PROTOTYPE
Not reviewed yet: use at your own risk!

satin.remotelauncher
Class Server

java.lang.Object
  |
  +--satin.remotelauncher.Server

public class Server
extends java.lang.Object

This is a program that provides remote access to various operations through the RemoteLauncher class. These operations include launching programs, manipulating files, and accessing parameters.

This class has a main method and thus is executable as an independent Java program. It is not intended for use inside another Java program. You can launch the server program by executing the command "java satin.remotelauncher.Server".

Command-Line Parameters

The server program recognizes the following arguments, all of which are optional, and which may appear in any order:

-appendLogFile

If this option is specified and the log file already exists, the log file is appended rather than being replaced. See -logfile.

-clients machineName

Specifies the name or IP address of a machine from which connection requests will be accepted. This argument may appear multiple times to specify multiple machines. A connection from the same (local) machine is always allowed, even if not specified.

-clientFiles fileName...

Specifies the names of one or more ASCII text files that contains lists of machine names or IP addresses from which connection requests will be accepted. Each machine name or IP address must appear on its own line. Whitespace within a line is ignored. Any line whose first non-space character is not alphanumeric or '_' is ignored.

-debug

Enables printing of debugging statements. This is only of use for development and debugging of the RemoteLauncher tool.

-log

Causes all client/server activity to be logged to the standard output.

-logFile fileName

Causes all client/server activity to be logged to a file. If the file already exists it is replaced, unless the -appendlog option is given.

-help

Displays a help message. Synonyms: -h, -?, /h, /?

-params fileName

Specifies the name of a testbed parameter file. The parameter file must contains exactly one testbed specification; its name does not matter. Some of these parameters control the behaviour of the server itself (see below). See satin.testing.parameters for more information.

-port portNumber

Specifies the IP port number on which the server will listen. If not specified, it defaults to 12344.

Testbed Parameters

The testbed parameter file may optionally contain an application block named "REMOTE_LAUNCHER", which may optionally contain any of the following parameters:

Vector CLIENTS client_list

Specifies a list of the names and/or IP addresses of machines from which connection requests will be accepted. Any clients specified on the command-line are added to this list.

int PORT port_number

Specifies the IP port number on which the server will listen. If not specified, it defaults to 12344. If the -port command-line option is specified, it overrides this value.

String LOG_FILE file_name

Specifies the name of a file in which all client/server activity will be logged. If no log is specified, then no log file will be written. If the -logfile command-line option is specified, it overrides this value.

boolean APPEND_LOG append?

Specifies what to do if the log file already exists: true means append, false means replace. If not specified, it defaults to false (replace).

Example

This is an example of a testbed parameter file. Note that this is an example of a server-side parameter file, not a client-side (script) parameter file.

 application REMOTE_LAUNCHER
 {
     int PORT 12344;
     Vector CLIENTS { String "estauffpc", String "estauffpc2" };
     String LOG_FILE "c:/temp/RemoteLauncher.log";
 } 

See satin.testing.parameters for more information.

Author:

Ed Stauff

Method Summary

static void

main(java.lang.String[] args)

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Detail

main

public static void main(java.lang.String[] args)
                 throws java.lang.Exception

Revision History

6/19/01 Ed Stauff - made changes per API review.

4/17/01 Ed Stauff - file created.