2.3.2 User resource definition

In Linux: $SSO_CONF/rsc/user*#
In Windows: $SSO_CONF\sso\rsc\user*#

(1) Adding a definition

To create a new user resource configuration file, or to re-create a user resource configuration file by adding definitions on a per-resource basis, use the following procedure:

1. Create a new or edit an existing user resource definition file.

   We do not recommend that you create the user resource definition file under the SSO installation directory. In particular, do not create the file under the $SSO_CONF/rsc (in Linux) or $SSO_CONF\sso\rsc (in Windows) directory, which contains the user resource configuration file. If that directory contains a file other than the user resource configuration file (for example, a user resource definition file or a work file), the ssocolmng daemon process might unduly monopolize the CPU or consume memory.

2. If the Resource Configuration window or the Resource Data Reference window is open, close it.

3. Create or re-create a new user resource configuration file by using the ssocolconf command.

4. Restart the ssocollectd, ssocolmng, and ssorptd daemon processes.

To Page Top

(2) Deleting a definition

If a definition is deleted, the existing collection data of the relevant user resources can no longer be referenced by using the ssoextractlog command or the Resource Data Reference window. If necessary, use the ssoextractlog command to extract that definition in text format, and then save the extracted data in a file.

To delete a user resource definition:

1. Stop the collection of all target user resources by using the ssocolstop command or the Resource Configuration window.

2. If necessary, use the ssoextractlog command (with the -text and -savefile options specified) to extract the existing collection data of the target user resources in text format.

3. Delete all the collection data of the target resource by using the ssodbdel command or the Resource Data Reference window.

4. Delete all the collection condition definitions of the target user resource by using the ssocolset command or the Resource Configuration window.

5. If the Resource Configuration window or the Resource Data Reference window is open, close it.

6. If you want to delete only some resources, re-create the user resource configuration file by using the ssocolconf command. If you delete a user resource configuration file, you must also delete the corresponding user resource configuration file.

7. Restart the ssocollectd, ssocolmng, and ssorptd daemon processes.

To Page Top

(3) Changing a definition

The procedure to change a user resource definition differs depending on the condition. The following shows the procedure for each condition.

Condition 1: When performing either of the following operations within the resource definitions of the same English resource name (rsc_label_e key value):

• Changing a resource ID (rsc_id key value).

• Deleting some definitions related to existing subresources (subrsc_label_j, subrsc_label_e, and subrsc_mib_data keys).

Before changing user resource definitions, you must delete all the existing collection data of those user resources as well as the resource configuration. If necessary, use the ssoextractlog command to extract the existing collection data in text format and save it as a file.

Execute the same procedure as that described in (2) Deleting a definition.

Condition 2: When changing the English resource name (rsc_label_e key value) within resource definitions that have the same resource ID (rsc_id key value):

Note that after changing user resource definitions, you cannot view the existing collection data of those user resources in the Resource Data Reference window.

If necessary, use the ssoextractlog command to extract the existing collection data in binary format or text format and save it as a file.

The procedure for changing user resource definitions is as follows:

1. Stop the collection of all target user resources by using the ssocolstop command or the Resource Configuration window.

2. If necessary, use the ssoextractlog command to extract the existing collection data of the target user resources and save it as a file.

   • To save the collection data in binary format

     Execute the ssoextractlog command with the -bin and -savefile options specified.

     You cannot view the data from the Resource Data Reference window, but you can view the data by using the ssoextractlog command with the -text and -logfile options specified.

   • To save the collection data in text format

     Execute the ssoextractlog command with the -text and -savefile options specified.

3. Delete all the collection data of the target user resources by using the ssodbdel command or the Resource Data Reference window.

4. Delete all the collection conditions definitions of the target resources by using the ssocolset command or the Resource Configuration window.

5. If the Resource Configuration window or the Resource Data Reference window is open, close it.

6. Use the ssocolconf command to re-create the user resource configuration file.

7. Restart the ssocollectd, ssocolmng, and ssorptd daemon processes.

Condition 3: When neither of the above conditions applies:

Execute the same procedure as that described in (1) Adding a definition.

To Page Top