English

Cloud Secure Agent Installation

Contributors netapp-alavoie dgracenetapp Download PDF of this page

Cloud Secure collects user activity data using one or more agents. Agents connect to devices in your environment and collect data that is sent to the Cloud Secure SaaS layer for analysis. See Agent Requirements to configure an agent VM.

Before You Begin

  • The sudo privilege is required for installation, running scripts, and uninstall.

Steps to Install Agent

  1. Log in as Administrator or Account Owner to your Cloud Secure environment.

  2. Click Admin > Data Collectors > Agents > +Agent

    The system displays the Add an Agent page:

    Add agent 1
  3. Select the operating system on which you are installing the agent.

  4. Verify that the agent server meets the minimum system requirements.

  5. To verify that the agent server is running a supported version of Linux, click Versions Supported (i).

    add agent 2
  6. Click the Copy to Clipboard icon to copy the installation command.

  7. Run the installation command in a terminal window.

  8. The system displays the following message when the installation completes successfully:

    new agent detect
After You Finish
  1. You need to configure a User Directory Collector .

  2. You need to configure one or more Data Collectors.

Network Configuration

Use the following commands to open ports to be used by Cloud Secure.

Steps
  1. sudo firewall-cmd --permanent --zone=public --add-port=35000-55000/tcp

  2. sudo firewall-cmd --reload

  3. sudo iptables-save | grep 35000

    sample output:
    -A IN_public_allow -p tcp -m tcp --dport 35000 -m conntrack -ctstate NEW -j ACCEPT

Troubleshooting Agent Installation Errors

Known problems and their resolutions are described in the following table.

Problem: Resolution:

Agent installation fails with error:
"File name too long" errror

To correct this error use the bash shell to run the command.

Agent installation fails to create the /opt/netapp/cloudsecure/agent/logs/agent.log folder and the install.log file provides no relevant information.

This error occurs during bootstrapping of the agent. The error is not logged in log files because it occurs before logger is initialized.
The error is redirected to standard output, and is visible in the service log using the journalctl -u cloudsecure-agent.service command. This command can be used for troubleshooting the issue further.

Agent installation fails with ‘This linux distribution is not supported. Exiting the installation’.

The supported platforms for Cloud Secure 1.0.0 are RHEL 7.x / CentOS 7.x. Ensure that you are not installing the agent on a RHEL 6.x or CentOS 6.x system.

Agent Installation failed with the error:
"-bash: unzip: command not found"

Install unzip and then run the installation command again. If Yum is installed on the machine, try “yum install unzip” to install unzip software

Agent Installation failed with the error:
"Adding cssys user to docker group
Usermod: group ‘docker’ does not exist"

Install Docker service and then run the installation command again.