Starting, stopping, pausing, and resuming the Launcher service
On UNIX systems, you can use command line options to start, stop, pause, and resume the Launcher daemon.
launcher.sh
[-start [adminpropfile]]
[-stop [listenerport [hostname]]]
[-pause | -resume [listenerport [timeout [hostname]]]]
- -start [adminpropfile.xml]
- Starts the Launcher daemon with
the properties that are configured in the adminpropfile file.
If the adminpropfile file is not specified or fails
to import, starts the Launcher daemon with
the properties that are configured in the launcheradmin.bin properties
file. If the launcheradmin.bin file does not exist, starts the Launcher daemon with the default properties.
In a Microsoft Windows environment, you specify the name of the properties file on the ADMINPROPFILE setting of the [LAUNCHER] section in the JavaServices.ini file. The properties file that is configured on the ADMINPROPFILE setting overrides the LauncherAdmin.bin file. If the LauncherAdmin.bin file does not exist, the Launcher daemon uses default settings on startup.
Start only one Launcher daemon per Launcher installation.
- -stop [listenerport [hostname]]
- Stops the Launcher daemon that
is listening on the specified listener port and host system. If the
listener port and host system are not specified, stops the Launcher daemon that is listening on
the default listener port (port 5015).
The -stop command has a default timeout interval of 120 seconds. During the timeout interval, the Launcher daemon is blocked by the command line until the Launcher daemon stops.
- -pause [listenerport [timeout [hostname]]]
- Pauses the Launcher daemon that is running on the specified listener port and host name, if specified. Otherwise, pauses the Launcher service that is listening on the default listener port (port 5015).
- -resume [listenerport [timeout [hostname]]]
- Resumes the Launcher daemon that is paused on the specified listener port and host name, if specified. Otherwise, resumes the Launcher service that is listening on the default listener port (port 5015).
- timeout
- A value from 30 to 3600 seconds that specifies the time interval that can elapse without an initial response from the Launcher service before a failure is reported. During the time interval, the Launcher daemon is blocked by the command line unless the Launcher daemon pauses or resumes. When the timeout interval expires, the Launcher daemon returns to the command prompt.
Based on the following command example, if the Launcher daemon pauses before 60 seconds,
TRUE or SUCCESS is returned. Otherwise launcher.sh exits, returning
FALSE.
. setup
launcher.sh -pause 3000 60