Command-line Usage for the Jini(TM) Technology Lookup, Discovery, and Join Compatibility Kit
v1.0

SYNOPSIS

java -Djava.security.policy=<security-policy-property> -cp <classpath> com.sun.jini.compat.harness.Runner <full-path-to-config-file-name> [-categories c1,...] [-testst1,...] [-xcategoriesc1,...] [-xtestst1,...] [-noduplicates]

DESCRIPTION

The harness found in the Jini(TM) Technology Lookup, Discovery, and Join Compatibility Kit (LDJ Kit) is used to test clients, services, and lookup services for conformance to the Jini technology specifications.

OPTIONS AND ARGUMENTS

security-policy-property

The security policy file that is specified for the Runner program must be the policy.all found in the policy subdirectory of the LDJ Kit installation directory.

classpath

The classpath will need to include the compat.jar file, located in the lib subdirectory of the LDJ Kit installation directory, as well as any implementation(s) of Admin components that you've written.

full-path-to-config-file-name

Specifies the absolute path of the LDJ Kit configuration file. A sample configuration file (ldj.prop) is in the LDJ Kit installation directory.

categories
Specifies a comma-separated list of test categories. When the test list is generated, only tests for the given categories will be included. This argument is optional, but if it is not provided, then the property com.sun.jini.compat.categories must exist in the config file and must specify a comma-separated list of test categories. Valid values for this property are client, service, and lookup.

tests
Specifies a comma-separated list of tests or test sets to run. If tests is not specified, all LDJ Kit tests which support the specified categories are included. The tests in each category are:
client
com.sun.jini.compat.test.RequestPacketTest com.sun.jini.compat.test.UnicastRequestTest com.sun.jini.compat.test.CodeDownloadTest
service
com.sun.jini.compat.test.RequestPacketTest com.sun.jini.compat.test.UnicastRequestTest com.sun.jini.compat.test.CodeDownloadTest com.sun.jini.compat.test.AnnouncementResponseTest com.sun.jini.compat.test.RegistrationTest com.sun.jini.compat.test.MultiRegistrationTest com.sun.jini.compat.test.PublicGroupTest com.sun.jini.compat.test.NonPublicGroupTest com.sun.jini.compat.test.MultiGroupTest com.sun.jini.compat.test.LeaseTest
lookup
com.sun.jini.compat.test.LookupByServiceIDTest com.sun.jini.compat.test.LookupByClassTest com.sun.jini.compat.test.LookupBySuperClassTest com.sun.jini.compat.test.LookupByInterfaceTest com.sun.jini.compat.test.MultipleServiceLeaseRenewalTest com.sun.jini.compat.test.ServiceIDTest com.sun.jini.compat.test.ServiceLeaseExpirationTest com.sun.jini.compat.test.MultipleEventLeaseRenewalTest com.sun.jini.compat.test.EventLeaseExpirationTest

xtests
Specifies a comma-separated list of tests to exclude from the test list.

xcategories
Specifies a comma-separated list of categories to exclude from the test list.

noduplicates
Specifies that duplicate test entries are to be removed from the test list. By default, duplicates are retained.

RELATED SYSTEM PROPERTIES

com.sun.jini.compat.reggie.proxy.debug
If set to any value, this property indicates that debugging information related to the execution of the LDJ Kit's lookup service proxy should be printed to System.err. Set this property on the LDJ Kit command line, if calls to the lookup service are unexpectedly returning null values for service objects, service types, attribute set classes, attribute sets, or attribute values.

EXAMPLES

To run each of the tests that a service must pass (where <install dir> is the installation directory of the LDJ Kit)

On UNIX platforms:

	java -Djava.security.policy=<install dir>/policy/policy.all 
	     -cp <install dir>/lib/compat.jar
	     com.sun.jini.compat.harness.Runner 
             <install dir>/ldj.prop
             -categories service

On Microsoft Windows platforms:

	java -Djava.security.policy=<install dir>\policy\policy.all
	     -cp <install dir>\lib\compat.jar
	     com.sun.jini.compat.harness.Runner
	     <install dir>\ldj.prop
             -categories service

To run only the service test, RegistrationTest (where <install dir> is the installation directory of the LDJ Kit)