Upgrade to 2021.11 FP3 process
| Step | Description |
|---|---|
| 1.1 | Download the latest Apliqo UX installer file: Apliqo.2021.11.03 (FP3) |
| 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 relevant when 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 |
If you have Cubewise Pulse v6.0.x installed you can use the online migration package below which will automate the entire upgrade process and skip to step 2.
For Pulse online package migration Pulse version 6.0.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.
Note: Upgrade your Content Store instance first. After completing the Content Store update, you can then simply use the installer and update your existing webapps to complete the upgrade process.
Download
Follow the steps
| Step | Description |
|---|---|
|
3.1 |
Download Server Upgrade Process |
|
3.2 |
Select the downloaded file and copy it to the TM1 Data\[Content Store]\Data\ folder to replace the existing }APQ.UX.Server.Upgrade process |
|
3.3 |
Restart the content store TM1 services |
|
3.4 |
In the content store run the }APQ.UX.Server.Upgrade process |
|
3.5 |
Stop the content store service(s) which are being upgraded |
|
3.6 |
Download 2021.11 FP3 Offline Loose File Package containing TM1 DB objects which need updating |
|
3.7 |
Unzip the downloaded offline package and go to the 'items' folder |
|
3.8 |
Select all the files and copy them to the TM1 Data\[Content Store]\Data\ folder to add/replace the required TM1 objects. |
|
3.9 |
Restart the content store TM1 services |
|
3.10 |
In the content store run the }APQ.UX.Server.Upgrade process again |
|
3.11 |
Restore any attribute values which have been overwritten by the new objects, which were backed up in step 1.5 |
| 3.12 | Repeat for each content store which is being upgraded |
| Step | Description |
|---|---|
| 4.1 | Right-click the downloaded Apliqo UX installer file and select "Run as Administrator" |
| 4.2 | Follow the installation wizard: |
|
4.3 |
Select the required options: |
✅ Install Apliqo Server |
➟ install the core components, required for e.g. Tomcat version upgrade |
✅ Demo Applications |
➟ install Apliqo Demo / reset the samples database |
✅ Update Existing Applications |
➟ update already existing webapp applications |
✅ Create Backup During Update |
➟ create copies of the webapps in ApliqoServer\Backups directory |
✅ Create New Application |
➟ proceed through the wizard to create new application. This is not required during existing applications update |
| 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. |
| 5.3 | Restart Apliqo Server if any updates have been made in steps 5.1 and 5.2 |
0 Comments
Add your comment