Configurazione del database Oracle per l'utilizzo con Jazz Team Server.
Prima di iniziare
Questa procedura presume che siano stati soddisfatti i seguenti prerequisiti. Consultare la documentazione
di Oracle oppure rivolgersi a un DBA (database administrator) Oracle per un ausilio.
- Oracle è installato sul computer da utilizzare come server database. Questo computer può essere diverso da quello sui cui viene eseguito Jazz Team Server.
- Sul server Oracle esiste un database predefinito.
Suggerimento: Quando si installa
Oracle, si ha l'opzione di creare un database automaticamente.
Importante: Per garantire una corretta gestione del contenuto Unicode,
l'insieme di caratteri del database deve essere in codifica UTF-8.
- L'utente che esegue queste istruzioni dispone dell'autorizzazione di amministrazione
del sistema sul database Oracle.
Quando si esegue Jazz Team Server su
Oracle, creare un tablespace Oracle per migliorare le prestazioni. È necessario
creare un utente collegato a tale tablespace.
Attenzione: Nessuno di questi
passi viene eseguito dal programma di creazione dei database con gli strumenti repository.
Informazioni su questa attività
Per configurare un database Oracle:
- Creare un tablespace. L'ubicazione del tablespace deve essere appropriata per il computer e l'unità disco.
Questo passo deve essere eseguito da un utente con privilegi DBA.
Nota: Il tablespace può avere una qualsiasi delle seguenti proprietà:
- Un nome diverso da oracle_tbs
- Un'ubicazione in un'altra directory
- Una dimensione superiore a 1GB. Per installazioni di grandi dimensioni, è necessario allocare più spazio.
L'esempio sottostante mostra un'istruzione di creazione eseguita su un computer Windows®:
CREATE BIGFILE TABLESPACE oracle_tbs DATAFILE 'D:\oracle_tbs\oracle_tbs.dbf' SIZE 1G AUTOEXTEND ON EXTENT MANAGEMENT LOCAL AUTOALLOCATE;
Importante: Il percorso di directory (in questo esempio D:\oracle_tbs)
deve esistere. Non è necessario creare una tablespace speciale separata.
È possibile utilizzare la tablespace USERS predefinita di Oracle, ma
le prestazioni di Oracle sono migliori con uno spazio preassegnato sul disco che gestisce.
- Creare un utente Oracle.
Una volta creata la tablespace, è necessario creare un utente Oracle speciale per Jazz per
utilizzare il database Oracle.
In questo esempio, l'utente ha il nome jazzDBuser e la password (IDENTIFIED
BY, in termini Oracle) jazzDBpswd ed esiste nella tablespace creata al punto 1.
CREATE USER jazzDBuser IDENTIFIED BY jazzDBpswd DEFAULT TABLESPACE oracle_tbs;
Una volta creato
l'utente, è necessario concedergli le autorizzazioni necessarie per poter inizializzare il database Jazz. Per concedere
le autorizzazioni appropriate, è possibile utilizzare i seguenti comandi SQL:
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;
- Individuare il file teamserver.properties nella directory JazzInstallDir/server/conf/jazz e ridenominarlo come teamserver.OtherDBProvider.properties.
- Individuare il file teamserver.oracle.properties nella
directory JazzInstallDir/server/conf/jazz e ridenominarlo come teamserver.properties.
Suggerimento: Ridenominare il file teamserver.properties originale
consente di ripristinare il file alla precedente versione funzionante. Per impostazione predefinita,
il provider DB è derby.
- Configurare il server
- Modificare il file di configurazione del server se si è fatto uso di un nome utente,
una password o un nome di database differenti, si è installato il server Oracle su un computer diverso da Jazz Team Server o si sta utilizzando
una porta diversa da quella predefinita. Aprire il file teamserver.properties nella directory JazzInstallDir/server/conf/jazz e
modificare le informazioni qui di seguito elencate in modo che corrispondano alla configurazione.
com.ibm.team.repository.db.vendor
= ORACLE
com.ibm.team.repository.db.jdbc.location=thin:jazzDBuser/{password}@localhost:1521/ORCL
Sostituire a jazzDBuser l'utente creato per Jazz per
utilizzare un database Oracle. Se si sta utilizzando localhost, rimuovere il commento da questa riga rimuovendo
il segno # dall'inizio della riga e impostare come commento la successiva riga di ubicazione. Le stringhe di connessione al localhost non
devono includere i caratteri // iniziali. Sostituire a 1521 la porta TCP del computer server Oracle utilizzato. Sostituire a ORCL il nome del database Oracle utilizzato.
com.ibm.team.repository.db.jdbc.location=thin:jazzDBuser/{password}@//oracleserver.example.com:1521/ORCLAttenzione: Gli URL di ubicazione Oracle possono
assumere diversi formati. Gli esempi qui riportati funzionano nella maggior parte delle circostanze. Per ulteriori dettagli, consultare la documentazione di JDBC Oracle.
Se si sta utilizzando una connessione non localhost, rimuovere il
commento di questa riga rimuovendo il segno # dall'inizio della riga e
impostare come commento la precedente riga di ubicazione. Le stringhe di connessione non localhost
devono includere i caratteri // iniziali.
com.ibm.team.repository.db.jdbc.password=jazzDBpswd
Sostituire a jazzDBpswd la password dell'utente creato per Jazz per
utilizzare il database Oracle.
Importante: Non modificare il testo {password}
nella proprietà com.ibm.team.repository.db.jdbc.location.
La password utente deve essere specificata nella proprietà com.ibm.team.repository.db.jdbc.password.
Se si sta utilizzando Oracle Express, utilizzare 1521 per la porta TCIP e XE per il nome database 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
- Nella stessa directory degli script del server (JazzInstallDir/server),
creare una directory denominata oracle.
- Individuare il file JAR del driver JDBC Oracle, denominato ojdbc14.jar.
L'ubicazione può variare a seconda del prodotto e del sistema operativo Oracle. Copiare questo file nella directory denominata oracle.
Nota: Se si sta utilizzando WebSphere Application Server,
configurare una proprietà denominata "ORACLE_JDBC" e impostarla quindi sul percorso di directory assoluto (non l'URL) che contiene
i driver JDBC Oracle, ad esempio se ojdbc14.jar si trova in JazzInstallDir/server/oracle.
Questa attività è descritta nelle istruzioni di configurazione di WebSphere Application Server. Prendere nota del percorso file per un utilizzo successivo in queste istruzioni.
- Aprire una finestra SQL Plus e immettere il seguente comando:
GRANT DBA TO jazzDBuser;