El script startOgServer inicia los servidores de contenedor y catálogo. Puede utilizar diversos parámetros al iniciar los servidores para habilitar el rastreo, especificar números de puerto, etc.
Finalidad
Puede utilizar el script startOgServer para iniciar servidores.
Ubicación
El script
startOgServer se encuentra en el directorio
bin del directorio raíz, por ejemplo:
cd raíz_intal_wxs/bin
Nota: Si tiene clases Java almacenadas en un directorio específico, o si utiliza un cargador o un agente, en lugar de alterar el script startOgServer, puede lanzar el servidor con argumentos del modo siguiente: -jvmArgs -cp C:\ . . . \DirectoryPOJOs\POJOs.jar
.
Opciones para iniciar servidores de catálogo
Todos los parámetros siguientes son opcionales.
Parámetros para iniciar un servidor de catálogo:- -catalogServiceEndPoints <nombreServidor:nombreHost:puertoCliente:puertoIgual>
- En el contenedor, hace referencia al host y puerto ORB (Object Request Broker - Intermediario
de solicitud de objetos) en el servicio de catálogo.
Cada atributo se define de la manera siguiente:
- serverName
- Especifica un nombre para identificar el proceso que está iniciando.
- hostName
- Especifica el nombre de host para el sistema donde se inicia el servidor.
- clientPort
- Especifica el puerto que se utiliza para la comunicación de servicio de catálogo de igual.
- peerPort
- Este valor es el mismo que el de haManagerPort. Especifica el puerto que
se utiliza para la comunicación de servicio de catálogo de igual.
El ejemplo siguiente inicia el servidor de catálogo cs1, que está en el dominio de servicio de catálogo que los servidores cs2 y cs3: startOgServer.bat|sh cs1 -catalogServiceEndPoints
cs1:MyServer1.company.com:6601:6602,
cs2:MyServer2.company.com:6601:6602,
cs3:MyServer3.company.com:6601:6602
- -clusterSecurityFile <archivo xml de seguridad de clúster>
- Especifica el archivo objectGridSecurity.xml en el disco duro, que describe las propiedades de seguridad comunes para todos los servidores (incluidos los servidores de catálogo y los servidores de contenedor).
Un ejemplo de propiedad es la configuración de autenticador que representa el mecanismo de autenticación y el registro de usuarios.
Ejemplo:/opt/xs/ogsecurity.xml
- -clusterSecurityUrl <URL de xml de seguridad de clúster>
- Especifica el archivo objectGridSecurity.xml como URL al archivo en el disco duro o en la red, que describe las propiedades de seguridad comunes para todos los servidores (incluidos los servidores de catálogo y los servidores de contenedor). Un ejemplo de propiedad es la configuración de autenticador que representa el mecanismo de autenticación y el registro de usuarios.
Ejemplo:file:///opt/xs/ogsecurity.xml
- -domain <nombre de dominio>
- Especifica el nombre del dominio de servicio de catálogo para este servidor de catálogo. El dominio de servicio de catálogo crea un grupo de servidores de catálogo con alta disponibilidad. Cada servidor de catálogo para un único dominio debe especificar el mismo valor para el parámetro -domain.
- -JMXConnectorPort <puerto>
- Define el puerto SSL (Capa de sockets seguros)
al que se enlaza el servicio JMX (Java Management
Extensions).
- -haManagerPort <puerto>
- Especifica el número de puerto utilizado por High Availability Manager. Si no se establece esta propiedad, no se elige un puerto libre. Esta propiedad se ignora en los entornos WebSphere Application Server.
- -JMXServicePort <puerto>
- Especifica el número de puerto en el que
el servidor MBean escucha las comunicaciones con
Java Management Extensions (JMX). La propiedad JMXServicePort especifica el puerto no SSL para JMX. Debe utilizar un número de puerto distinto para cada JVM de la configuración.
Si desea utilizar
JMX/RMI, especifique explícitamente JMXServicePort y el número de puerto,
incluso si desea utilizar el valor de puerto predeterminado. Esta propiedad se aplica tanto al servidor de contenedor, como al servicio catálogos. (Sólo necesario para entornos autónomos.)
Valor predeterminado: 1099 para servidores de catálogo
- -jvmArgs <argumento de JVM>
- Especifica un conjunto de argumentos de JVM. Cada opción después de la opción -jvmArgs se utiliza para iniciar la máquina virtual Java (JVM) del servidor. Cuando se utilice el parámetro -jvmArgs, asegúrese de que sea el último argumento del script opcional especificado.
Ejemplo: -jvmArgs -Xms256M
-Xmx1G
- -listenerHost <nombre de host>
Especifique el nombre de host al que se enlaza el
Intermediario para solicitudes de objetos (ORB) para la comunicación con
el protocolo Inter-ORB de Internet (IIOP). El valor debe ser un nombre de dominio
totalmente calificado o una dirección IP. Si la configuración incluye varias
tarjetas de red, establezca el puerto y el host de escucha para permitir que el
Intermediario para solicitudes de objetos de la
JVM conozca la dirección IP a la que enlazarse. Si no especifica qué
dirección IP se debe utilizar, se pueden producir síntomas como
tiempos de espera de conexión excedidos, anomalías de
API inusuales y clientes que parece que se cuelgan.
Valor predeterminado: localhost
- -listenerPort <puerto>
- Especifica el número de puerto al que se enlaza el
intermediario para solicitudes de objetos (ORB). Este valor configura los contenedores y clientes
para que se comuniquen con el servicio de catálogo mediante el ORB.
En WebSphere Application Server, el listenerPort se hereda de la configuración de puerto BOOTSTRAP_ADDRESS.Esta propiedad
se aplica al servidor de contenedor y al servicio de catálogo.Valor predeterminado: 2809
- -quorum true|false
Habilita el quórum para el servicio de catálogos. El quórum se utiliza para garantizar que una mayoría del dominio de servicio de catálogo está disponible antes de que se trasladen particiones en los servidores de contenedor disponibles. Para habilitar el quórum, establezca el valor en true o enabled.
El valor predeterminado es disabled. Esta propiedad se aplica solo al servicio de catálogo. Si desea más información, consulte Quórums del servidor de catálogos.
- -script <archivo de script>
- Especifica la ubicación de un script personalizado para mandatos que especifique para iniciar servidores de catálogo o contenedores y a continuación parametrizarlos o editarlos, según se requiera.
- -serverProps <archivo de propiedades de servidor>
- Especifica el archivo de propiedades que contiene las propiedades de seguridad específicas del servidor. El nombre de archivo especificado para esta propiedad está en formato de vía de acceso de archivo sencillo, como c:/tmp/og/catalogserver.props.
- -traceSpec <especificación de rastreo>
Permite el rastreo y la serie de especificación del rastreo para el servidor de contenedor.
El rastreo está inhabilitado de forma predeterminada. Esta propiedad se aplica tanto al servidor de contenedor, como al servicio catálogos. Ejemplos:
- ObjectGrid=all=enabled
- ObjectGrid*=all=enabled
- -traceFile <archivo de rastreo>
Especifica un nombre de archivo para grabar la información de rastreo. Esta propiedad se aplica tanto al servidor de contenedor, como al servicio catálogos. Ejemplo: ../logs/c4Trace.log
- -timeout <segundos>
- Especifica un número de segundos antes de que el inicio del servidor exceda el tiempo de espera.
Uso para servidores de contenedor
startOgServer.bat <servidor> -objectgridFile <archivo xml>
-deploymentPolicyFile <archivo xml> [options]
startOgServer.bat <servidor> -objectgridUrl <URL de xml>
-deploymentPolicyUrl <URL de xml> [options]
startOgServer.sh <servidor> -objectgridFile <archivo xml>
-deploymentPolicyFile <archivo xml> [options]
startOgServer.sh <servidor> -objectgridUrl <URL de xml>
-deploymentPolicyUrl <URL de xml> [options]
Opciones para servidores de contenedor
- -catalogServiceEndPoints<nombreHost:puerto,nombreHost:puerto>
- Especifica el host y el puerto del intermediario de solicitud de objetos (ORB) en el servicio de catálogo.
Valor predeterminado: localhost:2809
- -deploymentPolicyFile <archivo xml de política de despliegue>
- Especifica la vía de acceso del archivo de política de despliegue en el disco duro.
La política de despliegue se utiliza para configurar el particionamiento y la réplica.
La política de despliegue también se puede utilizar para influir en el comportamiento de la colocación.
Ejemplo: ../xml/SimpleDP.xml
- -deploymentPolicyUrl <url de política de despliegue>
- Especifica el URL del archivo de política de despliegue en el disco duro o en la red. La política de despliegue se utiliza para configurar el particionamiento y la réplica.
La política de despliegue también se puede utilizar para influir en el comportamiento de la colocación.
Ejemplo: file://xml/SimpleDP.xml
- -JMXConnectorPort <puerto>
- Define el puerto SSL (Capa de sockets seguros)
al que se enlaza el servicio JMX (Java Management
Extensions).
- -JMXServicePort <puerto>
Especifica el número de puerto en el que
el servidor MBean escucha las comunicaciones con
Java Management Extensions (JMX). La propiedad JMXServicePort especifica el puerto no SSL para JMX. Debe utilizar un número de puerto distinto para cada JVM de la configuración.
Si desea utilizar
JMX/RMI, especifique explícitamente JMXServicePort y el número de puerto,
incluso si desea utilizar el valor de puerto predeterminado. Esta propiedad se aplica tanto al servidor de contenedor, como al servicio catálogos. (Sólo necesario para entornos autónomos.)
Valor predeterminado: 1099
- -jvmArgs <argumento de JVM>
- Especifica un conjunto de argumentos de JVM. Cada opción después de la opción -jvmArgs se utiliza para iniciar la máquina virtual Java (JVM) del servidor. Cuando se utilice el parámetro -jvmArgs, asegúrese de que sea el último argumento del script opcional especificado.
Ejemplo: -jvmArgs -Xms256M
-Xmx1G
- -listenerHost <nombre de host>
Especifique el nombre de host al que se enlaza el
Intermediario para solicitudes de objetos (ORB) para la comunicación con
el protocolo Inter-ORB de Internet (IIOP). El valor debe ser un nombre de dominio
totalmente calificado o una dirección IP. Si la configuración incluye varias
tarjetas de red, establezca el puerto y el host de escucha para permitir que el
Intermediario para solicitudes de objetos de la
JVM conozca la dirección IP a la que enlazarse. Si no especifica qué
dirección IP se debe utilizar, se pueden producir síntomas como
tiempos de espera de conexión excedidos, anomalías de
API inusuales y clientes que parece que se cuelgan.
Valor predeterminado: localhost
- -listenerPort <puerto>
- Especifica el número de puerto al que se enlaza el
intermediario para solicitudes de objetos (ORB). Este valor configura los contenedores y clientes
para que se comuniquen con el servicio de catálogo mediante el ORB.
En WebSphere Application Server, el listenerPort se hereda de la configuración de puerto BOOTSTRAP_ADDRESS.Esta propiedad
se aplica al servidor de contenedor y al servicio de catálogo.Valor predeterminado: 2809
- -objectgridFile <archivo xml de descriptor ObjectGrid>
- Especifica la vía de acceso al archivo descriptor de ObjectGrid.El archivo XML de ObjectGrid
especifica qué servidores eXtreme Scale aloja el contenedor.
- -objectgridUrl <url de descriptor ObjectGrid>
- Especifica un URL para el archivo de descriptor de ObjectGrid. El archivo XML de ObjectGrid
especifica qué servidores eXtreme Scale aloja el contenedor.
- -script <archivo de script>
- Especifica la ubicación de un script personalizado para mandatos que especifique para iniciar servidores de catálogo o contenedores y a continuación parametrizarlos o editarlos, según se requiera.
- -serverProps <archivo de propiedades de servidor>
- Especifica la vía de acceso al archivo de propiedades del servidor.
Ejemplo:../security/server.props
- -timeout <segundos>
- Especifica un número de segundos antes de que el inicio del servidor exceda el tiempo de espera.
- -traceFile <archivo de rastreo>
Especifica un nombre de archivo para grabar la información de rastreo. Esta propiedad se aplica tanto al servidor de contenedor, como al servicio catálogos. Ejemplo: ../logs/c4Trace.log
- -traceSpec <especificación de rastreo>
Permite el rastreo y la serie de especificación del rastreo para el servidor de contenedor.
El rastreo está inhabilitado de forma predeterminada. Esta propiedad se aplica tanto al servidor de contenedor, como al servicio catálogos. Ejemplos:
- ObjectGrid=all=enabled
- ObjectGrid*=all=enabled
- -zone <nombre de zona>
- Especifica la zona que se va a utilizar para todos los contenedores dentro del servidor.
Consulte Direccionamiento a zonas según preferencias para obtener más información sobre cómo configurar las zonas.