If the bind address chosen by JGroups software for SAS Remote Services does not match the bind address chosen by JGroups in the Web application server for the SAS middle-tier applications, the communication protocol used by JGroups might not function correctly. As a result, the following errors might appear in the Web application server's log:
ERROR [ContextLoader] Context initialization failed
org.springframework.beans.factory.BeanDefinitionStoreException: Invalid bean
definition with name 'dashboardServices' defined in ServletContext resource
[/WEB-INF/spring-config/services-config.xml]: Could not resolve
placeholder 'metadata.user'
ERROR [main] – ****************************************************************
ERROR [main] – Required entry, '/sas/properties/environment', not found in the cache.
ERROR [main] – Possible causes include: the RemoteServices VM is not started or
ERROR [main] – there is a multicast address/port mismatch; using
ERROR [main] – address=239.168.68.1 and port=8561.
ERROR [main] – ****************************************************************
This issue can be caused by the following factors:
- Your system has multiple network interface cards (including virtual cards).
- You are logged on to a Virtual Private Network (VPN).
To resolve this problem, you must set the following Java Virtual Machine (JVM) option to ensure that the Web application server and SAS Remote Services use the same bind address:
−Djgroups.bind_addr=ip-address
The following sections explain how to set this option on the Red Hat JBoss application server and in the SAS Remote Services application.
Note: In the steps that follow, <ip-address> should be replaced with an actual IP address, as shown in these examples:
- −Djgroups.bind_addr=10.10.10.1
- −Djgroups.bind_addr=localhost
- −Djgroups.bind_addr=127.0.0.1
Setting the JVM Option on the JBoss Application Server
If JBoss is starting from the SASServer1 script file, perform the following steps:
JBOSS-root-directory\bin
−Djgroups.bind_addr=ip-address
- Open the SASServer1.bat(.sh) file in the following directory:
- Edit the JAVA_OPTS variable to include the following option:
If JBoss is starting as a Windows service, perform the following steps:
JBOSS_root_directory\server\SASServer1
wrapper.java.additional.nn=–Djgroups.bind_addr=ip-address
In this property, the value that is specified for nn is the next sequential number.
- Open the wrapper.conf file that is located in the following JBoss directory:
- Add an additional Java property to this file that is similar to the following example:
Setting the JVM Option in SAS Remote Services
If SAS Remote Services is starting as a Windows service, perform the following steps:
SAS_configuration_directory\Lev1\Web\Applications\RemoteServices
- Open the wrapper.conf file that is located in the following configuration directory:
- Add an additional Java property to this file that is similar to the following example:
wrapper.java.additional.nn=−Djgroups.bind_addr=ip-address
In this property, the value that is specified for nn is the next sequential number.
If SAS Remote Services is starting from the RemoteServices script file, perform the following steps:
SAS_configuration_directory\Lev1\Web\Applications\RemoteServices
- Open the RemoteServices.bat(.sh) that is located in the following directory:
- Add the following option to the :start2 section:
−Djgroups.bind_addr=ip-address
Note: On Unix operating systems, this option must be added after the nohup command in start2.
Also see SAS Note 40481 for more information regarding SAS BI Report Services and the jgroups.bind_addr property.
You also need to make the same changes to the SAS Analytic Platform’s wrapper and script files as well, if they are installed.
Operating System and Release Information
SAS System | SAS Enterprise BI Server | z/OS | 9.2 TS2M2 | |
Microsoft® Windows® for 64-Bit Itanium-based Systems | 9.2 TS2M2 | |
Microsoft Windows Server 2003 Datacenter 64-bit Edition | 9.2 TS2M2 | |
Microsoft Windows Server 2003 Enterprise 64-bit Edition | 9.2 TS2M2 | |
Microsoft Windows XP 64-bit Edition | 9.2 TS2M2 | |
Microsoft® Windows® for x64 | 9.2 TS2M2 | |
Microsoft Windows Server 2003 Datacenter Edition | 9.2 TS2M2 | |
Microsoft Windows Server 2003 Enterprise Edition | 9.2 TS2M2 | |
Microsoft Windows Server 2003 Standard Edition | 9.2 TS2M2 | |
Microsoft Windows XP Professional | 9.2 TS2M2 | |
Windows Vista | 9.2 TS2M2 | |
64-bit Enabled AIX | 9.2 TS2M2 | |
64-bit Enabled HP-UX | 9.2 TS2M2 | |
64-bit Enabled Solaris | 9.2 TS2M2 | |
HP-UX IPF | 9.2 TS2M2 | |
Linux | 9.2 TS2M2 | |
Linux for x64 | 9.2 TS2M2 | |
Solaris for x64 | 9.2 TS2M2 | |
*
For software releases that are not yet generally available, the Fixed
Release is the software release in which the problem is planned to be
fixed.