Configuring a connection to the RHEVM server

To configure a connection to the RHEVM server, you must run the script and respond to prompts.

Before you begin

  1. Download the security certificate that is available at the following path: http://[RHEVM-IP]/ovirt-engine/services/pki-resource?resource=cacertificate&format=X509-PEM-CA

    Depending on the browser, the certificate is either downloaded or imported into the browser's Keystore.

    • If the browser downloads the certificate: Save the file as rhvm.cer
    • If the browser imports the certificate: Export it from the browser's certification options and save it as rhvm.cer
  2. Use the keytool utility to import the security certificate file to generate a local keystore file:

    keytool -import -alias ALIAS -file CERTIFICATE_FILE -keystore
    KEYSTORE_FILE

    Example keytool -import -alias RHEVM36vmwt9 -file hjs495-vmw-t-9.cer
    -keystore RHEVM36KeyStore

    Where
    ALIAS
    A unique reference for each certificate that is added to the certificate truststore of the agent, for example, an appropriate alias for the certificate from datasource.example.com is datasource.
    CERTIFICATE_FILE
    The complete path and file name to the data source certificate that is being added to the truststore.
    KEYSTORE_FILE
    The name of the keystore file that you want to specify.
    Tip: The keytool utility is available with Java™ Runtime Environment (JRE). The keystore file is stored at the same location from where you run the command.
  3. Ensure that the user, who connects to the RHEVM, is an administrator with the SuperUser role. Use can use an existing user ID with this role, or you can create a new user ID by completing the steps that are mentioned in Creating a user and granting required permissions.

Procedure

  1. On the command line, run the following command:

    install_dir/bin/linux_kvm-agent.sh config instance_name

    Example /opt/ibm/apm/agent/bin/linux_kvm-agent.sh config instance_name

    Where
    instance_name
    The name that you want to give to the instance.
    install_dir
    The path where the agent is installed.
  2. Respond to the prompts and specify values for the configuration parameters.

    For information about the configuration parameters, see Configuration parameters to connect to the RHEVM server.

  3. Run the following command to start the agent:

    install_dir/bin/linux_kvm-agent.sh start instance_name

    Example /opt/ibm/apm/agent/bin/linux_kvm-agent.sh start instance_name

What to do next

Log in to the Cloud APM console to view the data that is collected by the agent in the dashboards. For information about using the Cloud APM console, see Starting the Cloud APM console.

If you need help with troubleshooting, see the Troubleshooting section.