Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?

 
 

Upgrade Paths and Workflow

  • First major release versions are for new Juniper Apstra installations only. You cannot upgrade to a first major release version (to 4.1.0 for example).
  • You can upgrade to maintenance release versions and later (to 4.1.2 for example).
  • To check your current Apstra version from the Apstra GUI navigate to Platform > About from the left navigation menu.
  • To check your current Apstra version from the CLI run the command service aos show_version.
Note:

Upgrading from Apstra release versions 3.X are not supported.

Apstra Server Supported Upgrade Paths to Version 4.1.2

Table 1: Apstra Server Upgrade Paths to Version 4.1.2
From Version VM-to-VM (on new VM) In-Place (on Same VM)
4.1.1 Yes (recommended for production) Yes
4.1.0 Yes (recommended for production) Yes
4.0.2 Yes No
4.0.1 Yes No
4.0.0 Yes No

Apstra Server Supported Upgrade Paths to Version 4.1.1

Table 2: Apstra Server Upgrade Paths to Version 4.1.1
From Version VM-to-VM (on new VM) In-Place (on Same VM)
4.1.0 Yes (recommended for production) Yes
4.0.2 Yes No
4.0.1 Yes No
4.0.0 Yes No

Apstra Server Upgrade Workflow

Table 3: Apstra Upgrade Workflow
Stage Description
Pre-Upgrade Validation
  • Verify upgrade path is supported

  • Verify sufficient VM memory for new version

  • Check the new Apstra version release notes for config-rendering changes that could impact the data plane.

  • Review blueprints and address issues

  • Verify device OS versions are supported

  • Remove any device AAA configuration

  • Remove any configlets used to configure firewalls

  • Back up current Apstra environment

Upgrade Apstra Server
  • Download Apstra VM image

  • Install software on controller VM (Check configlets for conflicts.)

  • Install software on worker VMs (new VMs with Apstra Cluster only)

  • Verify connections to new server

  • Import SysDB database (new VMs only)

  • Log into new server

  • Change operation mode to normal

Upgrade Agents
  • From the Apstra GUI

Upgrade Worker Nodes (Apstra Cluster only)
  • If re-using VMs for worker nodes - import state

  • If using new VMs for worker nodes - install software on worker VM(s)

Upgrade Device NOS, as needed If the NOS versions of your devices are not qualified on the new Apstra version, upgrade them to a qualified version. (See the Juniper Apstra User Guide for details.)