ServerView agents maintenance after the installation

3.5.1 The srvmagt script

Once you have installed the ServerView agents for Linux, as described in

"Installation via ServerView Suite DVD 2" on page 45or in"Installation from a directory" on page 46, further functions are provided for maintenance via the srvmagt script.

1. Open a terminal (as root) 2. Enter the command, see syntax.

Syntax

[/usr/sbin/]srvmagt [option] [action]

For option you can specify:

-f

Forces the intended action against an issued warning/rejection.

In that case you act on your own risk and responsibility. The behavior and functionality is undefined.

-h | --help

Displays the command syntax and exits.

-n

Does not start any ServerView agents' daemon during installation with the install action.

-p <path>

Here you can specify the directory containing the RPM packages.

<path> is a path to a directory in a local or remote file system.

The path option must not contain spaces or special characters.

-R

Installs the ServerView RAID Manager RPM package, if it is supplied together with the other RPM packages.

--ssm install | not-install

Determines the installation of local ServerView System Monitor and the ServerView System Monitor Web Interface. Default is to install both packages.

This option is only evaluated on Red Hat, SUSE and Oracle Linux systems.

-v <vers>

Indicates the version to handle. Default is the version of the script.

--version

Prints the script version and exits.

-V

Prints verbose information.

For action you can specify:

install

Installs (repairs, updates) all ServerView agents Linux RPM packages according to the already installed configuration and the version supplied with the -v option. The corresponding services (i.e. daemons) are started afterwards unless the -n option is also given.

start

Starts ServerView agents Linux.

restart

Restarts ServerView agents Linux.

status

Shows status of ServerView agents Linux.

diag

Collects diagnostic material by calling PrimeCollect(8).

stop

Stops ServerView agents Linux.

3.5 ServerView agents maintenance after the installation

3 Installing ServerView agents

remove

Removes all ServerView agents Linux RPM packages.

If the operating system is Citrix XenServer, the ServerView RAID package is also removed at the same time.

3.5.2 Configuring agents

The file /etc/srvmagt/config contains information which enables you to restrict access to the managed system and select other operating parameters.

Lines that begin with the "#" sign are comment lines and the other lines have the following format:

<keyword>=<value>

AgentPermission Basic permission for other systems to set values on the local server with the help of SNMP commands (2: not allowed, 3:

allowed, default: 2 (default for Japanese OS environment:

3)). If you want to permit SNMP SetRequests you must set the value to 3 here and configure the SNMP services appropriately (see"Configuring SNMP services" on page 28).

AgentShut Permission for remote shutdown/reboot of the local server using SNMP commands (2: not allowed, 3: allowed, default:

2, i.e. not allowed (default for Japanese OS environment:

3)). If you want to permit SNMP SetRequests you must set the value to 3 here and configure the SNMP services appropriately (see"Configuring SNMP services" on page 28).

ShutdownDelay Indicates the time delay (in minutes) between an SNMP shutdown request and the shutdown.

NoAccountCheck If a value other than 0 is specified for this entry, you are not prompted for a password when you modify settings via ServerView. The default value is 0, i.e. the user group authentication is enabled by default. In this case a user group must be entered under UserGroup, to which the user that wishes to change the SNMP settings must belong.

Please note that a deactivated password query can pose a considerable security risk.

UserGroup If 0 was specified for NoAccountCheck, Operations Manager requires a user/password combination on the management station in order for the SNMP settings to be changed. In order for a user to be granted access permission, the user must belong to the user group specified for UserGroup. The default setting is bin, which includes root. (The default setting for Japanese OS environment is svagtuser.) If the user group specified here does not exist, it must be created using operating system-specific resources.

ScanTapeDevices If this is set to something other than zero, the tape devices /dev/nst* are opened in order to get their current status. The opening of the tape device might cause (depending on the driver) an unintentional change of its read/write position. If the tape device is shared among servers, this parameter makes sure that Operations Manager do not impact tape operations (e.g. backup) by state queries. The default is zero, i.e. tape devices are not opened.

TraceFileLimit Controls the size of the trace files stored under

/var/log/srvmagt (1 is the default value, required space approx. 200 MB, 0 means no trace files, 2 means extra large trace files approx. 400 MB).

3.5 ServerView agents maintenance after the installation

3 Installing ServerView agents

InventoryRescan Specifies the time period (in minutes) within which the inventory data of the server is updated. Supported values are: 0, 120...34560. The value 0 disables the update. Values between 1 and 120 are set to 120. Values greater than 34560 are set to 0. The default value is 120 (The default value for Japanese OS environment is 0).

Note that changes made to the config file will only take effect on restarting the agent. You can do this by restarting the server or by entering the following command as the system administrator:

/usr/sbin/srvmagt restart Citrix Xen or Xen

To support the performance and threshold manager for Citrix Xen or Xen in the ServerView Operations Manager, it is necessary to configure account information for the system within ServerView VME agent. In order to do so, the following steps are necessary:

1. Edit the file /etc/srvmagt/VME/etc/app.config.xml.