Install the Windows Toolkit on a Server

You must log in to the host with adminstrator privileges. When you provide group credentials for the array, those credentials must have Power User or above privileges.

HPE recommends that you install all prerequisites that apply to your hosts before you install the HPE Storage Toolkit for Windows. Doing so minimizes the number of host reboots.

Important points to remember:
  • If your Windows host currently runs Windows Server 2008 R2 and you plan to upgrade to Windows Server 2012, upgrade to Windows Server 2012 first, and then install the HPE Storage Toolkit for Windows.
  • When installing HPE Storage Toolkit for Windows on a Windows Server Core host, the Hotfix Report cannot be accessed from the Microsoft Hotfixes dialog box, because the link launches a default web browser that is not available on Server Core hosts.

    To see what hotfixes you may need to install, view the Missing Hotfix Report in the C:\hotfix_report file.

  • In a Windows cluster environment, install the same version of HPE Storage Toolkit for Windows on all nodes in the cluster. Then, it is recommended that you run a cluster validation after installation.

    Refer to the Microsoft Windows Server Library article cc772055 for more information.

You can install the toolkit using the installer that is packaged with the toolkit. The installer takes you through the installation process and prompts you to select the features you want to install with the toolkit, such as Host Diagnostics.
  1. Open the Setup-HPEStorage-x64.x.x.x.x.zip file and extract the Setup-HPEStorage-x64.x.x.x.x.exe installer file.
  2. On the Windows host, right-click the installer file and choose Run as administrator.
  3. In the Welcome to the InstallShield Wizard dialog, click Next.
  4. In the License Agreement dialog, choose I accept the terms of the license agreement and click Next.
    IMPORTANT: You must accept the End User License Agreement (EULA) to install the toolkit.
  5. In the Microsoft Hotfixes dialog box, do one of the following:
    • Click Hotfix Report to launch a local web page that displays the Windows Server hotfix list with links for downloading.
    • Click Recommended Hotfix list to view the current list of recommended hotfixes.
    The hotfix list contains links to individual Microsoft Knowledge Base articles that explain the required hotfixes.
    IMPORTANT: The HPE Storage Toolkit for Windows installer checks for hotfixes. You need to install or update any missing or out-of-date hotfixes on your Windows host. (Several reboots may be required.) Hotfixes contain critical patches for the Windows disk, iSCSI, and MPIO stacks. Failure to install all listed hotfixes may lead to unexpected connectivity issues.
  6. Click Next.
  7. In the Logs Directory dialog box, do one of the following to set the logs location:
    • Click Next to accept the default logs location.
    • Click Change, browse to the desired directory, click OK, then click Next.
  8. Determine which features to install based on your connection method.

    You can customize your setup depending on whether you want to run iSCSI or Fibre Channel connections. In the Feature Selection dialog box, select the components you want to install.

    Connection methods, features, and descriptions are described below.

    Table 1. The Toolkit Feature Selection Options
    Connection Method Features
    iSCSI HPE Storage Setup Manager

    Enables first-time setup of the array associated with this installation of the toolkit.
    Windows Integration (Always installed)

    Collects logs from the Windows host for HPE Support.

    NOTE: This component cannot be deselected and is installed by default.
    DSM for MPIO (Required)

    The DSM for MPIO allows independent installation of modules for multipath I/O. Enables installation of DSM. Selects the optimal path for each I/O request. Also installs the Application Aware Data Management cmdlets* and creates a shortcut. Must be selected to choose installation of the sub-components, HPE VSS Service and Connection Manager for iSCSI.

    • VSS Service (Optional) — Provides snapshot support using HPE VSS requestor and VSS hardware provider. Enables highly efficient, application-consistent backups.
      NOTE: You must be running HPE Storage Toolkit for Windows 5.0.0 or later and version 5.0.1.0 or later to use VSS for vVols. Starting with 7.0.0, you must provide the host with the credentials used by the array, or application-synchronized snapshot creation operations fail. The array user must have credentials Power User or above.

      Any third-party backup and recovery software that uses VSS for restore can now leverage the restore functionality available through VSS Hardware Provider.

    • HPE Storage Connection Management for iSCSI (Required) — Helps you make iSCSI connections between the Windows host and the array. Monitors changes over time and adjusts the number of connections as needed. (Applies only to iSCSI connections, and is not installed for FC.)
    Host Diagnostics (Optional)

    Allows you to collect diagnostic information about the host and provide it to HPE Support if you encounter a problem. You access this tool through the GUI for the array. If you select the option to use Host Diagnostics, you must register the host by providing the array Group Management IP address and the credentials. Host Diagnostics supports up to 48 Windows hosts for each array. You must have Power User or above credentials to set up and use Host Diagnostics.
    Fibre Channel HPE Storage Setup Manager

    Enables first-time setup of the array associated with this installation of the toolkit.

    Windows Integration (Always installed)

    Collects logs from the Windows host for HPE Support.

    NOTE: The Windows Integration component cannot be deselected, and is installed by default.
    DSM for MPIO (Required)

    DSM for MPIO allows independent installation of modules for multipath I/O. Enables installation of DSM. Selects the optimal path for each I/O request. Also installs PowerShell cmdlets* and creates a shortcut. Must be selected to choose installation of the sub-components, HPE VSS Service or Connection Manager for iSCSI*.

    • VSS Service (Optional) — Provides snapshot support using HPE VSS requestor and VSS hardware provider. Enables highly efficient, application-consistent backups.
      NOTE: You must be running 5.0.0 or later and array OS version 5.0.1.0 or later to use VSS for vVols. Starting with 7.0.0, you must provide the host with the credentials used by the array, or application-synchronized snapshot creation operations will fail. The array user must have credentials Power User or above.

      Any third-party backup and recovery software that uses VSS for restore can now leverage the restore functionality available through the HPE VSS Hardware Provider.

      NOTE: VSS Hardware Provider version 4.x only supports arrays running array OS version 4.1 or later.
    • HPE Storage Connection Management for iSCSI* (Not Selected - iSCSI Initiator is not running)
    Host Diagnostics (Optional)

    Allows you to collect diagnostic information about the host and provide it to HPE Support if you encounter a problem. You access this tool through the GUI for the array. If you select the option to use Host Diagnostics, you must register the host by providing the array Group Management IP address and the credentials. Host Diagnostics supports up to 48 Windows hosts for each array. You must have Power User or above credentials to set up and use Host Diagnostics.

    * The installer automatically detects whether the iSCSI initiator service is running on the host to determine the setup. If no iSCSI initiator service is running, the Connection Management for iSCSI feature is not selected for installation (and is not needed in a Fibre Channel environment). You can add the Connection Management for iSCSI later if your environment changes.

  9. Deselect any components that you do not want to install, and click Install.
    NOTE: If you are installing on a Windows 2008 R2 host and PowerShell 3.0 is not detected, you receive the message: PowerShell 3.0 was not detected on this machine.
  10. Click OK in the message box.
  11. Review the HPE VSS Provider outbound ports, then click OK to confirm and proceed.
  12. Review the proposed MPIO and MSDSM registry key changes, then click OK to confirm and proceed.
    The HPE Storage Toolkit for Windows software installs itself on the Windows host. This process may take a few minutes. The installer log is saved to the C:\Install.log file.
  13. (VSS requirement) In HPE Storage Toolkit for Windows 7.0.0 and later, you must provide the Group Management IP address and the username/password credentials for the array if you want to use the application-synchronized snapshot creation feature of VSS. You must register at least one group. The array user should have Power User or above credentials.
    If you do not do provide this information when you set up HPE Storage Toolkit for Windows, you can use PowerShell cmdlet Set-Configuration to specify the array credentials.
  14. (Host Diagnostics requirement) If you are using Host Diagnostics, you must configure a TCP/IP port that allows the host to communicate with the array. You can enter any available port number that works with your configuration. The default port is 21344.
    A Host Diagnostics agent inbound and outbound rule is added to the Windows Defender firewall. For information about these rules, see Manually Specify a TCP Port for Host Diagnostics.
  15. (Host Diagnostics requirement) The InstallShield Wizard displays the Setup Complete dialog box. If you selected the Host Diagnostics feature, the wizard automatically starts the Host Diagnostics Registration Tool to enable you to register the Windows host with the group. If you do not want to register the host at this time, select Skip. Otherwise, go to Step 16.
    You can run the Host Diagnostics Registration Tool later to register the host with a group or to unregister the host from a group.
    NOTE: You cannot use the HPE Storage Toolkit for Windows PowerShell cmdlet Set-Configuration to enter the array credentials for the Host Diagnostics feature.
  16. (Host Diagnostics requirement) To register the Windows host with the group, enter the Group Management IP address and the username/password credentials for the array and select Register.
    • If you set up VSS during the HPE Storage Toolkit for Windows installation, you can select that IP address from the drop-down list.
    • If you want to use a different group, select Add new group and enter the IP address and credentials for the group you want to use. These credentials must have Power User or above privileges.
  17. (Host Diagnostics requirement) A message appears stating that the registration was successful. Click OK.
  18. (Host Diagnostics requirement) The Host Diagnostics Registration Tool gives you the option of unregistering the host. Select Close. The Host Diagnostics Registration Tool returns you to the Install Shield Wizard.
  19. The InstallShield Wizard displays the Setup Complete dialog box. Click Finish.
  20. Choose an option to restart your host:
    • Click Yes to restart now.

      or

    • Click No to restart later.
    NOTE: You must reboot the Windows host for the DSM Kernel Driver to take effect.
If you installed HPE Storage Toolkit for Windows on a 2008 R2 server that does not have PowerShell 3.0 installed, download the Windows Management Framework 3.0 from Microsoft:

https://www.microsoft.com/en-in/download/details.aspx?id=34595

  • In the Microsoft web page, click Download.
  • Select Windows6.1-KB2506143-x64.msu from the list of packages.
  • Click Next, then install the package.

The Application Aware Data Management cmdlets can now be launched.