Fresh installation

This topic provides instructions for installing BMC Release Package and Deployment version 4.4 on Microsoft Windows and Linux.

Before you begin

Ensure that you have Administrator privileges (on Windows) or superuser privileges (on Linux) to install this solution in the Program Files directory (on Windows) and register the component products as services.
Note
You can install this solution as a normal user without Administrator privileges (on Windows) or superuser privileges (on Linux), but without these privileges you cannot register the component products as services or install the solution in the Program Files directory (on Windows).
Refer to the <RLM_HOME>/README_special_config.txt file for more information on how to register and start/stop services for the non-root installation.
Verify that your environment meets the requirements listed in the System-requirements topic and verify that you have prepared the installation environment.
If you are installing the BMC Release Package and Deployment solution on any Linux platform, ensure that there is no rvm environment in the path of the installation.
Download and unzip the BMC Release Package and Deployment zip files in your preferred location.
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.
If you are installing the suite as a part of an upgrade, make a backup of your database to protect it from any issues that may occur during the upgrade.

To install the solution

Start the installation program:

Windows:
- If you are installing the product with administrator privileges:
  1. Enter the setup.cmd (BRLM\Disk1) command.
  2. From the menu, right-click setup.cmd, and click Run as administrator.
- If you are installing the product as a normal user, double-click setup.cmd.
Linux:

1. Log on as root and navigate to BRLM/Disk1.
2. Enter the chmod -R +x . command.
3. Enter the ./setup.sh command.
On the first page of the BMC Release Lifecycle Management 4.4.00 Installer wizard, click Next.
On the license agreement page, select I agree to the terms of the license agreement, and then click Next.
The Directory Selection page is displayed as shown in the following image:
To perform a fresh installation, provide the directory path for installing this suite by clicking Browse, and then click Next.

Note
The directory that you select for the product installation must be empty for the installation to complete successfully.
On the Installation Type page, select the appropriate option for installing as either a root user or a normal user, and then click Next.
- Installer is started with root privileges so perform full installation: Installs the solution as an administrator or root user
- Install solution files and configurations. Do not perform tasks that require special rights: Installs the solution as a normal user
  Note
  - If you are a normal user without administrator or root privileges and if you still select the first option, then 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 suite as a normal user without administrator or root privileges, but you cannot register the component products—deployment engine, dispatcher, RPD API, Apache server, Torquebox server, and the PostgreSQL database server—as services. However, you can register those components later. To do this, see the instructions in the <RLM_HOME>/README_special_configuration file (where RLM_HOME is your installation directory).
Select any or all of the following features, and then click Next:
- Install BMC Release Process Management 4.4.0: Installs version 4.4.00 of the BMC Release Process Management product
- Install BMC Release Package and Deployment UI 4.4.0: Installs version 4.4.00 of the BMC Release Package and Deployment product
- Install BMC Release Package and Deployment Engine 4.4.0: Installs the deployment engine for the BMC Release Package and Deployment product
- Install PostgreSQL: Installs version 8.4.10-1 of the PostgreSQL database along with the BMC Release Process Management and the BMC Release Package and Deployment component products. If you have already installed the database, you can choose to not install it at this point.
If you selected Install BMC Release Package and Deployment UI 4.4.0 in the preceding step, the deployment action packs page is displayed. It lists the action packs for the various types of middleware objects.
Select action packs based on the middleware type that you want to manage, and then click Next.
If you selected Install BMC Release Process Management on the feature selection page, the BMC Release Process Management migration page is displayed. Since you are performing a fresh installation of BMC Release Lifecycle Management products, do not enter any information on this page. For more information about upgrading, see Performing-the-upgrade.
If you selected Install BMC Release Package and Deployment UI 4.4.0 on the feature selection page, the BMC Release Package and Deployment migration page is displayed. Since you are performing a fresh installation of BMC Release Lifecycle Management products, do not enter any information on this page. For more information about upgrading, see Performing-the-upgrade.
On the JRE information page, choose whether to use the bundled Java Runtime Environment (JRE) for installation of BMC Release Process Management. To use the bundled JRE, select the Use the bundled JRE (version 1.7.0_09) check box. To use any other JRE, click Browse and set the path to where the JRE is located on your computer, and then click Next.
If installing BMC Release Process Management, on the Server HTTP/HTTPS Port Information page for BMC Release Process Management specify the appropriate details for BMC Release Process Management (shown as BRPM). Specify details regarding the HTTP port, which refers to the port of the TorqueBox server (default port: 8080). If you are already using the default port, then you must specify an alternate port, and then click Next.
(Optional) You can also enable SSL settings for your TorqueBox server by selecting the Enable SSL check box. If you enable your SSL settings, then you must specify the HTTPS port (default: 8443), as well as the private key, certificate file, and passphrase.

Note
The passphrase is used to set up the Java keystore. For more information, see Obtaining-test-SSL-certificates.
If installing BMC Release Package and Deployment, on Server HTTP/HTTPS port information page for BMC Release Package and Deployment specify appropriate details for the port used by BMC Release Package and Deployment. The HTTP port refers to the port of the Apache server (default port: 80). If you are already using the default port, then you must specify an alternate port, and then click Next.
(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, then you must specify the HTTPS port (default: 443), as well as the private key, certificate file, and passphrase.

Note
If in step 4 you selected a non-root installation, then the HTTP Port number that you specify must be greater than 1024.
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 BMC Release Process Management and BMC Release Package and Deployment component products. You can choose to use the default details, provide the password, and then click Next. You can also choose to add your own details. The first 3 fields (First Name, Last Name, and Email) are specific to the installation of BMC Release Process Management.

Login: Avoid using 'root' and '_system' as a login (Note that this restriction applies only to BMC Release Package and Deployment UI component).
Password: Password must be at least 6 characters long.
If installing BMC Release Process Management, on the Torquebox Super User Details screen enter the password for the Torquebox super user:

Login: Login must contain numbers and letters. Avoid using root, admin, or administrator as login.
Password: Password must be at least 8 characters long, and contain at least 1 letter, 1 number, 1 special (non-alphanumeric) character.
Confirm password: Confirmation of the password of the messaging system server.
If installing BMC Release Process Management, on the Messaging System Details page specify the following details to connect to the messaging system server of the BMC Release Process Management component product, and then click Next.

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

Note
The Host field is disabled. By default, the installation program detects the IP address of the host computer on which you are installing this product.
Depending on which products you selected to install on the feature selection page, on the Database details page specify the relevant details for the database that you want to use for the BMC Release Process Management and BMC Release Package and Deployment component products and then click Next.
Note
- If you are using the PostgreSQL or the SQL Server database, then specify different SID names for the BMC Release Process Management and the BMC Release Package and Deployment component products.
- 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 component products, BMC Release Process Management and BMC Release Package and Deployment.
- Database: You can select one of the following options from the list. As you select databases, the default port is automatically displayed.
  - POSTGRESQL (Default port 5432)
  - ORACLE (Default port 1521)
  - SQL_SERVER (Default port 1433)
    If at the feature selection screen you selected Install PostgreSQL, then the Database and Host fields appear dimmed.
- Host: Specify the computer name of the server where your database is installed. If at the feature selection screen you selected Install PostgreSQL, then the Host field appears dimmed.
- Port: Specify the port of the server that you used for installing your database. Depending on the database you selected earlier, the default port is automatically displayed.
- RPM Database/SID Name: If you selected POSTGRESQL or SQL_SERVER on the list displayed for the Database field, then specify the name of the database instance that you used while creating it at the time of the database installation. If you selected ORACLE on the list displayed for the Database field, then specify the SID details. This information relates only to the BMC Release Process Management component product.
- RPM Database User: Specify the user name of the database instance that you used while creating it at the time of the database installation. This information relates only to the BMC Release Process Management component product.
- RPM Database Password: Specify the password of the database instance that you used while creating it at the time of the database installation. This information relates only to the BMC Release Process Management component product.
- RPD Database/Service Name: If you selected POSTGRESQL or SQL_SERVER on the list displayed for the Database field, then specify the name of the database instance that you used while creating it at the time of the database installation. If you selected ORACLE on the list displayed for the Database field, then specify the service details. This information relates only to the BMC Release Package and Deployment component product.
- RPD Database User: Specify the user name of the database instance that you used while creating it at the time of the database installation. This information relates only to the BMC Release Package Deploymen component product.
- RPD Database Password: Specify the password of the database instance that you used while creating it at the time of the database installation. This information relates only to the BMC Release Package Deploymen component product.
  
  Warning
  If you selected the No migration required option for either BMC Release Process Management or BMC Release Package and Deployment, all product data is removed from the database during the installation.
On the Email Notifications details page, specify whether you want to configure email notification settings for the solution or not and then click Next. Select the No Email Notifications option if you do not want to configure email notification settings. Select the Use SMTP option and then specify the following Simple Mail Transfer Protocol (SMTP) server details for the configuration of email notification settings by using the SMTP service.
- SMTP Server: The fully qualified name of the SMTP server used for sending emails.
- SMTP Port: (Default 25) The SMTP server port.
- SMTP Domain: The part of the user name after "xyz@" in your email address. For example, if your username is redmine@example.net, then your domain name is example.net.
- SMTP Authentication: The authentication mechanism used for your SMTP service. You can select from one of the options in the list displayed.
- SMTP User: The user name used to connect to the SMTP server. For example, redmine@example.net.
- SMTP Password: The 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.
  
  Note
  If you selected Copy other settings too (SMTP configuration etc.) for the migration of BMC Release Process Management, the Email Notifications Details page is not displayed.
  The SMTP server details from the previous version will be used.
  To learn more about email notifications and how to change notification configurations manually, see Changing-email-notification-configuration-manually.
The Installation Preview page is displayed. This page displays the various details of your installation before the installation starts, including installation location, features selected, and total disk space that will be used. Click Next to start the installation.
(Optional): To see the installation log, click View Log.

Where to go from here

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

To start or stop product-related services, see the following topics:

Fresh installation

Before you begin

To install the solution

Where to go from here

On this page