Параметры командной строки сервера базы данных

С помощью параметров команды dbadmin, а также параметров командной строки можно управлять сервером базы данных Rational DOORS.
Прим.: Для применения команды dbadmin требуется параметр -data. Если этот параметр пропущен или содержит недопустимое значение, то при выполнении команды выдается следующее сообщение об ошибке: -F- DBADMIN: Не указан сервер.

Список параметров командной строки клиента RationalDOORS приведен в разделе Параметры командной строки клиента Rational DOORS.

Табл. 1. Параметры команды dbadmin в RationalDOORS
Параметр (сокращение) Значение Описание
-data (-d) порт@сервер-DOORS Этот параметр задает сервер базы данных Rational DOORS, где порт - это порт сервера базы данных, а сервер-DOORS - имя системы, в которой установлен сервер базы данных. Это обязательный параметр.
-killprocess (-k) идентификатор-канала Разрывает пользовательское соединение, обозначенное с помощью параметра идентификатор-канала.

Параметр идентификатор-канала отображается параметром -userlist.

-killserver (-K)   Останавливает сервер.
-locklist (-l)   Выводит список всех заблокированных файлов и идентификатор канала для каждого файла.
-outfile (-o) имя-файла Записывает вывод в файл.

Этот параметр применяется вместе с параметрами -locklist и -userlist.

-password (-P) пароль Этот параметр задает текущий пароль для сервера.
-newpassword (-p) новый-пароль Этот параметр задает новый пароль для сервера.
-unlock (-U) идентификатор-канала Разблокирует файл, указанный с помощью параметра идентификатор-канала.

Параметр идентификатор-канала отображается параметром -locklist.

-userlist (-u)   Выводит список всех пользовательских соединений.
-serverLogging уровень-протокола Если сервер запущен с параметрами loglevel и logfile, этот параметр можно использовать для изменения уровня ведения протокола.

Для вступления в силу нового уровня ведения протокола перезапуск сервера не требуется.

Описание уровней ведения протоколов приведено в разделе Файлы протоколов.
-logxconfig (-X) имя-файла-протокола Полное имя файла конфигурации log4cxx; например, c:\Program Files\IBM\Rational\DOORS\9.6\logging-config.xml. Log4cxx - это среда для регистрации сообщений приложений. Когда этот параметр указывается в командной строке или в реестре, сообщения приложения записываются в указанном файле конфигурации. Записываются шесть уровней сообщений:
  • TRACE
  • DEBUG
  • INFO, в том числе ACK, CONFIRM и QUERY
  • WARNING
  • ERROR
  • FATAL
-tdsUserFilterLimit строка Накладывает ограничение на поиск пользователей Rational Directory Server.
-tdsGroupFilterLimit строка Накладывает ограничение на поиск групп Rational Directory Server.
-useCardAuthentication   Включает режим идентификации с помощью смарт-карты.
-doNotUseCardAuthentication   Выключает режим идентификации с помощью смарт-карты.
-useOSUserAuthentication   Включает режим идентификации пользователя операционной системы.
-doNotUseOSUserAuthentication   Выключает режим идентификации пользователя операционной системы.
-secure on, ON, off, OFF Включает/выключает защищенный режим запуска Rational DOORS.
-keyDB имя-файла Этот параметр задает полный путь к файлу базы данных ключей, содержащему ключи идентификации и проверки SSL Rational DOORS.

Путь по умолчанию: DOORS\9.версия\certdb\server_authentication.kdb.

Этот параметр обладает преимуществом перед параметром -certdb. Расположение папки базы данных ключей Rational Directory Server можно указать с помощью параметра -certdb. Отдельное расположение файла базы данных ключей SSL Rational DOORS можно указать с помощью параметра -keyDB.

-certdb имя-папки Этот параметр задает папку, содержащую файлы базы данных ключей Rational Directory Server и SSL Rational DOORS.

Путь по умолчанию: DOORS\9.версия\certdb\.

С помощью параметра -keyDB файлы базы данных ключей SSL Rational DOORS можно разместить в отдельной папке. Параметр -keyDB обладает преимуществом перед параметром -certdb.

-certName строка Этот параметр задает метку сертификата для идентификации сервера во время выполнения защищенной идентификации.

Метка по умолчанию: IBMSV1.

-serverhostname строка Задает имя, применяемое сервером для идентификации в ходе проверки сертификата.

Метка по умолчанию: IBMEDSERV.

Табл. 2. Параметры команды dbadmin в Rational DOORS Web Access
Параметр (сокращение) Значение Описание
-dwaHost сервер-DWA Этот параметр задает сервер Rational DOORS Web Access, где сервер-DWA - это полное имя хоста компьютера, на котором работает сервер Rational DOORS Web Access; например dwaserver.ibm.com.
-dwaPort порт Этот параметр задает номер порта сервера Rational DOORS Web Access.

Если используется защищенное соединение, то по умолчанию используется порт 8443. В противном случае по умолчанию применяется порт 8080.

-dwaProtocol http или https Задает протокол, применяемый сервером Rational DOORS Web Access.

Для передачи данных по защищенному соединению укажите значение https. В противном случае введите http. Не указывайте оба значения.

-dcnEnable   Включает уведомления об изменении данных, необходимые для обеспечения взаимодействия с сервером и посредником Rational DOORS Web Access.
-dcnBrokerUri tcp://посредник:61616 Этот параметр задает посредник Rational DOORS Web Access, где посредник - это система, в которой размещен посредник, а 61616 - порт по умолчанию посредника.
-dcnChannelName dcn Настраивает канал службы DCN. Всегда применяется имя канала "dcn".
-dcnInfo   Позволяет проверить состояние службы уведомлений об изменении данных.
-dcnEnable   Включает службу DCN.
-dcnDisable   Выключает службу DCN.
Табл. 3. Параметры команды doorsd в Rational DOORS
Параметр (сокращение) Значение Описание
-minstall -port номер-порта -serverdata каталог-данных-сервера Создает дополнительную службу сервера базы данныхRational DOORS в системе Windows, где номер-порта - это порт соединения данных, а каталог-данных-сервера - это папка данных на сервере.

Пример:

"doorsd -minstall -port 36666 -serverdata C:\Program Files(x86)\IBM\Rational\DOORS\9.6\new_data._ Новой службе присвоен номер экземпляр 00001.

-remove   Удаляет службу по умолчанию, созданную в ходе первой установки сервера базы данных Rational DOORS.
-mremove -i номер-экземпляра-службы Удаляет конкретный экземпляр службы сервера базы данных Rational DOORS, где номер-порта - это номер экземпляра, присвоенный имени службы базы данных.
-list   Отображает таблицу со списком всех настроенных служб сервера базы данных Rational DOORS с информацией об их состоянии.
-logfile файл-протокола Задает файл, применяемый для ведения протокола транзакций сервера базы данных Rational DOORS. Описание уровней ведения протоколов приведено в разделе Файлы протоколов.
-loglevel уровень-протокола Задает уровень подробности информации, записываемой в протокол транзакций сервера базы данных Rational DOORS. Для выключения функции ведения протоколов укажите значение 0. Для сбора наиболее подробных сведений укажите значение 6.
-start   Запускает службу сервера базы данных Rational DOORS.
-stop   Останавливает службу сервера базы данных Rational DOORS.

Пример командной строки

Параметры командной строки можно указывать в командной строке или в ярлыках.

Для завершения работы сервера 36677@IBMEDSERV выполните следующую команду:
dbadmin -data 36677@abc -killserver

Пример ярлыка

Для запуска сервера воспользуйтесь следующим ярлыком. Укажите в команде применяемый установочный каталог Rational DOORS.
"C:\Program Files\IBM\Rational\DOORS\9.version\bin\doorsd.exe" -start -debug
Прим.: При запуске сервера базы данных Rational DOORS из командной строки укажите параметр -debug.

Комментарии