Previous      Contents      Index      Next
Sun[TM] Identity Manager 8.0 Administration

Appendix A  
lh Reference

---

Usage

Use the following syntax to invoke the Identity Manager command-line interface and execute Identity Manager commands:

lh { $class | $command } [ $arg [$arg... ] ]

Usage Notes

To display command usage help, type lh (do not supply any arguments).
Setting the path environment variables:
When using the lh command, you should set JAVA_HOME to the JRE directory that contains a bin directory with the Java executable. This location differs depending on your installation.

If you have a standard JRE from Sun (without the JDK), a typical directory location is C:\Program Files\Java\jre1.5.0_14 (or similar). This directory contains the bin directory with the Java executable. In this case, set JAVA_HOME to C:\Program Files\Java\jre1.5.0_14.

A full JDK installation has more than one Java executable. In this case, set JAVA_HOME to the embedded jre directory, which contains the correct bin/java.exe file. For a typical installation, set JAVA_HOME to C:\java\jdk1.5.0_14\jre.

Set the WSHOME variable to the Identity Manager installation directory, as follows:

set WSHOME=<path_to_identity_manager_directory>

For example, to set the variable to the default installation directory:

set WSHOME=C:\Program Files\tomcat\webapps\idm

Note	Make sure the value of the WSHOME variable does NOT contain the following: Quotation marks (“ “) A backslash at the end of the path (\) Do not use quotation marks, even if the path to the application deployment directory contains spaces.

On UNIX systems, you must also export the path variables, as follows:

export WSHOME

export JAVA_HOME

To run the command in 64-bit mode, uncomment the FLAGS="$FLAGS -d64" line in the lh script.
On Windows, start the Identity Manager command-line interface by typing the following at a command line:

%WSHOME%\bin\lh

On Unix, start the Identity Manager command-line interface by typing the following at a command line:

$WSHOME/bin/lh

---

class

Must be a fully qualified class name, such as com.waveset.session.WavesetConsole.

---

commands

Must be one of the following commands:

assessment — May be used during upgrades. Supports subcommands that report on all modified objects and report on all installed version of Identity Manager. See the Identity Manager Upgrade book for details.
config — Starts the Business Process Editor.
console — Starts the Identity Manager console.
genReports — Generates a set of random data that can be used to demonstrate Identity Manager report functionality.
import — Imports an Identity Manager object. Specify the -s option for strict mode. When strict mode is enabled, reference checking during import is less forgiving.
js — Invokes a JavaScript program.
javascript — Same as js.
msgtool     — Generates a custom message catalog based off of WPMessages.properties. This catalog can be manipulated to make custom changes to text or languages.
script — Executes JavaScript or BeanShell.
setRepo — Sets the Identity Manager index repository.
setup — Starts the Identity Manager setup process, which allows you to set the license key, define the Identity Manager index repository, and import configuration files.
spml—Launches the SPML browser.
syslog [options] — Extracts records from the system log. See syslog command for details.
waveset — An alias for the console command. See console, above.
xmlparse — Validates XML for Identity Manager objects.
xpress [options] Filename — Evaluates an expression. Valid option is
-trace (enables trace output).

---

Examples

lh com.waveset.session.WavesetConsole
lh console
lh console –u $user –p PathtoPassword.txt
lh setup -U Administrator -P PathtoPassword.txt
lh setRepo –c -A Administrator -C PathtoPassword.txt
lh setRepo –t LocalFiles –f $WSHOME

---

syslog command

Usage

syslog [options]

Options

Use these options to include or exclude information:

Table A-1  Syslog Command Options

Option	Description
-d Number	Shows records for the previous Number days (default=1).
-E	Shows only records with error severity level or above.
-F	Shows only records with fatal severity level.
-i LogID	Shows only records with a specified syslog ID. Syslog IDs are displayed on some error messages and reference a specific System Log entry.
-W	Shows only records with warning severity level or above (default).
-X	Includes reported cause of error, if available.

Previous      Contents      Index      Next

---

Part No: 820-2954-10.   Copyright 2008 Sun Microsystems, Inc. All rights reserved.