Upgrade prerequisites

This topic explains upgrade prerequisites for systems.

Before you start upgrading your ASMS system:

  • Read through the Mandatory and Recommended Prerequisites below to determine that the system is ready for the upgrade
  • Verify that your system nodes are available and connected as shown in the ASMS system architecture page

Tip: You can check your system's compliance with prerequisite requirements by running upgrade readiness checks prior to upgrading your system. First download build files to your system. See Download ASMS software packages. Then, in the algosec_conf menu, enter option 17 System health, and enter 3 Check upgrade readiness.

Mandatory upgrade prerequisites

The following prerequisites are required before upgrading.

Tip: If you have a distributed architecture, make sure that you have the required system specifications on all distributed nodes to prevent errors during upgrades.

AlgoSec's upgrade process to A32.10 is supported only from A32.00.

If you have an ASMS version running CentOS 6, you must first perform any upgrades required to get to A32.00. For details, see the upgrade procedure in the Installation and Setup Guide for A32.00.

System optimizations in version A32.10 require additional CPU and memory specifications.

See Hardware minimum requirements.

Downtime will be required while all of the servers in your system are upgraded. The downtime will differ depending on the number and types of servers you have. Schedule your upgrade at a time where you can afford this downtime.

Tip: Start the upgrade process to view the runtime estimation. If you're not ready to continue, enter n at the relevant prompt.

Once ASMS begins to upgrade your system, CTRL+C is not supported. Upgrades cannot be aborted.

5 GB of disk space is required per partition (OS and data) on all appliances:

  • If less than 5 GB of disk space is found, the upgrade process aborts.

  • If there is less than 10 GB of disk space found, the upgrade process presents a warning and enables you to choose whether to continue or not.

    To cancel and run the upgrade later, enter n at the confirmation prompt.

Back to top

Recommended upgrade prerequisites

The following pre-requisites are not mandatory, but are recommended:

If you have ASMS deployed on virtual machines, we recommend generating a fresh backup before upgrading. This isn't relevant for physical appliances, as restoring or rolling back upgrades on physical appliances is not supported.

For more details, see Backup/Restore.

Upgrading VisualFlow overwrites any un‐applied workflow drafts, and discards all un‐applied changes.

If you have un‐applied workflow changes in VisualFlow, we recommend that you apply them before upgrading so that you don't lose any work.

If you are upgrading AFA on HA clusters, and also have FireFlow configured, we highly recommend that you upgrade FireFlow as well.

This is not required for DR clusters.

We recommend that you ensure that all services are running before you perform the upgrade.

To check services:

  • Go to the algosec_conf menu and select option 17 - System health. Select option 1 - Services status. For details, see Test ASMS processes.

If services are down, contact AlgoSec customer support to start them before continuing.

If your AFA is currently using a customized brand_config.xml in /home/afa/.fa/plugins/BRAND, we recommend you contact AlgoSec support before updating your ASMS to verify that all updates will be implemented. See AlgoPedia article.

ASMS connects to AlgoSec SaaS services (ObjectFlow, AlgoSec Cloud and AppViz) through HTTPS tunnel. Ensure proper HTTPS tunnel connectivity in advance of the upgrade by making sure that traffic is allowed through port 8082 to Kafka host IPs in your host region. See AlgoSec Cloud Kafka Hosts, ObjectFlow Kafka Hosts, AppViz Kafka Hosts.

If you have a problem enabling port 8082, you can still upgrade your ASMS, but contact AlgoSec support.

 

â See also: