Mandato manageprofiles

Utilice el mandato manageprofiles para crear, suprimir, aumentar, restaurar perfiles y realizar copias de seguridad de éstos, que definen los entornos de ejecución. Si se utilizan perfiles en lugar de instalaciones de varios productos, se ahorra espacio en disco y se simplifica la actualización del producto porque se mantiene un conjunto único de archivos de producto principales.

El archivo de mandatos se encuentra en el directorio raíz_servidor_aplic/bin. El archivo de mandatos es un script denominado manageprofiles.

Nota: La creación de un perfil ejecutando directamente manageprofiles.sh no recibe soporte en z/OS.
Recuerde: Si utiliza este mandato con la plantilla de perfiles gestionados, no se crean los servidores de aplicaciones. No obstante, se continúan utilizando los puertos si está federando un nodo.
Importante: El comportamiento predeterminado de manageprofiles es crear archivos con el conjunto de permisos 755, sin tener en cuenta la umask de todo el sistema. Si desea modificar estos permisos, utilice el mandato chmod cada vez que pase el perfil de un usuario a otro.

Sintaxis

Utilice el mandato manageprofiles para llevar a cabo las tareas siguientes:
  • crear un perfil (-create)
  • suprimir un perfil (-delete)
  • aumentar un perfil (-augment)
  • eliminar el aumento de un perfil (-unaugment)
  • reducir todos los perfiles que se han aumentado con una plantilla de aumento específica (-unaugmentAll)
  • suprimir todos los perfiles (-deleteAll)
  • listar todos los perfiles (-listProfiles)
  • listar los aumentos para un perfil (-listAugments)
  • obtener un nombre de perfil (-getName)
  • obtener una vía de acceso de perfil (-getPath)
  • validar un registro de perfil (-validateRegistry)
  • validar y actualizar un registro de perfil (-validateAndUpdateRegistry)
  • obtener el nombre de perfil por omisión (-getDefaultName)
  • hacer una copia de seguridad de un perfil (-backupProfile)
  • restaurar un perfil (-restoreProfile)
  • realizar las tareas del mandato manageprofiles contenidas en un archivo de respuestas (-response)
Para obtener ayuda detallada sobre los parámetros necesarios para cada una de las tareas realizadas con el parámetro manageprofiles, utilice el parámetro -help. El siguiente ejemplo utiliza el parámetro help con el mandato manageprofiles -augment en sistemas operativos Windows:
raíz_servidor_aplicaciones\bin\manageprofiles.bat -augment -help

En función de la operación que desee realizar con el mandato manageprofiles, es necesario proporcionar uno o más de los siguientes parámetros. La herramienta de línea de mandatos valida que se proporcionen los parámetros necesarios y que los valores especificados para dichos parámetros sean válidos. Asegúrese de escribir el nombre de los parámetros utilizando las mayúsculas y minúsculas como corresponda ya que la herramienta de línea de mandatos no valida el uso de mayúsculas y minúsculas en el nombre del parámetro. Cuando el uso de mayúsculas y minúsculas no es correcto al escribir el parámetro, se pueden producir resultados incorrectos.

  • -adminPassword contraseñaAdmin
  • -adminUserName ID_usuarioAdmin
  • -applyPerfTuningSetting standard | peak | development
  • -appServerNodeName nombre_nodo_servidor_aplicaciones
  • -augment
  • -backupFile nombre_archivoCopiaSeguridad
  • -backupProfile
  • -cellName nombre_célula (Parámetro opcional)
  • -create
  • -debug
  • -defaultPorts
  • -delete
  • -deleteAll
  • -dmgrAdminPassword contraseña
  • -dmgrAdminUserName nombre_usuario
  • -dmgrHost dmgr_host_name (Parámetro opcional)
  • -dmgrPort número_puerto_dmgr
  • -dmgrProfilePath vía_acceso_perfil_dmgr
  • -enableAdminSecurity true | false
  • -federateLater true | false
  • -getDefaultName
  • -getPath
  • -getName
  • -help
  • -hostName nombre_host
  • -ignoreStack (Parámetro opcional)
  • -importPersonalCertKS vía_acceso_almacén_claves
  • -importPersonalCertKSAlias alias_almacén_claves
  • -importPersonalCertKSPassword contraseña_almacén_claves
  • -importPersonalCertKSType tipo_almacén_claves
  • -importSigningCertKS vía_acceso_almacén_claves
  • -importSigningCertKSAlias alias_almacén_claves
  • -importSigningCertKSPassword contraseña_almacén_claves
  • -importSigningCertKSType tipo_almacén_claves
  • -isDefault
  • -isDeveloperServer
  • -keyStorePassword contraseña_almacén_claves
  • -listAugments
  • -listProfiles
  • -nodeDefaultPorts
  • -nodeName nombre_nodo
  • -nodePortsFile vía_acceso_archivo_puertos_nodo
  • -nodeProfilePathvía_acceso_perfil_nodo
  • -omitAction característica1 característica2... característicaN (Parámetro opcional)
  • -personalCertDN nombre_distinguido
  • -personalCertValidityPeriod periodo_validez (Parámetro opcional)
  • -portsFile vía_acceso_archivo (Parámetro opcional)
  • -profileName nombre_perfil
  • -profilePath raíz_perfil
  • -response archivo_respuestas
  • -restoreProfile
  • -securityLevel nivel_seguridad
  • -serverName nombre_servidor
  • -serverType DEPLOYMENT_MANAGER | ADMIN_AGENT | JOB_MANAGER
  • -setDefaultName
  • -signingCertDN nombre_distinguido
  • -signingCertValidityPeriod periodo_validez (Parámetro opcional)
  • -startingPort puerto_inicio | -portsFile vía_acceso_archivo_puertos | -defaultPorts
  • -supportedProtocols protocolos_soportados
  • -templatePath vía_acceso_plantilla
  • -unaugment
  • -unaugmentAll
  • -unaugmentDependents
  • -validateAndUpdateRegistry
  • -validatePorts
  • -validateRegistry
  • -webServerCheck true | false
  • -webServerHostnamenombre_host_servidor_web
  • -webServerInstallPath nombre_vía_acceso_instalación_servidor_web
  • -webServerName nombre_servidor_web
  • -webServerOS sistema_operativo_servidor_web
  • -webServerPluginPath vía_acceso_plugin_servidor_web
  • -webServerPort puerto_servidor_web
  • -webServerType tipo_servidor_web
El ejemplo siguiente utiliza el mandato manageprofiles -create en sistemas operativos como AIX o Linux:
raíz_servidor_aplic/bin/manageprofiles.sh -create 
   -profileName nombre_perfil 
   -profilePath raíz_perfil 
   -templatePath vía_acceso_plantilla 

Parámetros

Las opciones siguientes están disponibles para el mandato manageprofiles:

-adminPassword contraseñaAdmin
Especifique la contraseña para el ID de usuario de seguridad administrativa especificado con el parámetro -adminUserName.
-adminUserName ID_usuarioAdmin
Especifique el ID de usuario que se utiliza para la seguridad administrativa.
-applyPerfTuningSetting opción
Especifica el valor de ajuste del rendimiento que coincida con más exactitud con el tipo de entorno en el que se ejecutará el servidor de aplicaciones.

Este parámetro sólo es válido para la plantilla de perfil predeterminada.

standard
Los valores standard son los valores de configuración predeterminados estándar optimizados para un uso general.
peak
Los valores de rendimiento máximo peak se han optimizado para un entorno de producción donde los cambios de aplicación son poco frecuentes y resulta importante el rendimiento de tiempo de ejecución óptimo.
development
Los valores development están optimizados para un entorno de desarrollo donde se realizan frecuentes actualizaciones de las aplicaciones y se utiliza la mínima cantidad de recursos del sistema.
Importante: No utilice los valores de desarrollo para los servidores de producción.

Si no especifica una opción con el parámetro -applyPerfTuningSetting, el valor predeterminado es standard.

Si especifica ambos parámetros -isDeveloperServer y -applyPerfTuningSetting, en función de la opción seleccionada para -applyPerfTuningSetting, -applyPerfTuningSetting puede alterar temporalmente -isDeveloperServer.

-appServerNodeNamenombre_nodo_servidor_aplicaciones
Especifica el nombre de nodo del servidor de aplicaciones que está federando en la célula. Especifique este parámetro al crear la parte del servidor de aplicaciones de la célula y cuando cree la parte del servidor de aplicaciones de la célula.
-augment
Utilice el parámetro augment para realizar cambios en un perfil existente con una plantilla de ampliación. El parámetro augment hace que el mandato manageprofiles actualice o aumente el perfil identificado en el parámetro -profileName utilizando la plantilla del parámetro -templatePath. Las plantillas de aumento que puede utilizar están determinadas por los productos y versiones de IBM® que están instalados en el entorno.
Importante: Las plantillas que se incluyen con el producto WebSphere Application Server Network Deployment sólo se pueden utilizar para crear perfiles y no para aumentar los perfiles existentes porque con el producto sólo se envían plantillas de creación.

Además, no debe modificar manualmente los archivos que se encuentran en el directorio dir_instalación profileTemplates. Por ejemplo, si cambia los puertos durante la creación del perfil, utilice los argumentos -startingPort o -portsFile en el mandato manageprofiles en lugar de modificar el archivo en el directorio de plantillas de perfiles.

Puede especificar una vía de acceso relativa para el parámetro -templatePath si las plantillas de perfil son relativas al directorio raíz_servidor_aplicaciones/profileTemplates. De lo contrario, especifique la vía de acceso de plantilla totalmente calificada. Por ejemplo:
 manageprofiles -augment -profileName nombre_perfil -templatePath vía_acceso_plantilla

Consulte también el parámetro -unaugment.

-backupFile nombre_archivoCopiaSeguridad
Hace una copia de seguridad del archivo de registro de perfiles en un archivo especificado. Debe proporcionar una vía de acceso de archivo plenamente cualificada para el nombre_ArchivoCopiaSeguridad.
-backupProfile
Realiza la copia de seguridad de sistema de archivos de una carpeta de perfiles y los metadatos de perfiles desde el archivo de registro de perfiles. Antes de invocar al mandato manageprofiles con la opción -backupProfile primero deben detenerse todos los servidores que utilizan el perfil del que se desea hacer copia de seguridad. El parámetro -backupProfile debe utilizarse con los parámetros -backupFile y -profileName, por ejemplo:
manageprofiles(.bat)(.sh) -backupProfile -profileName nombre_perfil -backupFile nombre_archivo_copia_seguridad

Cuando hace una copia de seguridad de un perfil utilizando la opción -backupProfile, en primer lugar, debe detener el servidor y los procesos en ejecución para el perfil que desea copiar.

-cellName nombre_célula (Parámetro opcional)
Especifica el nombre de célula del perfil. Utilice un nombre de célula exclusivo para cada perfil.
Avoid trouble Avoid trouble: Utilice un nombre exclusivo incluso si piensa añadir (federar) el perfil personalizado o perfil autónomo a una célula del gestor de despliegue. El proceso de federación necesita nombres de células exclusivos para que el nodo pase a formar parte de la célula del gestor de despliegue. Un nombre de célula debe ser exclusivo en cualquier circunstancia en la que el producto se ejecute en la misma máquina física o clúster de máquinas como, por ejemplo, un sysplex. Adicionalmente, un nombre de célula debe ser exclusivo en cualquier circunstancia en la que la conectividad de red entre entidades sea necesaria ya sea entre las células o desde un cliente que deba comunicarse con cada una de las células. Los nombres de célula también deben ser exclusivos si sus espacios de nombre se federan. De lo contrario, puede encontrar síntomas como, por ejemplo, el error javax.naming.NameNotFoundException, en cuyo caso deberá crear células de nombres exclusivos.gotcha

Éste es un parámetro opcional. Si omite el parámetro, se asigna un nombre de célula predeterminado.

Los nombres de célula predeterminados son los siguientes:
  • plantilla de dmgr: nombre_perfilNetwork
  • plantilla predeterminada: nombre_host_abreviado_nombre_perfil
  • plantilla gestionada: nombre_host_abreviado_nombre_perfil
  • plantilla de célula: igual que el ejemplo dmgr anterior para los dos perfiles creados.

El valor de este parámetro no debe contener espacios ni caracteres que no sean válidos, tales como los siguientes: *, ?, ", <, >,,, /, \, |, etc.

-create
Crea el perfil.
Especifique manageprofiles -create -templatePath vía_acceso_archivo_totalmente_calificada_para_plantilla -help para obtener información específica sobre la creación de un perfil. Las plantillas disponibles incluyen:
  • cell: célula del gestor de despliegue (dmgr y default)
  • management - Gestión. Utilícelo junto con el parámetro -serverType para indicar el tipo de perfil de gestión.
  • proxyseguro- Proxy seguro
  • default: servidor de aplicaciones
  • managed: personalizada
-debug
Activa la función de depuración del programa de utilidad Ant, que utiliza el mandato manageprofiles.
-personalCertValidityPeriod periodo_validez (Parámetro opcional)
Un parámetro opcional que especifica la cantidad de tiempo en años que es válido el certificado personal predeterminado. Si no especifica este parámetro con el parámetro -personalCertDN, el certificado personal predeterminado es válido durante un año.
-defaultPorts
Asigna los valores de puerto por omisión o base al perfil.

No utilice este parámetro cuando utilice el parámetro -startingPort o -portsFile.

Durante la creación de perfiles, si no se especifica el parámetro -startingPort, el parámetro -defaultPorts o el parámetro -portsFile, el mandato manageprofiles utiliza un conjunto de puertos recomendados generados automáticamente. Los valores de puerto recomendados pueden ser distintos de los valores de puerto por omisión en función de la disponibilidad de los puertos por omisión.

Recuerde: No utilice este parámetro si está utilizando la plantilla de perfiles gestionados.
-delete
Suprime el perfil.

El directorio de perfiles se suprime cuando suprime el perfil, de modo que puede volver a crear el perfil sin tener que suprimir manualmente el directorio.

Si suprime un perfil que tenga plantillas en aumento registradas en el mismo en el registro del perfil, las acciones para eliminar el aumento se llevan a cabo automáticamente.

Avoid trouble Avoid trouble: Si está suprimiendo un antiguo nodo que se ha migrado, concluya el nuevo gestor de despliegue migrado antes de suprimir el nodo antiguo. Esto garantizará que el nuevo nodo migrado no se elimina accidentalmente de la nueva célula migrada.gotcha
-deleteAll
Suprime todos los perfiles registrados.

El directorio del perfil se suprime cuando suprime el perfil, de modo que cuando vuelve a crear el perfil no tendrá información caducada que gestionar.

Si suprime un perfil que tenga plantillas en aumento registradas en el mismo en el registro del perfil, las acciones para eliminar el aumento se llevan a cabo automáticamente.

-dmgrAdminPassword contraseña
Si federa un nodo, especifique un nombre de usuario válido para un gestor de despliegue si la seguridad administrativa está habilitada en el gestor de despliegue. Utilice este parámetro con el parámetro -dmgrAdminUserName y el parámetro -federateLater.
-dmgrAdminUserName nombre_usuario
Si federa un nodo, especifique una contraseña válida para un gestor de despliegue si la seguridad administrativa está habilitada en el gestor de despliegue. Utilice este parámetro con el parámetro -dmgrAdminPassword y el parámetro -federateLater.
-dmgrHost dmgr_host_name (parámetro opcional)
Identifica la máquina en la que se ejecuta el gestor de despliegue. Especifique este parámetro y el parámetro dmgrPort para federar un perfil personalizado cuando se crea.

El nombre de host puede ser un nombre DNS largo y corto o la dirección IP de la máquina del gestor de despliegue.

Al especificar este parámetro opcional se instruye al mandato manageprofiles que intente federar el nodo personalizado en la célula del gestor de despliegue cuando crea el perfil personalizado con el parámetro -templatePath gestionado. El parámetro -dmgrHost se ignora al crear un perfil del gestor de despliegue o un perfil del servidor de aplicaciones.

Si federa un nodo personalizado cuando el gestor de despliegue no está ejecutándose o no está disponible porque se está habilitando la seguridad o por otros motivos, el indicador de instalación de los archivos de registros cronológicos es INSTCONFFAIL para indicar una anomalía total. El perfil personalizado resultante no puede utilizarse. Debe mover el directorio del perfil personalizado fuera del repositorio de perfiles (el directorio raíz de instalación de perfiles) antes de crear otro perfil personalizado con el mismo nombre de perfil.

Si ha habilitado la seguridad o cambiado el tipo de conector JMX predeterminado, no puede federar con el mandato manageprofiles. Utilice en su lugar el mandato addNode.

El valor predeterminado para este parámetro es localhost. El valor de este parámetro debe ser un nombre de host correctamente formato y no debe contener espacios ni caracteres no válidos como los siguientes: *, ?, ", <, >, ,, /, \, |, etc. Junto con el parámetro dmgrPort también debe haber disponible una conexión con el gestor de despliegue.

-dmgrPort número_puerto_dmgr
Identifica el puerto SOAP del gestor de despliegue. Especifique este parámetro y el parámetro dmgrHost para federar un perfil personalizado cuando se crea. El gestor de despliegue debe estar ejecutándose y ser accesible.

Si ha habilitado la seguridad o ha cambiado el tipo de conector Java™ Management Extensions (JMX) predeterminado, no podrá realizar la federación con el mandato manageprofiles. Utilice en su lugar el mandato addNode.

El valor predeterminado para este parámetro es 8879. El puerto que se indique debe ser un entero positivo y junto con el parámetro dmgrHost también debe haber disponible una conexión con el gestor de despliegue.

-dmgrProfilePath vía_acceso_perfil_dmgr
Especifica la vía de acceso del perfil para la parte del gestor de despliegue de la célula. Especifique este parámetro al crear la parte del servidor de aplicaciones de la célula.
-enableAdminSecurity true | false
Habilita la seguridad administrativa. Los valores válidos son true o false. El valor predeterminado es false.
Cuando enableAdminSecurity se establece en true, también deberá especificar los parámetros -adminUserName y -adminPassword junto con los valores para estos parámetros.

No puede utilizar el parámetro -enableAdminSecurity para habilitar la seguridad administrativa para un perfil personalizado. Para habilitar la seguridad para un perfil personalizado, debe federar el perfil personalizado en un gestor de despliegue. La seguridad administrativa para el gestor de despliegue es necesaria para habilitar la seguridad para el perfil personalizado federado.

-federateLater true | false
Indica si se federará el perfil gestionado durante la creación del perfil o si se federará más adelante mediante el mandato addNode. Si los parámetros dmgrHost, dmgrPort, dmgrAdminUserName y dmgrAdminPassword no tienen valores, el valor predeterminado para este parámetro es true. Los valores válidos son true o false.
-getDefaultName
Devuelve el nombre del perfil por omisión.
-getPath
Obtiene la ubicación en el sistema de archivos de un perfil de nombre determinado. Requiere el parámetro –profileName.
-getName
Obtiene el nombre de un perfil registrado en un parámetro -profilePath determinado.
-help
Muestra la sintaxis del mandato.
-hostName nombre_host
Especifica el nombre del host donde se crea el perfil. Debe coincidir con el nombre de host especificado durante la instalación del producto inicial. El valor predeterminado de este parámetro es el formato largo del sistema de nombre de dominio. El valor de este parámetro debe ser un nombre de host IPv6 válido y no debe contener espacios ni caracteres que no sean válidos como los siguientes: *, ?, ", <, >,,, /, \, |, etc.
-ignoreStack (Parámetro opcional)
Un parámetro opcional que se utiliza con el parámetro -templatePath para reducir un perfil determinado que se ha aumentado. Consulte el parámetro -unaugment.
-importPersonalCertKS vía_acceso_almacén_claves
Especifica la vía de acceso del archivo del almacén de claves que utiliza para importar un certificado personal al crear el perfil. El certificado personal es el certificado personal predeterminado del servidor.
Best practice Best practice: Cuando importe un certificado personal como certificado personal predeterminado, importe el certificado raíz que ha firmado el certificado personal. De lo contrario, el mandato manageprofiles añade la clave pública del certificado personal al archivo trust.p12 y crea un certificado de firma raíz.bprac
Los parámetros -importPersonalCertKS y -personalCertDN se excluyen mutuamente. Si no crea ni importa de forma específicamente un certificado personal, se crea uno predeterminado.

Si especifica cualquiera de los parámetros que empiezan por -importPersonal, debe especificarlos todos.

-importPersonalCertKSAlias alias_almacén_claves
Especifica el alias del certificado que está en el archivo de almacén de claves que ha especificado en el parámetro -importPersonalCertKS. El certificado se añade al archivo de almacén de claves predeterminado del servidor y se utiliza como el certificado personal predeterminado del servidor.

Si especifica cualquiera de los parámetros que empiezan por -importPersonal, debe especificarlos todos.

-importPersonalCertKSPassword contraseña_almacén_claves
Especifica la contraseña del archivo de almacén de claves que ha especificado en el parámetro -importPersonalCertKS.

Si especifica cualquiera de los parámetros que empiezan por -importPersonal, debe especificarlos todos.

-importPersonalCertKSType tipo_almacén_claves
Especifica el tipo de archivo de almacén de claves que especifica en el parámetro -importPersonalCertKS. Los valores pueden ser JCEKS, CMSKS, PKCS12, PKCS11 y JKS. No obstante, esta lista puede cambiar en función del proveedor del archivo java.security.

Si especifica cualquiera de los parámetros que empiezan por -importPersonal, debe especificarlos todos.

-importSigningCertKS vía_acceso_almacén_claves
Especifica la vía de acceso del archivo de almacén de claves que utiliza para importar un certificado raíz al crear el perfil. El certificado raíz es el certificado que se utiliza como el certificado raíz predeterminado del servidor. Los parámetros -importSigningCertKS y -signingCertDN se excluyen mutuamente. Si no crea ni importa de forma específica un certificado de firma, se crea uno predeterminado.

Si especifica cualquiera de los parámetros que empiezan por -importSigning, debe especificarlos todos.

-importSigningCertKSAlias alias_almacén_claves
Especifica el alias del certificado que está en el archivo de almacén de claves que ha especificado en el parámetro -importSigningCertKS. El certificado se añade al almacén de claves raíz predeterminado del servidor y se utiliza como el certificado raíz predeterminado del servidor.

Si especifica cualquiera de los parámetros que empiezan por -importSigning, debe especificarlos todos.

-importSigningCertKSPassword contraseña_almacén_claves
Especifica la contraseña del archivo de almacén de claves que ha especificado en el parámetro -importSigningCertKS.

Si especifica cualquiera de los parámetros que empiezan por -importSigning, debe especificarlos todos.

-importSigningCertKSType vía_acceso_almacén_claves
Especifica el tipo de archivo de almacén de claves que especifica en el parámetro -importSigningCertKS. Los valores válidos pueden ser JCEKS, CMSKS, PKCS12, PKCS11 y JKS. No obstante, esta lista puede cambiar en función del proveedor del archivo java.security.

Si especifica cualquiera de los parámetros que empiezan por -importSigning, debe especificarlos todos.

-isDefault
Especifica que el perfil identificado por el parámetro -profileName que le acompaña debe ser el perfil por omisión una vez que se registre. Cuando se emite mandato que trata el perfil por omisión, no es necesario utilizar el atributo -profileName del mandato.
-isDeveloperServer
Especifica que el servidor está destinado únicamente a fines de desarrollo. Este parámetro es útil cuando se crean perfiles para probar aplicaciones en un servidor que no es de producción antes de desplegar las aplicaciones en los servidores de aplicaciones de producción.

Este parámetro sólo es válido para la plantilla de perfil predeterminada.

Si especifica ambos parámetros -isDeveloperServer y -applyPerfTuningSetting, en función de la opción seleccionada para -applyPerfTuningSetting, -applyPerfTuningSetting puede alterar temporalmente -isDeveloperServer.

-keyStorePassword contraseña_almacén_claves
Especifica la contraseña que se va a utilizar en todos los archivos de almacén de claves creados durante la creación del perfil. Los archivos de almacén de claves se crean para el certificado personal predeterminado y el certificado de firma raíz.
-listAugments
Lista los aumentos registrados en un perfil que se encuentra en el registro de perfiles. Debe especificar el parámetro -profileName con el parámetro -listAugments.
-listProfiles
Lista los perfiles que están en el registro de perfil.
-nodeDefaultPorts
Define un conjunto de puertos cuando se crea un perfil junto con la plantilla de una célula. Si especifica esta opción, no puede especificar las opciones -nodePortsFile o nodeStartingPort a la vez.
-nodeName nombre_nodo
Especifica el nombre de nodo del nodo creado con el nuevo perfil. Utilice un valor exclusivo en la célula o en la máquina. Cada perfil que comparte el mismo conjunto de binarios del producto debe tener un nombre de nodo exclusivo.
Existen los siguientes nombres de nodo por omisión:
  • plantilla management para el gestor de despliegue, el agente administrativo o el gestor de trabajo: nombreperfilGestor
  • plantilla predeterminada: nombre_host_abreviado_nombre_perfil
  • plantilla gestionada: nombre_host_abreviado_nombre_perfil
  • célula: consulte los ejemplos anteriores de plantilla management y default y aplique lo que sea apropiado a los dos perfiles que se crean.
  • plantilla secureproxy: nombre_host_abreviado_nombre_perfil

El valor de este parámetro no debe contener espacios ni caracteres que no sean válidos como los siguientes: *, ?, ", <, >,,, /, \, |, etc.

-nodePortsFile vía_acceso_puertos_nodo
Especifica los puertos para la parte del nodo correspondiente a la célula que está creando. Si especifica esta opción, no puede especificar las opciones -nodeDefaultPorts o nodeStartingPort a la vez.
-nodeProfilePathvía_acceso_perfil_nodo
Especifica la vía de acceso del perfil para la parte del nodo de la célula. Especifique este parámetro al crear la parte del gestor de despliegue de la célula.
-omitAction característica1 característica2... característicaN (parámetro opcional)
Parámetro opcional que excluye las características de perfil.
Cada plantilla de perfil se entrega predefinida con determinadas características opcionales. Las siguientes características opcionales pueden utilizarse con el parámetro -omitAction para las siguientes plantillas de perfil:
  • default - application server
    • deployAdminConsole
    • defaultAppDeployAndConfig
    • deployIVTApplication
  • management: perfil de gestión para el gestor de despliegue, agente administrativo o el gestor de trabajo
    • deployAdminConsole
  • cell: célula de gestor de despliegue que está compuesta de una plantilla de perfil dmgr y default
    • cell_dmgr (dmgr que se crea durante la creación de perfil de célula)
      • deployAdminConsole
      • defaultAppDeployAndConfig
-personalCertDN nombre_distinguido
Especifica el nombre distinguido del certificado personal que crea al crear el perfil. Especifique el nombre distinguido entre comillas. Este certificado personal por omisión se encuentra en el archivo de almacén de claves del servidor. El parámetro -importPersonalCertKSType es mutuamente exclusivo con el parámetro -personalCertDN. Consulte el parámetro -personalCertValidityPeriod y el parámetro -keyStorePassword.
-portsFile vía_acceso_archivo (parámetro opcional)
Un parámetro opcional que especifica la vía de acceso a un archivo que define los valores del puerto para el nuevo perfil.

No utilice este parámetro cuando utilice el parámetro -startingPort o -defaultPorts.

Durante la creación de perfiles, si no se especifica el parámetro -startingPort, el parámetro -defaultPorts o el parámetro -portsFile, el mandato manageprofiles utiliza un conjunto de puertos recomendados generados automáticamente. Los valores de puerto recomendados pueden ser distintos de los valores de puerto por omisión en función de la disponibilidad de los puertos por omisión.

-profileName nombre_perfil
Especifica el nombre del perfil. Utilice un valor exclusivo cuando cree un perfil. Cada perfil que comparte el mismo conjunto de binarios del producto debe tener un nombre exclusivo. El nombre de perfil predeterminado se basa en el tipo de perfil y un número final, por ejemplo:
<tipo_perfil><número_perfil
donde
  • <tipo_perfil es un valor como AppSrv, Dmgr, AdminAgent, JobMgr o Custom
  • <número_perfil es un número secuencial que crea un nombre de perfil único

El valor de este parámetro no debe contener espacios ni caracteres no válidos como los siguientes: *, ?, ", <, >,,, /, \, |, etc.

El nombre de perfil que elija no debe estar en uso.

-profilePath raíz_perfil
Especifica la vía de acceso completa del perfil, a la que se hace referencia como raíz_perfil.
Especifique la vía de acceso completa para evitar que se produzca una limitación de scripts Ant que puede generar una anomalía al federar el perfil en una célula. Por ejemplo:
-profilePath raíz_perfil

El valor predeterminado se basa en el directorio raíz_datos_usuario, el subdirectorio de los perfiles y el nombre del perfil.

Por ejemplo, el valor predeterminado es:
DIR_PERFIL_POR_OMISIÓN_WS_WSPROFILE/nombrePerfil
El elemento WS_WSPROFILE_DEFAULT_PROFILE_HOME se define en el archivo wasprofile.properties del directorio raíz_servidor_aplic/properties.
Nota: El archivo wasprofile.properties incluye las propiedades siguientes:
WS_CMT_PI_MODPERMS
Esta propiedad especifica si el instalador posterior debe modificar los permisos de los archivos que crea. Los valores válidos son true o false. Cualquier otro valor toma por defecto false. La eliminación de esta propiedad del archivo también hace que por omisión se use false. Cuando se establece en false, todos los archivos creados por el instalador posterior tienen permiso basado en el valor de umask del sistema.

El valor de este parámetro debe ser una vía de acceso válida para el sistema de destino y no debe estar utilizándose actualmente.

El perfil QEJBSVR debe tener permisos para grabar en el directorio.

WS_CMT_PI_LOGS
Esta propiedad especifica si y cuándo el instalador posterior debe limpiar sus registros para cada producto que se encuentra en el directorio PROFILE_HOME/logs/service/productDir. Los valores de esta propiedad le permiten especificar los siguientes criterios de limpieza de registro:
  • Puede especificar el número de registros que desea conservar para cada producto en el directorio PROFILE_HOME/logs/service/productDir. El valor especificado puede ser cualquier entero entre 1 y 999. Por ejemplo, si especifica WS_CMT_PI_LOGS=5, el instalador posterior mantiene los cinco registros más recientes para cada producto.
  • Puede especificar la cantidad máxima de almacenamiento que los registros pueden ocupar. El valor especificado puede ser cualquier entero entre 1 y 999, seguido de:
    • KB, si está especificando el valor en kilobytes.
    • MB, si está especificando el valor en megabytes.
    • GB, si está especificando el valor en gigabytes.
    Por ejemplo, si especifica WS_CMT_PI_LOGS=10MB, cuando la cantidad de almacenamiento que los registros ocupan supera los 10 megabytes, el instalador posterior inicia la supresión de los registros más antiguos.
    Avoid trouble Avoid trouble: Puesto que los valores especificados son sensibles a mayúsculas y minúsculas, las letras que se incluyen en el valor especificado deben ser letras mayúsculas.gotcha
  • Puede especificar la cantidad de tiempo que desea que el instalador posterior mantenga los registros. El valor especificado puede ser cualquier entero entre 1 y 999, seguido de:
    • D, si está especificando el valor en días.
    • W, si está especificando el valor en semanas.
    • M, si está especificando el valor en meses.
    • Y, si está especificando el valor en años.
    Por ejemplo, si especifica WS_CMT_PI_LOGS=2W, cada registro se conserva durante dos semanas.
    Avoid trouble Avoid trouble: Puesto que los valores especificados son sensibles a mayúsculas y minúsculas, las letras que se incluyen en el valor especificado deben ser letras mayúsculas.gotcha
  • Puede especificar una fecha específica después de la cual un registro se suprime. El valor debe especificarse utilizando valores numéricos, separados por guiones en el formato DD-MM-AAAA. Por ejemplo, si especifica WS_CMT_PI_LOGS=12-31-2013, todos los registros se suprimen el 31 de diciembre de 2013.
    Avoid trouble Avoid trouble: Si no especifica el valor en el formato indicado, números separados por guiones, el valor de esta propiedad se ignora.gotcha
-response archivo_respuestas
Accede a todas las funciones de la API desde la línea de mandatos utilizando el mandato manageprofiles.

La interfaz de línea de mandatos puede controlarse mediante un archivo de respuestas que contiene los argumentos de entrada para un determinado mandato en el archivo de propiedades en formato de clave y valor. Para determinar qué argumentos de entrada son necesarios para los diferentes tipos de plantillas de perfiles y acción, utilice el mandato manageprofiles con el parámetro -help.

Utilice el siguiente archivo de respuesta de ejemplo para ejecutar una operación de creación:
create
profileName=testResponseFileCreate
profilePath=raíz_perfil
templatePath=raíz_servidor_aplicaciones/profileTemplates/default
nodeName=myNodeName
cellName=myCellName
hostName=myHostName
omitAction=myOptionalAction1,myOptionalAction2
Al crear un archivo de respuestas, tenga en cuenta el siguiente conjunto de directrices:
  • Cuando especifique los valores, no especifique los caracteres comillas dobles (") al principio o al final de un valor, incluso si dicho valor contiene espacios.
    Nota: Esta es una regla diferente cuando especifique valores en la línea de mandatos.
  • Cuando especifique un valor individual que contiene un carácter de coma, como los nombres distinguidos para los parámetros personalCertDN y signingCertDN, utilice una barra doble inclinada invertida antes del carácter de coma. Por ejemplo, a continuación se indica cómo especificar el valor de signingCertDN con un nombre distinguido:
    signingCertDN=cn=testserver.ibm.com\\,ou=Root Certificate\\,
       ou=testCell\\,ou=testNode01\\,o=IBM\\,c=US 
  • Cuando se especifican varios valores, sepárelos con un carácter de coma y no utilice barras dobles inclinadas invertidas. Por ejemplo, a continuación se explica cómo especificar varios valores para el parámetro omitAction:
    omitAction=deployAdminConsole,defaultAppDeployAndConfig 
  • No especifique una línea en blanco en un archivo de respuestas. Podría generarse un error.
-restoreProfile
Importante: El mandato manageProfiles -restoreProfile solo está soportado con una copia de seguridad creada en el mismo nivel de fixpack.
Restaura una copia de seguridad de perfil. Se debe utilizar con el parámetro -backupFile, por ejemplo:
manageprofiles(.bat)(.sh) -restoreProfile -backupFile nombre_archivo
Para restaurar un perfil, realice los pasos siguientes:
  1. Detenga el servidor y los procesos en ejecución para el perfil que desea restaurar.
  2. Suprima manualmente del sistema de archivos el directorio del perfil.
  3. Ejecute la opción -validateAndUpdateRegistry del mandato manageprofiles.
  4. Restaure el perfil utilizando la opción -restoreProfile del mandato manageprofiles.
-securityLevel nivel_seguridad
Especifica los valores de nivel de seguridad inicial para el servidor proxy. Los valores válidos son low, medium y high. El valor predeterminado es high. El nivel de seguridad está basado en los permisos de usuario de inicio, las consideraciones de direccionamiento, las opciones de administración y el manejo de errores. De forma opcional, puede cambiar los valores de seguridad después de crear el perfil de servidor proxy seguro.
-serverName nombre_servidor
Especifica el nombre del servidor. Especifique este parámetro únicamente para las plantillas predeterminadas y de proxy seguro. Si no especifica este parámetro al utilizar las plantillas predeterminadas o de proxy seguro, el nombre de servidor predeterminado es server1 para el perfil predeterminado, y proxy1, para el perfil de servidor proxy.
-serverType DEPLOYMENT_MANAGER | ADMIN_AGENT | JOB_MANAGER
Especifica el tipo de perfil de gestión. Especifique DEPLOYMENT_MANAGER para un servidor de gestor de despliegue, ADMIN_AGENT para un servidor de agente administrativo, o JOB_MANAGER para un servidor de gestor de trabajos. Este parámetro es necesario cuando se crea un perfil de gestión.
-setDefaultName
Establece el perfil por omisión en uno de los perfiles existentes. Se debe utilizar con el parámetro -profileName, por ejemplo:
manageprofiles(.bat)(.sh) -setDefaultName -profileName nombre_perfil
-signingCertDN nombre_distinguido
Especifica el nombre distinguido del certificado de firma raíz que ha creado al crear el perfil. Especifique el nombre distinguido entre comillas. Este certificado personal por omisión se encuentra en el archivo de almacén de claves del servidor. Los parámetros -importSigningCertKS y -signingCertDN se excluyen mutuamente. Si no crea ni importa de forma específica un certificado de firma, se crea uno predeterminado. Consulte el parámetro -signingCertValidityPeriod y -keyStorePassword.
-signingCertValidityPeriod periodo_validez (Parámetro opcional)
Un parámetro opcional que especifica la cantidad de tiempo en años que es válido el certificado de firma raíz. Si no especifica este parámetro con el parámetro -signingCertDN, el certificado de firma raíz es válido durante 15 años.
-startingPort puertoInicio
Especifica el número de puerto de inicio para la generación y asignación de todos los puertos del perfil.

Los valores de puertos se asignan de forma secuencial a partir del valor -startingPort.

No utilice este parámetro con los parámetros -defaultPorts o -portsFile.

Durante la creación de perfiles, si no se especifica el parámetro -startingPort, el parámetro -defaultPorts o el parámetro -portsFile, el mandato manageprofiles utiliza un conjunto de puertos recomendados generados automáticamente. Los valores de puerto recomendados pueden ser distintos de los valores de puerto por omisión en función de la disponibilidad de los puertos por omisión.

Atención: No utilice este parámetro si está utilizando la plantilla de perfiles gestionados.
-supportedProtocols protocolos_soportados
Especifica los protocolos que son válidos para el servidor proxy seguro para solicitudes proxy. Los valores válidos son SIP, HTTP y HTTP,SIP.
-templatePath vía_acceso_plantilla
Especifica la vía de acceso de directorio para los archivos de plantilla en el directorio raíz de instalación. Dentro del directorio profileTemplates hay diversos directorios que corresponden a distintos tipos de perfiles y que varían según el tipo de producto instalado. Los directorios del perfil son las vías de acceso que indica al utilizar la opción -templatePath. Si tiene alguna, puede especificar las plantillas de perfiles que se encuentran fuera del directorio raíz de instalación.
La vía de acceso de las plantillas predeterminada es raíz_servidor_aplicaciones/profileTemplates/default. Puede utilizar una vía de acceso relativa para el parámetro -templatePath. La vía de acceso es relativa al directorio de trabajo actual o a raíz_servidor_aplicaciones/profileTemplates, en dicho orden. En el ejemplo siguiente se crea un perfil basado en el valor predeterminado para un servidor de aplicaciones autónomo:
manageprofiles -create -profileName MyProfile -startingPort 10380

Las plantillas disponibles se describen en el tema Conceptos relacionados con perfiles.

-unaugment
La ampliación es la capacidad de cambiar un perfil existente con una plantilla de ampliación. Para reducir un perfil que se ha aumentado, debe especificar el parámetro -unaugment y el parámetro -profileName. Si se ha realizado una serie de aumentos de manageprofiles y especifica únicamente estos dos parámetros para reducir un perfil, la acción de reducción deshace en primer lugar la última acción de aumento.

para reducir un perfil concreto que se ha aumentado, especifique adicionalmente el parámetro -ignoreStack con el parámetro -templatePath. Normalmente, no se reduce un perfil concreto porque se debe asegurar de que no está violando las dependencias de las plantillas de perfiles.

Cuando utilice el parámetro -templatePath, puede especificar una vía de acceso relativa para el parámetro.

Consulte también el parámetro augment.

-unaugmentAll
Reduce todos los perfiles que se han aumentado con una plantilla de aumento específica. El parámetro -templatePath es necesario con el parámetro -unaugmentAll.

Cuando utilice el parámetro -templatePath, puede especificar una vía de acceso relativa para el parámetro.

De forma opcional, especifique el parámetro -unaugmentDependents con el parámetro -unaugmentAll para eliminar el aumento de todos los perfiles que son requisitos previos de los perfiles que se están reduciendo.

Nota: Si utiliza este parámetro cuando no haga aumentado ningún perfil con las plantillas de perfiles, es posible que aparezca un error.

Consulte también el parámetro augment.

-unaugmentDependents
Si se especifica, el parámetro reduce todos los perfiles aumentados que son requisitos previos de los perfiles que se están reduciendo con el parámetro -unaugmentAll. Si no se especifica, no se reduce los perfiles aumentados que son requisitos previos de los perfiles que se están reduciendo.

Especifique el parámetro -unaugmentDependents con el parámetro -unaugmentAll.

-validateAndUpdateRegistry
Comprueba todos los perfiles que se listan en el registro de perfiles para ver si se encuentran en el sistema de archivos. Elimina del registro los perfiles que faltan. Devuelve una lista de los perfiles que faltan y que se eliminaron del registro.
-validatePorts
Comprueba los puertos para verificar que no están reservados ni en uso. Este parámetro ayuda a identificar puertos que no están en uso. Si se determina que un puerto está utilizándose, se detiene la creación de perfil y se visualiza un mensaje de error. Este parámetro puede utilizarse en cualquier momento en la línea de mandatos de creación. Se recomienda utilizar este parámetro con el parámetro –portsFile.
-validateRegistry
Comprueba todos los perfiles que se listan en el registro de perfiles para ver si se encuentran en el sistema de archivos. Devuelve una lista de los perfiles que faltan.
-webServerCheck true | false
Indica si desea configurar definiciones de servidor web. Los valores válidos son true o false. El valor por omisión para este parámetro es false.
-webServerHostname nombre_host_servidor_web
Nombre de host del servidor. El valor predeterminado de este parámetro es el nombre de host completo de la máquina local.
-webServerInstallPath nombre_vía_acceso_instalación_servidor_web
Vía de acceso de instalación del servidor web, local o remoto. El valor predeterminado de este parámetro depende del sistema operativo de la máquina local y del valor del parámetro webServerType. Por ejemplo:
webServerType=IHS: webServerInstallPath defaulted to “n\a”
webServerType=IIS: webServerInstallPath defaulted to “n\a”
webServerType=SUNJAVASYSTEM: webServerInstallPath defaulted to “n\a”
webServerType=DOMINO: webServerInstallPath defaulted to “n\a”
webServerType=APACHE: webServerInstallPath defaulted to “n\a”
webServerType=HTTPSERVER_ZOS: webServerInstallPath defaulted to “n\a”
-webServerName nombre_servidor_web
Nombre del servidor web. El valor predeterminado para este parámetro es webserver1.
-webServerOS sistema_operativo_servidor_web
Sistema operativo en el que reside el servidor web. Los valores válidos incluyen: windows, linux, solaris, aix, hpux, os390 y os400. Utilice este parámetro con el parámetro webServerType.
-webServerPluginPath vía_acceso_plugin_servidor_web
Vía de acceso a los plug-ins que utiliza el servidor web. El valor predeterminado para este parámetro es WAS_HOME/plugins.
-webServerPort puerto_servidor_web
Indica el puerto desde el que se accederá al servidor web. El valor predeterminado para este parámetro es 80.
-webServerType tipo_servidor_web
Tipo de servidor web. Los valores válidos son: IHS, SUNJAVASYSTEM, IIS, DOMINO, APACHE y HTTPSERVER_ZOS. Utilice este parámetro con el parámetro webServerOS.

Ejemplo de uso

Los siguientes ejemplos muestran la sintaxis correcta. Emita el mandato en cualquiera de estos ejemplos en una línea. Cada ejemplo muestra el mandato en más de una línea para ofrecer una mayor claridad.

  • Creación de un gestor de despliegue

    En el ejemplo siguiente se utiliza la plantilla management para crear un gestor de despliegue denominado Dmgr001. Los puertos del gestor de despliegue empiezan en el puerto 20000.

    manageprofiles -create
       -profileName Dmgr001
       -profilePath raíz_perfil
       -templatePath management
       -serverType DEPLOYMENT_MANAGER
       -startingPort 20000
  • Creación de un agente administrativo

    El ejemplo siguiente utiliza la plantilla de gestión para crear un agente administrativo denominado AdminAgent001. Los puertos del agente administrativo empiezan en el puerto número 24000.

    manageprofiles -create
       -profileName AdminAgent001
       -profilePath raíz_perfil
       -templatePath management
       -serverType ADMIN_AGENT
       -startingPort 24000
  • Creación de un gestor de trabajo

    El ejemplo siguiente utiliza la plantilla de gestión para crear un gestor de trabajos denominado JobMgr001. Los puertos del gestor de trabajos empiezan en el puerto 25000.

    manageprofiles -create
       -profileName JobMgr001
       -profilePath raíz_perfil
       -templatePath management
       -serverType JOB_MANAGER
       -startingPort 25000
  • Creación de un proxy seguro

    En el ejemplo siguiente se utiliza la plantilla secureproxy para crear un proxy seguro denominado SecureProxySrv001. Los puertos del proxy seguro empiezan en el número de puerto 26000.

    manageprofiles -create
       -profileName SecureProxySrv001
       -profilePath raíz_perfil
       -templatePath secureproxy
       -startingPort 26000
  • Creación de un perfil personalizado

    El ejemplo siguiente crea un perfil personalizado y lo federa en la célula del gestor de despliegue.

    manageprofiles -create
       -profileName Custom01 
       -templatePath managed 
       -startingPort 22000
       -dmgrHost myhost.mycity.mycompany.com
       -dmgrPort 8879
  • Creación de un perfil de servidor de aplicaciones

    Cree un perfil de servidor de aplicaciones llamado default01 con el siguiente mandato.

    manageprofiles -create
       -profileName Default01 
       -templatePath default 
       -startingPort 21000
       -personalCertDN "cn=testa, ou=Rochester, o=IBM, c=US"   
       -signingCertDN "cn=testc, ou=Rochester, o=IBM, c=US"   
       -keyStorePassword ap3n9krw
  • Creación de un perfil de célula
    La creación de un perfil de célula requiere la creación del gestor de despliegue y de la parte del servidor de aplicaciones del perfil de célula. Los dos perfiles están enlazados y algunos parámetros deben coincidir entre los parámetros de creación del gestor de despliegue y la parte del servidor de aplicaciones del perfil de célula.
    Importante: Para el gestor de despliegue y el servidor de aplicaciones del perfil de célula, deberá utilizar los mismos valores para los parámetros cellName, nodeName y appServerNodeName. Si no especificó nombres para estos parámetros cuando creó la parte del gestor de despliegue del perfil de la célula, debe utilizar el nombre por omisión que se asignó en la primera invocación de la línea de mandatos. El ejemplo siguiente muestra el uso de valores idénticos para estos parámetros en el gestor de despliegue y en el servidor de aplicaciones del perfil de célula.
    Para el gestor de
    despliegue (Dmgr):                       
    -cellName host01Cell01          
    -nodeName host01CellManager01   
    -appServerNodeName host01Node01 
                                    
    Para AppServer:                  
    -cellName host01Cell01          
    -nodeName host01CellManager01   
    -appServerNodeName host01Node01 
    En el siguiente ejemplo se muestra la creación de un perfil de célula denominado Dmgr001 con el nombre de célula Célula01PorOmisión y el nombre de nodo Nodo01PorOmisión. Para crear una célula completa que funcione, es necesario que los parámetros -nodeProfilePath, -cellName, -appServerNodeName, -nodeName coincidan entre el perfil cell_dmgr y el perfil cell_node.
    1. Cree la parte del gestor de despliegue del perfil de célula.
      raíz_servidor_aplic/bin/manageprofiles -create 
         -templatePath raíz_servidor_aplic/profileTemplates/cell/dmgr
         -nodeProfilePath raíz_datos_usuario/profiles/AppSrv01
         -profileName Dmgr001
         -cellName Célula01Predeterminada
         -nodeName Default01Node
         -appServerNodeName Default02Node
    2. Cree la parte del servidor de aplicaciones del perfil de célula.
      raíz_servidor_aplicaciones/bin/manageprofiles -create
         -templatePath raíz_servidor_aplic/profileTemplates/cell/default
         -dmgrProfilePath raíz_datos_usuario/profiles/Dmgr001
         -portsFile raíz_datos_usuario/profiles/Dmgr001/properties/portdef.props
         -nodePortsFile raíz_datos_usuario/profiles/Dmgr001/properties/nodeportdef.props
         -profileName AppSrv01
         -cellName Célula01Predeterminada
         -nodeName Default01Node
         -appServerNodeName Default02Node

Anotaciones cronológicas

El mandato manageprofiles crea un archivo de anotaciones cronológicas para cada perfil que crea.
  • Los archivos de anotaciones cronológicas están en el directorio raíz_datos_usuario/profileRegistry/logs/manageprofiles. Los archivos se denominan siguiendo este patrón: nombre_perfil_create.log.
  • El mandato también crea un archivo de anotaciones cronológicas para cada perfil que suprime. Los archivos de anotaciones cronológicas están en el directorio raíz_datos_usuario/profileRegistry/logs/manageprofiles. Los archivos se denominan siguiendo este patrón: nombre_perfil_delete.log.

Ejemplo: Creación de perfiles de gestor de despliegue

Puede crear un perfil de gestor de despliegue después de instalar los archivos de producto principales. El gestor de despliegue proporciona una única interfaz de administración para agrupar lógicamente servidores de aplicaciones en una o más máquinas. Utilice el mandato manageprofiles.sh -create para crear un perfil de gestor de despliegue.

Para crear un perfil de gestor de despliegue denominado shasti:

manageprofiles -create
              -profileName shasti 
              -profilePath /shasti/WebSphere 
              -templatePath /opt/IBM/WebSphere/AppServer/profileTemplates/management
              -serverType DEPLOYMENT_MANAGER
              -cellName cell1
              -hostName planetaix 
              -nodeName dmgr1
El mandato crea un perfil de gestor de despliegue denominado shasti en la célula denominada cell1 con el nombre de nodo dmgr1 en la siguiente ubicación:
  • /shasti/WebSphere

Si no especifica una de las opciones de puerto durante la creación del perfil, se utilizará un conjunto de valores de puerto recomendados. El algoritmo de resolución de conflictos entre puertos determina estos puertos. El conjunto de puertos recomendado no deben tener conflictos entre sí. Si desea utilizar los puertos por omisión de IBM, utilice la opción -defaultPorts al crear un perfil.

Ejemplo: aumento de los números de puerto predeterminado desde un punto de partida

El mandato manageprofiles puede asignar números de puerto basándose en un valor de puerto de partida. Puede proporcionar un valor de puerto de partida desde la línea de mandatos, utilizando el parámetro -startingPort. El mandato asigna números de puerto en secuencia comenzando por el valor del número de puerto. Sin embargo, si un valor de puerto de la secuencia entra en conflicto con una asignación de puerto existente, se utiliza el siguiente valor de puerto disponible

El orden de las asignaciones de puerto es arbitrario. No se pueden predecir las asignaciones.

Por ejemplo, los puertos creados con -startingPort 20002 serán parecidos a lo siguiente:

Puertos asignados para el perfil de un servidor de aplicaciones
WC_defaulthost=20002
WC_adminhost=20003
WC_defaulthost_secure=20004
WC_adminhost_secure=20005
BOOTSTRAP_ADDRESS=20006
SOAP_CONNECTOR_ADDRESS=20007
IPC_CONNECTOR_ADDRESS=20008
SAS_SSL_SERVERAUTH_LISTENER_ADDRESS=20009
CSIV2_SSL_SERVERAUTH_LISTENER_ADDRESS=20010
CSIV2_SSL_MUTUALAUTH_LISTENER_ADDRESS=20011
ORB_LISTENER_ADDRESS=20012
DCS_UNICAST_ADDRESS=20013
SIB_ENDPOINT_ADDRESS=20014
SIB_ENDPOINT_SECURE_ADDRESS=20015
SIB_MQ_ENDPOINT_ADDRESS=20016
SIB_MQ_ENDPOINT_SECURE_ADDRESS=20017
SIP_DEFAULTHOST=20018
SIP_DEFAULTHOST_SECURE=20019
OVERLAY_UDP_LISTENER_ADDRESS=20020
OVERLAY_TCP_LISTENER_ADDRESS=20021
Puertos asignados para una célula de un perfil de servidor de aplicaciones federado
WC_defaulthost=20002
WC_defaulthost_secure=20003
BOOTSTRAP_ADDRESS=20004
SOAP_CONNECTOR_ADDRESS=20005
IPC_CONNECTOR_ADDRESS=20006
SAS_SSL_SERVERAUTH_LISTENER_ADDRESS=20007
CSIV2_SSL_SERVERAUTH_LISTENER_ADDRESS=20008
CSIV2_SSL_MUTUALAUTH_LISTENER_ADDRESS=20009
ORB_LISTENER_ADDRESS=20010
DCS_UNICAST_ADDRESS=20011
SIB_ENDPOINT_ADDRESS=20012
SIB_ENDPOINT_SECURE_ADDRESS=20013
SIB_MQ_ENDPOINT_ADDRESS=20014
SIB_MQ_ENDPOINT_SECURE_ADDRESS=20015
SIP_DEFAULTHOST=20016
SIP_DEFAULTHOST_SECURE=20017
NODE_MULTICAST_DISCOVERY_ADDRESS=20018
NODE_IPV6_MULTICAST_DISCOVERY_ADDRESS=20019
NODE_DISCOVERY_ADDRESS=20020
NODE_DCS_UNICAST_ADDRESS=20021
NODE_BOOTSTRAP_ADDRESS=20022
NODE_SOAP_CONNECTOR_ADDRESS=20023
NODE_ORB_LISTENER_ADDRESS=20024
NODE_SAS_SSL_SERVERAUTH_LISTENER_ADDRESS=20025
NODE_CSIV2_SSL_MUTUALAUTH_LISTENER_ADDRESS=20026
NODE_CSIV2_SSL_SERVERAUTH_LISTENER_ADDRESS=20027
NODE_IPC_CONNECTOR_ADDRESS=20028
OVERLAY_UDP_LISTENER_ADDRESS=20029
OVERLAY_TCP_LISTENER_ADDRESS=20030
NODE_XDAGENT_PORT=20031
NODE_OVERLAY_UDP_LISTENER_ADDRESS=20032
NODE_OVERLAY_TCP_LISTENER_ADDRESS=20033
Puertos asignados para una célula de un perfil de gestor de despliegue
WC_adminhost=20002
WC_adminhost_secure=20003
BOOTSTRAP_ADDRESS=20004
SOAP_CONNECTOR_ADDRESS=20005
IPC_CONNECTOR_ADDRESS=20006
SAS_SSL_SERVERAUTH_LISTENER_ADDRESS=20007
CSIV2_SSL_SERVERAUTH_LISTENER_ADDRESS=20008
CSIV2_SSL_MUTUALAUTH_LISTENER_ADDRESS=20009
ORB_LISTENER_ADDRESS=20010
CELL_DISCOVERY_ADDRESS=20011
DCS_UNICAST_ADDRESS=20012
XDAGENT_PORT=20013
OVERLAY_UDP_LISTENER_ADDRESS=20014
OVERLAY_TCP_LISTENER_ADDRESS=20015
STATUS_LISTENER_ADDRESS=20016
Puertos asignados para un perfil de gestión con un servidor de gestor de despliegue
WC_adminhost=20002
WC_adminhost_secure=20003
BOOTSTRAP_ADDRESS=20004
SOAP_CONNECTOR_ADDRESS=20005
IPC_CONNECTOR_ADDRESS=20006
SAS_SSL_SERVERAUTH_LISTENER_ADDRESS=20007
CSIV2_SSL_SERVERAUTH_LISTENER_ADDRESS=20008
CSIV2_SSL_MUTUALAUTH_LISTENER_ADDRESS=20009
ORB_LISTENER_ADDRESS=20010
CELL_DISCOVERY_ADDRESS=20011
DCS_UNICAST_ADDRESS=20012
DataPowerMgr_inbound_secure=20013
XDAGENT_PORT=20014
OVERLAY_UDP_LISTENER_ADDRESS=20015
OVERLAY_TCP_LISTENER_ADDRESS=20016
STATUS_LISTENER_ADDRESS=20017
Puertos asignados para un perfil de gestión con un servidor de gestor de trabajos
WC_adminhost=20002
WC_adminhost_secure=20003
BOOTSTRAP_ADDRESS=20004
SOAP_CONNECTOR_ADDRESS=20005
IPC_CONNECTOR_ADDRESS=20006
SAS_SSL_SERVERAUTH_LISTENER_ADDRESS=20007
CSIV2_SSL_SERVERAUTH_LISTENER_ADDRESS=20008
CSIV2_SSL_MUTUALAUTH_LISTENER_ADDRESS=20009
ORB_LISTENER_ADDRESS=20010
STATUS_LISTENER_ADDRESS=20011
Puertos asignados para un perfil de gestión con un servidor de agente administrativo
WC_adminhost=20002
WC_adminhost_secure=20003
BOOTSTRAP_ADDRESS=20004
SOAP_CONNECTOR_ADDRESS=20005
IPC_CONNECTOR_ADDRESS=20006
SAS_SSL_SERVERAUTH_LISTENER_ADDRESS=20007
CSIV2_SSL_SERVERAUTH_LISTENER_ADDRESS=20008
CSIV2_SSL_MUTUALAUTH_LISTENER_ADDRESS=20009
ORB_LISTENER_ADDRESS=20010
Puertos asignados para un perfil de proxy seguro
PROXY_HTTP_ADDRESS=20002
PROXY_HTTPS_ADDRESS=20003
PROXY_SIP_ADDRESS=20004
PROXY_SIPS_ADDRESS=20005
IPC_CONNECTOR_ADDRESS=20006

El siguiente ejemplo utiliza el parámetro startingPort del mandato manageprofiles y crea puertos a partir de un valor inicial 20002, con el contenido que se muestra en el ejemplo anterior:

raíz_servidor_aplicaciones/bin/manageprofiles -create
               -profileName shasti 
               -profilePath raíz_datos_usuario/profiles/shasti 
               -templatePath raíz_servidor_aplicaciones/profileTemplates/default 
               -nodeName W2K03 
               -cellName W2K03_Cell01
               -hostName planetnt 
               -startingPort 20002

Ejemplo: Creación de perfiles de célula

Para crear un perfil de célula utilizando el mandato manageprofiles, debe crear el perfil de gestión de la célula para un servidor de gestor de despliegue y el perfil de nodo de la célula utilizando dos invocaciones distintas de la línea de mandatos de manageprofiles. La combinación de estos dos perfiles es el perfil de célula.

Se utilizan dos plantillas para crear el perfil de célula: cell_dmgr y cell_node. Las plantillas están enlazadas y algunos parámetros deben coincidir entre los parámetros de creación de estas dos invocaciones. Verifique que las invocaciones coincidan.

Desde la línea de mandatos puede crear dos mitades de la célula en cualquier orden o en cualquier momento. Se recomienda crear primero la parte del perfil del gestor de despliegue. Después de crear la célula, ésta contiene un gestor de despliegue y un nodo federado. La parte del gestor de despliegue y la parte del nodo están en directorios distintos.

Para cada uno de los dos perfiles que cree, puede especificar la vía de acceso completa del perfil resultante utilizando el parámetro -profilePath. Si no especifica este parámetro, el valor predeterminado para cada vía de acceso de perfil se basa en el directorio, el subdirectorio de perfiles y el nombre del perfil.

Las dos plantillas que forman un perfil de célula tienen dependencias entre sí, lo que requiere que algunos valores de parámetros de las dos coincidan para crear invocaciones. Para crear una célula completa que funcione, es necesario que los parámetros -nodeProfilePath, -cellName, -appServerNodeName, -nodeName tengan los mismos valores para el perfil cell_dmgr profile y cell_node. En el caso de los puertos y, en especial, en el caso de los puertos asignados de forma dinámica, la creación de la segunda mitad de la célula debe hacer referencia a los puertos que se utilizan en la primera mitad de la célula. Utilice los argumentos -portsFile y -nodePortsFile con referencias a los archivos siguientes del perfil que representa la primera mitad de la célula:

  • raíz_perfil/properties/portdef.props
  • raíz_perfil/properties/nodeportdef.props
Este método garantiza que los puertos de la segunda mitad de la célula se creen con la correlación correcta con la primera mitad de la célula.

Para obtener ayuda detallada para crear el perfil de célula, utilice los mandatos siguientes:

raíz_servidor_aplicaciones/bin/manageprofiles -create
 -templatePath
raíz_servidor_aplic/profileTemplates/cell/dmgr
 -help 

o bien

raíz_servidor_aplicaciones/bin/manageprofiles -create
 -templatePath 
raíz_servidor_aplic/profileTemplates/cell/default
 -help 

La salida del parámetro -help especifica qué parámetros son necesarios y cuáles son opcionales al crear el perfil del gestor de despliegue de célula y el perfil de nodo de célula.

En el siguiente ejemplo se crea un perfil de célula denominado Dmgr001 con el nombre de célula Default01Cell y el nombre de nodo Default01Node.
  1. Verifique que la vía de acceso siguiente está disponible:

    La vía de acceso debe estar disponible al crear el gestor de despliegue y las partes de nodo de la célula como subdirectorios se añaden para cada parte.

    • raíz_servidor_aplic/profiles
  2. Cree la parte del gestor de despliegue del perfil de célula.
    raíz_servidor_aplic/bin/manageprofiles -create 
     -templatePath 
    raíz_servidor_aplic/profileTemplates/cell/dmgr 
     -nodeProfilePath 
    raíz_servidor_aplic/profiles/AppSrv01 
     -profileName Dmgr001 
     -cellName Default01Cell 
     -nodeName Default01Node 
     -appServerNodeName nombre_nodo_federado
  3. Verifique que el perfil Dmgr001 existe como debía existir antes de crear la parte del servidor de aplicaciones del perfil de la célula.
  4. Cree la parte del servidor de aplicaciones del perfil de célula.
    Importante: Debe utilizar los mismos valores para los parámetros cellName, nodeName y appServerNodeName que los que utilizó en la parte del gestor de despliegue del perfil de la célula. En el ejemplo siguiente se muestra el uso de los mismos valores para los parámetros cellName, nodeName y appServerNodeName en el gestor de despliegue y en el servidor de aplicaciones del perfil de célula.
    Para el gestor de
    despliegue (Dmgr):                       
    -cellName host01Cell01          
    -nodeName host01CellManager01   
    -appServerNodeName host01Node01 
                                    
    Para AppServer:                  
    -cellName host01Cell01          
    -nodeName host01CellManager01   
    -appServerNodeName host01Node01 
    Si no especificó nombres para estos parámetros cuando creó la parte del gestor de despliegue del perfil de la célula, debe utilizar el nombre predeterminado que se asignó en la primera invocación de la línea de mandatos.
    raíz_servidor_aplic/bin/manageprofiles -create 
     -templatePath 
    raíz_servidor_aplic/profileTemplates/cell/default 
     -dmgrProfilePath 
    raíz_servidor_aplic/profiles/Dmgr001 
     -portsFile 
    raíz_servidor_aplic/profiles/Dmgr001/properties/portdef.props 
     -nodePortsFile 
    raíz_servidor_aplic/profiles/Dmgr001/properties/nodeportdef.props 
     -profileName AppSrv01 
     -cellName Default01Cell 
     -nodeName Default01Node 
     -appServerNodeName nombre_nodo_federado

Después de crear el gestor de despliegue y las partes de nodo del perfil de célula, se debe producir una sincronización entre los dos servidores. De forma predeterminada, la sincronización se produce automáticamente entre los servidores en un intervalo especificado. Sin embargo, si la sincronización está inhabilitada, el intervalo es demasiado largo, o si se produce algún problema que impide que se produzca la sincronización de una forma periódica, ejecute el mandato syncNode para sincronizar el gestor de despliegue y el nodo.

Debe utilizar el parámetro portsFile o nodePortsFile y el parámetro startingPort o nodeStartingPort.

Si utiliza el mandato manageprofiles, puede elegir el perfil que desea que sea el valor predeterminado.

Ejemplo: Utilización de números de puertos predefinidos

El mandato manageprofiles recomienda valores iniciales de puerto cuando no se establecen de forma explícita los valores de puerto. En su lugar puede utilizar los valores de puerto predefinidos.

El mandato manageprofiles recomienda valores de puerto cuando no se especifican las opciones -defaultPorts, -startingPort o -portsFile.
Tabla 1. Ubicaciones de archivo de valores de puertos predeterminados.

En esta tabla se muestran las ubicaciones de archivo de los valores de puerto predeterminados por tipo de perfil.

Perfil Vía de acceso del archivo
Servidor de aplicaciones raíz_servidor_aplicaciones/profileTemplates/default/actions/portsUpdate/portdef.props
Célula - porción del servidor de aplicaciones raíz_servidor_aplicaciones/profileTemplates/cell/dmgr/actions/portsUpdate/nodeportdef.props
Célula - porción del gestor de despliegue raíz_servidor_aplicaciones/profileTemplates/cell/dmgr/actions/portsUpdate/portdef.props
Personalizado raíz_servidor_aplicaciones/profileTemplates/managed/actions/portsUpdate/portdef.props
Perfil de gestión para un servidor de gestor de despliegue raíz_servidor_aplicaciones/profileTemplates/management/actions/portsUpdate/dmgr.portdef.props
Perfil de gestión para un servidor de agente administrativo raíz_servidor_aplic/profileTemplates/management/actions/portsUpdate/adminagent.portdef.props
Perfil de gestión para un servidor de gestor de trabajos raíz_servidor_aplic/profileTemplates/management/actions/portsUpdate/jmgr.portdef.props
Proxy seguro raíz_servidor_aplic/profileTemplates/secureproxy/actions/portsUpdate/portdef.props
Para personalizar los valores de puerto del archivo portdef.props antes de crear el perfil, siga estos pasos. En el siguiente ejemplo se crea el perfil predeterminado. Para otros tipos de perfil, debe sustituir la vía de acceso del archivo por la vía de acceso del perfil que desea crear.
  1. Copie el archivo raíz_servidor_aplic/profileTemplates/default/actions/portsUpdate/portdef.props en la vía de acceso de plantillas de perfiles por omisión y coloque una copia del archivo en el directorio temporal que desee, como por ejemplo:
    • /temp/ports
  2. En el nuevo archivo, modifique los valores de puerto y especifique los valores de puerto que desee.
  3. Cree el perfil con el mandato manageprofiles. Utilice los valores de puerto modificados. Especifique la ubicación del archivo portdef.props modificado en el parámetro -portsFile. Especifique el parámetro -validatePorts para asegurarse de que los puertos no están reservados ni en uso. Utilice el ejemplo siguiente como pauta:
    manageprofiles 
       -create
       -profileName Wow_Profile 
       -profilePath raíz_perfil 
       -templatePath raíz_servidor_aplicaciones\profileTemplates\default 
       -nodeName Wow_node 
       -cellName Wow_cell
       -hostName lorriemb 
       -portsFile \temp\ports\portdef.props
       -validatePorts
Suponga que el archivo portdef.props tiene los siguientes valores:
WC_defaulthost=39080
WC_adminhost=39060
WC_defaulthost_secure=39443
WC_adminhost_secure=39043
BOOTSTRAP_ADDRESS=32809
SOAP_CONNECTOR_ADDRESS=38880
IPC_CONNECTOR_ADDRESS=39633
SAS_SSL_SERVERAUTH_LISTENER_ADDRESS=39401
CSIV2_SSL_SERVERAUTH_LISTENER_ADDRESS=39403
CSIV2_SSL_MUTUALAUTH_LISTENER_ADDRESS=39402
ORB_LISTENER_ADDRESS=39100
DCS_UNICAST_ADDRESS=39353
SIB_ENDPOINT_ADDRESS=37276
SIB_ENDPOINT_SECURE_ADDRESS=37286
SIB_MQ_ENDPOINT_ADDRESS=35558
SIB_MQ_ENDPOINT_SECURE_ADDRESS=35578
SIP_DEFAULTHOST=35060
SIP_DEFAULTHOST_SECURE=35061
OVERLAY_UDP_LISTENER_ADDRESS=35062
OVERLAY_TCP_LISTENER_ADDRESS=35063
STATUS_LISTENER_ADDRESS=35064

Después de ejecutar el mandato manageprofiles para crear el perfil con los valores de puerto definidos por el usuario, aparecerá un resultado indicando si se ha realizado correctamente o si ha fallado.

Nota: Después de crear un perfil correctamente, la consola imprime un mensaje que indica que se ha creado correctamente y le aconseja que compruebe el archivo aboutthisprofile . Sin embargo, un archivo aboutthisprofile no se genera al crear un perfil de cliente o un perfil de plug-ins en IBM i.

El mandato manageprofiles crea una copia del archivo portdefs.props actual en el directorio raíz_perfil\properties.

Utilice sólo uno de los tres parámetros de valores de puerto, -startingPort, -defaultPorts o -portsFile con el mandato manageprofiles. Los tres parámetros son mutuamente excluyentes.


Icon that indicates the type of topic Reference topic



Timestamp icon Last updated: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-iseries&topic=rxml_manageprofiles
File name: rxml_manageprofiles.html