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.

Each zip file contains files to support the following platforms:

• Solaris SPARC and x86 based systems

• Linux systems

• Windows systems

For the specific versions that are supported for each platform, see the Sun Java System Access Manager 7.1 Release Notes.

Using the Utilities and Scripts in the amAdminTools.zip File

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

Before You Begin

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.

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

   # chmod +x setup

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

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

4. 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

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.

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

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

3. 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.

   • Unzips the files for BerkeleyDB in the desireddir/bdb directory.

   To display the help for the setup utility:

   setup -h | --help

Next Steps

You are now ready to configure Access Manager session failover. For more information, see Configuring Access Manager for Session Failover.