Previous Topic: Web Agent Option Pack FeaturesNext Topic: Install the Web Agent Option Pack


Installation Requirements and Considerations

This section contains the following topics:

General Option Pack Installation Requirements

Components Required for SiteMinder Federation

Components Required for eTelligent Rules

Version Compatibility

Environment Variables Added by the Installation

Java Virtual Machine Installation Error on Solaris can be Ignored (149886)

Web Agent Option Pack on JBOSS Requires Workaround (147357, 149394)

General Option Pack Installation Requirements

Before you install the Web Agent Option Pack, the following components are required:

You can install the Web Agent Option Pack without the Web Agent. However, install the Web Agent before using federation.

Required Linux Libraries

Certain library files are required for components operating on Linux operating environments. Failure to install the correct libraries can cause the following error:

java.lang.UnsatisfiedLinkError 

If you are installing, configuring, or upgrading a Linux version of this component, the following libraries are required on the host system:

Red Hat 5.x

compat–gcc-34-c++-3.4.6-patch_version.I386

Red Hat 6.x (32-bit)

libstdc++-4.4.6-3.el6.i686.rpm

To have the appropriate 32-bit C run–time library for your operating environment, install the previous rpm.

Red Hat 6.x (64-bit)

libXau-1.0.5-1.el6.i686.rpm

libxcb-1.5-1.el6.i686.rpm

libstdc++-4.4.6-4.el6.i686.rpm

compat-db42-4.2.52-15.el6.i686.rpm

compat-db43-4.3.29-15.el6.i686.rpm

libX11-1.3-2.el6.i686.rpm

libXrender-0.9.5-1.el6.i686.rpm

libexpat.so.1 (provided by expat-2.0.1-11.el6_2.i686.rpm)

libfreetype.so.6 (provided by freetype-2.3.11-6.el6_2.9.i686.rpm)

libfontconfig.so.1 (provided by fontconfig-2.8.0-3.el6.i686.rpm)

libICE-1.0.6-1.el6.i686.rpm

libuuid-2.17.2-12.7.el6.i686.rpm

libSM-1.1.0-7.1.el6.i686.rpm

libXext-1.1-3.el6.i686.rpm

compat-libstdc++-33-3.2.3-69.el6.i686.rpm

compat-db-4.6.21-15.el6.i686.rpm

libXi-1.3-3.el6.i686.rpm

libXtst-1.0.99.2-3.el6.i686.rpm

libXft-2.1.13-4.1.el6.i686.rpm

libXt-1.0.7-1.el6.i686.rpm

libXp-1.0.0-15.1.el6.i686.rpm

Components Required for SiteMinder Federation

The following components are required for SiteMinder Federation (Legacy and Partnership):

Note: Refer to the Federation Release Notes for any known issues regarding federation features and the Web Agent Option Pack.

Components Required for eTelligent Rules

The following components are required for eTelligent Rules:

Version Compatibility

If the Web Agent and Web Agent Option Pack are installed on the same server, they must both be the same version, including the Service Pack and CR version. However, the Web Agent Option Pack can operate with Policy Servers of different, but compatible versions. To learn which Policy Server versions the Web Agent Option Pack is compatible with, see the SiteMinder Platform Support Matrix.

Important! When different compatible versions of the Web Agent Option Pack and Policy Server are mixed, federation functionality is limited to that of the lesser of the two components. Thus, if the Policy Server supports a federation feature but the Web Agent Option Pack does not, a request that requires that functionality may be rejected or the functionality ignored. The same is also true if the Web Agent Option pack supports a feature and the Policy Server does not.

More information:

Mixed-Version Upgrade Considerations

Environment Variables Added by the Installation

The installation of the Web Agent Option Pack sets the following environment variables:

Java Virtual Machine Installation Error on Solaris can be Ignored (149886)

Symptom:

You are doing a console mode installation of a SiteMinder product on a Solaris platform. The following error message displays: "Unable to install the Java Virtual Machine included with this installer."

Solution:

Ignore this error message. The error is a third-party issue and it has no functional impact.

Web Agent Option Pack on JBOSS Requires Workaround (147357, 149394)

Symptom:

On the JBoss 5.1.2 server, system JARs are overriding application-specific JARs, such as those JARs for the Web Agent Option Pack.

Solution:

Prevent the Web Agent Option Pack XML API files from being overwritten by JBOSS system JARS.

Important! This workaround only applies to the supported version of JBOSS 5.1.2.

Add the following filter package in two places in the war-deployers-jboss-beans.xml file:

<property name="filteredPackages">javax.servlet,org.apache.commons.
logging,javax.xml.parsers,org.xml.sax,org.w3c.dom</property>

The filter package allows the use of the Web Agent Option Pack XML API files instead of the JBOSS system files.

Follow these steps:

  1. Locate the war-deployers-jboss-beans.xml file located in the directory:

    /deployers/jbossweb.deployer/META-INF/

  2. Find the following entry:
    <property name="filteredPackages">javax.servlet,org.apache.
    commons.logging</property> 
    
  3. Change the entry to:
    <property name="filteredPackages">javax.servlet,org.apache.commons.
    logging,javax.xml.parsers,org.xml.sax,org.w3c.dom</property>
    

    This entry in the file is on one line.

  4. Find the second instance of the entry in step 2 and replace it with the entry in step 3.

    Add the filter package in both places in the XML file.

  5. Save the XML file.