|
|
Команды запуска и остановки OpenEdge
1.1. О командах запуска
Команды запуска Прогресс поддерживают клиент/серверную архитектуру и большое разнообразие опций конфигурации. В клиент/серверной конфигурации клиентские приложения и сервер базы данных являются отдельными процессами. Интерфейс пользователя и приложений Прогресса выполняются на стороне клиентской сессии, а запросы отправляются на сервер. Сервер получает доступ к базе данных от имени каждой клиентской сессии.
Следовательно, команды запуска разделяются на две общие категории:
- Команды для запуска и останова процессов базы данных, таких как сервер базы данных, брокеры базы данных и фоновые процессы
- Команды для запуска и останова клиентских соединений с базой данных, таких как 4GL client, AppServer и DataServer client.
В общих чертах, запуск клиента и сервера происходит следующим образом:
- Стартуется сервер базы данных или брокер базы данных. Старт этих процессов устанавливает постоянное соединение с базой данных. За более подробной информацией по старту обращайтесь к документации Progress Installation and Configuration Guide.
- Запускается клиентское приложение
1.2. О параметрах запуска
Вы можете использовать совместно с командами запуска параметры запуска, которые определяют режим работы базы данных и клиентских сессий. Требования к использованию параметров зависят от операционной системы и сетевой среды. Например, вы можете контролировать клиентские соединения, что бы обеспечить наибольшую производительность. Эти параметры разбиты по следующим категориям использования:
- Клиентские сессии
- Клиентские соединения
- Progress Database Server
- DataServer
- Open Interface Driver
1.3. Использование файлом параметров
Файл параметров является файлом операционной системы, который содержит один или более параметров запуска. Первоначальная причина использования файла параметров, это возможность избегать набора команд при каждом запуске Прогресса. Вместо того чтобы многократно вводить серию параметров и других аргументов, достаточно набрать их один раз в файл параметров. Также вы можете использовать его, чтобы поддерживать параметры запуска для конкретной базы данных, группы пользователей, или системной конфигурации. Файл параметров имеет расширение .pf.
Каждая программ Прогресса использует файл параметров, который по умолчанию называется startup.pf. Этот файл расположен в директории DLC. Он должен находиться там, чтобы Прогресс работал правильно. Вы можете модифицировать этот файл для добавления/изменения набора параметров. Вы можете также создавать один или более дополнительных файлов параметров, которые будут загружены после загрузки startup.pf.
Примечание: В Windows вы можете определять имя файла запуска, используя переменную среды PROSTARTUP в progress.ini или в реестре. См. Progress Client Deployment Guide для более детального описания файла progress.ini.
1.3.1. Вызов файла параметров
Для того чтобы вызвать дополнительный файл параметров, при старте Прогресса в командной строке используйте параметр запуска (–pf).
Вызов файла параметров из командной строки.
Введите одну из следующих команд:
pro sports -pf filename.pf (Unix)
prowin32 -1 sports -pf filename.pf (Windows)
Имя файла может быть любым. Прогресс объединяет все параметры запуска из файла в одну командную строку. Если один и тот же параметр упоминается несколько раз, то приоритет отдается последнему.
Вызов файла параметров оператором CONNECT.
Используйте следующий синтаксис для вызова файла параметров оператором CONNECT в процедурах 4GL:
CONNECT -pf sports.pf
Например, следующая процедура соединения использует файл параметров new_york.pf:
UPDATE ny_user ny_password BLANK.
CONNECT -pf new_york.pf
-U VALUE(ny_user) -P VALUE(ny_passwd)
NO-ERROR.
IF NOT CONNECTED("new_york") THEN
MESSAGE "Connection to New York office failed".
Вызов многочисленных файлов параметров
Параметр –pf можно использовать в файлах также как и в командной строке. Это позволяет вам определять специализированные параметры, специфические параметры базы данных, и специальные пользовательские параметры в других файлах параметров. Это также позволяет подключаться к многочисленным базам данных из одной командной строки или по средствам одного оператора CONNECT.
Когда подключение происходит к более чем одной базе данных, этот параметр должен быть указан после параметра –db (Physical Database Name). Если соединение происходит к более чем одной базе, то в первой строке будет параметр –db, а в последующих строках – параметры запуска, относящиеся к этой базе данных
1.3.2 Создание и редактирование файлов параметров
Вы можете использовать любой текстовый редактор для создания файла, содержащего стартовый параметры. Вы также можете использовать инструментальные средства.
1.3.3 Формат файла параметров
Пример файла параметров
-db /usr/disk0/newyork # new york central db
-B 200 # database buffers
-H nysystem -S nyserver # host, service
-L 10000 # lock table entries
# Остальные параметры получают значения по умолчанию
Этот формат используется для всех операционных систем. Следуйте следующим правилам при создании файла параметров:
- Устанавливайте параметры и их аргументы в одной строке
- Используйте максимум 40 символов в одной строке
- Выделите параметры с синтаксисом UNIX
- Используйте знак # для выделения комментариев. Прогресс проигнорирует данные в строке, следующие за этим знаком
- Заключайте значения в одиночные или двойные кавычки
- Параметры запуска не указанные в файле параметров принимают значения по умолчанию
- Используйте ~ для определения управляющих символом, таких как указанных в таблице 1-1
Table 1–1: Управляющие символы в файлах параметров
Символ
|
Описание
|
Код
|
| ~nnn |
Символ, имеющий восьмеричный код |
- |
| ~b |
BS символ |
~010 |
| ~t |
HT (горизонтальная таб.) |
~011 |
| ~n |
LF (подача линии) |
~012 |
| ~r |
VT (перевод строки) |
~013 |
| ~f |
FF (подача формы) |
~014 |
| ~E |
ESC |
~033 |
На Unix используйте обратную косую черту (\) вместо тильды.
2.1 Синтаксис команд запуска
Общий синтаксис команд выглядит следующим образом:
command [ db-name ] [ parameter ] [ value ] ...
Например, следующая команда обеспечивает доступ 100 пользователей к базе данных и устанавливает значения необходимых сетевых параметров.
proserve sports -n 100 -B 30000 -L 1000 -S sprtsv -H sys27
Таблица 2-1 описывает каждый командный компонент
Компонент
|
Описание
|
| Command |
На UNIX, команда выполняет сценарий, который выполняет программу Прогресса с подходящими параметрами.
На Windows, некоторые команды запускают пакетный файл, который
выполняет программу Прогресса с подходящими параметрами. Другие команды
запускают программу Прогресса непосредственно |
| db-name |
Имя базы данных, с которой необходимо соединиться |
| Parameter |
Набор параметров поддерживаемых командой |
| Value |
Значения параметров команды |
Используйте следующие соглашения для команд:
- В Unix команды набирайте в верхнем регистре. В windows регистр значения не имеет
- Вводите параметры команд точно так же, как они описаны в синтаксических описаниях
- В Unix значения параметров чувствительны к регистру (Например, имена файлов). Кроме того, в Windows NT использующей файловую системы NTFS, значения также могут быть чувствительными к регистру. В Windows использующих FAT и FAT32 значения к регистру не чувствительны.
2.2 Задачи выполняемые командами запуска и останова
Команды запуска запускают или останавливают базы данных Прогресса или клиентские сессии.
Таблица 2-2 Общие команды запуска и останова Unix и Windows
| Задача |
Команда |
| Подключение к редактору Прогресса в однопользовательском режиме |
pro db-name |
| Подключение к редактору Прогресса в многопользовательском режиме |
mpro db-name
-S service-name
-H host-name
-N network-type |
| Запуск клиентской сессии в однопользовательском режиме |
bpro db-name -p procedure-name |
| Запуск клиентской сессии в многопользовательском режиме |
mbpro db-name -p procedure-name
-S service-name
-H host-name
-N network-type |
| Запуск группы серверов |
proserve
-servergroup server-group-name |
| Запуск серверов и брокеров базы данных Прогресс в многопользовательском режиме |
proserve db-name
-S service-name
-H host-name
-N network-type |
| Остановка серверов и брокеров базы данных многопользовательского режима |
proshut db-name |
| Запуск брокера удаленного сервера базы данных |
probrkr
-S service-name
-H host-name
-N network-type |
| Запуск процесса APW для базы данных |
proapw db-name |
| Запуск процесса BIW |
probiw db-name |
| Запуск процесса AIW |
proaiw db-name |
| Запуск процесса Watchdog |
prowdog db-name |
| Останов удаленного сервера базы данных |
proshut db-name
-S service-name
-H host-name
-N network-type |
| Останов всех процессов базы данных (APW,BIW,AIW, Watchdog). Используйте
первый пункт команды для отсоединения конкретного процесса |
proshut db-name |
Таблица 2-3 Команды запуска Windows
| Задача |
Команда
|
| Старт редактора графического интерфейса Прогресс в однопользовательском режиме |
prowin32 -1 db-name |
| Старт редактора графического интерфейса Прогресс в многопользовательском режиме |
prowin32 db-name
-S service-name
-H host-name
-N network-type |
| Запуск ADE Desktop в однопользовательском режиме |
prowin32 -p _desk.p -1 db-name |
| Запуск ADE Desktop в многопользовательском режиме |
prowin32 -p _desk.p db-name
-S service-name
-H host-name
-N network-type |
| Запуск Пргрессовой сессии в однопользовательском режиме |
prowin32 -b -1 db-name
-p procedure
|
| Запуск Прогрессовой сессии в многопользовательском режиме |
prowin32 -b db-name -p procedure
-S service-name
-H host-name
-N network-type |
2.3 Описание команд запуска и останова
В этом разделе подробно описываются команды Прогресс в алфавитном порядке. Описание каждой команды включает таблицу, показывающую ее синтаксис и прочую связанную с ней информацию. После таблицы идет описание каждого параметра команды.
Примечание: Если база данных находится не в текущей директории, обязательно прописывайте полный путь к ней. Возможны некоторые исключения. Подробно изучите описание команды, которую вы хотите использовать.
Команда BPRO
Запуск однопользовательской клиентской сессии в пакетном или фоновом режиме.
Синтаксис
Операционная система
|
Синтаксис
|
UNIX
Windows
|
bpro [ db-name ] -p procedure-name [ parameters ] [ > output-file ] |
Параметры:
db-name
Определяет базу данных, к которой необходимо подключение
-p procedure-name
Определяет запускаемую процедуру
parameters
Определяет параметры запуска Прогресса
output-file
Определяет имя файла, в который будут записываться все сообщения команды
Примечание:
В Unix команда выполняется следующим образом:
_progres -1 -b &
Символ & переводит пакетный сеанс в фоновый режим, возвращая управление терминалу, как только команда начнет работать. Если этот символ отсутствует, то Прогресс запускает команду, а управление терминалу передается только после ее завершения.
В Unix и Windows можно переназначать ввод/вывод командами переадресации, можно также использовать символ (|) чтобы помещать результат работы в командный конвейер.
Команда MBPRO
Запуск многопользовательской сессии в пакетном или фоновом режиме.
Синтаксис
Операционная система
|
Синтаксис
|
UNIX
Windows |
mbpro [ db-name ] -p procedure-name
[ parameters ] [ > output-file ] |
Параметры:
db-name
Определяет базу данных, к которой необходимо подключение. Если соединение происходит, используя общую память, и база данных находится не в текущей директории, необходимо указать полный путь к ней. С другой стороны, если происходит клиент/серверное подключение – полный путь не обязателен.
-p procedure-name
Определяет запускаемую процедуру
parameters
Определяет параметры запуска Прогресса
output-file
Определяет имя файла, в который будут записываться все сообщения команды
Примечание:
В Unix команда выполняется следующим образом:
_progres -b &
В Unix и Windows можно переназначать ввод/вывод командами переадресации, можно также использовать символ (|) чтобы помещать результат работы в командный конвейер.
Команда MPRO
Запуск клиентской сессии в многопользовательском режиме
Синтаксис
Операционная система
|
Синтаксис
|
UNIX
Windows |
mpro [ db-name ] [ parameters ] |
Параметры:
db-name
Определяет базу данных, к которой необходимо подключение. Если соединение происходит, используя общую память, и база данных находится не в текущей директории, необходимо указать полный путь к ней. С другой стороны, если происходит клиент/серверное подключение – полный путь не обязателен.
-p procedure-name
Определяет запускаемую процедуру
parameters
Определяет параметры запуска Прогресса
Примечание:
Команду MPRO в Unix выполняет следующая программа _progres
Сервер базы данных должен быть запущен прежде чем будет выполнена эта команда, в противном случае Прогресс отобразит следующее сообщение: There is no server for database db-name (1423)
Команда PRO
Запуск клиентской сессии в однопользовательском режиме
Синтаксис
Операционная система
|
Синтаксис |
UNIX
Windows |
pro [ db-name ] [ parameters ] |
Параметры:
db-name
Определяет базу данных, к которой необходимо подключение
parameters
Определяет параметры запуска Прогресса. Можно использовать любой однопользовательский стартовый параметр.
Примечание:
Команду PRO в Unix выполняет следующая программа _progres -1
Команда PROAIW
Команда запускает процессы AIW (after-image writer). AIW улучшает производительность системы, за счет сохранения ai-блоков на диск в фоновом режиме, разгружая тем самым работу брокера.
За более подробной информацией обращайтесь Progress Database Administration Guide and Reference.
Синтаксис
Операционная система
|
Синтаксис
|
UNIX
Windows |
proaiw db-name |
Параметры:
db-name
имя базы данных, для которой запускается процесс AIW
Примечание:
- Для того чтобы остановить работу процесса, используйте команде PROSHUT. Можно запускать и останавливать работу процесса в любое время без останова базы данных.
- Каждый процесс AIW считается одним пользователем. Необходимо учитывать количество процессов при формировании значения параметра –n. Тем не менее, AIW не входит в состав лицензированных пользователей.
- Вы можете изменять количество буферов для AIW с помощью параметра –aibufs (After-image Buffers). Повышение количества буферов при работе AIW, увеличивает количество доступных свободных буферов клиентским и серверным процессам. Этот параметр не имеет ни кого значения, если процесс AIW не запущен.
Команда PROAPW
Запускает процесс APW (asynchronous page writer). APW улучшает производительность системы за счет обработки второстепенных задач в фоновом режиме.
За более подробной информацией обращайтесь Progress Database Administration Guide and Reference.
Синтаксис
| Операционная система |
Синтаксис
|
UNIX
Windows |
proapw db-name |
Параметры:
db-name
имя базы данных, для которой запускается процесс APW
Примечание:
- Для того чтобы остановить работу процесса, используйте команде PROSHUT. Можно запускать и останавливать работу процесса в любое время без останова базы данных.
- Каждый процесс APW считается одним пользователем. Необходимо учитывать количество процессов при формировании значения параметра –n. Тем не менее, APW не входит в состав лицензированных пользователей.
- Оптимальное количество процессов зависит от ваших приложений и среды выполнения. Используйте как минимум один APW для каждого жесткого диска, на котором расположена база данных. Если этого количества не достаточно, можно добавить еще. Если существуют приложения, которые выполняют большое количество изменений, помимо запуска по одному APW на каждый диск, запускается еще один дополнительный процесс. Чем меньше приложение вносит изменения в базу данных, тем меньше APW процессов ему требуется.
Команда PROBIW
Запускает процесс BIW (before-image writer). BIW улучшает производительность системы, за счет сохранения bi-блоков на диск в фоновом режиме, разгружая тем самым работу брокера.
За более подробной информацией обращайтесь Progress Database Administration Guide and Reference.
Синтаксис
Операционная система
|
Синтаксис |
UNIX
Windows |
probiw db-name |
Параметры:
db-name
имя базы данных, для которой запускается процесс BIW
Примечание:
- Для того чтобы остановить работу процесса, используйте команде PROSHUT. Можно запускать и останавливать работу процесса в любое время без останова базы данных.
- Каждый процесс BIW считается одним пользователем. Необходимо учитывать количество процессов при формировании значения параметра –n. Тем не менее, BIW не входит в состав лицензированных пользователей.
- Вы можете изменять количество буферов для BIW с помощью параметра –bibufs (Before-image Buffers). Повышение количества буферов при работе BIW, увеличивает количество доступных свободных буферов клиентским и серверным процессам.
Команда PROBRKR
Запускает брокер DataServer, который используется, когда клиентские прогрессовые сессии подключаются к не прогрессовым базам данных. Чтобы использовать DataServer с удаленного клиента, необходимо сначала запустить его брокер. Как только брокер запущен, можно отправлять запросы, используя подходящий DataServer.
Синтаксис
| Операционная система |
Синтаксис
|
UNIX
Windows |
probrkr [db-name] -S service-name [ -H host-name ]
[ -N network-type ] |
Параметры:
db-name
имя базы данных, к которой необходимо подключение
service-name
Определяет имя брокерского процесса (сервиса)
host-name
Определяет имя машины, на которой установлен брокер сервер данных. Этот параметр используется только в Unix System V с типом сети TLI. По умолчанию установлено имя текущей машины.
network-type
Определяется сетевой протокол по которому брокер будет работать
Прогресс поддерживает TCP, SNA (Progress/400 only), и LFP (Progress/400 only).
Примечание:
- Можно использовать любой стартовый параметр с командой PROBRKR
- Для получения более подробной информации о соединении с не прогрессовыми базами данных, смотрите документацию к DataServer.
- Вы должны запускать удаленного брокера в той же среде, где и установлена не прогрессовая база данных, поскольку сервера наследуют среду брокера. Например, если вы используете базу данных Oracle на платформе Unix, установить величину ORACLE_SID токую же, как и для локального DataServer.
- Запускайте брокер, даже если не прогрессовая база данных подключена локально.
Команда PROQUIET
Запуск команды с опцией enable останавливает вся транзакционную активность. Это полезно при выполнении резервного копирования не прогрессовыми средствами.
(Башкатов В.Г. 2007 г.)
|
|
|
|
Главная
