![[AIX Solaris HP-UX Linux Windows]](../images/dist.gif)
![[IBM i]](../images/iseries.gif)
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 mandato manageprofiles y su interfaz gráfica de usuario, la
herramienta de gestión de perfiles, son las únicas maneras de crear entornos de
ejecución.
El archivo de mandatos se encuentra en el directorio raíz_servidor_aplic/bin. El archivo de mandatos es un script denominado manageprofiles.
Sintaxis
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.
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:
- Especifique la contraseña para el ID de usuario de seguridad administrativa especificado con el parámetro -adminUserName.
- Especifique el ID de usuario que se utiliza para la seguridad administrativa.
- 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.
- Los valores standard son los valores de configuración predeterminados estándar optimizados para un uso general.
- 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.
- 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.
- 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.
- 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.
Especifique el archivo totalmente calificado para -templatePath. Por ejemplo:
manageprofiles(.bat)(.sh) -augment -profileName nombre_perfil -templatePath vía_acceso_plantilla
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.
- 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.
- 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.
- Especifica el nombre de célula del perfil. Utilice un nombre de célula
exclusivo para cada perfil.
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.
El valor predeterminado para este parámetro se basa en una combinación del nombre de host abreviado, la célula constante y un número final:
Los nombres de célula predeterminados son los siguientes:
El valor de este parámetro no debe contener espacios ni caracteres que no sean válidos, tales como los siguientes: *, ?, ", <, >,,, /, \, |, etc.
- 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:
- Activa la función de depuración del programa de utilidad Ant, que utiliza el mandato manageprofiles.
- 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.
- 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. - Suprime el perfil.
Al suprimir un perfil no se suprime el directorio del perfil. Por ejemplo, suponga que crea un perfil en el directorio/usr/WebSphere/AppServer/profiles/managedProfile. El directorio permanece después de suprimir el perfil.
El directorio se puede suprimir o dejar. Sin embargo, el directorio raíz_perfil/logs contiene información sobre la desinstalación del perfil. Por ejemplo, podría conservar el archivo _nodeuninst.log para determinar la causa de cualquier problema que surja durante el proceso de desinstalación.
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: 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
- Suprime todos los perfiles registrados.
Al suprimir un perfil no se suprime el directorio del perfil. Por ejemplo, suponga que crea un perfil en el directorio/usr/WebSphere/AppServer/profiles/managedProfile. El directorio permanece después de suprimir el perfil.
El directorio se puede suprimir o dejar. Sin embargo, el directorio raíz_perfil/logs contiene información sobre la desinstalación del perfil. Por ejemplo, podría conservar el archivo _nodeuninst.log para determinar la causa de cualquier problema que surja durante el proceso de desinstalación.
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.
- 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.
- 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.
- 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.
- 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.
- 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.
- 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.
Permite crear un servicio Linux. Los valores válidos son true o false. El valor por omisión para este parámetro es false.
Cuando se ejecuta el mandato manageprofiles con la opción -enableService establecida en true, se crea el servicio Linux con el perfil cuando el mandato lo ejecuta el usuario root. Cuando un usuario no root ejecuta el mandato manageprofiles, se crea el perfil, pero no se crea el servicio Linux. El servicio Linux no se crea porque el usuario no root no tiene suficientes permisos para configurar el servicio. Al final de la creación del perfil se visualizará un resultadoINSTCONPARTIALSUCCESS y el archivo de registros cronológicos de creación de perfil raíz_servidor_aplic/logs/manageprofiles_create_nombre_perfil.log contiene un mensaje que especifica que el usuario actual no tiene suficientes permisos para configurar el servicio Linux.
- 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.
- Devuelve el nombre del perfil por omisión.
- Obtiene la ubicación en el sistema de archivos de un perfil de nombre determinado. Requiere el parámetro –profileName.
- Obtiene el nombre de un perfil registrado en un parámetro -profilePath determinado.
- Muestra la sintaxis del mandato.
- 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.
- 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.
- 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.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.
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
Si especifica cualquiera de los parámetros que empiezan por -importPersonal, debe especificarlos todos.
- 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.
- 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.
- 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.
- 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.
- 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.
- 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.
- 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.
- 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.
- 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.
- 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.
- 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.
- Lista los perfiles que están en el registro de perfil.
- 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.
- 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.
El valor predeterminado de este parámetro se basa en el nombre de host abreviado, el nombre de perfil y un número final:
Existen los siguientes nombres de nodo por omisión:
El valor de este parámetro no debe contener espacios ni caracteres que no sean válidos como los siguientes: *, ?, ", <, >,,, /, \, |, etc.
- 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.
- 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.
- 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:
- 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.
- 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.
- 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:
donde<tipo_perfil><número_perfil
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.
- 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
Si la vía de acceso plenamente cualificada contiene espacios, indique el valor entre comillas.
El valor predeterminado está basado en el directorio raíz_servidor_aplicaciones, el subdirectorio de perfiles y el nombre del 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:
El elemento WS_WSPROFILE_DEFAULT_PROFILE_HOME se define en el archivo wasprofile.properties del directorio raíz_servidor_aplic/properties.DIR_PERFIL_POR_OMISIÓN_WS_WSPROFILE/nombrePerfil
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.
Debe tener permisos para grabar en el directorio.
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.
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.
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: Si no especifica el valor en el formato indicado, números separados por guiones, el valor de esta propiedad se ignora.gotcha
- 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.
La sentencia de vía de acceso del sistema operativo Windows puede utilizar barras inclinadas (/) o barras inclinadas invertidas (\). Si la sentencia de vía de acceso utiliza barras inclinadas invertidas, en el archivo de respuestas se precisa de barras inclinadas invertidas dobles para que el archivo de respuestas entienda correctamente la vía de acceso. A continuación se muestra un ejemplo de un archivo de respuestas para una operación create que utiliza barras inclinadas invertidas dobles:
create templatePath=C:\\WebSphere\\AppServer\\profileTemplates\\default
Best practice: Utilice las barra inclinadas invertidas para reducir la posibilidad de errores a la hora de conmutar entre plataformas.bprac
- Cuando especifique los valores, no especifique los caracteres comillas dobles (") al principio o al final de un valor, incluso si dicho valor contiene espacios.
- 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: - 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.
- 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.
- 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.
Especifique el ID de usuario utilizado durante la creación del servicio Linux, para que el servicio Linux se ejecute desde este ID de usuario. El servicio Linux se ejecuta cuando el ID de usuario ha iniciado la sesión.
- 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
- 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.
- 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.
- 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, omitiendo los puertos que ya se están utilizando. El sistema reconoce y resuelve los puertos que se están utilizando actualmente y determina las asignaciones de puerto para evitar que se produzcan conflictos entre puertos.
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. - 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.
- 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.
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. F
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.
- 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, especifique la vía de acceso al archivo totalmente calificada para el parámetro.
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.
- 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, especifique la vía de acceso al archivo totalmente calificada para el parámetro.
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.
- 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.
- 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.
- 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.
- 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.
- 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.
- Nombre de host del servidor. El valor predeterminado de este parámetro es el nombre de host completo de la máquina local.
- 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 “C:\Program Files\IBM\HTTPServer” webServerType=IIS: webServerInstallPath defaulted to “C:\” webServerType=SUNJAVASYSTEM: webServerInstallPath defaulted to “C:\” webServerType=DOMINO: webServerInstallPath defaulted to “” webServerType=APACHE: webServerInstallPath defaulted to “” webServerType=HTTPSERVER_ZOS: webServerInstallPath defaulted to “n/a”
webServerType=IHS: webServerInstallPath defaulted to “/opt/IBM/HTTPServer” webServerType=IIS: webServerInstallPath defaulted to “n\a” webServerType=SUNJAVASYSTEM: webServerInstallPath defaulted to “/opt/sun/webserver” webServerType=DOMINO: webServerInstallPath defaulted to “” webServerType=APACHE: webServerInstallPath defaulted to “” webServerType=HTTPSERVER_ZOS: webServerInstallPath defaulted to “n/a”
webServerType=IHS: webServerInstallPath defaulted to “/usr/IBM/HTTPServer” webServerType=IIS: webServerInstallPath defaulted to “n\a” webServerType=SUNJAVASYSTEM: webServerInstallPath defaulted to “/opt/sun/webserver” webServerType=DOMINO: webServerInstallPath defaulted to “?” webServerType=APACHE: webServerInstallPath defaulted to “?” webServerType=HTTPSERVER_ZOS: webServerInstallPath defaulted to “n/a”
webServerType=IHS: webServerInstallPath defaulted to “/opt/IBM/HTTPServer” webServerType=IIS: webServerInstallPath defaulted to “n\a” webServerType=SUNJAVASYSTEM: webServerInstallPath defaulted to “/opt/sun/webserver” webServerType=DOMINO: webServerInstallPath defaulted to “” webServerType=APACHE: webServerInstallPath defaulted to “” webServerType=HTTPSERVER_ZOS: webServerInstallPath defaulted to “n/a”
webServerType=IHS: webServerInstallPath defaulted to “/opt/IBM/HTTPServer” webServerType=IIS: webServerInstallPath defaulted to “n\a” webServerType=SUNJAVASYSTEM: webServerInstallPath defaulted to “/opt/sun/webserver” webServerType=DOMINO: webServerInstallPath defaulted to “” webServerType=APACHE: webServerInstallPath defaulted to “” webServerType=HTTPSERVER_ZOS: webServerInstallPath defaulted to “n/a”
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”
- Nombre del servidor web. El valor predeterminado para este parámetro es webserver1.
- 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.
- Vía de acceso a los plug-ins que utiliza el servidor web. El valor predeterminado para este parámetro es WAS_HOME/plugins.
- Indica el puerto desde el que se accederá al servidor web. El valor predeterminado para este parámetro es 80.
- 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.
El tipo de cuenta del propietario del servicio Windows creado para el perfil. Los valores válidos incluyen specifieduser o localsystem. El valor localsystem ejecuta el servicio Windows bajo la cuenta local del usuario que crea el perfil. El valor predeterminado para este parámetro es localsystem.
Si el valor es specifieduser, el parámetro winservicePassword es necesario. El parámetro winserviceUserName se establece de manera predeterminada en el valor del nombre de usuario del entorno, si no se especifica.
El valor puede ser true o false. Especifique true para crear un servicio Windows para el proceso servidor que se ha creado dentro del perfil. Especifique false para no crear el servicio Windows. El valor por omisión para este parámetro es false.
Importante: Con un perfil personalizado, no puede crear un servicio de Windows con este parámetro. En su lugar, utilice el mandato WASService para crear el servicio por separado.Especifique la contraseña para el usuario especificado o la cuenta local que va a ser propietario del servicio Windows.
Los valores posibles de tipo_inicio son:
Consulte el artículo sobre el mandato WASService para obtener más información sobre los servicios Windows.
El valor por omisión para este parámetro es automatic.
Especifique el ID de usuario para que el sistema operativo Windows pueda comprobar que el ID es capaz de crear un servicio Windows. El ID de usuario debe pertenecer al grupo de administradores y tener los siguientes derechos de usuario avanzados.
Importante: Al crear un perfil con un servicio Windows con un usuario y una contraseña especificados y si el usuario es un usuario de dominio, debe utilizar una barra doble invertida tal como se muestra en el ejemplo siguiente:winServiceUserName=DOMAIN\\DOMAINUSER winServicePassword=DOMAINUSERPASSWORD
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.
Anotaciones cronológicas
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:
![[AIX]](../images/aixlogo.gif)
![[HP-UX]](../images/hpux.gif)
![[Linux]](../images/linux.gif)
![[Solaris]](../images/solaris.gif)
manageprofiles.sh -create
-profileName shasti
-profilePath /shasti/WebSphere
-templatePath /opt/IBM/WebSphere/AppServer/profileTemplates/management
-serverType DEPLOYMENT_MANAGER
-cellName cell1
-hostName planetaix
-nodeName dmgr1
![[Windows]](../images/windows.gif)
manageprofiles.bat -create
-profileName shasti
-profilePath C:\shasti\WebSphere
-templatePath C:\IBM\WebSphere\AppServer\profileTemplates\management
-serverType DEPLOYMENT_MANAGER
-cellName cell1
-hostName planetnt
-nodeName dmgr1
![[IBM i]](../images/iseries.gif)
manageprofiles -create
-profileName shasti
-profilePath /shasti/WebSphere
-templatePath /opt/IBM/WebSphere/AppServer/profileTemplates/management
-serverType DEPLOYMENT_MANAGER
-cellName cell1
-hostName planetaix
-nodeName dmgr1
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:
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
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
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
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
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
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
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:
![[Windows]](../images/windows.gif)
manageprofiles.bat -create
-profileName shasti
-profilePath G:\shasti\WebSphere
-templatePath G:\shasti\WebSphere\profileTemplates\default
-nodeName W2K03
-cellName W2K03_Cell01
-hostName planetnt
-startingPort 20002
![[Linux]](../images/linux.gif)
![[HP-UX]](../images/hpux.gif)
![[Solaris]](../images/solaris.gif)
![[AIX]](../images/aixlogo.gif)
raíz_servidor_aplicaciones/bin/manageprofiles.sh -create
-profileName shasti
-profilePath raíz_servidor_aplicaciones/profiles/shasti
-templatePath raíz_servidor_aplicaciones/profileTemplates/default
-nodeName W2K03
-cellName W2K03_Cell01
-hostName planetnt
-startingPort 20002
![[IBM i]](../images/iseries.gif)
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
raíz_servidor_aplicaciones,
el subdirectorio de perfiles y el nombre del perfil.
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:
![[Linux]](../images/linux.gif)
![[HP-UX]](../images/hpux.gif)
![[Solaris]](../images/solaris.gif)
![[AIX]](../images/aixlogo.gif)
![[IBM i]](../images/iseries.gif)
![[Windows]](../images/windows.gif)
Para obtener ayuda detallada para crear el perfil de célula, utilice los mandatos siguientes:
![[Linux]](../images/linux.gif)
![[HP-UX]](../images/hpux.gif)
![[Solaris]](../images/solaris.gif)
![[AIX]](../images/aixlogo.gif)
raíz_servidor_aplic/bin/manageprofiles.sh -create
-templatePath
raíz_servidor_aplic/profileTemplates/cell/dmgr
-help
![[Windows]](../images/windows.gif)
raíz_servidor_aplicaciones\bin\manageprofiles.bat -create
-templatePath
raíz_servidor_aplic\profileTemplates\cell\dmgr
-help
![[IBM i]](../images/iseries.gif)
raíz_servidor_aplicaciones/bin/manageprofiles -create
-templatePath
raíz_servidor_aplic/profileTemplates/cell/dmgr
-help
o bien
![[Linux]](../images/linux.gif)
![[HP-UX]](../images/hpux.gif)
![[Solaris]](../images/solaris.gif)
![[AIX]](../images/aixlogo.gif)
raíz_servidor_aplic/bin/manageprofiles.sh -create
-templatePath
raíz_servidor_aplic/profileTemplates/cell/default
-help
![[Windows]](../images/windows.gif)
raíz_servidor_aplicaciones\bin\manageprofiles.bat -create
-templatePath
raíz_servidor_aplic\profileTemplates\cell\default
-help
![[IBM i]](../images/iseries.gif)
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.
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.
Si federa un nodo de servidor de aplicaciones como parte de la creación del perfil de célula utilizando el parámetro -appServerNodeName, el nodo no tendrá una configuración original. Si utiliza el mandato -removeNode en un nodo
que fue creado durante la creación del perfil de la célula, el mandato
indicará que el programa de utilidad para eliminar el nodo no puede eliminar el nodo y lo restaura
a una configuración base. Para eliminar correctamente un nodo que fue
federado como parte de la creación de un perfil de célula, utilice el mandato manageprofiles para
suprimir el perfil del nodo. Después de suprimir el perfil del nodo, utilice el
mandato -cleanupNode en el Gestor de despliegue para
eliminar la configuración del nodo del repositorio de células. Se puede crear un nuevo perfil con la herramienta de gestión de perfiles o el mandato manageprofiles.
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.
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 |
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.
![[IBM i]](../images/iseries.gif)
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.