Configurazione di un database SQL Server

Questo argomento descrive la procedura di configurazione di un database SQL Server da utilizzare con IBM® Rational Quality Manager.

In questa procedura si suppone che siano stati soddisfatti i seguenti prerequisiti:

Nota: il nome di accesso predefinito specificato nel file RQM_install_dir/server/conf/jazz/teamserver.properties per un database SQL Server è jazzDBuser e la password predefinita è jazzDBPswd. Questi valori vengono utilizzati nella procedura seguente per la creazione di un database. È possibile sostituirli con il nome utente e la password per il database.

Configurazione di un database

Nota: questa sezione descrive la procedura di configurazione del database SQL Server utilizzando lo strumento della riga comandi sqlcmd, fornito con l'installazione di SQL Server. È inoltre possibile utilizzare uno strumento visivo, come SQL Server Studio Management, disponibile anche per la versione Express come SQL Server Studio Management Express. Per ulteriori informazioni, consultare la documentazione di SQL Server o un DBA (database administrator) di SQL Server.

Per configurare un database SQL Server utilizzando lo strumento di comandi sqlcmd:

  1. Creare un database Rational Jazz Team Server. Dallo strumento della riga comandi, immettere:
    CREATE DATABASE jazz 
    GO 
  2. Creare un utente e una password e modificare la proprietà del database Rational Jazz Team Server. Dallo strumento della riga comandi, immettere:
    CREATE LOGIN jazzDBuser
    WITH PASSWORD = 'jazzDBPswd';
    USE jazz;
    exec sp_changedbowner 'jazzDBuser'
    GO 
  3. Modificare l'ordinamento del database Rational Jazz Team Server. Dallo strumento della riga comandi, immettere:
    ALTER DATABASE jazz COLLATE SQL_Latin1_General_CP437_CS_AS 
    GO

Configurazione del server

Nota: per impostazione predefinita, il file teamserver.properties nella directory RQM_install_dir/server/conf/jazz non è configurato per la connessione ad un database SQL Server. Tutte le impostazioni predefinite, insieme ad impostazioni specifiche di SQL Server si trovano nel file teamserver.sqlserver.properties nella stessa directory.

Per configurare il server:

  1. Creare una copia di backup del file teamserver.properties prima di apportare le modifiche come descritto nel passo successivo.
    Nota: il backup del file teamserver.properties originale consente di ripristinare il file alla versione di lavoro precedente. Per impostazione predefinita, il fornitore DB è derby.
  2. Modificare il file teamserver.properties aggiungendo dei caratteri # all'inizio di ciascuna riga della sezione mostrata di seguito:
    #
    # Configurazione DERBY
    #
    # Posizione DB JDBC, specificando che questa proprietà disabilita la selezione di una posizione predefinita basata sul sistema
    #com.ibm.team.repository.db.vendor=DERBY
    #com.ibm.team.repository.db.jdbc.location=repositoryDB
  3. Modificare la seguente sezione nel file teamserver.properties e modificare le informazioni elencate di seguito in modo che corrispondano alla propria configurazione.
    com.ibm.team.repository.db.vendor = SQLSERVER
    com.ibm.team.repository.db.jdbc.location=//SQL SERVER MACHINE IP:SQL SERVER TCIP PORT;databaseName=JAZZ DATABASE NAME;user=JAZZ USERNAME;password={password}
    com.ibm.team.repository.db.jdbc.password=JAZZ LOGIN PASSWORD
  4. Creare una directory denominata InstallDir/server/sqlserver e copiare il file JAR dei driver JDBC sqljdbc.jar al suo interno. Per ulteriori informazioni, consultare http://msdn2.microsoft.com/en-us/data/aa937724.aspx.
  5. Aprire server.startup.bat nella directory InstallDir/server, posizionarsi sulla riga set SQLSERVER_JDBC=%START_DIR%\sqlserver e modificare la sezione in modo che sia simile alla seguente:
    set JAVA_PTS=-Djava.awt.headless=true - 
    DSQLSERVER_JDBC="%SQLSERVER_JDBC%" -
    DORACLE_JDBC=%ORACLE_JDBC%" - DDB21_JDBC="%DB21_JDBC%" -
    DDB2Z_JDBC="%DB2Z_JDBC%" -
    Dorg.eclipse.emf.ecore.plugin.EcorePlugin.doNotLoadResourcesPlugin=true -
    Dcom.ibm.team.repository.provision.profile="%cd%"\provision_profiles -
    Dcom.ibm.team.repository.tempDir=%TEMP% -Dcom.ibm.rqm.create.samples=false -
    Xss512k -Xmx700M

La configurazione del database è terminata. A questo punto, creare le tabelle del database Rational Jazz Team Server. Per ulteriori informazioni, consultare Creazione di tabelle database del server Jazz.

Risoluzione dei problemi

Se il comando repotools non riesce, consultare il file di log denominato repotools_createTables.log, situato nella directory InstallDir/server.

Verificare inoltre che si verifichino le seguenti condizioni:

Il codice database per Rational Jazz Team Server è stato concepito come generico e standard per essere eseguito su più piattaforme database; tuttavia, esistono delle differenze tra i fornitori database enterprise nella sintassi, nelle strategie di ottimizzazione e nella semantica di blocco. Il server è stato verificato su SQL Server utilizzando una combinazione di simulazioni e test automatizzati di normali carichi di lavoro ed esecuzione del test di sollecitazioni. La simulazione di normali carichi di lavoro ha mostrato prestazioni accettabili. In alcuni casi, sono state osservate condizioni di stallo del database di istanze nei test di simultaneità automatizzati; tuttavia, tali problemi non sono stati riprodotti in modo congruente su differenti componenti hardware del server.

Il server è concepito per soddisfare numerose richieste simultanee. In casi eccezionali, potrebbero verificarsi condizioni di stallo nel database del repository, poiché oggetti simili o uguali vengono aggiornati contemporaneamente in transazioni associate alle richieste. Questi sono eventi rari ma normali. Il sistema è concepito per difendersi da tali situazioni e l'integrità dei dati viene preservata; non vi è alcuna perdita di dati. Talvolta, attività quali l'esecuzione del motore di build registrano condizioni di stallo. Generalmente, la condizione viene rilevata e l'attività viene rieseguita. La condizione di stallo potrebbe impedire la riuscita della build. In casi molto rari, potrebbe essere un'azione utente (ad esempio l'utilizzo di elementi di lavoro o di un codice sorgente) a venire interrotta in modo anomalo per risolvere una condizione di stallo. In tal caso, l'azione utente non riesce e viene visualizzato un errore con dettagli relativi alla suddetta condizione. L'utente può ritentare l'azione.

Tutte le condizioni di stallo incontrate vengono registrate sul server per fornire informazioni sugli eventi verificatisi nel momento in cui è avvenuta la condizione di stallo. La voce di log ha un testo simile al seguente: com.ibm.team.repository.common.RetryableDatabaseException: Errore di serializzazione.

Se il proprio sistema incontra delle condizioni di stallo, consultare il log degli errori, disponibile all'indirizzo https://servername:9443/jazz/service/com.ibm.team.repository.common.internal.IFeedService?category=SystemLog.

Se si contrano eccezioni frequenti di condizioni di stallo, contattare l'assistenza del prodotto o consultare i forum su jazz.net per ottenere le informazioni, gli aggiornamenti o le tecniche di mitigazione più recenti.


Feedback