WebSphere Enterprise Service Bus, Versión 6.2.0 Sistemas operativos: AIX, HP-UX, i5/OS, Linux, Solaris, Windows


Parámetros de manageprofiles

Utilice los parámetros siguientes con el mandato manageprofiles para WebSphere ESB.

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

Antes de empezar a utilizar el mandato manageprofiles, asegúrese de que conoce todos los requisitos previos para crear y aumentar perfiles. Para obtener más información sobre los requisitos previos, consulte la sección sobre Requisitos previos para crear o aumentar perfiles. Para obtener más información sobre cómo crear y aumentar perfiles, consulte la sección Creación de perfiles mediante el mandato manageprofiles y Aumento de perfiles mediante el mandato manageprofiles.

Atención: Al crear un perfil de WebSphere ESB, utilice sólo los parámetros que están documentados en el centro de información para WebSphere ESB.
Nota: Todos los parámetros son sensibles a las mayúsculas y minúsculas.

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

-adminUserName ID_Usuarioadmin
Especifica el ID de usuario utilizado para la seguridad administrativa. Para aumentar un perfil existente que tiene habilitada la seguridad administrativa, es necesario este parámetro.
-adminPassword Contrseñaadmin
Especifica la contraseña para el ID de usuario de la seguridad administrativa especificado con el parámetro -adminUserName. Para aumentar un perfil existente que tiene habilitada la seguridad administrativa, es necesario este parámetro.
-augment
Utilice el parámetro augment para realizar cambios en un perfil existente con una plantilla de aumento. El parámetro augment hace que el mandato manageprofiles actualice o aumente el perfil identificado en el parámetro -profileName utilizando la plantilla en el parámetro -templatePath. Las plantillas de aumento que puede utilizar están determinadas por los productos y las versiones de IBM® instaladas en el entorno.
Nota: No modifique manualmente los archivos situados en el directorio dir_instalación/Plantillasperfil. Por ejemplo, si cambia los puertos durante la creación de perfiles, utilice la herramienta de gestión de perfiles o los argumentos -startingPort o -portsFile en el mandato manageprofiles, en lugar de modificar el archivo en el directorio de la plantilla del perfil.
Especifique la vía de acceso del archivo totalmente calificada para -templatePath. Por ejemplo:
manageprofiles(.bat)(.sh) -augment -profileName nombre_perfil
 -templatePath vía_acceso_completa
-backupProfile
Realiza una copia de seguridad del sistema de archivos de una carpeta de perfil y de los metadatos del perfil desde el archivo de registro del perfil.

Este parámetro no se soporta con WebSphere ESB.

-backupFile nombre_archivo_copia_seguridad
Hace una copia de seguridad del archivo de registro del perfil en el archivo especificado. Debe proporcionar una vía de acceso de archivo totalmente calificada para el nombre_archivo_copia_seguridad.
-cbeServerName
Nombre del servidor donde se ha configurado que se ejecute el navegador de WebSphere ESB Common Base Event.
-ceiBufferPool4k
Especifica el nombre de la agrupación de almacenamiento intermedio de 4 K para Common Event Infrastructure. Esta agrupación de almacenamiento intermedio debe estar activa para poder activar los scripts DDL de base de datos.
Nota: En desuso en la versión 6.2 para todas las bases de datos excepto DB2 para z/OS.
-ceiBufferPool8k
Especifica el nombre de la agrupación de almacenamiento intermedio de 8 K para Common Event Infrastructure. Esta agrupación de almacenamiento intermedio debe estar activa para poder activar los scripts DDL de base de datos.
Nota: En desuso en la versión 6.2 para todas las bases de datos excepto DB2 para z/OS.
-ceiBufferPool16k
Especifica el nombre de la agrupación de almacenamiento intermedio de 16 K para Common Event Infrastructure. Esta agrupación de almacenamiento intermedio debe estar activa para poder activar los scripts DDL de base de datos.
Nota: En desuso en la versión 6.2 para todas las bases de datos excepto DB2 para z/OS.
-ceiDbInstallDir
Directorio donde se ha instalado la base de datos para Common Event Infrastructure. Este parámetro sólo es necesario si ha especificado true para el parámetro dbDelayConfig.
-ceiDbName
Nombre de la base de datos sucesos de Common Event Infrastructure que se debe crear. Para bases de datos DB2, bases de datos Derby, bases de datos Informix y bases de datos Microsoft® SQL Server, el valor por omisión es event si no se especifica ninguno. Para bases de datos DB2 iSeries (i5/OS) nativas, el valor por omisión es *LOCAL si no se especifica. Para las bases de datos DB2 iSeries (i5/OS) Toolbox, el valor por omisión es *SYSBAS si no se especifica.

Para bases de datos Oracle, el SID (Identificador de sistema) Oracle ya se debe haber creado y debe estar disponible para que el mandato de servicio de sucesos cree las tablas y llene las tablas con datos. Si no se especifica, el valor por omisión es orcl.

-ceiDbNodeName
Nombre de nodo DB2 (debe tener 8 caracteres o menos) para Common Event Infrastructure. Este nodo ya debe estar catalogado y configurado para comunicarse con el servidor DB2. Este parámetro se debe establecer si la estación de trabajo actual se ha configurado como un cliente DB2 y el parámetro dbDelayConfig se establece en true.
Nota: En desuso en la versión 6.2 para todas las bases de datos excepto el cliente de DB2.
-ceiDbUser
Nota: En desuso en la versión 6.2 para todas las bases de datos excepto Microsoft SQL Server.
Especifica el ID de usuario a utilizar para la base de datos de sucesos de Common Event Infrastructure.
Para bases de datos DB2, el valor por omisión es db2inst1 si no se especifica ningún valor. Para las bases de datos DB2 para z/OS, especifica el ID de usuario que tiene privilegios para crear y descartar las bases de datos. Este parámetro es obligatorio.
Para el sistema operativo i5/OS Para las bases de datos iSeries (i5/OS), especifica el ID de usuario que tiene privilegios para crear y descartar las bases de datos. Este parámetro es obligatorio.
Para bases de datos Derby, es el ID de usuario utilizado por el origen de datos para la autenticación de base de datos Derby. Este parámetro es opcional cuando la seguridad de dominio de WebSphere se ha inhabilitado y es necesario cuando la seguridad de dominio de WebSphere está habilitado.
Para bases de datos Informix, especifica el ID de usuario de esquema de base de datos Informix que será propietario de las tablas de base de datos de servicio de sucesos. El origen de datos WebSphere utiliza este ID de usuario para autenticar la conexión de base de datos de Informix. Este parámetro es obligatorio.
Para bases de datos Oracle, especifica el ID de usuario de esquema de Oracle que será propietario de las tablas de Oracle de servicio de sucesos. El ID de usuario se creará durante la creación de base de datos y el origen de datos de WebSphere utiliza este ID de usuario para autenticar la conexión de base de datos Oracle. Si no se especifica, el valor por omisión es ceiuser.
Para bases de datos de Microsoft SQL Server, especifica el ID de usuario de SQL Server que será propietario de las tablas de servicio de sucesos. Si no se especifica, el valor por omisión es ceiuser.
-dbCeiUserId
Para bases de datos Oracle, especifica el ID de usuario de CEI.
-dbUserId
Especifica el ID de usuario a utilizar para la base de datos de sucesos de Common Event Infrastructure.
Para bases de datos DB2, el valor por omisión es db2inst1 si no se especifica ningún valor. Para las bases de datos DB2 para z/OS, especifica el ID de usuario que tiene privilegios para crear y descartar las bases de datos. Este parámetro es obligatorio.
Para el sistema operativo i5/OS Para las bases de datos iSeries (i5/OS), especifica el ID de usuario que tiene privilegios para crear y descartar las bases de datos. Este parámetro es obligatorio.
Para bases de datos Derby, es el ID de usuario utilizado por el origen de datos para la autenticación de base de datos Derby. Este parámetro es opcional cuando la seguridad de dominio de WebSphere se ha inhabilitado y es necesario cuando la seguridad de dominio de WebSphere está habilitado.
Para bases de datos Informix, especifica el ID de usuario de esquema de base de datos Informix que será propietario de las tablas de base de datos de servicio de sucesos. El origen de datos WebSphere utiliza este ID de usuario para autenticar la conexión de base de datos de Informix. Este parámetro es obligatorio.
Para bases de datos Oracle, especifica el ID de usuario de esquema de Oracle que será propietario de las tablas de Oracle de servicio de sucesos. El ID de usuario se creará durante la creación de base de datos y el origen de datos de WebSphere utiliza este ID de usuario para autenticar la conexión de base de datos Oracle. Si no se especifica, el valor por omisión es ceiuser.
Para bases de datos de Microsoft SQL Server, especifica el ID de usuario de SQL Server que será propietario de las tablas de servicio de sucesos. Si no se especifica, el valor por omisión es ceiuser.
-ceiDiskSizeInMB
Tamaño de base de datos en MB que se debe crear para la base de datos de sucesos de Common Event Infrastructure. El valor más bajo que se puede establecer es 10 MB. Para DB2 para z/OS, el valor por omisión es de 100 MB si no se especifica ningún valor.
Nota: En desuso en la versión 6.2 para todas las bases de datos excepto DB2 para z/OS.
-ceiInstancePrefix
Para bases de datos de Informix, Oracle y Microsoft SQL Server, el mandato utiliza el nombre de instancia de base de datos de sucesos de Common Event Infrastructure para agrupar los archivos de base de datos en un directorio con nombres exclusivos. Si no se especifica, el valor por omisión es ceiinst1.
Nota: En desuso en la versión 6.2 para todas las bases de datos excepto Informix, Oracle y Microsoft SQL Server.
-dbLocation
Directorio de ORACLE_HOME. Este parámetro es obligatorio cuando el parámetro dbDelayConfig se establece en true.
-ceiOverrideDataSource
Cuando este parámetro se establece en true, el mandato elimina el origen de datos de servicio de Common Event Infrastructure existente en el ámbito especificado antes de crear uno nuevo. Cuando este parámetro está establecido en false, el mandato no crea ningún dato de servicio de sucesos en el ámbito especificado, si se encuentra en el mismo ámbito otro origen de datos del servicio de sucesos. El valor por omisión es false, si no se especifica ninguno.
-ceiSaUser
ID de Microsoft SQL Server que tiene privilegios para crear tablas, dispositivos y antememorias para Common Event Infrastructure. Este parámetro es necesario si el parámetro dbDelayConfig se establece en true.
Nota: En desuso en la versión 6.2 para todas las bases de datos excepto Microsoft SQL Server.
-ceiSaPassword
Contraseña para el ID de Microsoft SQL Server que tiene privilegios para crear tablas, dispositivos y antememorias para Common Event Infrastructure. Este parámetro es necesario si especifica un valor para el parámetro ceiSaUser, a menos que el ID de usuario sa no tenga contraseña.
Nota: En desuso en la versión 6.2 para todas las bases de datos excepto Microsoft SQL Server.
-cellName nombre_célula
Especifica el nombre de célula del perfil para Common Event Infrastructure. Utilice un nombre de célula exclusivo para cada perfil. Este parámetro sólo es para la creación de perfiles. No proporcione este parámetro cuando aumente un perfil existente.
El valor por omisión para este parámetro se basa en una combinación del nombre de sistema principal abreviado, la Célula constante y un número de seguimiento, por ejemplo:
if (DMgr)
	Nombre_Sistema_principal_abreviadoCélulaNúmero_Célula
else
	Nombre_Sistema_principal_abreviadoNodoNúmero_NodoCélula
donde Número_Célula es un número secuencial que empieza por 01 y Número_Nodo es el número del nodo que ha utilizado para definir el nombre del nodo.

El valor de este parámetro no debe contener espacios ni ningún carácter que no sea válido como los siguientes: *, ?, ", <, >, ,, /, \ y |.

-configureBSpace true | false
Configura Business Space basado en WebSphere, que permite que los usuarios utilicen de forma integrada las diferentes aplicaciones del abanico de productos de IBM WebSphere Business Process Management. El valor por omisión es true. Business Space tiene soporte con los siguientes productos de base de datos: Derby Embedded, Derby Network Server, DB2 Universal, DB2 Universal Runtime Client, DB2 para i5/OS, DB2 para z/OS, Oracle 9i, Oracle 10g y Oracle 11g.
Importante: Si la base de datos común utilizada para WebSphere ESB no coincide con las bases de datos admitidas para Business Space, el mandato manageprofiles utiliza una base de datos Derby Embedded para la configuración de Business Space. No puede federar este perfil en un entorno de despliegue más adelante porque Derby incorporado no recibe soporte para entornos de despliegue.
Para obtener más información sobre la configuración de Business Space para los entornos de despliegue, consulte Configuración de Business Space en Información relacionada.
-create
Crea el perfil.
Especifique manageprofiles -create -templatePath vía_acceso_archivo_totalmente_calificada_a_la_plantilla -help si desea información específica acerca de la creación de un perfil. Entre las plantillas disponibles se encuentra:
  • default.esbserver: para un perfil de servidor autónomo de WebSphere Enterprise Service Bus, que define un servidor autónomo.
  • dmgr.esbserver: para un perfil de gestor de despliegue de WebSphere Enterprise Service Bus, que define un gestor de despliegue.
  • managed.esbserver: para un perfil personalizado de WebSphere Enterprise Service Bus que cuando está federado con un gestor de despliegue, define un nodo gestionado.
-dbCommonForME
Indica si se debe utilizar la base de datos común para motores de mensajería. Para las bases de datos DB2 para z/OS, el valor por omisión es true. Para todas las demás bases de datos, el valor por omisión es false. Si este parámetro se establece en false, los motores de mensajería utilizarán un almacén de datos de almacén de archivos.
-dbConnectionLocation
Ubicación de base de datos DB2 para z/OS.
-dbCreateNew
Indica si creará o reanudará una base de datos. Los valores válidos son true o false.
-dbDelayConfig
Indica si retrasará la creación de una tabla, hasta después de haber creado el perfil. Los valores válidos son true o false. El parámetro se establece en false por omisión.
-dbDriverType
El tipo de controlador de la base de datos. Para bases de datos Oracle, los valores válidos son ORACLE_THIN u ORACLE_OCI. Para bases de datos DB2, los valores válidos son 2 o 4.
-dbHostName
El nombre de sistema principal del servidor de bases de datos o la dirección IP. El valor por omisión es localhost.
-dbInstance
Nombre de instancia de las bases de datos Informix.
-dbJDBCClasspath
La ubicación de los archivos del controlador JDBC.
-dbLocation
Indica el directorio de instalación de base de datos si utiliza bases de datos Informix. Sólo puede utilizar este parámetro si el parámetro dbCreateNew se establece en true.
-dbName
El nombre de la base de datos. El valor se establece en WPRCSDB por omisión.
-dbOutputScriptDir
La ubicación para los scripts exportados de la base de datos.
-dbPassword
La contraseña necesaria para la autenticación de la base de datos. Este parámetro es necesario para todas las bases de datos, excepto Derby Embedded.
-dbSchemaName
El nombre del esquema de base de datos para bases de datos DB2 para iSeries, DB2 para i5/OS y DB2 para z/OS.
Nota: Este parámetro no es válido para ser utilizado con la base de datos DB2 Universal.
-dbServerPort
El número de puerto del servidor de bases de datos. En función de la base de datos que utilice, puede especificar un número de puerto diferente, en lugar del número de puerto por omisión.
-dbStorageGroup
Nombre de grupo de almacenamiento para bases de datos DB2 z/OS.
-dbType
El tipo de base de datos.

Establezca uno de los valores siguientes para el tipo de producto de base de datos que utilice con WebSphere ESB.

  • DERBY_EMBEDDED para una base de datos Derby Embedded
  • DERBY_NETWORKSERVER para una base de datos Derby Network Server
  • DB2_UNIVERSAL para una base de datos DB2 Universal Database
  • DB2UDBOS390_V8_1 para una base de datos DB2 para z/OS v8
  • DB2UDBOS390_V9_1 para una base de datos DB2 para z/OS v9
  • DB2UDBISERIES_NATIVE para una base de datos DB2 UDB para iSeries o DB2 para i5/OS utilizando un controlador nativo.
  • DB2UDBISERIES_TOOLBOX para una base de datos DB2 UDB para iSeries o DB2 para i5/OS utilizando un controlador Toolbox.
  • INFORMIX para una base de datos Informix Dynamic Server
  • MSSQLSERVER_EMBEDDED para una base de datos Microsoft SQL Server utilizando un controlador Embedded
  • MSSQLSERVER_DATADIRECT para una base de datos Microsoft SQL Server utilizando un controlador DataDirect
  • MSSQLSERVER_MICROSOFT para una base de datos Microsoft SQL Server utilizando un controlador Microsoft
    Nota: Se ha añadido soporte para el controlador JDBC de Microsoft SQL Server, el controlador Microsoft SQL Server veresión 1.2 en WebSphere Process Server, versión 6.2.0.1.
  • ORACLE9I para una base de datos Oracle 9i
  • ORACLE10G para una base de datos Oracle 10g o Oracle 11g
-debug
Activa la función de depuración del programa de utilidad Apache Ant, que el mandato manageprofiles utiliza.
-defaultPorts
Asigna los valores de puerto por omisión o básicos al perfil.

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

Durante la creación de perfiles, el mandato manageprofiles utiliza un conjunto generado automáticamente de puertos recomendados, si no especifica el parámetro -startingPort, -defaultPorts o -portsFile. Los valores de puerto recomendados pueden ser diferentes a los valores de puerto por omisión, según la disponibilidad de los puertos por omisión.

Nota: No utilice este parámetro si utiliza la plantilla de perfil gestionado.
-delete
Suprime el perfil.

La supresión de un perfil no suprime el directorio del perfil. Por ejemplo, si crea un perfil en el directorio /usr/WebSphere/ESB/profiles/managedProfile o en las plataformas i5/OS, en el directorio QIBM/UserData/WebSphere/ESB/profiles/managedProfile, el directorio permanece después de suprimir el perfil.

Puede suprimir o abandonar el directorio. Sin embargo, el directorio raíz_perfil/logs contiene información sobre cómo desinstalar el perfil. Por ejemplo, puede conservar el archivo _nodeuninst.log para determinar la causa de cualquier problema durante el procedimiento de desinstalación.

Si suprime un perfil que ha registrado plantillas en aumento en el registro del perfil, las acciones de reducción se realizan automáticamente.

-deleteAll
Suprime todos los perfiles registrados.

La supresión de un perfil no suprime el directorio del perfil. Por ejemplo, suponga que crea un perfil en el directorio /usr/WebSphere/ESB/profiles/managedProfile o en las plataformas i5/OS, en el directorio QIBM/UserData/WebSphere/ESB/profiles/managedProfile. El directorio permanecerá, después de que suprima el perfil.

Puede suprimir o abandonar el directorio. Sin embargo, el directorio raíz_perfil/logs contiene información sobre cómo desinstalar el perfil. Por ejemplo, puede conservar el archivo _nodeuninst.log para determinar la causa de cualquier problema durante el procedimiento de desinstalación.

Si suprime un perfil que ha registrado plantillas en aumento en el registro del perfil, las acciones de reducción se realizan automáticamente.

-dmgrHost nombre_sistema_principal_dmgr
Identifica la estación de trabajo donde se ejecuta el gestor de despliegue. Especifique este parámetro y el parámetro dmgrPort para federar un perfil personalizado, al crearlo o aumentarlo. Este parámetro está disponible con la plantilla de perfil managed.esbserver.

El nombre de host puede ser el nombre DNS largo o corto o la dirección IP de la estación de trabajo del gestor de despliegue.

Especificar este parámetro opcional dirige el mandato manageprofiles para intentar federar el nodo personalizado en la célula del gestor de despliegue cuando se crea el perfil personalizado. Este parámetro se ignora al crear un perfil de gestor de despliegue o perfil de servidor autónomo.

Si federa un nodo personalizado cuando no se ejecuta el gestor de despliegue, el indicador de instalación de las anotaciones cronológicas es INSTCONFFAILED para indicar una anomalía completa. El perfil personalizado resultante no puede utilizarse. Debe extraer el directorio de perfil personalizado del depósito de perfiles (el directorio raíz de instalación del perfil) antes de crear otro perfil personalizado con el mismo nombre de perfil.

Si ha habilitado la seguridad o ha cambiado el tipo de conector JMX por omisión, no puede federarlo con el mandato manageprofiles. Utilice en su lugar el mandato addNode.

El valor por omisión de este parámetro es localhost. El valor para este parámetro debe ser un nombre de sistema principal formado correctamente y no debe contener espacios o caracteres que no son válidos como los siguientes: *, ?, ", <, >, , , /, \ y |. Debe estar disponible una conexión con el gestor de despliegue junto con el parámetro dmgrPort.

-dmgrPort número_puerto_gestord
Identifica el puerto SOAP del gestor de despliegue. Especifique este parámetro y el parámetro dmgrHost para federar un perfil personalizado al crearlo o aumentarlo. El gestor de despliegue debe ejecutarse y ser accesible.

Si ha habilitado la seguridad o ha cambiado el tipo de conector JMX por omisión, no puede federarlo con el mandato manageprofiles. Utilice en su lugar el mandato addNode.

El valor por omisión de este parámetro es 8879. El puerto que indique debe ser un entero positivo y debe estar disponible una conexión con el gestor de despliegue junto con el parámetro dmgrHost.

-enableAdminSecurity true | false
Habilita la seguridad administrativa. Los valores válidos incluyen true o false. El valor por omisión es false. Si está creando perfiles para un entorno de despliegue, debe establecer este parámetro en true. Utilice este parámetro sólo cuando cree perfiles. No proporcione este parámetro cuando aumente un perfil existente.
Cuando enableAdminSecurity se establece en true, también debe especificar los parámetros -adminUserName y -adminPassword junto con los valores para estos parámetros. Si se han instalado ejemplos durante la instalación de servidor de aplicaciones, también debe especificar el parámetro -samplesPassword al crear un perfil para el que se ha habilitado la seguridad administrativa. Si el parámetro -samplesPassword no se especifica cuando está habilitada la seguridad administrativa, el perfil se crea correctamente, pero cuando intente ejecutar los ejemplos, se colocarán excepciones y anomalías en el archivo de anotaciones cronológicas de la salida del sistema del servidor.
Para el sistema
operativo Linux -enableService true | false
Habilita la creación de un servicio Linux. Los valores válidos incluyen true o false. El valor por omisión de este parámetro es false. Utilice este parámetro sólo cuando cree perfiles. No proporcione este parámetro cuando aumente un perfil existente.

Cuando se ejecuta el mandato manageprofiles con la opción -enableService establecida en true, el servicio de Linux se crea con el perfil cuando el usuario root ejecuta el mandato. Cuando un usuario no root ejecuta el mandato manageprofiles, se crea el perfil, pero no el servicio de Linux. El servicio de Linux no se crea porque el usuario no root no tiene suficiente permiso para configurar el servicio. Se visualiza un resultado de INSTCONPARTIALSUCCESS al final de la creación de perfil y las anotaciones cronológicas de creación de perfil raíz_instalación/logs/manageprofiles/nombre_perfil_create.log contiene un mensaje que indica que el usuario actual no tiene suficiente permiso para configurar el servicio de Linux.

-federateLater true | false
Indica si el perfil gestionado se federará durante la creación del perfil, o bien si lo federará más tarde utilizando el mandato addNode. Si está creando un perfil de WebSphere ESB, no proporcione un valor; utilice el valor por omisión de true.
-federateLaterWESB true | false
Indica si el perfil gestionado se federará más adelante utilizando la plantilla managed.wesbserver. Los valores válidos son true o false. Si no se establecen los parámetros dmgrHost, dmgrPort, dmgrAdminUserName y dmgrAdminPassword, el valor por omisión para este parámetro es true.
-fileStoreForME true | false
Si se establece en true, se utilizará el almacén de datos del almacén de archivos para los motores de mensajería. El valor predeterminado de este parámetro es false.
Nota: Los parámetros -dbCommonForME y -fileStoreForME no se pueden establecer ambos en true. Esto produce un error de validación.
-getDefaultName
Devuelve el nombre del perfil por omisión.
-getName
Obtiene el nombre de un perfil registrado en un parámetro -profilePath determinado.
-getPath
Obtiene la ubicación del sistema de archivos para un perfil de un nombre determinado. Requiere el parámetro –profileName.
-help
Visualiza la sintaxis del mandato.
-hostName nombre_sist_princ
Especifica el nombre de sistema principal al crear el perfil. No proporcione este parámetro cuando aumente un perfil existente. Este valor debe coincidir con el nombre de sistema principal que ha especificado durante la instalación del producto inicial. El valor por omisión de este parámetro es el formato largo del sistema de nombres de dominios. Este parámetro es necesario sólo para la creación de perfiles. El valor de este parámetro debe ser un nombre de sistema principal IPv6 válido y no debe contener espacios ni caracteres que no sean válidos, como los siguientes: *, ?, ", <, >, ,, /, \ y |.
-ignoreStack
Un parámetro opcional que se utiliza con el parámetro -templatePath para reducir un perfil particular que haya sido aumentado.
Nota: Para WebSphere ESB, no está soportado el uso de perfiles que hayan sido reducidos (parámetro -unaugment).
-isDefault
Especifica que el perfil identificado por el parámetro -profileName adjunto debe ser el perfil por omisión cuando se registre. Cuando se emiten mandatos que se dirigen al perfil por omisión, no es necesario utilizar el atributo -profileName del mandato.
-isDeveloperServer
Especifica si el servidor sólo tiene una finalidad 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 desplegarlas en sus servidores de aplicaciones de producción. Este parámetro sólo es válido para crear perfiles en WebSphere ESB.
Si -isDeveloperServer se establece al crear un perfil de WebSphere ESB, se instala un depósito de archivos VMM preconfigurado.
-listProfiles
Lista todos los perfiles definidos.
-ndtopology
Indica si desea utilizar la vía de acceso del entorno de despliegue para crear el perfil. Los valores válidos son true o false.
-nodeName nombre_nodo
Especifica el nombre de nodo para el nodo que se crea con el nuevo perfil. No proporcione este parámetro cuando aumente un perfil existente. Utilice un valor exclusivo en la célula o en la estación de trabajo. Cada perfil que comparte el mismo conjunto de binarios de producto debe tener un nombre de nodo exclusivo. Este parámetro es necesario sólo para la creación de perfiles con las plantillas default.wbiserver, dmgr.wbiserver y managed.wbiserver.
Para el sistema
operativo LinuxPara el sistema operativo UNIXPara el sistema operativo Windows El valor por omisión de este parámetro se basa en el nombre de sistema principal abreviado, el tipo de perfil y un número de seguimiento, por ejemplo:
if (DMgr)
	Nombre_Sistema_principal_abreviadoGestor_CélulasNúmero_Nodo
else
	Nombre_Sistema_principal_abreviadoNodoNúmero_Nodo
donde Número_Nodo es un número secuencial que empieza en 01.
Para el sistema operativo i5/OS Los nombres de nodo por omisión son los siguientes:
  • plantilla dmgr: nombre_perfilManager
  • plantilla por omisión: nombre_sistema_principal_abreviado_nombre_perfil
  • plantilla gestionada: nombre_sistema_principal_abreviado_nombre_perfil
  • célula: consulte los ejemplos anteriores de las plantillas dmgr y por omisión y aplíquelos según proceda a los dos perfiles que se han creado.

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

-omitAction característica1 característica2... característicaN
Un parámetro opcional que excluye las características del perfil.
Cada plantilla de perfil viene predefinida con determinas características opcionales. La opción samplesInstallAndConfig sólo está disponible cuando el producto se instala con aplicaciones de ejemplo seleccionadas. Las características opcionales siguientes se pueden utilizar con el parámetro -omitAction para las plantillas de perfil siguientes:
  • default - Servidor de aplicaciones
    • deployAdminConsole
    • samplesInstallAndConfig
    • defaultAppDeployAndConfig
  • dmgr - Gestor de despliegue
    • deployAdminConsole
-portsFile vía_acceso_archivo
Un parámetro opcional que especifica la vía de acceso de un archivo que define los valores del puerto para el nuevo perfil. No proporcione este parámetro cuando aumente un perfil existente.

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

Durante la creación de perfiles, el mandato manageprofiles utiliza un conjunto generado automáticamente de puertos recomendados, si no especifica el parámetro -startingPort, -defaultPorts o -portsFile. Los valores de puerto recomendados pueden ser diferentes a los valores de puerto por omisión, según la disponibilidad de los puertos por omisión.

-profileName nombre_perfil
Especifica el nombre del perfil. Utilice un valor exclusivo cuando cree un perfil.
Cada perfil que comparte el mismo conjunto de binarios del producto debe tener un nombre exclusivo. El nombre del perfil por omisión se basa en el tipo de perfil y en un número de seguimiento, por ejemplo:
Tipo_perfil Número_perfil
donde Tipo_perfil es un valor como ProcSrv, Dmgr o Custom y Número_perfil es un número secuencial que crea un nombre de perfil único.

El valor de este parámetro no debe contener espacios ni caracteres que no sean válidos, como los siguientes: *, ?, ", <, >, ,, /, \ y |. El nombre de perfil que elija no debe estar en uso.

-profilePath raíz_perfil
Especifica la vía de acceso totalmente calificada del perfil, al que se hace referencia a lo largo del centro de información como raíz_perfil.
Por ejemplo:
-profilePath raíz_perfil
Utilice este parámetro sólo cuando cree perfiles. No establezca este parámetro para aumentar un perfil existente.

Para el sistema operativo Windows En las plataformas Windows: Si la vía de acceso totalmente calificada contiene espacios, escriba el valor entre comillas.

El valor por omisión se basa en el directorio raíz_instalación, el subdirectorio profiles y el nombre del archivo.

Por ejemplo, el valor por omisión para la creación de perfil es:
WS_WSPROFILE_DEFAULT_PROFILE_HOME/nombre_perfil
donde WS_WSPROFILE_DEFAULT_PROFILE_HOME se define en el archivo wasprofile.properties del directorio raíz_instalación/properties.

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

Debe tener permisos para escribir en el directorio.

-response archivo_respuestas
Accede a todas las funciones de la API desde la línea de mandatos utilizando el mandato manageprofiles.
La interfaz de la línea de mandatos puede ser dirigida por un archivo de respuestas que contiene los argumentos de entrada para un mandato determinado en el archivo de propiedades en el formato de clave y valor. A continuación, aparece un archivo de respuestas de ejemplo para una operación create:
create
profileName=testResponseFileCreate
profilePath=raíz_perfil
templatePath=raíz_instalación/profileTemplates/default
nodeName=miNombreNodo
cellName=miNombreCélula
hostName=miNombreSistemaPrincipal
omitAction=miAcciónOpcional1, miAcciónOpcional2
Para el sistema operativo Windows En las plataformas Windows: 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 las barras inclinadas invertidas, el archivo de respuestas requiere barras inclinadas invertidas dobles para que el archivo de respuestas entienda correctamente la vía de acceso. Aquí aparece un ejemplo de un archivo de respuestas para una operación create que utiliza las barras inclinadas invertidas dobles:
create
templatePath=C:\\WebSphere\\ESB\\profileTemplates\\default

Para determinar qué argumentos de entrada son necesarios para los diversos tipos de plantillas de perfil y acción, utilice el mandato manageprofiles con el parámetro -help.

-restoreProfile
Restaura la copia de seguridad de un perfil. Se debe utilizar con el parámetro -backupFile. Este parámetro no se soporta para WebSphere ESB.
-samplesPassword Contraseña_de_ejemplo
Cree una contraseña para utilizarla en ejemplos. La contraseña se utiliza para restringir el acceso a los ejemplos de aplicación Web instalados durante la instalación del servidor de aplicaciones.
Para el sistema
operativo Linux -serviceUserName ID_usuario_servicio
Especifica el ID de usuario que se utiliza durante la creación del servicio Linux para que el servicio Linux se ejecute bajo este ID de usuario. El servicio Linux se ejecuta siempre que el ID de usuario inicia una sesión.
-setDefaultName
Establece el perfil por omisión en uno de los perfiles existentes. Se debe utilizar con el parámetro -profileName, por ejemplo:
manageprofiles(.bat)(.sh) -setDefaultName -profileName nombre_perfil
-startingPort Puerto_de_inicio
Especifica el número de puerto de inicio para generar y asignar todos los puertos para el perfil.

No establezca este parámetro, si aumenta un perfil existente. Los valores de puerto se asignan de forma secuencial a partir del valor -startingPort, y se omiten los puertos que ya estén siendo utilizados. En todos los sistemas, excepto i5/OS, el sistema reconoce y resuelve los puertos que se están utilizando actualmente y determina las asignaciones de puerto para evitar conflictos de puerto.

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

Durante la creación de perfiles, el mandato manageprofiles utiliza un conjunto generado automáticamente de puertos recomendados, si no especifica el parámetro -startingPort, -defaultPorts o -portsFile. Los valores de puerto recomendados pueden ser diferentes a los valores de puerto por omisión, según la disponibilidad de los puertos por omisión.

Nota: No utilice este parámetro si utiliza la plantilla de perfil gestionado.
-templatePath vía_de_acceso_plantilla
Especifica la vía de acceso de directorio a los archivos de plantilla en el directorio raíz de instalación. Dentro del directorio profileTemplates hay varios directorios que corresponden a distintos tipos de perfil y que varían en función del tipo de producto instalado. Los directorios de perfil son las vías de acceso que se indican al utilizar la opción -templatePath. Puede especificar plantillas de perfil que se encuentran fuera de la raíz de la instalación, si es que existe alguna.

Utilice vías de acceso absolutas. Este parámetro debe existir como un directorio y debe señalar un directorio de plantilla válido.

Utilice las plantillas siguientes con WebSphere ESB:
  • default.esbserver: para un perfil de servidor autónomo de WebSphere Enterprise Service Bus, que define un servidor autónomo.
  • dmgr.esbserver: para un perfil de gestor de despliegue de WebSphere Enterprise Service Bus, que define un gestor de despliegue.
  • managed.esbserver: para un perfil personalizado de WebSphere Enterprise Service Bus que cuando está federado con un gestor de despliegue, define un nodo gestionado.
-topologyPattern
Determina los patrones del entorno de despliegue para el gestor de despliegue que se está creando. Los valores válidos son CondensedSync, CondensedAsync o Reference.
-topologyRole
Indica la función que desempeñará el perfil en el entorno de despliegue, cuando se federe un perfil que haya sido creado. Los valores válidos son ADT para un destino de despliegue, Messaging para una mensajería de sistema principal o Support para los servicios de soporte. Puede indicar un valor o más de un valor, cada uno separado mediante un espacio, por ejemplo, ADT Messaging Support o Messaging o ADT Support.
-unaugment
Nota: Para WebSphere ESB, no está soportado el uso de perfiles que hayan sido reducidos (parámetro -unaugment).
-validateAndUpdateRegistry
Comprueba todos los perfiles que aparecen listados en el registro de perfiles para verificar si los perfiles están presentes en el sistema de archivos. Elimina cualquier perfil que no aparezca en el registro. Devuelve una lista de los perfiles que faltan que hayan sido suprimidos del registro.
-validateRegistry
Comprueba todos los perfiles que aparecen listados en el registro de perfiles para verificar si los perfiles están presentes en el sistema de archivos. Devuelve una lista de los perfiles que faltan.
-validatePorts
Especifica los puertos que se deben validar para garantizar que no estén reservados o siendo utilizados. Este parámetro le ayuda a identificar puertos que no están siendo utilizados. Si se ha determinado que un puerto está siendo utilizado, se detiene la creación del perfil y se visualiza un mensaje de error. Puede utilizar este parámetro en cualquier momento en la línea de mandatos de create. Se recomienda el uso de este parámetro con el parámetro –portsFile.
-webServerCheck true | false
Indica si desea configurar definiciones del servidor Web. Los valores válidos incluyen true o false. El valor predeterminado de este parámetro es false. Utilice este parámetro sólo cuando cree perfiles. No proporcione este parámetro cuando aumente un perfil existente.
-webServerHostname nombre_sistema_principal_servidor_web
El nombre de sistema principal del servidor. El valor por omisión de este parámetro es el nombre de sistema principal largo de la estación de trabajo local. Utilice este parámetro sólo cuando cree perfiles. No proporcione este parámetro cuando aumente un perfil existente.
-webServerInstallPath nombre_vía_de_acceso_instalación_servidor_web
La vía de acceso de la instalación del servidor Web, local o remoto. Utilice este parámetro sólo cuando cree perfiles. No proporcione este parámetro cuando aumente un perfil existente.
El valor por omisión de este parámetro depende del sistema operativo de la estación de trabajo local y del valor del parámetro webServerType. Por ejemplo:
Para el sistema operativo AIX
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”

Para el sistema operativo HP-UX
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”

Para el sistema
operativo Linux
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”

Para el sistema operativo Solaris
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”

Para el sistema operativo Windows
webServerType=IHS: webServerInstallPath defaulted to “C:\Archivos de programa\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”
-webServerName nombre_servidor_web
El nombre del servidor Web. El valor por omisión de este parámetro es webserver1. Utilice este parámetro sólo cuando cree perfiles. No proporcione este parámetro cuando aumente un perfil existente.
-webServerOS sistema_operativo_servidor_Web
El 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.
Utilice este parámetro sólo cuando cree perfiles. No proporcione este parámetro cuando aumente un perfil existente.
-webServerPluginPath vía_de_acceso_plugin_servidor_Web
La vía de acceso de los plug-ins que utiliza el servidor Web. El valor predeterminado de este parámetro es raíz_instalación/plugins. Utilice este parámetro sólo cuando cree perfiles. No proporcione este parámetro cuando aumente un perfil existente.
-webServerPort puerto_servidor_Web
Indica el puerto desde el cual se accederá al servidor Web. El valor predeterminado de este parámetro es 80. Utilice este parámetro sólo cuando cree perfiles. No proporcione este parámetro cuando aumente un perfil existente.
-webServerType tipo_servidor_Web
El tipo de servidor Web. Los valores válidos incluyen: IHS, SUNJAVASYSTEM, IIS, DOMINO, APACHE y HTTPSERVER_ZOS. Utilice este parámetro con el parámetro webServerOS. Utilice este parámetro sólo cuando cree perfiles. No proporcione este parámetro cuando aumente un perfil existente.
Para el sistema operativo Windows -winserviceAccountType specifieduser | localsystem
Tipo de la cuenta de propietario del servicio de Windows creado para el perfil. Utilice este parámetro sólo cuando cree perfiles. No proporcione este parámetro cuando aumente un perfil existente.
Los valores válidos incluyen: specifieduser o localsystem. El valor localsystem ejecuta el servicio de Windows bajo la cuenta local del usuario que crea el perfil. El valor predeterminado de este parámetro es system.
Para el sistema operativo Windows -winserviceCheck true | false
El valor puede ser indistintamente true o false. Especifique true para crear un servicio de Windows para el proceso de servidor que se crea en el perfil. Especifique false para no crear el servicio de Windows. El valor predeterminado de este parámetro es false.
Utilice este parámetro sólo cuando cree perfiles. No proporcione este parámetro cuando aumente un perfil existente.
Para el sistema operativo Windows -winservicePassword contraseña_servicio_win
Especifique la contraseña para el usuario especificado o la cuenta local que debe ser propietaria del servicio de Windows. Utilice este parámetro sólo cuando cree perfiles. No proporcione este parámetro cuando aumente un perfil existente.
Para el sistema operativo Windows -winserviceStartupType manual | automatic | disabled
Los valores posibles para el arranque de servicios de Windows son:
  • manual
  • automatic
  • disabled

El valor predeterminado de este parámetro es manual.

Utilice este parámetro sólo cuando cree perfiles. No proporcione este parámetro cuando aumente un perfil existente.

Para el sistema operativo Windows -winserviceUserName ID_usuario_servicio_win
Especifique el ID de usuario para que el sistema operativo Windows pueda verificarle como un ID que es capaz de crear un servicio de Windows. El ID de usuario debe pertenecer al grupo Administrador y tener los siguientes derechos de usuario avanzados:
  • Actuar como parte del sistema operativo
  • Iniciar una sesión como servicio
El valor predeterminado de este parámetro es el nombre del usuario actual. El valor de este parámetro no debe contener espacios ni caracteres que no sean válidos, como los siguientes: *, ?, ", <, >, ,, /, \ y |. El usuario que especifique debe tener los permisos apropiados para crear un servicio de Windows. Debe especificar la contraseña correcta para el nombre de usuario que elija.
Utilice este parámetro sólo cuando cree perfiles. No proporcione este parámetro cuando aumente un perfil existente.

reference Tema de referencia

Condiciones de uso | Comentarios


Icono de indicación de la hora Última actualización: 05 julio 2010


http://publib.boulder.ibm.com/infocenter/dmndhelp/v6r2mx/topic//com.ibm.websphere.wesb620.doc/doc/rins_manageprofiles_parms.html
Copyright IBM Corporation 2005, 2010. Reservados todos los derechos.
Este centro de información está basado en tecnología Eclipse (http://www.eclipse.org).