Top
Systemwalker Service Quality Coordinator User's Guide
Systemwalker

3.2.3 Settings for Monitoring Servers

Steps for setting the monitoring server are described below.

  1. Definition method

  2. Setup

3.2.3.1 Definition method

Define in the following order:

3.2.3.1.1 Creating a connection account configuration file

When using VMware ESX/Hyper-V/Red Hat Virtualization function (Xen)

Define the settings for telnet/ssh communication between the monitoring server and the monitored server.
Edit the connection account configuration file (remoteAccount.txt).

Refer to "3.1.3.1.1 Connection account configuration file" for setting details.

When using VMware ESXi

Define the settings for https communication between the monitoring server and the monitored server.

Edit the connection account configuration file (remoteAccount.txt).

Storage location

The file is stored in the following location:

Windows

<variable file storage directory>\control\remoteAccount.txt

UNIX

/etc/opt/FJSVssqc/remoteAccount.txt

Edit the above file using the definition method described below.


Definition method

This is an ini format file.

Set the sections by connection account groups for communication between the monitoring server and the monitored server.

The method of definition depends on the communication method. Edit to match the communication method.

  1. No

    Item

    Mandatory/optional

    Format

    Description

    -

    [ACCOUNT]

    Mandatory

    63 characters or fewer, using alphanumerics, hyphens (-), periods (.), and hash symbols (#) only

    Use an account group name for the section name.

    Make it so that the section name is a unique character string.

    1

    CONNECTTYPE

    Mandatory

    HTTPS

    Set the connection method when connecting to the VMware ESXi.

    Set to "HTTPS" as this is for https connection.

    2

    USER

    Mandatory

    63 characters or fewer
    The following characters cannot be used:
    \/[];:|<>+=,?*@.

    Set the login account for connection.

    3

    PASSWORD

    Mandatory

    Character string generated with genpwd (*1)

    Set the password for connection.

    *1: Refer to "A.6 genpwd (password encryption command)" for details about how to use the genpwd command to generate encrypted passwords.

Example of definition

The following is an example of definitions when using VMware ESXi.

[ESXi-Account1]

CONNECTTYPE=HTTPS

USER=httpsuser

PASSWORD=C5sJGBE3ONs=


3.2.3.1.2 Creating remote monitoring configuration file

Define the settings for the virtual server.
Edit the remote monitoring configuration file (remoteAgent.txt).

File storage location

Windows

<variable file storage directory>\control\remoteAgent.txt

UNIX

/etc/opt/FJSVssqc/remoteAgent.txt


File format

ini file format


Setup items

Set sections for each server to be monitored.

No

Item

Mandatory/optional

Format

Description

-

[HOSTNAME]

Mandatory

63 characters or fewer, using alphanumerics, hyphens (-), periods (.), and hash symbols (#) only

Set an optional section name as the section name.
Make it so that the section name is a unique character string.
It is recommended to use the host name.

1

HOSTNAME

Mandatory

63 characters or fewer, using alphanumerics, hyphens (-), periods (.), and hash symbols (#) only

Specify the IP address or host name used for connection to the monitored server.

2

DISPLAYNAME

Any

63 characters or fewer, using alphanumerics, hyphens (-), periods (.), and hash symbols (#) only

Specify the host name displayed in the SQC console.
* HOSTNAME becomes the host name if this is not specified.

3

VMTYPE

Any

VMWARE

ESXI
HYPERV
XEN

Type of virtual server of the monitored host.

VMWARE: VMware ESX

ESXI: VMware ESXi
HYPERV: Hyper-V
XEN: With the Red Hat virtualization function (Xen)

4

ACCOUNT

Mandatory

63 characters or fewer, using alphanumerics, hyphens (-), periods (.), and hash symbols (#) only

Specify a connection account for communicating with the monitored server.
Specify the section name of the user group set in remortAccount.txt (Connection account configuration file).

5

CONNECTION

Any

ON or OFF

Set ON/OFF for monitoring.
Specify "OFF" to stop monitoring.
* Set to "ON" if this is not specified.


Example of definition

The following is an example of definitions if the virtual server is a VMware ESX, VMware ESXi, Hyper-V, or Red Hat Virtualization function (Xen) server

# If the monitoring server is a VMware ESX server:
[192.168.1.1]
HOSTNAME=192.168.1.1
DISPLAYNAME=vmware-host1
VMTYPE=VMWARE
ACCOUNT=SSH-ACCOUNT1


# If the monitoring server is a VMware ESXi server:
[192.168.1.2]

HOSTNAME=192.168.1.2

DISPLAYNAME=esxi-01

VMTYPE=ESXI

ACCOUNT=ESXi-Account1


# If the monitoring server is a Hyper-V server:
[host2]
HOSTNAME=host2
VMTYPE=HYPERV
ACCOUNT=TELNET-ACCOUNT2

# When the monitoring server is a Red Hat Virtualization function (Xen) server and is not to be monitored:
[xen-host3]
HOSTNAME=192.168.1.3
DISPLAYNAME=host3
VMTYPE=XEN
ACCOUNT=SSH-ACCOUNT3
CONNECTION=OFF


3.2.3.2 Setup

Refer to "A.1 Server Resource Information Collection Policy Creation Command" and execute sqcRPolicy and sqcSetPolicy.

Point

Perform a check of the text entered into the definitions files during setup. Start the service to check that connection can be made to the monitored server. Warning messages are output to the event log when performance information collection is executed on monitored servers that cannot be connected. Refer to Section 5.1, "Common Messages" in the Reference Guide and take the steps described.

If definitions files (Connection account configuration file and remote monitoring configuration file) have errors, monitored servers that have the errors will not be managed.
When sqcSetPolicy is executed, the following message is output for monitored servers that have been excluded from management due to errors in the definition.

(Warning) : <Install-less Agent> ignored section name[section name]

The section name defined in "remote monitoring configuration file" is output to "section name".


The following message is also output if any errors are found in a definitions file.

(Warning) : <Install-less Agent> There is an error in definition.
Please confirm the file (file name).

The following is output to "file name".

Windows

<variable file storage directory>\log\setpolicy_error.log

UNIX

/var/opt/FJSVssqc/setpolicy_error.log


If this message appears, check the file content, correct the definitions files (Connection account configuration file and remote monitoring configuration file) according to the message in the file, and then setup again. Refer to Section 1.1.3, "sqcSetPolicy (Policy Application Command)" in the Reference Manual for details about messages output to the file.

Note that collection policy setup must be passed to the console. Refer to Section 1.2.2.3, "Agents" in the User's Guide (Console Edition) and use the Agent Settings window to collect configuration information.

Note

  • It takes about 15 to 20 minutes for this information to appear in the console's "UnregisteredAgents folder" after starting the Manager/Proxy Manager service.
    If it does not appear, look in the Manager/Proxy Manager's event log/syslog to see if a message has been output.

  • It is necessary to create directories and files (needed to carry out monitoring) on the server to be monitored when managing with an agent for Agentless Monitoring.
    Directories and files are created in the following location:

    • If the monitored server is a Hyper-V:

      • When communicating by telnet

        %USERPROFILE%\SQC_TEMP directory

        %USERPROFILE% : Path name of the user profile folder

    • If the server to be monitored is a VMware or Red Hat Virtualization function (Xen) server:

      Home directory of the user

    The created directory name is as follows:

    dsa_temp_***

    Do not delete the above directory during monitoring. Performance information will not be collected if this directory is deleted. If this directory is deleted by accident, restart the Manager/Proxy Manager service.

    Delete the above directory to exclude the server from monitoring.