Hitachi

JP1 Version 12 JP1/Performance Management - Remote Monitor for Virtual Machine Description, User's Guide and Reference


2.6.3 For KVM

This subsection provides an example of setting up an instance environment to monitor KVM.

Organization of this subsection

(1) Assumed KVM environment

The explanation in this subsection assumes that the user has the following KVM environment:

Monitored host
  • Virtual environment software: KVM

  • Physical server host name: vm-host

  • Login user name: user01

  • Login password: None

  • Domain name: None

PFM - RM host
  • Login user name: vmuser

  • Login password: vmpass

  • Domain name: vmdomain

  • SSH client: C:\Program Files\PuTTY\plink.exe

  • Private key file: C:\Program Files\PuTTY\agt8.ppk

(2) Example of setting up an instance environment

A command execution example for setting up an instance environment follows.

C:\Program Files\Hitachi\jp1pc\tools>jpcconf inst setup -key RMVM -inst kvm1    ...1
 VM_Type            [vmware]         :kvm<Enter>        ...2
 Interval           [300]            :<Enter>           ...3
 Offset             [10]            :<Enter>            ...4
 Std_Category       [Y]              :<Enter>           ...5
 Cpu_Category       [Y]              :<Enter>           ...6
 Memory_Category    [Y]              :<Enter>           ...7
 Disk_Category      [Y]              :<Enter>           ...8
 Network_Category   [Y]              :<Enter>           ...9
 HostUserID         []               :vmuser<Enter>     ...10
 HostPassword       []               :vmpass<Enter>     ...11
                            Re-enter :vmpass<Enter>
 HostDomain         []               :vmdomain<Enter>   ...12
 SSH_Type           [putty]          :<Enter>           ...13
 SSH_Client         []               :C:\Program Files\PuTTY\plink.exe<Enter>                            ...14
 Log_Size (MB)      [16]             :<Enter>           ...15
 UseVcpuMax         [N]              :<Enter>           ...16
KAVE05080-I Creating an instance environment. (servicekey=RMVM, inst=kvm1)
KAVE05081-I An instance environment has been created. (servicekey=RMVM, inst=kvm1)
Legend:

<Enter>: Enter key must be pressed.

1 through 16: Number of the corresponding step in the setup procedure.

To set up an instance environment:

  1. Execute the jpcconf inst setup command.

    Specify any name as the instance name.

  2. Set up VM_Type.

    Enter kvm and press the Enter key.

  3. Set up Interval.

    Since the default value (300) will be used, press the Enter key without entering any value.

  4. Set up Offset.

    Since the default value (10) will be used, press the Enter key without entering any value.

  5. Set up Std_Category.

    Since the default value (Y) will be used, press the Enter key without entering any value.

  6. Set up Cpu_Category.

    Since the default value (Y) will be used, press the Enter key without entering any value.

  7. Set up Memory_Category.

    Since the default value (Y) will be used, press the Enter key without entering any value.

  8. Set up Disk_Category.

    Since the default value (Y) will be used, press the Enter key without entering any value.

  9. Set up Network_Category.

    Since the default value (Y) will be used, press the Enter key without entering any value.

  10. Set HostUserID.

    Enter vmuser as the PFM - RM host user name that is used for connection, and then press the Enter key.

  11. Set up HostPassword.

    Enter vmpass as the password for the user ID set by HostUserID, and then press the Enter key. The system will ask you to re-enter the password for confirmation purposes. Re-enter the vmpass password and then press the Enter key.

    Note:

    The entered character strings are not displayed on the screen.

  12. Set HostDomain.

    Enter vmdomain as the name of the domain that the PFM - RM host belongs to, and then press the Enter key.

  13. Set up SSH_Type.

    Since the default value (putty) will be used, press the Enter key without entering any value.

  14. Set up SSH_Client.

    Enter C:\Program Files\PuTTY\plink.exe as the executable file of the SSH command that is used for connection, and then press the Enter key.

  15. Set Log_Size.

    Since the default value (16 MB) will be used, press the Enter key without entering any value.

  16. Set up UseVcpuMax.

    Press the Enter key without entering any value because this item is not used by KVM.

(3) Example of setting up a monitoring target

The following shows an example of executing a command to set up a monitoring target.

C:\Program Files\Hitachi\jp1pc\tools>jpcconf target setup -key RMVM -inst kvm1 -target vm-host    ...1
 Target Host       []            :vm-host <Enter>     ...2
 VM_Host           []            :<Enter>             ...3
 Security          [1]           :<Enter>             ...4
 Port              [0]           :<Enter>             ...5
 UserID                          :user01<Enter>       ...6
 Password          []            :<Enter>             ...7
 Domain            []            :<Enter>             ...8
 Private_Key_File  []            :C:\Program Files\PuTTY\agt8.ppk<Enter>    ...9
KAVE05361-I The monitoring target is now being added. (servicekey=RMVM, inst=kvm1, target=vm-host)
KAVE05362-I The monitoring target has been added. (servicekey=RMVM, inst=kvm1, target=vm-host)
Legend:

<Enter>: Enter key must be pressed.

1 through 9: Number of the corresponding step in the setup procedure.

To set up a monitoring target (as in the above example):

  1. Execute the jpcconf target setup command.

    Specify vm-host, which is the host name of a physical server, as the name of a monitoring target.

  2. Set Target Host.

    Enter vm-host, which is the host name of a physical server, and then press the Enter key.

  3. Set VM_Host.

    Since the Target Host value will be used, press the Enter key without entering any value.

  4. Set Security.

    Press the Enter key without entering any value because this item is not used by KVM.

  5. Set Port.

    Since the default value (0) will be used, press the Enter key without entering any value.

  6. Set UserID.

    Enter user01 as the user name that is used for connection, and then press the Enter key.

  7. Set Password.

    Press the Enter key without entering any value because this item is not used by KVM.

  8. Set Domain.

    Press the Enter key without entering any value because this item is not used by KVM.

  9. Set Private_Key_File.

    Enter C:\Program Files\PuTTY\agt8.ppk as the name of the private key file that is used for SSH connection, and then press the Enter key.