Hitachi

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


2.6.4 For Docker environment

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

Organization of this subsection

(1) Assumed Docker environment

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

Monitored host
  • Virtual environment software: Docker environment

  • Physical server host name: docker-host

  • Port number: 2376

PFM - RM host
  • Login user name: vmuser

  • Login password: vmpass

  • Domain name: vmdomain

(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 docker1      ...1
 VM_Type          [vmware]        :docker<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       []              :<Enter>             ...14
 Log_Size (MB)    [16]            :<Enter>             ...15
 UseVcpuMax       [N]             :<Enter>             ...16
KAVE05080-I Creating an instance environment. (servicekey=RMVM, inst=docker1)
KAVE05081-I An instance environment has been created. (servicekey=RMVM, inst=docker1)
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 docker 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 up HostUserID.

    Enter the PFM - RM host's vmuser user name to be used for connection and 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 vmpass and then press the Enter key.

    Note:

    The entered character strings are not displayed on the screen.

  12. Set up 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.

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

  14. Set up SSH_Client.

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

  15. Set up Log_Size.

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

  16. Set up UseVcpuMax.

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

(3) Example of setting up monitoring targets

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 docker1 -target docker-host    ...1
 Target Host      []         : docker-host <Enter>    ...2
 VM_Host          []         :<Enter>                 ...3
 Security         [1]        :<Enter>                 ...4
 Port             [0]        :2376<Enter>             ...5
 UserID           []         :<Enter>                 ...6
 Password         []         :<Enter>                 ...7
 Domain           []         :<Enter>                 ...8
 Private_Key_File []         :<Enter>                 ...9
KAVE05361-I The monitoring target is now being added. (servicekey=RMVM, inst=docker1, target=docker-host)
KAVE05362-I The monitoring target has been added. (servicekey=RMVM, inst=docker1, target=docker-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:

  1. Execute the jpcconf target setup command.

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

  2. Set Target Host.

    Enter docker-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.

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

  5. Set Port.

    Enter a port number of Docker environment and press the Enter key.

  6. Set UserID.

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

  7. Set Password.

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

  8. Set Domain.

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

  9. Set Private_Key_File.

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