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.
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
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.
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;
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"
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"
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"
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:
LD_PRELOAD
in UNIX environment scripts such as .profile
is
not recommended, as it may have side effects.©2004 Hyperion Solutions Corporation. All Rights Reserved. http://www.hyperion.com |