FTP PROCEDURE FOR WinSCP

If you do not have WinSCP installed, download and install the program.  WinSCP is a secure file transfer program that shows hidden folders or files which allows accessing the .spamassassin folder to view and modify your user preferences.  WinSCP uses secure shell protocols which are inherently more secure than FTP, and  it provides an easy to use interface to download or upload files as well as other functions such as renaming and deleting files.

Downloading And Installing WinSCP
1.  First download WinSCP from http://www.winscp.net/eng/docs/protocols
2.  When you open the file that you downloaded, you should have an installer launch. Use all of the defaults, so once you accept the License, you can just click "Next" until the window closes.
3.  At the last screen, it will ask if you wish to launch WinSCP. Leave the box checked and click "Finish". If you do not do this, you can still launch WinSCP from the Start menu.

Making Files Public When They are Uploaded
1. Start WinSCP, check Advanced Options (lower left), click Preferences (above Advanced Options), and click Preferences button (on right).
2. On the Preferences window (on left) click Transfer
3. Check the Set permissions box and change the permissions to rw-r--r-- (+x) in the drop down list..
4. Click OK.
To determine a file's group, right click on the file name, and then click on Properties.

Connecting To A Host
1.  When you first start WinSCP, you are greeted with a Login dialog box.
2.  Type in the host name of www.sjpc.org, your SJPC assigned User Name as username@sjpc.org, your SJPC password, leave the private key file blank, and set the default Protocol of FTP in the drop down list.
3.  Click "Save" in order to store this information for future sessions.
4.  Click Login.
5.  If you have never connected to this host before, you will be asked to save it's encryption fingerprint locally. You will want to click "Yes" at the prompt saying "Continue connecting and add host key to the cache?"
6.  Once you have successfully connected, a dialog box will appear which is called the "Commander Interface".
7.  Future connections will only require clicking Login

Downloading A File
1.  The WinSCP default "Commander Interface" has two panes in its dialog box. The left pane is the "local pane", that starts out as the user's "My Documents" folder, and the right pane is the remote server to which you have connected that starts out as your directory, home/userid where userid is your SJPC assigned userid..
2.  If you want to copy a file from the remote server to the "My Documents" folder, you can just select a file on the right (server) pane, and then drag it to the left (local) pane.
3.  You will be prompted with a dialog box asking if there are any specific download options you wish to use. In nearly all cases, the defaults are fine, so you can just click the button labelled "Copy".
4.  The file will then appear on the left pane.
5.  If you wish to save to another location, you can navigate down through the directories in the left (local) pane by double clicking on them, and can go up a level by double clicking on the top icon on your left pane (the folder with the up arrow) in the left (local) pane.

Uploading A File
1.  Uploading a file is very similar in process to downloading one. Now you want to drag a file from the left (local) pane to the right (server) pane.
2.  You will again be prompted for any specific settings you wish to change for the upload file. Click "Copy" to upload the file.
3.  Usually it's safe to go with the defaults, though it may be useful to use the permissions dialog if you wish to lock down access to this file on the server.
4.  The file will then appear on the right (server) pane.
5.  If you wish to upload to another directory, you can navigate down through the directories in the right (server) pane by double clicking on them, and can go up a level by double clicking on the top icon (the folder with the up arrow) on your right (server) pane .

Edit Function To Modify A Remote File
The edit function has integrated text file editor with basic functions. It includes clipboard commands, find, replace, etc.
Instead of an integrated editor, it is possible to use even a custom external editor ("Notepad" by default).  When editing a remote file, the file is first downloaded to a local temporary directory, where it is opened. Every time the file is saved from editor, it is uploaded to the server. After the editor is closed, the local copy of the file is deleted. For all transfers of an edited file, text (ASCII) mode is used regardless of the user settings or file type.
1.  Select the file to edit in the right (server) pane.  If the file is not in the present directory, you can navigate down through the directories by double clicking on them in the right (server) pane, and can go up a level by double clicking on the top icon (the folder with the up arrow) on your right (server) pane .
2.  Right click on the file, and left click Edit, and a copying window will appear while the file is being copied to a temporary file.
3.  When the notepad like dialog box appears, you can modify the text file.
4.  Click the Save icon which is the second from the left in the command line at the top of the dialog box.
5.  The copying window will appear while the modified file is being saved on the remote server.
6.  Close the dialog box.

Renaming A Remote File Or Folder
1.  Select the file or folder to rename in the right (server) pane.  If the file is not in the present directory, you can navigate down through the directories by double clicking on them in the right (server) pane, and can go up a level by double clicking on the top icon (the folder with the up arrow) on your right (server) pane.
2.  Right click on the file, and click Rename.
3.  Type in the new name, and press Enter.

Deleting A Remote File Or Folder
1.  Select the file or folder to deleted in the right (server) pane.  If the file is not in the present directory, you can navigate down through the directories by double clicking on them, and can go up a level by double clicking on the top icon (the folder with the up arrow) on your right (server) pane.
2.  Right click on the file, and click Delete, and a window will appear saying "Are you sure you want to delete . . ?"
3.  Click OK and the deleting window will appear until the file or folder is deleted from the right (server) pane.

Add A Remote Folder
1. If the file is not in the present directory, you can navigate down through the directories in the right (server) pane by double clicking on them, and can go up a level by double clicking on the top icon (the folder with the up arrow) on your right (server) pane.
2.  Click Files and click Create Directory.  Then the folder window will appear.
3.  Type the folder name and click OK, and the new folder will appear in the directory in the right (server) pane.


Return to the San Jose IBM PC Club's home page