6/4/2017 Modificación de los valores de configuración de la máquina virtual Java

Modificación de los valores de

configuración de la máquina virtual Java
Versión 10.2.1 

En esta sección se describe cómo modificar los valores de configuración de JVM (máquina virtual
Java™) editando los scripts de inicio. Se da por supuesto que utiliza una JVM Java SE HotSpot Versión
1.5.
Existen valores específicos que corresponden a la asignación de RAM. Para evitar intentos de
reasignación de memoria, -Xms y -Xmx deben establecerse en el mismo valor: la cantidad de memoria
mínima y máxima que ha de asignarse al servidor de Real-time Monitoring. Para un servidor con 16 GB
de RAM, el valor preferido es un mínimo de 12 GB. Por lo general, es preferible asignar un número que
represente aproximadamente 3/4 de la RAM total.

Establezca -XX:NewSize y -XX:MaxNewSize en el mismo valor. El número debe ser 1/4 del tamaño
seleccionado para -Xms.

En la siguiente tabla se proporcionan ejemplos de los valores de parámetros que se utilizarían para un
tamaño de memoria de 16 GB y de 32 GB.

Tabla 1. Ejemplos de valores de parámetros de

JVM

Memoria Valor de parámetro

16 GB -Xms12288M

-Xmx12288M

-XX:NewSize=3072M

-XX:MaxNewSize=3072M

https://www.ibm.com/support/knowledgecenter/es/SSEP7J_10.2.1/com.ibm.swg.ba.cognos.ig_rtm.10.2.1.doc/t_jvm_cnfg.html 1/9
6/4/2017 Modificación de los valores de configuración de la máquina virtual Java

Memoria Valor de parámetro

32 GB -Xms24576M

-Xmx24576M

-XX:NewSize=6144M

-XX:MaxNewSize=6144M

También debe especificar los valores de la recogida de basura. La entrada -

XX:ParallelGCThreads debe ser igual al número de núcleos de procesador disponibles. Por
ejemplo, si existen dos procesadores de doble núcleo, especifique:

-XX:ParallelGCThreads=4

Si existen 4 procesadores de doble núcleo, o 2 procesadores de núcleo cuádruple, especifique:

-XX:ParallelGCThreads=8

Los valores -verbose:gc y -Dsun.rmi.dgc.client.gcInterval son útiles en la determinación

de problemas de recogida de basura durante la ejecución. También deben establecerse. El último valor
debe apuntar al directorio de registro; por ejemplo:

-Xloggc:"c:/program files/ibm/cognos/c10_64/realtime/logs"

Si existe un espacio en la ruta, la totalidad del parámetro deberá especificarse entre comillas. En el
nombre de la ruta, utilice barras inclinadas hacia la derecha (/) en lugar de barras inclinadas invertidas
(\).

Procedimiento
1. Si el servidor de aplicaciones JBoss ya está en ejecución, ciérrelo.

2. Localice y abra el script de ejecución que inicia el servidor de aplicaciones JBoss. Este archivo se
encuentra en:
...\%JBOSS_HOME%\bin\run.bat (en un servidor que ejecuta el sistema operativo Microsoft
Windows)

.../$JBOSS_HOME/bin/run.sh (en un servidor que ejecuta el sistema operativo UNIX)

3. Para incluir el archivo obiProperties.jar, que se encuentra en el directorio

ubicación_c10/realtime/bin64/, edite el archivo run.bat o run.sh para establecer lo siguiente en los

https://www.ibm.com/support/knowledgecenter/es/SSEP7J_10.2.1/com.ibm.swg.ba.cognos.ig_rtm.10.2.1.doc/t_jvm_cnfg.html 2/9
6/4/2017 Modificación de los valores de configuración de la máquina virtual Java

valores de la ruta de clase.

En un servidor que ejecuta el sistema operativo Microsoft Windows:

set
JBOSS_CLASSPATH=%JBOSS_CLASSPATH%;C:/Archivos~1/ibm/cognos/c10_64/realtime/bin64/ob

En un servidor que ejecuta el sistema operativo AIX, Solaris o Linux:

JBOSS_CLASSPATH=$JBOSS_CLASSPATH:/opt/ibm/cognos/c10_64/realtime/bin64/obiProperties.ja

4. Establezca las variables de entorno. (Para un servidor que ejecuta el sistema operativo AIX, Linux o
Solaris, utilice el JDK. El JRE es insuficiente.)

En un servidor que ejecuta el sistema operativo Microsoft Windows:

Cree una variable de entorno denominada JAVA_HOME que apunte al directorio de instalación del
JDK. Por ejemplo:

C:\Archivos de programa\Java\jdk1.5.0_14\

Para ejecutar Java desde la línea de comandos, añada el directorio jre\bin a la ruta. Por ejemplo:

C:\Archivos de programa\Java\jdk1.5.0_14\jre\bin

Para crear la variable de entorno, abra el Panel de control desde el menú Inicio (si es necesario,
cambie a la Vista clásica) y, a continuación, abra el applet del sistema. Seleccione la pestaña
Avanzado y pulse el botón Variables de entorno. Pulse el botón Nuevo de las variables del sistema
para crear la variable JAVA_HOME.

En un servidor que ejecuta el sistema operativo AIX, Solaris o Linux:

Cree una variable de entorno denominada JAVA_HOME que apunte al directorio de instalación del
JDK. Añada $JAVA_HOME/bin a la ruta del sistema para poder ejecutar Java desde la línea de
comandos. Por ejemplo, en Linux con el shell bash, puede hacerlo añadiendo las líneas siguientes
al archivo .bashrc del directorio inicial:

export JAVA_HOME=<jdk_directory>

export PATH=$PATH:$JAVA_HOME/bin

donde <directorio_jdk> es el directorio de instalación del JDK (por ejemplo, /usr/java/jdk1.6.0_07).

Deberá seleccionar el JDK adecuado en función de la versión del servidor de aplicaciones JBoss
utilizada.

Para obtener más información acerca de los requisitos previos para el servidor de aplicaciones
JBoss, consulte lo siguiente:

https://www.ibm.com/support/knowledgecenter/es/SSEP7J_10.2.1/com.ibm.swg.ba.cognos.ig_rtm.10.2.1.doc/t_jvm_cnfg.html 3/9
6/4/2017 Modificación de los valores de configuración de la máquina virtual Java

http://www.jboss.org/file-
access/default/members/jbossas/freezone/docs/Installation_Guide/4/pdf/Installation_Guide.pdf

http://www.jboss.org/file-
access/default/members/jbossas/freezone/docs/Installation_Guide/beta500/html-
single/index.html#Pre_Requisites-Configuring_Your_Java_Environment

5. Asegúrese de que el parámetro JAVA_OPTS de la propiedad

com.cognos.obi.bootstrap.envpropname se ha establecido en BOOTPROPS y de que la propiedad
BOOTPROPS de la JVM apunta al archivo realtime.properties que ha editado durante la preparación
para la instalación que se describe en Establecimiento de las propiedades del sistema durante el
inicio

En un servidor que ejecuta el sistema operativo Microsoft Windows:

set JAVA_OPTS=%JAVA_OPTS% "-DBOOTPROPS=<bootstrap_file>"

set JAVA_OPTS=%JAVA_OPTS% "-

Dcom.cognos.obi.bootstrap.envpropname=BOOTPROPS"

donde <archivo_inicialización> especifica la ubicación del archivo realtime.properties que

contiene las propiedades de inicialización.

En un servidor que ejecuta el sistema operativo AIX, Solaris o Linux:

JAVA_OPTS="$JAVA_OPTS -DBOOTPROPS=<bootstrap_file>"

JAVA_OPTS="$JAVA_OPTS -
Dcom.cognos.obi.bootstrap.envpropname=BOOTPROPS"

donde <archivo_inicialización> especifica la ubicación del archivo realtime.properties que

contiene las propiedades de inicialización.

6. Establezca el tipo de codificación de archivos en UTF8 tal como se muestra en los ejemplos
siguientes:
A continuación se muestran ejemplos para cada sistema operativo:

En un servidor que ejecuta el sistema operativo Microsoft Windows:

set JAVA_OPTS=%JAVA_OPTS% "-Dfile.encoding=utf8"

En un servidor que ejecuta el sistema operativo AIX, Solaris o Linux:

JAVA_OPTS="$JAVA_OPTS -Dfile.encoding=utf8"

7. Opcionalmente, establezca la propiedad anonymousaccessenabled, tal como se muestra a

continuación, en true para habilitar el inicio de sesión anónimo. Establezca esta propiedad en false

https://www.ibm.com/support/knowledgecenter/es/SSEP7J_10.2.1/com.ibm.swg.ba.cognos.ig_rtm.10.2.1.doc/t_jvm_cnfg.html 4/9
6/4/2017 Modificación de los valores de configuración de la máquina virtual Java

para inhabilitar el inicio de sesión anónimo. Cuando se ha habilitado esta propiedad, en la pantalla
de inicio de sesión se muestra el enlace Iniciar sesión como usuario anónimo.

En un servidor que ejecuta el sistema operativo Microsoft Windows:

set JAVA_OPTS=%JAVA_OPTS% "-Danonymousaccessenabled=true"

En un servidor que ejecuta el sistema operativo AIX, Solaris o Linux:

JAVA_OPTS="$JAVA_OPTS -Danonymousaccessenabled=true"

Con el inicio de sesión anónimo habilitado, puede iniciar la sesión automáticamente en IBM Cognos
Real-time Monitoring Dashboard o en IBM Cognos Real-time Monitoring Workbench sin especificar
un nombre de usuario y contraseña mediante la utilización de la URL:

http://nombre_servidor/cognos/realtime/landing/landingpage.htm

Esto le permite seleccionar la aplicación.

8. Opcionalmente, si se necesitan conexiones http salientes, como conexiones con servicios web o
con servicios de codificación geográfica, para poder atravesar un servidor proxy desde el entorno
de servidor, añada la propiedad JVM al script de inicio con el fin de que la capa de conectividad de
Java utilice el servidor proxy para todas las llamadas salientes.
A continuación se muestran ejemplos para cada sistema operativo.

En un servidor que ejecuta el sistema operativo Microsoft Windows:

set JAVA_OPTS=%JAVA_OPTS% "-Dhttp.proxyHost=<fully qualified server
name of http proxy>"

set JAVA_OPTS=%JAVA_OPTS% "-Dhttp.proxyPort=<http proxy port number>"

set JAVA_OPTS=%JAVA_OPTS% "-Dhttps.proxyHost=<fully qualified server

name of https proxy>"

set JAVA_OPTS=%JAVA_OPTS% "-Dhttps.proxyPort=<https proxy server

port>"

En un servidor que ejecuta el sistema operativo AIX, Solaris o Linux:

JAVA_OPTS="$JAVA_OPTS -Dhttp.proxyHost=<fully qualified server name of
http proxy>"

JAVA_OPTS="$JAVA_OPTS -Dhttp.proxyPort=<http proxy port number>"

JAVA_OPTS="$JAVA_OPTS -Dhttps.proxyHost=<fully qualified server name

of https proxy>"

JAVA_OPTS="$JAVA_OPTS -Dhttps.proxyPort=<https proxy server port>"

https://www.ibm.com/support/knowledgecenter/es/SSEP7J_10.2.1/com.ibm.swg.ba.cognos.ig_rtm.10.2.1.doc/t_jvm_cnfg.html 5/9
6/4/2017 Modificación de los valores de configuración de la máquina virtual Java

Nota

No están soportados los servidores proxy que necesitan autenticación.

9. Opcionalmente, añada un valor JAVA_OPTS, tal como se muestra a continuación, para inhabilitar el
registro doble de la salida del sistema.

Nota

Es una solución al error 877974 de JBoss.

En un servidor que ejecuta el sistema operativo Microsoft Windows:

set JAVA_OPTS=%JAVA_OPTS%

"-Dorg.jboss.logging.Log4jService.catchSystemOut=false"

"-Dorg.jboss.logging.Log4jService.catchSystemErr=false"

Nota

La información anteriormente indicada debe especificarse en una única línea.

En un servidor que ejecuta el sistema operativo AIX, Solaris o Linux:

JAVA_OPTS="$JAVA_OPTS

-Dorg.jboss.logging.Log4jService.catchSystemOut=false

-Dorg.jboss.logging.Log4jService.catchSystemErr=false"

Nota

La información anteriormente indicada debe especificarse en una única línea.

https://www.ibm.com/support/knowledgecenter/es/SSEP7J_10.2.1/com.ibm.swg.ba.cognos.ig_rtm.10.2.1.doc/t_jvm_cnfg.html 6/9
6/4/2017 Modificación de los valores de configuración de la máquina virtual Java

10. Active la JVM de 64 bits añadiendo la línea siguiente al valor JAVA_OPTS, tal como se muestra a
continuación:

En un servidor que ejecuta el sistema operativo Microsoft Windows:

set JAVA_OPTS=%JAVA_OPTS% "-D64"

En un servidor que ejecuta el sistema operativo AIX, Solaris o Linux:

JAVA_OPTS="$JAVA_OPTS -D64"

11. Establezca los parámetros de JVM de modo que se haga un uso óptimo de la memoria y la
recogida de basura (GC). A continuación se indican los parámetros de JVM de ejemplo
recomendados para ejecutar Real-time Monitoring (para la JVM Java SE HotSpot Versión 1.5):

-server

-Xms24576M

-Xmx24576M

-XX:NewSize=6144M

-XX:MaxNewSize=6144M

-XX:PermSize=256M

-XX:MaxPermSize=256M

-XX:ThreadStackSize=300

-XX:MaxTenuringThreshold=0

-XX:SurvivorRatio=128

-XX:+UseTLAB

https://www.ibm.com/support/knowledgecenter/es/SSEP7J_10.2.1/com.ibm.swg.ba.cognos.ig_rtm.10.2.1.doc/t_jvm_cnfg.html 7/9
6/4/2017 Modificación de los valores de configuración de la máquina virtual Java

-verbose:gc

-Dsun.rmi.dgc.client.gcInterval=600000

-Xloggc:<location of the GC logs>

-XX:-UsePerfData

-XX:+PrintVMOptions

-XX:+TraceClassUnloading

-XX:+DisableExplicitGC

-XX:+CMSParallelRemarkEnabled

-XX:+PrintGCDetails

-XX:+PrintGCTimeStamps

-XX:+UseParNewGC

-XX:+UseConcMarkSweepGC

-XX:ParallelGCThreads=<number of cpus>

-XX:CMSMarkStackSize=8M

-XX:CMSMarkStackSizeMax=32M

-XX:+UseCMSCompactAtFullCollection

https://www.ibm.com/support/knowledgecenter/es/SSEP7J_10.2.1/com.ibm.swg.ba.cognos.ig_rtm.10.2.1.doc/t_jvm_cnfg.html 8/9
6/4/2017 Modificación de los valores de configuración de la máquina virtual Java

-XX:CMSFullGCsBeforeCompaction=0

-XX:+ParallelRefProcEnabled

-XX:+CMSClassUnloadingEnabled

-XX:+CMSPermGenSweepingEnabled

-XX:+CMSIncrementalMode

-XX:+CMSIncrementalPacing

-XX:CMSIncrementalDutyCycleMin=0

-XX:CMSIncrementalDutyCycle=10

-XX:+UseCMSInitiatingOccupancyOnly

12. Opcionalmente, establezca los parámetros de idioma y de entorno local tal como se describe en
Establecimiento de los parámetros de idioma y de entorno local.
Sólo será necesario que realice este paso si desea inicializar los metadatos en un entorno local
distinto del entorno local predeterminada del servidor.

13. Guarde y cierre el archivo del script de inicio.

 Establecimiento de los parámetros de idioma y de entorno local

Puede establecer parámetros opcionales para la base de datos de metadatos, incluidos el idioma,
el país o región y el nivel de clasificación.

Tema principal:
 Instalación y despliegue de Real-time Monitoring en un servidor de aplicaciones JBoss

https://www.ibm.com/support/knowledgecenter/es/SSEP7J_10.2.1/com.ibm.swg.ba.cognos.ig_rtm.10.2.1.doc/t_jvm_cnfg.html 9/9