Fresh installation

This topic provides instructions for installing BMC Release Lifecycle Management 5.0 on Windows and Linux.

Before you begin

  • Download and unzip the BMC Release Lifecycle Management zip files in your preferred location.

  • Verify that your environment meets the requirements listed in the System-requirements topic and verify that you have prepared the installation environment.
    Windows:

    • Ensure that you have administrator privileges to install the solution and register the component products as services.

    Linux:

    • Ensure that you have superuser privileges to install the solution and register the component products as services.
    • Ensure that there is no Ruby Version Manager (RVM) environment in the path of the installation.
    • If your Linux environment has the DISPLAY variable set to export your display to a remote system, ensure that the remote system has an X Window server installed and configured.

    Starting with version 5.0.03, BMC has replaced the BMC Release Lifecycle Management common installer with standalone installers for BMC Release Process Management (BRPM) and BMC Release Package Deployment (BRPD) applications. For more information about installing BRPM, see Installing. For more information about installing BRPD, see Installing.

To install the solution

  1. To start the installation program:
    Windows:

    • To install product with administrator privileges, go to RLMinstallationDirectory\RLM\Disk1 and run the setup.cmd command.
    • To install product as a normal user, double-click setup.cmd.

    Linux or Oracle:

    • Log in as a root user.
    • Navigate to RLMinstallationDirectory\RLM\Disk1.
    • To make the installation file executable, run the chmod -R +x . command.
    • To start the installation program, run the ./setup.sh command.
  2. On the welcome page of the BMC Release Lifecycle Management 5.0.00 Installer wizard, click Next.
  3. On the license agreement page, select I agree to the terms of the license agreement, and then click Next.

  4. On the Directory Selection page, specify the installation directory for BMC Release Lifecycle Management 5.0.00, and then click Next.

    Note

    The directory that you select for the product installation must be empty for the installation to complete successfully.

  5. On the Installation Type page, do one of the following, and then click Next.
    • If you started the installation as a root user or administrator, select Installer is started with root privileges so perform full installation.

    • If you started the installation as a normal user, select Install solution files and configurations. Do not perform tasks that require special rights.

      Notes

      • If you are a normal user and you start the installation that requires administrator or root privileges, then the installation might not complete successfully. 
        For a successful product installation, specify the installation directory to which you have access (for example your user home directory).
      • If you start the installation as a normal user, you cannot register the component products as services (deployment engine, dispatcher, RPD API, Apache server, TorqueBox server, and the PostgreSQL database server). To do this after the installation, see instructions in the RLMhome/README_special_configuration file (where RLMhome is your installation directory).
  6. Select any or all of the following features, and then click Next.
    • Install BMC Release Process Management 5.0.00
    • Install BMC Release Package and Deployment UI 5.0.00
    • Install BMC Release Package and Deployment Engine 5.0.00
    • Install PostgreSQL
  7. (For RPD UI 5.0.00) On the deployment action packs page, select the appropriate action packs based on the middleware type that you want to manage, and then click Next.
  8. On the BMC Release Process Management data migration page, click Next.
  9. On the BMC RPM Server Instance type page, select the deployment mode for RPM:
    • To run RPM as a single instance, select Standalone.
    • To run RPM as a node in the cluster, select Cluster, and then do the following:
      1. In the Node name box, enter the name of the cluster node.
      2. In the Node IP box, enter the IP of the cluster node.
      3. Click Next.
  10. (For RPD UI 5.0.00) On the BMC Release Package and Deployment data migration page, click Next.
  11. (For RPM) On the JRE information page:
    • To Use the bundled JRE (version 1.8.0_31), click Next. 
    • To use any other JRE, clear the Use the bundled JRE (version 1.8.0_31) check box, click Browse, set the path to the JRE on your computer, and then click Next.

  12. (For RPM) On the Server HTTP/HTTPS Port Information page:

    • To use HTTP to access the RPM server, in the HTTP Port box, enter the HTTP port number, which refers to the port of the TorqueBox server (default: 8080).

    • To use the Secure Sockets Layer (SSL) to access the RPM server:

      1. Select Enable SSL.
      2. In the Private Key box, specify the directory path to the private key for SSL encryption.
      3. In the Certificate File box, specify the directory path to the certificate for SSL connection.
      4. In the Passphrase box, enter the passphrase for your certificate.

      For more information about how to obtain SSL private key, certificate file, and passphrase, see Obtaining-test-SSL-certificates.

    Click Next.

  13. (For RPD UI 5.0.00) On Server HTTP/HTTPS port information page:

    • To use HTTP to access the RPD server, in the HTTP Port box, enter the HTTP port number, which refers to the port of the Apache server (default: 80).
    • To use the Secure Sockets Layer (SSL) to access the RPD server, complete step 11 a through d.

    Note

    For a non-root installation, the HTTP Port number must be greater than 1024.

  14. On the Super User Details page, provide the superuser credentials, and then click Next.

    Notes

    • The superuser is the first user who has administrator access permissions to use the RPM and RPD products.
    • Avoid using root  and system as a login. This restriction applies only to the RPD UI component.
    • Password must be at least six characters long.

  15. (For RPM) On the TorqueBox Super User Details page, enter the user name and password, and then click Next.

    Notes

    • Login must contain numbers and letters. Avoid using root, admin, or administrator as login.
    • Password must be at least eight characters long and contain at least one letter, one number, and one special (non-alphanumeric) character.

  16. (For RPM) On the Messaging System Details page, specify the following details to connect to the messaging system server of RPM, and then click Next. 

    1. Port: (Default 5445) The port of the messaging system server.
    2. User: The user name of the messaging system server. Login must contain numbers and letters. Avoid using root, admin, or administrator as login.
    3. Password: The password of the messaging system server. Password must be at least eight characters long and contain at least one letter, one number, and one special (non-alphanumeric) character. 
    4. Confirm password: Confirmation of the password of the messaging system server.

    Note

    The Host box is populated automatically. By default, the installation program detects the IP address of the host computer on which you are installing the product.

  17. On the Database details page, specify the relevant details for the database, and then click Next.

    Notes

    • If you are using the PostgreSQL or Microsoft SQL Server database, then specify different SID names for RPM and RPD.
    • If you are using the Oracle database, then you can use the same schema but you must specify a different user name. This applies to both RPM and RPD.

    1. In the Database list, select one of the following:

      • POSTGRESQL (Default port 5432)
      • ORACLE (Default port 1521)
      • SQL_SERVER (Default port 1433)

      The Database list is dimmed if you selected Install PostgreSQL on the feature selection page.

    2. In the Host box, specify the computer name of the server where your database is installed.
      The Host box is dimmed if you selected Install PostgreSQL on the feature selection page.
    3. In the Port box, specify the port of the server that you used for installing your database. Depending on the database you specified, the default port is automatically displayed.
    4. In the RPM Database/SID Name box, do one of the following:
      • For PostgreSQL or Microsoft SQL Server, specify the name of the database instance that you used while creating it at the time of the database installation.
      • For Oracle, specify the SID details.
    5. In the RPM Database User box, specify the user name of the database instance that you used while creating it at the time of the database installation.
    6. In the RPM Database Password box, specify the password of the database instance that you used while creating it at the time of the database installation.
    7. In the RPD Database/Service Name box, do one of the following:
      • For PostgreSQL or Microsoft SQL Server, enter the name of the database instance that you used while creating it at the time of the database installation.
      • For Oracle, specify the service details.
    8. In the RPD Database User box, specify the user name of the database instance that you used while creating it at the time of the database installation.
    9. In the RPD Database Password box, specify the password of the database instance that you used while creating it at the time of the database installation.
  18. On the Email Notifications details page, do one of the following:
    • Not to configure email notifications, click Next.

    • To configure email notification settings, select Use SMTP, and then specify the following SMTP server details:

      1. SMTP Server: The fully qualified name of the SMTP server used for sending emails.
      2. SMTP Port: (Default 25) The SMTP server port.
      3. SMTP Domain: The part of the user name after "xyz@" in your email address. For example, if your user name is redmine@example.net, then your domain name is example.net.
      4. SMTP Authentication: The authentication mechanism used for your SMTP service. You can select from one of the options in the list displayed.
      5. SMTP User: The user name used to connect to the SMTP server. For example, redmine@example.net.
      6. SMTP Password: The password used to connect to the SMTP server.
      7. TLS: Select this check box if your SMTP server requires a secure connection and is using TLS.

      To learn more about email notifications and how to change notification configurations manually, see Changing email notification configuration manually.

  19. On the Installation Preview page, view the installation details, and then click Install.

Back to top

Where to go from here

To ensure that your installation is successful, follow the guidance in Verifying-the-installation.

To start or stop the product-related services, see Starting-or-stopping-product-services.

 

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