====== Connecting to Caviness from Windows ======

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

===== 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 Caviness ====

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

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

or with X11 forwarding and running Xming, use

<code>
putty.exe -ssh -X traine@caviness.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@caviness.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, ''caviness.hpc.udel.edu'', to ''local-file'' on your local system in the current directory, or

<code>
pscp -r traine@caviness.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, ''caviness.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@caviness.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, ''caviness.hpc.udel.edu'', in the specified directory for ''remote-file'', or

<code>
pscp -r local-dir traine@caviness.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, ''caviness.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 ''caviness-traine'' and ''x-caviness-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 Caviness ====

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

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

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

<code>
putty.exe -load "x-caviness-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 ''caviness-traine'' with username ''traine'' and encryption cipher selection policy set to ''Arcfour (SSH-2 only)'', use

<code>
pscp caviness-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, ''caviness.hpc.udel.edu'', to ''local-file'' on your local system, or

<code>
pscp -r caviness-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, ''caviness.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 ''caviness-traine'' with username ''traine'' and encryption cipher selection policy set to ''Arcfour (SSH-2 only)'', use

<code>
pscp local-file caviness-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, ''caviness.hpc.udel.edu'', in the specified directory for ''remote-file'' on your remote system, or

<code>
pscp -r local-dir caviness-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, ''caviness.hpc.udel.edu'', in the specified directory for ''remote-dir'' on your remote system.