Sun Java System SAML v2 Plug-in for Federation Services User's Guide

Supported Software Products

This section covers information you should know about the supported software products. It includes the following topics:

Supported Server Products

The SAML v2 Plug-in for Federation Services can only be installed in a running instance of either Sun Java System Access Manager 7 2005Q4 or Sun Java System Federation Manager 7 2005Q4. These products can be installed on versions of the Solaris™ Operating System (OS), Red Hat™ Linux, or Microsoft Windows. The following sections contain information regarding installation of the SAML v2 Plug-in for Federation Services on these server products.

Installing on Sun Java System Access Manager 7 2005Q4

This section contains information on an Access Manager installation and preparing it for the SAML v2 Plug-in for Federation Services installation.

Note –

The SAML v2 Plug-in for Federation Services works in either the realm or legacy mode of Access Manager.

Installing Access Manager

Access Manager can be installed on versions of the Solaris™ Operating System (OS), Red Hat™ Linux, or Microsoft Windows. The default installation directories for Solaris and Linux are /opt/SUNWam/ and /opt/sun/identity/, respectively. /opt is the root installation directory. SUNWam and sun/identity are the product directories.

Note –

/opt is the default root installation directory for Access Manager. When specified in a path, /AccessManager-base will be used as a generic placeholder. /SUNWam and /sun/identity are the default product directories for Access Manager. When specified in a path, /product-directory/ will be used as a generic placeholder. See the Sun Java System Access Manager 7 2005Q4 Deployment Planning Guide for more information on the product's installed layout.

For information on installing Access Manager, see the Sun Java Enterprise System 2005Q4 Installation Guide for UNIX.

Preparing Access Manager for SAML v2 Plug-in for Federation Services

Before installing the SAML v2 Plug-in for Federation Services into an instance of Sun Java System Access Manager, you need to copy the amserver.war (located in /AccessManager-base/product-directory/) into a new directory and extract its contents using the following command:

jar —xvf amserver.war

This new directory is referred to as the staging directory and contains the original contents for your Access Manager application. Any modifications to the application must be made to the files in this directory. These files are then repackaged into a new WAR and redeployed into your web container. The path to this directory is the value used for the STAGING_DIR variable in your installation file.

Caution –

If your instance of Access Manager has been customized, be sure to copy and extract the updated WAR.

For more information on Linux and Windows installations of the SAML v2 Plug-in for Federation Services, see the following:

Installing on Sun Java System Federation Manager 7 2005Q4

This section contains information on a Federation Manager installation and preparing it for the SAML v2 Plug-in for Federation Services installation.

Installing Federation Manager

Federation Manager can be installed on the Solaris OS, Red Hat Linux, or Microsoft Windows. The default root installation directory for the Solaris OS is /opt.

Note –

/opt is the default root installation directory for Federation Manager. When specified in a path, /FederationManager-base will be used as a generic placeholder. Unlike in Access Manager, the SUNWam directory in Federation Manager cannot be modified so references to this directory will remain static. See the Sun Java System Federation Manager 7.0 User’s Guide for more information on the default installation directory and the default runtime directory.

For information on installing Federation Manager, see the Sun Java System Federation Manager 7.0 User’s Guide. Additional information on Linux and Windows installations of Federation Manager can be found in the following:

Preparing Federation Manager for SAML v2 Plug-in for Federation Services

Before installing the SAML v2 Plug-in for Federation Services into an instance of Sun Java System Federation Manager, backup your staging directory. For more information on Linux and Windows installations of the SAML v2 Plug-in for Federation Services, see the following:

Supported Web Containers

A WAR modified with the SAML v2 Plug-in for Federation Services can be deployed in any of the following web containers. CPU and memory requirements are based on the needs of the web container. See your product's documentation for installation information.

Table 2–1 Supported Web Containers


Web Container	Minimum Version
Sun Java System Web Server	6.1sp4
Sun Java System Application Server	8.1
BEA WebLogic® Server	8.1
WebSphere® Application Server	5.1