HomeConfiguring AgentVMWare & Xenserver
VMWare & Xenserver

The Agent will use the Config file for :

  • Configuring the device key to determine the Nodelizer – Server device – with which your server’s metrics will be associated.
  • Additional settings for VMWare Credentials like – server, username, password … etc
  • Optional settings like – Logging level and Log file location … etc

The location of the config file is :

  • For VMWare platform
    • /etc/rptmonitor/config.cfg
  • For XenServer platform If Control Domain VM OS is a …
    • deb/rpm package supported Linux distro:
      • /etc/rptmonitor/config.cfg
    • Linux distro that does not support deb/rpm package or is a FreeBSD8+ OS :
      • /usr/local/bin/rptmonitor/config.cfg
Basic configuring :-
Required
  • device_key : The device key as unique identifier for server is provided in the Web app under the Manage Servers menu in Device Key column beside ‘IP Address’… In-case of manual installation, fill in your device_key for server identification. (Also check out below for optional parameters if you wish to configure.)
    device_key: abCd4F5gh
  • For VMWare

    Fill in values for variables – vmware_server, vmware_usrnm, vmware_pswd. Uncomment the lines containing these variables (remove # symbol). You can also customize port if not running the default, through vmware_port config variable.

    vmware_server: localhost (or hostname of server)

    vmware_usrnm: vmwareUserName

    vmware_pswd: p@5$w07d

    vmware_port: 443 custom port for connection(Default – 443)

    NOTE : In VMWare, save changes in config file using commands :

    • chmod +t config.cfg
    • /sbin/auto-backup.sh
  • For XenServer

    Fill in values for variables – xen_server, xen_usrnm, xen_pswd. Uncomment the lines containing these variables (remove # symbol). You can also customize port if not running the default, through xen_port config variable.

    xen_server: localhost (or hostname of server)

    xen_usrnm: vmwareUserName

    xen_pswd: p@5$w07d

    xen_port: 443 custom port for connection(Default – 443)

    Restart rptmonitor service, after editing the config file.

    • In VMWare system :
      • /etc/init.d/rptmonitor restart
    • In XenServer system If Control domain VM OS is a..
      • deb/rpm package supported Linux distro:
        • sudo /etc/init.d/rptmonitor restart
        • OR
        • sudo service rptmonitor restart
      • Linux distro that does not support deb/rpm package, or is a FreeBSD 8+ OS :
        • sudo python /usr/local/bin/rptmonitor/monitor.py restart
Optional (make sure you restart the agent after editing config file)
  • # Set postdata preference

    Secure HTTP Connection(https) will be established by default while posting data. To switch to http, specify the value for variable ‘https_conn’ as no or false.

    # Set postdata preference

    https_conn: yes

  • # Set logging level

    The agent will log warnings and errors by default but if the agent is not reporting data for any particular metric then you can set log_level to debug mode which will log all the details to be helpful in troubleshooting. Available log level options are : debug, info, warn, error.

    #log_level: info

    To

    log_level: info

    or

    log_level: debug

  • # Log file location

    Uncomment this option and change the directory location if you wish to save your logs in another location.

    #logfile_directory: /var/log/rptmonitor/

    to

    logfile_directory: /var/log/rptmonitor/

    • Default location for VMWare :

      /var/log/rptmonitor/

    • Default location for XenServer If Control Domain VM OS is a..

      • deb/rpm package supported Linux distro:

        /var/log/rptmonitor/

      • Linux distro that does not support deb/rpm package, or is a FreeBSD 8+ OS :

        /tmp/

  • # Pid file location

    pidfile_directory :- Default location to save PID file:

    #pidfile_directory: /var/run/rptmonitor/

    to

    pidfile_directory: /var/run/rptmonitor/

    Default location for VMWare :

    /var/run/rptmonitor/

    Default location for XenServer If Control Domain VM OS is a..

    • deb/rpm package supported Linux distro:

      /var/run/rptmonitor/

    • Linux distro that does not support deb/rpm package, or is a FreeBSD 8+ OS :

      /tmp/

Default location for logs

The agent, by default, will log data at info level which also includes warnings and errors but if the agent is not reporting data for any metric then you can set log_level to debug mode which will log all the details.

#log_level: info

To

log_level: info

or

log_level: debug

The log file (in debug mode)contains valuable data about the agent’s parsing actions which can be helpful in troubleshooting.

  • log level options: debug, info, warn, error.