Comutadores de linha de comandos para o servidor de banco de dados

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

Tabela 1. Comutadores da linha de comandos para o comando dbadmin no 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 mais informações sobre a criação de log, incluindo uma descrição dos níveis de log, consulte Arquivos de log.
-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.
-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.

Tabela 2. Comutadores de linha de comandos para o dbadmin no IBM Engineering Requirements Management DOORS - Web Access (DWA)
Comutador (abreviatura) Parâmetro Descrição
-dwaHost DWAserver Esse comutador identifica o servidor DWA, em que DWAserver é o nome completo do host do computador em que o servidor da Web está sendo executado. Por exemplo, dwaserver.ibm.com.
-dwaPort porta Esse comutador identifica o número da porta na qual o servidor DWA está em execução.

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

-dwaProtocol http ou https Esse comutador especifica o protocolo que o servidor DWA 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   Esse comutador ativa as notificações de mudança de dados que são necessárias para ativar a comunicação com o servidor e o broker do DWA.
-dcnBrokerUri tcp://broker:61616 Esse comutador identifica o broker do DWA, 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 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 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.7\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 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.
-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
-secure on, ON, off, OFF Esse comutador especifica se o servidor 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 DOORS, incluindo o nome do arquivo.

O caminho padrão é DOORS\9.version\certdb\client_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 DOORS, use o comutador -keyDB.

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

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

Para colocar os arquivos de banco de dados de chaves para o SSL do DOORS 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.

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 DOORS.
"C:\Program Files (x86)\IBM\Rational\DOORS\9.7\bin\doorsd.exe" -start

ícone de Vídeo Vídeo

Canal Jazz.net
Canal Educação de Software

ícone aprender Cursos

IoT Academy
Gateway de conhecimento técnico

ícone de Pergunta Comunidade

Jazz.net
Fóruns do Jazz.net
artigos do Jazz.net

ícone de suporte Suporte

Comunidade Suporte IBM
Wiki de implantação