Setting Environment Variables for Java

To enable the security platform for Analytic Services, you must set library-path environment variables to specify the location of the Java and JVM shared libraries. On Solaris, you must also set an ESS_JVM_OPTION.

Analytic Services packages the JavaTM Runtime Environment (JRE) with all supported platforms. For the latest JRE version information and installation instructions, see the Installation Guide, and also check the Readme.

Windows Instructions

On Windows NT, Windows 2000, or Windows 2003, set the PATH environment variable to specify the location of the Java shared library jvm.dll found beneath the HYPERION_HOME directory. Replace HYPERION_HOME with its value on your computer; for example, C:\Program Files\Hyperion.

Examples:

Add the following to the PATH specification:

set PATH=%HYPERION_HOME%\common\JRE\Sun\1.4.1\bin\server;%PATH%

If you are using the Korn shell, add the following text to your setup script:

export PATH=$HYPERION_HOME\common\JRE\Sun\1.4.1\bin\server;$PATH

Solaris Instructions

On Solaris, set LD_LIBRARY_PATH to specify the locations of the Java shared libraries libjava.so and libjvm.so.

If you are using JRE 1.4.1, only version 1.4.1.01 is currently supported on Solaris.

Examples:

In the C shell, add the following text to the .cshrc file:

setenv LD_LIBRARY_PATH "$HYPERION_HOME/common/JRE/Sun/1.4.1/lib/sparc/server:$HYPERION_HOME/common/JRE/Sun/1.4.1/lib/sparc:$LD_LIBRARY_PATH"

In the Bourne or Korn shell, add the following text to the .profile file:

export LD_LIBRARY_PATH="$HYPERION_HOME/common/JRE/Sun/1.4.1/lib/sparc/server:$HYPERION_HOME/common/JRE/Sun/1.4.1/lib/sparc:$LD_LIBRARY_PATH"

Note: On Solaris, the symbolic link for the JVM is set to the client version by default. To enable the security platform, you must do one of the following: Either change the symbolic link to the server version as detailed in the Installation Guide, or make sure that in LD_LIBRARY_PATH, $HYPERION_HOME/common/JRE/Sun/1.4.1/lib/sparc/server is listed before $HYPERION_HOME/common/JRE/Sun/1.4.1/lib/sparc, as in the above example.

Additional Solaris Instructions

On Solaris, if you are using JRE version 1.4.1_01, you need to set an ESS_JVM_OPTION environment variable to use a special Java argument, Xusealtsigs. ESS_JVM_OPTION1 through ESS_JVM_OPTION9 are available for setting options for the Java Virtual Machine on Analytic Services. Note: This is a requirement for the Analytic Services application process, and not specifically for the security platform. This requirement applies only to JRE version 1.4.1_01 on Solaris, and is not applicable to other JRE versions on Solaris.

Examples:

In the C shell, add the following text to the .cshrc file:

setenv ESS_JVM_OPTION1 "-Xusealtsigs"

In the Bourne or Korn shell, add the following text to the .profile file:

ESS_JVM_OPTION1=-Xusealtsigs;
export ESS_JVM_OPTION1;

If you are using JRE version 1.3, you need to set an ESS_JVM_OPTION environment variable to use a special Java argument, -XX:+AllowUserSignalHandlers. ESS_JVM_OPTION1 through ESS_JVM_OPTION9 are available for setting options for the Java Virtual Machine on Analytic Services. Note: This is a requirement for the Analytic Services application process, and not specifically for the security platform. This requirement applies only to JRE version 1.3 on Solaris, and is not applicable to other JRE versions on Solaris.

Examples:

In the C shell, add the following text to the .cshrc file:

setenv ESS_JVM_OPTION1 "-XX:+AllowUserSignalHandlers"

In the Bourne or Korn shell, add the following text to the .profile file:

ESS_JVM_OPTION1=-XX:+AllowUserSignalHandlers;
export ESS_JVM_OPTION1;

Linux Instructions

On Linux, set LD_LIBRARY_PATH to specify the locations of the Java shared libraries libjava.so and libjvm.so.

Examples:

In the C shell, add the following text to the .cshrc file:

setenv LD_LIBRARY_PATH "$HYPERION_HOME/common/JRE/Sun/1.4.1/lib/i386:$HYPERION_HOME/common/JRE/Sun/1.4.1/lib/i386/server:$LD_LIBRARY_PATH"

In the Bourne or Korn shell, add the following text to the .profile file:

export LD_LIBRARY_PATH="$HYPERION_HOME/common/JRE/Sun/1.4.1/lib/i386:$HYPERION_HOME/common/JRE/Sun/1.4.1/lib/i386/server:$LD_LIBRARY_PATH"

AIX Instructions

On AIX, set LIBPATH to specify the location of the Java shared library libjava.a.

Examples:

In the C shell, add the following text to the .cshrc file:

setenv LIBPATH "$HYPERION_HOME/common/JRE/IBM/1.4.1/bin:$LIBPATH"

In the Bourne or Korn shell, add the following text to the .profile file:

export LIBPATH="$HYPERION_HOME/common/JRE/IBM/1.4.1/bin:$LIBPATH"

HP-UX Instructions

On HP-UX, set SHLIB_PATH to specify the location of the Java shared libraries libjava.sl and libjvm.sl.

Examples:

In the C shell, add the following text to the .cshrc file:

setenv SHLIB_PATH "$HYPERION_HOME/common/JRE/HP/1.4.1/lib/PA_RISC:$HYPERION_HOME/common/JRE/HP/1.4.1/lib/PA_RISC/server:$SHLIB_PATH"

In the Bourne or Korn shell, add the following text to the .profile file:

export SHLIB_PATH="$HYPERION_HOME/common/JRE/HP/1.4.1/lib/PA_RISC:$HYPERION_HOME/common/JRE/HP/1.4.1/lib/PA_RISC/server:$SHLIB_PATH"

Additional HP-UX Instructions

The following requirements apply to setting up the Java Runtime Environment on HP-UX. JRE is required if you want to use custom-defined functions, the security platform, or both.

If you are using JRE 1.4.1, only version 1.4.1.01 is currently supported on HP-UX.

To use JRE 1.4.1.01, you must set the environment variable LD_PRELOAD using a shell script that you design for starting Analytic Services.

For example, create a script called startessbase.sh in $ARBORPATH/bin with the following contents (for Bourne or Korn shell):

export LD_PRELOAD="$HYPERION_HOME/common/JRE/HP/1.4.1/lib/PA_RISC/server/libjvm.sl"
$ARBORPATH/bin/ESSBASE 

and start Analytic Services using the startup script, as follows:

cd $ARBORPATH/bin
./startessbase.sh

The following example of a startessbase.sh script is for the C shell:

setenv LD_PRELOAD "$HYPERION_HOME/common/JRE/HP/1.4.1/lib/PA_RISC/server/libjvm.sl"
$ARBORPATH/bin/ESSBASE

Warnings:

©2004 Hyperion Solutions Corporation. All Rights Reserved.
http://www.hyperion.com