Configure um banco de dados Oracle para funcionar com o
Jazz Team
Server.
Antes de Iniciar
Isto assume que os seguintes pré-requisitos foram atendidos. Consulte sua documentação do Oracle ou
um DBA (administrador de banco de dados Oracle) para obter ajuda.
- O Oracle é instalado em uma máquina para ser utilizado com o servidor de banco de dados. Esta máquina pode ser uma máquina diferente daquela que o
Jazz Team
Server
executa.
- Um banco de dados padrão existe no servidor Oracle.
Dica: Quando você instala o Oracle, tem a opção de
criar um banco de dados automaticamente.
Importante: Para garantir a manipulação adequada do conteúdo
Unicode, o conjunto de caracteres de banco de dados deve ter a codificação UTF-8.
- O usuário que realiza estas 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 aprimorar o desempenho. Você deve criar um usuário vinculado
a este espaço de tabela.
Lembre-se: Nenhuma dessas etapas é realizada por um criador do banco de dados com as
ferramentas do repositório.
Por Que e Quando Desempenhar Esta Tarefa
Para configurar um banco de dados Oracle:
- Crie um espaço de tabela. O local do espaço de tabela deve ser apropriado para a máquina e a unidade de disco.
Esta etapa deve ser executada por um usuário com privilégios DBA.
Nota: O espaço de tabela pode ter uma destas propriedades:
- Um nome diferente de oracle_tbs
- Um local em outro diretório
- Um tamanho maior do que 1 GB. Para instalações maiores, você precisa 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 espaço de tabela
USERS padrão do Oracle, mas o Oracle tem um desempenho melhor com um espaço previamente
alocado no disco que ele gerencia.
- Crie um usuário Oracle.
Após o espaço de tabela ser criado, um usuário especial Oracle deve ser criado para o
Jazz utilizar o banco de dados
Oracle.
Neste exemplo, o usuário tem o nome jazzDBuser e a senha (IDENTIFIED
BY nos termos do Oracle) jazzDBpswd e existe no espaço de tabela criado no
1.
CREATE USER jazzDBuser IDENTIFIED BY jazzDBpswd DEFAULT TABLESPACE oracle_tbs;
Depois do usuário ser criado, ele deve receber as permissões necessárias para inicializar
o banco de dados do Jazz. Os seguintes comandos SQL podem ser usados
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 original teamserver.properties
possibilita restaurar o arquivo para a versão de trabalho anterior. Por padrão,
o Provedor do BD é derby.
- Configurar o servidor
- Edite o arquivo de configuração do servidor se você usou um nome de usuário,
senha, ou nome de BD diferente, instalou o servidor Oracle em uma máquina
diferente de Jazz Team Server
ou está usando uma porta diferente da padrão. Abra o arquivo teamserver.properties no diretório JazzInstallDir/server/conf/jazz
e altere as informações listadas abaixo para corresponderem a 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
usar o banco de dados Oracle. Se você estiver usando o host local, remova o comentário desta
linha removendo # do início da linha e comente a
próxima linha local. As cadeias de conexão do host local não devem incluir
// precedente. Altere 1521 com sua porta TCIP da máquina servidor
Oracle. Altere ORCL com seu nome do banco de dados Oracle.
com.ibm.team.repository.db.jdbc.location=thin:jazzDBuser/{password}@//oracleserver.example.com:1521/ORCLLembre-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.
Se
você estiver usando uma conexão não de host local, remova o comentário desta linha removendo
o # do início da linha e comente a linha local
anterior. As cadeias de conexão não de host local devem incluir
// precedente.
com.ibm.team.repository.db.jdbc.password=jazzDBpswd
Altere
jazzDBpswd com a senha do usuário criado para o Jazz para
usar o banco de dados Oracle.
Importante: Não altere o texto {password}
na propriedade com.ibm.team.repository.db.jdbc.location.
A senha de usuário deve ser especificada na propriedade com.ibm.team.repository.db.jdbc.password.
Se
você estiver usando o Oracle Express, use 1521 para a porta TCIP e XE para 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 o dos scripts de servidor
JazzInstallDir/server),
crie um diretório denominado oracle.
- Localize o arquivo JAR do driver JDBC Oracle, denominado ojdbc14.jar.
O local pode variar dependendo do produto Oracle e do sistema operacional. Copie este arquivo no diretório denominado oracle.
Nota: Se estiver usando o WebSphere Application Server, configure uma propriedade chamada "ORACLE_JDBC"; depois configure-a para o caminho do diretório absoluto (não URL) que contém os drivers JDBC Oracle, por exemplo, se seu ojdbc14.jar estiver localizado em JazzInstallDir/server/oracle.
Esta tarefa é descrita nas instruções de configuração do
WebSphere Application
Server. Faça uma anotação do caminho de arquivo para utilização posterior nestas instruções.
- Abra uma janela SQL plus e digite o seguinte comando:
GRANT DBA TO jazzDBuser;