Update AX Server analytic engine to version 15.0.0
Update AX Server's analytic engine to remain compatible with the latest updates in Analytics 15.0.0. You must run the update on AX Server and any instances of AX Engine Node.
Note
This procedure updates the version of the AX Connector and the AX Engine components, and installs additional required prerequisites if they are not present on the server.
This procedure does not update or upgrade AX Server as a whole. For information about upgrading the entire application, see Upgrading AX Server.
Add certificate authority URLs to your network allowlist
Galvanize has updated the digital certificate used by the analytic engine. To ensure that AX Server continues to work after updating the analytic engine, you may need to add URLs associated with the certificate authority to your network allowlist. After updating the analytic engine, inspect the installed certificate to get the required URLs.
Show me how
- In the AX Engine installation directory, right-click AclScript.exe and select Properties.
The default installation directory is: C:\ACL\App\analytic_engine
- In the AclScript.exe Properties dialog box, select the Digital Signatures tab.
- In the Signature list, double-click Galvanize, then click View Certificate.
- In the Details tab in the Certificate dialog box, select the following fields, copy the URLs from the display area at the bottom of the dialog box, and save them in a text file:
Field Value URL (example) CRL Distribution Points CRL Distribution Point http://crl3.digicert.com/sha2-assured-cs-g1.crl CRL Distribution Point http://crl4.digicert.com/sha2-assured-cs-g1.crl Authority Information Access Access Method=On-line Certificate Status Protocol http://ocsp.digicert.com - Select the Certification Path tab, select the intermediate entry in the certification path (entry 2 of 3) and click View Certificate.
- In the Details tab, select the following fields, copy the URLs from the display area at the bottom of the dialog box, and save them in the text file:
Field Value URL (example) Authority Information Access Access Method=On-line Certificate Status Protocol http://ocsp.digicert.com CRL Distribution Points CRL Distribution Point http://crl4.digicert.com/DigiCertAssuredIDRootCA.crl CRL Distribution Point http://crl3.digicert.com/DigiCertAssuredIDRootCA.crl - Add the URLs that you have collected to your network allowlist.
Download the patch installer
You need to download the patch installer ACLAX1420UpdateToACLAnalytics1500.exe.
- Sign in to Launchpad (www.highbond.com).
If you are unable to sign in to your Launchpad account, contact your company’s HighBondSystem Admin or Galvanize Support for assistance.
- Under Resources, click Downloads.
- In the top menu, click Analytics Exchange.
- Under Patch available for Analytics Exchange Engine, click Download Version 15 and save the installer to the server where AX Server is installed.
Run the update
Note
If you are performing the update during working hours, notify AX Client and AX Web Client users in advance to log out. Once you stop the AX Server services, no one can access AX Server.
In AX Client, check to make sure no analytics are currently running, queued, or scheduled to run shortly. If your planned update conflicts with the running of analytics, perform the update at a different time, or reschedule queued or scheduled analytics as required.
- On the AX Server or AX Engine Node machine, stop the AX Server services
in the following order:
- Analytics Exchange Connector
- ACL Analytics Exchange Service
Although Windows may indicate within a few seconds that the ACL Analytics Exchange Service is stopped (or started), the TomEE application server may take approximately a minute to actually stop (or start), depending on the speed of your server hardware.
- Analytics Exchange Database
If you do not stop the services in the correct order, problems can occur with the functioning of AX Server.
- Double-click ACLAX1420UpdateToACLAnalytics1500.exe, select the appropriate language for your installation,
and click OK.
If a security warning dialog box appears, verify the information listed, and click Yes or Run.
- If you are prompted to install prerequisites, click Install.
- Read the information that appears in the warning dialog box and make sure that you have complied with it before clicking OK to proceed.
- The Welcome page, click Next.
The Welcome page displays the current version of AX Engine (ACLScript.exe). The installer can only be used to update version 14.2.x of the engine.
- In the Optional Analytics data connectors page, do one of the following:
- Leave Upgrade selected and click Next to allow upgrading the optional data connectors.
- Deselect Upgrade and click Next to remove the optional data connectors.
Important
If you are updating one or more instances of AX Engine Node in addition to AX Server, you must make the same selection on this page for all of them.
Note
If you remove the optional data connectors, AX Server cannot run analytic scripts that contain an ACCESSDATA command configured to connect to one of the deselected data sources.
If you want to install the optional data connectors in the future, you will need to uninstall and re-install AX Server.
- In the Enable machine learning page, do one of the following:
- Leave Upgrade selected and click Next to allow upgrading the Python engine used by Analytics machine learning commands.
- Deselect Upgrade and click Next to remove the Python engine used by Analytics machine learning commands.
Important
If you are updating one or more instances of AX Engine Node in addition to AX Server, you must make the same selection on this page for all of them.
Note
If you remove the Python engine, AX Server cannot run analytic scripts that contain any machine learning commands.
If you want to install the Python engine in the future, you will need to uninstall and re-install AX Server.
- In the Ready to Install the Program page, click Install and when the installation is complete, click Finish.
- Click Yes to restart the Windows server on which AX Server is installed.
- After the server has restarted, check that the three AX Server services are running.
- If the services are not running , restart them
in the following order:
- Analytics Exchange Database
- ACL Analytics Exchange Service
Although Windows may indicate within a few seconds that the ACL Analytics Exchange Service is stopped (or started), the TomEE application server may take approximately a minute to actually stop (or start), depending on the speed of your server hardware.
- Analytics Exchange Connector
If you do not start the services in the correct order, problems can occur with the functioning of AX Server.
