Upgrading BMC Helix Platform SDK to 20.02.01

If you are using the BMC Helix Platform SDK to build and deploy applications and/or libraries, after you receive the notification, you must upgrade BMC Helix Platform SDK and any application projects that you created using an earlier version of BMC Helix Platform SDK. Note that these steps are not required for pure codeless development by using BMC Helix Innovation Studio. However, you must upgrade the BMC Helix Platform SDK and your code based application for each release. Follow the steps given below if you are upgrading the BMC Helix Platform SDK and your applications from 20.02.0 to 20.02.01 version. 

To upgrade BMC Helix Platform SDK to 20.02.01

1. After you receive notification that your BMC Helix Platform has been updated, download the BMC Helix Platform SDK ZIP file (com.bmc.arsys.rx.sdk-20.2.1.zip).  

2. Some Maven repositories may not be available over HTTP, so if your maven compilation fails due to the error, Return code is: 501 , ReasonPhrase:HTTPS Required, then add the following entry in the <mirrors> section in settings.xml file located in your <maven installation>/conf directory. For more information, see Creating-a-Project-using-Maven-and-the-Archetype.

   <mirror>
   <id>central-over-https</id>
   <mirrorOf>central</mirrorOf>
   <name>Maven Central Repository</name>
   <url>https://repo1.maven.org/maven2</url>
   </mirror>
3. Rename your current SDK folder to create a backup.
   For example, rename it to com.bmc.arsys.rx.sdk-20.2.0.BACKUP.
4. At the location where you want to install the SDK, create a new SDK folder and extract the BMC Helix Platform SDK ZIP file (com.bmc.arsys.rx.sdk-20.2.1.zip).
5. Add or update RX_SDK_HOME environment variable to point to the new SDK folder location.
6. Find the .m2 folder (usually located in your user directory, such as %USERPROFILE%\.m2\repository\com\bmc on windows). Delete the arsys and rx folders located there.

7. Install BMC Helix Platform SDK in your Maven repository by using the following commands:

   \com.bmc.arsys.rx.sdk-20.2.1> cd lib
   \com.bmc.arsys.rx.sdk-20.2.1\lib> mvn clean install

8. Update the archetype-catalog.xml file to delete the 20.2.0 archetypes and ensure the archetype-catalog.xml has the archetype version as 20.2.1-SNAPSHOT.

   The archetype-catalog.xml file might be located at following locations:

   • .m2
   • .m2/repository

   The .m2 folder is usually located in your user directory, such as %USERPROFILE%\.m2\.
   For example: 

   <archetypes>
   <archetype>
   <groupId>com.bmc.arsys</groupId>
   <artifactId>rx-sdk-archetype-lib</artifactId>
   <version>20.2.1-SNAPSHOT</version>
   <description>Rx SDK lib archetype</description>
   </archetype>
   <archetype>
   <groupId>com.bmc.arsys</groupId>
   <artifactId>rx-sdk-archetype-simple</artifactId>
   <version>20.2.1-SNAPSHOT</version>
   <description>Rx SDK simple archetype</description>
   </archetype>
   </archetypes>

To upgrade your application or library

If your application/library has not been updated to 20.2.0 yet, please check the 20.2.0 upgrade steps. If you have upgraded your application or library to 20.2.0 SDK or created an application or a library by using the 20.2.0 SDK, then perform the steps given below:

1. Change the rx-sdk version to 20.2.1 in the parent pom.xml file located in the project folder by using the following syntax: 
   <rx-sdk.version>20.2.1-SNAPSHOT</rx-sdk.version>

2. Build, export, and deploy your application project.
   For example: 

   myproj> mvn clean install -Pexport -Pdeploy
3. Verify that your application functions correctly.

Related topic

Known-and-corrected-issues