Sun Java System Access Manager 7.1 Postinstallation Guide

Running the amsfo Script

The amsfo script includes the start and stop options:

Usage: amsfo { start | stop }

ProcedureTo Run the amsfo Script

  1. Log in as or become superuser (root).

  2. Set the variables in the amsfo.conf file, as required for your deployment. For a description of these variables, see Table 6–4.

  3. Run the script. For example, to start the session failover components on a Solaris system with Access Manager installed in the default directory:

    # cd  /opt/SUNWam/bin
    # ./amsfo start
  4. To check the results of the script, see the /tmp/amsession/logs/amsessiondb.log file.

Variables in the amsfo.conf Configuration File

Set the following variables as needed for your deployment before you run the amsfo script.

Table 6–4 amsfo.conf Configuration File




Access Manager default installation directory. The default directory depends on the platform: 

Solaris systems: AccessManager-base/SUNWam

Linux systems: AccessManager-base/identity

AccessManager-base represents the base installation directory for Access Manager. The default values are /opt on Solaris systems and /opt/sun on Linux systems.


Specifies (true or false) whether the script should automatically restart the amsessiondb client.

The default is true (restart the amsessiondb client).


Message Queue broker list participating in the cluster. The format is:  


For example:,,

There is no default.  


Directory where the session database files will be created.  

The default is "/tmp/amsession/sessiondb".


Specifies (true or false) whether the script should delete and then create a new database when the amsessiondb process is restarted.

The default is true.  


Location of the log directory.  

The default is "/tmp/amsession/logs".


Specifies (true or false) whether the Message Queue broker should be started with the amsessiondb process. Set this variable as follows:

true - The Message Queue broker will run on the same machine as the amsessiondb process.

false - The Message Queue broker and the amsessiondb process will run on different machines.

The default is true.  


Name of the Message Queue broker instance to start.  

The default is aminstance.


Port for the local Message Queue broker instance.  

The default is 7777. 


Java VM arguments. The default is "-Xms256m -Xmx512m", which sets the maximum value based on the system resources.


User name used to connect to the Message Queue broker.  

The default is guest. If you specified a different user name under step 3–Add a New User in the Message Queue Server, set USER_NAME to that name.


Location of the password file that contains the encrypted password used to connect to the Message Queue broker. To generate the encrypted password, use the amsfopassword script, as described in amsfopassword Script

The default is $AM_HOME_DIR/.password, where $AM_HOME_DIR specifies the Access Manager default installation directory.