Referência de linha de comandos de ferramentas de repositório

O aplicativo de ferramentas de repositório é uma interface de linha de comando que fornece um conjunto de ferramentas para gerenciar aplicativos baseados no Jazz, como o Jazz® Team Server, o IBM® Engineering Workflow Management, o Data Collection Component, Global Configuration Management, o IBM Engineering Test Management, o Engineering Lifecycle Optimization Engineering Insights e o IBM Engineering Requirements Management DOORS® Next.

O aplicativo Repository Tools destina-se principalmente para executar migrações de bancos de dados. O aplicativo não se destina a executar backups de banco de dados. É possível usar ferramentas que são fornecidas por seu fornecedor do banco de dados para fazer backup de seu banco de dados. Consulte sua documentação do fornecedor de banco de dados para obter informações sobre como executar um backup.

Nota: Shutdown e faça backup do banco de dados antes de usar qualquer comando repotools que executem operações de manutenção do sistema.

Os scripts repotools estão em JazzInstallDir/server. Use o script que está associado ao aplicativo IBM Engineering Lifecycle Management. A Tabela 1 descreve cada script " repotools e o aplicativo associado Engineering Lifecycle Management que ele gerencia.

Tabela 1. scripts de repotools
Script	Aplicativo Engineering Lifecycle Management
repotools-jts	Jazz Team Server
repotools-ccm	IBM Engineering Workflow Management (aplicativo Change and Configuration Management)
repotools-dcc	Data Collection Component
repotools-gc	Global Configuration Management
repotools-qm	IBM Engineering Test Management (aplicativo Quality Management)
repotools-relm	IBM Engineering Lifecycle Optimization Engineering Insights
repotools-rm	IBM Engineering Requirements Management DOORS Next

Nos exemplos a seguir, repotools-jts é usado, mas os mesmos comandos podem ser usados com qualquer um dos scripts repotools que estão descritos na Tabela 1.

Nota: Se você quiser executar os comandos repotools a partir de um diretório diferente de JazzInstallDir/server, você deve alterar os arquivos *.ini em JazzInstallDir/server/conf/application/provision_profiles para usar um caminho absoluto. Por exemplo, altere url=file:./update-site no UNIX para url=file:/opt/IBM/JazzTeamServer/server/conf/application/sites/update-site, e no Windows para

url=file:c:\program
files\IBM\JazzTeamServer\server\conf\application\sites\update-site

Em z/OS, o repotools aplicativo é iniciado com a Linguagem de Controle de Tarefas (JCL). Várias tarefas de amostra são fornecidas para as funções de ferramentas de repositório mais usadas. Essas tarefas são localizadas no conjunto de dados hlq.SBLZSAMP criado pela instalação do SMP/E. Tabela 2 descreve os nomes dos membros.

Tabela 2. Tarefas associadas com funções repotools comumente usadas
Tarefa	Função das ferramentas de repositório
`BLZCREDB`	-createTables (para Db2® no z/OS)

Para executar outras funções de ferramentas de repositório, você pode copiar um dos membros do JCL de amostra do System z existente. Modifique o membro copiado alterando a instrução DD //MAINARGS para corresponder à função de ferramentas do repositório que você deseja executar no z/OS.

Autenticação do Kerberos

Alguns comandos repotools são usados contra uma execução do Jazz Team Server. O modelo de autenticação padrão é para fornecer credenciais ao usuário administrativo como parâmetros da linha de comandos ou usando um arquivo de credenciais. Para obter mais informações sobre como criar o arquivo de credenciais, consulte Comando de ferramentas do repositório para preparar um aplicativo Engineering Lifecycle Management para o logon único da arquitetura de segurança Jazz. Como alternativa, o usuário pode usar um certificado de cliente ou um cartão inteligente. Em todos os casos, o usuário deve ser um membro do grupo JazzAdmins.

Para usar o Kerberos/SPNEGO para autenticar com o servidor, deve-se executar o comando repotools-jts com o parâmetro kerberos. Se o parâmetro for configurado como windows, o tipo de autenticação será Autenticação Integrada do Windows. Se o parâmetro for configurado para qualquer outro valor, o tipo de autenticação será Kerberos. Por exemplo,

repotools-jts -repository=repositoryURL -createUser userID=UserID kerberos=true

Este comando cria o usuário UserID no servidor enquanto ele é autenticado com o Kerberos/SPNEGO.

Quando o parâmetro do Kerberos é configurado para true, a interface da linha de comandos obtém um ticket Kerberos por meio de logon do Windows ou do utilitário kinit. Assegure-se de que o cliente baseado em Java esteja configurado por meio de krb5.ini, krb5.conf, das propriedades de sistema Java (propriedades de sistema java.security.krb5.realm e java.security.krb5.kdc ou da propriedade de sistema java.security.krb5.conf). Para obter mais informações, consulte a Engineering Lifecycle Management configuração do cliente para Kerberos /SPNEGO SSO.