OpenTP1 Version 7 Operation
rtssetup (Set execution environment for real-time statistics service)
Format
rtssetup [-d][storage-directory-for-servers]
|
Function
The rtssetup command sets the environment required to execute the real-time statistics service.
Option
-d
Deletes the executable modules (rtssup and rtsspp) and user service definition files (RTSSUP and RTSSPP) of the real-time statistics service from the OpenTP1 execution environment.
Command argument
storage-directory-for-servers~<path name>
Specifies the directory that stores the management servers (RTSSUP and RTSSPP) for the real-time statistics service.
If you do not specify storage-directory-for-servers, the system assumes $DCDIR/aplib.
Output messages
Message ID |
Description |
Output destination |
KFCA32719-E |
The command was used incorrectly. |
Standard error output |
KFCA32738-I |
Help message |
Standard output |
KFCA32739-E |
An error occurred while the command was being executed. |
Standard error output |
Notes
- The rtssetup command does not set the environment in the following cases:
- If storage-directory-for-servers contains files or directories that have the same names as the execution modules (rtssup and rtsspp) to be created by the rtssetup command
- If the directory specified in the $DCCONFPATH environment variable contains files or directories that have the same names as the user service definition files (RTSSUP and RTSSPP) created by the rtssetup command
- When you specify a user other than an OpenTP1 administrator in the uid operand in the user service default definition, in the rts_log_file_name operand in the real-time statistics service definition, specify a directory that this user can write to.
The real-time statistics service always operates correctly as long as the user has the write authority for the directory that will contain the RTS log file, regardless of the user ID with which the service was started. If the user does not have the write authority, the service outputs the KFCA32734-W message and stops outputting log information to the RTS log file. Note that the uid and groups operands are not specified in the definition files created using the rtssetup command (RTSSUP and RTSSPP). For this reason, if these operands have been specified in the user service default definition, the real-time statistics service is started as the specified user and group.
- The dcsetup command cannot delete the executable modules (rtssup and rtsspp) and user service definition files (RTSSUP and RTSSPP) created by the rtssetup command. Use the rtssetup command to delete the executable modules and user service definition files before you execute the dcsetup command to remove OpenTP1 from your operating system.
If you leave these files on the system when you remove OpenTP1, use the rtssetup command to delete and re-create them when you next install OpenTP1.
All Rights Reserved. Copyright (C) 2006, 2010, Hitachi, Ltd.