Skip to main content
SnapCenter Software 6.0

Add hosts and install plug-in packages on remote hosts

Contributors netapp-nsriram netapp-soumikd

You must use the SnapCenter Add Host page to add hosts, and then install the plug-ins packages. The plug-ins are automatically installed on the remote hosts. You can add the host and install plug-in packages for an individual host.

Before you begin
  • If the operating system of the SnapCenter Server host is Windows 2019 and the operating system of the plug-in host is Windows 2022, you should perform the following:

    • Upgrade to Windows Server 2019 (OS Build 17763.5936) or later

    • Upgrade to Windows Server 2022 (OS Build 20348.2402) or later

  • You must be a user that is assigned to a role that has the plug-in install and uninstall permissions, such as the SnapCenter Admin role.

  • When installing a plug-in on a Windows host, if you specify a credential that is not built-in, or if the user belongs to a local workgroup user, you must disable UAC on the host.

  • You should ensure that the message queueing service is running.

  • The administration documentation contains information about managing hosts.

  • If you are using group Managed Service Account (gMSA), you should configure gMSA with administrative privileges.

About this task
  • You cannot add a SnapCenter Server as a plug-in host to another SnapCenter Server.

Steps
  1. In the left navigation pane, click Hosts.

  2. Verify that the Managed Hosts tab is selected at the top.

  3. Click Add.

  4. In the Hosts page, perform the following actions:

    For this field…​ Do this…​

    Host Type

    Select the type of host:

    • Windows

    • Linux

      Note The Plug-in for PostgreSQL is installed on the PostgreSQL client host, and this host can be on either a Windows system or a Linux system.

    Host name

    Enter the communication host name. Enter the fully qualified domain name (FQDN) or the IP address of the host. SnapCenter depends on the proper configuration of the DNS. Therefore, the best practice is to enter the FQDN.

    Credentials

    Either select the credential name that you created or create new credentials. The credential must have administrative rights on the remote host. For details, see the information about creating credentials.

    You can view details about the credentials by positioning your cursor over the credential name that you provided.

    Note The credentials authentication mode is determined by the host type that you specify in the Add Host wizard.
  5. In the Select Plug-ins to Install section, select the plug-ins to install.

    While using the REST API to install Plug-in for PostgreSQL, you must pass the version as 3.0. For example, PostgreSQL:3.0

  6. (Optional) Click More Options.

    For this field…​ Do this…​

    Port

    Either retain the default port number or specify the port number. The default port number is 8145. If the SnapCenter Server was installed on a custom port, that port number will be displayed as the default port.

    Note If you manually installed the plug-ins and specified a custom port, you must specify the same port. Otherwise, the operation fails.

    Installation Path

    The Plug-in for PostgreSQL is installed on the PostgreSQL client host, and this host can be on either a Windows system or a Linux system.

    • For the SnapCenter Plug-ins Package for Windows, the default path is C:\Program Files\NetApp\SnapCenter. Optionally, you can customize the path.

    • For the SnapCenter Plug-ins Package for Linux, the default path is /opt/NetApp/snapcenter. Optionally, you can customize the path.

    Skip preinstall checks

    Select this check box if you already installed the plug-ins manually and you do not want to validate whether the host meets the requirements for installing the plug-in.

    Add all hosts in the cluster

    Select this check box to add all the cluster nodes.

    Use group Managed Service Account (gMSA) to run the plug-in services

    For Windows host, select this check box if you want to use group Managed Service Account (gMSA) to run the plug-in services.

    Note Provide the gMSA name in the following format: domainName\accountName$.
    Note gMSA will be used as a log on service account only for SnapCenter Plug-in for Windows service.
  7. Click Submit.

    If you have not selected the Skip prechecks checkbox, the host is validated to verify whether the host meets the requirements for installing the plug-in. The disk space, RAM, PowerShell version, .NET version, location (for Windows plug-ins), and Java version (for Linux plug-ins) are validated against the minimum requirements. If the minimum requirements are not met, appropriate error or warning messages are displayed.

    If the error is related to disk space or RAM, you can update the web.config file located at C:\Program Files\NetApp\SnapCenter WebApp to modify the default values. If the error is related to other parameters, you must fix the issue.

    Note In an HA setup, if you are updating web.config file, you must update the file on both nodes.
  8. If host type is Linux, verify the fingerprint, and then click Confirm and Submit.

    In a cluster setup, you should verify the fingerprint of each of the nodes in the cluster.

    Note Fingerprint verification is mandatory even if the same host was added earlier to SnapCenter and the fingerprint was confirmed.
  9. Monitor the installation progress.

    • For Windows plug-in, the install and upgrade logs are located at: C:\Windows\SnapCenter plugin\Install<JOBID>\_

    • For Linux plug-in, the install logs are located at: /var/opt/snapcenter/logs/SnapCenter_Linux_Host_Plug-in_Install<JOBID>.log_ and the upgrade logs are located at: /var/opt/snapcenter/logs/SnapCenter_Linux_Host_Plug-in_Upgrade<JOBID>.log_