Version 9.5 SP1
 —  LoginModules Guide  —

Installing Integrated Authentication Framework

When you install Integrated Authentication Framework, you can also install and use System Management Hub as an administration web interface of your IAF installation. System Management Hub is not automatically selected as a dependent product in Software AG Installer. To install and use System Management Hub, you need to manually select the product when you install IAF.

For more information about installing (or uninstalling) the latest release of Integrated Authentication Framework, see Installing webMethods Products on the Software AG Documentation Web site.

When you install Integrated Authenticated Framework on a system that already has an installed instance of System Management Hub; to administer your IAF installation using SMH administration interface, you must restart Software AG Tomcat Server.

See also Configuring Integrated Authentication Framework.


Installing System Management Hub over an Integrated Authentication Framework Installation

When you install System Management Hub on a system that has an already installed Integrated Authentication Framework, you must manually perform the following steps after the installation.

Start of instruction setTo install SMH on an IAF installation on Windows operating systems

  1. Open a console window.

  2. Open the following directory in the console window.

    Software AG_directory\InstanceManager\bin\

  3. Execute the argrgutl.exe tool with the iafarg.argrgutl parameter as shown below:

    argrgutl.exe Software AG_directoryiaf\conf\iafarg.argrgutl
  4. Execute the following commands in the console window:

    1. set REGFILE=Software AG_directory\common\conf\regfile
    2. Software AG_directory\InstanceManager\bin\regutil create "HKEY_LOCAL_MACHINE\SOFTWARE\Software AG\System Management Hub\Products\Integrated Authentication Framework\Users\userName"

      Replace userName with a valid SMH user.

    3. Software AG_directory\iaf\bin\iafsrv install
    4. Software AG_directory\iaf\bin\iafsrv start

Start of instruction setTo install SMH on an IAF installation on UNIX operating systems

  1. Open a console window.

  2. Open the following directory in the console window.

    Software AG_directory/InstanceManager/bin/

  3. Execute the argrgutl tool with the iafarg.argrgutl parameter as shown below:

    sh argrgutl Software AG_directoryiaf/conf/iafarg.argrgutl
  4. Execute the following commands in the console window:

    1. Depending on the shell that is used, execute one of the following:

      set REGFILE=Software AG_directory/common/conf/regfile
      export REGFILE=Software AG_directory/common/conf/regfile
    2. Software AG_directory/InstanceManager/bin/regutil create "HKEY_LOCAL_MACHINE\SOFTWARE\Software AG\System Management Hub\Products\Integrated Authentication Framework\Users\userName"

      Replace userName with a valid SMH user.

    3. Software AG_directory/iaf/bin/iafsrv start
      

Top of page

Product Directory Structure

In the current document, Software AG_directory is used as the base directory of the installed product. In Software AG_directory the installation creates the subdirectories common and iaf. The iaf directory is the root for installing Integrated Authentication Framework product versions. The common directory is used for installing components shared by Integrated Authentication Framework and other Software AG products.

Directory Description
Software AG_directory\iaf\bin

Directory containing IAF related executables and libraries. The directory contains copies of the IAF executable tools that are described in the Integrated Authentication Framework Tools section.

Note:
On UNIX based operating systems the IAF libraries are separated into the Software AG_directory\iaf\lib directory.

Software AG_directory\iaf\conf

Directory containing IAF related configuration and attribute files.

Software AG_directory\iaf\etc

Directory containing certificates and keystore files used by IAF.

Software AG_directory\iaf\service

Directory containing the IAF attributes file.

Software AG_directory\iaf\xml

Directory containing System Management Hub agent descriptions that perform the integration of IAF into SMH.

Top of page

Next Steps

To complete the installation of IAF and start using it, you must create and configure an IAF service (that provides an authentication scenario). IAF does not create, nor configures a default IAF service after the installation of the product.

For more information about creating and configuring authentication scenarios in IAF (IAF services), see Configuring Integrated Authentication Framework.

Top of page