This document describes the necessary steps to configure SAS 9.2 products to run with an installation of a Java Runtime Environment (JRE) or Java Development Kit (JDK) that is different from the JRE or JDK that was used during the initial installation and configuration process.
SAS 9.2 uses TrueType fonts to provide quality printing and font display across multiple platforms. During the installation and configuration of SAS 9.2, some of these TrueType fonts are installed to the required Java Runtime Environment. When SAS 9.2 is configured to use an alternate JRE, these TrueType fonts must be installed to the new JRE.
Perform the following steps to move the SAS installed TrueType fonts:
The default location of the JRE with UNIX installations is under the $SASHOME directory. The $SASHOME directory is the root directory where the SAS 9.2 installation was performed.
SAS Foundation uses Java Native Libraries. These native libraries are contained within the JRE.
You must modify your library path on UNIX hosts to contain the location of the native libraries of the alternate JRE. The library path used by SAS Foundation is set in the "sasenv" file which is located in the SAS 9.2 installation directory. The environment variable JAVA_HOME is set in the sasenv file.
Modify JAVA_HOME to update your library path to contain the native libraries of the alternate JRE.
The JRE configuration for SAS Foundation is managed through the JREOPTIONS SAS option. This SAS option includes all the Java options that are used when SAS invokes a Java Virtual Machine (JVM). The -Dsas.jre.libjvm property identifies the shared library for the JVM to use. The following example shows the default JREOPTIONS for a Windows machine. The example is shown on several lines for readability, the JREOPTIONS must be kept on a single line in the SAS configuration file.
To change SAS Foundation to use Java 5 update 15, change the first option as follows:
On Windows, the configuration file is located in !SASROOT\nls\LANG\SASV9.CFG.
Many SAS applications and rich clients are invoked through the SAS Application Launcher. These applications are configured through the product.ini file located in the product directory. For SAS 9.2, a top-level configuration file named sassw.config is introduced. An example location for the file is C:\Program Files\SAS\sassw.config. By default, the JRE location is specified as the JREHOME property within this file. A large percentage of SAS Java applications can be reconfigured to use an alternate JRE just by editing this file. Refer to the following Windows example:
To change the value for Java 5 update 15, change the first option as follows:
For SAS 9.2 client applications that are based on the Eclipse Rich Client Platform, you can reconfigure the application to use an alternate JRE by editing an INI file. The INI file is located in the same directory as the application. For example, to update SAS Data Integration Studio (distudio.exe), edit the distudio.ini file in the same directory. Change the -vm argument to the path for the alternate JRE. Refer to the following example:
Note: The -vm string and the path must be on separate lines and they must precede any -vmargs entries. For information about the INI file structure, see the Eclipse.ini Web page. For information about Eclipse runtime options, see the Eclipse runtime options Web page.
SAS 9.2 servers such as SAS Remote Services require a JRE or JDK. These servers can be reconfigured to use an alternate JRE or JDK.
File $SAS_CONFIG/Lev1/level_env.sh contains two variables that can be edited to use an alternate JRE or JDK:
On Windows platforms, the file $SAS_CONFIG\Lev1\level_env.bat contains two variables that can be edited to use an alternate JRE or JDK:
SAS 9.2 Business Intelligence (BI) and Enterprise BI require the installation of a Java application server and a Java Development Kit (JDK). SAS does not ship Java Development Kits. Customers must download and install the required JDK before installing SAS. After installing the JDK, SAS and the application server are configured to use the supplied JDK. It might become necessary to change the version of the Java Development Kit required by SAS 9.2. Instructions are provided based on the Java application server.
JBoss configurations on UNIX platforms save the location of the required JDK in two places. The first place is the $JBOSS_HOME/bin/SASServer1.sh script and the second place is the $SAS_CONFIG/level_env.sh script. $JBOSS_HOME is the root level directory of the JBoss installation and $SAS_CONFIG is the root level directory of the SAS configuration. The following variables in their corresponding files should be modified to contain the location of the desired JDK:
SAS uses Tanuki Wrapper to install the JBoss application server as a service on Windows platforms. Tanuki Wrapper uses a configuration file named wrapper.conf to identify the location of the Java executable and the location of the tools.jar file for the JDK. If JBoss is configured to run as a service, then edit $JBOSS_HOME\server\SASServer1\wrapper.conf. Refer to the following example:
If your site does not have JBoss configured to run as a service, then edit the JBoss configuration. JBoss configurations on Windows platforms save the location of the alternate JDK in two places just as JBoss on UNIX. The first file is $JBOSS_HOME\bin\SASServer1.bat and the second file is $SAS_CONFIG\level_env.bat. $SAS_CONFIG is the location of the SAS configuration. The following variables in their corresponding files should be modified to contain the location of the desired JDK:
WebLogic configurations on UNIX platforms save the location of the required JDK in two files. The first file is $SAS_CONFIG/Lev1/Web/SASDomain/bin/setDomainEnv.sh. The second file is $SAS_CONFIG/Lev1/Web/SASDomain/bin/commEnvSAS.sh. The JAVA_HOME variable should be modified to contain the location of the desired JDK:
WebLogic configurations on Windows platforms save the location of the required JDK in two files. The first file is $SAS_CONFIG\Lev1\Web\SASDomain\bin\setDomainEnv.cmd. The second file is $SAS_CONFIG\Lev1\Web\SASDomain\bin\commEnvSAS.cmd. The JAVA_HOME variable should be modified to contain the location of the desired JDK:
The WebLogic Node Manager can be installed to run as a service on Windows platforms. The service is configured to use the JDK that WebLogic is configured with at the time of installation. If you have configured WebLogic to run with an alternate JDK and are running WebLogic Node Manager as a service, then you must complete the following steps to reinstall the service with configuration changes:
WebSphere configurations are installed with the required JDK.
SAS Deployment Tester:
Java 2 Security, Restrictive Policy Files (if applicable):