RTSERVER Shell Script
The RTSERVER shell script is located in the /sbin directory that is subordinate to the Optim™ installation directory. This shell script contains commands that may be useful to manipulate the Server process. Generally, the RTSERVER script does not need modification.
You must change the script, however, if the Server is installed in a directory other than the default directory, /opt/IBM/Optim, or if the Server will be run under a user account other than root. The script contains areas that allow you to modify the following environment variables:
- Set PSTHOME=${PSTHOME:directory/rt} to define the directory containing the Server.
- Set PSTUSER=${PSTUSER:user} to identify a user other than root.
Arguments
RTSERVER arguments define the operation to be performed, as follows.
- rtserver start
- Start the Server in the background. The stdout and stderr produced by the Server are written to a file named pr0svce.out, which can be found in the temp directory that is subordinate to the Optim installation directory.
- rtserver stop
- Stop a running Server instance. The Server stops after processes are complete.
- rtserver kill
- Kill a running Server instance. The Server stops abruptly, without regard to running processes.
- rtserver update
- Reread the Pstserv configuration file after processes have completed. Use this command to make changes to the configuration file without restarting the Server.
- rtserver list
- List all processes running on the Server. The list includes the PID of the process, the name of the computer delegating the process, the Optim Directory that is active for the process, the type of process (archive, extract, etc.), the name of the process request, the time the process started, and period for which it has been running.
- rtserver verify server
- Verify settings in the pstserv configuration file, used to configure the system for running the Server.
- rtserver verify local
- Verify the settings in the pstlocal configuration file, which provides settings for local operation, using the command line.