The following sections explain the commands for managing the operating environment.
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
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.
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.
Changes user information.
Deletes user information.
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
Registering user information
"C:\Program Files\ETERNUS-SSC\Agent\bin\defusr" -a key1 user pass
Changing user information
"C:\Program Files\ETERNUS-SSC\Agent\bin\defusr" -r key1 user pass
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
Displays the current setting information.
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
Displaying Agent information
"C:\Program Files\ETERNUS-SSC\Agent\bin\setagtip"
Setting the Agent IP address to 10.12.13.14
"C:\Program Files\ETERNUS-SSC\Agent\bin\setagtip" -i 10.12.13.14
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.
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
SNMP Trap is transmitted from the server node agent of IP address 11.11.11.11.
"C:\Program Files\ETERNUS-SSC\Agent\bin\traptest" 11.11.11.11
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.