In the directory where you want to install the tuning tool, unzip the ssoAdmintools.zip file.
In the directory which has the unzipped ssoAdminTools file, run the following command:
./setup
setup
When prompted, enter the configuration directory.
Example: /opensso_config/opensso
Once installation is complete, you can use the command-line interface under the following directory:
<TOOLS_DIR>/<OPENSSO_INSTANCE_NAME>/bin
where <TOOLS_DIR> is the directory which has the unzipped ssoAdmintools.zip file, and <OPENSSO_INSTANCE_NAME> is the OpenSSO Enterprise deployment URI.
The amtune tool is now in the <TOOLS_DIR>/<OPENSSO_URI>/bin/amtune directory.
Log in as or change to superuser.
If you have not run the tool in REVIEW mode, ensure that AMTUNE_MODE is set to REVIEW in the following file:
<TOOLS_DIR>\<OPENSSO_URI>\bin\amtune\amtune-env.properties file
Edit other parameters in the amtune-env.properties file, depending upon the components you want to tune.
See the Appendix for detailed information about the properties.
In REVIEW mode, run the amtune tool with a password file.
See the section Using a Password File in this document.
<TOOLS_DIR>/<OPENSSO_URI>/bin/amtune/amtune
<TOOLS_DIR>\<OPENSSO_URI>\bin\amtune\amtune.bat
Review the tuning recommendations in the terminal or in the <TOOLS_DIR>/OPENSSO_URI/logs/amtune-config.<timestamp>.log file. If necessary, make changes to the amtune-env.properties file based on the tuning recommendations.
When you are satisfied with the tuning recommendations from running amtune in REVIEW mode, set AMTUNE_MODE to CHANGE in the amtune-env.properties file.
Check the debug log file for the results.
In CHANGE mode, the amtune tool might need to restart the web container and OpenSSO Enterprise. When the operating system kernel parameters are changed, the amtune tool will recommend a system restart.
FTP or copy amtune.zip to the remote Sun Directory Server host.
In the change mode section of amtune-env.properties file, if AMTUNE_TUNE_DS=true, then the amtune.zip file is automatically generated.
Unzip amtune.zip.
Set values for TOOL_HOME and JAVA_HOME.
<TOOLS_DIR>/bin/unix/amtune
<TOOLS_DIR>\bin\windows\amtune.bat
Edit the amtune-env.properties file to include Directory Server information.
Run the amtune tool with a password file for the Sun Directory Server Directory Manager.
The Directory Server Directory Manager password must be inaccessible to non-owners and only readable by its owner . For example, you can run change the permissions mode of the password file by running the following command:
chmod 400
amtune
amtune.bat
On Windows, you must also execute amtune.bat with a password file. But amtune.bat does not check its file permission on Windows.
In CHANGE mode, if AMTUNE_TUNE_DS=true, then the amtune tool will restart the Sun Directory Server instance.
If AMTUNE_TUNE_OS=true, then the amtune tool will tune the operating system kernel parameters and will recommend a system restart.