This page outlines the steps required to replace an OnSight vCollector from an AMI while preserving all existing checks and historical data associated with the original OnSight vCollector. This document assumes the user has a basic knowledge of Amazon Machine Images and/ or other disk images as well as basic knowledge of virtual machines provisioning.

Installation Procedure

The instructions below outline the procedure for replacing an existing OnSight.

1. Provision a new VM using the OnSight vCollector machine image.

2. Perform appropriate network configuration.

3. Obtain the customer key for your tenant - this may be found via the Control Panel by navigating to the portrait icon in the upper right corner of the navigation bar and looking under My Account. Note this for a later step.

4. Obtain the OnSight key for the current OnSight vCollector that will be replaced. This may be found by navigating to the details page for the OnSight vCollector in the Control Panel. Note this for a later step.

5. Shutdown the existing OnSight vCollector that is being replaced. The container or VM should be disabled to prevent any future registration issues with this appliance.

6. On the newly created OnSight vCollector, run the following commands from Root-level access (items in CAPS should be replaced with the respective key values saved in steps 3 and 4):

   1. onsight configure-collector --customer-key CUSTOMER-KEY-FROM-STEP-3

   2. onsight configure-collector --appliance-key ONSIGHT-KEY-FROM-STEP-4

   3. onsight start-vcollector

7. Return to the Control Panel, navigate to the details page of the OnSight vCollector, and verify data flow has been restored.