Configurando um Banco de Dados Oracle para Rational Engineering Lifecycle Manager e o Lifecycle Query Engine

Configure um banco de dados Oracle para trabalhar comRational Engineering Lifecycle Manager Jazz Team Server, o Rational Engineering Lifecycle Manager e o aplicativo Configuration Management.

Antes de Iniciar

Para criar e configurar um banco de dados Oracle, supõe-se que o usuário que esta preparando o banco de dados deva ter autoridade de administração do banco de dados sobre o banco de dados e que o banco de dados, o armazenamento de espaço de tabela e a configuração apropriada do armazenamento sejam criados por um usuário com autoridade de administração do sistema. Além disso, uma das edições do Oracle suportadas a seguir deve ser instalada em um computador para ser usado como o servidor de banco de dados. Esse computador pode ser diferente daquele no qual o Jazz Team Server é executado:
Nota: O driver Java™ Database Connectivity (JDBC) necessário para o Oracle 10g e 11g é ojdbc6.jar 11.2.0.3 ou posterior. Além disso, sempre atualize o banco de dados para a versão do banco de dados mais recente. Por exemplo, se o servidor de banco de dados for 11.2, você deverá executar a 11.2.0.3 ou mais recente.
Importante: Os parâmetros de configuração e opções de espaço de tabela a seguir são exemplos e podem não se aplicar inteiramente a seu ambiente. Por exemplo, se não for possível usar a configuração AUTOEXTEND, então os arquivos devem ser grandes o suficiente para permitirem o crescimento. Ou, se não for possível usar a cota de tamanho UNLIMITED para o usuário do banco de dados Jazz Team Server, certifique-se de deixar espaço suficiente para rápido crescimento.
Importante: Se você instalar aplicativos do Rational Engineering Lifecycle Manager no mesmo computador ou plataformas distribuídas, será possível criar bancos de dados separados para cada aplicativo ou usar o mesmo banco de dados para todos os aplicativos. No entanto, você deve criar um espaço de tabela separado e um usuário do banco de dados associado a esse espaço de tabela para cada aplicativo.

Os exemplos deste tópico são para um banco de dados Oracle com usuários do banco de dados separados dedicados a cada aplicativo.

Nota: O banco de dados criado para o Jazz Team Server e todos os aplicativos Rational Engineering Lifecycle Manager devem ser formatados para usar UTF-8 como o conjunto de caracteres. Por padrão, o Oracle não cria um banco de dados com o conjunto de caracteres UTF-8. Ao criar um novo banco de dados, assegure-se de ter selecionado AL32UTF8 na configuração do BD Oracle.

Procedimento

  1. Como um administrador do sistema, crie um banco de dados com a codificação UTF8 para o Jazz Team Server e todos os aplicativos.
  2. Abra uma janela SQL *Plus e crie os espaços de tabela de banco de dados:
    CREATE TABLESPACE <espaço de tabela do usuário do relmjts> 
    DATAFILE '<path and name of .dbf file>' 
    SIZE 1G AUTOEXTEND ON EXTENT MANAGEMENT LOCAL AUTOALLOCATE;
    CREATE TEMPORARY TABLESPACE <espaço de tabela temp do usuário do relmjts> 
    TEMPFILE '<path and name of the temp .dbf file>' 
    SIZE 20M AUTOEXTEND ON EXTENT MANAGEMENT LOCAL UNIFORM SIZE 1M;
  3. Se você estiver instalando todos os aplicativos do Rational Engineering Lifecycle Manager, deverá repetir a etapa anterior duas vezes para criar um espaço de tabela separado para o Rational Engineering Lifecycle Manager JTS (relmjts), o Rational Engineering Lifecycle Manager (relm) e o aplicativo Configuration Management (vvc). No Oracle Enterprise Manager Database Control, verifique se os espaços de tabela criados são exibidos e estão acessíveis.
  4. Crie um usuário do banco de dados Oracle para cada novo espaço de tabela.

    Depois que os espaços de tabela forem criados, um usuário Oracle especial deverá ser criado para cada aplicativo para usar o banco de dados Oracle. Para diversos servidores Jazz executados em um banco de dados Oracle, um usuário do banco de dados Oracle deve ser criado para cada aplicativo. O usuário do banco de dados Oracle deve poder criar objetos de banco de dados em seu espaço de tabela (ilimitado ou com uma cota de espaço) com privilégios para criar sessão, tabela, procedimento e visualizações.

    Nestes exemplos, substitua as frases nos sinais de maior e menor.
    CREATE USER <usuário do bd relmjts> IDENTIFIED BY <senha> DEFAULT TABLESPACE <espaço de tabela do usuário do relmjts> QUOTA UNLIMITED ON <espaço de tabela do usuário relmjts> TEMPORARY TABLESPACE <espaço de tabela temp do usuário relmjts>;
    Após o usuário ser criado, dê ao usuário as permissões necessárias para inicializar o banco de dados Jazz. É possível usar o seguinte comando SQL para conceder as permissões apropriadas:
    GRANT CREATE PROCEDURE, CREATE SESSION, CREATE TABLE, CREATE VIEW TO <usuário do bd relmjts>;
    Nota: A criação do armazém no Oracle requer mais permissões em comparação a outros bancos de dados. Ao especificar o usuário do banco de dados na especificação da conexão para o armazém de dados, assegure-se de que o usuário do banco de dados tenha permissões de DBA. Para obter mais informações, consulte Conclua a instalação. Além disso, presume-se que um espaço de tabela denominado "USERS" já exista. Esse é um espaço de tabela Oracle padrão. Se esse espaço de tabela não existir em seu banco de dados Oracle, use o comando a seguir para criá-lo.
    CREATE TABLESPACE USERS 
    DATAFILE '<path and name of .dbf file>' 
    SIZE <tablespace size> AUTOEXTEND ON EXTENT MANAGEMENT LOCAL AUTOALLOCATE;
  5. Crie uma variável de ambiente denominada ORACLE_JDBC_DRIVER_FILE e aponte para o driver JDBC ojdbc6.jar. O local pode variar dependendo do produto Oracle e do sistema operacional. É possível fazer download do driver JDBC Oracle suportado (ojdbc6.jar 11.2.0.3) a partir de www.oracle.com.
    1. Clique em Iniciar > Painel de Controle > Sistema.
    2. Clique na guia Avançado e, em seguida, clique em Varáveis de Ambiente.
    3. Na lista Variáveis do Sistema, clique em Novo.
    4. No Nome de Variável, insira ORACLE_JDBC_DRIVER_FILE, e no Valor da Variável, insira C:\Path_to_JDBC_dirver\ojdbc6.jar.
    1. Nos sistemas Linux, inclua a seguinte declaração de variável de ambiente:
      ORACLE_JDBC_DRIVER_FILE =.;Path_to_JDBC_dirver/ojdbc6.jar
      Nota: O Rational Engineering Lifecycle Manager não suporta JRE 5.0. As versões dos JREs suportados são 6.0 e 7.0. A biblioteca de classes ojdbc5.jar requer o JRE 5.0 e a biblioteca de classes ojdbc6.jar requer o JRE 6.0 ou mais recente. Você deve usar o ojdbc6.jar.

      Se você estiver usando o WebSphere Application Server, deverá incluir também uma propriedade personalizada que aponta para o driver JDBC ojdbc6.jar. Para obter informações adicionais, consulte Configurando o WebSphere Application Server para Rational Engineering Lifecycle Manager.

  6. Para configurar sua conexão com o banco de dados e criar tabelas de banco de dados, execute uma destas etapas:
    1. Se estiver usando o Tomcat, inicie o servidor e continue com Executando o assistente de configuração Jazz Team Server para aplicativos do Rational Engineering Lifecycle Manager.
    2. Se você estiver implementando o WebSphere Application Server, veja Executando o assistente de configuração Jazz Team Server para aplicativos do Rational Engineering Lifecycle Manager.

Configurando Manualmente um Banco de Dados Oracle

Sobre Esta Tarefa

A execução do assistente de configuração é o método recomendado para configurar as conexões com o banco de dados e criar as tabelas de banco de dados. Para executar o assistente de configuração, siga as instruções em: Executando o assistente de configuração Jazz Team Server para aplicativos do Rational Engineering Lifecycle Manager

Se você preferir executar esse procedimento manualmente, use este tópico para editar o arquivo teamserver.properties para configurar uma conexão com o banco de dados Oracle e execute o comando -createTables para criar tabelas de banco de dados.

Procedimento

  1. Para cada aplicativo, há um arquivo teamserver.properties separado que você deve abrir e modificar. Esses arquivos estão localizados nos seus próprios diretórios (relmjts, relm e vvc) no diretório <Dir_de_Instalação_do_Jazz>/server/conf. Abra cada arquivo teamserver.properties e especifique os detalhes de banco de dados e conexão.
    1. Comentar as linhas a seguir a partir da Derby Configuration colocando um sinal de número (#) antes de cada linha:
      #com.ibm.team.repository.db.vendor = DERBY
      # com.ibm.team.repository.db.jdbc.location=conf/relmjts/derby/repositoryDB
    2. Remova comentário das linhas a seguir sob Oracle Configuration, removendo o sinal numérico (#) ao lado de cada linha:
      Nota: Há duas linhas para o local do banco de dados fornecido para cada repositório. Uma para os sistemas locais e uma para os servidores de banco de dados em sistemas remotos. Remova comentário apenas de uma linha que se aplique aos seu ambiente. Os exemplos aqui referem-se ao servidor remoto com 2 barras antes da URL do servidor, @//oracleserver.example.com:1521/ORCL.
      com.ibm.team.repository.db.vendor = ORACLE
      com.ibm.team.repository.db.jdbc.location=thin:relmjtsDBuser/{password}@//oracleserver.example.com:1521/ORCL
      com.ibm.team.repository.db.jdbc.password=relmjtsDBpswd
    3. Edite os valores a seguir nas linhas com.ibm.team.repository.db.jdbc.location e com.ibm.team.datawarehouse.db.jdbc.location:
      • //oracleserver.example.com:1521: Digite o nome completo do host do servidor de banco de dados.
      • jtsDBuser: Digite o usuário do banco de dados.
      • jazzDBuser: Digite o usuário do banco de dados do armazém de dados. Deve ser um DBA.
      • ORCL: Digite o nome do serviço Oracle. Ao conectar-se a um banco de dados Oracle, assegure-se de que o nome do serviço ORCL exista no computador servidor.
      Lembre-se: URLs de local do Oracle podem assumir várias formas. Os exemplos aqui funcionam sob a maioria das circunstâncias. Consulte a documentação do JDBC Oracle para obter mais detalhes.
      Nota: Não altere o texto password={password} nas propriedades com.ibm.team.repository.db.jdbc.location e com.ibm.team.datawarehouse.db.jdbc.location.
    4. Especifique a senha de usuário nas propriedades com.ibm.team.repository.db.jdbc.password e com.ibm.team.datawarehouse.db.jdbc.password.
    5. Altere o valor da linha com.ibm.team.fulltext.indexLocation=conf/relmjts/indices/workitemindex para o local do caminho completo do índice de texto completo. Por exemplo, digite com.ibm.team.fulltext.indexLocation=c:/Progra~1/IBM/JazzTeamServer/server/conf/relmjts/indices/workitemindex.
    6. Altere o valor da linha com.ibm.team.jfs.index.root.directory=indices para o local do caminho completo do diretório raiz do índice Jazz Foundation Service. Por exemplo, digite com.ibm.team.jfs.index.root.directory=c:/Progra~1/IBM/JazzTeamServer/server/conf/relmjts/indices.
  2. Após o banco de dados ser criado, execute um comando de ferramentas de repositório para criar tabelas de banco de dados.
    Importante: Execute o comando createTables somente se essa for uma nova instalação.
    Nota: O usuário que executa o comando -createWarehouse deve ter permissões de DBA. .
    Nota: Quando você executar o comando repotools, o arquivo teamserver.properties será atualizado e o arquivo original com o conteúdo original será salvo no mesmo diretório. Você também pode ver um aviso de que o URI Público não foi configurado. É possível ignorar esse aviso neste momento porque o URI Público será configurado quando em Executando o assistente de configuração Jazz Team Server para aplicativos do Rational Engineering Lifecycle Manager.
    1. Para criar as tabelas de banco de dados para o Jazz Team Server, acesse o diretório JazzInstallDir/server e execute estes comandos:
      repotools-relmjts -createTables
    2. Para criar as tabelas de banco de dados para o aplicativo Rational Engineering Lifecycle Manager, acesse o diretório RELMInstallDir/server e execute estes comandos:
      repotools-relm -createTables
    3. Para criar as tabelas de banco de dados para o aplicativo Configuration Management, acesse o diretório VVCInstallDir/server e execute estes comandos:
      repotools-vvc -createTables

Feedback