Skip to main content
SnapCenter 4.9 cmdlets

Install-SmHostPackage

Contributors

Installs or upgrades a host plug-in package on one or more hosts.

Syntax

Install-SmHostPackage [-HostNames]  <String>  [-PluginCodes]  <UploadedPluginCode>  [-PluginVersions]  <Hashtable>  [-InstallPath]  <String>  [-SkipPreinstallChecks]  <SwitchParameter>  [-GMSAName]  <String>  [-Force]  <SwitchParameter>

Detailed Description

Installs or upgrades a host plug-in package on one or more hosts. When specifying multiple hosts, all hosts must have the same OS.

Parameters

Name Description Required? Pipeline Input Default Value

HostNames

Specifies the hosts on which you want to install or upgrade the plug-in. You can specify one host, or multiple, comma-separated host names. Host names must be entered using the format -HostNames @("hostname") when installing to a single host, or -HostNames @("hostname1", "hostname2") when installing to multiple hosts. You can specify the hostname using either the host FQDN or IP address.

true

true (ByPropertyName)

PluginCodes

Specifies the code for one or more plug-ins in the packages that you want to install. The following values are valid: SCSQL, SCO, SCW, SCE and hana.For custom plug-ins, the value is the custom plug-in name. For example "CustomPlugin1".You can use a comma-separated list of plug-in codes to install multiple plug-ins.

true

true (ByPropertyName)

PluginVersions

Specifies in a hash table the custom plug-in name and the version to install. The PluginVersions parameter uses the format @{"customplugin" = "4.0"}

false

true (ByPropertyName)

InstallPath

Specifies the plug-in installation path, if the path different from the default.

false

true (ByPropertyName)

SkipPreinstallChecks

Specifies that installation prechecks will not be triggered.

false

true (ByPropertyName)

GMSAName

Specifies that group Managed Service Account (gMSA) name will be used to run the plug-in services.

false

true (ByPropertyName)

Force

Internal switch.

false

true (ByPropertyName)

Examples

Example 1: Installing SnapCenter Plug-in for Microsoft SQL Server and SnapCenter Plug-in for Microsoft Windows on a Windows host

 Install-SmHostPackage -HostNames @("host2012r2.mycompany.com") -PluginCodes SCSQL,SCW

This example syntax installs SnapCenter Plug-in for Microsoft SQL Server and SnapCenter Plug-in for Windows on the specified host.

Example 2: Installing SnapCenter Plug-in for Microsoft SQL Server and SnapCenter Plug-in for Microsoft Windows on multiple hosts

 Install-SmHostPackage -HostNames @("sql-1.mycompany.com", "sql-2.mycompany.com") -PluginCodes SCSQL,SCW

This example syntax installs SnapCenter Plug-in for Microsoft SQL Server and SnapCenter Plug-in for Microsoft Windows on multiple hosts.

Example 3: Installing a custom plug-in with SnapCenter Plug-in for Oracle and SnapCenter Plug-in for Unix on a Linux host

 Install-SmHostPackage -HostNames("scspr0098708001.englab.mycompany.com") -PluginCodes CustomPlugin1,SCO -InstallPath /opt/NetApp/snapcenter/ -PluginVersions  @{"customplugin1" = "2.0"}

This example syntax installs a custom plug-in along with SnapCenter Plug-in for Oracle and SnapCenter Plug-in for Unix on a Linux host.

Example 4: Installing SnapCenter Plug-in for Microsoft Exchange Server

 Install-SmHostPackage -HostNames Exchange2016DAG -PluginCodes SCE,SCW -Verbose

This example syntax installs SnapCenter Plug-in for Microsoft Exchange Server on the specified host.

Example 5: Installing SnapCenter Plug-in for SAP HANA Database on the same Windows host

 Install-SmHostPackage -HostNames 'Windows.Host.lab.com' -PluginCodes hana,SCW

This example syntax installs the SnapCenter Plug-in for SAP HANA Database on the same host where SnapCenter Server is installed.

Example 6: Installing SnapCenter Plug-in for SAP HANA database on a remote host

 Install-SmHostPackage -HostNames 'Host.fqdn.lab.com' -PluginCodes hana

This example syntax installs the SnapCenter Plug-in for SAP HANA Database on the specified remote host (Windows and Linux).

Example 7: Installing SnapCenter Plug-in for Oracle Database on a AIX host

 Install-SmHostPackage -HostNames 'aix207-193.gdl.englab.netapp.com' -PluginCodes SCO

This example syntax installs the SnapCenter Plug-in for Oracle Database on the specified AIX host. Plugin code SCC is not supported.

Example 8: Installing SnapCenter Plug-in for Microsoft SQL Server and SnapCenter Plug-in for Microsoft Windows on a Windows host to run with group Managed Service Account (gMSA)

 Install-SmHostPackage -HostNames 'host2012r2.NewDomain.com' -PluginCodes SCSQL,SCW -GMSAName 'NewDomain\gMSAName$'

This example syntax installs SnapCenter Plug-in for Microsoft SQL Server and SnapCenter Plug-in for Windows to run with the mentioned group Managed Service Account (gMSA) name on the specified host.