B.0 Upgrading/Migrating an All-in-One TeamWorks Deployment

Before You Upgrade!

Failure to comply with the following critical points could result in a non-functional TeamWorks system.

  • Verify the Appliance Version: Make sure that the appliance being upgraded is running TeamWorks 18.1.1 with the latest updates applied.

  • Review the Release Notes: Check Upgrade in the TeamWorks 18.2 Release Notes before you start the upgrade process.

  • Ensure that the VM host has enough unformatted disk space:

    • System Disk (/): A 20 GB disk is created automatically.

    • Disk 2 (/vastorage): You make a copy of the appliance’s Disk 2.

    • Each Disk 3 (/var): You create this disk. The recommended size is 4 GB plus 3 times the appliance’s RAM allocation.

  • Remove VMware Snapshots: Before copying Disk 2, make sure to remove all VMware snapshots so that the /vastorage disk has the correct disk file and latest configuration settings.

  • If the appliance has two network adapters: Do the following:

    1. Download the networkprep.zip file from the TeamWorks software downloads page.

    2. Enable SSH on the appliance, as described in Managing System Services in the TeamWorks 18.2: Administrative UI Reference.

    3. Using an SSH client (such as WinSCP), log in to the appliance as the root user.

    4. Copy the networkprep.zip file that you downloaded to the /root/ directory on the appliance.

    5. Unzip the networkprep.zip file:

      unzip networkprep.zip

      The networkprep folder is created.

    6. Change to the network prep folder:

      cd /root/networkprep

    7. Run the script:

      sh run-networkprep.sh

    8. Close the remote SSH connection to the appliance.

After ensuring that you have met the prerequisites and cautions above, complete the instructions in the following sections in order.