Difference between revisions of "Upgrade ACP to a new release"

Revision as of 18:37, 15 September 2021

Activate a new license for ACP3

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

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

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

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 database user - 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 ACP3

Download and install the Analytica installer

Download the Analytica release appropriate for your new ACP release, currently https://downloads.analytica.com/ANA6.0/AnaSetup6_0_4_184.exe
Install this Analytica release build. Install to the default folder. Use your existing ACP3 or ACP3 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.0"

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 then to your ACP installation

Download these 2 Zip Archives, and extract them to replace the existing files on your current ACP installation.
- ACP-Analytica0.34.zip contains files that need to be saved to C:\Program Files\Lumina\Analytica 6.0
  - Extract the files from the ACP-Analytica.zip.

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

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

- ACP3-BetaBuild0.34.zip contains the ui directory with subdirectories Assets and Build. These folders need to replace the existing folders in D:\ACP\ui\

Test this part
- In all 3 of the D:\Acp\ui\Assets *.config files, in a text editor, temporarily set DesktopUI=1
- In a non-admin CMD prompt:
  CD "c:\program files\lumina\Analytica 6.0"
  
  .\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.22
In the text input Updating to release number enter your release you are updating to eg. 0.34
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

Restart the Suan.exe

Launch task scheduler
Select your scheduled task to launch acp at boot
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.

@@ Line 64: / Line 64: @@
 * 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. <code>0.22</code>
-* In the text input Updating to release number enter your release you are updating to eg. <code>0.32</code>
+* In the text input Updating to release number enter your release you are updating to eg. <code>0.34</code>
 * 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.