Configuring Users for VM Monitoring

In order to enable the eG agent to connect to VMs in multiple domains and pull out metrics from them, the eG administrative interface provides a special page using which the different domain names, and their corresponding admin user names and admin passwords can be specified. To access this page, just click on the encircled '+' button alongside the admin user parameter of any of the test configuration pages. 

Figure 1 : Configuring a sample AHV test

Upon clicking, Figure 2 will appear, using which the VM user details can be configured.

Figure 2 : The VM user configuration page

To add a user specification, do the following:

  1. First, provide the name of the Domain to which the VMs belong (see Figure 2). If one/more VMs do not belong to any domain, then, specify none here.

  2. The eG agent must be configured with user privileges that will allow the agent to communicate with the VMs in a particular domain and extract statistics. If none is specified against Domain, then a local user account can be provided against Admin User. On the other hand, if a valid Domain name has been specified, then a domain administrator account can be provided in the Admin User text box. If key-based authentication is implemented between the eG agent and the SSH daemon of a Linux guest, then, in the Admin User text box, enter the name of the user whose <user_home_dir> (on that Linux guest) contains a .ssh directory with the public key file named authorized_keys. The Admin Password in this case will be the passphrase of the public key; the default public key file that is bundled with the eG agent takes the password eginnovations. Specify this as the Admin Password if you are using the default private/public key pair that is bundled with the eG agent to implement key-based authentication. On the other hand, if you are generating a new public/private key pair for this purpose, then use the passphrase that you provide while generating the pair. For the detailed procedure on Implementing Key-based Authentication refer to Troubleshooting the Failure of the eG Remote Agent to Connect to or Report Measures for Linux Guests.

  3. The password of the specified Admin User should be mentioned in the Admin Password text box.

  4. Confirm the password by retyping it in the Confirm Password text box.

  5. To add more users, click on the Add More button in Figure 2. This will allow you to add one more user specification as depicted by Figure 3.

    Figure 3 : Adding another user

  6. In some virtualized environments, the same Domain could be accessed using multiple Admin User names. For instance, to login to a Domain named chn, the eG agent can use the Admin User name egadmin or the Admin User name eguser. You can configure the eG agent with the credentials of both these users as shown by Figure 4.

    Figure 4 : Associating a single domain with different admin users

  7. When this is done, then, while attempting to connect to the domain, the eG agent will begin by using the first Admin User name of the specification. In the case of Figure 4, this will be egadmin. If, for some reason, the agent is unable to login using the first Admin User name, then it will try to login again, but this time using the second Admin User name of the specification - i.e., eguser in our example (see Figure 4).  If the first login attempt itself is successful, then the agent will ignore the second Admin User name.

  8. To clear all the user specifications, simply click the Clear button in Figure 4.

  9. To remove the details of a particular user alone, just click the button in Figure 4.

  10. To save the specification, just click on the Update button in Figure 4. This will lead you back to the test configuration page, where you will find the multiple domain names, user names, and passwords listed against the respective fields (see Figure 5).

Figure 5 : The test configuration page displaying multiple domain names, user names, and passwords