Upgrade the Virtual Appliance

When you upgrade the Virtual Appliance, it upgrades the components of Virtual Appliances. You might experience an outage up to one hour, so plan your upgrade accordingly.

Prepare to upgrade the Virtual Appliance

Complete the following steps to prepare the Virtual Appliance upgrade:

1. Download the Virtual Appliance upgrade OVA file from the Downloads portal.
2. Shutdown the Splunk AppDynamics, Anomaly Detection, and Cisco Secure Application services.
   

   appdcli stop secapp
   appdcli stop aiops
   appdcli stop appd
   <<Wait for pods to terminate before deleting operators>>
   appdcli stop operators

   CODE
3. Run the backup command:
   

   appdcli run backup

   CODE
   This command generates a <backup_tar> file with all the necessary data.
4. Copy the backup file outside of the cluster.
5. Power off the virtual machines that are running the Kubernetes cluster.
6. Rename the existing virtual machines to use their names for the new virtual machines.
7. Right click each virtual machine and select Edit Settings:
   1. In Virtual Hardware, expand Hard Disk 2.
   2. Note the Disk File name
      
8. Remove the data disk from the virtual machines.
   1. Right click on each virtual machine and select Edit Settings.
   2. In Virtual Hardware > Hard Disk 2, select Remove Device from the more options.
      

Upgrade the Virtual Appliance with the OVA File

Complete the following steps to upgrade the Virtual Appliance by using an OVA file:

1. Deploy three virtual machines by using the upgrade OVA file.
2. Delete the data disk of the new virtual machine:
   1. Go to Edit Settings.
   2. Select Hard Disk 2.
   3. Remove device
3. Attach the data disks of the previous virtual machines:
   1. Go to Edit Settings.
   2. Add a new device.
   3. Select Existing Hard Disk and specify the disk file name that you have noted earlier.
4. Enable VMware tools in the virtual machines to configure OVF properties.
   1. Select the Configure tab.
   2. Select vApp Options and click Edit.
   3. In Edit vApp Options > OVF Tools, select VMware Tools. See Edit OVF properties for a virtual machine.
5. Power on the new virtual machines.
6. Verify whether the deployment of virtual machines are successful:
   

   appdctl show boot

   CODE
    
   
   

   Ensure the status of the services in each node. If any service appears as Failed, restart that virtual machine. You might have to redeploy the virtual machine if it is still failing.

7. Create a three-node cluster:
   
   1. Run the following command in the primary node and specify the IP address of the peer nodes:
      

      appdctl cluster init <Node-2-IP> <Node-3-IP>

      CODE
   2. Run the following command to verify the node status:
      

      appdctl show cluster
      microk8s status

      CODE
      
      Ensure that the output displays the Running status as true for the nodes that are part of the cluster.
      

      Sample Output

        NODE           | ROLE  | RUNNING 
      ----------------+-------+---------
       10.0.0.1:19001 | voter | true    
       10.0.0.2:19001 | voter | true    
       10.0.0.3:19001 | voter | true  

      CODE
      

      You must re-login to the terminal if the following error appears:

      Insufficient Permissions to Access Microk8s 

      CODE
8. Verify whether the data directories exist in the following location:
   

   /var/appd/data

   CODE
9. Copy the <backup_tar> file to one of the cluster nodes that is generated earlier. See Prepare to Upgrade Virtual Appliance.
10. Run the following command to restore the persistent volumes specifications:
    

    appdcli run restore <backup_tar>

    CODE
11. Verify the PVC are in the Bound state by running the following command:
    

    kubectl get pvc -A

    CODE
12. Start the following services:
    

    appdcli start appd [Profile]

    CODE
    
    
    1. Cisco AppDynamics Services.
    2. Anomaly Detection Service.
    3. Cisco Secure Application Service.

After the upgrade, the cluster uses the existing data disk and becomes functional.