Fresh installation

This topic provides instructions for installing BMC Release Package and Deployment (RPD) 5.0 on Windows and Linux.

Before you begin

• Download and unzip the RPD ZIP files in the preferred location.
• Ensure that you have prepared the installation environment, and verify that your environment meets the requirements listed in the System requirements topic.
• Before installing RPD 5.0.x with the Microsoft SQL Server database, restart your system.
• If installing is part of an upgrade, back up your database to safeguard against any issues in the upgrade.

Windows:

• • Ensure that you have administrator privileges. You can install the product as a normal user without administrator privileges, but then you cannot register the product as a service. For more information on how to register and start/stop services for the non-root installation, refer to the RLMhome/README_special_config.txt file.

Linux:

• • Ensure that you have superuser privileges. You can install the product as a normal user without superuser privileges, but then you cannot register the product as a service.
    For more information on how to register and start/stop services for the non-root installation, refer to the RLMhome/README_special_config.txt file.
  • Ensure that there is no Ruby Version Manager (RVM) environment in the installation path.
  • If your Linux environment has the DISPLAY variable set to export the display from a remote system, ensure that the remote system has the X Windows Server installed and configured.

To install the product

1. Start the installation program:
   Windows:

• • To install the product with administrator privileges, navigate to RLMinstallationFolder\RLM\Disk1, and run the following command: setup.cmd.
  • To install the product as a normal user, double-click setup.cmd.
• Linux:

1. 1. Log in as a root user, and navigate to RLM/Disk1.
   2. To make the installation file executable, run the following command: chmod -R +x .
   3. To start the installation program, run the following command: ./setup.sh .
2. On the welcome page of the BMC Release Lifecycle Management installation wizard, click Next.

3. On the license agreement page, select I agree to the terms of the license agreement, and click Next.

4. On the Directory Selection page, provide the directory path for installing this solution, and click Next.

   Note

   To complete the installation successfully, the directory for the product installation must be empty.

5. On the Installation Type page, select the appropriate option:

   • Installer is started with root privileges so perform full installation: Installs the solution as an administrator or a root user.

   • Install solution files and configurations. Do not perform tasks that require special rights: Installs the solution as a normal user.

     Notes

     • If you are a normal user without administrator or root privileges, and you select the first option, your 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 select the second option, you can install the solution as a normal user without administrator or root privileges, but you cannot register the product components as services. Therefore, the services related to the deployment engine, dispatcher, RPD API, Apache server, and PostgreSQL database server may not start automatically after you restart the computer. However, you can register these components later. To do this, see instructions in the RLMhome/README_special_configuration file (where RLM_HOME is your installation directory).
   Click Next.
6. On the features selection page, select the needed features:
   
   • Install BMC Release Package and Deployment UI version: Installs the 5.0 version for RPD.

   • Install BMC Release Package and Deployment Engine version: Installs the deployment engine for RPD.

     Note

     If during fresh installation of RPD you select the Install BMC Release Package and Deployment Engine version option, the following services are installed automatically:

     • Engine
     • API
     • Dispatcher

   • Install PostgreSQL: Installs the following versions of the PostgreSQL database along with the RPD components. If you have already installed the database, you can choose to not install it at this point.

     RPD version	PostgreSQL version
     5.0.02, 5.0.01	9.5.5
     5.0.00	8.4.10-1

   Click Next.

7. If you have selected Install BMC Release Package and Deployment UI version in the preceding step, the features selection page is displayed. It lists action packs for various types of middleware objects.
   Select action packs based on the middleware type that you want to manage, and click Next.

8. On the data migration page, click Next. 

   Note

   Because you are performing a fresh installation of RPD, do not enter any information on this page. For more information about upgrading, see Upgrading.

9. (Optional) If you install the product application files and do not make any changes to the database, in the Cluster Installation section, ensure that the Skip database modification check box is selected.

   Note

   You can use the Skip database modification option if you install BMC Release Process Management to a node in a cluster, and you already have installed the same version of the application and database on another node of the same cluster.

10. On the Server HTTP/HTTPS Port Information page, specify the appropriate details for the port used by RPD. The HTTP port refers to the port of the Apache server (the default port is 80). If you are already using the default port, you must specify an alternate port, and click Next.

11. (Optional) You can also choose to enable SSL settings for your Apache server by selecting the Enable SSL check box. If you enable your SSL settings, you must specify the HTTPS port (the default port is 443), as well as the private key, certificate file, and passphrase.

    Note

    If in step 5 you select a non-root installation, the HTTP port number that you specify must be greater than 1024.

12. On the Super User Details page, provide the super user credentials. The super user is the first user who has administrator access permissions to use the RPD product components. You can use the default details, or add your own details, and click Next. 
    Login: Avoid using 'root' and '_system' as a login.
    Password: Password must be at least 6 characters long.

13. Depending on what products you have selected to install on the features selection page, on the Database Details page, specify the relevant details for the database that you want to use for RPD:

    • Database: Select one of the following options from the list. 

      • POSTGRESQL (the default port is 5432)

      • ORACLE (the default port is 1521)
      • SQL_SERVER (the default port is 1433)
    • Host: Specify the computer name of the server where your database is installed. If on the features selection page you have selected Install PostgreSQL, the Host field appears dimmed.
    • Port: Specify the port number used by your database on the server. Depending on the database that you have selected earlier, the default port is automatically displayed.
    • RPD Database/Service Name: Specify the name of the database instance that you used during the database installation for the POSTGRESQL or SQL_SERVER databases. For the ORACLE database, specify the service details. This information relates only to RPD.
    • RPD Database User: Specify the user name of the database instance that you used during the database installation. This information relates only to RPD.
    • RPD Database Password: Specify the password of the database instance that you used during the database installation. This information relates only to RPD.
    Click Next.

14. On the Email Notification Details page, specify whether you want to configure email notification settings for the solution or not:

    • No Email Notifications: Select if you do not want to configure email notification settings.
    • Use SMTP: Select to configure email notification settings, and then specify the following Simple Mail Transfer Protocol (SMTP) server details:
      • SMTP Server: Fully qualified name of the SMTP server used for sending emails.
      • SMTP Port: SMTP server port (the default port is 25).
      • SMTP Domain: Part of the user name after "xyz@" in your email address. For example, if your username is redmine@example.net, your domain name is example.net.
      • SMTP Authentication: Authentication mechanism used for your SMTP service. You can select one of the options from the list.
      • SMTP User: User name used to connect to the SMTP server. For example, redmine@example.net.
      • SMTP Password: Password used to connect to the SMTP server.
      • TLS: Select this check box if your SMTP server requires a secure connection and is using TLS.
    Click Next.
15. On the Installation Preview page, verify the details of your installation, such as installation path, selected features, and total disk space that will be used, and click Install.

Where to go from here

To ensure that your installation completed successfully, follow the guidance in Verifying the installation.

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

To roll back the changes after the failed installation, see Rolling back after the failed installation or upgrade.