Drush Installation Guide

Overview
Drush is a command line shell and scripting interface for Drupal. The purpose of this installer is to copy all required Drush files and third party components that Drush is referencing. The installer works on Windows OS. Optionally the installer configures Windows Remote Management and environment settings.

Licensing
Drush nstaller installs and!or uses the following components. "lease refer each corresponding #R$ for more information a%out its licensing. Drush & http'!!drupal.org!pro(ect!drush )nuWin*+ & http'!!gnuwin*+.sourceforge.net ,including -.ip+/ )0ip/ $ess/ $i%archive/ $i%iconv/ $i%intl/ OpenSS$/ "cre/ Tar/ Wget/ .li%1 "2" & http'!!windows.php.net cwRsync & http'!!www.itefi3.no!i+!node!45675 Wi8 Tool & http'!!wi3.sourceforge.net!

Setting the PATH Environment Variable

Drush makes calls to e3ecuta%les without specifying full path to their location. n order to resolve the correct location/ their full path should %e included in 9":T29 environment varia%le. This can %e done %y either installing the Register ;nvironment <aria%les feature/ or %y running the Drush =ommand "rompt located on user>s desktop when installer completes.

un As Administrator
M"ORT:?T' Selecting =onfigure Windows Remote Management feature on systems that has #ser :ccess =ontrol ena%led requires running installer with elevated privileges. This can %e done %y right clicking on the MS file and select Run :s :dministrator. This is required step for system having #ser :ccess =ontrol ena%led. @ailure to do so will make WinRM configuration commands to fail due to MS impersonation restrictions.

S!stem

e"uirements

Support Operating Systems' Windows A/ Windows <ista S"+/ Windows 8" S"*B/ Windows Server +55* S"+B/ Windows Server +55C/ Windows Server +55C R+. 2ard disk' 455M- free space Dou must have administrator privileges on your computer to run the Drush nstaller.

Installation ste#s
4. Run DrushSetup.msi +. =lick ?e3t on the Welcome page

*. Select features to install. See section Drush nstaller @eatures %elow. M"ORT:?T' f you select =onfigure Windows Remote Management feature/ make sure that you run the installer using Run :s :dministrator option.

E. =lick nstall to proceed with installation

7. =lick Des if prompted to run as :dministrator 6. =lick @inish to complete the installation

Drush Installer $eatures

Drush e"uired untime This feature installs all Drush source files and places them in 9"rogramData 9F"ropeopleFDrush folder. t is a required feature and is always installed. Gnu%in&' e"uired (om#onents This feature installs the )nuWin*+ components %elow and places them in 9"rogram@iles9F"ropeopleFDrushF)nuWin*+. )nuWin*+ tools are required for Drush to work on Windows. Drush makes calls to )nuWin*+ tools without specifying full path to their location. n order to resolve the correct location/ their full path should %e included in 9":T29 environment varia%le. This can %e done %y either installing the Register ;nvironment <aria%les feature/ or %y running the Drush =ommand "rompt located on user>s desktop when installer completes. Ph# e"uired untime This feature installs "2"runtime in folder 9"rogram@iles9F"ropeopleFDrushF"hp. Drush makes calls to "2" runtime without specifying full path to its location. n order to resolve the correct location/ its full path should %e included in 9":T29 environment varia%le. This can %e done %y either installing the Register ;nvironment <aria%les feature/ or %y running the Drush =ommand "rompt located on user>s desktop when installer completes.

There are pretty good chances that "2" runtime is already installed on user>s machine if you have used We% "latform nstaller to install Drupal. 2owever there is no a safe way to detect if "2" runtime is already installed. f "2" runtime is already installed on user machine and its full path can %e resolved/ you do not need to install this feature. :lso make sure that a recent version of the "2" runtime is %eing used. : minimum version of 7.+ is required. Run php.e3e &v see "2" runtime version. cw s!nc O#tional (om#onents This feature installs cwRsync in folder 9"rogram@iles9F"ropeopleFDrushFcwRsync. t adds support for rsync command that is used for remote command invocation when Windows calls $inu3!#ni3 server. egister Environment Variables This feature adds full path of all installed features to ":T2 environment varia%le. "ay attention that Windows has a limit of environment varia%les total length of +5EA characters as descri%ed in G-C*5EA*. f you e3ceed this length/ some or all paths to Drush components will not %e added and will make Drush not operational. n such case you can use Drush =ommand "rompt that gets installed on your desktop to start new command prompt. Drush =ommand "rompt simply runs new command prompt and e3ecutes Drush;nv.%at to set all required paths. f ":T2 still gets truncated/ run new =ommand "rompt window and remove all unnecessary ":T2 values. Then run Drush;nv.%at to set all Drush required paths. (on)igure %indows emote *anagement This feature ena%les remote command invocation from Windows client ,where Drush is %eing installed1 to a Windows Server ,where Drupal is hosted1. Manual configuration of WinRM can %e performed %y running WinRM=onfig.%at file located in 9"rogram@iles9F"ropeopleFDrush. n this case this feature need not to %e installed. This feature has also a su%&feature called :ccept incoming requests. t should %e ena%led when installing Drush on Windows Server hosting the Drupal installation. t ena%les incoming connections and allows remote Drush commands to %e sent to the server. -y default WinRM remote connections are ena%led over 2TT" port C5 using WinRM =ompati%ility 2ttp $istener. "ort can %e changed %y either setting W ?RM"ORT property of the MS installer or %y calling WinRM=onfig.%at Hport num%erI. Read nstallation and =onfiguration for Windows Remote Management for more information on how to configure WinRM.