ETERNUS SF Disk Space Monitor User's Guide - Microsoft(R) Windows Server(TM) 2003/Solaris(TM) Operating System/Linux - 13.0

13.2 Applying Policies

Once policies have been prepared, they can be applied. The specification for the policy application command is explained below.

[Command name]

sqcSetPolicy: Applies policies

[Syntax]

Installation drectory\bin\sqcSetPolicy.exe [-h host name]

Log in as a superuser to execute this command.

/opt/FJSVssqc/bin/sqcSetPolicy.sh [-h host name]

[Function]

This command applies policies. The system name can be specified using the -h option. If the -h option is omitted, the host name will be set.

If this command is re-executed or an Agent is reinstalled where an operating environment for this product already exists and an Agent has already been registered, then use the same system name as was used before if the -h option is specified.

If the system name has to be changed for some reason, first delete the previous system name information from the PDB using the data deletion command explained in Section 18.3, "sqcPDBerase (Data Deletion Command)". However, in this case, performance information that has already been collected cannot be displayed.

Make sure that this product's DCM service has been stopped before applying policies. If policies are applied (that is, if this command is executed) while the DCM service is still running, the command will terminate abnormally. Refer to Chapter 5, "How to Start and Stop Resident Processes" for details on how to stop the DCM service.

[Options]

Option

Meaning

[-h host name]

Use this option to specify a new name for the managed system in the following kinds of cluster operations: Where the server is a Manager and information about resources within the server is to be collected. (The current node and the standby node need to be managed using a single system name.) Where the server is an Agent in a cluster system that uses node name inheritance. (Each node needs to be managed using separate names.)

[Termination status]

Normal termination:0
Abnormal termination:1

If this command terminates normally, the following message will be output:

• "(Success): sqcSetPolicy succeeded."

If this command terminates abnormally, the following messages will be output:

• "(Error): The file was not able to be created because of insufficient file access rights or disk space."
  (File access error such as no available disk space or access privileges)
• "(Error): There is an error in section [Section : XXX] of the template file sqcSetPolicy Template define error."
  (There is an error with a template definition.)
• "(Error): DCM is running and so sqcSetPolicy can not be run. Please stop dcm and retry sqcSetPolicy."
  (The DCM service/daemon is running.)
• "(Error): There is no available policy to apply."
  (No valid policies can be found to apply, or sqcRPolicy is yet to be executed.)

If these error messages are displayed, the policies for the policy settings message displayed before the error messages will not take effect.

[Usage example]

For normal termination

C:\Program Files\DiskSpaceMonitor\bin>sqcSetPolicy

This Computer Name is "XXXX"

The policy has been set for the <YYYY>

(Success) : sqcSetPolicy succeeded.

For abnormal termination

C:\Program Files\DiskSpaceMonitor\bin>sqcSetPolicy

This Computer Name is "XXXX"

(Error ) : There is an error in section [Section:ZZZZ] of the template file.

For normal termination

# cd /opt/FJSVssqc/bin/

# ./sqcSetPolicy.sh

This Host Name is "XXXX"

The policy has been set for the <YYYY>

(Success) : sqcSetPolicy succeeded.

For abnormal termination

# cd /opt/FJSVssqc/bin/

# ./sqcSetPolicy.sh

This Host Name is "XXXX"

(Error) : There is an error in section [Section : ZZZZ] of the template file sqcSetPolicy Template define error.

"XXXX" refers to the name specified with the -h option. If the -h option is omitted, the host name of the system where this command was executed will be displayed.

"YYYY" indicates the middleware that has been detected. A separate line will be displayed for each middleware product that is detected.

"ZZZZ" indicates the section of the template file where the definition error was found.

[File]

If this command is successful, the following files will be created according to the content of the managed object configuration information file.

Variable file directory\control\ManagedConf_XXXX.xml

"XXXX" refers to the name specified with the -h option. If the -h option was omitted, the computer name of the system where the command was executed will be set.

/etc/opt/FJSVssqc/ManagedConf_XXXX.xml

"XXXX" refers to the name specified with the -h option. If the -h option was omitted, the host name of the system where the command was executed will be set.

Start the service/daemon after applying the policy. This configuration information must then be updated in the Console window.

Refer to Chapter 5, "How to Start and Stop Resident Processes" for details on how to start the service/daemon and Chapter 9, "The Admin Console Window" for details on how to update configuration information.