Page tree

Before you begin

Before you install the Cloud Probe, ensure that the following requirements are fulfilled:

 

Tip

For best results capturing end-user performance data, install the Cloud Probe on the host that provides load balancing services for an application. By binding the public interface used by the load balancing services, end-user transactions can be accurately measured and processed.

To encrypt the password for silent installations

The Maintenance Tool enables you to create an encrypted password. You must use an encrypted password to set up a silent installation, so that the system password is not exposed in the cloudprobe-silent-option file.

You can run the Maintenance Tool in a GUI or from the command line.

  1. To open the Maintenance Tool, go to the Disk1\utility directory.
  2. Run the ./CloudProbeMaintenanceTool.sh file and click the Encrypt tab.
  3. Enter your password in the Password and Confirm Password fields and click Encrypt.
  4. Copy and paste the value from the Encrypted Password field to the cloudprobe-silent-option file for your silent installation.
    For example, if the encrypted password output is DES\:d70cbe3669602717ce66af37cce7ecf0, modify the real_user_collector_password property as follows:
    -J real_user_collector_password=DES\:d70cbe3669602717ce66af37cce7ecf0
  1. To open the Maintenance Tool, go to the Disk1\utility directory.
  2. Run the following command, entering your password for the -password and -confirm_password options:
    ./CloudProbeMaintenanceTool.sh -silent -encrypt -encrypt -password=<password> -confirm_password=<password>

     

    If the password contains special characters, put it into quotation marks. For example:

    ./CloudProbeMaintenanceTool.sh -silent -encrypt -encrypt -password=”<password>” -confirm_password=”<password>”

  3. Copy and paste the output to the cloudprobe-silent-option file for your silent installation.
    For example, if the encrypted password output is DES\:d70cbe3669602717ce66af37cce7ecf0, modify the real_user_collector_password property as follows:
    -J real_user_collector_password=DES\:d70cbe3669602717ce66af37cce7ecf0

To define properties and run the silent installation on Linux

Warning

Changing the value of properties that are not specifically mentioned in this procedure might have unexpected results.

  1. Log in to the virtual machine as root.
  2. From the Disk1 directory, open the cloudprobe-silent-option file in a text editor.
  3. Enter an installation directory for the installLocation property.
    By default, the following directory is entered:
    -P installLocation=/opt/bmc/CloudProbe
  4. Enter the following values to connect to the Real User Collector:

    -J real_user_collector_ip_address=<ipAddress>
    -J real_user_collector_port=443
    -J real_user_collector_username=<userName>
    -J real_user_collector_password=<encryptedPassword>
    • <ipAddress> represents the IP address or DNS name of the Collector.
    • The default value of the real_user_collector_port property is 443.
    • <userName> represents the user name to log in to the Collector.
    • <encryptedPassword> represents an encrypted version of the password used to log in to the Collector.
  5. Enter the name of the Cloud Probe.

    -J cloud_probe_name=<cloudProbeName>

    <cloudProbeName> represents the name displayed in the Real User Collector. The name can have up to 60 alphanumeric characters, hyphens (-), and underscore characters (_).

  6. Enter the name of the network interface card (NIC) to use for capturing traffic.

    -J cloud_probe_network_card=<networkCard>

    You can run the ifconfig command to see a list of the network cards and enter the value of the one you want to monitor. Network card names are in the following form: eth0, eth1, eth2.

  7. Save and close the cloudprobe-silent-option file.
  8. In the Disk1 directory, run the following command to run the installation file:
    ./setup.sh -i silent -DOPTIONS_FILE=cloudprobe-silent-option
  9. If you use encrypted traffic, configure the SSL keys for traffic decryption.

Following the installation, the Cloud Probe starts automatically. You access the Cloud Probes page through the Real User Collector console. Point to Administration > Integration, and click Cloud Probes.

To define properties and run the silent installation on Windows

  1. Log in to the windows machine as Administrator
  2. From the Disk1 directory, open the cloudprobe-silent-option file using a text editor.
  3. Enter an installation directory for the installLocation property.
    By default, the following directory is provided:
    -P installLocation= C:\Program Files (x86)\BMC Software\CloudProbe
  4. Enter the following values to connect to the Real User Collector:

    • The IP address or DNS name of the Real User Collector.
    • Real User Collector port (default value is 443).

    • The user name to log in to the Collector.

    • Encrypted version of the password used to log in to the Real User Collector.



    Example
    -J real_user_collector_ip_address=<ipAddress>
    -J real_user_collector_port=443
    -J real_user_collector_username=<userName>
    -J real_user_collector_password=<encryptedPassword>

     

     

  5. Provide the display name for the Cloud Probe instance. The name can have up to 60 alphanumeric characters, hyphens (-), and underscore characters (_).

     

    Example
     -J cloud_probe_name=<cloudProbeName>
  6. Enter the name of the monitored network card to be used for capturing traffic.


     

    Example
     -J cloud_probe_network_card=<networkCardName>

    Tip

    Use getmac /v command to get the network card name. The network card name appears in the Network Adapter column. For example: Intel(R) 82579L

  7. Save and close the cloudprobe-silent-option file.
  8. In the \Disk1 directory, run the following command to run the installation file:

    Command
    ./setup.sh -i silent -DOPTIONS_FILE=cloudprobe-silent-option
  9. If you use encrypted traffic, configure the SSL keys for traffic decryption.

    Following the installation, the Cloud Probe instance starts automatically. Find your Cloud Probe instance in the list and ensure it processes traffic data.

Where to go from here

Verify the Real User Cloud Probe installation.

Modify the configuration with the Real User Cloud Probe Maintenance Tool.

Configure confidentiality policies on the Cloud Probe

Configure traffic filtering rules on the Cloud Probe 

Related topics

Starting and stopping the Real User Cloud Probe
Troubleshooting the Real User Cloud Probe

Managing SSL keys and settings for Cloud Probe traffic decryption
 

 

-J real_user_collector_ip_address=<ipAddress>

-J real_user_collector_port=443

-J real_user_collector_username=<userName>

-J real_user_collector_password=<encryptedPassword>

1 Comment

  1.