How to Upgrade IM Using Update Assistant

The process consists of the following steps:

1. Update Check – Here you select to which IM version you want to update and the system will perform a comparison of your current version and the target one. As a result, you will get a list of potentially breaking changes. When you expand a particular change, you can read the details and also learn how to fix it.
   To continue, there are two buttons: one leading the next step Code Analysis, the other called Direct Update which will skip the next steps and perform the update directly (i.e. go to Step 4). Direct Update is meant for experienced Integration Engineers only who are sure that the breaking changes do not affect their instance or they want to solve the conflicts manually in Git.
   There is the IN_CONFLICT state in the Update Assistant, which is returned when the analysis conflicts with Git changes. The “Current Update is in Conflict” message is displayed. Click Start new update to restart the Update Assistant.

   
   

2. Code Analysis – In this step the Update Assistant analyzes the code of your current IM instance and lists all places affected by the breaking changes from the previous step. This step is read-only. For every change you can expand the details to compare the current state and the target state. Changes that PlatformManager applies automatically are distinguished from changes that require a manual action; changes flagged as requiring a manual rewrite are highlighted. Use the View in Git link to inspect the affected code directly in Git.
   ⚠️ This does not include thorough validation of custom code.
   Click Next to continue to the Code Modification step. Clicking Next does not trigger any modification.

   
   

3. Code Modification – This step is divided into two sections:

   • Automatically applied changes – Shows the number of changes that PlatformManager can apply for you. Click Apply Changes to trigger the automatic code modification. After the modification finishes, the result is displayed.

   • Manual action required – Displayed only when at least one change requires a manual action. Each listed change provides a detail view and a direct link to Git. Make these changes yourself in the highlighted temporary branch. After you apply a required change in Git, click Re-Analyze; changes that are resolved are removed from the list.

   Before you continue, confirm the acknowledgement that all required changes have been made in the correct branch. PlatformManager stores this acknowledgement (user name, date and time, target IM version). After the acknowledgement, click Start Update to start the update.

   
   

4. Update – In this step, the actual update is performed. (Until now, all changes were done in a separate branch in Git and now they are merged with your IM instance.) When it is successfully completed, you get a confirmation.