To install the SAML v2 Plug-in for Federation Services packages and create an updated WAR, run the saml2setup installer as described in The saml2setup Command-line Reference.
saml2setup takes as input an installation configuration properties file. See Creating an Installation Configuration Properties File for more information.
Create an installation configuration properties file as described in Creating an Installation Configuration Properties File.
For instances of Access Manager and Federation Manager using an LDAPv3–compliant directory, the new schema file is loaded only if the LOAD_SCHEMA variable in the installation configuration properties file is set to true.
Log in as root.
You must have system administrator privileges to run the SAML v2 Plug-in for Federation Services installer.
Create a new directory.
# mkdir saml2bits
# cd saml2bits
Download the file-name.tar.gz file into the new directory.
See the Sun Java System SAML v2 Plug-in for Federation Services Release Notes for the download URL.
Unpack the product binaries by typing:
# gunzip —dc file-name.tar.gz | tar -xvof -
where file-name.tar.gz is the name of the downloaded file.
Run the saml2setup installer as follows:
# saml2setup install -s installation-file-name
where installation-file-name is the name of the installation configuration properties file described in Creating an Installation Configuration Properties File.
The installer will install the packages, configure the plug-in, and create an updated WAR using the service deployment identifier specified in the AMConfig.properties file of the specific server product.
When installed into an instance of Access Manager, the new WAR is located in /AccessManager-base/product-directory/ and is called service-deploy-uri.war as in, for example, amserver.war.
AMConfig.properties is located in the /etc/opt/product-directory/config directory.
When installed into an instance of Federation Manager, the new WAR is located in the staging directory defined in the installation configuration properties file and is called FM-deploy-uri.war as in, for example, federation.war
AMConfig.properties is located in the /staging-directory/web-src/WEB-INF/classes directory.
Follow the instructions in Appendix A, Deploying the SAML v2 Plug-in for Federation Services Generated WAR to deploy the modified WAR and complete the installation.
Restart Federation Manager if you installed the SAML v2 Plug-in for Federation Services on that server product.