Insights On-Premises OVA-Based Upgrade Guide 8.x to 8.5

This guide explains the installation steps for the Insights On-premises (IOP) server. This article is part of the On-Premises Upgrade Guide 8.x to 8.5. Use this upgrade guide only if you:

Table of Contents:

Upgrade IOP Server

The IOP server can be deployed in two different modes - as a cluster or standalone. Each of these modes can run with static IP addresses (preferred) or with DHCP. This guide explains the upgrade steps for static IP addresses. 

Important: If you are using IOP server(s) in a DHCP environment, contact our Support team at support@controlup.com.

Upgrade a Standalone IOP Machine

This section describes the upgrade of a standalone machine that uses a static IP address. A standalone installation consists of only one machine therefore perform the upgrade on that dedicated IOP machine.

  1. Open your vCenter Client with a user that is assigned to the Administrator role.
  2. Create a new IOP server using the new OVA file with the version you want to upgrade to. In our case, version 8.5.
    Perform the installation according to the Insights On-Premises Virtual Appliance Installation - Version 8.5 guide.

    Note: During the installation process for the new IOP, you need to enter a unique display name for the virtual machine (see Step 5). Make sure that you choose a different display name as two machines can not have the same display name.

    Important: When entering the new template properties, provide the same details as the old appliance. For example, hostname, DNS domain, IP, Gateway, password, etc.

  3. Wait until the import and creation process of the new IOP server is finished. Do not turn on the machine yet. 
  4. SSH into your old IOP server. 
  5. Log in as the root user.
  6. Stop the IOP services by running the following command and wait until all services are stopped:
    iopcmd stop
    1.png

  7. Shut down the machine by running the following command:
    shutdown -P 0

  8. On the old IOP server, note the storage that is used.
    2.png

  9. Open the storage on which the old IOP server is hosted. Select the Datastores view on the IOP server and then click on the datastore the machine is on.
    3.png

  10. Select the Files tab and search the old IOP machine on the left side menu.
    4.png
  11. Select the vmdk file, which has the format [VirtualMachineName]_1.vmdk, and click Copy to.
    5.png

  12. In the Select Destination window, select the new IOP server and click OK. The copy of the virtual disk to the new IOP server starts.
    Important: Make sure to have enough free disk space on the destination datastore before you copy the vmdk file to the new IOP machine.
    6.png

  13. Click the Monitor tab > Tasks and watch the status of the copy process. Wait until the copy file task is finished.
    7.png

  14. Select the new IOP server from the left side menu and right-click on it. Select Edit Settings.
    8.png

  15. Click the X sign to remove the Hard disk 2 with 50 GB.
    9.png

    Check the Delete files from datastore checkbox to confirm the deletion of the device.
    10.png

  16. Click OK. Once the operation completes, proceed to the next step. 
  17. Right-click the new IOP server and select Edit Settings
  18. Click the ADD NEW DEVICE button on the top right-hand side of the screen and click the Existing Hard Disk option.
    11.png

  19. In the Select File screen, select the storage and the new IOP server. Select the VMDK that you copied in Step 12. Click OK to confirm the file. 
    12.png

  20. A new hard disk is shown in the settings. Confirm by clicking OK

    Note: The size of the new hard disk must be the same as the size of the exported HDD.


    13.png

  21. Wait until the reconfiguration task is finished.
    14.png

  22. Verify that the upgrade was successful.
    1)    Power on the new IOP machines and wait until the machine is booted. 
    2)    From your Real-Time Console, open the Insights portal by browsing the IP of the IOP server.
    3)    Log in to the portal and check if data that existed before the upgrade is shown in the portal.
  23. Install the new IOP Forwarder on all monitor machines by running the iop_forwarder-[IOPVersion].msi. Follow the installation instructions from the IOP Forwarder installation guide
  24. Remove the old IOP server once you confirm that old and new metrics data are shown in Insights.
    To delete the machine, open the vSphere client, right-click the old IOP virtual machine, and select Delete from Disk. 
    test.jpg


Click YES to delete the disk.
ConfirmDeletion1.png



Upgrade IOP Cluster Machines

This section describes the upgrade in a cluster environment that uses static IP addresses. In a clustered environment, you have a master node and one or more data nodes that all need to be upgraded. 

This section describes the upgrade for clustered IOP servers that use static IP addresses

Follow these steps for the master node and each data node.

Start with the upgrade of the master node:

  1. Open your vCenter Client with a user that is assigned to the Administrator role.
  2. Create a new IOP server using the new OVA file with the version you want to upgrade to. In our case, version 8.5.
    Perform the installation according to the Insights On-Premises Virtual Appliance Installation - Version 8.5 guide.

    Note: During the installation process for the new IOP, you need to enter a unique display name for the virtual machine (see Step 5). Make sure that you choose a different display name as two machines can not have the same display name.

    Important: When entering the new template properties for the master and data node(s), make sure to use the same virtual appliance password, hostname, DNS domain, IP/Subnet in CIDR notation, Default Gateway, and DNS settings as your old IOP machines.

    An example is shown below:
    StaticIPAddresses.png

  3. Wait until the import and creation process of the new IOP server is finished. Do not turn on the machine yet. 
  4. SSH into your old IOP machine.
  5. Log in as the root user.
  6. Stop the IOP services by running the following command and wait until all services are stopped:
    iopcmd stop
    1.png

  7. Shut down the machine by running the following command:
    shutdown -P 0
  8. On the old IOP server, note the storage that is used.
    iop_master.png

  9. Open the storage on which the old master node is hosted. Select the Datastores view on the old IOP server and then click on the datastore the machine is on.
    38_Datastore.jpg

  10. Select the Files tab and search the old IOP machine on the left side menu.
    FIleMaster.png
  11. Select the vmdk file, which has the format [VirtualMachineName]_1.vmdk, and click Copy to.
    FileMaster2.png

  12. In the Select Destination window, select the new IOP server and click OK. The copy of the virtual disk to the new IOP server starts.

    Important: Make sure to have enough free disk space on the destination datastore before you copy the vmdk file to the new IOP machine.


    Destination.png
  13. Click the Monitor tab > Tasks and watch the status of the copy process. Wait until the copy file task is finished.
    7.png

  14. Select the new IOP server from the left side menu and right-click on it. Select Edit Settings.
    EditSettingsNew.png
  15. Click the X sign to remove the Hard disk 2 with 50 GB.
    RemoveHDD.png
    Check the Delete files from datastore checkbox to confirm the deletion of the device.
    10.png
  16. Click OK. Once the operation completes, proceed to the next step. 
  17. Right-click the new IOP server and select Edit Settings
  18. Click the ADD NEW DEVICE button on the top right-hand side of the screen and click the Existing Hard Disk option.
    NewExistingDisk.png
  19. In the Select File screen, select the storage and the new IOP server. Select the VMDK that you copied in Step 12. Click OK to confirm the file. 
    ChooseNewHDD.png
  20. A new hard disk is shown in the settings. Click OK to confirm. 

    Note: The size of the new hard disk must be the same as the size of the exported HDD.


    NewHDD.png
  21. Wait until the reconfiguration task is finished. The upgrade of the master node is completed.
    ReConfigureOK.png

    The next step is to upgrade the data nodes. Before you can start to upgrade the data nodes, you need to follow these steps on each of the data nodes:

    On each data node:

    1. Remove the data containers by running this command
      docker stop iop_data && docker rm iop_data
      23_DataNodeStop.jpg
    2. Set the same password, new IP / DNS of the master node for each data node by running this command:
      iopcmd install -t data -pwd <SAME PASSWORD> -m <NEW_MASTER_IP>

      <SAME PASSWORD> is the password for the old appliance.
      <NEW_MASTER_IP> is the IP address of the new IOP master that we deployed in the previous chapter.
      25_DataNodeNewIP_OK.jpg
  22. Once you executed both commands from above on all your data nodes, create new data nodes by following steps 1-21 for each data node.
  23. Once you finish the deployment for all master/data nodes, verify that the upgrade was successful.
    1)    Power on all new IOP machines and wait until they are booted. 
    2)    From your Real-Time Console, open the Insights portal by browsing the IP of the master node.
    Important: If the IP of the new master node is different from the old master node, configure the new IP in the COP configuration. Go to the Control Panel, right-click ControlUp Server, and select Change
    ControlPanelIP.png
    In the configuration window, click Insights On-Premises (IOP) Configuration.
    InsightsConfiguration.png
    Enter the new IP address and, if changed as well, the folder for the Activity and Backup files. 
    InsightsNewConfiguration.png

    3)    Log in to the portal and check if data that existed before the upgrade is shown in the portal.
  24. Install the new IOP Forwarder by running the iop_forwarder-[IOPVersion].msi. Follow the installation instructions from the IOP Forwarder installation guide
    Important: If the IP of the new master node is different from the old master node, enter the new IP of the master node and, if changed, the new folder for the Activity files, in the IOP Forwarder installation wizard. 
    IOP_Forwarder_new_configuration.png
  25. Remove the old IOP server(s) once you confirm that old and new metrics data are shown in Insights. Open the vSphere client, right-click the old IOP virtual machine(s) and select Delete from Disk. 


DeleteFromDisk.png

Click YES to confirm the deletion of the old IOP machine and its associated disks.

ConfirmDeletion1.png

 

 

1-on-1 Demo
Schedule now
Price Quote
Get it now
Need a Script?
Get it here
Powered by Zendesk