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

Steps to be performed before running the SAS® Deployment Wizard on your midtier, and before you install the JBoss, WebLogic and WebSphere application servers with SAS® 9.3 Enterprise BI Server software.

Increasing Per-User Limits (ulimit) on Unix operating systems

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 throttles back that number to 4096. When SAS Deployment Wizard automatically configures your WebLogic server domain, the SAS wrapper script, sets this value to 20480 before calling 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/

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.

IBM AIX 6.1 Update for Multicast Networking

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.

WL_HOME Must Reside Directly under MW_HOME

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.

Installing the Oracle WebLogic Server on 64-bit Platforms

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:

java -d64 -jar server103_generic.jar


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.

Configuring an Alternative Database for SAS Web Infrastructure Platform Services

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.

Recommended Resources

Explore our training options, including on-site classroom, live web, e-learning and one-on-one mentoring.

Validate your SAS knowledge and skills by earning a globally recognized credential from SAS.

Explore documentation on topics of interest to SAS administrators.

Back to Top