Section - 3 : Controlling a Connector Server Instance
For the Commander mode, there are no systemparams. The command line looks like this:
java [–cp classpath] oracle.docu…tions.Commander parameters
mainclass is replaced by the oracle.documaker.ecmconnector.applications.Commander class reference.
Because the Commander mode uses far fewer support classes than actually running a connector workload, a much simpler classpath provides all the necessary support classes. The actual classpath is installation dependent. For the Commander mode, it only needs these JAR files:
- log4j-1.2.15.jar
- connector.jar
The Commander mode opens a connection to another copy of the connector application (the target copy) which is already running, presumably in a faceless background mode on the same or another host computer.
It then sends a command to the other program copy. The only available command at this time is the shutdown command, which stops the other program’s execution in an orderly way. You specify the location of the other program copy in the command line parameters. Here is a description of the parameters:
| Parameter | Description |
|---|---|
| -host | This is the host IP address or DNS name of the computer running the target copy. The default is localhost. |
| -port | This is the port on which the target program is configured to listen for commands. The default is 23232. |
| -pword | This is a password configured on the target required to allow command input. There is no default. |
| -command | This is the command to send. Only the shutdown command is currently implemented, which is also the default value. |
Here is an example of a Commander mode command line on Windows:
java -cp log4j-1.2.15.jar;Connector.jar oracle.documaker.ecmconnector.Commander –host 127.0.0.1 –port 23232 -pword boogie –command shutdown
Since this command line uses defaults, an equivalent command would be to just provide a password:
java -cp log4j-1.2.15.jar;Connector.jar oracle.documaker.ecmconnector.Commander -pword boogie
These commands reach out to another copy of the application running in Server mode on the same machine with the default port number and shut it down.