Configure um banco de dados Oracle para funcionar com o Jazz Team Server.
Antes de Iniciar
Isso assume que os seguintes pré-requisitos foram atendidos. Consulte sua documentação do Oracle ou um administrador de banco de dados (DBA) Oracle para obter ajuda.
- O Oracle é instalado em uma máquina que será utilizada como o servidor de banco de dados. Essa máquina pode ser uma diferente daquela na qual o Jazz Team Server executa.
- Um banco de dados padrão no servidor Oracle.
Dica: Ao instalar o Oracle, você tem a opção de criar um banco de dados automaticamente.
Importante: Para assegurar a manipulação adequada do conteúdo Unicode, o conjunto de caracteres do banco de dados
deve ser a codificação UTF-8.
- O usuário que executa essas instruções possui autoridade de administração do sistema no banco de dados Oracle.
Ao executar o Jazz Team Server no Oracle, crie um espaço de tabela Oracle para melhorar o desempenho. Crie um usuário vinculado a esse espaço de tabela.
Lembre-se: Nenhuma dessas etapas é executada pelo construtor do banco de dados com as ferramentas de repositório.
Sobre Esta Tarefa
Para configurar um banco de dados Oracle:
Procedimento
- Crie um espaço de tabela. O local do espaço de tabela deve ser adequado à máquina e à unidade de disco.
Essa etapa deve ser executada por um usuário com privilégios de DBA.
Nota: O espaço de tabela pode ter qualquer uma dessas propriedades:
- Um nome diferente de oracle_tbs.
- Um local em outro diretório.
- Um tamanho maior que 1 GB.
Para instalações maiores, é necessário alocar mais espaço.
O exemplo
abaixo mostra uma instrução create executada em uma máquina Windows®:
CREATE BIGFILE TABLESPACE oracle_tbs DATAFILE 'D:\oracle_tbs\oracle_tbs.dbf' SIZE 1G AUTOEXTEND ON EXTENT MANAGEMENT LOCAL AUTOALLOCATE;
Importante: O caminho do diretório (neste exemplo D:\oracle_tbs) deve existir. Não é necessário criar um espaço de tabela especial separado.
É possível utilizar o usuário Oracle padrão USERS, mas o Oracle executa melhor com um espaço pré-alocado no disco que ele gerencia.
- Crie um usuário Oracle.
Depois de o espaço de tabela ser criado, um usuário especial do Oracle deve ser criado para o Jazz utilizar o banco de dados Oracle.
Nesse exemplo, o usuário tem o nome jazzDBuser e a senha (IDENTIFIED
BY em termos do Oracle) jazzDBpswd e existe no espaço de tabela criado em 1.
CREATE USER jazzDBuser IDENTIFIED BY jazzDBpswd DEFAULT TABLESPACE oracle_tbs;
Depois de o
usuário ser criado, o usuário deverá receber as permisssões necessárias para inicializar o banco de dados do Jazz. Os
comandos SQL a seguir pode ser utilizado para conceder as permissões adequadas:
GRANT CREATE SESSION TO jazzDBuser;
GRANT CREATE TABLE, ALTER ANY TABLE, DROP ANY TABLE, CREATE ANY INDEX, ALTER ANY INDEX, DROP ANY INDEX TO jazzDBuser;
GRANT INSERT ANY TABLE, UPDATE ANY TABLE, DELETE ANY TABLE TO jazzDBuser;
GRANT CREATE PROCEDURE TO jazzDBuser;
GRANT CREATE VIEW TO jazzDBuser;
- Localize o arquivo teamserver.properties no diretório JazzInstallDir/server/conf/jazz e renomeie-o para teamserver.OtherDBProvider.properties.
- Localize o arquivo teamserver.oracle.properties no diretório JazzInstallDir/server/conf/jazz e
renomeie-o para teamserver.properties.
Dica: Renomear o arquivo teamserver.properties original permite que você restaure o arquivo na versão de trabalho anterior. Por padrão,
o Provedor do DB é derby.
- Configure o servidor.
- Edite o arquivo de configuração do servidor se tiver utilizado um nome de usuário, uma senha ou um nome de BD diferente,
instalado o Oracle Server em uma máquina diferente do Jazz Team Server ou estiver utilizando uma porta diferente do padrão. Abra o arquivo teamserver.properties no diretório JazzInstallDir/server/conf/jazz, e altere as informações listadas a seguir para corresponder à sua configuração.
com.ibm.team.repository.db.vendor = ORACLE
com.ibm.team.repository.db.jdbc.location=thin:jazzDBuser/{password}@localhost:1521/ORCL
Altere jazzDBuser com o usuário criado para o Jazz para
utilizar o banco de dados Oracle. Se estiver utilizando o host local, remova o comentário desta linha removendo o # do início
da linha e comente a próxima linha de local. As cadeias de conexão do host local não devem incluir as // precedentes. Mude 1521 pela porta TCIP da máquina do Oracle Server. Mude ORCL pelo nome do seu banco de dados Oracle.
com.ibm.team.repository.db.jdbc.location=thin:jazzDBuser/{password}@//oracleserver.example.com:1521/ORCLLembre-se: As URLs de local do Oracle podem ter diversos formatos. Os exemplos aqui funcionam sob a maioria das circunstâncias. Consulte a documentação do JDBC do Oracle para obter detalhes adicionais.
Se estiver utilizando uma conexão que não seja do host local, remova o comentário
desta linha removendo o # do início da linha e comente a linha de local anterior. Cadeias de conexão
que não sejam do host local devem incluir as // precedentes.
com.ibm.team.repository.db.jdbc.password=jazzDBpswd
Altere jazzDBpswd com a senha do usuário criado para o Jazz para utilizar o banco de dados Oracle.
Importante: Não altere o texto {password}
na propriedade com.ibm.team.repository.db.jdbc.location.
A senha do usuário deve ser especificada na propriedade com.ibm.team.repository.db.jdbc.password.
Se estiver utilizando o Oracle Express, utilize 1521 como a porta TCIP e XE como o nome do banco de dados Oracle:
com.ibm.team.repository.db.vendor = ORACLE
com.ibm.team.repository.db.jdbc.location=thin:jazzDBuser/{password}@localhost:1521/XE
com.ibm.team.repository.db.jdbc.password=jazzDBpswd
- No mesmo diretório que os scripts do servidor (JazzInstallDir/server),
crie um diretório chamado oracle.
- Localize o arquivo JAR do driver JDBC do Oracle, chamado ojdbc14.jar.
O local pode variar dependendo do produto Oracle e do sistema operacional. Copie esse arquivo para o diretório chamado oracle.
Nota: Se estiver utilizando o WebSphere Application Server,
configure uma propriedade chamada "ORACLE_JDBC" e, em seguida, configure-a para o caminho de diretório absoluto (não uma URL) que contém os drivers do JDBC do Oracle, por exemplo, se o seu ojdbc14.jar estive localizado em JazzInstallDir/server/oracle.
Essa tarefa é descrita nas instruções de configuração do WebSphere Application Server. Anote o caminho do arquivo para uso posterior nessas instruções.
- Abra uma janela do SQL Plus e digite o seguinte comando:
GRANT DBA TO jazzDBuser;