Installing the Real End User Experience Monitoring Software Edition silently

Where you are in the Installation process

Note

BMC Real End User Experience Monitoring Software Edition version 11.0.00.002 is the latest version of the component and is compatible with TrueSight Operations Management versions 11.3.01 and later.

The server-silent-options-linux file is used to configure the Real End User Experience Monitoring Software Edition silent installation.

This file is located in the Disk1 directory of the Real End User Experience Monitoring Software Edition installation file structure.


Notes

  • If you are planning to install the Real User Analyzer component, you must have an activation key file from BMC Customer Support. You will need this file to complete the installation of the Real User Analyzer. 
  • You must have an encrypted user password for the Real User Analyzer and Collector silent installation.

Encrypting a password for silent Real End User Experience Monitoring Software Edition installation

The Maintenance Tool enables you to create an encrypted password that the Real User Analyzer and Collector installation process requires for importing a keystore. You must use an encrypted password so that the KeyStore password is not exposed in the server-silent-options.txt file.

You can run the Maintenance Tool in a GUI or from the command line interface (CLI).

To encrypt a password by using the Maintenance Tool in a GUI (click here to expand steps)
  1. To open the Maintenance Tool, go to the temporaryDirectory/Disk1/utility directory.
    The temporaryDirectory is the place where you downloaded the installation files.
  2. Run the EuemMaintenanceTool utility 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 server-silent-options-linux.txt file for the collector_password, analyzer_password, and -confirm_password parameter.
    For example, if the encrypted password output is DES\:d70cbe3669602717ce66af37cce7ecf0, modify the collector_password parameter as follows:
    -J collector_password=DES\:d70cbe3669602717ce66af37cce7ecf0
To encrypt a password by using the Maintenance Tool in the CLI (click here to expand steps)
  1. To open the Maintenance Tool, go to the temporaryDirectory\Disk1\utility directory.
    The temporaryDirectory is the place to which you downloaded the installation files.

  2. Run the following command, entering your password for the -password and -confirm_password options. For example:

    {{code language="none"}}
    ./EuemMaintenanceTool.sh -silent -encrypt -encrypt -password=security -confirm_password=security

    {{/code}}

    Note

    For Linux installations, any password that includes special characters requires single quotation marks before and after the password. For example:

    ./EuemMaintenanceTool.sh -silent -encrypt -encrypt -password='$123456$' -confirm_password='$123456$'
  3. Copy and paste the encrypted password output to the server-silent-options-linux.txt file for your silent installation.
    For example, if the encrypted password output is DES\:d70cbe3669602717ce66af37cce7ecf0, modify the collector_password parameter as follows:
    -J collector_password= DES\:d70cbe3669602717ce66af37cce7ecf0

To configure the silent installation file

On the system where you want to install the Real User Analyzer and Collector, complete the following procedure:

  1. Use a text editor to open the server-silent-options-linux file.

  2. Use the default installation directory or enter a new directory for the installation:

    -P installLocation=/opt/bmc/euem

  3. (Optional) To prevent the Analyzer or Collector installation, add a # symbol to beginning of the relevant line.

    -A featureEuemAnalyzer
    -A featureEuemCollector 

  4. Verify the configuration information and change the port numbers, disk space, or amount of RAM for the Analyzer or Collector, if required.
    Ensure that the port numbers you enter are available.

    -J analyzer_logrotate_dir=/etc/logrotate.d
    -J euem_hostname=
    -J max_memory=

    -J analyzer_activation_key_file_path=
    -J analyzer_company_name_for_activation=

    -J analyzer_http_port=80
    -J analyzer_https_port=443
    -J analyzer_shutdown_port=8005
    -J analyzer_sessions_port=22033
    -J analyzer_pages_port=22032
    -J analyzer_objects_port=22031
    -J analyzer_username=
    -J analyzer_password=
    -J analyzer_confirm_password=
    -J analyzer_database_port=3306
    -J analyzer_data_disk_space=570
    -J analyzer_optional_ram=

    -J collector_http_port=8080
    -J collector_https_port=8443
    -J collector_shutdown_port=8004
    -J collector_username=
    -J collector_password=
    -J collector_confirm_password=
    -J collector_database_port=5432
    -J collector_data_disk_space=28
    -J collector_optional_ram=


    -J snmp_port=161
    -J snmp_active=false

    -J demo_mode=false

     Silent installation file field descriptions

    Parameter

    Description

    euem_hostname

    The host address is the Fully Qualified Domain Name, host name, virtual IP, or public IP address for the machine where the component is installed. This host address is used when a component generates a link to itself (e.g., within mailouts).
    This is a mandatory parameter. The installation will fail if this parameter is not entered.

    max_memory

    (Optional) The maximum amount of physical memory (GB) available to the installed components
    If the amount of physical memory is not set for the Analyzer and Collector, this field sets the maximum amount of memory available for these components.
    If none of the memory options (analyzer_optional_ram, collector_optional_ram, max_memory) are set, the maximum amount of memory available for these components is the total amount of physical memory available on the system, up to 24 GB per component.

    analyzer_activation_key_file_path

    If you are installing the Real User Analyzer, enter the path to the activation key file that you received from BMC Customer Support.
    If you do not have an activation key file, you can use the Real User Analyzer for a 30-day trial period by entering the Trial in this field.
    For example: -J analyzer_activation_key_file_path=Trial
    Note: Contact BMC Customer Support to receive an activation key file for the Real User Analyzer.

    analyzer_company_name_for_activation

    The company name must match the name that is in the activation key file you received from BMC Customer Support.
    If you do not have an activation key file, you can use the Real User Analyzer for a 30-day trial period by entering your company's name.

    analyzer_http_port

    Port numbers for the Real User Analyzer

    analyzer_https_port

    analyzer_shutdown_port

    Port number to close the Real User Analyzer service port

    analyzer_sessions_port

    Port number for the Real End User Experience Monitoring Performance Analytics Engine (PAE) sessions

    analyzer_pages_port

    Port number for the Real End User Experience Monitoring PAE session pages

    analyzer_objects_port

    Port number for the Real End User Experience Monitoring PAE page objects

    analyzer_username

    User name to access the Real User Analyzer

    analyzer_password

    anayzer_confirm_password

    Password to access the Real User Analyzer

    You must enter an encrypted password.

    analyzer_database_port

    Port number for the Real User Analyzer PostgreSQL database

    analyzer_logrotate_dir

    Location for the log rotate directory

    analyzer_data_disk_space_size

    Maximum disk space allowed for the Real User Analyzer data
    The disk space size must be 100–570 GB.

    analyzer_optional_ram

    (Optional) The maximum amount of physical memory (GB) available to the Real User Analyzer
    The amount of physical memory must be 7–24 GB.
    If this setting is not used, the max_memory setting is used for the amount of physical memory.

    collector_http_port

    Port numbers for the Real User Collector

    collector_https_port

    collector_shutdown_port

    Port number to close the Real User Collector service port

    collector_username

    User name to access the Real User Collector

    collector_password

    collector_confirm_password

    Password to access the Real User Collector

    You must enter an encrypted password.

    collector_database_port

    Port number for the Real User Collector PostgreSQL database

    collector_data_disk_space

    Maximum disk space allowed for the Real User Collector data
    The minimum disk space size must be 20–100 GB.

    collector_optional_ram

    (Optional) The maximum amount of physical memory available to the Real User Collector
    The amount of physical memory must be 7–24 GB.
    If this setting is not used, the max_memory setting is used for the amount of physical memory.

    snmp_port

    Port number for the SNMP service. The default SNMP port number can be changed, if necessary.

    snmp_active

    Change to true to enable SNMP.
    Post-installation, you can enable SNMP for the Real User Analyzer or Collector. 

    demo_mode

    (Optional) Installs the Real User Analyzer and Collector in Demo mode that only uses 10 GB of disk space for data and 2.5 GB of physical memory
    This mode is only used for a system Proof of Concept (POC) installation.
    Change to true to enable the Demo mode.

  5. Save and close the server-silent-options-linux.txt file.

To install the Real End User Experience Monitoring Software Edition silently

  1. In a command line, navigate to the Disk1 folder in the installation file structure.

  2. Enter the following command:

    ./setup.bin -i silent -DOPTIONS_FILE=<Full File Path>/server-silent-options-linux.txt

Notes

  • The Real User Analyzer and Collector installation euem_install_log.txt log file is located in the /tmp folder.

To verify the Real End User Monitoring Software Edition installation

You can verify that a Real User Analyzer or Collector component instance was installed successfully by opening a supported browser and entering the host and port address that you used during the installation process. If the component is installed, the log on screen will appear in the browser's window.

Real End User Experience Monitoring log on

EUEM_log_on_screen.png

The host address is the Fully Qualified Domain Name, host name, virtual IP, or public IP address for the machine where the component is installed.  

You can also see an installation success message at the end of the euem_install_log.txt installation log file. This file includes any warnings or errors that might have occurred during the component installation process, and a new log is created each time you install the program. The default location for this file that is in the system's /tmp folder.  Additionally, if you used the Real End User Experience Monitoring Software Edition installation wizard, you can see the installation log file's location in the wizard's Installation Summary page. You can also use the Maintenance Tool to view each log.

Next Step in the Installation process

Step 7 Phase B — Now that you have successfully installed Real End User Experience Monitoring Software Edition, you must install Cloud Probe.

 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*