Web Services Security Guides › CA SiteMinder® Agent for JBoss › Configure JBoss to Work with the SiteMinder Agent

Configure JBoss to Work with the SiteMinder Agent

This section contains the following topics:

Set the JBoss Environment on Windows

Before the SiteMinder Agent can operate with the JBoss Application Server, you must configure SiteMinder Agent-related environment settings on Windows by editing the JBoss run.bat script.

To configure SiteMinder Agent-related environment settings

Navigate to the JBOSS_HOME\bin directory
Open the run.bat file in a text editor.
Add the following entry to specify the installed location of the SiteMinder Agent for JBoss
```
set SOA_HOME=SMAGENT_HOME
```

Add the following entry to define required JVM system properties for the SiteMinder agent:

set JAVA_OPTS=%JAVA_OPTS% -DJAVA_AGENT_ROOT=%SOA_HOME% -Dlog.log-config-properties=%SOA_HOME%\config\log-config.properties -Dfile.encoding=UTF8

Add the following entry to include directories required for SiteMinder Agent operation in the JBOSS_CLASSPATH:
```
set JBOSS_CLASSPATH=%JBOSS_CLASSPATH%;%SOA_HOME%\config;%JBOSS_HOME%\server\default\lib\cryptojFIPS.jar
```
By default, JBoss only listens for requests on the localhost IP address. To configure JBoss to listen on all IP addresses, locate the entry following the remark line "Execute the JVM in the background" and change "org.jboss.Main" to "org.jboss.Main -b 0.0.0.0". For example:
```
"%JAVA%" %JAVA_OPTS% -Djava.endorsed.dirs="%JBOSS_ENDORSED_DIRS%"
-classpath "%JBOSS_CLASSPATH%" org.jboss.Main -b 0.0.0.0 %*
```
Save your changes.
Restart the JBoss Application Server to apply the changes.

Set the JBoss Environment on UNIX

Before the SiteMinder Agent can operate with the JBoss Application Server, you must configure SiteMinder Agent-related environment settings on UNIX by editing the JBoss run.sh script.

To configure SiteMinder Agent-related environment settings

Navigate to the JBOSS_HOME/bin directory
Open the run.sh file in a text editor.
Add the following lines to specify the installed location of the SiteMinder Agent for JBoss:
```
SOA_HOME=SMAGENT_HOME
export SOA_HOME
```

Add the following entry to define required JVM system properties for the SiteMinder agent:

JAVA_OPTS=$JAVA_OPTS -DJAVA_AGENT_ROOT=$SOA_HOME -Dlog.log-config-properties=$SOA_HOME/config/log-config.properties -Dfile.encoding=UTF8
export JAVA_OPTS

Add the following entry to include directories required for SiteMinder Agent operation in the JBOSS_CLASSPATH:

JBOSS_CLASSPATH=$JBOSS_CLASSPATH:$SOA_HOME/config:$JBOSS_HOME/server/default/lib/cryptojFIPS.jar
export JBOSS_CLASSPATH

By default, JBoss only listens for requests on the localhost IP address. To configure JBoss to listen on all IP addresses, locate the entry following the remark line "Execute the JVM in the background" and change "org.jboss.Main" to "org.jboss.Main -b 0.0.0.0". For example:
```
"$JAVA" $JAVA_OPTS -Djava.endorsed.dirs="$JBOSS_ENDORSED_DIRS"
-classpath "$JBOSS_CLASSPATH" org.jboss.Main -b 0.0.0.0 *
```
Save your changes.
Restart the JBoss Application Server to apply the changes.