WebSphere WebSphere Enterprise Service Bus, Version 6.0.1 Sistemas operativos: AIX, HP-UX, Linux, Solaris, Windows

Mandato manageprofiles

La herramienta de línea de mandatos manageprofiles puede utilizarse para crear todos los entornos de ejecución de WebSphere ESB, como alternativa al asistente gráfico de creación de perfiles. El mandato crea perfiles, que son conjuntos de perfiles que definen el entorno de tiempo de ejecución para un gestor de despliegue, un perfil personalizado o un perfil de servidor autónomo. El mandato puede utilizarse para crear, suprimir, aumentar, reducir, listar o validar perfiles.

El asistente de creación de perfiles es una aplicación ISMP (InstallShield para multiplataformas). Puede utilizar el asistente para introducir la mayor parte de los parámetros que se describen en este tema. No obstante, algunos parámetros requieren el uso del mandato manageprofiles. Debe utilizar el mandato manageprofiles para suprimir o reducir un perfil, por ejemplo, porque el asistente de creación de perfiles no proporciona ninguna función de supresión.

Sin embargo, el asistente de creación de perfiles también realiza tareas que no pueden ejecutarse con el mandato manageprofiles. El asistente, por ejemplo, puede crear un servicio Windows para cada perfil que crea. También puede asignar puertos que no entren en conflicto en función de las asignaciones de puerto anteriores.

Cuando se utiliza el asistente de creación de perfiles (de forma interactiva o silenciosa) para crear o aumentar inicialmente un perfil, se escribe una versión de línea de mandatos de la creación o el aumento del perfil en un archivo de registro cronológico. Puede extraer esta línea de mandatos del archivo de registro cronológico, modificarla con cuidado y utilizarla para crear o aumentar otros perfiles.

Importante: Para crear correctamente un nuevo perfil de WebSphere ESB, o aumentar un perfil existente de WebSphere Application Server, primero debe utilizar el asistente de creación de perfiles o el proceso de instalación silenciosa y utilizar solamente el mandato manageprofiles para "clonar" dicho perfil o crear uno que sea muy parecido. En Utilización del mandato manageprofiles para crear y aumentar perfiles encontrará instrucciones detalladas para este procedimiento.
Consulte las secciones siguientes para obtener más información:

Tipos de perfiles

Las plantillas para cada perfil se encuentran en el directorio raíz_instalación/profileTemplates.

Este directorio contiene varios directorios que corresponden a distintos tipos de perfil. Dichos directorios son las vías de acceso que se indican en el mandato manageprofiles con la opción -templatePath. También puede especificar plantillas de perfiles que residen fuera de la raíz de instalación, si existe alguna.

El mandato manageprofiles de WebSphere ESB puede crear los tipos siguientes de perfiles de ESB:
  • El perfil de servidor autónomo utiliza la plantilla raíz_instalación/profileTemplates/default.esbserver.
  • El perfil de gestor de despliegue utiliza la plantilla raíz_instalación/profileTemplates/dmgr.esbserver.
  • El perfil personalizado utiliza la plantilla raíz_instalación/profileTemplates/managed.esbserver.

Ubicación del archivo de mandatos

El archivo de mandatos se encuentra en el directorio raíz_instalación/bin. El archivo de mandatos es un script denominado manageprofiles.sh para plataformas Linux y UNIX o manageprofiles.bat para plataformas Windows.

El asistente de creación de perfiles es la interfaz gráfica de usuario para la herramienta de línea de mandatos. El nombre de archivo del mandato que llama al asistente de creación de perfiles varía en función de la plataforma de sistema operativo.

Registro cronológico

Cada invocación de manageprofiles creará dos archivos de registro cronológico en el directorio raíz_instalación/logs/wasprofile.
  • El archivo wasprofile_<modalidad>_nombre_perfil.log contendrá los detalles de las acciones que hayan sido invocadas por el mandato manageprofiles.
  • El archivo manageprofile_<modalidad>_nombre_perfil.log contendrá una descripción mucho más breve de las plantillas que se hayan aplicado para una invocación determinada, y los códigos de retorno correspondientes.
Por ejemplo, cuando se utiliza el mandato manageprofiles para crear un perfil denominado profile1, se crean dos archivos de registro cronológico:
  • raíz_instalación/logs/wasprofile/wasprofile_create_profile1.log
  • raíz_instalación/logs/wasprofile/manageprofile-create-profile1.log
Plataformas LINUX Plataformas UNIX

Sintaxis del mandato manageprofiles.sh

Utilice la sintaxis y los parámetros siguientes con el mandato manageprofiles para obtener información acerca de los perfiles, para suprimir perfiles o para reducir perfiles. Para crear o aumentar un perfil con manageprofiles, siga las instrucciones que se indican en Utilización del mandato manageprofiles para crear y aumentar perfiles.

Listar perfiles existentes:
# ./manageprofiles.sh -listProfiles 
                 
Eliminar el aumento más reciente para un perfil:
# ./manageprofiles.sh -unaugment 
              -profileName nombre_perfil 
Suprimir perfiles:
Nota: Debe eliminar todos los aumentos de un perfil antes de suprimir el perfil. Emita el mandato unaugment dos veces antes de emitir el mandato delete para los perfiles de WebSphere ESB. De este modo se garantiza la supresión del perfil y de todos los artefactos relacionados. Una vez que haya suprimido un perfil, suprima manualmente el contenido del directorio raíz_perfil antes de intentar volver a crear el perfil.
# ./manageprofiles.sh -unaugment 
              -profileName nombre_perfil
# ./manageprofiles.sh -unaugment 
              -profileName nombre_perfil
# ./manageprofiles.sh -delete 
                -profileName nombre_perfil | -profilePath vía_acceso_perfil
                
Obtener el nombre de un perfil existente de su vía de acceso:
# ./manageprofiles.sh -getName 
                 -profilePath vía_acceso_perfil
                
Obtener la vía de acceso de un perfil existente de su nombre:
# ./manageprofiles.sh -getPath 
                 -profileName nombre_perfil
                
Comprobar la integridad del registro de perfil:
# ./manageprofiles.sh -validateRegistry 
                
Comprobar la integridad del registro de perfil, eliminando los perfiles que no se encuentran:
# ./manageprofiles.sh -validateAndUpdateRegistry 
                 [-backup nombre_archivo]
                
Obtener ayuda para el mandato:
# ./manageprofiles.sh -help

# ./manageprofiles.sh -nombre_opción -help
Para plataformas Windows

Sintaxis del mandato manageprofiles.bat

Listar perfiles existentes:
manageprofiles -listProfiles 
             
Eliminar el aumento más reciente para un perfil:
manageprofiles -unaugment 
               -profileName nombre_perfil
Suprimir perfiles:
Nota: Debe eliminar todos los aumentos de un perfil antes de suprimir el perfil. Emita el mandato unaugment dos veces antes de emitir el mandato delete. De este modo se garantiza la supresión del perfil y de todos los artefactos relacionados. Una vez que haya suprimido un perfil, suprima manualmente el contenido del directorio raíz_perfil antes de intentar volver a crear el perfil.
manageprofiles -unaugment 
               -profileName  nombre_perfil
manageprofiles -unaugment 
               -profileName  nombre_perfil
manageprofiles -delete 
              -profileName nombre_perfil | -profilePath vía_acceso_perfil
            
Obtener el nombre de un perfil existente de su vía de acceso:
manageprofiles -getName 
               -profilePath vía_acceso_completa_perfil
             
Obtener la vía de acceso de un perfil existente de su nombre:
manageprofiles -getPath 
               -profileName nombre_perfil
             
Comprobar la integridad del registro de perfil:
manageprofiles -validateRegistry 
             
Comprobar la integridad del registro de perfiles, eliminando los perfiles que no se encuentran:
manageprofiles -validateAndUpdateRegistry 
             [-backup nombre_archivo]
             
Obtener ayuda para el mandato:
manageprofiles -help

manageprofiles -nombre_opción -help

Parámetros

El mandato WebSphere ESB manageprofiles tiene el mismo conjunto de parámetros que el mandato WebSphere Process Server manageprofiles.

Consulte Parámetros del mandato manageprofiles para obtener una lista y descripciones de los parámetros que deben utilizarse con el mandato manageprofiles para WebSphere ESB.

Salida del mandato

Una vez que finalice la ejecución de un mandato de creación o de aumento, se imprimirán las sentencias siguientes en la línea de mandatos (las palabras exactas dependerán de la modalidad en la que se haya invocado manageprofiles):
  • INSTCONFSUCCESS: El perfil se ha creado correctamente.
  • INSTCONFFAILED: El perfil no ha podido crearse.
  • INSTCONFPARTIALSUCCESS: No se han podido realizar algunas acciones de configuración posteriores a la instalación no críticas.
En algunos casos, la sentencia se muestra más de una vez. Por ejemplo, para un perfil de WebSphere ESB, la línea INSTCONFSUCCESS se muestra tres veces en la línea de mandatos.

Ejemplos

UnaugmentPlataformas LINUX Plataformas UNIX
raíz_instalación/bin
manageProfiles.sh -unaugment –profileName nombre_perfil
Para plataformas Windows
raíz_instalación\bin
manageProfiles -unaugment –profileName nombrePerfil
DeletePlataformas LINUX Plataformas UNIX
raíz_instalación/bin
manageProfiles.sh -delete –profileName nombrePerfil
Para plataformas Windows
raíz_instalación\bin manageProfiles -delete
–profileName nombrePerfil
Referencia relacionada
Parámetros del mandato manageprofiles

Reference topic

Condiciones de uso | Evalúe esta página

Icono de fecha y horaÚltima actualización: 2 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. Reservados todos los derechos.
Este centro de información está basado en tecnología Eclipse. (http://www.eclipse.org)