English

Setup and deploy the agent

Contributors netapp-rlithman Download PDF of this page

You must deploy the Converged Systems Advisor agent on a VMware ESXi server. The agent collects configuration data about each device in your FlexPod converged infrastructure and sends that data to the Converged Systems Advisor portal.

Download and install the agent

You must deploy the Converged Systems Advisor agent on a VMware ESXi server.

About this task

To minimize bandwidth usage, you should install the agent on a VMware ESXi server that is in the same data center as the FlexPod configuration. The agent must have connectivity to each FlexPod component and to the internet so it can send configuration data to the Converged Systems Advisor portal using HTTPS port 443.

The agent is deployed as a VMware vSphere virtual machine from an Open Virtualization Format (OVF) template. The template is Debian-based with 1 vCPU and 2 GB of RAM (more may be needed for multiple or larger FlexPod systems).

Steps
  1. Download the agent:

    1. Log in to the Converged Systems Advisor portal.

    2. Click Download Agent.

  2. Install the agent by deploying the OVF template on the VMware ESXi server.

    On some versions of VMware, you might receive a warning when deploying the OVF template. The virtual machine was developed on the latest version of VCenter with hardware compatibility for older versions, which might result in the warning. You should review the configuration options prior to acknowledging the warning and then proceed with installation.

Set up networking for the agent

You must ensure that networking is set up correctly on the agent virtual machine to enable communication between the agent and FlexPod devices and between the agent and several internet endpoints. Note that the networking stack is disabled on the virtual machine until the system initializes.

Steps
  1. Ensure that an outbound internet connection enables access to the following endpoints:

    • csa.netapp.com

    • docker.com

    • docker.io

  2. Log in to the agent’s virtual machine console using the VMware vSphere client.

    The default user name is csa and the default password is netapp.

    For security purposes, SSHD is disabled by default.
  3. When prompted, change the default password and make note of the password, because it cannot be recovered.

    After you change the password, the system reboots and starts the agent software.

  4. If DHCP is not available in the subnet, configure a static IP address and DNS settings using standard Debian tools, and then reboot the agent.

    The network configuration for the Debian virtual machine defaults to DHCP. NetworkManager is installed and provides a text user interface that you can start from the command nmtui (see the man page for more details).

    For additional help with networking, see the network configuration page on the Debian wiki.

  5. If your security policies dictate that the agent must be on one network to communicate with FlexPod devices and another network to communicate with the internet, add a second network interface in VCenter and configure the correct VLANs and IP addresses.

  6. If a proxy server is required for internet access, run the following command:

    sudo csa_set_proxy

    The command generates two prompts and shows the required format for the proxy entry. The first prompt enables you to specify an HTTP proxy, while the second enables you to specify an HTTPS proxy.

    Enter the HTTP proxy below using the format:
    http://user:password@proxy-server:proxy-port

    Leave blank if no HTTP proxy is required for internet access.

  7. Once the network is up, wait approximately 5 minutes for the system to update and start.

    A broadcast message appears on the console when the agent is operational.

  8. Verify connectivity by running the following CLI command from the agent:

    curl -k https://www.netapp.com/us/index.aspx

    If the command fails, verify DNS settings. The agent virtual machine must have a valid DNS configuration and the ability to reach csa.netapp.com.

Install an SSL certificate on the agent

Optional: If needed, install an SSL certificate on the agent.

The agent creates a self-signed certificate when the virtual machine boots for the first time. If required, you can delete that certificate and use your own SSL certificate.

About this task

Converged Systems Advisor supports the following:
* Any cipher compatible with OpenSSL version 1.0.1 or greater
* TLS 1.1 and TLS 1.2

Steps
  1. Log in to the agent’s virtual machine console.

  2. Navigate to /opt/csa/certs

  3. Delete the self-signed certificate that the agent created.

  4. Paste your SSL certificate.

  5. Restart the virtual machine.

Configure the agent to discover your FlexPod infrastructure

You must configure the agent to collect configuration data from each device in your FlexPod converged infrastructure.
The agent requires credentials to collect configuration data. You must provide the credentials when you configure the agent.

Steps
  1. Open a web browser and enter the IP address of the agent virtual machine.

  2. Log in to the agent with the customer’s NetApp Support Site account user name and password.

    For any partners deploying a licensed version of CSA on behalf of their customer, it’s important for the customer’s account to be used in this step (for NetApp Support and records management).
  3. Add the FlexPod devices that you want the agent to discover.

    You have two options:

    1. Click Add a device to enter details about your FlexPod devices, one by one.

    2. Click Import devices to fill out and upload a CSV template that includes details about all devices.

      Note the following:
      * The user name and password should be for the account that you previously created for the device.
      * If your UCS environment has LDAP user management configured, then you must add the user’s domain before the user name. For example: local\csa-readonly

Result

Each device in the FlexPod infrastructure should display in the table with a checkmark.
Shows each required device with a green checkmark in the Status column.