Versions Compared

Version Old Version 1 New Version Current
Changes made by

Ada atrajer

Ada atrajer

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Expand
title 1. Pre-upgrade steps

Step

Description

1.1

Download the latest Apliqo UX installer file: Apliqo.2023.0502 FP1

1.2

Stop the content store service(s) which are being upgraded

1.3

Stop Apliqo application server

1.4

Take a backup of the content store data directories

1.5

Take a backup of any TM1 content store db data which will be overwritten during the upgrade (e.g. }APQ UX AppSubType cube including DefaultJSON.)

NOTE: this step is only relevant if custom widgets were created

1.6

If the Apliqo server is being updated e.g. due to the Tomcat version upgrade, take a backup of the settings.json file, as it will be overwritten during the server upgrade.

File location: ..\ApliqoServer\py\settings.json

Expand
title2. Online Upgrade Process

Panel
panelIconId2757
panelIcon:exclamation:
panelIconText❗
bgColor#FFEBE6

For Pulse online package migration Pulse version 6.x.x is required.

Note: that upgrades and fix pack releases of Apliqo UX ContentStore prior to July 2021 used Pulse 5.8.x migration packages. With the 2021.07 Apliqo UX release this was switched to the Pulse v6 format which is not backwards compatible with older versions of Pulse. If you are a Pulse customer still using an older version then you will need to follow the procedure for the offline package upgrade

Step

Description

2.1

If you have Cubewise Pulse v6.x.x installed you can use the online migration package below which will automate the entire upgrade process.

2.2

Download 2023.05 02 FP1 Online Loose File Package Package containing TM1 DB objects which need updating

Expand
title3. Offline Upgrade Process: Installing TM1 DB objects

Step

Description

3.1

Download2023.05 02 FP1 Offline Loose File Package Package containing TM1 DB objects which need updating

3.2

Unzip the downloaded offline package and go to the 'items' folder

3.3

Select all the files and copy them to the TM1 Data\[Content Store]\Data\ folder to add/replace the required TM1 objects.

3.4

Restart the content store TM1 services

3.5

In the content store run the }APQ.UX.Server.Upgrade process

3.6

Restore any attribute values which have been overwritten by the new objects, which were backed up in step 1.5

3.7

Repeat for each content store which is being upgraded

...

Expand
title5. Updating the Apliqo Server and webapp file properties

Step

Description

5.1

Settings.json file in Apliqo Server (..\ApliqoServer\py\settings.json)

If the Apliqo Server has been upgraded, copy any overwritten values from the backup taken in step 1.6

5.2

Settings.json file in each webapp
Update the allowedRestPaths property - located under WEB-INF\Config.

Current allowedRestPaths available in the attached file below:

View file
nameallowedRestPaths.txt

5.3

Restart Apliqo Server if any updates have been made in steps 5.1 and 5.2

Expand
title6. Post-upgrade steps (after the 1st upgrade to a 2022.12 version or newer)

Admin user needs to step through each screen of the wizard while in edit mode. This means that all wizard SubSteps including all pop-ups should be opened once by the UX power user.

After this the wizard steps should render properly for non-admin users.

Bitbucket Issue Reference