Configure um banco de dados Oracle para funcionar com o
Jazz Team Server para System z.
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 para System z
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 para System z
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.
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.
Você pode 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
Após
a criação do usuário, o usuário deve receber as permissões necessárias
para inicializar o banco de dados Jazz.
Os comandos SQL a seguir 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 para teamserver.OtherDBProvider.properties.
- Localize o arquivo teamserver.oracle.properties no diretório JazzInstallDir/server/conf/jazz e renomeie 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 tiver usado um nome de usuário, senha ou nome de BD diferente, instalado o Servidor Oracle em uma máquina diferente do Jazz Team Server para System z,
ou estiver usando uma porta diferente do padrão. Abra o arquivo teamserver.properties no diretório JazzInstallDir/server/conf/jazz, e altere as informações listadas abaixo para que correspondam à sua configuração.
com.ibm.team.repository.db.vendor = ORACLE
com.ibm.team.repository.db.jdbc.location=thin:jazzDBuser/{password}@localhost:1521/ORCL
Altere o jazzDBuser com o usuário criado para Jazz para usar o banco de dados Oracle. Se estiver usando localhost, remova o comentário desta linha retirando o # do início da linha e comente a próxima linha de local. Cadeias de conexão do localhost não devem incluir o // precedente. Altere 1521 por sua porta TCIP da máquina servidor do Oracle. Altere o ORCL por seu nome de banco de dados Oracle.
com.ibm.team.repository.db.jdbc.location=thin:jazzDBuser/{password}@//oracleserver.example.com:1521/ORCL
Se estiver usando uma conexão que não seja com o localhost, remova o comentário desta linha retirando o # do início da linha e comente a linha de local anterior. Cadeias de conexão que não sejam do localhost devem incluir o // precedente.
com.ibm.team.repository.db.jdbc.password=jazzDBpswd
Altere o jazzDBpswd com a senha do usuário criado para o Jazz para usar o banco de dados Oracle.
Importante: Não altere o teto {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 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 você estiver utilizando o
WebSphere Application
Server, configure uma propriedade denominada "ORACLE_JDBC"; a seguir, configure-a como o caminho absoluto do
arquivo (não a URL) para os drivers JDBC 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.