Unsupported content This version of the documentation is no longer supported. However, the documentation is available for your convenience. You will not be able to leave comments.

Patch 8: version 4.4.00.08

This topic contains information about updates in this patch, and provides instructions for downloading and installing the patch.

For information about issues corrected in this patch, see Known-and-corrected-issues.

Updates

Patch 8 provides the following updates:

Failed to execute the [excerpt-include] macro. Cause: [Error number 2 in 0: No wiki with id [confluencePage:page:brpm46.Patch 1] could be found]. Click on this message for details.

Downloading BMC Release Process Management version 4.4.00.08

Perform the following steps to download the patch:

  1. Create a directory in which to place the downloaded files.

    Note

    On Windows computers, ensure that the directory is only one level into the directory structure. The Electronic Product Distribution (EPD) package creates a directory in the temporary directory when you extract the files, and the directory that  contains the installation image must not be in a directory deeper than two levels into the directory structure.

  2. Go to http://www.bmc.com/available/epd.html.e
  3. At the logon prompt, enter your user ID and password, and then click Submit.
  4. On the Export Compliance and Access Terms page, provide the required information, agree to the terms of the agreements, and click Continue.
  5. Click the Product Patches tab.
  6. Select the profile you want from the Select Profile list, if you have multiple profiles, or if you are accessing this site for the first time, create an EPD profile to specify the platforms that you want to see, as described in the EPD site help. Otherwise, go to step 7.
  7. Expand BMC Application Management Suite > BMC Application Management Suite 2.6.00 > BMC Release Lifecycle Management (License Add-on 4.4.00) and then expand BMC Release Lifecycle Management 4.4.00 to show its downloadable files.
  8. Select the following link for download:
    • BMC Release Process Management 4.4.00 Patch 8 Manual Upgrade
  9. Click Download (FTP) or Download Manager:
    • Download (FTP) places the selected items in an FTP directory, and the credentials and FTP instructions are sent to you in an email message.
    • Download Manager enables you to download multiple files consecutively, and to resume an interrupted download if the connection drops. 
      This method requires a one-time installation of the Akami NetSession client program on the target computer and is usually the faster and more reliable way to transfer files. A checksum operation is used to verify file integrity automatically.
  10. Save the .war file to a temporary directory.

Upgrading BMC Release Process Management to version 4.4.00.08

Note

If your current BMC Release Process Management version is earlier than 4.4.00.00, upgrade to the major version 4.4.00.00, and then upgrade to version 4.4.00 Patch 8.

  1. Log on as an administrator to the server that hosts the database and save a backup of the database before performing the upgrade.

  2. Stop the BMC Release Process Management service for the current version.

    Note

    If you run several instances of BMC Release Process Management connected to the same database for load balancing and clustering purposes, also stop the BMC Release Process Management service for these instances.

  3. On the command line, run the following command: 

    • (Windows) dir <RLM_HOME>\releases
    • (Linux or Solaris ) cd <RLM_HOME>/releases

    Note

    Complete steps 3 through 13 on all the other hosts that are part of the cluster.

  4. Create a directory with the following name: 4.4.00.08\RPM.
  5. Copy the downloaded brpm.war file to the <RLM_HOME>\releases\4.4.00.08\RPM folder.
  6. Extract the brpm.war file by using Java Archive Tool, UnZip, 7-Zip, or any other file extractor.
    For example, for Java Archive tool, use the following command:
    %JAVA_HOME%\bin\jar.exe -xvf <RLM_HOME>\releases\4.4.00.08\RPM\brpm.war
  7. Copy the following configuration files from <RLM_HOME>\releases\4.4.00.04<or your previous product version>\RPM\config to <RLM_HOME>\releases\4.4.00.08\RPM\config:
    • database.yml
    • automation_settings.rb
    • smtp_settings.rb
    • wicked_pdf_config.rb
    • carrierwave_settings.rb
  8. Go to <RLM_HOME>\releases\4.4.00.08\RPM\config, and then open the torquebox.yml file in a text editor.

  9. For the stomp parameter, change the host value from localhost to the server IP address or the domain name of your current BMC Release Process Management server.

    Note

    You can copy the valid host value from the torquebox.yml file located in <RLM_HOME>\releases\<4.4.00>\RPM\config.

  10. Save your changes to the torquebox.yml file.
  11. Go to <RLM_HOME>\server\jboss\standalone\deployments and then open the RPM-knob.yml file in a text editor.
  12. Change the application root from <RLM_HOME>\releases\4.4.00.04<or your previous product version>\RPM to <RLM_HOME>\releases\4.4.00.08\RPM.
  13. Save your changes to the RPM-knob.yml file.
  14. On the command line, navigate to <RLM_HOME>\bin and run the following executable file:
    • (Windows) setenv.bat
    • (UNIX) setenv.sh, using the . ./setenv.sh command

  15. In the same command line window as the previous step, navigate to <RLM_HOME>\releases\4.4.00.08\RPM and run the following code:

    jruby -S rake --verbose db:migrate

    Note

     See Specifying-the-product-environment-during-the-database-migration if the following error appears during rake task execution:

     rake aborted!database configuration does not specify adapter
  16. Start the BMC Release Process Management service.

After the upgrade

If you perform the upgrade from BMC Release Process Management version 4.4.00.02 or earlier, complete the necessary steps as described in Additional-actions-after-the-patch-upgrade.

Related topic

Known and corrected issues

 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*