Xshell FAQ

X11 forwarding is a bit different from other TCP/IP port forwarding.
Please, go through the following steps.

1. To enable X11 forwarding service in Xshell
2. To enable X11 forwarding service in the SSH server
3. To run X applications from the Xshell terminal

1. To enable X11 forwarding service in Xshell:
   
   On the Tunneling tab of Advanced SSH Options dialog box, check Forward X11 Connections To. and select Xmanager if Xmanager is installed in your PC. If you use another PC X server, select X Display Location and enter the proper display name.
   
   
2. To enable X11 forwarding service in the SSH server:
   
   Setup the configuration file in the following table.
   

   SSH server	Config file	Setup
   OpenSSH	/etc/ssh/sshd_config	X11Forwarding yes
   SSH.COM	/etc/ssh2/sshd2_config	AllowX11Forwarding yes

   
   
   
3. To run X11 applications from the Xshell terminal:
   
   
   1. If Xmanager is installed on your PC, just go to the next step. Otherwise, run the PC X server installed on your PC first.
   2. Start the SSH connection with the session enabling X11 Forwarding.
   3. At the shell prompt of Xshell, execute the X11 applications like the following examples:

      [nathaniel@intranet ~]$ xterm &
      [nathaniel@intranet ~]$ startkde &
      [nathaniel@intranet ~]$ gnome-session &

Use the following setting to prevent Xshell from exiting when the connection is closed.

1. From the Xshell tool bar, click Tools, and then Options.
   RESULT: Options dialog box opens up.
2. Click the Advanced tab.
3. In the Options area, select Exit to local shell on connection close.
   
   

To export sessions:

To connect to Server A through an intermediate server, Server B, you can use the Wait & Response feature. Please follow the instruction below:

1. Open Xshell.
   
2. Click File, and then Open.
   RESULT: Sessions dialog box opens up.
   
3. Select a session that will be an intermediate server. (Server B)
   
4. Right click on the session, and then click Properties.
   RESULT: Session Properties dialog box opens up.
   
5. Click Logon Scripts.
   RESULT: Logon Scripts page opens up.
   
6. Select the Execute the following Expect & Send pairs. 
7. Click Add.
   RESULT: Wait & Response Rule dialog box opens up.
8. In the Expect field, type in the last few characters of the shell prompt
   Ex: If your prompt says [oracle@OTS oracle]$ , then you should write oracle]$.
   NOTE: This is the last line you see on the Xshell terminal when you login to the destination server.
   
9. In the Response field, type in the SSH or Telnet command you use when connecting to the destination server.
   Ex: ssh John@192.168.1.193
10. Repeat steps 9 and 10 for password and other commands.

If Xftp is already installed, the Xftp button (New File Transfer) in the Xshell toolbar is automatically activated.

1. Click on the Xftp button (New File Transfer).
   
2. Xftp then opens a new session by using the same account information provided in Xshell session.
   
   

You can use 'sftp' command from the local Xshell prompt to transfer files.

1. Use the following 'sftp' command and connect to a server where files will be transferred.

   sftp [user@]host [port] Example of command line) Xshell> sftp myhostname Xshell> sftp myusername@myhostname Xshell> sftp myusername@myhostname 12345
2. On the sftp prompt, 'help' command lists a set of available sftp commands.

   sftp:/home/myusername> help bye finish your SFTP session cd change your remote working directory clear clear screen exit finish your SFTP session explore explore your local directory get download a file from the server to your local machine help give help lcd change and/or print local working directory lls list contents of a local directory lpwd print your local working directory ls list contents of a remote directory mkdir create a directory on the remote server mv move or rename a file on the remote server put upload a file from your local machine to the server pwd print your remote working directory quit finish your SFTP session rename move or rename a file on the remote server rm delete a file rmdir remove a directory on the remote server sftp:/home/myusername>
3. Following is sample sequences of uploading files.
   1. Use 'cd' command to move to a directory where you want to upload files to. (Server)
   2. Use 'lcd' command to move to a directory where the files, which will be uploaded, are saved. (Windows)
   3. Check the file name with 'lls' command.
   4. Start uploading with 'put' command.

If Xftp is already installed, Xshell can create an Xftp session from the current Xshell session for easier and more secure file transfer. For more information on how to integrate Xftp and Xshell, please refer to the How can I open an Xftp session from the current Xshell session?.

SSH2 is a complete rewrite of the SSH1 protocol. They are two entirely different protocols. SSH2 is a significant improvement over older versions of the Secure Shell protocol. It is more secure, better designed and more flexible, so anyone who is still using SSH1 is strongly encouraged to upgrade to SSH2.

The SSH2 protocol provides the services such as server authentication, encryption, data integrity verification, and client authentication. The server authentication is performed using the DSA public key algorithm. For the encryption and the data integrity verification, a number of algorithms that can be implemented in modular fashion on every SSH2 product are provided. The client authentication can be performed using password and public key algorithm such as DSA or RSA as well as a variety of other methods.

The supported ciphers are AES128/192/256, 3DES, BLOWFISH, CAST128, ARCFOUR, and RIJNDAEL. And Xshell supports SHA1, SHA1-96, MD5, MD5-96, and RIPEMD160 MAC algorithms. You can configure multiple ciphers and MAC algorithms to be tried in order of the appearance in the list.

The SSH port forwarding is a good method of allowing secure, encrypted connections to traditionally non-encrypted services, such as POP3 for email, NNTP for news, etc. You can easily setup a port forwarding rule from Xshell. Simply put proper information to the Forwarding Rules dialog box.

If you are connecting from local client applications to the remote server application, you should set Xshell to forward the local port to the remote port.

Type(direction): Outgoing
Listen Port: a port on your machine
Remote Host: remote server to connect to
Remote Port: remote port on the remote host

If you are making secure connection to a POP3 server (mail.xyz.com:110) over Xshell, you may set as follows:

Listen Port: 5110
Remote Host: mail.xyz.com
Remote Port: 110

And, on the mail client(MS Outlook), you must setup the mail server and port.

Incoming mail server: localhost
Incoming mail port: 5110

The POP3 client will connect to Xshell at local rather than connecting to the remote mail server directly. Xshell forwards all traffics to the mail server over the secure tunnel and transfers all traffics received from the mail server to the POP3 client.

"Could not connect to 'hostname': Unknown host."

Check if the host name is entered correctly. Also, if you are using the host name, try using the IP address instead.

"Could not connect to 'hostname' (port 22): Connection failed."

Check if the host machine is ready for connection and the port is reachable. If you are connecting to a SSH server, make sure that SSH daemon is running on the remote host.