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:

Configure Agent-related Environment Settings on JBoss 5.x

Configure Agent-related Environment Settings on JBoss 6.x

Configure Agent-related Environment Settings on JBoss 5.x

To configure the agent to operate with the JBoss 5.x Application Server, complete one of the following procedures:

Set the JBoss 5.x 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 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 5.x 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 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.

Configure Agent-related Environment Settings on JBoss 6.x

To configure the agent to operate with a JBoss 6.x Application Server, complete one of the following procedures:

Set the JBoss 6.x Environment on Windows

Configure agent-related environment settings on Windows by editing the standalone.conf.bat script.

Follow these steps:

Navigate to the JBOSS_HOME\bin directory
Open the standalone.conf.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 agent:

set "JAVA_OPTS=%JAVA_OPTS% -DJAVA_AGENT_ROOT=%SOA_HOME%  -DSM_AGENT_LOGGING_EXTERNAL_CONFIG=true  -DTXM_DOCUMENT_BUILDER=org.apache.xerces.jaxp.DocumentBuilderFactoryImpl"

Save your changes.
Restart the JBoss Application Server to apply the changes.

Set the JBoss 6.x Environment on UNIX

Configure agent-related environment settings on UNIX by editing the JBoss standalone.conf script.

Follow these steps:

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

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

JAVA_OPTS="$JAVA_OPTS -DJAVA_AGENT_ROOT=$SOA_HOME -DSM_AGENT_LOGGING_EXTERNAL_CONFIG=true  -DTXM_DOCUMENT_BUILDER=org.apache.xerces.jaxp.DocumentBuilderFactoryImpl"

Save your changes.
Restart the JBoss Application Server to apply the changes.