====== PuTTY command line mode ======

First, install and configure the [[http://www.udel.edu/it/research/training/config_laptop/puTTY.shtml|PuTTY]] client to connect a remote host. Then add the PuTTY install path to your local system PATH environment variable. This will allow you to use PuTTY's command line mode.

<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 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.

==== Windows XP ====
  - From the desktop, right-click on **My Computer**, select **Properties**.
  - In the System Properties window, click on the **Advanced** tab. 
  - In the Advanced tab section, click on **Environment Variables** at the bottom.
  - In the Environment Variables window under System variables, click on Path to highlight it, then click **Edit**.
  - In the Edit System 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 System Variable window.
  - Click **OK** to exit the Environment Variables window.
  - Click **OK** to exit the System Properties window.

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

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

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

<code>
pscp traine@mills.hpc.udel.edu:/lustre/work/it_css/traine/remote-file local-file
</code>

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

<code>
pscp -r traine@mills.hpc.udel.edu:/lustre/work/it_css/traine/remote-dir local-dir
</code>

to copy an entire directory, ''remote-dir'', from account, ''traine'', on the remote system, ''mills.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@mills.hpc.udel.edu:/lustre/work/it_css/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, ''mills.hpc.udel.edu'', in the specified directory for ''remote-file'', or

<code>
pscp -r local-dir traine@mills.hpc.udel.edu:/lustre/work/it_css/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, ''mills.hpc.udel.edu'', in the specified directory for ''remote-dir''.

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

==== 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 ''mills-traine'' with username ''traine'' and encryption cipher selection policy set to ''Arcfour (SSH-2 only)'', use

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

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

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

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