WebSphere WebSphere Enterprise Service Bus, Version 6.0.1 Sistemi operativi: AIX, HP-UX, Linux, Solaris, Windows

Comando manageprofiles

Lo strumento della riga comandi manageprofiles può essere utilizzato per creare tutti gli ambienti runtime WebSphere ESB, come un'alternativa alla procedura guidata di creazione del profilo grafica. Il comando crea i profili, ovvero la serie di file che definiscono l'ambiente runtime per un gestore distribuzione, un profilo personalizzato o un profilo del server autonomo. Il comando può essere utilizzato per creare, eliminare, ampliare, annullare l'ampliamento, elencare o convalidare i profili.

La procedura guidata di creazione del profilo è un'applicazione ISMP (InstallShield for Multiplatforms). E' possibile utilizzare la procedura guidata per inserire la maggior parte dei parametri descritti in questo argomento. Alcuni parametri, tuttavia, richiedono di utilizzare il comando manageprofiles. Ad esempio, è necessario utilizzare il comando manageprofiles per eliminare un profilo o per annullarne il relativo ampliamento perché la procedura guidata di creazione del profilo non fornisce una funzione di eliminazione.

Tuttavia, la procedura guidata di creazione del profilo esegue anche attività che il comando manageprofiles non esegue. Ad esempio, la procedura guidata può creare un servizio Windows per ogni profilo generato. Inoltre, può assegnare delle porte non in conflitto basate sulle assegnazioni di porte precedenti.

Quando la procedura guidata di creazione del profilo viene utilizzata (in modalità interattiva o non presidiata) per creare o ampliare inizialmente un profilo, una versione della riga comandi di creazione o di ampliamento del profilo viene scritta in un file di log. E' possibile estrarre questa riga comandi dal file di log, modificarla con attenzione ed utilizzarla per creare o ampliare altri profili.

Importante: per creare correttamente un nuovo profilo WebSphere ESB o per ampliare un profilo WebSphere Application Server esistente, per prima cosa è necessario utilizzare il processo di installazione non presidiata o la procedura guidata di creazione del profilo ed utilizzare solo il comando manageprofiles per "clonare" un profilo o crearne uno molto simile. Utilizzo del comando manageprofiles per la creazione e l'ampliamento di profili contiene delle istruzioni dettagliate per questa procedura.
Per ulteriori informazioni, fare riferimento alle seguenti sezioni:

Tipi di profilo

I modelli di ogni profilo si trovano nella directory install_root/profileTemplates.

All'interno di questa directory sono presenti varie directory che corrispondono a tipi di profilo differenti. Queste directory si trovano nei percorsi indicati nel comando manageprofiles con l'opzione -templatePath. Inoltre, è possibile specificare i modelli del profilo che si trovano fuori della root di installazione, se esistono.

Il comando manageprofiles in WebSphere ESB può creare i seguenti tipi di profili ESB:
  • Il profilo del server autonomo che utilizza il modello install_root/profileTemplates/default.esbserver.
  • Il profilo del gestore distribuzione che utilizza il modello install_root/profileTemplates/dmgr.esbserver.
  • Il profilo personalizzato che utilizza il modello install_root/profileTemplates/managed.esbserver.

Ubicazione del file di comando

Il file di comando si trova nella directory install_root/bin. Il file di comando è uno script denominato manageprofiles.sh per piattaforme Linux e UNIX o denominato manageprofiles.bat per piattaforme Windows.

La procedura guidata di creazione del profilo è l'interfaccia grafica utente/graphical user interface per lo strumento della riga comandi. Il nome del file del comando che richiama la procedura guidata di creazione del profilo varia per sistema operativo in base alla piattaforma.

Registrazione

Ogni richiamo di manageprofiles creerà due log nella directory install_root/logs/wasprofile.
  • wasprofile_<mode>_profile_name.log conterrà i dettagli delle azioni richiamate dal comando manageprofiles.
  • manageprofile_<mode>_profile_name.log conterrà una descrizione molto più breve dei modelli applicati per un richiamo specifico e per i relativi codici di ritorno.
Ad esempio, quando il comando manageprofiles viene utilizzato per creare un profilo denominato profile1, vengono creati due file di log:
  • install_root/logs/wasprofile/wasprofile_create_profile1.log
  • install_root/logs/wasprofile/manageprofile-create-profile1.log
LINUX platforms UNIX platforms

Sintassi del comando manageprofiles.sh

Utilizzare i seguenti parametri e sintassi con il comando manageprofiles per ottenere informazioni sui profili, su come eliminare i profili o su come annullare l'ampliamento di profili. Per creare o ampliare un profilo con manageprofiles, seguire le istruzioni contenute in Utilizzo del comando manageprofiles per la creazione e l'ampliamento di profili.

Elencare i profili esistenti:
# ./manageprofiles.sh -listProfiles 
                 
Rimuovere l'ampliamento più recente relativo ad un profilo:
# ./manageprofiles.sh -unaugment 
              -profileName profile_name 
Eliminare i profili:
Nota: è necessario rimuovere tutti gli ampliamenti da un profilo prima di eliminarlo. Inoltrare il comando unaugment due volte prima di inoltrare il comando delete per i profili WebSphere ESB. Questa operazione assicura l'eliminazione del profilo e di tutti i relativi artefatti. Dopo aver eliminato un profilo, eliminare manualmente il contenuto della directory profile_root prima di tentare di creare nuovamente il profilo.
# ./manageprofiles.sh -unaugment
              -profileName profile_name # ./manageprofiles.sh -unaugment
              -profileName profile_name # ./manageprofiles.sh -delete 
                -profileName profile_name | -profilePath profile_path 
                
Richiamare il nome di un profilo esistente dal relativo percorso:
# ./manageprofiles.sh -getName
                 -profilePath profile_path 
                
Richiamare il percorso di un profilo esistente dal relativo nome:
# ./manageprofiles.sh -getPath 
                 -profileName profile_name                 
Verificare l'integrità del registro di profili:
# ./manageprofiles.sh -validateRegistry 
                
Verificare l'integrità del registro di profili, rimuovendo i profili non trovati:
# ./manageprofiles.sh -validateAndUpdateRegistry 
                 [-backup file_name] 
                
Richiamare la guida per il comando:
# ./manageprofiles.sh -help

# ./manageprofiles.sh -option_name -help
For Windows platforms

Sintassi del comando manageprofiles.bat

Elencare i profili esistenti:
manageprofiles -listProfiles 
             
Rimuovere l'ampliamento più recente relativo ad un profilo:
manageprofiles -unaugment 
               -profileName profile_name 
Eliminare i profili:
Nota: è necessario rimuovere tutti gli ampliamenti da un profilo prima di eliminarlo. Inoltrare il comando unaugment due volte prima di inoltrare il comando delete. Questa operazione assicura l'eliminazione del profilo e di tutti i relativi artefatti. Dopo aver eliminato un profilo, eliminare manualmente il contenuto della directory profile_root prima di tentare di creare nuovamente il profilo.
manageprofiles -unaugment
               -profileName profile_name manageprofiles -unaugment
               -profileName profile_name manageprofiles -delete
              -profileName profile_name | -profilePath profile_path
            
Richiamare il nome di un profilo esistente dal relativo percorso:
manageprofiles -getName 
               -profilePath fully_qualified_profile_path 
             
Richiamare il percorso di un profilo esistente dal relativo nome:
manageprofiles -getPath 
               -profileName profile_name              
Verificare l'integrità del registro di profili:
manageprofiles -validateRegistry 
             
Verificare l'integrità del registro di profili, rimuovendo qualsiasi profilo non trovato:
manageprofiles -validateAndUpdateRegistry 
             [-backup file_name]
             
Richiamare la guida per il comando:
manageprofiles -help

manageprofiles -option_name -help

Parametri

Il comando WebSphere ESB manageprofiles possiede la stessa serie di parametri del comando WebSphere Process Server manageprofiles.

Fare riferimento a parametri manageprofiles, per un elenco e descrizioni relative ai parametri da utilizzare con il comando manageprofiles per WebSphere ESB.

Output di comando

Al termine di un comando di creazione o di ampliamento verrà stampata una delle seguenti istruzioni nella riga comandi (la forma esatta varierà in base alla modalità con cui è stato richiamato manageprofiles):
  • INSTCONFSUCCESS: creazione del profilo riuscita.
  • INSTCONFFAILED: creazione del profilo non riuscita.
  • INSTCONFPARTIALSUCCESS: alcune azioni non critiche della configurazione successiva all'installazione non sono riuscite.
In alcuni casi l'istruzione viene stampata più di una volta. Ad esempio, per un profilo WebSphere ESB, la riga INSTCONFSUCCESS viene stampata 3 volte nella riga comandi.

Esempi

Annullamento ampliamentoLINUX platforms UNIX platforms
install_root/bin  manageProfiles.sh -unaugment –profileName profileName
For Windows platforms
install_root\bin  manageProfiles -unaugment –profileName profileName
EliminazioneLINUX platforms UNIX platforms
install_root/bin  manageProfiles.sh -delete –profileName profileName
For Windows platforms
install_root\bin  manageProfiles -delete –profileName profileName
Riferimenti correlati
parametri manageprofiles

Reference topic

Condizioni di utilizzo | Valuta questa pagina

Timestamp iconUltimo aggiornamento: 5 Mar 2006
http://publib.boulder.ibm.com/infocenter/dmndhelp/v6rxmx/index.jsp?topic=/com.ibm.websphere.wesb.doc.nl1_6.0.1\ref\rwesb_manageprofile.html

(C) Copyright IBM Corporation 2005. Tutti i diritti riservati.
Questo information center è sviluppato con tecnologia Eclipse. (http://www.eclipse.org)