====== Connecting to DARWIN from Windows ======

IT strongly recommends that you configure your clients as described in the online X-windows (X11) and SSH documents
([[http://www.udel.edu/it/research/training/config_laptop/puTTY.shtml|Windows]] /
[[http://www.udel.edu/it/research/training/config_laptop/linuxAgent.html|Linux/MacOSX]]).

<note important>**For all ACCESS (XSEDE) Allocation Users ONLY** passwords are **not** set for ACCESS users on DARWIN, the instructions on this page will only work if you set a password. See instructions for [[abstract:darwin:system_access:system_access#logging-on-to-darwin-for-access-xsede-allocation-users|logging on to DARWIN for ACCESS (XSEDE) Allocation Users]] for details.
</note>
===== PuTTY command line mode =====

If you want to be able to use PuTTY command line on your Windows computer, first, install and configure the [[http://www.udel.edu/it/research/training/config_laptop/puTTY.shtml|PuTTY]] client to connect a remote host. Now add the PuTTY install path to your Windows system PATH environment variable. This will allow you to use PuTTY's command line mode on your Windows computer.

<note tip>IT strongly recommends that you configure your  client as described in the online [[http://www.udel.edu/it/research/training/config_laptop/puTTY.shtml|X-Windows (X11) and SSH document]]. </note>
 
===== Adding PuTTY to your PATH =====

==== Windows 10 ====
  - Click Windows taskbar and type to search **environment**.
  - Best match should be on **Edit the system environment variables**, click to open.
  - In the Systems Properties window, it should be on the **Advanced** tab. 
  - In the System Properties window, click on **Environment Variables...** at the bottom of the window.
  - In the Environment Variables window in the System variables (second box), click on Path to highlight, then click **Edit...**.
  - In the Edit environment variable window, click **New**. Type\\ **''C:\Program Files (x86)\PuTTY\''**.
  - Click **OK** to save and exit the Edit environment variable window.
  - Click **OK** to exit the Environment Variables window.
  - Click **OK** to exit the System Properties window.

==== Windows 7 ====
  - Click **Start** in the taskbar.
  - Right-click on **Computer**, select **Properties**.
  - In the System window, click on **Advanced system settings** on the left. 
  - In the System Properties window, click on **Environment Variables...**.
  - In the Environment Variables window, PATH should be highlighted, click **Edit...**.
  - In the Edit User Variable window, click in the **Variable value:** box and move to the end using the right arrow. Type\\ **'';C:\Program Files (x86)\PuTTY''**.
  - Click **OK** to save and exit the Edit User Variable window.
  - Click **OK** to exit the Environment Variables window.
  - Click **OK** to exit the System window.


===== Using command line PuTTY without a saved session =====

Please review [[https://documentation.help/PuTTY/using-cmdline.html|PuTTY command line documentation]] for complete details if you would like to use it in a Windows ''cmd'' window.
==== Logging on to DARWIN ====

In a Windows (''cmd'') window or adding a line to a batch script, use

<code>
putty.exe -ssh traine@darwin.hpc.udel.edu
</code>

or with X11 forwarding and running Xming, use

<code>
putty.exe -ssh -X traine@darwin.hpc.udel.edu
</code>

==== Copy from remote system to local system ====

In a Windows (''cmd'') window or adding a line to a batch script, use

<code>
pscp traine@darwin.hpc.udel.edu:/lustre/scratch/traine/remote-file local-file
</code>

to copy a single file, ''remote-file'', from account, ''traine'', on the remote system, ''darwin.hpc.udel.edu'', to ''local-file'' on your local system in the current directory, or

<code>
pscp -r traine@darwin.hpc.udel.edu:/lustre/scratch/traine/remote-dir local-dir
</code>

to copy an entire directory, ''remote-dir'', from account, ''traine'', on the remote system, ''darwin.hpc.udel.edu'', to ''local-dir'' on your local system in the current directory.

==== Copy from local system to remote system ====

In a Windows (''cmd'') window or adding a line to a batch script, use

<code>
pscp local-file traine@darwin.hpc.udel.edu:/lustre/scratch/traine/remote-file
</code>

to copy a single file, ''local-file'', on your local system in the current directory, to account, ''traine'', on remote host, ''darwin.hpc.udel.edu'', in the specified directory for ''remote-file'', or

<code>
pscp -r local-dir traine@darwin.hpc.udel.edu:/lustre/scratch/traine/remote-dir
</code>

to copy an entire directory, ''local-dir'', on your local system in the current directory, to account, ''traine'', on remote host, ''darwin.hpc.udel.edu'', in the specified directory for ''remote-dir''.

===== Using command line PuTTY with a saved session =====

Please review [[https://documentation.help/PuTTY/using-cmdline.html|PuTTY command line documentation]] for complete details if you would like to use it in a Windows ''cmd'' window. In the following examples, we have two saved sessions configured called ''darwin-traine'' and ''x-darwin-traine'' based on configuring your client as described in the online [[http://www.udel.edu/it/research/training/config_laptop/puTTY.shtml|X-Windows (X11) and SSH document]]

==== Logging on to DARWIN ====

In a Windows (''cmd'') window or adding a line to a batch script, use

<code>
putty.exe -load "darwin-traine"
</code>

or with X11 forwarding and running Xming, use a saved session configured with X11 forwarding

<code>
putty.exe -load "x-darwin-traine"
</code>
==== Copy from remote system to local system ====

In a Windows (''cmd'') window or adding a line to a batch script using a saved session called ''darwin-traine'' with username ''traine'' and encryption cipher selection policy set to ''Arcfour (SSH-2 only)'', use

<code>
pscp darwin-traine:/lustre/work/it_css/traine/remote-file local-file
</code>

using ''arcfour'' cipher to copy a single file, ''remote-file'', from account, ''traine'', on the remote system, ''darwin.hpc.udel.edu'', to ''local-file'' on your local system, or

<code>
pscp -r darwin-traine:/lustre/work/it_css/traine/remote-dir local-dir
</code>

using ''arcfour'' cipher to copy an entire directory, ''remote-dir'', from account, ''traine'', on the remote system, ''darwin.hpc.udel.edu'', to ''local-dir'' on your local system.

==== Copy from local system to remote system ====

In a Windows (''cmd'') window or adding a line to a batch script using a saved session called ''darwin-traine'' with username ''traine'' and encryption cipher selection policy set to ''Arcfour (SSH-2 only)'', use

<code>
pscp local-file darwin-traine:/lustre/work/it_css/traine/remote-file
</code>

using ''arcfour'' cipher to copy a single file, ''local-file'', on your local system in the current directory, to account, ''traine'', on the remote system, ''darwin.hpc.udel.edu'', in the specified directory for ''remote-file'' on your remote system, or

<code>
pscp -r local-dir darwin-traine:/lustre/work/it_css/traine/remote-dir
</code>

using ''arcfour'' cipher to copy an entire directory, ''local-dir'', on your local system in the current directory, to account, ''traine'', on the remote system, ''darwin.hpc.udel.edu'', in the specified directory for ''remote-dir'' on your remote system.