◄
►

Orchestrator Upgrade

This section discusses the prerequisites and steps required to upgrade an Orchestrator. The Orchestrator allows you to configure and send a banner message about an upcoming Orchestrator upgrade. The banner is displayed to users the next time they login to the Orchestrator. You can customize the banner message and visibility for the users.

To upgrade an Orchestrator, perform the following steps:

  1. Configure Orchestrator Upgrade Announcement: The Upgrade Announcement area enables you to configure and send a message about an upcoming upgrade. To send an Orchestrator Upgrade announcement, perform the following steps:
    1. In the Operator Portal, select the Orchestrator tab, and go to Orchestrator Upgrade in the left navigation pane.
      The Orchestrator Upgrade screen appears.
      Figure 1. Orchestrator Upgrade
    2. Under Upgrade Announcement, set the banner message and visibility for the users.
      Table 1. Orchestrator Upgrade- Options and Descriptions
      Option Description
      Banner Message Enter the required Banner Message in the textbox to announce the status of an upcoming upgrade.

      A popup message appears indicating that you have successfully created your announcement, and your banner message displays at the top of the Orchestrator.
      Visibility You can choose the banner Visibility for the users. By default, Operator only is selected.
    3. Select the Announce Orchestrator Upgrade button to display the banner message.
      A popup message appears indicating that you have successfully created your announcement, and that your banner message displays at the top of the Orchestrator.
    4. If you want to remove the announcement from the Orchestrator, select the Unannounce Orchestrator Upgrade button.
      A popup message appears indicating that you have successfully unannounced the Orchestrator upgrade.
  2. Prepare Orchestrator Upgrade: After you have configured the Orchestrator upgrade banner message and visibility for the users, select the Prepare Orchestrator Upgrade button.
    This pauses the application of the configuration updates of Edges during the upgrade, at the global level and by default at the enterprise level. It displays the system configured message as the banner message while the upgrade is in progress.
    Figure 2. Prepare Orchestrator Upgrade
    Contact the Arista Support to prepare for the Orchestrator upgrade. Collect the following information prior to contacting the Support team:
    • Provide the current and target Orchestrator versions, for example: current version (i.e. 2.5.2 GA-20180430), target version (3.3.2 p2).
      Note: For the current version, this information can be found on the top, right corner of the Orchestrator by selecting the Help icon.
    • Provide a screenshot of the replication dashboard of the Orchestrator as shown below.
      • Hypervisor Type and version (i.e. vSphere 6.7)
      • Commands from the Orchestrator:
        Note: Commands must be run as root (e.g. sudo <command> or sudo -i).
        • Run the script /opt/vc/scripts/vco_upgrade_check.sh to check:
          • LVM layout
          • Memory Information
          • CPU Information
          • Kernel Parameters
          • Some system properties
          • ssh configurations
          • MySQL schema and database sizes
          • File_store locations and sizes
        • Copy of /var/log 
          tar -czf /store/log-`date +%Y%M%S`.tar.gz --newer-mtime="36 hours ago" /var/log
        • From the Standby Orchestrator: 
          sudo mysql --defaults-extra-file=/etc/mysql/velocloud.cnf velocloud -e 'SHOW SLAVE STATUS \G'
        • From the Active Orchestrator: 
          sudo mysql --defaults-extra-file=/etc/mysql/velocloud.cnf velocloud -e 'SHOW MASTER STATUS \G'
  3. Complete Orchestrator Upgrade: After you have complete the Orchestrator upgrade, select the Complete Orchestrator Upgrade button under Upgrade Actions. This re-enables the application of the configuration updates of Edges at the global level.
    Figure 3. Complete Orchestrator Upgrade
    1. To verify that the status of the upgrade is complete, run the following command to display the correct version number for all the packages: 
      dpkg -l|grep vco
    2. When you are logged in as an Operator, you can confirm if the same version displays by selecting the Help icon at the top right corner of the page.
    More information regarding how to upgrade the Orchestrator can be found in the following sections of the Arista Orchestrator Deployment and Monitoring Guide:
    • Upgrade VeloCloud Orchestrator with DR Deployment
    • Upgrade VeloCloud Orchestrator from Version 3.3.2 or 3.4 to Version 4.0