Pre-Installation Steps for JBoss, WebLogic and WebSphere Application Servers with SAS^® 9.3

Increasing Open File Descriptors

SAS recommends the soft limit on number of open file descriptors be at least 20480 on Unix operating systems. When running SAS web applications, this increase is required to enable the opening of class files within the web applications. Contact your on-site system administrator for details about increasing this ulimit.

Note for WebLogic Server users: When the value for open file descriptors is unlimited, the common WebLogic server configuration script commEnv.sh throttles back that number to 4096. When SAS Deployment Wizard automatically configures your WebLogic server domain, the SAS wrapper script, commEnvSAS.sh sets this value to 20480 before calling commEnv.sh. If you manually configure your WebLogic SAS domain, you can either use the SAS wrapper that is generated for the sample domain as an example, or you can modify the value in WL_HOME/common/bin/commEnv.sh.

Increasing Maximum Number of Processes - RHEL 6 only

SAS requires the soft limit on maximum number of processes be at least 10240 on Red Hat Enterprise Linux (RHEL) 6 platform. Contact your on-site system administrator for details about increasing this ulimit.

SAS 9.3 software uses multicast networking in the SAS Remote Services application. IBM has identified that AIX 6.1 systems might require updates to support multicast networking correctly. Review the IBM support note for APAR IZ35571. If necessary, apply the appropriate fixpack from the IBM support website for the issue.

The problem that is described in the IBM support note generates an entry similar to the following in the web application server log:

********************************************************************************
16:25:16,648 ERROR [SimpleCache] Required entry, '/sas/properties/environment', not found in the cache.
16:25:16,648 ERROR [SimpleCache] Possible causes include: the RemoteServices VM is not started or
16:25:16,648 ERROR [SimpleCache] there is a multicast address/port mismatch; using
16:25:16,648 ERROR [SimpleCache] address=239.nn.nn.nn and port=nnnn.
********************************************************************************

Note: The previous error message indicates a communication failure between the SAS Remote Services application and SAS Web Infrastructure Platform applications. Therefore, the multicast networking issue that is associated with IBM AIX 6.1 is not the only cause of the message.

When you install and configure SAS software on Oracle WebLogic 10.3.x, be sure that the directory that is referenced by WL_HOME resides directly under the directory that is referenced by MW_HOME. If this is not the case, errors can occur during installation and configuration of SAS on WebLogic 10.3.x. For details, see SAS Note 42361.

On platforms that use a single Java Development Kit binary to provide 32-bit and 64-bit modes, make sure that you install WebLogic server in 64-bit mode with the -d64 parameter, as shown in the following example:

If 32-bit WebLogic Server is accidentally installed on a 64-bit platform, then the SAS Deployment Wizard fails to configure the server. When that happens, the error message NodeManager failed to start is generated.

On 64-bit Windows, if the WebLogic download comes with the .exe and .jar installation files, the .jar file must be used to install WebLogic.

SAS Web Infrastructure Platform Services use a JDBC data source. The default configuration is for SAS Web Infrastructure Platform Services to use a SAS Framework Data Server. If you prefer to use a different database, then see Configuring an Alternative Database for SAS Web Infrastructure Platform Services.