Getting Started With the OpenSSO Diagnostic Tool

• Unzipping the ssoDiagnosticTools.zip File

• Setting Your JAVA_HOME Environment Variable

• Invoking the Diagnostic Tool

Unzipping the ssoDiagnosticTools.zip File

After you unzip the OpenSSO Enterprise 8.0 Update 1 Patch 4 (or later) ZIP file, the Diagnostic Tool is in the ssoDiagnosticTools.zip file in the zip-root/opensso/tools directory, where zip-root is where you unzipped the Patch 3 ZIP file.

Create a directory for the Diagnostic Tool and its related files and then unzip the ssoDiagnosticTools.zip file in the new directory. The tool is available for these platforms:

• Solaris and Linux systems: ssodtool.sh

• Windows: ssodtool.bat

In this guide, diagnostic-tool-zip-root represents the directory where you unzipped the ssoDiagnosticTools.zip file.

Setting Your JAVA_HOME Environment Variable

The Diagnostic Tool requires JDK 1.5 or later. Before you run the tool, set your JAVA_HOME environment variable to a JDK 1.5 or later installation.

Note: Embedded quotes are not supported in the JAVA_HOME environment variable.

Invoking the Diagnostic Tool

You can invoke the Diagnostic Tool in either CLI or GUI mode. First, change to the diagnostic-tool-zip-root directory and then invoke the tool as follows:

• GUI mode (default):

  • Solaris and Linux systems: ./ssodtool.sh

  • Windows: ssodtool.bat

• CLI mode, using the --console option:

  • Solaris and Linux systems: ./ssodtool.sh --console

  • Windows: ssodtool.bat --console

The default mode for the Diagnostic Tool is GUI. To change the default mode to CLI before you invoke the tool, set the following property in the diagnostic-tool-zip-root/config/DTConfig.properties configuration file:

odt.application.runmode=CLI