Dell EqualLogic PS6210XS EqualLogic Host Integration Tools for Microsoft Editi - Page 17

Syntax for PowerShell Remote Host Installation, ICMPv4, Option, Description

Page 17 highlights

You can select the same installation options that the regular Windows installer allows. You can install MPIO alone because it does not require ASM/ME. If you install ASM/ME, then RSW and VSS, the ASMCLI will automatically be installed as well. If you do not specify these components, you will be prompted accordingly. To use a PowerShell script to install the Host Integration Tools, the following prerequisites must be met: • PowerShell version 2.0 or later is required. You need PowerShell only on the machine from which you are running the install script. • In order for new installations to run successfully on remote hosts, ensure that you allow incoming ping requests through the remote host's firewall to the remote host. Use Windows Server Manager to create new inbound rules for your firewall. Select ICMPv4 or ICMPv6 protocol types for IPv4 and IPv6 pings, respectively. If both the local and remote hosts are in the same domain, allow the connections over the domain profile type. • You will be prompted for user name and password credentials in order to install Host Integration Tools on remote hosts added to the HIT Group. These credentials are never stored; they are only used for the installation. The following requirements must be met: • If you are installing on a cluster, you must provide the appropriate credentials (domain user with local administrator rights) across all cluster nodes. • If adding or installing on multiple hosts: • Single Domain - For multiple machines that belong to a single domain, you must provide the appropriate user credentials (domain users with local admin rights) so that ASM/ME can successfully access the machines to perform the required installations. • Single Workgroup - For multiple machines that belong to a single workgroup, each machine must have the same local admin account credentials. • Multiple Domains - For machines across multiple domains, add or install on all the machines from one domain at a time. • The Remote Procedure Call (RPC) service must be running. This service should be started by default on Windows systems. If it is not running, or if the firewall is blocking it, the installation will not work. • Copy the Setup.exe and Setup64.exe installation files into a directory of your choice. Because you must specify this directory multiple times if you are pushing out several installations, you can simplify the process by copying the installation files onto a network shared directory. (The default installation directory is C:\Program Files\EqualLogic\bin, so you can also place it there). ASM/ME will use these files to initiate the installation procedure on remote hosts. These installation files are available on the CD-ROM that shipped with your PS Series array, or from the customer support site: support.dell.com/equallogic Syntax for PowerShell Remote Host Installation HitRemoteInstall.ps1 [-ComputerNames "computer 1 computer 2 ..."] [-InstallerLocation "path"] [-BackupDocumentLocation "path"] [-InstallOptions "Install Option 1 Install Option 2 ..."] [-UserName "Domain\Username"] [-Password "Password"] The BackupDocumentLocation parameter allows you to specify the backup document directory. This directory is especially important for cluster installations, for which a network share must be specified. For information about backup document directories and cluster configurations, see the Dell EqualLogic Auto-Snapshot Manager/Microsoft Edition User's Guide. When specifying host names, you can specify the host's IP address, host name, fully qualified domain name, or IPv6 address. Specify an IPV6 address as follows: 1. Change all the : characters to - characters. 2. If the address has a % character, change it to s. 3. Add .ipv6-literal.net to the end. For example, an address of fe80::2c02:db79%8 must be specified as fe80-2c02-db79s8.ipv6-literal.net. The following table lists the install options that you can specify when running the PowerShell script. Table 3. Install Options Option ALL Description Installs all options listed in this table RSW Remote Setup Wizard VSS Volume Shadow Copy Service Provider ASMCLI ASM/ME Command Line Interface Installation 17

  • 1
  • 2
  • 3
  • 4
  • 5
  • 6
  • 7
  • 8
  • 9
  • 10
  • 11
  • 12
  • 13
  • 14
  • 15
  • 16
  • 17
  • 18
  • 19
  • 20
  • 21
  • 22
  • 23
  • 24
  • 25
  • 26
  • 27
  • 28
  • 29
  • 30
  • 31
  • 32
  • 33
  • 34
  • 35
  • 36
  • 37
  • 38
  • 39
  • 40
  • 41
  • 42
  • 43
  • 44
  • 45
  • 46
  • 47
  • 48
  • 49
  • 50
  • 51
  • 52
  • 53
  • 54
  • 55
  • 56
  • 57
  • 58
  • 59
  • 60
  • 61
  • 62
  • 63
  • 64
  • 65
  • 66
  • 67
  • 68
  • 69

You can select the same installation options that the regular Windows installer allows. You can install MPIO alone because it does not
require ASM/ME. If you install ASM/ME, then RSW and VSS, the ASMCLI will automatically be installed as well. If you do not specify
these components, you will be prompted accordingly.
To use a PowerShell script to install the Host Integration Tools, the following prerequisites must be met:
PowerShell version 2.0 or later is required. You need PowerShell only on the machine from which you are running the install script.
In order for new installations to run successfully on remote hosts, ensure that you allow incoming ping requests through the remote
host’s firewall to the remote host. Use
Windows Server Manager
to create new inbound rules for your firewall. Select
ICMPv4
or
ICMPv6
protocol types for IPv4 and IPv6 pings, respectively. If both the local and remote hosts are in the same domain, allow the
connections over the domain profile type.
You will be prompted for user name and password credentials in order to install Host Integration Tools on remote hosts added to the
HIT Group. These credentials are never stored; they are only used for the installation. The following requirements must be met:
If you are installing on a cluster, you must provide the appropriate credentials (domain user with local administrator rights) across
all cluster nodes.
If adding or installing on multiple hosts:
Single Domain — For multiple machines that belong to a single domain, you must provide the appropriate user credentials
(domain users with local admin rights) so that ASM/ME can successfully access the machines to perform the required
installations.
Single Workgroup — For multiple machines that belong to a single workgroup, each machine must have the same local admin
account credentials.
Multiple Domains — For machines across multiple domains, add or install on all the machines from one domain at a time.
The Remote Procedure Call (RPC) service must be running. This service should be started by default on Windows systems. If it is not
running, or if the firewall is blocking it, the installation will not work.
Copy the
Setup.exe
and
Setup64.exe
installation files into a directory of your choice. Because you must specify this directory
multiple times if you are pushing out several installations, you can simplify the process by copying the installation files onto a network
shared directory. (The default installation directory is
C:\Program Files\EqualLogic\bin
, so you can also place it there).
ASM/ME will use these files to initiate the installation procedure on remote hosts. These installation files are available on the CD–ROM
that shipped with your PS Series array, or from the customer support site:
support.dell.com/equallogic
Syntax for PowerShell Remote Host Installation
HitRemoteInstall.ps1 [-ComputerNames "
computer 1
computer 2
..."]
[-InstallerLocation "
path
"]
[-BackupDocumentLocation "
path
"]
[-InstallOptions "
Install Option 1
Install Option 2
..."]
[-UserName "
Domain
\
Username
"] [-Password "
Password
"]
The
BackupDocumentLocation
parameter allows you to specify the backup document directory. This directory is especially important
for cluster installations, for which a network share must be specified. For information about backup document directories and cluster
configurations, see the
Dell EqualLogic Auto-Snapshot Manager/Microsoft Edition User’s Guide
.
When specifying host names, you can specify the host’s IP address, host name, fully qualified domain name, or IPv6 address. Specify an
IPV6 address as follows:
1.
Change all the
:
characters to
-
characters.
2.
If the address has a
%
character, change it to
s
.
3.
Add
.ipv6-literal.net
to the end.
For example, an address of
fe80::2c02:db79%8
must be specified as
fe80—2c02-db79s8.ipv6-literal.net
.
The following table lists the install options that you can specify when running the PowerShell script.
Table 3. Install Options
Option
Description
ALL
Installs all options listed in this table
RSW
Remote Setup Wizard
VSS
Volume Shadow Copy Service Provider
ASMCLI
ASM/ME Command Line Interface
Installation
17