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.
When you are upgrading the BMC Helix Platform SDK and the applications:
- Make sure you perform all the steps in the sequence given below.
- Make sure you have the correct versions of all the required tools installed. For more information, see Setting up your IDE and installing BMC Helix Platform SDK.
- Make sure you go through the Known and corrected issues in this version.
To upgrade BMC Helix Platform SDK to 20.02.01
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).
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>
- Rename your current SDK folder to create a backup.
For example, rename it to com.bmc.arsys.rx.sdk-20.2.0.BACKUP.
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).
Add or update RX_SDK_HOME environment variable to point to the new SDK folder location.
- 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.
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
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:
The .m2 folder is usually located in your user directory, such as %USERPROFILE%\.m2\.
<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:
- 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:
Build, export, and deploy your application project.
myproj> mvn clean install -Pexport -Pdeploy
- Verify that your application functions correctly.