Sun OpenSSO Enterprise 8.0 Installation and Configuration Guide

ProcedureTo Run the Session Failover setup Script

Before You Begin
  1. In the directory where you unzipped the ssoSessionTools.zip file, run the setup script.

    On Solaris and Linux systems, use this syntax to run the setup script:

    setup -p|--path dirname

    where dirname is a directory under the current directory where the setup script places the session failover scripts and related files. If dirname does not exist, the script will create the directory for you.

    For example: # ./setup -p sfo

    Considerations:

    • On Windows systems, run the setup.bat script.

    • If you run the setup script without any options, the script prompts you for a path.

    • If the path contains a space, run the setup script without any options and then provide the path when you are prompted.

    • To display the help for the setup script: setup -h|--help

    The setup (or setup.bat) script installs the session failover scripts and related files in the following directories:

    sfo-zip-root Directory

    Script or File 

    jmq/mq

    Message Queue scripts and related files 

    dirname/config/lib

    amsfo.conf session failover configuration file

    dirname/bin

    • Scripts to start and stop the Message Queue broker and amsessiondb client:

      • amsfo on Solaris and Linux systems

      • amsfo.pl on Windows systems

    • Scripts to run the Oracle Berkeley DB client (called by amsfo):

      • amssessiondb on Solaris and Linux systems

      • amssessiondb.bat on Windows systems

    • Scripts to encrypt the password for the Message Queue broker user (default is guest):

      • amsfopassword on Solaris and Linux systems

      • amsfopassword.bat on Windows systems