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
- 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
- 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
- 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
- Caricare gli script JACL, che includono i comandi exportToFile e
importFile nella shell di comandi wsadmin: wsadmin>
source teamAdminUtils.jacl
- 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".
- 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
- 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
- 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.
- 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.