Federation Manager Installation and Upgrade Guide › Install Federation Manager › How to Run the Federation Manager Configuration Wizard › Run the Configuration Wizard on UNIX Systems

Run the Configuration Wizard on UNIX Systems

Before you run the configuration wizard, install Federation Manager and gather all the information that the configuration wizard requires. Run the configuration wizard any time you reinstall Federation Manager.

Important! If you reinstall Federation Manager, rerun the Configuration wizard. Before you rerun the Configuration wizard, back up your existing configuration to preserve SSL and database connections. If you are using an ODBC user directory, also back up the system_odbc.ini file. This file is in the directory federation_mgr_home/siteminder/db/.

These instructions are for GUI and Console Mode installations on UNIX systems. The steps for the two modes are the same, with the following exceptions for Console Mode:

• You can select an option by entering a corresponding number.
• Press ENTER after each step to proceed through the process.
• You can type BACK to visit the previous step.

The prompts for each mode help guide you through the process.

Note: If the UNIX system where you plan to configure Federation Manager uses an IPv6 address, run the configuration wizard only in Console mode. If you try to use GUI mode, the program defaults to console mode due to a third-party limitation.

Important! Do not run the configuration wizard as the root user. If you try to run it as root, the wizard aborts and you receive an error message. Run the configuration wizard as the same user that ran the installation.

To run the configuration wizard

1. Open a console window.
2. Navigate to the directory federation_mgr_home.
3. Source the environment script, ca_federation_env.ksh.
4. Enter one of the following commands in a command window:
   • GUI Mode: ./ca-Federation-config.sh
   • Console Mode: ./ca-Federation-config.sh -i console

   The configuration wizard starts.

5. Respond to the Configuration wizard prompts using the information you gathered before running the wizard.
6. Review the configuration settings and click Install (GUI Mode) or enter Y to install (Console mode).

   Federation Manager is configured.

   If you experience problems during the configuration, review the configuration log file, CA_Federation_Manager_ConfigLog.log, located at federation_mgr_home/install_config_info.

   The installation and configuration of Federation Manager is complete.

7. Start Federation Manager by running the following script:

   federation_mgr_home/fedmanager.sh start

Important! To change the configuration, for example, to switch the deployment mode, rerun the Configuration wizard. The Federation Manager services must be running when you rerun the wizard. You can rerun the Configuration wizard any time, but by doing so you discard your existing configuration. Before you rerun the Configuration wizard, back up your existing configuration to preserve SSL connections.