Upgrading in a new folder

This topic explains how to upgrade (or migrate) your installed version of BMC Release Lifecycle Management Suite to the latest 4.8 version in a new folder.

You can upgrade to BMC Release Lifecycle Management Suite 4.8 starting from 4.4 version.

Note

You can use the BMC Release Lifecycle Management full installer to upgrade its component products (BRPM and BRPD) only if you installed them together using the full installer. If you installed BRPM and BRPD using standalone installers, you cannot upgrade with the full installer. The exception is when you installed BMC Release Lifecycle Management Suite, and then you upgraded BRPM or BRPD with standalone installers.

When you perform the upgrade (or migration) in a new folder, the new installation does not replace the product files related to the older version. You can upgrade in one of the following ways:

By migrating the database from the earlier to new version
By using a fresh database for the latest version

To perform a silent upgrade of the BMC Release Lifecycle Management Suite, follow the steps described in Silent-installation. To learn more about options that you can specify in a silent upgrade options file, see Silent-installation-properties.

Before you begin

Download and extract the BMC Release Lifecycle Management zip files in your preferred location.
Verify that your environment meets the system requirements and verify that you have prepared the installation environment.
Warning
Notes
- Backup your database in case of any issues with the product upgrade.
- Before you migrate the product database to a new version, stop the BMC Release Process Management server.
Windows:
- Ensure that you have the administrator privileges to install and register the product as a service.
Linux:
- Ensure that you have superuser privileges to install and register the product as a service
- 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.

To upgrade (or migrate) to the latest version of suite products

Start the installation program:
Windows:
- To install the product with the administrator privileges, go to BRLMinstallationDirectory\BRLM\Disk1 and run the setup.cmd command.
- To install the product as a normal user, double-click setup.cmd.
Linux:
1. Log in as a root user.
2. Navigate to BRLMinstallationDirectory \RLM\Disk1.
3. To make the installation file executable, run the chmod -R +x . command.
4. To start the installation program, run the ./setup.sh command.
On the welcome page of the BMC Release Lifecycle Management 4.8.00 Installer wizard, click Next.
On the license agreement page, select I agree to the terms of the license agreement, and then click Next.
On the Directory Selection page, specify a new installation directory for BMC Release Lifecycle Management 4.8.00, and then click Next.
Warning
Note
For the installation to complete successfully, the directory that you select for the product installation must be empty.
On the Installation Type page, do one of the following, and then click Next.
- If you started the installation program with administrator or root privileges, select Installer is started with root privileges so perform full installation.
- If you started the installation program without administrator or root privileges, select Install solution files and configurations. Do not perform tasks that require special rights.
  Warning
  Note
  If you are a normal user without administrator or root privileges, yet 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 start the installation as a normal user, you cannot register the component products as services. Therefore, the services related to the deployment engine, dispatcher, Apache server, TorqueBox server, and PostgreSQL database server are not started automatically after the restart of your computer. To register the component products as services after the installation, see instructions in the BRLMhome/README_special_configuration.txt file (where BRLMhome is your installation directory).
On the feature selection page, select the products and components that you want to upgrade, and then click Next.
- Install BMC Release Process Management 4.8.00
- Install BMC Release Package and Deployment UI 4.8.00
- Install BMC Release Package and Deployment Engine 4.8.00
- Install PostgreSQL
(For BRPD UI 4.8.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.
Warning
Note
If you modified any of your action packs, they are not updated with fixes from BMC. To avoid this, before the upgrade, delete the scripts that you modified. If after the upgrade your action scripts are still not modified, delete the unmodified scripts and execute the run loadpacks <pack name> command from the RLMhome/releases/4.8.00/RPD directory.
On the BRPM data migration page, specify the details for migrating your database to version 4.8.00, and then click Next.
1. In the Copy data from list, select your current version of BRPM.
2. In Existing installation location, enter the directory path to your current version of BRPM.
  For example, C:\Program Files\BMC Software\RLM\releases\4.4.01.08\RPM.
3. In Database migration:
  - To save your data from the existing database and update the database to version 4.8.00.x, select Update database.
  - To delete your data from the existing database and update the database to version 4.8.00.x, select Clean database.
4. (Optional) Select the Copy SMTP configuration settings check box if you want to copy your email notification settings to version 4.8.00.
  Warning
  Note
  If you select Copy SMTP configuration settings, then the Email Notifications Details page does not appear. The SMTP server then uses details from theprevious installed version.
On the BMC RPM Server Instance type page, select the deployment mode for BRPM:
- To run BRPM as a single instance, select Standalone.
- To run BRPM 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 address of the cluster node.
  3. Click Next.
(For BRPD UI 4.8.00) On the BRPD data migration page, specify the following upgrade details, and then click Next.
1. In the Copy data from list, select your current version of BRPD.
2. In Existing installation location, enter the directory path to your current version of BRPD.
  For example, C:\Program Files\BMC Software\RLM\releases\4.4.01.08\RPM.
3. In Database migration:
  - To save your data from the existing database and update the database to version 4.8.00.x, select Update database.
  - To delete your data from the existing database and update the database to version 4.8.00.x, select Clean database.
(For BRPM) On the TorqueBox Super User Details page, enter the user name and password for the TorqueBox superuser, and then click Next.
(For BRPM) On the Messaging System Details page, specify the following details to connect to the messaging system server, and then click Next.
1. Port: (Default 5445) Represents the port of the messaging system server.
  The Host box is dimmed. By default, the installation program detects the IP address of the host computer on which you are installing this product.
2. User: Represents the user name of the messaging system server. Login must contain numbers and letters. Avoid using root, admin, or administrator as login.
3. Password: Represents 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.
4. Confirm password: Confirmation of the password of the messaging system server.
On the Database details page, specify the following details for the database that you want to use for BRPM and BRPD, and then click Next.
Warning
Note
- Depending on which products you selected to upgrade, several parts of the Database Details page may be dimmed.
- If you are using the PostgreSQL or the SQL Server database, then specify a different schema for BRPM and BRPD.
- If you are using the Oracle database, then you can use the same schema, but you must specify a differentuser name. This applies to both BRPM and BRPD.
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 that you specified, the default port is automatically filled in.
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.
Error
Warning
If you selected No migration required for either BRPM or BRPD, all product data is removed from the database during the installation.
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.
  Warning
  Note
  If you selected Copy SMTP configuration settings on the BMC Release Process Management Migration information page, the Email Notifications Details page is not displayed. The SMTP server details from the previous version will be used.
On the Installation Preview page, view the installation details, and then click Next.

After the upgrade

After a successful upgrade, perform the following action depending on your operating system:

(Windows) Ensure that the startup settings for your BMC Release Process Management server (earlier version) is set to Manual.

(Linux) Remove links from the etc\init.d location by running the following commands with a root login ID.

rm --rf /etc/rc0.d/K02bmcrpm
rm --rf /etc/rc1.d/K02bmcrpm
rm --rf /etc/rc3.d/S98bmcrpm
rm --rf /etc/rc4.d/S98bmcrpm
rm --rf /etc/rc5.d/S98bmcrpm
rm --rf /etc/rc6.d/K02bmcrpm

Also, remove these links from the /etc/rc0.d directory:

K02bmcrpm-4.3.01
K02bmcrlmqengine-4.3.01
K02bmcrpmhornetq-4.3.01
K15bmcrlmapache-4.3.01

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: