![[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
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.
- 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 base 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_plantillaPuede 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_plantillaConsulte 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_seguridadCuando 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: Los nombres de célula deben
ser exclusivos. Si las células tienen nombres duplicados, se pueden producir
problemas en las comunicaciones remotas entre células, tales como las
llamadas remotas de Enterprise JavaBeans. 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.
- 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.
- 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.
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.
- 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.bpracSi 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.
- Especifica el nombre de nodo del nodo creado con el nuevo perfil. Utilice un valor exclusivo 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.
- 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_perfilEl 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.
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/nombrePerfilNota: 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,myOptionalAction2Al 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_archivoPara restaurar un perfil, realice los pasos siguientes: - 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 ADMIN_AGENT para un servidor de agente administrativo. 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 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 10380Las 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:
![[Windows]](../images/windows.gif)
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”![[Linux]](../images/linux.gif)
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”![[AIX]](../images/aixlogo.gif)
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”![[HP-UX]](../images/hpux.gif)
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”![[Solaris]](../images/solaris.gif)
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”![[IBM i]](../images/iseries.gif)
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: 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
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: 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 |
| Perfil de gestión para un servidor de agente administrativo | raíz_servidor_aplic/profileTemplates/management/actions/portsUpdate/adminagent.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
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.
![[AIX HP-UX Solaris]](../images/unix.gif)
Reference topic