Installing

his section provides information about installing the BMC Cloud Lifecycle Management Dashboards utility.

Supported BMC Cloud Lifecycle Management versions

You must be using BMC Cloud Lifecycle Management 3.0, 3.1, 4.0 or 4.1.

Minimum system requirements

To install BMC Cloud Lifecycle Management Dashboards your system must meet the following minimum system requirements.

Category

Minimum requirement

Operating system

One of the following:

  • Microsoft Windows 2012
  • Microsoft Windows 2008 R2
  • Microsoft Windows 2008
  • Linux RedHat 5.5
  • Linux RedHat 6.x

Note: Linux systems must have the X environment to run the BMC Cloud Lifecycle Management Dashboards installer.

Hardware

All of the following:

  • 2 CPUs
  • 4GB RAM
  • 60GB Hard disc space

Browser

Any of the following:

  • Microsoft Internet Explorer 9 or greater
  • Mozilla Firefox 26.0 or greater

Java

Java Runtime Environment 7

Additional requirements for the Health Dashboard

In addition to the minimum system requirements, ensure that the following requirements are met:

  • You are an Administrator or the root user of the computer on which you will install the Health Dashboard.
  • All BMC Cloud Lifecycle Management component products (such as BMC Remedy AR System, BMC Server Automation, and so on) are accessible from the computer on which you will install the Health Dashboard.
  • On Linux systems, ensure that you have execute permission for the jrel.7.0/bin/java directory.
  • If you are using Microsoft Internet Explorer, ensure that it is not running in Compatibility Mode.
  • BMC Server Automation Network Shell (NSH) is installed on the computer on which you will install the Health Dashboard. You can use the NSH installer bundled with your BMC Cloud Lifecycle Management installer files (and not the directory of your installed BMC Cloud Lifecycle Management solution) in the Applications\BL-NSH directory. For more information about installing NSH, see Installing only the Network Shell (Linux and UNIX) and Installing only the Network Shell (Windows).
  • BMC Server Automation NSH on the Health dashboard server and BMC Server Automation RSCD Agent on the Platform Manager must be configured to use the same port number. For example, on the Platform Manager open the C:\Windows\rsc\secure file and locate the following line: rscd:port=4750:protocol=5:tls_mode=encryption_only:encryption=tls. Now open the same file on the Health Dashboard server. The following line should have the same port number, in this example 4750: default:port=4750:protocol=5:tls_mode=encryption_only:encryption=tls.

  • The Health Dashboard server must have, at minimum, read access permission to the Platform Manager RSCD agent. For example, on Windows open the C:\Windows\rsc\exports file and locate the following line:
    * rw,user=Administrator

    Use the following command to grand read permission, where ipAddress is the IP address of the Health Dashboard:
    ipAddress r,user=Administrator

  • At any time, only one instance of the clmhealth utility (the Health Dashboard) is monitoring BMC Cloud Lifecycle Management.
  • If you have downloaded the HealthDashBoards-installer.zip file on a Windows computer and transferred it to a Linux computer, ensure that you have execute permission for the bundled jre-1.7.0 folder on that Linux computer.

Additional requirement for the Value Dashboard

Ensure that JRE_HOME is in your system PATH variable.

To install the Health Dashboard

  1. Download the HealthDashboards-installer.zip file from BMC Communities to the computer on which you want to install the Health Dashboard.  
  2. Unzip the HealthDashboards-installer.zip file.

  3. Do one of the following:

     

    Environment

    Steps

    Windows

    Double-click the HealthDashboards-installer.jar file.

    The CLM Health Dashboards screen appears

    Linux

    Start the X graphical environment, and then enter the following command:
    java -jar HealthDashboards-installer.jar

    The CLM Health Dashboards screen appears.

  4. Click Next.
     The End User License Agreement screen appears.
  5. Select I accept the terms of this license agreement, and then click Next.
    The Java Installation Path screen appears.
  6. Enter the path for Java Runtime Environment (such as C:\Program Files\Java\jre7), and then click Next.
    The Dashboards Installation Path screen appears.

  7. Enter the installation path (such as C:\Program Files\BMC Software\CLMHealth for Windows, and /opt/bmc for Linux), and then click Next. If the path does not exist, you are prompted to accept that the directory will be created.

    Note

    For Linux installations the path must not contain spaces.

    The Server Configuration screen appears.

  8. Enter the port numbers used to start up and shutdown the Health Dashboards server, then click Next.
    A validation screen appears.

    Note

    If you are installing the Health Dashboard and the Value Dashboard in the same computer, you must specify different port numbers for each Dashboard.

  9. When validation has completed, click Next.
    The Processing screen appears, showing the progress of the installation.
  10. When processing has completed, click Next.
    The Installation Completion screen appears.
  11. Click Done.
  12. Wait for the server to start, and then wait 15 minutes for the server to collect data.

To install the Value Dashboard

  1. Download the CLMDashboards-installer.zip file from BMC Communities to the computer on which you want to install the Value Dashboard. 
  2. Unzip the CLMDashboards-installer.zip file.

  3. Do one of the following:

    Environment

    Steps

    Windows

    Double-click the CLMDashboards-installer.jar file.

    The CLM Value Dashboards screen appears

    Linux

    Start the X graphical environment, and then enter the following command:
    java -jar CLMDashboards-installer.jar

    The CLM Value Dashboards screen appears.

  4. Click Next.
     The End User License Agreement screen appears.
  5. Select I accept the terms of this license agreement, and then click Next.
    The Java Installation Path screen appears.
  6. Enter the path for Java Runtime Environment (such as C:\Program Files\Java\jre7), and then click Next.
    The Dashboards Installation Path screen appears.

  7. Enter the installation path (such as C:\Program Files\BMC Software\CLMDashboards for Windows, and /opt/bmc/ for Linux), and then click Next. If the path does not exist, you are prompted to accept that the directory will be created.

    Note

    For Linux installations the path must not contain spaces.

    The AR Host Machine Details screen appears.

  8. Enter the following information about the Enterprise AR System and Cloud AR System computers used in your BMC Cloud Lifecycle Management installation, and then click Next:

    Notes

    You must have Administrator rights to the BMC Remedy AR System Servers.

    If the Enterprise AR System and Cloud AR System are on the same computer, you do not need to enter information for the Cloud AR System.

    Field

    Description

    Host Name

    Name of the BMC Remedy AR System server.

    User

    BMC Remedy AR System user name required to access the server. This user must be a BMC Remedy AR System administrator.

    Password

    BMC Remedy AR System password required to access the server.

    Port No

    Port number used to access the server. If you installed BMC Remedy AR System without the port mapper integration, enter a number in the range 1024-49151. If you installed the port mapper integration, enter 0.

    The Server Configuration screen appears.

  9. Enter the port numbers used to start up and shutdown the Value Dashboards server, then click Next.
    A validation screen appears.

    Note

    If you are installing the Health Dashboard and the Value Dashboard in the same computer, you must specify different port numbers for each Dashboard.

  10. When validation has completed, click Next.
    The Processing screen appears, showing the progress of the installation.
  11. When processing has completed, click Next.
    The Installation Completion screen appears.
  12. Click Done.
  13. Wait for the server to start, and then wait 15 minutes for the server to collect data.

To use an existing Tomcat server for the Value Dashboard

  1. Do one of the following to set a new -D parameter for the Tomcat server, referencing the location of the BMC Cloud Lifecycle Management configuration.properties file:

    Platform

    Steps

    Windows

    a. In the Control Panel, open the System pane.

    b. Click Advanced System Settings.
    The Advanced tab of the System Properties dialog box opens.

    c. Click Environment Variables.
    The Environment Variables dialog box opens.

    d. Under System Variables, click New.
    The New System Variable dialog box opens.

    e. In the Variable Name field, enter JAVA_OPTS.

    f. In the Variable Value field, enter -DdashboardProperties=path_to_configuration.properties_file

    g. In the New System Variable dialog box, click OK.

    h. In the Environment Variables dialog box, click OK.

    i. In the System Properties dialog box, click OK.

     

    Linux

    Enter the following command:
    export JAVA_OPTS="-DdashboardProperties=path_to_configuration.properties_file"

  2. Locate the dashboards.war file in your Value Dashboard installation directory.
  3. Copy the dashboards.war file to the webapps folder of your existing Tomcat installation.
  4. Update the configuration.properties file of your BMC Cloud Lifecycle Management installation.
  5. Stop and then restart the Tomcat server.

To uninstall the Value Dashboard

  1. Navigate to the the installationDirectory\Uninstaller folder.
  2. Double-click the uninstaller.jar file.

 

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