Agent Guide › Install the SiteMinder Agent for WebLogic › Post Installation Steps › Set the WebLogic Environment for the SiteMinder Agent

Set the WebLogic Environment for the SiteMinder Agent

Before the SiteMinder Agent can operate with the WebLogic Server, you must configure SiteMinder Agent-related environment settings in one of the following:

• 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 documentation.

Set the WebLogic Environment for SiteMinder on Windows

To set the environment for the SiteMinder Agent on a standalone WebLogic Server on Windows, do the following:

• Define a Java environment variable smasa.home that refers to the directory where the SiteMinder Agent for WebLogic is installed.
• Add the following SiteMinder Agent files and directories to the CLASSPATH variable:
  • ASA_HOME\conf
  • ASA_HOME\lib\smagentapi.jar
  • ASA_HOME\lib\smjavasdk2.jar
  • ASA_HOME\lib\sm_cryptoj.jar
  • ASA_HOME\lib\smclientclasses.jar
• Add the following SiteMinder Agent option to the WebLogic execution entry:
  • -Dsmasa.home=%SMASA_HOME%

Example: Set the Environment for a Standalone WebLogic Server on Windows

The following procedure is an example of how to set the environment for the SiteMinder Agent on a standalone WebLogic Server on Windows.

1. Edit the startWebLogic.cmd file.

   The startWebLogic.cmd is located in wl_install\user_projects\domains\your_domain\bin

   where wl_install is the installed location of the WebLogic application server, and your_domain is the name of the WebLogic domain where the SiteMinder Agent is installed.

2. Define SMASA_HOME as follows:

   set SMASA_HOME=ASA_HOME
   

   • ASA_HOME

     Specifies the installed location of the SiteMinder Agent.

3. Define SMASA_CLASSPATH as follows:

   set SMASA_CLASSPATH=%SMASA_HOME%\conf;
   %SMASA_HOME%\lib\smagentapi.jar;
   %SMASA_HOME%\lib\smjavasdk2.jar;
   %SMASA_HOME%\lib\sm_cryptoj.jar;
   %SMASA_HOME%\lib\smclientclasses.jar;
   

4. Add %SMASA_CLASSPATH% to the beginning of the CLASSPATH definition.

   The modified CLASSPATH variable should resemble the following:

   set CLASSPATH=%SMASA_CLASSPATH%;%CLASSPATH%
   

5. Define the SM_JAVA_OPTIONS variable as follows:

   set SM_JAVA_OPTIONS= -Dsmasa.home=%SMASA_HOME%
   

6. Add %SM_JAVA_OPTIONS% to the execution entry.

   The modified execution entry should resemble the following:

   if "%WLS_REDIRECT_LOG%"=="" (
           echo Starting WLS with line:
           echo %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%
           %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%
   ) else (
           echo Redirecting output from WLS window to %WLS_REDIRECT_LOG%
           %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%  >"%WLS_REDIRECT_LOG%" 2>&1 
   )
   

7. Save startWebLogic.cmd.
8. Restart the WebLogic Application Server for changes to take effect.

Set the WebLogic Environment for SiteMinder on UNIX

To set the environment for the SiteMinder Agent on a standalone WebLogic Server on UNIX, do the following:

• Define a Java environment variable SMASA.HOME that refers to the directory where the SiteMinder Agent for WebLogic is installed.
• Add the following SiteMinder Agent files and directories to the CLASSPATH variable:
  • ASA_HOME/conf
  • ASA_HOME/lib/smagentapi.jar
  • ASA_HOME/lib/smjavasdk2.jar
  • ASA_HOME/lib/sm_cryptoj.jar
  • ASA_HOME/lib/smclientclasses.jar
• Add the following SiteMinder Agent option to the WebLogic execution entry:
  • -Dsmasa.home=$SMASA_HOME

Example: Set the Environment for a Standalone WebLogic Server on UNIX

The following procedure is an example of how to set the environment for the SiteMinder Agent on a standalone WebLogic Server on UNIX.

1. Edit the startWebLogic.sh file.

   The startWebLogic.sh is located in wl_install/user_projects/domains/your_domain/bin

   where wl_install is the installed location of the WebLogic application server, and your_domain is the name of the WebLogic domain where the SiteMinder Agent is installed.

2. Define SMASA_HOME as follows:

   SMASA_HOME=ASA_HOME
   

   • ASA_HOME

     Specifies the installed location of the SiteMinder Agent.

3. Define SMASA_CLASSPATH as follows:

   SMASA_CLASSPATH=$SMASA_HOME/conf:
   $SMASA_HOME/lib/smagentapi.jar;
   $SMASA_HOME/lib/smjavasdk2.jar;
   $SMASA_HOME/lib/sm_cryptoj.jar:
   $SMASA_HOME/lib/smclientclasses.jar:
   

4. Add ${SMASA_CLASSPATH} to the beginning of the CLASSPATH definition.

   The modified CLASSPATH variable should resemble the following:

   CLASSPATH=${SMASA_CLASSPATH}:${CLASSPATH}
   

5. Define the SM_JAVA_OPTIONS variable as follows:

   SM_JAVA_OPTIONS= -Dsmasa.home=$SMASA_HOME
   

6. 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}
   

7. Save startWebLogic.sh.
8. Restart the WebLogic Server.