Генерация файлов параметров
В OpenEdge 12.8 LTS администраторы баз данных могут создавать файлы параметров (.pf) в процессе выполнения для настройки баз данных. Эти файлы могут быть использованы напрямую, без дополнительного редактирования, для перезапуска базы данных с теми же параметрами конфигурации, что и в предыдущей версии. Например, администратор может регулярно использовать файл .pf с параметром -B, установленным на значение 100. В дальнейшем, при запуске базы данных, он может применить команду INCREASETO для изменения значения параметра -B на 1000. При перезапуске базы данных с использованием того же файла .pf, значение параметра -B вернется к исходному значению 100.
Преимущество данной функции заключается в том, что администраторы баз данных освобождаются от необходимости запоминать или документировать изменения, внесенные в конфигурацию. С учетом того, что современные версии OpenEdge предоставляют возможность выполнения множества операций без остановки базы данных, сохранение конфигурации становится критически важным.
Файлы параметров могут быть созданы для воспроизведения текущей конфигурации системы во время выполнения. Эти файлы могут быть использованы для:
- Простого изменения текущих конфигураций.
- Перечисления всех параметров конфигурации, независимо от их явного указания.
- Сравнения изменений параметров с течением времени.
- Генерации файлов параметров для запуска вторичного брокера.
Сгенерированные файлы могут быть запущены без изменений. При перезапуске базы данных с использованием сгенерированного файла, некоторые параметры, не являющиеся необходимыми для поддержания работоспособности системы, все равно будут включены в файл. Эти параметры будут упорядочены по категориям и снабжены комментариями, объясняющими их значение и необходимость.
Следует учитывать следующие ограничения при создании файлов параметров:
- Файлы параметров доступны только в многопользовательской среде.
- Файлы создаются без прав суперпользователя, групповой идентификации пользователя (GUID) или установки групповой идентификации (SGID).
- Сервер ABL, клиенты самообслуживания, SQL Server и PROMON создают файлы .pf относительно каталога .db.
- При использовании обновления VST необходимо присвоить сгенерированному файлу новое имя, чтобы избежать перезаписи существующего файла .pf.
- Сгенерированный файл параметров заменяет комментарии и историю в существующем файле .pf.
- Выходные данные сортируются по идентификатору строки _dbparams в алфавитном порядке и по размеру.
- Создание файла свойств не поддерживается.
- OpenEdge обрабатывает явные параметры со значениями по умолчанию так же, как и неявные параметры.
Для создания файла параметров с текущей конфигурацией системы во время выполнения с помощью служебной программы PROMON, необходимо выполнить следующие шаги:
- Запустить PROMON.
- Выбрать раздел “R&D Advanced Options”.
- Выбрать пункт 4 “А Administrative Functions”.
- Выбрать пункт 17 “Generate parameter file”.
Важно отметить, что сгенерированный файл параметров заменит комментарии и историю в уже существующем файле .pf. Этот метод может быть использован для записи параметров для запуска основного и дополнительного брокера.
Созданный файл содержит все параметры запуска, а также комментарии к параметрам, которые не являются необходимыми для поддержания конфигурации. OpenEdge группирует параметры в пять категорий в зависимости от их влияния на конфигурацию системы. Каждая категория параметров форматируется с уникальным символом комментария для облегчения определения влияния изменения параметра на систему. Для отображения параметров, сгруппированных по категориям, а не в алфавитном порядке, необходимо выбрать опцию “order by categor”, как указано в примере вывода в данном разделе.
На следующем экране PROMON будут отображены доступные настройки.
OpenEdge Release 12 Monitor (R&D)
Generate parameter file
1. Database wide parameter file in alphabetical order
2. Database wide parameter file in order by category
3. Broker specific parameter file in alphabetical order
4. Broker specific parameter file in order by category
Enter a number, P, T, or X (? for help):
Администратору необходимо выбрать одну из следующих опций:
- Database wide parameter file in alphabetical order – Генерирует файл параметров для всей базы данных, где параметры перечислены в порядке идентификатора строки _DbParams (строчные буквы сортируются перед прописными).
- Database wide parameter file in order by category – Генерирует общий файл параметров для базы данных, где параметры сгруппированы по категориям.
- Broker specific parameter file in alphabetical order – Генерирует файл параметров для конкретного брокера, где параметры перечислены в порядке идентификатора строки _DbParams (строчные буквы сортируются перед прописными). PROMON запросит номер брокера и имя файла параметров. Если файл уже существует, необходимо ввести Y для его перезаписи.
- Broker specific parameter file in order by category – Генерирует файл параметров для конкретного брокера, где параметры сгруппированы по категориям. PROMON запросит номер брокера и имя файла параметров. Если файл уже существует, необходимо ввести Y для его перезаписи.
Пример сгенерированного общего файла параметров, где параметры сгруппированы по категориям.
############################################### # # OpenEdge generated DB parameter file. # OpenEdge version: # Date generated: # ############################################### # # # Parameters explicitly set # ------------------------- -cpinternal 1251 -db "/usr/wrk128/atm/atm" -n 120 -spin 10000 -B 20000 -L 100000 -Ma 5 -Mn 20 -S 12345 # # Parameters set to default value # ------------------------------- # -aibufs 64 # -baseindex 1 # -baselob 1 # -basetable 1 # -baseuserindex 1 # -baseuserlob 1 # -baseusertable 1 # -bibufs 64 # -biscantime 10 # -blocksize 4096 # -bwdelay 30 # -c 484 # -cdcsize 200 # -cstackPrintopt 0 # -dbnotifyops 16 # -dbnotifytime 30 # -diagEvent LockTable:0,BiThold:0,SysErr:0 # -diagEvtLevel 0 # -diagFS ' ' # -diagFormat csv # -diagPause 0 # -diagPrefix diagEvent_ # -dt PROGRESS # -ecsize 1000 # -groupdelay 10 # -hashLatchFactor 10 # -indexrangesize 50 # -ipver IPV4 # -lgTruncateSize 0 # -lgTruncateTime 00:00 # -limitLgPayload 0 # -lobrangesize 50 # -lruskips 100 # -lru2skips 100 # -maxAreas 32000 # -maxport 13000 # -maxxids 100 # -minport 12000 # -mtpmsize 1024 # -mux 1 # -nap 10 # -napmax 250 # -numCheckpointStats 32 # -omsize 1024 # -pica 128 # -picanap 1 # -prefetchDelay # -prefetchFactor 100 # -prefetchNumRecs 64 # -prefetchPriority 1 # -pwqdelay 100 # -pwqmin 1 # -pwsdelay 1 # -pwwmax 25 # -recspacesearchdepth 5 # -secsize 512 # -semsets 3 # -shmsegsize 1024 # -ssj 1 # -stsSocketReuse Yes # -stslogginglevel 0 # -tablerangesize 50 # -threadedServer 1 # -threadedServerStack 512 # -userindexrangesize 50 # -userlobrangesize 50 # -usernotifytime 600 # -usertablerangesize 50 # -Bpmax 64 # -G 0 # -H MyAltSrv # -Mf 3 # -Mi 1 # -Mm 8192 # -Mxs 87 # -N TCP # -Nmsgwait 2 # -ServerType BOTH # -SQLAutoStats OFF # -SQLCursors 50 # -SQLEnableCoreGeneration OFF # -SQLFailureDrivenLog OFF # -SQLLockWaitTimeout 5 # -SQLQuotedRowid STD # -SQLStack 1000 # -SQLStmtCache 100 # -SQLTempBuff 1000 # -SQLTempDisk 500000 # -SQLTempPgSize 8 # -SQLTruncateTooLarge OFF # -SQLWidthUpdate OFF # -TXERetryLimit 0 # -TXESkipLimit 10000 # # Parameters with auto generated default value # -------------------------------------------- ## -hash 6661 ## -lkhash 13063 ## -pwscan 33 # # Parameters with no specific default value and not explicitly set # ---------------------------------------------------------------- ### -aiarcdir "" ### -aiarcinterval -1 ### -bithold 0 ### -certstorepath "" ### -clstmtcachedir "" ### -diagDir "" ### -diagProc "" ### -keyalias "" ### -lgArchiveDir "" ### -lgTruncateFrequency -1 ### -nGovernor 0 ### -omitLgMsgs "" ### -pf "" ### -sessiontimeout 0 ### -AreaCheck "" ### -B2 0 ### -DBService "" ### -IndexCheck "" ### -LGovernor 0 ### -Mp 0 ### -Mpb 0 ### -PendConnTime 0 ### -TableCheck "" # # Parameters requiring no value and not explicitly set # ---------------------------------------------------- #### -aiarcdircreate #### -aistall #### -bistall #### -directio #### -hostnameAliasing #### -i #### -lgArchiveEnable #### -lkrela #### -nohostverify #### -nosessioncache #### -nosessionreuse #### -pinshm #### -r #### -schlockwq #### -ssl #### -DbCheck #### -MemCheck
В представленной таблице приведены категории параметров и соответствующие индикаторы комментариев для каждой из них.
| Категория | Индикатор комментариев | Описание | Примечания |
|---|---|---|---|
| 1 | None | Параметры, явно заданные при запуске брокера | Все значения имен, допускающие использование специальных символов, заключаются в кавычки. |
| 2 | # | Параметры со значением по умолчанию | Указанные параметры закомментированы с целью обеспечения совместимости при обновлении значений по умолчанию в будущих версиях. В случае, если данные параметры не были бы закомментированы, установленное значение могло бы переопределить новые значения по умолчанию. |
| 3 | ## | Параметры с автоматически сгенерированным значением по умолчанию | Данные параметры обозначены двойным знаком решётки (##), что указывает на их статус как значений по умолчанию, основанных на соответствующем связанном параметре, и на то, что они не были изменены.
В случае увеличения значения параметра –B, текущее значение параметра –hash будет автоматически скорректировано в соответствии с этим изменением. При онлайн-изменении параметра –B текущее значение параметра –hash также будет обновлено. Обычно параметры, которые не соответствуют текущему значению по умолчанию, отображаются как явно заданные параметры. Однако это не распространяется на автоматически сгенерированные параметры. |
| 4 | ### | Параметры без определенных значений по умолчанию | При запуске не были запрошены эти параметры, и для них не установлено значение по умолчанию.
Чтобы удалить комментарий, необходимо задать значение для каждого из этих параметров. |
| 5 | #### | Параметры, которые не были запрошены, но не имеют значения | Эти параметры внесены в перечень с целью информирования о их существовании, но без указания или активации.
При внесении изменений в данные параметры следует проявлять особую осторожность, так как удаление комментариев может существенно повлиять на функционирование уже запущенной конфигурации, вплоть до кардинального изменения её поведения. |
