Adding Acquisition Units Edit on GitHub Request doc changes

Contributors dgracenetapp netapp-alavoie

Cloud Insights collects device data using one or more Acquisition Units installed on local servers. Each Acquisition Unit can host multiple Data Collectors, which send device metrics to Cloud Insights for analysis.

This topic describes how to add Acquisition Units and describes additional steps required when your environment uses a proxy.

Adding a Linux Acquisition Unit

Before you begin
  • If your system is using a proxy, you must set the proxy environment variables before the acquisition unit is installed. For more information, see Setting proxy environment variables.

  • You must have an unzip program to unzip the downloaded files.

Steps for Linux Acquisition Unit Installation
  1. Log in as Administrator or Account Owner to your Cloud Insights environment.

  2. Click Admin > Data Collectors > Acquisition Units > +Acquisition Unit

    The system displays the Add Acquisition Unit dialog. Choose Linux.

add acq linux1
  1. Verify that the server or VM hosting the Acquisition Unit meets the minimum system requirements.

  2. Verify that the server is running a supported version of Linux, click Versions Supported (i).

  3. Copy the Installation command displayed in the dialog into a terminal window on the server or VM that will host the Acquisition unit.

  4. Execute the command in the Bash shell.

After you finish
  • Click Admin > Data Collectors > Acquisition units to check the status of Acquisition Units.

  • You can access the Acquisition Unit logs at /var/log/netapp/cloudinsights/acq/acq.log

  • Use the following script to control the Acquisition Unit:

    • cloudinsights-service.sh (stop, start, restart, check the status)

  • Use the following script to uninstall the Acquisition Unit:

    • cloudinsights-uninstall.sh

Setting proxy environment variables

For environments that use a proxy, you must set the proxy environment variables before you add the Acquisition Unit. The instructions for configuring the proxy are provided on the Add Acquisition Unit dialog.

  1. Click + in Have a Proxy Server?

  2. Copy the commands to a text editor and set your proxy variables as needed.
    + Note: Restrictions on special characters in proxy username and password fields: '%' and '!' are allowed in the username filed. ':', '%', and '!' are allowed in the password field.

  3. Run the edited command in a terminal using the Bash shell.

  4. Install the Acquisition Unit software.

Adding a Windows Acquisition Unit

Steps for Windows Acquisition Unit Installation
  1. Log in to the Acquisition Unit server/VM as a user with Administrator permissions.

  2. On that server, open a browser window and log in to your Cloud Insights environment as Administrator or Account Owner.

  3. Click Admin > Data Collectors > Acquisition Units > +Acquisition Unit .

    The system displays the Add Acquisition Unit dialog. Choose Windows.

add acq windows
  1. Verify that the server or VM hosting the Acquisition Unit meets the minimum system requirements.

  2. Verify that the server is running a supported version of Windows click Versions Supported (i).

  3. Click the Download Installer (Windows 64-bit) button.

  4. Copy the Installation command snippet in the dialog and paste it into a command prompt window on the Acquisition Unit server. You can click the clipboard icon to copy the full command to the clipboard.

    The snippet installs the Acquisition Unit software on the server.

After you finish
  • Click Admin > Data Collectors > Acquisition units to check the status of Acquisition Units.

  • You can access the Acquisition Unit log in <install dir>\Cloud Insights\Acquisition Unit\log\acq.log

Reinstalling an Acquisition Unit

To re-install an Acquisition Unit on the same server/VM, you must follow these steps:

Before you begin

You must have a temporary Acquisition Unit configured on a separate server/VM before re-installing an Acquisition Unit.

Steps
  1. Log in to the Acquisition Unit server/VM and uninstall the AU software.

  2. Log into your Cloud Insights environment and go to Admin > Data Collectors.

  3. For each data collector, click the Options menu on the right and select Edit. Assign the data collector to the temporary Acquisition Unit and click Save.

    You can also select multiple data collectors of the same type and click the Bulk Actions button. Choose Edit and assign the data collectors to the temporary Acquisition Unit.

  4. After all of the data collectors have been moved to the temporary Acquisition Unit, go to Admin > Data Collectors and select the Acquisition Units tab.

  5. Click the Options button to the right of the Acquisition Unit you wish to re-install, and select Delete. You can delete an Acquisition Unit only if there are no data collectors assigned to it.

  6. You can now re-install the Acquisition Unit software on the original server/VM. Click +Acquisition Unit and follow the instructions above to install the Acquisition Unit.

  7. Once the Acquisition Unit has been re-installed, assign your data collectors back to the Acquisition Unit.