Federation Security Services Guide › Deploying Federation with the FSS Sample Application › Deploy the Sample Application on One System
Deploy the Sample Application on One System
To run the FSS sample application, you execute the SetupFederationSample.pl script from a command line. Be aware that after you run the SetupFederationSample.pl once, running it again deletes the sample policy objects created by the previous execution of the script.
Important! You must use the Perl interpreter that is shipped with SiteMinder. This script is located in the directory policy_server_home/CLI/bin.
To run the sample application on a single system
- Complete all core SiteMinder and Federation prerequisites.
- (Optional) If you are using a web browser on a system that does not have the correct host mappings for www.idp.demo and www.sp.demo, add these mappings to the system's hosts file.
- On Windows, the host file is typically located in WINDOWS\system32\drivers\etc\hosts.
- On Solaris/UNIX, the host file is commonly located in /etc/hosts.
- Define your environment by configuring the FederationSample.conf file.
- Open up a command window.
- Navigate to policy_server_home/siteminder/samples/federation
- Enter the following command then follow the prompts:
perl SetupFederationSample.pl -admin siteminder_administrator
-password administrator_password
Note: When you are prompted to continue with the installation, enter the word "yes." Do not only enter the letter "y."
- Restart the Policy Server after the script is finished.
- Test single sign-on and single logout.
The script accomplishes the following:
- reads the configuration information from FederationSample.conf file.
- creates policy objects in the policy store that are needed to establish the SAML 2.0 single sign-on and single logout profiles.
- copies web pages to the web server document root
- adds a private key and the corresponding certificate data to smkeydatabase.
- modifies the system's hosts file to map a loopback IP address, 127.0.0.1 to www.sp.demo and www.idp.demo
