Installing Liberty Identity Provider Software

To install a basic Liberty IDP infrastructure, complete the following procedures:


Installing Liberty Identity Provider Software

The Liberty IDP software should only be installed on compatible hardware (see Liberty Identity Provider Requirements ). The installation is divided into four sections: an installation introduction, a pre-installation summary, the Liberty IDP installation, and a completion record. At any given point of the installation process, you can follow the progress of your installation by referring to the left-hand side of the install dialog. (See Figure 1.)

To install the Liberty IDP:

  1. At the Web download site, click the Web download link to automatically download the Liberty IDP executable.

  2. Run the executable.

    InstallAnywhere* will guide you through the installation process.

  3. After you have read the introductory screen, click Next.

    Figure 1
    Liberty Identity Provider Introduction

  4. If you accept the License Agreement, select the accept button, then click Next.

    Figure 2
    License Agreement

  5. The Liberty IDP created by the installation is configured to run in a non-SSL mode by default. This mode is sufficient for testing purposes only. You cannot use the non-SSL mode in a production environment. For information on how to convert to SSL mode, see Configuring Your Liberty Identity Provider to Run in SSL Mode .

    Click Next if you accept the SSL warning.

    Figure 3
    SSL Warning

  6. The Liberty IDP requires Novell iManager to be installed. Even if you already have iManager installed on your machine, click Next to proceed with the installation.

    Figure 4
    Install iManager

    The iManager installation is a wizard that consists of several screens that run on top of your Liberty IDP installation wizard. InstallAnywhere will guide you through the iManager installation.

    1. Select the language you want (English is the default), then click OK.

      Figure 5
      iManager Installation

    2. Read the Introduction screen, then click Next.

      Figure 6
      iManager Introduction

    3. Read the Detection Summary screen, which indicates the components that will be installed with iManager, then click Next.

      WARNING:  If the Web server, servlet container, and/or JVM show as already installed, you must quit the installation, remove the component(s), then begin the installation again. To be sure you have deleted all the files before reinstalling the Liberty IDP, see Uninstalling the Liberty Identity Provider Software .

      Figure 7
      Detection Summary

    4. Select the directory where iManager should be installed. The default is C:\Program Files\Novell.

      Figure 8
      Choose Install Folder

    5. Click Next.

    6. Review the Pre-Installation Summary. If you need to make changes, click Previous to return to the previous screens. Otherwise, click Install.

      Figure 9
      Pre-Installation Summary

      iManager is installed on your machine. (This installation might take a few minutes.)

    7. If the iManager installation is successful, you will get an Install Complete screen. Review this screen, then click Done.

      Figure 10
      Install Complete

      You are returned to the Liberty IDP installation.

      If iManager does not install successfully, see Troubleshooting Your Liberty IDP Installation and Configuration for tips on how to troubleshoot the installation.

  7. At the LDAP Configuration screen, enter the Admin Distinguished Name, Admin Password, LDAP Server Domain/IP Address, LDAP Port, and select whether to Use Secure LDAP, meaning if the connection should be over SSL (the default is No).

    You must enter the Admin Distinguished Name in eDirectory context. For example, cn=admin,ou=users,o=mycompany.

    NOTE:  If you are using Secure LDAP, you need to import the trusted root of your eDirectory tree into your certificate authority's keystore. You can do this by locating your key material object. By default, this would be located in the same container where your server object is located. Export the trusted root from the key material object. For more information, see Importing Trusted Roots .

    Figure 11
    LDAP Configuration Page

  8. Click Next.

  9. All Liberty single sign-on communication must be digitally signed. To support the digitally signing, the installer program will create a digital signing certificate. In order to create the certificate, you must first enter information. You set up this information on two screens by first entering site information, then setting up a keystore. At the Signing Certificate Information screen, enter the Liberty IDP Site Name, Organization Unit, Organization, City/Locality, State, and Country. You must fill in all of the fields in order to continue with the installation.

    For the Liberty IDP Site Name, you normally specify the DNS Host Name of your IDP server. For example, idp.novell.com.

    IMPORTANT:  Do not use commas on any of the fields for this screen.

    Figure 12
    Signing Certificate Information: Site Information Page

  10. Click Next.

  11. Set up your keystore information by entering a Keystore File Name, Keypair Alias, Keypair Password, and Keystore Password.

    These files are used in the signing process and are referenced by the Liberty application's web.xml file. (By default, this file is located at C:\Program Files\Novell\Tomcat\webapps\nidp\WEB-INF\web.xml.)

    For more information about digital signing and keys, see the Key and Certificate Management Tool documentation.

    Figure 13
    Signing Certificate Information: Keystore Page

  12. Click Next.

  13. Enter an application name. This name will be part of the URL that will be used by service providers to request authentication services from you.

    For example, if you use nidp, an nidp folder will be created in your Tomcat webapps folder (<Tomcat_home>\webapps) with the identity provider Web application.

    Figure 14
    Application Name Page

  14. Click Next.

  15. Review the Pre-Installation Summary. If you need to make changes to your configuration, click Previous to go back to previous screens. If you accept the configuration, click Install.

    Figure 15
    Pre-Installation Summary

    The installation will extend the schema using eDirectory. (This process could take several minutes.)

  16. When the installation is complete, click Done.

    You will need to install the Liberty administration plug-ins in iManager. An installation help screen for iManager launches. To set up the Liberty Roles and Tasks, follow the instructions in the help screen to launch iManager and run the Configuration Wizard.

    Continue with the steps in Creating a Liberty IDP Site to set up your Liberty IDP site.


Installing the Liberty Administration Plug-ins When iManager is Already Installed on Your eDirectory Server

After you have successfully completed the initial Liberty installation, you must install the Liberty administration plug-ins for iManager in order to configure the information entered for your Liberty IDP server. By default, you will install these plug-ins as part of your IDP installation, however, if you need to install these plug-ins separately from your Liberty IDP installation, follow the instructions in this section.

To install the Liberty plug-ins:

  1. Launch iManager, log in to your tree using the IP address, then click the Configure icon (on the toolbar at the top of the page).

    You launch iManager by opening a Web browser and going to https://<ipaddress>/eMFrame/iManager.html (case-sensitive), where <ipaddress> is the address of your server. For detailed instructions on how to launch iManager, see the "Novell Web Applications," html document that was placed on your desktop as part of the iManager installation.

    For iManager documentation, see the iManager 1.5.1 Administration Guide.

  2. Expand the Plug-in Setup and Install menu on the left-hand side.

  3. Click Install Plug-in.

  4. Select the Liberty Identity Management plug-in from the list, enter the collection name (by default, this name is Role Based Service) or search for it, then click OK.

  5. Click the Roles and Tasks icon on the toolbar.

  6. Expand the Liberty Management menu on the left-hand side.

  7. Click Manage Sites and follow the instructions to set up your site. See Creating a Liberty IDP Site for details.

  8. Reboot your machine for the settings to take effect.

    IMPORTANT:  Your machine will still be running in test mode. Before you can run in a production environment, you will need to switch to SSL mode. To make the switch, you need to create a key signing pair, get it signed by a certificate authority, then configure Apache to use it as the SSL certificate. See Configuring Your Liberty Identity Provider to Run in SSL Mode for information on how to make this conversion. You can also refer to the Tomcat and Apache Web sites for more information.