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.
- 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.
To install the product
- 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:
- Log in as a root user, and navigate to RLM/Disk1.
- To make the installation file executable, run the following command: chmod -R +x .
- To start the installation program, run the following command: ./setup.sh .
- On the welcome page of the BMC Release Lifecycle Management installation wizard, click Next.
- On the license agreement page, select I agree to the terms of the license agreement, and click Next.
On the Directory Selection page, provide the directory path for installing this solution, and click Next.
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.
Click Next.
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.
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.
- 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. On the data migration page, click Next.
(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.
- 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.
(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.
- 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. 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.
- Database: Select one of the following options from the list.
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.
- 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.