Top
ETERNUS SF Storage Cruiser 14.0 User's Guide

12.6.1 Commands for operating environment management

The following sections explain the commands for managing the operating environment.


12.6.1.1 User information setting command (defusr)

NAME

defusr - Sets the user information


SYNOPSIS

$INS_DIR\Agent\bin\defusr -a key-name user-name password
$INS_DIR\Agent\bin\defusr -l [key-name]
$INS_DIR\Agent\bin\defusr -r key-name user-name password
$INS_DIR\Agent\bin\defusr -d key-name

($INS_DIR means "Program Directory" specified at the Agent installation.)


DESCRIPTION

This command sets user information necessary for database monitoring. Based on the information set with the defusr command, Agent accesses a database and collects information. User information specified with the defusr command is used only by Agent to access the database and collect information, but it is not related to the user who has started Agent or the user who has logged in to the Client machine.

Only users having administrator authority can execute this command to set or reset user information necessary for database monitoring. Up to 63 letters can be specified individually for the key name, user name, and password of the defusr command. However, Japanese characters (double-byte characters) cannot be specified for the key name, user name, and password of the defusr command.


OPTIONS

-a

Registers user information. Up to 255 sets of user information can be registered. An attempt at registration with an existing key results in an error.

-l

Displays user information. The user name defined for a specified key name is displayed. If no key name is specified, all registered user names are displayed.

-r

Changes user information.

-d

Deletes user information.

key-name, user-name, and password

Specify the following.

Monitored object

key-name

user-name and password

Oracle

Instance name specified in Oracle statement

User information to access to instance specified by key name

SQL Server

Arbitrary name (The same name as the key name specified in SQL Server statement)

User information to access to instance specified by SQL Server statement


EXAMPLES

12.6.1.2 Agent information change command (setagtip)

NAME

setagtip - Changes the Agent information


SYNOPSIS

$INS_DIR\Agent\bin\setagtip [-i ip-address]

($INS_DIR means "Program Directory" specified at the Agent installation.)


DESCRIPTION

This command sets Agent information. Only user of OS administrative group can execute this command.

To change the start IP address of Agent, specify an IP address in the command parameter for this setting.


OPTIONS

No specify

Displays the current setting information.

-i ip-address

For ip-address, specify the IP address of the server node that can communicate from the administrative server.

Sets a specified IP address as the start IP address of Agent.


EXAMPLES

NOTES

If the host name cannot be resolved from the specified IP address, the messages shown below is displayed. Check for an error in the specified IP address or network definition (hosts, DNS, etc.), and re-execute the command.

IP Address = IP address: Host's Name is not found.

12.6.1.3 Server node Agent SNMP Trap Test (traptest)

NAME

traptest - Does the test of SNMP Trap


SYNOPSIS

$INS_DIR\Agent\bin\traptest [ip-address]

($INS_DIR means "Program Directory" specified at the Agent installation.)


DESCRIPTION

This command checks whether SNMP Trap is correctly transmitted to a administrative server from a server node agent, display an event, and check the linkage with Shell/Bat. The Centric Manager linkage is not operated by this command.

If the action on SNMP Trap as a test is supposed to be changed, change SNMP Trap XML definition file (1_3_6_1_4_1_211_4_1_3_21_2_2.xml) for the ESC agent. In SNMP Trap as a test, 1 is used for Specific Trap Type number and the action can be changed by changing the definition of the Specific Trap Type number 1 defined in SNMP Trap XML definition file. For SNMP Trap XML definition file, refer to "C.6 SNMP Trap XML Definition File".

Only in the environment where the server node holds two or more IP addresses, a server node's IP (Agent start IP address) address which the ESC manager recognizes is specified to ip-address.


OPTIONS

None.


EXAMPLES

NOTES

If the SNMP Trap destination address is not set to the server node when execute the command, the following results are output.

Target Host Nothing
SNMPTrap error

If the server node that input in the command is not registered in ESC, please re-execute the command after registering the server node.

Please execute the same action in case where the server node is not registered in ESC after deletion of the server node.