Applying hotfix

This topic provides instructions for applying hotfix to an existing installation of BMC Release Process Management (BRPM).

Do the following steps to apply a hotfix:

1. Log in 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. From the command line, run the following command: 

   • (Windows) dir RLMhome\releases
   • (Linux or Solaris ) cd RLMhome/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: newProductVersion\RPM. For example, 5003004-HF1\RPM.
5. Copy the downloaded brpm.war file to the RLMhome\releases\newProductVersion\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\<new_product_version>\RPM\brpm.war
7. Copy the following configuration files from RLMhome\releases\previousProductVersion\RPM\config to RLMhome\releases\newProductVersion\RPM\portal.war\WEB-INF\config:
   
   1. database.yml
   2. automation_settings.rb
   3. smtp_settings.rb
   4. wicked_pdf_config.rb
   5. carrierwave_settings.rb
8. Navigate to the RLMhome\bin directory and update the start file as follows:
   
   1. (Windows) Set the value of the CURRENT_RPM_PATH parameter to the directory that you created in step 4.
      set CURRENT_RPM_PATH="RLMHome\releases\newProductVersion\RPM"
   2. (Linux) Set the value of the CURRENT_RPM_PATH parameter to the directory that you created in step 4.
      export CURRENT_RPM_PATH="RLMHome\releases\newProductVersion\RPM"
9. On the command line, navigate to RLMhome\bin and run the following command:
   1. (Windows) setenv.bat
   2. (Linux). ./setenv.sh

10. In the same command line window as the previous step, navigate to RLMhome\releases\newProductVersion\RPM\portal.war\WEB-INF and run the following rake task:

    jruby -S rake --verbose db:migrate RAILS_ENV=production
    
11. Start the BMC Release Process Management service.