Using the Access Manager Utilities and Scripts with
an Access Manager WAR File Deployment

After you have deployed and configured the Access Manager 7.1 from
the WAR file, you will probably need to perform various administrative and
configurations tasks. For example, you might need to run the amadmin utility
or to configure Access Manager session failover. The Access Manager 7.1 ZIP
file provides utilities, scripts, libraries, and other supporting files in
the following zip files, available for you to download:

The amAdminTools.zip file contains the
files to run the Access Manager CLI utilities and scripts such as amadmin, ampassword, amtune, and amsfoconfig. This zip file also contains properties files for various
locales, including English, French, German, Spanish, Japanese, Korean, Simplified
Chinese, and Traditional Chinese.

The amSessionTools.zip file contains
the files to install Sun Java System Message Queue and the Berkeley DB, which
then allows you to configure Access Manager session failover.

Using the Utilities and Scripts in the amAdminTools.zip File

To Use the Utilities and Scripts in the amAdminTools.zip File

Before You Begin

Caution –

To run the setup utility, you must be using
the Java Runtime Environment (JRE) 1.4 or later. Make sure that your JAVA_HOME and PATH environment variables point to the
JDK installation directory for the version of the JDK that you are using.

On Solaris and Linux systems, issue the following command before
running the setup script:

# chmod +x setup

Create a new directory to unzip the files. For example: amtools

Download the amAdminTools.zip file to the
new directory and unzip the files.

In the directory (amtools) where you unzipped
the files, run the setup utility.

On Windows
systems, run the setup.bat utility.

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

setup -p | --path aminstancedir

where aminstancedir is
the path to the Access Manager configuration files, which includes the AMConfig.properties and serverconfig.xml files.

If you run the setup utility without any options,
the script prompts you for the path to the Access Manager configuration directory.

If the path to the Access Manager configuration files contains
a space, run the setup utility without any options and
then provide the path when you are prompted.

To display the help
for the setup utility:

setup -h | --help

Next Steps

You can now run the Access Manager CLI utilities and scripts from the
directory where you unzipped the amAdminTools.zip file.

Troubleshooting

For more information, see the amAdminTools.zip README
file.

To run the setup utility, you must be using
the JRE1.4 or later.

Using the amSessionTools.zip File
For Access Manager Session Failover

To Use the Scripts and Related Files in the amSessionTools.zip File

Before You Begin

Caution –

To run the setup utility, you must be using
the Java Runtime Environment (JRE) 1.4 or later. Make sure that your JAVA_HOME and PATH environment variables point to the
JDK installation directory for the version of the JDK that you are using.

Create a new directory to unzip the amSessionTools.zip file.
For example: amsfotools

Download the amSessionTools.zip file to the
new directory and unzip the files.

In the directory (amsfotools) where you unzipped
the files, run the setup utility.

On Windows
systems, run the setup.bat utility.

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

setup -p | --path desireddir

where desireddir is
the directory where the setup utility unzips the session
failover scripts and related files.

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

The setup utility
preforms these functions:

Unzips the session failover scripts and related files in the
directory indicated by desireddir.

Unzips the files for Sun Java System Message Queue in the desireddir/jmq directory.