Difference between revisions of "Upgrade ACP to a new release"
Line 11: Line 11:
 
In a non admin command prompt cd to your Analytica install folder.
 
In a non admin command prompt cd to your Analytica install folder.
  
−
*<code>CD "C:\Program Files\Lumina\Analytica 6.0"</code>
+
*<code>CD "C:\Program Files\Lumina\Analytica 6.3"</code>
  
 
Launch Desktop Analytica...
 
Launch Desktop Analytica...
Line 19: Line 19:
 
*In the Help menu, select Update license and enter the license - Activation key you received from Lumina into the license field and press Enter.
 
*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.
+
Now Activate this license for your user running ACP - substitute the user name on your server for ACPUser if necessary.
 
*<code>RunAs /user:ACPUser .\Analytica</code>
 
*<code>RunAs /user:ACPUser .\Analytica</code>
 
*When prompted, enter the password for ACPUser
 
*When prompted, enter the password for ACPUser
Line 30: Line 30:
  
 
=== Download and install the Analytica installer ===
 
=== Download and install the Analytica installer ===
−
*Download the Analytica release appropriate for your new ACP release, currently [https://downloads.analytica.com/ANA/AnaSetup6_0_10.exe https://downloads.analytica.com/ANA/AnaSetup6_0_10.exe]
+
 
 +
*Download the Analytica release appropriate for your new ACP release, currently [https://downloads.analytica.com/ANA/AnaSetup6_3_6.exe https://downloads.analytica.com/ANA/AnaSetup6_3_6.exe]
 
* Install this Analytica release build. Install to the default folder. Use your existing ACP or ACP w/optimizer license.
 
* 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:
 
* Now you need to ensure your database user can use the Analytica license - In a non admin CMD prompt:
−
*::<code>CD "C:\Program Files\Lumina\Analytica 6.0"</code>
+
*::<code>CD "C:\Program Files\Lumina\Analytica 6.3"</code>
 
*::<code>RunAs /user:ACPUser .\Analytica</code>
 
*::<code>RunAs /user:ACPUser .\Analytica</code>
 
*When prompted, enter the password for ACPUser
 
*When prompted, enter the password for ACPUser
Line 40: Line 41:
  
 
=== Download files to be updated and copy them to your ACP installation ===
 
=== Download files to be updated and copy them to your ACP installation ===
−
*Download this Zip Archive, and extract it to a folder on your computer. [https://downloads.analytica.com/ana6.0/ACP3_0.zip ACP3_0.zip]
+
*Download the relevant Zip Archive for the UI, and extract it to a folder on your computer.  
 +
If you are using Firebase Authentication:
 +
[https://downloads.analytica.com/ana6.3/ACP3.1_build_113_AP.zip]
 +
 
 +
If you are using Apache Authentication:
 +
[https://downloads.analytica.com/ana6.3/ACP3.1_build_113_AP.zip]
  
 
====Save files to the Analytica folder====  
 
====Save files to the Analytica folder====  
−
*These files (from the archive extracted in the previous sections) need to be saved to <code>C:\Program Files\Lumina\Analytica 6.0</code> Overwrite the existing files with the same name.<br />
+
*These files (from the archive extracted in the previous sections) need to be saved to <code>C:\Program Files\Lumina\Analytica 6.3</code> Overwrite the existing files with the same name.<br />
  
 
#Analytica.ini
 
#Analytica.ini
Line 52: Line 58:
  
 
'''''<font color=blue>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</font>.'''''
 
'''''<font color=blue>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</font>.'''''
−
*Save these files to <code>C:\Program Files\Lumina\Analytica 6.0</code> (When prompted click yes to replace existing files)<br />
+
*Save these files to <code>C:\Program Files\Lumina\Analytica 6.3</code> (When prompted click yes to replace existing files)<br />
  
 
====Save files to the UI folder====
 
====Save files to the UI folder====
Line 63: Line 69:
 
** In the config files D:\Acp\ui\Assets Session.config and Server.config, in a text editor, temporarily set <code>DesktopUI=1</code>. Save the files.
 
** In the config files D:\Acp\ui\Assets Session.config and Server.config, in a text editor, temporarily set <code>DesktopUI=1</code>. Save the files.
 
** In a non-admin CMD prompt:
 
** In a non-admin CMD prompt:
−
**:<code>CD "c:\program files\lumina\Analytica 6.0"</code>
+
**:<code>CD "c:\program files\lumina\Analytica 6.3"</code>
 
**:<code>.\Suan.exe /config:d:\Acp\ui\assets\server.config</code>
 
**:<code>.\Suan.exe /config:d:\Acp\ui\assets\server.config</code>
 
**:: Expected: An Analytica desktop instance should launch with an architecture drawing.  It should stick around and not vanish.
 
**:: Expected: An Analytica desktop instance should launch with an architecture drawing.  It should stick around and not vanish.
Line 74: Line 80:
  
 
===Make any updates to the database===
 
===Make any updates to the database===
−
 
+
<font color="blue">There are no database updates for recent releases. So you can skip this section</font>
 
* Run: Analytica.exe "d:\Acp\ui\assets\Database alterations.ana"
 
* 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.32</code>
 
* In the text input Updating from release number enter your release you are updating from eg. <code>0.32</code>
Line 82: Line 88:
 
* 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.
 
* 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.
  
 +
<!--
 
===Add a Subscription Administrator===
 
===Add a Subscription Administrator===
−
 
+
<font color="blue">You should be able to skip this section. So you can skip this section</font>
 
You only need to do this if your last build was ACP beta build 0.40 or earlier.  For instance if you are updating from build 0.32 beta  to build 3.0 (which has the same database as 0.45 beta). Starting in build 0.41, only subscription administrators can add or delete projects.  See more on this page [[ACP_Group_Accounts|ACP Group accounts]].
 
You only need to do this if your last build was ACP beta build 0.40 or earlier.  For instance if you are updating from build 0.32 beta  to build 3.0 (which has the same database as 0.45 beta). Starting in build 0.41, only subscription administrators can add or delete projects.  See more on this page [[ACP_Group_Accounts|ACP Group accounts]].
  
Line 103: Line 110:
 
'''Expected: You should have a subscription manager for the Group account on your server, the user(s) whose email address you entered.'''
 
'''Expected: You should have a subscription manager for the Group account on your server, the user(s) whose email address you entered.'''
 
** Notify the Subscription Administrator that they can add or delete projects, and manage other subscription administrators by using the Subscription Administration project. See more on the ACP Group accounts page [[ACP_Group_Accounts|here]].
 
** Notify the Subscription Administrator that they can add or delete projects, and manage other subscription administrators by using the Subscription Administration project. See more on the ACP Group accounts page [[ACP_Group_Accounts|here]].
−
 
+
-->
 
=== Restart Apache ===
 
=== Restart Apache ===
 
In an elevated command prompt: <code>C:\Apache24\bin>httpd.exe -k restart</code>
 
In an elevated command prompt: <code>C:\Apache24\bin>httpd.exe -k restart</code>

Revision as of 12:04, 23 June 2023

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 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.3"

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

  • Download the Analytica release appropriate for your new ACP release, currently https://downloads.analytica.com/ANA/AnaSetup6_3_6.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.3"
    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: [1]

If you are using Apache Authentication: [2]

Save files to the Analytica folder

  • These files (from the archive extracted in the previous sections) need to be saved to C:\Program Files\Lumina\Analytica 6.3 Overwrite the existing files with the same name.
  1. Analytica.ini
  2. suan.exe
  3. libssl-3.dll
  4. libcrypto-3.dll
  5. SuanFirebaseAuth

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.3 (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
  • Save these folders to D:\ACP\ui\. Replace the existing folders.
    .
  1. Assets
  2. Build

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.3"
      .\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

There are no database updates for recent releases. So you can skip this section

  • 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.32

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.45
  • 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 (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.

Comments


You are not allowed to post comments.