Web Services Security Guides › CA SiteMinder® Web Services Security Agent for Oracle WebLogic Guide › Set the WebLogic Environment for the SiteMinder WSS Agent

Set the WebLogic Environment for the SiteMinder WSS Agent

This section contains the following topics:

WebLogic Environment Setting Locations

Set the WebLogic Environment on Windows

Set the WebLogic Environment on UNIX

WebLogic Environment Setting Locations

You configure SiteMinder WSS Agent-related environment settings in one of the following locations depending on your environment:

• The WebLogic start script for both managed and standalone servers (startWebLogic.cmd on Windows; startWebLogic.sh on UNIX)

  Note: The startWebLogic.cmd (Windows) or startWebLogic.sh (Unix) script that contains the environment configuration is placed in the bin folder of a created domain.

• If using the Node Manager to control Managed Servers, in the Server Start configuration page in the WebLogic Adminstration Console.

  For details regarding the Server Start configuration page, see the WebLogic Online Documentation.

Set the WebLogic Environment on Windows

Before the SiteMinder WSS Agent can operate with the WebLogic Application Server on Windows, you must configure SiteMinder WSS Agent-related environment settings in the location appropriate for your environment.

Follow these steps:

1. Define a SOA_HOME variable as follows:

   set SOA_HOME=WSS_Home\wlsagent
   

2. Define a SMSOA_CLASSPATH variable as follows:

   set SMSOA_CLASSPATH=%SOA_HOME%\config; 
   %SOA_HOME%\lib\smagentapi.jar; 
   %SOA_HOME%\lib\thirdparty\cryptojFIPS.jar;
   %SOA_HOME%\lib\soaagent-proxy.jar;
   %SOA_HOME%\lib\thirdparty\xalan.jar
   

3. Add %SMSOA_CLASSPATH% to the beginning of the CLASSPATH variable definition. The modified CLASSPATH variable should resemble the following:

   set CLASSPATH=%SMSOA_CLASSPATH%;%CLASSPATH% 
   

4. Define the SM_JAVA_OPTIONS variable as follows:

   set SM_JAVA_OPTIONS=-DJAVA_AGENT_ROOT=%SOA_HOME% 
   -Dlog.log-config-properties=%SOA_HOME%\config\log-config.properties 
   -Djava.security.auth.login.config==%SOA_HOME%\config\soa_jaas.config
   -Djavax.xml.soap.SOAPFactory=weblogic.xml.saaj.SOAPFactoryImpl
   -Djavax.xml.soap.MessageFactory=weblogic.xml.saaj.MessageFactoryImpl
   

5. Add %SM_JAVA_OPTIONS% to the execution entry. The modified execution entry should resemble the following:

   %JAVA_HOME%\bin\java %JAVA_VM% %MEM_ARGS% %JAVA_OPTIONS%
   %SM_JAVA_OPTIONS% -Dweblogic.Name=%SERVER_NAME% 
   -Djava.security.policy=%WL_HOME%\server\lib\weblogic.policy %PROXY_SETTINGS% %SERVER_CLASS% 
   

6. Save your changes.
7. Restart the WebLogic Application Server for changes to take effect.

More information:

WebLogic Environment Setting Locations

Set the WebLogic Environment on UNIX

Before the SiteMinder WSS Agent can operate with the WebLogic Application Server on UNIX, you must configure SiteMinder WSS Agent-related environment settings in the location appropriate for your environment.

Follow these steps:

1. Define a SOA_HOME variable as follows:

   SOA_HOME=WSS_Home/wlsagent
   

2. Define the SMSOA_CLASSPATH as follows:

   SMSOA_CLASSPATH=${SOA_HOME}/config:
   ${SOA_HOME}/lib/smagentapi.jar:
   ${SOA_HOME}/lib/thirdparty/cryptojFIPS.jar: 
   ${SOA_HOME}/lib/soaagent-proxy.jar:
   ${SOA_HOME}/lib/thirdparty/xalan.jar
   

   export SMSOA_CLASSPATH
   

3. Add ${SMSOA_CLASSPATH} to the beginning of the CLASSPATH definition. The modified CLASSPATH variable should resemble the following:

   CLASSPATH=${SMSOA_CLASSPATH}${CLASSPATHSEP}${CLASSPATH}
   export CLASSPATH
   

4. Define the SM_JAVA_OPTIONS variable as follows:

   SM_JAVA_OPTIONS="-DJAVA_AGENT_ROOT=${SOA_HOME}
   -Dlog.log-config-properties=${SOA_HOME}/config/log-config.properties 
   -Djava.security.auth.login.config==${SOA_HOME}/config/soa_jaas.config
   -Djavax.xml.soap.SOAPFactory=weblogic.xml.saaj.SOAPFactoryImpl
   -Djavax.xml.soap.MessageFactory=weblogic.xml.saaj.MessageFactoryImpl"
   

5. Add ${SM_JAVA_OPTIONS} to the execution entry. The modified execution entry should resemble the following:

   "${JAVA_HOME}/bin/java ${JAVA_VM} ${MEM_ARGS} ${JAVA_OPTIONS} ${SM_JAVA_OPTIONS} -Dweblogic.Name=${SERVER_NAME} -Djava.security.policy=${WL_HOME}/server/lib/weblogic.policy ${PROXY_SETTINGS} ${SERVER_CLASS}"
   

6. Save your changes.
7. Restart the WebLogic Application Server for changes to take effect.

More information:

WebLogic Environment Setting Locations