The following information is applicable when installing the SAML v2 Plug-in for Federation Services on Microsoft Windows.
Before installing the SAML v2 Plug-in for Federation Services Patch 3 on Windows, ensure that the LDAP server is running, and the web container is shutdown. The installer needs to modify files held by the web container process.
When installing the SAML v2 Plug-in for Federation Services Patch 3 on Solaris and Linux, sample metadata templates and a circle of trust will be automatically created. This is not done when installing on Windows. To create metadata templates and a circle of trust on Windows after installation, start your web container and run saml2meta. See The saml2meta Command-line Reference in Sun Java System SAML v2 Plug-in for Federation Services User’s Guide for more information.
You should already have a staging directory from your initial installation. This variable is referred to as war staging dir in the following procedure.
Download the Windows patch.
See Table 1–3.
Unzip the file into a new directory.
Copy saml2.jar from unzip directory\saml2\lib to war staging dir\WEB-INF\lib.
Change to the unzip directory\saml2\samples\useCaseDemo directory.
Copy init.jspf to the war staging dir\samples\saml2\useCaseDemo.
This action will overwrite the earlier init.jspf.
Generate a new WAR from the war staging dir.
Redeploy the new WAR to your web container.
It may be necessary to clean up an attempted installation of Patch 3 if an error is encountered. If this situation occurs, future attempts to install the patch will fail unless this procedure is followed.
Remove the base_dir\saml2 directory.
This directory contains the SAML v2 binary bits.
Remove the following SAML v2 related properties from the bottom of AMConfig.properties.
Remove the appropriate Access Manager or Federation Manager staging directory and extract new one.