Appendix A lh Reference

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\j2re1.4.1_01. This directory contains the bin directory with the Java executable. In this case, set JAVA_HOME to C:\Program Files\Java\j2re1.4.1_01.

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 D:\java\jdk1.3.1_02.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

class

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

commands

Must be one of the following commands:

config — Starts the Business Process Editor.

console — Starts the Identity Manager console.

export — Exports an exchange file.

js — Invokes a JavaScript program.

javascript — Same as js.

import — Imports an Identity Manager object.

license [options] {status | set {parameters }} — Sets the Identity Manager license key.

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.

syslog [options] — Extracts records from the system log.

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

export command

Usage

export [-v] Outfile [ typeSet | typeName... ]

Options

-v — Enables verbose mode.

typeName options: all, default, or users. The all option exports all object types except:

Log

Syslog

TestItem

Server

Administrator

It is not generally common practice to export a log file from one environment to another.

license command

Usage

license [options] { status | set {parameters} }

Options

-U username (if Configurator account renamed)

-P PathtoPassword.txt (if Configurator password changed)

Parameters for the set option must be in the form -f File.

Examples

lh license status

lh license set -f File

syslog command

Usage

syslog [options]

Options

-d Number — Shows records for the previous Number days (default=1)

-F — Shows only records with fatal severity level

-E — Shows only records with error severity level or above

-W — Shows only records with warning severity level or above (default)

-X — Includes reported cause of error, if available

Previous Contents Index Next

Previous Contents Index Next
Sun Java[TM] System Identity Manager 7.1 Admininstration