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

É possível usar os comutadores da linha de comandos para configurar opções para o comando dbadmin e para gerenciar o servidor de base de dados do IBM® 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 de comutadores da linha de comandos para o cliente Rational DOORS, consulte Comutadores da linha de comandos para o cliente Rational DOORS.

Tabela 1. Comutadores da linha de comandos para o comando dbadmin no Rational DOORS
Comutador (abreviatura) Parâmetro Descrição
-data (-d) port@DOORSserver Este comutador identifica o servidor de base de dados, em que port é o número da porta que o servidor de base de dados está usando e DOORSserver é o nome do computador em que o servidor de base 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 usadas para validação e autenticaçã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 do Rational DOORS Web Access, em que DWAserver é o nome completo do host do computador no qual o servidor da web está em execução; por exemplo,dwaserver.ibm.com.
-dwaPort porta Este comutador identifica o número da porta na qual o servidor do Rational DOORS Web Access está em execução.

Consulte as notas importantes após esta tabela sobre URIs e valores padrão.

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

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

Consulte as notas importantes após esta tabela sobre o relacionamento de protocolo e os valores de porta padrão.

-dcnEnable   Este comutador ativa as Notificações de mudança de dados necessárias para ativar a comunicação com o broker e o servidor do Rational DOORS Web Access.
-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.
Importante: Se o comutador -dwaPort estiver vazio, o valor da porta será padronizado como a porta padrão do protocolo selecionado:
Tabela 3. Comutadores da linha de comandos para o doorsd em Rational DOORS
Comutador (abreviatura) Parâmetro Descrição
-minstall -port port_number -serverdata server_data_path Este comutador cria um serviço do servidor de base de dados do Rational DOORS adicional em computadores com o sistema operacional Windows se os parâmetros forem configurados com esses valores:
  • portnumber é igual à porta de conexão de dados
  • 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 da instância, como 00001, é designado para o novo serviço.
-remove   Este comutador remove o serviço padrão que é criado quando o servidor de base de dados for instalado pela primeira vez.
-mremove -i service_instance_number Este comutador remove uma instância específica do serviço do servidor de base de dados no qual portnumber é igual ao número de instância designado para o nome do serviço de banco de dados.
-list   Este comutador gera uma lista, em formato de tabela, de todos os serviços do servidor de base de dados do Rational DOORS configurados e seu status.
-logfile log_file Este comutador configura o arquivo que é usado para a criação de log de transações do servidor de base de dados. Para obter uma descrição de níveis de log, consulte Arquivos de log.
-loglevel log_level Este comutador configura o nível de detalhes para as informações que são registradas pela criação de log transacional de servidor de base de dados. 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 base de dados padrão.
-stop   Este comutador para o serviço do servidor de base de dados 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 (x86)\IBM\Rational\DOORS\9.version\bin\doorsd.exe" -start

Feedback