Privileges required for execution
[Windows]
The privileges of a user belonging to the "Administrators" group are required to execute this command.
[UNIX]
The privileges of a system administrator (superuser) are required to execute this command.
Execution environment
This command can be executed on Enterprise Manager, Manager, Proxy Manager, and Agent.
Note
To detect each middleware product, it is necessary to ensure that performance information relating to each middleware product can be collected before executing this command.
Server resource information collection policies are created using the following two types of information.
Managed object configuration information (resource configuration information)
This information indicates which resources within the server are being managed (server information/middleware information). It is detected automatically when the sqcRPolicy command is executed.
Note
If the server is running as a cluster system, execute this command on both nodes. However, make sure that the middleware to be managed is running when the command is executed, and fail the cluster system over to the node where the policies are being created before executing the command. (Cluster system functionality is provided by the Enterprise Edition.)
Template
This template defines the performance items for which information will be always collected. It is provided as the following file when this product is installed:
[Windows]
<Variable file storage directory>\control\template.dat |
[UNIX]
/etc/opt/FJSVssqc/template.dat |
[Windows]
For Windows systems, to collect disk-related performance information, the diskperf Windows command must be executed beforehand to enable information to be collected. This command is used as follows:
diskperf -y |
Refer to the Windows help for details on the diskperf command. Before using this command, be sure to enable both physical drives and logical drives.
Point
The system must be restarted after settings are made using the diskperf command.
The diskperf command must be executed before the Systemwalker SQC DCM service starts (before performance information starts being collected).
Syntax
[Windows]
<Installation directory>\bin\sqcRPolicy.exe |
[UNIX]
/opt/FJSVssqc/bin/sqcRPolicy.sh |
Function
This command creates server resource information collection policies, and, at the same time, checks the installation status of the middleware being managed.
Note
Do not execute multiple sqcRPolicy commands simultaneously.
The following middleware and associated resources can be managed:
[Windows]
Interstage Application Server
Work Unit name, object name
Interstage Service Integrator
Work Unit name, object name
Symfoware Sever
RDB system name
Systemwalker Centric Manager
Systemwalker Operation Manager
Subsystem number, project name, queue name
Systemwalker Resource Coordinator(Storage)
Storage, storage-device, Zone, LUNMapping, LUN_R, LUN_POfLUN_R, LUN_V, CM, Switch
ETERNUS SF Storage Cruiser
Storage,storage-device,Zone,LUNMapping,LUN_R,LUN_POfLUN_R,LUN_V,CM,Switch
ServerView Resource Orchestrator
Resource pool
SAP NetWeaver
Web transaction volume management
Identifier for the log file to be analyzed
[Solaris]
Interstage Application Server
Work Unit name, object name
Interstage Business Application Server
Interstage Application Framework Suite
Interstage Service Integrator
Group, queue, sequence
Symfoware Sever
RDB system name
Systemwalker Centric Manager
Systemwalker Operation Manager
Sub system number, project name, queue name
Systemwalker Resource Coordinator
Network interface name
Systemwalker Resource Coordinator (Storage)
Storage,storage-device,Zone,LUNMapping,LUN_R,LUN_POfLUN_R,LUN_V,CM,Switch
ETERNUS SF Storage Cruiser
Storage,storage-device,Zone,LUNMapping,LUN_R,LUN_POfLUN_R,LUN_V,CM,Switch
SAP NetWeaver
Web transaction volume management
Identifier for the log file to be analyzed
[Linux]
Interstage Application Server
Work Unit name, object name
Interstage Business Application Server
Interstage Service Integrator
Group, queue, sequence
Symfoware Sever
RDB system name
Systemwalker Centric Manager
Systemwalker Operation Manager
Subsystem number, project name, queue name
Systemwalker Resource Coordinator(Storage)
Storage,storage-device,Zone,LUNMapping,LUN_R,LUN_POfLUN_R,LUN_V,CM,Switch,
ETERNUS SF Storage Cruiser
Storage,storage-device,Zone,LUNMapping,LUN_R,LUN_POfLUN_R,LUN_V,CM,Switch
ServerView Resource Orchestrator
Resource pool
SAP NetWeaver
Web transaction volume management
Identifier for the log file to be analyzed
Options
None.
Return values
Normal termination: 0
Abnormal termination: 1
If this command terminates normally, the following message will be output:
(Success) : sqcRPolicy succeeded. |
If this command terminates abnormally, the following message will be output:
(Error) : The file was not able to be created because of insufficient file access. |
(File access error such as no available disk space or access privileges)
If managed middleware is detected on the server where RPolicy is executed, the following message will be output:
(Success) : Middleware product <middleware name> has been detected. |
For <middleware name>, the name of the middleware product that has been detected will be displayed. Refer to "Function" for information about which middleware products can be managed.
Usage example
[Windows]
C:\>cd C:\Program Files\SystemwalkerSQC\bin C:\Program Files\SystemwalkerSQC\bin>sqcRPolicy (Success) : Middleware product <InterstageApplicationServer> has been detected. The configuration definitions for the detected middleware have been added. (Success) : sqcRPolicy succeeded. C:\Program Files\SystemwalkerSQC\bin> |
[UNIX]
# cd /opt/FJSVssqc/bin/ # ./sqcRPolicy.sh (Success) : Middleware product Interstage has been detected. The configuration definitions for the detected middleware have been added. (Success) : SqcRPolicy succeeded. # |
File
If this command is successful, the following file will be created:
[Windows]
<Variable file storage directory>\control\MiddlewareConf.xml |
[UNIX]
/opt/FJSVssqc/control/MiddlewareConf.xml |
After creating a server resource information collection policy, run the sqcSetPolicy command by referring to "1.1.3 sqcSetPolicy (Policy Application Command)".
Point
When the Server Resource Information Collection Policy Creation Command (sqcRPolicy) or sqcCtrlPolicy.exe -e RP command described in "1.1.7 sqcCtrlPolicy (Remote Policy Operation Command)" is executed, a file named "MiddlewareConf.xml" will be created. To remove one or more managed objects, edit the contents of MiddlewareConf.xml by referring to "Chapter 3 Resource Configuration Information(MiddlewareConf.xml)".
