Difference between revisions of "WinSCP How To Guide"

From Swivel Knowledgebase
Jump to: navigation, search
 
(import changes from kb2)
 
(One intermediate revision by the same user not shown)
Line 6: Line 6:
 
= Introduction =
 
= Introduction =
  
There are various applications which will provide SSH and SFTP functionality. We recommend the use of  [http://winscp.net/eng/download.php WinSCP] for SFTP file transfers to and from the PINsafe appliance. If you wish to access the CMI console via SSH, please see the [[PuTTY How To Guide]], WinSCP allows Putty to be started through the WinSCP interface for saved servers. WinSCP also allows files to be edited, and here Notepad or Notepad++ should be used but not WordPad as this may introduce Windows Control codes which can cause problems.
+
There are various applications which will provide SSH and SFTP functionality. We recommend the use of  [http://winscp.net/eng/download.php WinSCP] for SFTP file transfers to and from the PINsafe appliance. If you wish to access the CMI console via SSH, please see the [[PuTTY How To Guide]]. WinSCP allows Putty to be started through the WinSCP interface for saved servers. WinSCP also allows files to be edited, and here Notepad or another text editor, such as Notepad++, should be used, but not WordPad as this may introduce Windows Control codes which can cause problems.
  
 
WinSCP can also be used to copy backups off of the appliance, see [[Automated SCP Backups]].
 
WinSCP can also be used to copy backups off of the appliance, see [[Automated SCP Backups]].
Line 13: Line 13:
 
= Connecting to the PINsafe appliance =
 
= Connecting to the PINsafe appliance =
  
When you run WinSCP, you are presented with the following screen, where you can manage stored sessions. To connect to the PINsafe appliance click the 'New' button on the right-hand side.
+
When you run WinSCP, you are presented with the following screen, where you can manage stored sessions. To connect to the Swivel appliance click the 'New' button on the right-hand side.
  
 
[[File:WinSCP1dialog.PNG]]
 
[[File:WinSCP1dialog.PNG]]
  
  
* Enter the IP address of the PINsafe appliance into the Host Name field (the default out of the box IP address is 192.168.0.35);
+
* Enter the IP address of the Swivel appliance into the Host Name field (the default out of the box IP address is 192.168.0.35);
 
+
* Enter the username into the User Name field (the default username is '''admin''');
* Enter the username into the User Name field (the default username is admin);
+
* Enter the password into the Password field (the default password is '''lockbox''', but if you have changed the password for the appliance console, use that instead);
 
 
* Enter the password into the Password field (the default password is lockbox);
 
  
 
Click the Login button at the bottom of the window, to initiate the SFTP session. You may be prompted to add or update the security key.
 
Click the Login button at the bottom of the window, to initiate the SFTP session. You may be prompted to add or update the security key.
Line 30: Line 28:
  
  
You should then be presented with the following screen, where you have a left-hand pane and right-hand pane representing your local filesystem and remote (PINsafe) filesystem. You can now drag and drop files between your local filesystem and the remote filesystem.
+
You should then be presented with the following screen, where you have a left-hand pane and right-hand pane representing your local filesystem and remote (Swivel Appliance) filesystem. You can now drag and drop files between your local filesystem and the remote filesystem.
  
 +
On a version 3 remote (Swivel Appliance) filesystem you will need to place and retrieve files from the /support/store directory.
  
[[File:WinSCP3dialog.PNG]]
+
[[File:WinSCP Commander.PNG|500px]]
  
  
 
= Viewing hidden files =
 
= Viewing hidden files =
  
Folders and files that start with a '.' are hiden from view, and to allow these to be seen, select Options/Preferences then Panels and check the option to '''show hidden files (Ctrl+Alt+H)'''
+
Folders and files that start with a '.' are hidden from view by default. To allow these to be seen, select '''Options''', '''Preferences''' from the main menu, then the '''Panels''' tab, and check the option to '''Show hidden files (Ctrl+Alt+H)'''.
  
  
Line 44: Line 43:
  
 
* Check that the IP address is the correct IP for the appliance;
 
* Check that the IP address is the correct IP for the appliance;
 
 
* Check that internal firewall policies allow connection to port 22.
 
* Check that internal firewall policies allow connection to port 22.
 +
* Security Breach message may pop up which you will need to either Add or Update the key for, if you are accessing this machine for the first time. This is to prevent spoofing of the SSH login.
 +
[[File:WinSCP Security Breach.PNG|500px]]

Latest revision as of 08:39, 18 May 2017


Introduction

There are various applications which will provide SSH and SFTP functionality. We recommend the use of WinSCP for SFTP file transfers to and from the PINsafe appliance. If you wish to access the CMI console via SSH, please see the PuTTY How To Guide. WinSCP allows Putty to be started through the WinSCP interface for saved servers. WinSCP also allows files to be edited, and here Notepad or another text editor, such as Notepad++, should be used, but not WordPad as this may introduce Windows Control codes which can cause problems.

WinSCP can also be used to copy backups off of the appliance, see Automated SCP Backups.


Connecting to the PINsafe appliance

When you run WinSCP, you are presented with the following screen, where you can manage stored sessions. To connect to the Swivel appliance click the 'New' button on the right-hand side.

WinSCP1dialog.PNG


  • Enter the IP address of the Swivel appliance into the Host Name field (the default out of the box IP address is 192.168.0.35);
  • Enter the username into the User Name field (the default username is admin);
  • Enter the password into the Password field (the default password is lockbox, but if you have changed the password for the appliance console, use that instead);

Click the Login button at the bottom of the window, to initiate the SFTP session. You may be prompted to add or update the security key.


WinSCP2dialog.PNG


You should then be presented with the following screen, where you have a left-hand pane and right-hand pane representing your local filesystem and remote (Swivel Appliance) filesystem. You can now drag and drop files between your local filesystem and the remote filesystem.

On a version 3 remote (Swivel Appliance) filesystem you will need to place and retrieve files from the /support/store directory.

WinSCP Commander.PNG


Viewing hidden files

Folders and files that start with a '.' are hidden from view by default. To allow these to be seen, select Options, Preferences from the main menu, then the Panels tab, and check the option to Show hidden files (Ctrl+Alt+H).


Troubleshooting

  • Check that the IP address is the correct IP for the appliance;
  • Check that internal firewall policies allow connection to port 22.
  • Security Breach message may pop up which you will need to either Add or Update the key for, if you are accessing this machine for the first time. This is to prevent spoofing of the SSH login.

WinSCP Security Breach.PNG