Installing Service Pack 1

This topic provides instructions for installing the BMC Release Lifecycle Management Service Pack 1 solution on Microsoft Windows and Linux. This solution includes the following component products:

• BMC Release Process Management 4.3.01
• BMC VaraLogix Q Deployment Automation 4.3.01

This topic contains the following sections:

• Before you begin
• To install the solution
• Where to go from here

Before you begin

• If you plan to run multiple versions of BMC Release Process Management side-by-side, perform the preparatory steps described in Running different versions of BMC Release Process Management concurrently.

• 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.

  Warning

  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).

• 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 Lifecycle Management solution on any Linux platform, ensure that there is no rvm environment in the path of the installation.
• Download and unzip the BMC Release Lifecycle Management 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 installing as part of an upgrade, back up your database to safeguard against any issues in the upgrade.

To install the solution

1. 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. 
   
   1. Log on as root and navigate to BRLM/Disk1.
   2. Enter the chmod -R +x . command.
   3. Enter the ./setup.sh command.
2. On the first page of the BMC Release Lifecycle Management 4.3.01 Installer wizard, click Next.

3. 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:
   
   Directory selection
   (Click the image to expand it)
   
   
   
   

   
   

4. To perform a fresh installation, provide the directory path for installing this solution by clicking Browse, and then click Next.

   Warning

   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, 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
     
     

     Warning

     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.
     • 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 component products as services. This means the services related to the deployment engine, dispatcher, Apache server, Tomcat server, Hornetq messaging server, and the PostgreSQL database server are not started automatically when restarting your computer.

6. Select any or all of the following features (see the figure that follows the list of features), and then click Next:

   • Install BMC Release Process Management: Installs version 4.3.01 of the BMC Release Process Management product
   • Install Varalogix Q Deployment Automation UI: Installs version 4.3.01 of the BMC VaraLogix Q Deployment Automation product
   • Install VaraLogix Q Deployment Engine: Installs the deployment engine for the BMC VaraLogix Q Deployment Automation product
   • Install PostgreSQL: Installs version 8.4.10-1 of the PostgreSQL database along with the BMC Release Process Management and the BMC VaraLogix Q Deployment Automation component products. If you have already installed the database, you can choose to not install it at this point.

   Feature selection
   (Click the image to expand it)
   
   

7. If you selected Install Varalogix Q Deployment Automation UI 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.
   
   Deployment action packs information
   (Click the image to expand it)
   
   

8. If you selected Install BMC Release Process Management on the Feature Selection page, the BMC Release Process Management Migration Information page is displayed. Specify the appropriate details for the upgrade and database migration of BMC Release Process Management, and then click Next. If you do not want to upgrade (that is, you want to perform a fresh installation), do not enter any information on this page. For more information about upgrading, see Performing-the-upgrade.

   BMC Release Process Management Migration Information
   (Click the image to expand it)
   
   

9. If you selected Install Varalogix Q Deployment Automation UI on the Feature Selection page, the BMC VaraLogix Q Deployment Automation Migration Information page is displayed. Specify the appropriate details for the upgrade and database migration of BMC VaraLogix Q Deployment Automation, and then click Next. If you do not want to upgrade (that is, you want to perform a fresh installation), do not enter any information on this page. 
   
   BMC VaraLogix Q Deployment Automation Migration information
   (Click the image to expand it)
   
   
10. 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. 
    
    JRE information
    (Click the image to expand it)
    
    

11. If installing BMC Release Process Management, on the BMC Release Process Management HTTP/HTTPS Port Information page 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 Tomcat server (default port: 8080). If you are already using the default port, then you must specify an alternate port, and then click Next. 
    You can also enable SSL settings for your Tomcat 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.
    
    

    Warning

    Note

    The passphrase is used to set up the Java keystore. For more information, see Obtaining-test-SSL-certificates.

    BMC Release Process Management HTTP/HTTPS port information
    (Click the image to expand it)
    
    

12. If installing BMC Varalogix Q Deployment Automation, on the BMC VaraLogix Q Deployment Automation HTTP/HTTPS port information page specify appropriate details for the port used by BMC VaraLogix Q Deployment Automation. 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. 
    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.
    
    

    Warning

    Note

    If in step 4 you selected a non-root installation, then the HTTP Port number that you specify must be greater than 1000.

    
    BMC VaraLogix Q Deployment Automation HTTP/HTTPS port information
    (Click the image to expand it)
    
    

13. On the Super User Details page, provide super user details. The super user is the first user who has administrator access permissions to use the BMC Release Process Management and BMC VaraLogix Q Deployment Automation 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. 
    
    

    Warning

    Note

    • If you selected the Update database option on the BMC VaraLogix Q Deployment Automation Migration page, the data that you enter on the Super User Details page relate only to the installation of the BMC Release Process Management component product.
    • If you selected the Update database option on the BMC Release Process Management Migration page, the data that you enter on the Super User Details page relate only to the installation of the BMC VaraLogix Q Deployment Automation component product.
    • If you selected to update the database for both suite products, the Super User Details page is not displayed.

    Super user information
    (Click the image to expand it)
    
    

14. 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 1099) Represents the port of the messaging system server.
    User: Represents the user name of the messaging system server.
    Password: Represents the password of the messaging system server.
    
    

    Warning

    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.

     

    Messaging system details
    (Click the image to expand it)
    
    

15. Depending on which products you selected to upgrade 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 VaraLogix Q Deployment Automation component products and then click Next.

     

    Warning

    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 Varalogix Q Deployment Automation 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 Varalogix Q Deployment Automation.

    • 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)

    • Host: Specify the computer name of the server where your database is installed.
    • 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.
    • Q 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 VaraLogix Q Deployment Automation component product.
    • Q 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 VaraLogix Q Deployment Automation component product.

    • Q 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 VaraLogix Q Deployment Automation component product.

      Error

      If you selected the No migration required option for either BMC Release Process Management or BMC VaraLogix Q Deployment Automation, all product data is removed from the database during the installation. If you want to save the data in the database, either use a new database or follow the migrations steps, described in topic Upgrading-from-version-4-3-00-to-4-3-01.

      Database details for BMC Release Process Management migration
      (Click the image to expand it)
      
      

      Database details for BMC VaraLogix Q Deployment Automation migration
      (Click the image to expand it)

      

16. 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: Represents the fully qualified name of the SMTP server used for sending emails.
    • SMTP Port: (Default 25) Represents the SMTP server port.
    • SMTP Domain: Represents 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: Represents the authentication mechanism used for your SMTP service. You can select from one of the options in the list displayed.
    • SMTP User: Represents the user name used to connect to the SMTP server.  For example, redmine@example.net.
    • SMTP Password: Represents 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.
      
      

      Warning

      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.

      The option of using Sendmail available in version 2.5.00 of BMC Release Process Management is not available in this release.

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

      Email notification information
      (Click the image to expand it)

      

17. 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.
18. (Optional, BMC Release Process Management product only): To see the installation log, click View Log.
19. (Optional, BMC Release Process Management product only): Change the default credentials for accessing the Tomcat server. The default credentials for the Tomcat server are the following:
    Login: tomcat
    Password: s3cret

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:

• Starting-or-stopping-product-services-for-root-installation
• Starting-or-stopping-product-services-for-non-root-installation