Comutadores de Linha de Comandos para o Servidor de Banco de Dados

Você pode utilizar comutadores de linha de comandos para configurar opções para o comando dbadmin e para gerenciar o servidor de banco de dados do Rational DOORS.
Nota: Para utilizar o comando dbadmin, o comutador -data será necessário. Se você omitir esse comutador ou utilizar um valor de dados inválido, o comando não poderá ser executado e esta mensagem será mostrada: -F-DBADMIN: Servidor não especificado.

Para obter a lista dos comutadores de linha de comandos para o cliente RationalDOORS, consulte Comutadores da linha de comandos para o cliente Rational DOORS .

Tabela 1. Comutadores de linha de comandos para o comando dbadmin no RationalDOORS
Comutador (abreviatura) Parâmetro Descrição
-data (-d) port@DOORSserver Este comutador identifica o servidor de banco de dados do Rational DOORS, em que port é o número da porta que o servidor de banco de dados está usando e DOORSserver é o nome do computador em que o servidor de banco de dados está instalado. Este comutador é sempre necessário.
-killprocess (-k) channel_identifier Este comutador desconecta a conexão do usuário que é especificada pelo parâmetro channel_identifier.

O parâmetro channel_identifier é exibido pelo comutador -userlist.

-killserver (-K)   Este comutador interrompe o servidor.
-locklist (-l)   Este comutador lista todos os arquivos que estão atualmente bloqueados e o identificador de canal para cada arquivo.
-outfile (-o) filename Este comutador envia a saída para um arquivo.

Utilize este comutador com os comutadores -locklist e -userlist.

-password (-P) password Este comutador é a senha atual para o servidor.
-newpassword (-p) newpassword Este comutador é a nova senha para o servidor.
-unlock (-U) channel_identifier Este comutador desbloqueia o arquivo que é especificado pelo parâmetro channel_identifier.

O parâmetro channel_identifier é exibido pelo comutador -locklist.

-userlist (-u)   Este comutador lista todas as conexões do usuário.
-serverLogging log_level Se o servidor foi iniciado com os parâmetros loglevel e logfile, é possível usar esse comutador para alterar o nível de criação de log.

Não é necessário reiniciar o servidor para que o novo nível de registro entre em vigor.

Para obter uma descrição de níveis de log, consulte Arquivos de log.
-logxconfig (-X) logging_file_name O nome completo do arquivo de configuração log4cxx; por exemplo, c:ProgramFiles\IBM\Rational\DOORS\9.6\logging-config.xml. Log4cxx é uma estrutura para mensagens do aplicativo de criação de log. Ao usar esse parâmetro na linha de comandos ou no registro, as mensagens do aplicativo são publicadas no arquivo de configuração especificado. São registrados seis níveis de mensagens:
  • TRACE
  • DEBUG
  • INFO, incluindo ACK, CONFIRM, e QUERY
  • WARNING
  • ERROR
  • FATAL
-tdsUserFilterLimit string Este comutador configura limites em procuras de usuário do Rational Directory Server.
-tdsGroupFilterLimit string Este comutador configura limites nas procuras de grupo do Rational Directory Server.
-useCardAuthentication   Este comutador ativa a autenticação de cartão inteligente.
-doNotUseCardAuthentication   Este comutador desativa a autenticação de cartão inteligente.
-useOSUserAuthentication   Este comutador ativa a autenticação do usuário do sistema operacional.
-doNotUseOSUserAuthentication   Este comutador desativa a autenticação do usuário do sistema operacional.
-secure on, ON, off, OFF Este comutador especifica se o servidor Rational DOORS está configurado para iniciar no modo seguro.
-keyDB filename Este comutador é o caminho completo para o arquivo do banco de dados de chave que contém as chaves que são usadas para autenticação e validação SSL do Rational DOORS, incluindo o nome do arquivo.

O caminho padrão é DOORS\9.version\certdb\server_authentication.kdb.

Este comutador tem prioridade sobre o comutador -certdb. Para especificar um local para a pasta do banco de dados de chaves do Rational Directory Server, use o comutador -certdb. Para especificar um local separado para o arquivo do banco de dados de chave SSL do Rational DOORS, use o comutador -keyDB.

-certdb folder_name Este comutador identifica a pasta que contém os arquivos do banco de dados de chaves que contêm as chaves para o Rational Directory Server e Rational DOORS SSL.

O caminho padrão é DOORS\9.version\certdb\.

Para colocar os arquivos do banco de dados de chave para o Rational DOORS SSL em uma pasta separada, use o comutador -keyDB. O comutador -keyDB tem prioridade sobre o comutador -certdb.

-certName string Este comutador identifica o rótulo do certificado que identifica o servidor durante a autenticação segura.

O rótulo padrão é IBMSV1.

-serverhostname string Este comutador é o nome que o servidor utiliza para identificar a si mesmo durante a validação do certificado.

O rótulo padrão é IBMEDSERV.

Tabela 2. Comutadores da linha de comandos para o dbadmin no Rational DOORS Web Access
Comutador (abreviatura) Parâmetro Descrição
-dwaHost DWAserver Este comutador identifica o servidor Rational DOORS Web Access, em que DWAserver é o nome completo do host do computador em que o servidor do Rational DOORS Web Access está em execução; por exemplo, dwaserver.ibm.com.
-dwaPort porta Este comutador identifica o número da porta em que o servidor do Rational DOORS Web Access está em execução.

Se a comunicação deve ser segura, a porta padrão será 8443. Caso contrário, a porta padrão será 8080.

-dwaProtocol http ou https Este comutador especifica o protocolo que o servidor Rational DOORS Web Access está usando.

Se a comunicação for segura, insira https. Caso contrário, insira http. Não insira ambos.

-dcnEnable   Este comutador ativa as Notificações de Mudança de Dados necessárias para ativar a comunicação com o servidor Rational DOORS Web Access e o broker.
-dcnBrokerUri tcp://broker:61616 Este comutador identifica o broker do Rational DOORS Web Access, em que broker é o computador que está hospedando o broker e 61616 é o número da porta padrão que o broker usa.
-dcnChannelName dcn Este comutador configura o canal Notificações de Mudança de Dados. O nome de canal é sempre "dcn".
-dcnInfo   Este comutador verifica o status do serviço de Notificações de mudança de dados.
-dcnEnable   Este comutador ativa o serviço de Notificações de mudança de dados.
-dcnDisable   Este comutador desativa o serviço de Notificações de mudança de dados.
Tabela 3. Comutadores de linha de comandos para o doorsd no Rational DOORS
Comutador (abreviatura) Parâmetro Descrição
-minstall -port port_number -serverdata server_data_path Este comutador cria um serviço de servidor de banco de dados do Rational DOORS em máquinas que estejam executando sistemas operacionais Windows, em que portnumber é igual à porta de conexão de dados e server_data_path é igual à pasta de diretório de dados no servidor.

Por exemplo:

"doorsd -minstall -port 36666 -serverdata C:\Program Files(x86)\IBM\Rational\DOORS\9.6\new_data._ Um número de instância, como 00001, é designado ao novo serviço.

-remove   Este comutador remove o serviço padrão criado quando o servidor do banco de dados do Rational DOORS é instalado na primeira vez.
-mremove -i service_instance_number Este comutador remove uma instância específica de um serviço do servidor de banco de dados do Rational DOORS no qual portnumber é igual ao número de instância designado ao nome do serviço de banco de dados.
-list   Este comutador emite uma lista, em formato de tabela, de todos os serviços de banco de dados configurados do Rational DOORS e seus status.
-logfile log_file Este comutador configurou o arquivo utilizado para a criação de log de transações do servidor do banco de dados do Rational DOORS. Para obter uma descrição de níveis de log, consulte Arquivos de log.
-loglevel log_level Este comutador define o nível de detalhe para informações que são registradas pela criação de log transacional do servidor de banco de dados do Rational DOORS. Utilize o valor 0 para desativar a criação de log. Utilize o valor 6 para produzir o máximo de detalhes.
-start   Este comutador inicia o serviço do servidor de banco de dados do Rational DOORS padrão.
-stop   Este comutador interrompe o serviço do servidor de banco de dados do Rational DOORS padrão.

Exemplo de Comando da Linha de Comandos

Você pode utilizar comutadores de linha de comandos na linha de comandos e em atalhos.

Para encerrar um servidor que está sendo executado em 36677@IBMEDSERV, insira este comando:
dbadmin -data 36677@abc -killserver

Exemplo de Comando de Atalho

Para iniciar um servidor, utilize o atalho a seguir. Revise o comando para refletir seu caminho da instalação do Rational DOORS.
"C:\Program Files\IBM\Rational\DOORS\9.version\bin\doorsd.exe" -start -debug
Nota: Utilize o -debug quando você iniciar o servidor de banco de dados do Rational DOORS a partir da linha de comandos.

Feedback