Standard Installation

The Federation Manager standard installation option encompasses two separate procedures.

1. The first procedure adds the Federation Manager packages to your server. See To Add Federation Manager Packages.

2. The second procedure creates the Federation Manager WAR from the added packages. See To Archive the Federation Manager Packages.

To Add Federation Manager Packages

This section details the first part of the standard installation procedure in which the Federation Manager packages are added to a directory on your machine. Following the package add, you must still create a staging directory and the WAR. See To Archive the Federation Manager Packages.

1. Log in as root.

2. Create a new directory.

   # mkdir fm1.0

   # cd fm1.0

3. Paste the download URL into a browser window to download the installation bundle into the new directory.

   Go to http://www.sun.com/download/products.xml?id=44a5bbb5 to download Federation Manager.

4. 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.

5. Edit the silent installation file template as described in The Silent Installation File.

6. Run fmsetup to add the Federation Manager packages using the -p option.

   The -p option is used for package installations only.

   # fmsetup install -p -s silent-installation-file

   where silent-installation-file is the name of the file created from the silent installation template discussed in The Silent Installation File. See Detailing the fmsetup Syntax for more information.

   ---

   Caution –

   fmsetup only installs shared packages if they are not already present. If an older package is detected, the installer script will quit and display an error message identifying the older package name. To continue, you must manually remove that package using pkgrm(1M) and run fmsetup again.

   ---

7. Follow the instructions in To Archive the Federation Manager Packages to complete the standard installation option.

To Archive the Federation Manager Packages

This section details the second part of the standard installation option: how to create a staging directory and archive the packages added to your machine in To Add Federation Manager Packages. This procedure will create the WAR used to deploy Federation Manager. After generating a WAR, see Deploying Your Federation Manager WAR.

1. Log in as root.

2. Run fmwar to archive the Federation Manager packages into a WAR file.

   # /FederationManager-base/SUNWam/fm/bin/fmwar -n name-for-WAR -d staging-directory -s silent-installation-file -g

   where:

   name-for-WAR	Defines the name given to the created WAR.
   staging-directory	Defines the path to the directory which contains the files that will be used to generate the WAR.  Caution – The -g option in the example above is used only when creating a Federation Manager WAR for the first time. In these cases, the -g option must be specified and the -d option must point to a directory which does not yet exist. This directory will be the staging directory. A recommended path is /var/opt/SUNWam/FM/war_staging. If the -g option is not specified, -d must point to an existing staging directory to regenerate the WAR. See Detailing the fmwar Syntax for more information.
   silent-installation-file	Defines the name of the file created in The Silent Installation File.

3. Follow the instructions in Deploying Your Federation Manager WAR to complete the product installation.