Upgrade ACP to a new release

Here's how to upgrade Analytica Cloud Platform running on a server to a new release.

If you are doing a complete new install of ACP on a server, you need to follow the instructions on this page.

Activate a new license for ACP

This section is not necessary if you are still have an active ACP license. You can skip to the next section.

If you are just activating a new subscription license for ACP then you can skip the downloading and installing. But you need to ensure that the user running the ACP processes can use the new license. The easiest way will normally be to launch Analytica as that user in a command prompt.

If you don't have an internet connection

Acp licenses cannot be activated manually as the Desktop Analytica licenses can. If you do not have an internet connection, you will need to get a license file which has been signed from Lumina, and update with the license file from Analytica's Help > Update license dialog. Once you receive the updated license file, save it to the directory where your previous Analytica license was - usually C:\programData\Lumina\Licenses

Check the ACP user's license

In a non admin command prompt cd to your Analytica install folder.

CD "C:\Program Files\Lumina\Analytica 6.4"

Launch Desktop Analytica...

.\Analytica

Activate your new license - you can refer to this page License Information dialog

In the Help menu, select Update license and enter the license - Activation key you received from Lumina into the license field and press Enter.

Now Activate this license for your user running ACP - substitute the user name on your server for ACPUser if necessary.

RunAs /user:ACPUser .\Analytica
When prompted, enter the password for ACPUser

When Analytica launches, accept the terms and select the license in Desktop Analytica's Help->Update License dialog.
Test that it saves this info by exiting and restarting, again as ACPUser, and checking the Help-Update License dialog.
Now restart and test the Suan.exe application - see the sections below

Install/upgrade to a newer build of ACP

Download and install the Analytica installer

If you are updating to build 149 from build 138, you will not need to update this installer release and you can skip to the next section

Download the Analytica release appropriate for your new ACP release, currently https://downloads.analytica.com/ANA/AnaSetup6_4_8.exe.
Install this Analytica release build. Install to the default folder. Use your existing ACP or ACP w/optimizer license.
Now you need to ensure your database user can use the Analytica license - In a non admin CMD prompt:
CD "C:\Program Files\Lumina\Analytica 6.4"

RunAs /user:ACPUser .\Analytica
When prompted, enter the password for ACPUser
When Analytica launches, accept the terms and select the license in Desktop Analytica's Help->Update License dialog
Test that it saves this info by exiting and restarting, again as ACPUser, and checking the Help-Update License dialog.

Download files to be updated and copy them to your ACP installation

Download the relevant Zip Archive for the UI, and extract it to a folder on your computer.

If you are using Firebase Authentication: ACP_Build_149_FB.zip.

If you are using Apache Authentication: ACP_Build_149_AP.zip.

Save files to the Analytica folder

If you are updating to build 149 from build 138, you will not need to update these files and you can skip to the next section

These files (from the archive extracted in the previous sections) need to be saved to C:\Program Files\Lumina\Analytica 6.4 Overwrite the existing files with the same name.

Analytica.ini
suan.exe
libssl-3.dll
libssl-3-x64.dll
libcrypto-3.dll
libcrypto-3-x64
SuanFirebaseAuth

Again, this next step is not necessary If you are updating to build 149 from build 138

Before proceeding with the next step, you will need to stop the current Suan.exe process in the task manager (if it is running), so that you can overwrite it with the new version.

Save these files to C:\Program Files\Lumina\Analytica 6.4 (When prompted click yes to replace existing files)

Save files to the UI folder

The rest of the files from the extracted archive, in folders assets and build, need to saved to the ACP\ui folder

If you are updating to build 149 from build 138, you will not need to update the assets folder since it has not changed since 149. You will only need to update the Build folder.

Save these folders to D:\ACP\ui\. Replace the existing folders.
.

Assets
Build

If you did not save the previous Acp\Ui\assets\Db driver info.ana file, open the new one and enter the Database credentials before attempting to run ACP.

Test this part

- In the config files D:\Acp\ui\Assets Session.config and Server.config, in a text editor, temporarily set DesktopUI=1. Save the files.
- In a non-admin CMD prompt:
  CD "c:\program files\lumina\Analytica 6.4"
  
  .\Suan.exe /config:d:\Acp\ui\assets\server.config
  Expected: An Analytica desktop instance should launch with an architecture drawing. It should stick around and not vanish.
- In Chrome: http://localhost:8080
  Expected: Login page should appear
Once this test succeeds:
- Quit all Desktop Analytica instances
- Edit both Server.config and Session.config and set:
  DesktopUI=0

Make any updates to the database

Run: Analytica.exe "d:\Acp\ui\assets\Database alterations.ana"
In the text input Updating from release number enter your release you are updating from eg. 0.113

For this next step, if you are updating to the ACP 3.0 release build from an earlier beta build, you should enter 0.45.

In the text input Updating to release number enter your release you are updating to eg. 0.138
Press the output node Required alterations
Look at the result for number of alterations to be applied. If more than 0 press the button Apply Alterations. Once you get a message the the alterations have been applied, of If no alterations need to be applied just close the model.

Restart Apache

In an elevated command prompt: C:\Apache24\bin>httpd.exe -k restart

Update Scheduled tasks

If this update has involved installing a newer major or minor release of Analytica. For instance 6.3 - 6.4, you will need to update the scheduled tasks in task scheduler to point to the new Suan executables.

So for instance you would change the scheduled tasks that start the Suan processes at boot to point to the new Suan.exe at C:\Program Files\Lumina\Analytica 6.4\Suan.exe
Repeat for all 3 of the scheduled tasks for suan.exe pointing to Server.*.config tasks and the DTA Publish to cloud task.

Restart the Suan.exe

Launch task scheduler
Select your scheduled task to launch acp at boot (probably in the Lumina tasks directory).
End all instances
Run the task

Now you should have suan.exe running in task manager. If not there is something wrong with the configuration.

Test

Browse to your ACP instance and check to see that you can get to the user portal and log in.