Upgrading BMC Helix Innovation Studio SDK to 21.05.03

If you are using the BMC Helix Innovation Studio SDK to build and deploy applications and/or libraries, after you receive the notification, you must upgrade BMC Helix Innovation Studio SDK and any application projects that you created using an earlier version of BMC Helix Innovation Studio SDK. Note that these steps are not required for pure codeless development by using BMC Helix Innovation Studio.

To upgrade BMC Helix Innovation Studio SDK to 21.05.03

1. After you receive notification that your BMC Helix Innovation Studio has been updated, download the BMC Helix Platform SDK ZIP file (com.bmc.arsys.rx.sdk-10.1.00.003.zip).
2. Make sure that you have Node.js version 12.20.1 and Yarn version v1.22.5 installed. If not, see To install Node.js.
3. Development environment has changed to OpenJDK. To install OpenJDK, see Setting-up-your-IDE-and-installing-BMC-Helix-Innovation-Studio-SDK. 

4. 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://repo.maven.apache.org/maven2</url>
   </mirror>
5. Rename your current SDK folder to create a backup.
   For example, rename it to com.bmc.arsys.rx.sdk-10.1.00.001.BACKUP.
6. At the location where you want to install the SDK, create a new SDK folder and extract the BMC Helix Innovation Studio SDK ZIP file (com.bmc.arsys.rx.sdk-10.1.00.003.zip).
7. Add an environment variable, RX_SDK_HOME, that points to the sdk folder location.
8. 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.

9. Install BMC Helix Innovation Studio SDK in your Maven repository by using the following commands:

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

10. Update the archetype-catalog.xml file to delete the earlier archetype versions (for example, 17.5.0) and ensure the archetype-catalog.xml has the archetype version as 10.1.00.003-SNAPSHOT.

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

    • .m2
    • .m2/repository

    For example: 

    <archetype>    
    <groupId>com.bmc.arsys</groupId>
    <artifactId>rx-sdk-archetype-application</artifactId>
    <version>10.1.00.003-SNAPSHOT</version>
    <description>Rx SDK application archetype</description>
    </archetype>

To upgrade your application or library

To upgrade your applications or libraries created by using the 21.05.03 (10.1.00.003) SDK, perform the following steps:

1. Change the rx-sdk version to 10.1.00.003 in the parent pom.xml file located in the project folder by using the following syntax: 
   <rx-sdk.version>10.1.00.003-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