Preservazione della configurazione del CM Server

Occorre preservare la configurazione dell'MBean del CM (Change Management) Server prima di personalizzare gli attributi dell'MBean o prima di effettuare l'aggiornamento a ClearQuest 7.1.x.y o 8.0.x.y o prima della reinstallazione. Se non si preserva la configurazione, qualsiasi personalizzazione effettuata viene persa.

Informazioni su questa attività

Se l'installazione di ClearCase e ClearQuest 7.1.0.x, o 8.0.x.y, include i package di supporto WAN, vengono anche installati i componenti del CM Server. Per determinare se i package di supporto WAN sono installati, controllare se la sottodirectory CM è installata nella directory comune di Rational:
  • Su Windows: %RATIONAL_INSTALL%\%RATIONAL_COMMON%\
  • Sul sistema UNIX e Linux: $RATIONAL_INSTALL/$RATIONAL_COMMON/
dove le variabili hanno il seguente significato:
  • RATIONAL_INSTALL: La directory in cui è installato il software Rational
  • RATIONAL_COMMON: La directory comune di Rational
Nota: Prima di effettuare l'aggiornamento da, o di reinstallare, ClearQuest 7.1.x.y, è necessario preservare la configurazione dell'MBean del CM Server poiché il programma di installazione non lo fa. Se non si esegue questa attività prima dell'aggiornamento o della reinstallazione, qualsiasi personalizzazione andrà persa.

È anche buona pratica esportare la configurazione dell'MBean prima di modificare qualsiasi attributo dell'MBean del CM Server utilizzando gli script wsadmin inclusi con i componenti del CM Server installati. Ciò consente di ripristinare i valori dell'MBean in una nuova configurazione funzionante se le nuove impostazioni producono risultati indesiderati.

È necessario eseguire gli script wsadmin mentre i componenti del CM Server, incluso WebSphere Application Server, sono in esecuzione. Notare che è possibile automatizzare la procedura di cattura della configurazione dell'MBean del CM Server su base periodica creando un job AT su Windows o un job cron sul sistema UNIX o Linux.

Di seguito è indicata l'ubicazione predefinita degli script del programma di utilità wsadmin del CM Server:
  • Su Windows: C:\Program Files\IBM\RationalSDLC\common\CM\scripts
  • Su sistemi UNIX e Linux: /opt/rational/common/CM/scripts
Nota: se è installato solo ClearCase o solo ClearQuest, è necessario seguire le istruzioni nella sezione successiva "Procedura per preservare manualmente le impostazioni di configurazione dell'MBean" invece di utilizzare le istruzioni in questa sezione.

Procedura

Procedura per importare ed esportare le impostazioni di configurazione dell'MBean

  1. In una finestra del prompt dei comandi, impostare la directory predefinita sull'ubicazione degli script del programma di utilità wsadmin del CM Server. Ad esempio:
    • Su Windows: # cd "C:\Program Files\IBM\RationalSDLC\common\CM\scripts"
    • Sul sistema UNIX e Linux: # cd /opt/rational/common/CM/scripts
  2. Impostare il percorso al programma di utilità wsadmin utilizzando la sintassi appropriata alla shell. Ad esempio:
    • Su Windows: # set WAS_BIN="C:\Program Files\IBM\RationalSDLC\common\eWAS\bin"
    • Sul sistema UNIX e Linux: # WAS_BIN=/opt/rational/common/eWAS/bin
  3. Avviare il programma di utilità wsadmin specificando il nome del profilo di CM Server. Per impostazione predefinita, il nome profilo predefinito di CM Server è cmprofile. Ad esempio:
    • Su Windows: # %WAS_BIN%\wsadmin -profileName cmprofile
    • Sul sistema UNIX e Linux: # $WAS_BIN/wsadmin.sh -profileName cmprofile
  4. Caricare gli script JACL, che includono i comandi exportToFile e importFile nella shell di comandi wsadmin: wsadmin> source teamAdminUtils.jacl
  5. Esportare la configurazione MBean in un file esterno alla struttura di directory di installazione del CM Server.
    Nota: Su Windows, quando si esegue uno script JACL dalla shell di comandi wsadmin,è possibile utilizzare le barre '/' nella specifica di percorso inoltrata allo script JACL. In alternativa, se si sceglie di utilizzare le barre retroverse '\', ad ogni carattere barra retroversa è necessario aggiungerne un altro per consentirne l'interpretazione. Ad esempio:
    • Su Windows: wsadmin> exportToFile C:/temp/CmServer_backups/MBean.bck
    • Sul sistema UNIX e Linux: wsadmin> exportToFile /tmp/CmServer_backups/MBean.bck
    È possibile utilizzare il comando importFile per ripristinare una configurazione MBean salvata. Utilizzare questo comando dopo aver aggiornato o reinstallato i componenti del CM Server o dopo aver effettuato modifiche alla configurazione MBean ma si desidera eseguire il rollback a una configurazione precedente.

Procedura per preservare manualmente le impostazioni di configurazione dell'MBean

Se è installato solo ClearCase o solo ClearQuest, è necessario seguire le istruzioni in questa sezione. In caso contrario, se sono installati sia ClearCase che ClearQuest, utilizzare le istruzioni nella sezione precedente "Procedura per importare ed esportare le impostazioni di configurazione dell'MBean".

  1. In una finestra del prompt dei comandi, impostare la directory predefinita sulla seguente ubicazione, sostituendo le variabili come appropriato:
    • Sostituire cmprofile se non viene utilizzato il nome profilo predefinito
    • Sostituire <nome-computer>CMProfileNode01Cell, dfltCell,<nome-computer>CMProfileNode01, o dfltNode con il nome cella o il nome nodo
    Ad esempio:
    • Su Windows: # cd "C:\Program Files\IBM\RationalSDLC\common\CM\profiles\cmprofile\config\cells\ <nome-computer>CMProfileNode01Cell\nodes\<nome-computer>CMProfileNode01\servers\server1\stp"
    • Sul sistema UNIX e Linux: # cd /opt/rational/common/CM/profiles/cmprofile/config/ cells/dfltCell/nodes/dfltNode/servers/server1/stp
  2. Copiare tutti i file .dat dalla directory predefinita in una temporanea esterna alla struttura di directory di installazione del CM Server. Ad esempio:
    • Su Windows: # copy *.dat C:\temp\CmServer_mbean_config_files
    • Sul sistema UNIX e Linux: # cp *.dat /tmp/CmServer_mbean_config_files
  3. Dopo aver aggiornato ClearCase e ClearQuest, assicurarsi che i componenti del CM Server non siano in esecuzione. Seguire le istruzioni nell'argomento Avvio, arresto e riavvio del CM Server, per arrestare i componenti del CM Server.
  4. Aprire un prompt dei comandi. Come utente root, impostare la directory predefinita sull'ubicazione indicata nel passo 6, quindi copiare i file .dat salvati dalla directory temporanea indicata al passo 7 a quella predefinita. Ad esempio:
    • Su Windows: # copy C:\temp\CmServer_mbean_config_files\*.dat
    • Sul sistema UNIX e Linux: # cp /tmp/CmServer_mbean_config_files/*.dat
    Quando i componenti del CM Server vengono avviati, i dati dai file .dat ripristinati vengono utilizzati per inizializzare gli attributi dell'MBean.


Feedback