Настройка экземпляра
Во время создания экземпляра PAS for OpenEdge его параметры автоматически устанавливаются на определённые значения по умолчанию. Каждый сервер приложений имеет собственный каталог /conf, который содержит различные конфигурационные файлы:
- openedge.properties – содержит настройки, необходимые для создания и работы экземпляра;
- catalina.properties – содержит настройки JAVA, которые использует экземпляр и его ABL Web-приложения;
- appserver.properties – настройки в этом файле связаны с файлом catalina.properties таким образом, чтобы любые изменения в catalina.properties динамически отражались в appserver.properties;
- jvm.properties – содержит список параметров старта командной строки JMV;
- server.xml – содержит компоненты сервера экземпляра.
В большинстве случаев нет необходимости в изменении значений параметров в файлах конфигурации. Тем не менее, если необходимо, вы можете изменить значения существующих параметров или добавить новые параметры. В зависимости от того какой конфигурационный файл вы хотите изменить, используется один из следующих инструментов:
- oeprop – для редактирования файла openedge.properties;
- tcmanconfig – для редактирования файла catalina.properties (или appserver.properties), а также для просмотра параметров их файла jvm.properties;
- tcmanfeature – для редактирования файла server.xml.
Для получения информации о полном наборе параметров по умолчанию и их описанию обратитесь к документации Progress Application Server for OpenEdge: Administration Guide.
Редактирование файла openedge.properies
Как вы уже знаете, файл openedge.properties находится в каталоге /conf экземпляра PAS for OpenEdge и содержит параметры, которые используются для создания экземпляра. В файле эти параметры распределены по группам. Каждая группа идентифицируется по соответствующему тегу ([groupname]). Например, следующие параметры относятся к группе «AppServer»:
[AppServer] collectMetrics=1 applications=oepas1 statusEnabled=1 allowRuntimeUpdates=0
OEPROP – это утилита командной строки, которая предназначена для просмотра и управления параметрами из файла openedge.properties. Команду OEPROP необходимо выполнять из каталога /bin экземпляра сервера приложений.
Синтаксис команды OEPROP:
oeprop.bat [-help] [-v] [-g] [-t] [-R] [-f filename] [group_name.property_name] [group_name.property_name=value] [+group_name.property_name=value] [~group_name.property_name] [~group_name]
Параметр | Назначение |
-help | Используется для получения справки по команде OEPROP. |
-v | Используется для получения и просмотра подробной информации во время работы команды. |
-g | Используется для просмотра отладочной информации во время работы команды. |
-t | Используется для детальной трассировки работы команды. |
-R | Используется для удаления группы, включая параметры в ней, из файла openedge.properties. Должен использоваться в сочетании с параметров [~group_name]. |
-f filename | Используется для объединения содержимого текстового файла с содержимым файла openedge.properties. Здесь filename это имя любого текстового файла. |
group_name.property_name | Используется для просмотра значения параметра из указанной группы. |
group_name.property_name=value | Используется для указания нового значения существующего параметра из указанной группы. |
+group_name.property_name=value | Используется для добавления нового параметра в указанную группу и указания его значения. |
~group_name.property_name | Используется для удаления параметра из указанной группы. |
~group_name | Используется для удаления группы. Группа должна быть пустой. Для удаления не пустой группы добавьте параметр -R. |
Следующая команда показывает максимальное количество ABL-сессий для агента в группе AppServer.SessMgr:
oeprop.bat AppServer.SessMgr.maxABLSessionsPerAgent 200
Для уменьшения количества ABL-сессий для агента до 100 используется следующая команда:
oeprop.bat AppServer.SessMgr.maxABLSessionsPerAgent=100 oeprop.bat AppServer.SessMgr.maxABLSessionsPerAgent 100
Редактирование файла catalina.properties
Просмотр, добавление, изменение или удаление параметров из файла catalina.properties должно выполняться с помощью команды TCMAN CONFIG.
Для просмотра всех параметров необходимо выполнить из каталога /bin соответствующего экземпляра следующую команду:
tcman.bat config
Выведенный на экран список параметров будет содержать настройки сервера Tomcat и всех параметров из файлов catalina.properties и jvm.properties. И хотя вы можете просматривать и изменять параметры Tomcat, параметры JVM вы можете только просматривать.
Синтаксис команды для просмотра, изменения, добавления и удаления индивидуальных параметров экземпляра:
tcman.bat config [prop_name | prop_name=value | +prop_name=value | ~prop_name]
Параметр |
Назначение |
prop_name | Показывает значение существующего параметра. |
prop_name=value | Устанавливает новое значение для существующего параметра. |
+prop_name=value | Добавляет новый параметр и устанавливает его значение. |
~prop_name | Удаляет указанный параметр. |
Нет никаких ограничений на удаление параметров. Поэтому всегда проверяйте команду перед выполнением чтобы случайно не удалить параметр, который необходим для старта экземпляра.
Пример установки нового значения для существующего параметра:
tcman.bat config psc.as.http.port=6543
Эта команда устанавливает значение 6543 в качестве нового HTTP-порта экземпляра сервера приложений.
Редактирование файла server.xml
Для просмотра или изменения функций сервера Tomcat, содержащихся в файле conf\server.xml, используется следующая команда TCMAN FEATURE:
tcman.bat feature [general_options] [feature_name [={on|off}]]
Параметр |
Назначение |
general_options | Укажите один или несколько основных параметров TCMAN. Для просмотра списка возможных параметров выполните команду tcman.bat help. |
feature_name | Используется для просмотра указанной функции. Если конкретная функция не указана, то будут выведен список всех функций из файла server.xml. |
on | Используется для включения заданной функции. |
off | Используется для выключения заданной функции. |
Команда TCMAN FEATURE должна выполняться в оффлайн, когда сервер приложений остановлен.
Следующий пример команды выключает функцию AccessLog для экземпляра сервера приложений. Эта функция определяет необходимость логирования HTTP-сообщений от клиента и кода ответа от сервера:
tcman.bat feature AccessLog=off
Для получения полного списка функций, содержащихся в файле server.xml, обратитесь к документации Progress Application Server for OpenEdge: Administration user guide.