SlideShare a Scribd company logo
Manual - Xshell
Version 7 Help
Exported on 10/23/2020
Version 7 Help – Manual - Xshell
– 2
Table of Contents
1 Xshell Manual .......................................................................................................7
2 Content.................................................................................................................8
2.1 About Xshell...............................................................................................................................8
2.2 Start ...........................................................................................................................................8
2.3 Session Management................................................................................................................8
2.4 Connection................................................................................................................................9
2.5 Security......................................................................................................................................9
2.6 Tab Management ......................................................................................................................9
2.7 Tunneling Service......................................................................................................................9
2.8 Terminal Window Operations ..................................................................................................9
2.9 Options Setting .......................................................................................................................10
2.10 File Transfer.............................................................................................................................10
2.11 Session Logging and Tracing..................................................................................................10
2.12 Printing....................................................................................................................................10
2.13 Using Xagent............................................................................................................................10
2.14 Using Scripts............................................................................................................................10
2.15 References...............................................................................................................................11
3 About Xshell........................................................................................................12
3.1 Key Functions..........................................................................................................................12
3.2 Minimum System Requirements............................................................................................14
3.3 Install and Uninstall................................................................................................................14
4 Start ....................................................................................................................15
4.1 Create Session.........................................................................................................................15
4.2 Connect to Remote Host.........................................................................................................16
4.3 Exit Xshell ................................................................................................................................17
5 Session Management.........................................................................................18
5.1 Session Management..............................................................................................................18
5.2 Session Properties ..................................................................................................................19
Version 7 Help – Manual - Xshell
– 3
5.2.1 Connection............................................................................................................................................................ 19
5.2.2 Connection _ Authentication ............................................................................................................................... 20
5.2.3 Connection _ Authentication _ Login Prompts ................................................................................................... 20
5.2.4 Connection _ Login Scripts................................................................................................................................... 21
5.2.5 Connection _ SSH.................................................................................................................................................. 21
5.2.6 Connection _ SSH _ Security ................................................................................................................................ 22
5.2.7 Connection _ SSH _ Tunneling............................................................................................................................. 22
5.2.8 Connection _ SSH _ SFTP ..................................................................................................................................... 22
5.2.9 Connection _ TELNET ........................................................................................................................................... 22
5.2.10 Connection _ RLOGIN ........................................................................................................................................... 22
5.2.11 Connection _ SERIAL............................................................................................................................................. 23
5.2.12 Connection _ PROXY ............................................................................................................................................. 23
5.2.13 Connection _ Keep Alive....................................................................................................................................... 23
5.2.14 Terminal ................................................................................................................................................................ 23
5.2.15 Terminal _ Keyboard............................................................................................................................................. 24
5.2.16 Terminal _ VT Mode .............................................................................................................................................. 24
5.2.17 Terminal _ Advanced ............................................................................................................................................ 25
5.2.18 Appearance ........................................................................................................................................................... 26
5.2.19 Appearance _ Window .......................................................................................................................................... 26
5.2.20 Appearance _ Highlight ........................................................................................................................................ 27
5.2.21 Advanced............................................................................................................................................................... 27
5.2.22 Advanced _ Trace.................................................................................................................................................. 27
5.2.23 Advanced _ Bell..................................................................................................................................................... 28
5.2.24 Advanced _ Logging.............................................................................................................................................. 28
5.2.25 File Transfer........................................................................................................................................................... 29
5.2.26 File Transfer _ X_YMODEM.................................................................................................................................... 29
5.2.27 File Transfer _ ZMODEM........................................................................................................................................ 29
5.3 Export ......................................................................................................................................30
5.4 Import......................................................................................................................................30
6 Connection.........................................................................................................31
6.1 Connections without Session Files ........................................................................................31
6.2 Connections with Session Files..............................................................................................31
6.3 Sessions to Run on Xshell Startup..........................................................................................32
6.4 SERIAL Connection..................................................................................................................32
Version 7 Help – Manual - Xshell
– 4
6.5 Connection with Kerberos......................................................................................................32
6.6 Connection with PKCS _11 .....................................................................................................33
6.7 Proxy Setting ...........................................................................................................................33
6.8 Jump host................................................................................................................................33
7 Security...............................................................................................................35
7.1 Public Key User Authentication0............................................................................................35
7.1.1 User Keys Dialog Box............................................................................................................................................. 36
7.2 Host Key Management............................................................................................................36
7.2.1 SSH Security Warning Dialog Box......................................................................................................................... 36
7.2.2 Host Keys Dialog Box ............................................................................................................................................ 37
7.3 Master Password.....................................................................................................................37
8 Tab Management ...............................................................................................39
8.1 Tab...........................................................................................................................................39
8.2 Tab Group................................................................................................................................39
8.3 Split and Merge Tabs ..............................................................................................................40
8.4 Arrange Tabs ...........................................................................................................................40
9 Tunneling Service...............................................................................................41
9.1 TCP_IP Port Forwarding .........................................................................................................41
9.2 X11 Forwarding .......................................................................................................................41
9.3 SOCKS4_5 Dynamic Port Forwarding ....................................................................................42
9.4 Instant Tunneling....................................................................................................................42
10 Terminal Window Operations ...........................................................................44
10.1 Copy and Paste........................................................................................................................44
10.2 Find String ...............................................................................................................................45
10.3 Font Change ............................................................................................................................45
10.4 Font Color and Background Color Setting.............................................................................45
10.5 Cursor Change.........................................................................................................................46
10.6 Window Handling....................................................................................................................47
10.7 Multi-session Handling ...........................................................................................................48
10.8 Quick Command Sets Setting.................................................................................................48
10.9 Terminal Output Encoding Change........................................................................................50
Version 7 Help – Manual - Xshell
– 5
10.10 Advanced Terminal Options Setting......................................................................................50
10.11 Layout Management...............................................................................................................51
10.12 Highlight Sets Settings............................................................................................................51
11 Options Setting ..................................................................................................53
11.1 Session Folder and Startup Session.......................................................................................53
11.2 History Clearing and Connection Log ....................................................................................53
11.3 Key Mapping Setting...............................................................................................................53
11.4 Mouse Setting..........................................................................................................................54
11.5 Transparency Setting..............................................................................................................54
11.6 Master Password Settings ......................................................................................................54
11.7 Screen Lock Settings...............................................................................................................54
11.7.1 Auto Lock............................................................................................................................................................... 55
11.8 Live Update Settings...............................................................................................................55
11.9 Advanced Settings ..................................................................................................................56
12 File Transfer........................................................................................................58
12.1 File Transfer Using SFTP.........................................................................................................58
12.2 File Transfer Using FTP ...........................................................................................................58
12.3 File Transfer Using X_Y_ZMODEM ..........................................................................................58
12.4 File Transfer Using Xftp...........................................................................................................60
13 Session Logging and Tracing.............................................................................61
13.1 Session Logging ......................................................................................................................61
13.2 Session Tracing .......................................................................................................................61
14 Printing...............................................................................................................62
15 Using Xagent.......................................................................................................63
15.1 Connecting to a Server Through Xagent................................................................................63
15.2 Using the Xagent User Key on a Remote Host .......................................................................63
16 Using Scripts.......................................................................................................65
16.1 Script Starting and Ending .....................................................................................................65
16.2 Script API .................................................................................................................................65
16.2.1 xsh.Session............................................................................................................................................................ 65
16.2.2 xsh.Screen ............................................................................................................................................................. 66
Version 7 Help – Manual - Xshell
– 6
16.2.3 xsh.Dialog .............................................................................................................................................................. 68
16.2.4 Script Example ...................................................................................................................................................... 68
16.3 Script Recording......................................................................................................................70
16.4 Multi-Session Script ................................................................................................................70
17 References..........................................................................................................71
17.1 Standard Buttons....................................................................................................................71
17.2 Address Bar..............................................................................................................................73
17.3 Xshell Local Command ...........................................................................................................74
17.4 Xshell Command Line Option.................................................................................................78
17.5 SFTP Command.......................................................................................................................80
17.6 Regular Expression..................................................................................................................81
17.6.1 Pattern Match........................................................................................................................................................ 81
17.6.2 The shorthand of character classes ..................................................................................................................... 82
17.6.3 POSIX character classes........................................................................................................................................ 83
17.6.4 Example................................................................................................................................................................. 84
17.7 Pre-defined Shortcut Key .......................................................................................................84
Version 7 Help – Manual - Xshell
Xshell Manual – 7
1 Xshell Manual
The manual describe how to use the program's interface and will guide you through the basics.
Version 7 Help – Manual - Xshell
Content – 8
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
2 Content
2.1 About Xshell
Key Functions(see page 12)
Minimum System Requirements(see page 14)
Install and Uninstall(see page 14)
2.2 Start
Create Session(see page 15)
Connect to Remote Host(see page 16)
Exit Xshell(see page 17)
2.3 Session Management
Session Management(see page 18)
Session Properties(see page 19)
Connection(see page 19)
Connection _ Authentication(see page 20)
Connection _ Authentication _ Login Prompts(see page 20)
Connection _ Login Scripts(see page 21)
Connection _ SSH(see page 21)
Connection _ SSH _ Security(see page 22)
Connection _ SSH _ Tunneling(see page 22)
Connection _ SSH _ SFTP(see page 22)
Connection _ TELNET(see page 22)
Connection _ RLOGIN(see page 22)
Connection _ SERIAL(see page 23)
Connection _ PROXY(see page 23)
Connection _ Keep Alive(see page 23)
Terminal(see page 23)
Terminal _ Keyboard(see page 24)
Terminal _ VT Mode(see page 24)
Terminal _ Advanced(see page 25)
Appearance(see page 26)
Appearance _ Window(see page 26)
Appearance _ Highlight(see page 27)
Advanced(see page 27)
Advanced _ Trace(see page 27)
Advanced _ Bell(see page 28)
Advanced _ Logging(see page 28)
File Transfer(see page 29)
File Transfer _ X_YMODEM(see page 29)
File Transfer _ ZMODEM(see page 29)
Export(see page 30)
Import(see page 30)
Version 7 Help – Manual - Xshell
Content – 9
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
2.4 Connection
Connections without Session Files(see page 31)
Connections with Session Files(see page 31)
Sessions to Run on Xshell Startup(see page 32)
SERIAL Connection(see page 32)
Connection with Kerberos(see page 32)
Connection with PKCS _11(see page 33)
Proxy Setting(see page 33)
Jump host(see page 33)
2.5 Security
Public Key User Authentication0(see page 35)
User Keys Dialog Box(see page 36)
Host Key Management(see page 36)
SSH Security Warning Dialog Box(see page 36)
Host Keys Dialog Box(see page 37)
Master Password(see page 37)
2.6 Tab Management
Tab(see page 39)
Tab Group(see page 39)
Split and Merge Tabs(see page 40)
Arrange Tabs(see page 40)
2.7 Tunneling Service
TCP_IP Port Forwarding(see page 41)
X11 Forwarding(see page 41)
SOCKS4_5 Dynamic Port Forwarding(see page 42)
Instant Tunneling(see page 42)
2.8 Terminal Window Operations
Copy and Paste(see page 44)
Find String(see page 45)
Font Change(see page 45)
Font Color and Background Color Setting(see page 45)
Cursor Change(see page 46)
Window Handling(see page 47)
Multi-session Handling(see page 48)
Quick Command Sets Setting(see page 48)
Terminal Output Encoding Change(see page 50)
Advanced Terminal Options Setting(see page 50)
Layout Management(see page 51)
Version 7 Help – Manual - Xshell
Content – 10
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
Highlight Sets Settings(see page 51)
2.9 Options Setting
Session Folder and Startup Session(see page 53)
History Clearing and Connection Log(see page 53)
Key Mapping Setting(see page 53)
Mouse Setting(see page 54)
Transparency Setting(see page 54)
Master Password Settings(see page 54)
Screen Lock Settings(see page 54)
Auto Lock(see page 55)
Live Update Settings(see page 55)
Advanced Settings(see page 56)
2.10 File Transfer
File Transfer Using SFTP(see page 58)
File Transfer Using FTP(see page 58)
File Transfer Using X_Y_ZMODEM(see page 58)
File Transfer Using Xftp(see page 60)
2.11 Session Logging and Tracing
Session Logging(see page 61)
Session Tracing(see page 61)
2.12 Printing
2.13 Using Xagent
Connecting to a Server Through Xagent(see page 63)
Using the Xagent User Key on a Remote Host(see page 63)
2.14 Using Scripts
Script Starting and Ending(see page 65)
Script API(see page 65)
xsh.Session(see page 65)
xsh.Screen(see page 66)
xsh.Dialog(see page 68)
Script Example(see page 68)
Script Recording(see page 70)
Multi-Session Script(see page 70)
Version 7 Help – Manual - Xshell
Content – 11
•
•
•
•
•
•
•
•
•
•
•
2.15 References
Standard Buttons(see page 71)
Address Bar(see page 73)
Xshell Local Command(see page 74)
Xshell Command Line Option(see page 78)
SFTP Command(see page 80)
Regular Expression(see page 81)
Pattern Match(see page 81)
The shorthand of character classes(see page 82)
POSIX character classes(see page 83)
Example(see page 84)
Pre-defined Shortcut Key(see page 84)
1 http://ssh.com
Version 7 Help – Manual - Xshell
About Xshell – 12
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
3 About Xshell
Xshell is a powerful SSH, TELNET and RLOGIN terminal emulator software operating on the Windows platform.
Windows users can conveniently and securely access UNIX/Linux hosts using Xshell. SSH (secure shell) protocols
support encryption and user authentication for secure connections on the Internet and can replace legacy
protocols, such as TELNET and RLOGIN.
3.1 Key Functions
This section provides descriptions on key functions of Xshell.
General
Supports SSH1, SSH2, SFTP, TELNET, RLOGIN and SERIAL protocols
Supports Windows 7/8/10, Server 2008/2012/2016
Supports OpenSSH and ssh.com1
servers
Supports having multi tabs in a single window
Supports displaying multiple tab groups in a single window
Multi-user setting
Keep alive option
SOCKS4/5, HTTP proxy connection
Custom key mapping
VB, Perl, Jscript scripting
IPv6 support
Kerberos(MIT Keberos, Microsoft SSPI) authentication support
SSH/Telnet 추적
Session Management
The Session Manager provides a convenient way to manage and run multiple sessions
Create and manage session files for both local and remote hosts
Supports Sessions dialog box, address bar, local prompt, shortcut to session, and links bar to open sessions
Provides a default session for quick connection
Simultaneous connection with multiple sessions
Address bar supports URL commands and allows connection to a remote host with or without a saved
session
Supports automatic login and login scripts
Supports folder and tree view in the Sessions dialog box
Batch update sessions
Import and export sessions
Security
Version 7 Help – Manual - Xshell
About Xshell – 13
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
RSA/DSA/ECDSA/ED25519 Public key, Password and Keyboard interactive user authentication
RSA/DSA/ECDSA/ED25519 New Key Wizard and import/export key
SSH PKCS#11 Support
User authentication using Xagent (SSH user authentication agent)
AES128/192/256, 3DES, BLOWFISH, CAST128, ARCFOUR and RIJNDAEL encryption algorithms
SHA1, SHA1-96, MD5, MD5-96 and RIPEMD160 MAC algorithms
zlib compression
Host Keys dialog box
User Keys dialog box
Supports using master password to encrypt password
Terminal
Unicode-based terminal buffer
VT100, VT220, VT320, XTERM, LINUX, SCOANSI and ANSI terminals
Fixed terminal size option for standardized output
Horizontal scroll bar while in fixed terminal size
Multi-language output encoding (UTF-8)
Compose Bar for sending strings to multiple sessions
Compose Pane for sending multiple lines of strings to multiple sessions
Scroll buffer enabling up to 2,147,483,647 lines to be saved
Character string search using regular expressions
Column unit text selection
Supports multi-byte character strings at copy & paste
Designates delimiters of double-click word selection in the terminal window
Triple click selects one line
Bold font and ANSI color code
Xterm terminal mouse
Xterm 256-color mode
Linux Meta key emulation
Prints terminal screen
Set line spacing and margins in the terminal window
Search a user specified web browser for selected text
Various bell options
Tunneling
TCP/IP and X11 forwarding
Dynamic port forwarding using SOCKS4/5
Tunneling pane for observing and managing active forwarding channels
Instand tunneling to add/remove or modify tunneling to the current connected session
Appearance
Dockable UI for the main window
Theme selection feature
Convenient and powerful user interface
Supports custom layout
Color schemes edit/import/export feature
Change cursor color and blinking
Easily changeable fonts via the Font button
Apply separate fonts for ASCII and non ASCII characters
Designate frequently used character strings as quick commands: Quick Commands Bar, Quick Commands
Pane
Customizable Standard Buttons on toolbar
Security–lock, session selection, and network up/down traffic information display in the status bar
Version 7 Help – Manual - Xshell
About Xshell – 14
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
Full screen view (Alt+Enter)
Transparency options
Local Command
Local shell prompt for advanced users
Local commands, including open, ssh, telnet, rlogin, sftp, and ftp
Local Windows commands, such as ping, ipconfig, netstat, and nslookup
Escape to the local prompt during connection
Interoperability
Interoperable with Xmanager program for X11 forwarding
Interoperable with Xagent program for agent authentication and forwarding
Interoperable with Xftp program for file transfers
Edits scroll buffer in notepad
Sequentially selects Xshell window via the menu command
String Transfer and File Management
Send and receives files via FTP/SFTP
Send and receives files via X/Y/Z MODEM
Send ASCII files
Send Delay for preventing data loss
Auto save and support for various logging formats during session logging
Page setting and print preview
3.2 Minimum System Requirements
Processor: Intel®
compatible
Operating System:Microsoft Windows®
7 or higher
Storage Space: 50MB of available space
Memory: 512 MB
Network: TCP/IP network
3.3 Install and Uninstall
The Xshell installation program was created using InstallShield®
. A variety of installation options can be changed
during installation. However, it is often sufficient to simply click [Next].
To uninstall Xshell, use the standard Windows add/remove functions. Run [Add/Remove Program] in the control
panel and select to uninstall Xshell from the list. Even when the program is uninstalled, the registry information, log
files and data files created by the user are not removed. The information and files are available for reuse when the
program is reinstalled. If you want to remove all the files and registry information completely, remove the following
explicitly:
Registry Information:
HKEY_CURRENT_USERSoftwareNetSarangXshell
File and Folder:
"User's Docuements Folder"Netsarang Computer7Xshell
Version 7 Help – Manual - Xshell
Start – 15
1.
2.
3.
4.
5.
6.
4 Start
This section provides descriptions of the methods to create a TELNET/RLOGIN or SSH session and to connect to
UNIX/Linux hosts. TELNET sessions are very simple. However, an SSH session occasionally requires a user key
registration in the server prior to connection. If you need user key registration for SSH sessions, see 'Public Key
User Authentication'.
4.1 Create Session
Select [New] from the [File] menu. New Session Properties dialog box is displayed.
Fig. 1: New Session Properties dialog box
Enter a session name in [Name].
Select an appropriate protocol from the [Protocol] list.
Enter server host name or IP address in [Host].
Enter port number used by the remote server in [Port Number].
Click [OK].
Version 7 Help – Manual - Xshell
Start – 16
1.
2.
3.
4.
5.
4.2 Connect to Remote Host
The following is the process for connecting to a remote host via an SSH session. If a session is not available, see
'Create Session'.
Select [Open] from the [File] menu. Sessions dialog box is displayed.
Select session for connection from the sessions list and click [Connect]. SSH User Name dialog box is
displayed.
Fig. 2: SSH User Name dialog box
Enter user name and click [OK]. SSH User Authentication dialog box is displayed.
Fig. 3: SSH User Authentication dialog box
To attempt Password authentication, enter password in [Password] and click [OK].
To attempt Public Key authentication, first select a user key from the list. Enter [Passphrase] of the selected
user key and click [OK].
Version 7 Help – Manual - Xshell
Start – 17
6.
Note
If a user key is not available, see 'Public Key User Authentication'.
To attempt Keyboard Interactive authentication, click [OK] and answer the questions given during
connection process.
4.3 Exit Xshell
To disconnect with a session, enter 'exit' in the terminal screen prompt or select [Disconnect] from the [File] menu.
Note
If a session is disconnected withthe [Revert to local shell when connection is closed] option selected, the
session tab remains open and reverts back to local shell. Under local shell status, the current session file's
path prompt is displayed in the terminal screen and local commands, such as open, telnet, ssh, and ping can
be executed.
To end Xshell, select [Exit] from the [File] menu.
Version 7 Help – Manual - Xshell
Session Management – 18
1.
2.
3.
•
•
1.
2.
3.
4.
1.
2.
3.
1.
2.
3.
1.
2.
3.
1.
2.
3.
4.
5 Session Management
Session is a file containing information about remote host connection setup. By creating a session, users can set
different options for different remote hosts. The Sessions dialog box shows all sessions created and enables to
create and edit sessions.
Users can connect to a remote computer without creating a session. For this purpose, Xshell provides a default
session which is ready to use after installation.
5.1 Session Management
To Create a New Session:
Open the New Session Properties dialog box by selecting [New] in the [File] menu.
Enter connection information.
Click [OK].
To Open the Sessions Dialog Box:
Select [Open] in the [File] menu.
Click the standard [Open] button.
To Edit a Session:
Open the Sessions dialog box.
Select a session to edit.
Click the standard [Properties] button.
Click [OK] after completing session editing.
Note
You can edit multiple sessions simultaneously simply by selecting all the sessions you want to edit and
clicking [Properties].
To Rename a Session:
Open the Sessions dialog box.
Right-click on the session to rename.
Select [Rename] in menu.
Note
Session name must be a valid file name.
To Copy a Session Under Different Name:
Open the Sessions dialog box.
Select a session to copy under a different name.
Click the standard [Save As] button.
To Delete a Session:
Open the Sessions dialog box.
Select the session to delete.
Click the standard [Delete] button.
To Create a Shortcut to Session:
Open the Sessions dialog box.
Select a session for which to create shortcut.
Click the standard [Create Shortcut] button.
Select a folder to save shortcut.
Version 7 Help – Manual - Xshell
Session Management – 19
5.
•
•
1.
2.
3.
1.
2.
3.
4.
5.
•
•
•
Click [OK].
To Change Default Session Properties:
To open the default Session Properties dialog box, select one of the following:
Select [Properties] from the [File] menu in local shell.
Click the arrow next to the standard [Properties] button in the main toolbar and select [Default Session]
from the list.
Note
Default session is used when connecting withSSH, TELNET, RLOGIN and SFTP using a local prompt or the
Address Bar.
To use a connection command in the local prompt, see 'Xshell Local Command'. For connections using the
address bar, see 'Address Bar'.
To Create a New Session Folder:
Open the Sessions dialog box.
Click an arrow next to the standard [New] button and select [Folder] from the list.
Enter folder name.
To Copy a Session file to Another Computer:
Select [Export] from the [File] Menu.
If you would like to use the session file's password on another device, set the Master Password.
Copy a session file (*.xsh) or email it to another computer.
On the device to use the session file, set the exact same Master Password.
Select [Import] from the [File] Menu.
5.2 Session Properties
Open the Session Properties dialog box to create a new session or to edit a session.
To Open the Session Properties Dialog Box:
Select [New] from the [File] menu.
Select [Properties] from the [File] menu.
Click the standard [Properties] button.
5.2.1 Connection
In the connection settings, information about session connections may be set. In most cases, users can connect to a
remote host with the connection settings only.
Name
Enter an intrinsic name for the session. The name becomes the session file name, and must be comprised of a valid
characters for a file name.
Protocol
Select a connection protocol to use when connecting to a remote computer. The protocols supported are SSH,
SFTP, TELNET, RLOGIN, SERIAL, and LOCAL.
Host
Enter host name or IP address of the remote computer.
Port Number
Enter the port number of the protocol selected above. When a protocol is selected from the protocols list, the
default protocol port number is automatically entered. If a remote computer is using another port number, the port
number must be directly entered. Default port numbers for each protocol are 22 for SSH/SFTP, 23 for TELNET, and
513 for RLOGIN. SERIAL and LOCAL sessions do not require a port number.
Version 7 Help – Manual - Xshell
Session Management – 20
Description
Add a short description about the session. This information will be displayed on the session tab after running the
session.
Reconnect
This setting is used to restart the session if the connection is lost. Set the number of seconds desired between
reconnection attempts. If a connection is not established during the user specified duration of minutes, the
connection will cease. If the specified time is set to 0, a connection will be attempted.
Use Nagle's algorithm
If this option is selected, transfer efficiency may be slightly higher at the expense of a slower key response rate.
5.2.2 Connection _ Authentication
In the user authentication settings, the authentication method, user name, password, user key, etc. may be
designated
Method
Select an authentication method among Password, Public Key, Keyboard Interactive, GSSAPI and PKCS11. If the
selected authentication method is not supported by the SSH server, a dialog box asking about the user
authentication method is displayed during connection.
Note
If the PC running Xshell is utilizing an Xshell supported Kerberos module, Xshell can only automatically
authenticate to the SSH server if GSSAPI authentication is selected.
User Name
Enter a user name for login. User name is the remote computer login account. If this field is left blank, a dialog box
asking for the user name is displayed during connection.
Password
Enter a remote user account password. This value is valid when Password authentication is selected. If this field is
left blank, a dialog box asking for the user authentication is displayed during connection. The password is encoded
and saved in the user's PC. For greater security, leave this field blank.
User Key
Select a user key to use when Public Key authentication is selected. If this field is left blank, a dialog box asking
about the user authentication is displayed during connection. If a user key is not in the list, a key must be created
and registered in the remote SSH server.
Passphrase
Enter the passphrase for the selected user key. The entered key passphrase is encoded and saved in the user's PC.
For greater security, leave this field blank.
5.2.3 Connection _ Authentication _ Login Prompts
It is necessary for Xshell to recognize the server user name/password prompt in order to automate the login
process for the TELNET or RLOGIN protocol. In general, the default value is used.
TELNET
Enter the user name and password prompt to automate TELNET login process. Note that blanks are recognized as
valid characters.
RLOGIN
Enter the password prompt for RLOGIN protocol. A password may not be needed depending on the RLOGIN server
settings. Note that blanks are recognized as valid characters.
Version 7 Help – Manual - Xshell
Session Management – 21
5.2.4 Connection _ Login Scripts
For the login script settings, commands to be automatically entered in the terminal may be defined. After a
successful login to a remote server, commands are sequentially executed in the order displayed in the list. This
feature is very useful when you login to another server after the first login to a remote server.
Execute the Following Expect and Send Rule
Select this option to use expect and send rule.
Add
Open the Expect and Send Rule dialog box. When rules editing is complete, the rule is added to the list.
Edit
Open the Expect and Send Rule dialog box and edit the selected rule.
Remove
Delete the Expect and Send Rule.
Move up
Move the Expect and Send Rule up.
Move Down
Move the Expect and Send Rule down
Execute script when session starts.
Set a script file to execute after a session connection.
5.2.5 Connection _ SSH
Set general SSH protocol options.
Remote Command
Specify the remote command to run after connection.*
Protocol Version Priority
Select which SSH version to prioritize. SSH2 is safer than SSH1 and offers more capabilities.
Use Xagent (SSH Agent) for authentication
Private keys for the public key authentication are provided by Xagent.* Using Xagent, entering a passphrase is not
required during the public key user authentication process.
Allow agent forwarding
Xagent allow the remote servers which are already connected with the SSH protocol to use its private keys. It can be
used when connecting to another remote server or using a remote service through public key authentication from a
remote server.*
Use ZLIB Compression
A compression algorithm is used to compress all SSH connection data. In an environment where network speed is
slow, use this option to improve the speed.
Do Not Allocate a Terminal
Select this option when not using terminal. If this option is turned on, a terminal(tty) for input/output is not
assigned and thus input/output on the screen is not possible. Use this option if you want to use tunneling only
without terminal access.
Accept and save host key automatically upon first connection
If the option is turned on when connecting to a server where the host key is not registered, the host key is
automatically saved without going through the authentication process.
Version 7 Help – Manual - Xshell
Session Management – 22
5.2.6 Connection _ SSH _ Security
Encryption
Encryption algorithms are used to encrypt and decrypt network traffics. Users may select a preferred encryption
algorithm from the list. If <Cipher List> is selected from the list, multiple algorithms may be attempted in the order
appearing in the list. To edit the list of <Cipher List>, click [Edit].
MAC (Message Authentication Code)
MAC is added in SSH2 for greater security and to ensure data integrity. If <MAC List> is selected from the list,
multiple algorithms are tried in the order appearing in the list. To edit the list of <MAC List>, click [Edit].
Key exchange
Users can select the intial Key Exchange for the SSH connection. The desired algorithm can be selected from the list.
If the server does not support the selected algorithm, the connection will fail.
5.2.7 Connection _ SSH _ Tunneling
In the tunneling setting, TCP/IP, Dynamic and X11 forwarding rules may be set. These settings are valid only when
the SSH protocol is selected in Connection setting.
For details on tunneling setting, see 'Tunneling Service'.
5.2.8 Connection _ SSH _ SFTP
Set SFTP protocol related options.
Startup Folder
Set a local and remote folder with which to start after a successful login via SFTP protocol.
5.2.9 Connection _ TELNET
Set TELNET protocol related options.
Use XDISPLOC Telnet Option
Uses XDISPLOC Telnet option to pass display (PC X server) information to server. If you are using a PC X server such
as Xmanager, use this option to execute remote X11 applications from a local PC.
Display
Enter the DISPLAY value to pass upon login. $PCADDR value is translated automatically to IP address of a local PC
right before it is passed to server. The DISPLAY number must match the DISPLAY number of the X server currently
running on the PC.
Option Negotiation
This option determines who initiates the attempt to negotiate additional TELNET options. When set to Active, after
a connection has started, Xshell intiates the negotation. Passive waits for the server to intiate the negotiation. The
values may have to be different depending on the server or firewall settings. If both the server and Xshell are set to
Passive, the negotiation will not proceed. Conversely, if Active is selected and the firewall is enabled on the server,
the negotiation may fail.
5.2.10 Connection _ RLOGIN
Set RLOGIN protocol related options.
Version 7 Help – Manual - Xshell
Session Management – 23
Terminal Speed
Designate terminal speed to be passed to rlogin server.
5.2.11 Connection _ SERIAL
In serial setting, serial connection options may be set. Instead of using the traditional terminal environment,
RS232C SERAL connection lets you use your PC to connect to UNIX machines that has no graphic card support or
where direct access to console is not available. To use Serial connection through Xshell, serial interface must be
installed in the host system.
For details on serial setting, see 'Serial Connection'.
5.2.12 Connection _ PROXY
Proxy Server
Select a proxy server to use in this session.
For details on proxy setting, see 'Proxy Setting'.
5.2.13 Connection _ Keep Alive
Send keep alive messages while this session is connected
Send keep alive messages every user defined interval (seconds) to a remote computer. This is useful when a
connection is unexpectedly closed while the connection is idle. In some network environments, the gateway or
firewall system forces a disconnection if data transfer is not made for a defined period of time.
Send string when network is idle
Certain systems, if there is not user key input, the sessions is automatically determined to be idle and the sesion is
ended. Typically, the NF value, /n, is used.
Send TCP keep alive packets when network is idle
Users cannot designate the interval or cycles in which keep alive packets are sent at the OS level.
5.2.14 Terminal
In the terminal setting, terminal types and other related options may be set.
Terminal Type
Select a terminal type to use. Xshell supports VT100, VT102, VT220, VT320, ANSI, SCOANSI, LINUX and XTERM
terminals. The terminal type may change after a connection is made depending on the remote user's settings. Users
can check the current terminal type using the echo $TERM command.
Terminal Size : Columns
Enter the number of columns in the terminal. The value is applied when the column size is fixed or if the terminal is
reset after the connection is made.
Terminal Size : Rows
Enter the number of lines in the terminal. The value is applied once the terminal is reset after the connection is
made.
Fixed column size
With this option selected and a connection established, even if the user changes the window size, the column size,
specified by the user, will not change. If the window size is smaller than the column size, a horizontal scroll bar will
be shown.
Version 7 Help – Manual - Xshell
Session Management – 24
Reset terminal size when connected
When a session is run, Xshell's window will be resized to the user defined terminal size.
Scroll Buffer
Designate the row unit scroll buffer size.
Push Erased Screen into Scroll Buffer
With this option enabled, clearing the screen or resetting the terminal will push the contents into the Scroll Buffer.
The erased contents can be viewed again using the mouse scroll.
Encoding
Select terminal output encoding. This value must be a language the remote server uses. If Default Language is
selected, Xshell uses the Windows encoding.
Treat Ambiguously sized characters as wide
Characters without size information will be treated as 2-byte characters.
5.2.15 Terminal _ Keyboard
In the keyboard settings, users may set the character strings sent by their PC's keyboard to the server.
Function Key Emulation
Set function keys appropriate for your terminal type. If <Default> is selected, the function key is automatically
assigned according to the terminal type designated in the 'Terminal' setting.
Specify an Alternate Key Mapping File
Using a custom key mapping file, users can manually assign a string to each function key (F1~F20) and it will be sent
to the server when pressed.
Delete Key Sequence, Backspace Key Sequence
Select a character string to be sent when the user presses the Delete or Backspace key.
Meta Key Emulation
Treat the Alt key as the Meta key for application programs which use meta keys, such as Emacs.
Use Left ALT Key as Meta key
Treat the Left Alt key as the Meta key.
Ctrl+Alt works as Alt Gr
If Ctrl + Alt are pressed simultaneously, it will be recognized as the Alt Gr key.
Use Right ALT key as Meta key
Treat the Right Alt key as the Meta key.
5.2.16 Terminal _ VT Mode
Set the initial values for each terminal mode.
Auto Wrap Mode (DECAWM)
Activate auto wrap mode at startup.
Origin Mode (DECOM)
Activate origin mode. When this option is activated, the cursor moves based on the location designated by the
server.
Reverse Video Mode (DECSCNM)
Enables Reverse Video Mode when the session starts. When this option is activated, the screen foreground and
background colors are reversed.
Version 7 Help – Manual - Xshell
Session Management – 25
New Line Mode (NLM)
Enables New Line Mode when the session starts. When this option is activated, both CR and LF are sent when Enter
key is pressed. If this option is not selected, Enter key sends CR only.
Insert Mode (IRM)
Enables Insert Mode. When this option is selected, characters received from the remote server are inserted into
where the cursor is located and the existing characters are not erased.
Echo Mode (SRM)
When this option is activated, a character string to send to server is displayed on screen and then transferred to
server.
Initial Cursor Key Mode (DECCKM)
Set initial cursor key mode value.
Initial Numeric Keypad Mode (DECNKM)
Set default setting for Keypad mode.
5.2.17 Terminal _ Advanced
Set advanced terminal options.
Restrict Mouse Use at Terminal with Shift Key
Some applications such as 'vi' and 'mc' can use mouse click and drag to make a selection or change the directory.
When this option is selected, press the Shift key while using the mouse and Xshell uses the mouse input to perform
actions such as making selection on the screen.
Erase Screen Using Background Color
Use the current terminal background color rather than the background color set in the color scheme when erasing
screen.
Receive LF as CR+LF
Display both CR and LF in the terminal screen when LF is received from the server.
Scroll to the Bottom when Pressing the Key
Scroll to the bottom of the terminal screen when a user enters a key.
Scroll to the Bottom at Terminal Input/Output
Scroll to the bottom of the screen when text is displayed on the terminal screen.
Enable Destructive Backspace
Erase a letter to the left of the cursor, when the Backspace key is pressed, and move the cursor to the erased
character's position.
Disable Blinking Text
Blinking texts do not blink and are displayed with solid color.
Disable Terminal Title Change
Do not change the Xshell title bar. In most cases, the title bar displays the folder and host name according to a
request from a remote computer.
Disable Terminal Printing Feature
Display the terminal on screen without printing it when a request for terminal printing is received from server.
Disable Switching to Alternate Terminal Screen
Do not use an alternate screen for certain application programs, such as vi. When an alternate screen is used, and
the application is terminated, the terminal area goes back to the screen before the application is started.
Version 7 Help – Manual - Xshell
Session Management – 26
Disable Terminal Size Change upon Request
Ignore a terminal size change signal from the server.
Answerback to ^E
For output ^E (ENQ, Enquiry), most terminal emulators will answerback with its name. Xshell defaults to the same
behavior, but the user may define which characters to answerback with.
Use the built-in font to draw line characters
When outputting lines or boxes with line characters (─,│,┌┘,├, etc.) use Xshell's default font instead of the user
defined font.
Use the built-in font to support Powerline
Enable this option for a cleaner ouput when using Powerline.
5.2.18 Appearance
In the appearance setting, the terminal window's colors and fonts may be set.
Color Scheme
Select a color scheme. Xshell provides several default color schemes. Add a new color scheme or edit an existing
color scheme in the Select Color Scheme dialog box.
Font
Select a font to be used for Roman characters and ASCII numbers. Only fixed width fonts are listed. A font may also
be selected by pressing the standard [Fonts] button.
Asian Font
Select the font to be used for non ASCII characters such as Chinese. If you change the font via the Standard Button
toolbar, this value will be replaced by the font selected for ASCII characters.
Font Size
Select the desired font size. If the desired font size is not displayed, it can be manually entered.
Font Quality
Select the quality of the characters displayed in the terminal.
Bold
Select a method to express bold characters.
Cursor Color
Select the cursor's color.
Text Color
Select the color for text within the cursor.
Use blinking cursor
Enable this option to have the cursor blink.
Speed
Select the speed at which to blink the cursor.
Appearance
Select the type of cursor.
5.2.19 Appearance _ Window
In the window settings, set the margins, spacing, tab color, and background of Xshell's terminal window.
Version 7 Help – Manual - Xshell
Session Management – 27
Margin
Set terminal window margins.
Spacing
Set spacing between lines and characters outputted in the terminal window.
Tab Color
Select or choose the color of the session tab.
Background Image
Select a BMP image file to set as the terminal's background image.
Background Image
Select a BMP image file to set as the terminal's background image.
5.2.20 Appearance _ Highlight
Highlighting will highlight user defined keywords with color or font conversions. Set the Highlight Set to be used to
manage keywords to emphasize. For more information on settings keywords and managing highlight sets, see
"Highlight Set Settings."
5.2.21 Advanced
In the advanced settings, set quick command sets, tracing, bell options, and log options.
Quick Command Set
Select the default quick command set to be used in a session. The selected quick command set is displayed in the
quick command bar when the session is started. For more information on quick commands and settings, see
"Quick Command Bar Settings."
Disable Shortcut Key to Quick Command
Ctrl+F1 and Ctrl+F2 keys are not used as shortcut keys to quick commands. The corresponding key values are sent
to the server.
Xftp Option
Xftp can be called from Xshell using the current connection's information. When the Telnet and Rlogin protocols are
being used, Xftp will utilize the FTP protocol. A port number other than 21 can be set here.
Send Delay
Pasting a large number of strings into a terminal may cause some of the data to be lost depending on the network
or server environment. In this case, it is recommended to use Send Delay to manually delay the transmission.
Send Delay : Character Delay
Set the string paste delay between the characters in milliseconds.
Send Delay : Line Delay
Set the string paste delay between lines in milliseconds.
Send Delay : Prompt
When pasting multiple lines in sequence, paste the following line only when this user defined string appears. Set a
"Max Wait" time to withold pasting the following line if the specified string does not appear.
5.2.22 Advanced _ Trace
In the tracing settings, set protocol tracing options. This feature is helpful when you want to trace detailed protocol
messages to solve a specific problem. A tracing message is displayed in the terminal screen.
Version 7 Help – Manual - Xshell
Session Management – 28
•
•
•
•
SSH Version, Algorithm Exchange and User Authentication
Display information about version exchange, encoding algorithm, compression method, and server and user
authentication.
SSH TCP/IP and X11 Tunneling
Display port forwarding information on screen.
SSH Packet
Display SSH Packet message ID information.
TELNET Option Negotiation
Display the TELNET option exchange process between Xshell and the telnet server on the screen.
5.2.23 Advanced _ Bell
Xshell incorporates several options to utilize the typical sytems' bell sounds using the ASCII character number 7(Bell
character, ^G).
Bell Settings
Select how to acknowledge the bell character.
None (Ignore bell request) : Do not respond to the server's bell character output
Default system alert sound : Play Window's default alert sound
PC Speaker : Play the bell sound via the PC's speakers
Play the following sound : Play a user defined .wav format file
Flash window and taskbar if window is not focused
If the bell enabled window is behind another window or if the user is working on another program, the icon on the
Windows taskbar and the window itself will flash to notifify the user that there was a bell ouput on the remote
system.
Ignore Bell
Non system alerts and etc. may cause unintendedl bell rings due to incorrect output strings in the terminal. Time
intervals can be set to avoid unintended bell rings.
Temporarily disable the bell if the bell request is received more than once during the following time duration.
Any bell requests made more than once during the time duration set here (seconds) will be ignored.
Re-enable it after the following period of time.
After a bell request has been ignored, bell requests will once again be accepted after no bell requests are made in
the time duration set here (seconds).
5.2.24 Advanced _ Logging
In the logging settings, set the options related to log creation.
File Path
Specifies the path of the log file. The string conversion formats available at file creation are %n: session name, %Y:
current 4 digit year, %m: current 2 digit month, %d: current 2 digit day, %t: current time (%H-%M-%s), %h: current 2
digit hour, %M: current 2 digit minutes, %s: current 2 digit seconds.
Overwrite if the file exists
If a file with the same name exists in the destination folder, specify whether or not to overwrite the file. If this option
is not selected, a sequence number is appended to the file name.
Start Logging upon connection
Logging is automatically started when a session is connected to a remote host.
Version 7 Help – Manual - Xshell
Session Management – 29
•
•
Prompt me to choose a file path when logging starts
A prompt will be displayed when logging starts which allows the user to specify where to save the log file rather
than the default path.
Include terminal code
Choose one of the following logging methods.
Record only printable text
Record terminal code as well as printable text
If you include terminal code, all contents (color, string output status, etc.) will be recorded.
Timestamp: Log file records
Log file records will show the time the log was output.
Timestamp : Format
This is how the the date and time are formatted: %n: session name, %Y: current 4 digit year, %m: current 2 digit
month, %d: current 2 digit day, %t: current time(%H-%M-%s), %h: current 2 digit hour, %M: current 2 digit minutes,
%s: current 2 digit seconds, %a: other OS expression for date and time, %I: line number.
Timestamp: Preview
Displays the formatted timestamp based on current date and time.
5.2.25 File Transfer
This sections deals with X/Y/Z modem protocol file transfers during a terminal connection.
Folder
When transferring a file from remote servers, users can specify whether to save to a predetermined path or to have
a prompt displayed so the user can specifiy each transfer.
Duplicate file handling
When a file with the same name exists, users can specify whether to automatically rename the file or to overwrite it.
Upload protocol
User can upload local files by simply dragging and dropping the file into Xshell. Specify which protocol to use during
these uploads.
5.2.26 File Transfer _ X_YMODEM
Set various options for file transers using X/Y modem.
Option
Select the packet size to be sent to the remote server. If 1024 bytes is selected, the transfer speed will be faster, but
it must be supported by the server.
Upload Command
When using the XMODEM or YMODEM commands in the File Menu or when dragging and dropping, the selected file
is automatically transferred. Set the commands the server will use to prepare to receive the files at this time. For X/Y
modem related commands, please refer to the related server manual.
5.2.27 File Transfer _ ZMODEM
In the ZMODEM settings, set various options relating to ZMODEM file transfers.
Version 7 Help – Manual - Xshell
Session Management – 30
1.
2.
3.
1.
2.
3.
4.
5.
Activate ZMODEM Automatically
Automatically start file send when remote ZMODEM program starts send. If this option is not set, the file must be
received by selecting [Send with ZMODEM] in the [File] > [Transfer] menu. X/YMODEM cannot automatically be
received and so [Receive with X/YMODEM] must be selected" from the [File] > [Transfer] menu.
5.3 Export
Sessions exported by Xshell are collected into a single convenient file. When this file is imported from another
computer where Xshell is installed, the imported sessions may be used without additional setup. However, the
password of the exported session file will not be available unless a Master Password has been set on the PC from
which the session file was exported and the same exact Master Password has been set on the PC into which the
session file is imported.
To Export Session:
Select [Export] from the [File] menu. The Import/Export Sessions wizard is displayed.
Select the position where the exported file is to be saved and click [Next]. Session export results will be
displayed.
Note
If 'Clear Password' is selected, the exported session file will not include the session password during
the export. Also, even if 'Clear Password' is not selected, the password will only be evailable if
imported into the same computer under the same user. To use the session with the session password
on another device you must first set a Master Password on the computer from which the session file
is being exported and the same exact Master Password must be set on the computer into which the
session file is to be imported.
Click [Finish] to complete sessions export.
5.4 Import
Xshell can import sessions exported by other computers.
To Import Session:
Select [Import] from the [File] menu. The Import/Export Sessions wizard is displayed.
Directly enter the file path exported from other computer or click the […] button to select the exported file
and click [Next]. Sessions are imported and the result is displayed.
Select how to handle sessions with the same file names.
Click [Next] to select the types of sessions to import.
Click [Finish] to complete session import.
Version 7 Help – Manual - Xshell
Connection – 31
1.
•
•
•
1.
•
•
•
2.
1.
2.
1.
2.
3.
1.
1.
6 Connection
Xshell provides various connection methods, such as the Sessions dialog box, local prompt, address bar, links bar,
and shortcuts to session.
6.1 Connections without Session Files
Connection from the Local Prompt:
Enter one of the following commands in the local prompt:
[C:~]$ telnet hostname
[C:~]$ ssh hostname
[C:~]$ rlogin hostname
Note
A port number must be designated if a remote host does not use the default port number. For information
on commands, see 'Xshell Local Command'.
Connection from the Address Bar:
Enter one of the following commands in the address bar:
telnet://hostname
ssh://hostname
rlogin://hostname
Press Enter or click [Connect].
Note
A user name and port number may be entered in the address bar. For details, see 'Address Bar'.
Connection from the Recent Sessions:
Select [Recent Sessions] in the [File] menu.
User authentication of the selected session is performed.
Note
If user authentication is registered in the registration information of the selected session, step 2 is skipped.
6.2 Connections with Session Files
Connection from the Sessions Dialog Box:
Open the Sessions dialog box.
Select a session for connection.
Click [Connect].
Note
If a remote host connection already exists, a new tab is opened or a new Xshell is started.
Connection from the Local Prompt:
Enter the following command in Xshell local prompt. [C:~]$ open session file name
Connection from a Shortcut:
Double-click the shortcut icon of a session.
Note
To obtain information about shortcut to session, see 'Session Management'.
Version 7 Help – Manual - Xshell
Connection – 32
1.
2.
1.
2.
1.
2.
3.
4.
5.
6.
7.
8.
9.
10.
11.
12.
13.
1.
2.
3.
4.
5.
6.
7.
Connection from the Session Manager:
Make sure the "Session Manager" is enabled in the [View] menu.
Select the session you want to connect to and double-click or press the Enter key.
6.3 Sessions to Run on Xshell Startup
Select 'Options' from the [Tools] menu.
In the 'General' tab, click 'Add' and select session files to automatically connect upon Xshell startup.
6.4 SERIAL Connection
RS232C SERIAL connections lets you use your PC as a terminal when there is no video card in the UNIX system or if
the console is not directly accessible. To use SERIAL connections via Xshell, the SERIAL interface must be installed
in the host system.
To Make Serial Connections:
Select [New] from the [File] menu. New Session Properties dialog box is displayed.
Enter a session name in [Session].
Select SERIAL from [Protocols] list.
Enter a host name in [Host]
Select [SERIAL] from [Category].
Select the RS232C serial port number connected with the PC where Xshell is installed from [Port]. If the port
number is not in the list or if the name is the same as the named pipe, enter it manually.
Select communication speed in [Baud Rate]. The value must match the server value. In general, 9600 is used.
Select the transferred data unit bit count in [Data Bits]. It must match the server value.
Select number of bits to indicate the end of data unit in [Stop Bits]. Make a selection according to server
settings.
[Parity] is to verify errors in transferred data. Select one from none, odd, even, mark and space according to
server settings.
[Flow Control] is for controlling data communications. Supported flow control methods are XON/XOFF and
RTS/CTS. If a flow control is not set(None), data may be lost if data is sent faster than the serial line.
Create a new session by clicking [OK].
Make a connection as described in 'Connection with Sessions Files' with the created session.
6.5 Connection with Kerberos
Xshell 6 supports MIT GSSAPI Kerberos and Microsoft's SSPI Kerberos authentication. This article assumes that you
have a working Kerberos server and client.
To create a new Kerberos session,
Select [New] from the [File] menu.
Enter a session name in [Name].
Select SSH from the [Protocols] list.
Enter a host name in [Host]
Select [Authentication] from under [Category].
Select GSSAPI from the [Method] list.
Note
If the PC running Xshell is utilizing an Xshell supported Kerberos module, Xshell can only
automatically authenticate to the SSH server if GSSAPI authentication is selected.
To change the GSSAPI settings, click the [Setup] button.
Version 7 Help – Manual - Xshell
Connection – 33
8.
9.
10.
11.
1.
2.
3.
4.
5.
6.
7.
8.
9.
10.
11.
12.
1.
2.
3.
4.
Note
To connect to another server using Kerberos authentication from a server using Kerberos
authentication, select the 'Allow GSSAPI credential delegation' option.
Click [OK] to save the GSSAPI settings.
Enter the user name.
Click [OK] to save the session file.
Click [Connect] to connect immediately or select the session file from the Sessions Dialog Box to connect.
You have finished creating a session that will use the Kerberos module. When this session opens, it will try to use the
Kerberos credential for the specified user. It has to be the same user you defined in the Network Identity Manager.
6.6 Connection with PKCS _11
PKCS #11 is one of the public key cryptography standards. Xshell 6 can connect to a remote SSH server using a PKCS
#11 encrypted hardware security token (HSM) or a smart card's RSA key.
To create a new PKCS #11 session:
Select [New] from the [File] menu.
Enter a session name in [Name].
Select SSH from the [Protocols] list.
Enter a host name in [Host]
Select [Authentication] from under [Category].
Select PKCS11 from the [Method] list.
Click the [Setup] button.
Enter the path of the middleware program that can connect to the hardware token that contains the user
key. Or click […] to browse for it.
If the pin number is set in the hardware token, enter the pin number.
Enter the user name.
Click [OK] to save the session file .
Click [Connect] to connect immediately or select the session file from the Sessions Dialog Box to connect.
6.7 Proxy Setting
Proxy server mediates between a network to which a user belongs and an external network to be connected with.
Add, edit and delete a proxy server in Proxy List dialog box.
To Add Proxy Server:
In [Connection > Proxy] category of Session Properties dialog box, click [Browse] in [Proxy Server].
Click [Add] in Proxy List dialog box. Proxy Settings dialog box is displayed.
Enter proxy server name, proxy server type, host information and user information.
Press [OK] to add proxy server.
6.8 Jump host
The Jump Host feature is a proxy feature that allows you to utilize an intermediate SSH server in order to reach the
final destination server. As it uses Open-SSH’s TCP Tunneling, this feature can be used to connect to servers that
cannot directly connect to the firewall or network configuration.
To Connect Using the -J Parameter from the Local Shell:
Version 7 Help – Manual - Xshell
Connection – 34
1.
1.
2.
3.
4.
5.
6.
In the local shell, type ssh -J user1: passwd1 @ jump_host1, user2: passwd2 @ jump_host2
destination_host.
To Connect Through a Proxy:
Select [New…] from the [File] meun.
Enter the host of the destination server in [Host].
Select [Browse] in [Proxy Server].
Select [Add] to open the proxy creation window.
In [Proxy Settings], change [Type] to JUMPHOST and enter the remaining required information.
Fig 1: Proxy Settings Screen
Set the created proxy as the default in [Proxy Server].
2 http://ssh.com
Version 7 Help – Manual - Xshell
Security – 35
1.
2.
•
•
•
1.
2.
3.
4.
5.
6.
1.
2.
7 Security
Xshell provides public key user authentication. Host keys and user key databases created in Xshell may be used in
Xmanager and Xftp programs. Once a public key is created, it may be used in other programs without any
additional configuration.
7.1 Public Key User Authentication0
For public key user authentication, a pair of user keys must be created comprised of a public key and a private key.
While public key authentication is carried out, the private key is used by Xshell to create a user signature and the
public key is used by the SSH server to check the signature.
A user key may be created from the SSH server or Xshell. If the user key is created from the server, the private key
must be registered in the Xshell private key repository using Xshell import. If the user key is created from Xshell,
the public key must be registered in the server.
To Create a User Key:
Select [New User Key Wizard] from the [Tools] menu.
Create a user key according to instructions given by the New User Key Wizard.
Note
Register a public key on a server at the last stage of key creation. Registration methods vary depending on
server types.
SSH1: Copy the public key text and save it to $HOME/.SSH/authorized_keys file. Execute the following
command to turn off the write permission of the files and directories.
$ cd
$ chmod go-w . .SSH .SSH/authorized_keys
SSH2-OpenSSH: OpenSSH servers use this format. Copy the public key text and save it to
$HOME/.SSH/authorized_keys2 file. Execute the following command to turn off the write permission
of the files and directories.
$ cd
$ chmod go-w . .SSH .SSH/authorized_keys2
SSH2-IETF SECSH: Certain commercial SSH servers, such as ssh.com2
server, use this format. Save a
public key under an intrinsic name, such as mypublickey.pub and copy it to $HOME/.ssh2 directory.
Add the following line to $HOME/.ssh2/authorization file:
Key mypublickey.pub
Execute the following command to turn off the write permission of the files and directories.
$ cd
$ chmod go-w . .ssh2$ chmod go-w .ssh2/authorization .ssh2/mypublickey.pub
To Register a Public Key in a Server:
Open the User Keys dialog box by selecting [User Key Manager] from the [Tools] menu.
Select a user key to register.
Click [Properties]. The User Key Properties dialog box is displayed.
Click the [Public Key] tab.
Select an appropriate type from the [Public Key Format] list.
Click [Save as a file] to save or copy the key content and register the key to the server according to the public
key registration method above.
To Change the User KeyPassphrase:
Open the User Keys dialog box.
Select a user key for which to change the passphrase.
3 http://SSH.com
Version 7 Help – Manual - Xshell
Security – 36
3.
4.
5.
Click [Properties]. The User Key Properties dialog box is displayed.
Click the [General] tab.
Click [Change Passphrase].
Note
Import, export, rename, delete, and create a user key in the 'User Keys Dialog Box'.
7.1.1 User Keys Dialog Box
The User Keys dialog box enables the creation and management of user keys. Open this dialog box by selecting
[User Key Manager] from the [Tools] menu.
Import
Select a user key file and import it by opening the Open dialog box. Currently, Xshell can read the SSH1 protocol
RSA key, the OpenSSH SSH2 protocol RSA/DSA key, the SSH.com3
key and the NetSarang Computer user key
formats(*.pri).
Export
Save a selected user key file by opening the Save dialog box. Exported file types are NetSarang user keys or the
OpenSSH SSH2 format. NetSarang Computer user key format files(*.pri) can be used in programs developed by
NetSarang Computer, Inc.
Delete
Delete a selected user key from database.
Rename
Rename a selected user key. Key name must be valid as a file name.
Properties
Show user key attributes. Type, length, fingerprint, and public key may be viewed, and the key passphrase may be
changed.
Generate
Open the New User Key Wizard.
7.2 Host Key Management
A host key is a remote host public key, and users can verify the host via its fingerprint. When a connection is made,
the remote host sends its public key to Xshell. When the host key is valid and you trust it, you can save the host key
to the database in Xshell. If a host key is not saved in the database, the SSH Security Warning dialog box will
appear when you try to connect to the host.
7.2.1 SSH Security Warning Dialog Box
The SSH Security Warning dialog box is displayed when a remote host key is not saved in the host key database or
the fingerprints of the remote host key and the saved host key are different.
Accept Once
Accept host key for this connection only. The host key is not saved and the same dialog box opens at the next
connection. This is useful when a server host key changes often or the user rarely connects to the server.
Version 7 Help – Manual - Xshell
Security – 37
1.
2.
3.
4.
5.
6.
1.
Accept and Save
Save host key and process the connection. This dialog box does not open on the next connection. This is useful
when the fingerprint is correct and the user connects to the host frequently.
Cancel
Host key is not accepted and connection is cancelled.
7.2.2 Host Keys Dialog Box
The Host Keys dialog box permits users to manage host keys of remote hosts to which connection is allowed.
Import
Import a host key by opening the Open dialog box. The imported host key is saved in the host key database. Files
saved in the SECSH public key format can be imported.
Export
Export a selected host key by opening the Save dialog box. The exported keys are saved in the SECSH public key
format and can be used in other programs.
Remove
Remove a selected host key from the database.
View
Open a selected host key with notepad.
7.3 Master Password
Master password can be used to save passwords more securely using the user defined master password. Xshell
saves all password information in an encrypted format. However, since passwords are encrypted using a fixed key,
it has a risk of being exploited by hackers. When the master password is enabled and set, it is mixed in during
password encryption adding an additional layer of security.
Master password uses a user defined keyword to encrypt the password section of the session data. When the master
password is enabled, Xshell asks for the master password every time a new Xshell instance is started and a session
is open. If the correct master password in not inputted, the session's password is not able to be utilized and must be
entered again manually preventing unauthorized access.
Note
Be sure to remember your master password. If you lose your master password, there is no way to retrieve
the password information stored in the session files.Maser Password settings are applied simultaneously to
Xmanager, Xshell, and Xftp sessions.
To Enable Master Password:
Click on the Tools menu and then select Options.
Select the Security tab.
Click Set Master Password to open the Master Password dialog box.
In the Master Password dialog box, enter a new master password in the New Password field.
In the Confirm Password field, enter the new password again.
Click OK to save the changes.
Once master password is enabled, all sessions saved in the default location are re-encrypted using the new master
password.
To Change Master Password:
Click on the Tools menu and then select Options.
Version 7 Help – Manual - Xshell
Security – 38
2.
3.
4.
5.
6.
7.
8.
1.
2.
3.
4.
5.
1.
2.
3.
4.
5.
Select the Security tab.
Click Set Master Password to open the Master Password dialog box.
In the Change area click Change to open the Master Password Change dialog box..
Enter the current master password in the Current Password field.
Enter the new master password in the New Password field.
Enter the new password one more time in the Confirm Password field.
Click OK to save the changes.
To Disable Master Password:
Click on the Tools menu and then select Options.
Select the Security tab.
Click Set Master Password to open the Master Password dialog box.
Click the Remove button to open the Remove Master Password dialog box.
In the Remove Master Password dialog box, enter the master password and click OK.
To Reset the Master Password:
Click on the Tools menu and then select Options.
Select the Security tab.
Click Set Master Password to open the Master Password dialog box.
Click the Reset button to open the Reset Master Password dialog box.
In the Reset Master Password dialog box, click Reset Master Password and click OK.
Note
Reset of the master password can be used if your forgot your master password or if you would like to clear
all the passwords stored in your sessions.
Version 7 Help – Manual - Xshell
Tab Management – 39
•
•
•
•
•
1.
2.
1.
2.
1.
2.
3.
8 Tab Management
Xshell has a powerful tab management feature. You can connect to multiple hosts and compare them side by side
from a single window. The intuitive tab management feature is a unique Xshell feature that cannot be found in
other terminal emulators.
Each tab is associated to a single terminal and it belongs to a tab group. A tab group is a collection tabs. A single
Xshell window can have multiple tab groups and can be organized as desired.
8.1 Tab
There are several ways you can create a new tab. You can use any of the following methods:
Click the [Tab] menu and select [New Tab]
Double click on the tab bar in the background.
Use the keyboard shortcut, Shift + Alt + N.
To close a Tab:
Click the x button on the tab.
When focus is on the tab, press Ctrl+Shift+F4.
To close a tab from Terminal:
While connected to the remote host, enter 'exit'.
In Xshell's local shell, type 'exit' again.
Note
To close a tab from Terminal, you must not have selected the 'Revert to local shell when connection is
closed' option in the [Options] dialog box. Also, if the 'Exit Xshell when the last tab is closed' option is not
selected, you must select 'Exit' from the 'File' menu to exit Xshell.
8.2 Tab Group
A tab group is collection of multiple tabs. Use tab groups to neatly organize sessions. Only one tab from the tab
group is visible at any given moment. To view and compare multiple tabs simultaneously, you must separate the
tabs into different groups.
To Create a New Tab Group:
Right click on the tab background.
Point to [New Tab Group] and select a location you want to create a new tab group.
Note
If you want to create a new tab group with an existing tab, you can drag a tab to edge of the terminal until
you see the blue marker and drop it.
To Move a Tab to a Different Tab Group:
Select a tab you want to move to a new tab group.
While holding down the left mouse button, drag the tab to a different tab group.
Drop the tab to a new tab group.
To Delete a Tab Group:
Version 7 Help – Manual - Xshell
Tab Management – 40
1.
2.
3.
1.
2.
1.
2.
1.
2.
1.
2.
1.
2.
Select a tab group you want to close.
Right click on the tab group in the background.
Select the [Close This Tab Group] option.
To Combine All Tab Groups into one Tab Group
Select the Xshell window you would like to combine tab groups.
In the [Tab] menu, select 'Merge All Tab Groups' under 'Arrange.'
8.3 Split and Merge Tabs
Tabs can be separated to create new windows and you can combine tabs from different windows into one window.
To use this feature, you must turn off the 'Use single-process mode for better performance' in [Options >
Advanced].
To Detach a Tab and Create a New Window:
Select the tab you want to detach with the mouse.
Drag the tab and drop it outside of the Xshell Window.
To Detach and Tab and Add it to an Existing Window:
Select the tab from an Xshell Window.
Drag the tab and drop it into a tab group of an existing Xshell Window.
8.4 Arrange Tabs
Multiple tabs can be automatically arranged into horizontal, vertical, or tiled tab groups. This is useful for
concurrent operations on multiple servers.
To Arrange Tabs Horizontally, Vertically, or Tiled:
Select the Xshell window to be arranged.
In the [Tab] menu, under 'Arrange,' select the desired arrangement method.
To Combine an Auto-Arranged Group of Tabs into One Tab Group:
Select the Xshell window to be arranged.
In the [Tab] menu, under 'Arrange,' select 'Merge All Tab Groups.
Version 7 Help – Manual - Xshell
Tunneling Service – 41
1.
2.
3.
4.
5.
6.
7.
8.
9.
10.
11.
12.
1.
2.
3.
4.
5.
6.
1.
2.
3.
4.
5.
6.
9 Tunneling Service
Xshell provides TCP/IP and X11 forwarding functions, which creates a secure tunnel between a user's PC and
another computer connected across an unreliable network enviornment providing a way to safely transmit data.
9.1 TCP_IP Port Forwarding
To use port forwarding service via a secure tunnel, define port forwarding rules for each application program.
Note
For local forwarding, connection to alocal PC's listening port is forwarded to a specific destination host port.
For remote forwarding, connection to the remote host listening port is forwarded to a specific destination
host port.
Dynamic forwarding works the same as local forwarding. It automatically determines the host of delivery
destination and port according to the SOCKS protocol. The default port number of SOCKS protocol is 1080.
To Add a New Port Forwarding Rule to a Session:
Open the Sessions dialog box.
Select a session for which to edit port forwarding rule.
Click the standard [Properties] button.
Select [Connection > SSH > Tunneling] from [Category].
Click [Add] to open the Forwarding Rule dialog box.
Select connection type from the [Type] list.
Enter the localhost or IP address in [Source Host].
Enter the port number in [Listening Port] or select a service name.
Enter the name of the host or IP address where the server program operates in [Destination Host].
Enter the port number where server program is waiting in [Destination Port].
Enter a description of the forwarding rule in [Description].
Click [OK].
To Change Forwarding Rule:
Open the Sessions dialog box.
Select session for which to edit port forwarding rule.
Click the standard [Properties] button.
Select [Connection > SSH > Tunneling] from [Category].
Select a forwarding rule to change.
Click [Edit].
To Remove Port Forwarding Rule:
Open the Sessions dialog box.
Select session for which to edit port forwarding rule.
Click the standard [Properties] button.
Select [Connection > SSH > Tunneling] from [Category].
Select a forwarding rule to remove.
Click [Remove].
9.2 X11 Forwarding
X11 forwarding is a special TCP/IP port forwarding case. The X11 protocol is used by a PC X server software, such as
Xmanager, and the connection is established to a user PC from a remote host. It is thus the reverse situation from
other client programs, such as email or telnet. Using X11 forwarding, remote X11 application programs can be used
Version 7 Help – Manual - Xshell
Tunneling Service – 42
1.
2.
3.
4.
5.
6.
7.
1.
2.
3.
1.
2.
3.
1.
2.
3.
4.
5.
6.
7.
8.
in a user's PC via a secure encoding tunnel without complicated port forwarding settings.
To use the X11 forwarding service, you should configure both Xshell and the SSH server.
To Activate X11 Forwarding in Xshell:
Open the Sessions dialog box.
Select a session for which to activate X11 forwarding.
Click the standard [Properties] button.
Select [Connection > SSH > Tunneling] from [Category].
Select [Forward X11 Connections to].
If Xmanager®
is installed in the user's PC, select [Xmanager]. If another PC X server is used, select [X DISPLAY]
and enter an appropriate DISPLAY.
Click [OK].
Note
In Xmanager, Xshell automatically finds the X DISPLAY option. In other PC X server programs, the option
must be set manually. If PC X server uses TCP 6000 port, DISPLAY is set as 'localhost:0.0'.
To Activate X11 Forwarding in an OpenSSH Server:
Open the /etc/ssh/sshd_config file.
Set X11Forwarding option value as follows: X11Forwarding yes
Restart SSH server.
To Activate X11 Forwarding in an ssh.com Server:
Open the /etc/ssh2/sshd2_config file.
Set AllowX11Forwarding option value as follows: AllowX11Forwarding yes
Restart SSH server.
9.3 SOCKS4_5 Dynamic Port Forwarding
Dynamic port forwarding is a method to forward a local network connection to an SSH server, where the
destination host and port are automatically determined by the SOCKS protocol. Using dynamic port forwarding,
Xshell can operate as a SOCKS proxy server.
To Add New Dynamic Port Forwarding Rule to a Session:
Open the Sessions dialog box.
Select a session for which to edit port forwarding rule.
Click the standard [Properties] button.
Select [Connection > SSH > Tunneling] from [Category].
Open the Forwarding Rule dialog box by clicking [Add].
Select Dynamic (SOCKS4/5) from [Type] list.
Enter port number in [Listening Port] or select a service name. The SOCKS proxy server default port is 1080.
Click [OK].
Note
For dynamic port forwarding, the destination host and port do not need to be entered.
9.4 Instant Tunneling
Instant tunneling enables users to add, remove, suspend, and resume a forwarding rule while a session is
connected. The current session tunneling status can be checked in the tunneling pane. To view the tunneling pane,
select [Tunneling Pane] from the [View] menu.
Version 7 Help – Manual - Xshell
Tunneling Service – 43
1.
2.
3.
1.
2.
3.
1.
2.
3.
1.
2.
3.
To Add Port Forwarding Rule in the Tunneling pane:
Click the [Forwarding Rules] tab in the tunneling pane.
Right-click on the list.
Select [Add] from menu. Forwarding Rule dialog box is displayed.
Note
Newly added rules are applied to the current connection. Unless you save the rules, they are deleted when
the connection is closed.
To Remove Port Forwarding Rules from the Tunneling pane:
Click the [Forwarding Rules] tab in the tunneling pane.
Right-click on a rule to remove from the [Forwarding Rules] list.
Select [Remove] from menu.
To Suspend Port Forwarding Rules:
Click the [Forwarding Rules] tab in the tunneling pane.
Right-click on a rule to suspend from the [Forwarding Rules] list.
Select [Suspend] from menu.
To Retry Port Forwarding Rules:
Click the [Forwarding Rules] tab in the tunneling pane.
Right-click on a rule to resume in the [Forwarding Rules] list.
Select [Resume] from menu.
Note
Resume can only be executed for a previously suspended rule.
Version 7 Help – Manual - Xshell
Terminal Window Operations – 44
1.
•
•
•
•
1.
2.
1.
2.
•
•
•
•
•
1.
2.
•
•
1.
•
•
•
•
10 Terminal Window Operations
Xshell provides a succinct and powerful terminal window enabling users to simultaneously use the remote terminal
and local prompt command interface. Terminal window provides a range of convenient functions, such as copy &
paste, find character string, change font and font color, and advanced terminal options.
10.1 Copy and Paste
To Select a Character String:
Do one of the following:
Press the left mouse button at the starting point of an area to select. While pressing the button, move
the mouse to the end of the area to be selected and release the button. The selected character string
is displayed in an inverted color.
Click the left mouse button at the starting point of an area to select. Move mouse to the end of the
area. While pressing Shift key, press the left button once again.
Double-click a word to select. The double-clicked word is selected.
Triple-click a row to select. The entire row is selected.
To Select Character Strings in a Column Unit:
Press Alt key.
Press the left mouse button at the starting point of an area to select. While pressing the button, move to the
end of the area to select and release the button.
To Copy Selected Character Strings to the Windows Clipboard:
Select a character string to copy.
Do one of the following:
Click the [Smart Selection] button and select [Copy].
Select [Copy] from the [Edit] menu.
Click the standard [Copy] button.
Press Ctrl+Insert key.
If [Copy Selected Texts to the Clipboard Automatically] is set in options, the selected text is
automatically copied.
To Copy Selected Character String to Notepad:
Select a character string to copy.
Do one of the following:
Click the [Smart Selection] button and select [To Text Editor].
Point to [To Text Editor] in the [Edit] menu and select [Selected Area].
Note
The scroll buffer and current screen may be copied as well as the selected character strings. A notepad
window is automatically displayed with the copied text. This does not copy character strings to the
clipboard.
To Paste Clipboard Contents to the Terminal Screen:
Do one of the following:
Select [Paste] from the [Edit] menu.
Click the standard [Paste] button.
Press Shift+Insert key.
If Paste the clipboard contents is selected for middle or right mouse button operation, click the
corresponding mouse button.
Version 7 Help – Manual - Xshell
Terminal Window Operations – 45
1.
2.
3.
4.
5.
1.
2.
3.
1.
2.
3.
4.
1.
•
•
1.
2.
3.
To Set Xterm Style Copy and Paste:
Open the Options dialog box.
Click the [Keyboard and Mouse] tab.
Select [Mouse] – [Middle Button] operation as Paste the clipboard contents.
Select [Selection] - [Copy Selected Texts to the Clipboard Automatically].
Click [OK].
Note
When a character string is selected, the xterm program copies it to clipboard. When the middle mouse
button is pressed, it is pasted to the terminal screen.
10.2 Find String
Search scroll buffer using a specific keyword or a regular expression.
To Find with Keyword:
Select [Find] from the [Edit] menu.
Enter a keyword in Find dialog box.
Click [Find Next].
To Find with Regular Expression:
Select [Find] from the [Edit] menu.
Enter a keyword in Find dialog box.
Select [Regular Expression].
Click [Find Next].
Note
For detailed information on regular expression, see 'Regular Expression'.
10.3 Font Change
In the terminal screen, characters must be displayed in rows and columns. In Xshell, only fixed width fonts may be
selected.
To Change Terminal Font and the Font Size:
Do one of the following:
Click the standard [Fonts] button and select a font and the font size.
Select [Appearance] in Session Properties dialog box and select a font and the font size.
To Change Bold Text:
Open the Session Properties dialog box.
Select [Appearance] from [Category].
Select an option from [Bold] field.
Note
As for Bold, either colors or bold font or both may be used.
10.4 Font Color and Background Color Setting
In a color scheme, font colors, background colors and ANSI 16 colors are saved. Xshell enables users to select/
change color schemes anytime while using Xshell. The selected color scheme is applied immediately.
Version 7 Help – Manual - Xshell
Terminal Window Operations – 46
1.
•
•
1.
2.
3.
4.
1.
2.
3.
4.
5.
6.
1.
2.
3.
4.
5.
1.
2.
3.
4.
1.
2.
3.
4.
5.
To Change Terminal Color:
Do one of the following:
Click the standard [Color Schemes] button to display the Select Color Scheme dialog box. Select a
color scheme in the dialog box and click [OK].
Select [Appearance] from [Category] in Session Properties dialog box, select a color scheme from
the [Color Scheme] and click [OK].
Note
Xshell provides several default color schemes. Users may edit the existing color schemes or create new color
schemes.
To Create New Color Scheme:
Open the Select Color Scheme dialog box.
Click [New]. A new color scheme is added to the list.
Select the new color scheme created.
Click [Edit]. Edit Color Scheme dialog box is displayed.
To Edit Color Scheme:
Open the Select Color Scheme dialog box.
Select a color scheme to edit.
Click [Edit]. Edit Color Scheme dialog box is displayed.
Select colors for normal text in [Normal Text].
Select colors for bold text in [Bold Text]. In general, colors lighter than the normal text are used for bold text.
[ANSI Colors] is used to express ANSI color code in terminal. The colors on top are for normal text, such as
black, red, green, yellow, blue, magenta, cyan and white, and the colors on the bottom are for bold text.
To Export Color Scheme:
Open the Select Color Scheme dialog box.
Select a color scheme to export.
Click [Export]. Save dialog box is displayed.
Select a folder and enter the file name to save.
Click [Save].
Note
Exported file is in '.xcs' format and may be used in Xshell only. A number of color schemes may be saved in a
single file. The color scheme names are also saved in the file.
To Import Color Scheme:
Open the Select Color Scheme dialog box.
Click [Import]. Open dialog box is displayed.
Select a color scheme file (.xcs) to import.
Click [Open].
10.5 Cursor Change
To Change Cursor Color:
Open the Session Properties dialog box.
Select [Appearance] from [Category].
Select [Cursor Color] value.
Select [Text Color] value.
Click [OK].
Version 7 Help – Manual - Xshell
Terminal Window Operations – 47
1.
2.
3.
4.
1.
2.
3.
4.
5.
1.
2.
3.
4.
1.
2.
3.
4.
1.
2.
3.
4.
1.
2.
3.
4.
1.
1.
1.
To Change Cursor Blinking:
Open the Session Properties dialog box.
Select [Appearance] from [Category].
Select or deselect [Use blinking cursor].
Click [OK].
To Change Cursor Blinking Speed:
Open the Session Properties dialog box.
Select [Appearance] from [Category].
Check [Use blinking cursor].
Enter cursor blinking speed by millisecond in [Speed].
Click [OK].
10.6 Window Handling
To Minimize to Notification Area:
Open the Options dialog box.
Click the [Advanced] tab.
Check [Send to the notification area when minimized] in [Window] options.
Save changes by clicking [OK].
To Minimize to Notification Area at Startup:
Open the Options dialog box.
Click the [Advanced] tab.
Check [Minimize to the notification area at Xshell startup] in [Window] options.
Save changes by clicking [OK].
To Exit Xshell when All Connections are Closed:
Open the Options dialog box.
Click the [Advanced] tab.
Check [Exit Xshell when all connections are closed] in [Session] options.
Click [OK].
To Exit to Local Shell when Connections are Closed:
Open the Options dialog box.
Click the [Advanced] tab.
Check [Revert to local shell when connection is closed] in [Session] options.
Click [OK].
To Create New Xshell Window:
Select [New Window] from the [Window] menu.
To Move to Another Xshell Window:
Select [Next] or [Previous] from the [Window] menu.
Note
The same functionmay be executed using Alt+Right and Alt+Leftkeys.
To Close All Xshell Windows Simultaneously:
Select [Close All] from the [Window] menu.
To Close All Xshell Windows Except the Current Window:
Version 7 Help – Manual - Xshell
Terminal Window Operations – 48
1.
1.
2.
3.
4.
1.
2.
1.
2.
1.
2.
1.
•
•
•
•
1.
Select [Close All but This] from the [Window] menu.
10.7 Multi-session Handling
'Multi-session' enables users to work and move between sessions using the sessions tab or sessions bar while
maintaining multiple connections in a single Xshell window.
To Open the Multiple Sessions in Single Xshell Window:
Open the Options dialog box.
Click the [Advanced] tab.
Check [Open multiple sessions in a single Xshell window] in [Session] options.
Save changes by clicking [OK].
To Create a New Connection in Sessions Tab:
Click the [+(Add Tab)] button at the far left of the sessions tab.
Select one from sessions list. The selected session is opened in a new tab.
To Create New Connection in Sessions Bar:
Click an icon at the far left of the sessions bar.
Select one from the sessions list. The selected session is opened in a new tab.
Note
To create a new connection, use a session as described in 'Session Management' or try a connectionwithout
a session.
To Connect with a Remote Computer by Entering a Command in Local Shell:
To open a local shell, click the [+(Add Tab)] button of the sessions tab and select [Local Shell] or double-
click a blank in the sessions tab.
In the local command prompt, connect to a remote computer using commands, such as ssh, telnet and sftp.
For details on using command, enter '?'.
Note
For detailed information on local commands, see 'Xshell Local Command'.
To Move Between Sessions at Multi-session Connection:
Do one of the following:
Click a sessions tab.
Click a session button from the sessions bar.
Use Ctrl+Tab, Shift+Tab or Ctrl+Shift+Tab.
Move between sessions using Alt+'session number'.
To Connect with Session in New Xshell Window:
Select [New Terminal] from the [Window] menu or click the standard [New Terminal] button. A new Xshell
window opens and connection is attempted with the same session information as the currently connected
session.
10.8 Quick Command Sets Setting
By designating frequently used character strings as quick commands, Users can avoid repeated keyboard inputs
and use simple mouse clicks to execute the commands. To display quick commands bar, check [Quick Commands]
in the [View] menu.
To Add Quick Command Set:
202254.com香蕉影视,在线观看最新动漫,民调异闻录第二季线上看,民调异闻录第二季免费观看,民调异闻录第二季免费播放,民调异闻录第二季在线观看,民调异闻录第二季在线播放
202254.com香蕉影视,在线观看最新动漫,民调异闻录第二季线上看,民调异闻录第二季免费观看,民调异闻录第二季免费播放,民调异闻录第二季在线观看,民调异闻录第二季在线播放
202254.com香蕉影视,在线观看最新动漫,民调异闻录第二季线上看,民调异闻录第二季免费观看,民调异闻录第二季免费播放,民调异闻录第二季在线观看,民调异闻录第二季在线播放
202254.com香蕉影视,在线观看最新动漫,民调异闻录第二季线上看,民调异闻录第二季免费观看,民调异闻录第二季免费播放,民调异闻录第二季在线观看,民调异闻录第二季在线播放
202254.com香蕉影视,在线观看最新动漫,民调异闻录第二季线上看,民调异闻录第二季免费观看,民调异闻录第二季免费播放,民调异闻录第二季在线观看,民调异闻录第二季在线播放
202254.com香蕉影视,在线观看最新动漫,民调异闻录第二季线上看,民调异闻录第二季免费观看,民调异闻录第二季免费播放,民调异闻录第二季在线观看,民调异闻录第二季在线播放
202254.com香蕉影视,在线观看最新动漫,民调异闻录第二季线上看,民调异闻录第二季免费观看,民调异闻录第二季免费播放,民调异闻录第二季在线观看,民调异闻录第二季在线播放
202254.com香蕉影视,在线观看最新动漫,民调异闻录第二季线上看,民调异闻录第二季免费观看,民调异闻录第二季免费播放,民调异闻录第二季在线观看,民调异闻录第二季在线播放
202254.com香蕉影视,在线观看最新动漫,民调异闻录第二季线上看,民调异闻录第二季免费观看,民调异闻录第二季免费播放,民调异闻录第二季在线观看,民调异闻录第二季在线播放
202254.com香蕉影视,在线观看最新动漫,民调异闻录第二季线上看,民调异闻录第二季免费观看,民调异闻录第二季免费播放,民调异闻录第二季在线观看,民调异闻录第二季在线播放
202254.com香蕉影视,在线观看最新动漫,民调异闻录第二季线上看,民调异闻录第二季免费观看,民调异闻录第二季免费播放,民调异闻录第二季在线观看,民调异闻录第二季在线播放
202254.com香蕉影视,在线观看最新动漫,民调异闻录第二季线上看,民调异闻录第二季免费观看,民调异闻录第二季免费播放,民调异闻录第二季在线观看,民调异闻录第二季在线播放
202254.com香蕉影视,在线观看最新动漫,民调异闻录第二季线上看,民调异闻录第二季免费观看,民调异闻录第二季免费播放,民调异闻录第二季在线观看,民调异闻录第二季在线播放
202254.com香蕉影视,在线观看最新动漫,民调异闻录第二季线上看,民调异闻录第二季免费观看,民调异闻录第二季免费播放,民调异闻录第二季在线观看,民调异闻录第二季在线播放
202254.com香蕉影视,在线观看最新动漫,民调异闻录第二季线上看,民调异闻录第二季免费观看,民调异闻录第二季免费播放,民调异闻录第二季在线观看,民调异闻录第二季在线播放
202254.com香蕉影视,在线观看最新动漫,民调异闻录第二季线上看,民调异闻录第二季免费观看,民调异闻录第二季免费播放,民调异闻录第二季在线观看,民调异闻录第二季在线播放
202254.com香蕉影视,在线观看最新动漫,民调异闻录第二季线上看,民调异闻录第二季免费观看,民调异闻录第二季免费播放,民调异闻录第二季在线观看,民调异闻录第二季在线播放
202254.com香蕉影视,在线观看最新动漫,民调异闻录第二季线上看,民调异闻录第二季免费观看,民调异闻录第二季免费播放,民调异闻录第二季在线观看,民调异闻录第二季在线播放
202254.com香蕉影视,在线观看最新动漫,民调异闻录第二季线上看,民调异闻录第二季免费观看,民调异闻录第二季免费播放,民调异闻录第二季在线观看,民调异闻录第二季在线播放
202254.com香蕉影视,在线观看最新动漫,民调异闻录第二季线上看,民调异闻录第二季免费观看,民调异闻录第二季免费播放,民调异闻录第二季在线观看,民调异闻录第二季在线播放
202254.com香蕉影视,在线观看最新动漫,民调异闻录第二季线上看,民调异闻录第二季免费观看,民调异闻录第二季免费播放,民调异闻录第二季在线观看,民调异闻录第二季在线播放
202254.com香蕉影视,在线观看最新动漫,民调异闻录第二季线上看,民调异闻录第二季免费观看,民调异闻录第二季免费播放,民调异闻录第二季在线观看,民调异闻录第二季在线播放
202254.com香蕉影视,在线观看最新动漫,民调异闻录第二季线上看,民调异闻录第二季免费观看,民调异闻录第二季免费播放,民调异闻录第二季在线观看,民调异闻录第二季在线播放
202254.com香蕉影视,在线观看最新动漫,民调异闻录第二季线上看,民调异闻录第二季免费观看,民调异闻录第二季免费播放,民调异闻录第二季在线观看,民调异闻录第二季在线播放
202254.com香蕉影视,在线观看最新动漫,民调异闻录第二季线上看,民调异闻录第二季免费观看,民调异闻录第二季免费播放,民调异闻录第二季在线观看,民调异闻录第二季在线播放
202254.com香蕉影视,在线观看最新动漫,民调异闻录第二季线上看,民调异闻录第二季免费观看,民调异闻录第二季免费播放,民调异闻录第二季在线观看,民调异闻录第二季在线播放
202254.com香蕉影视,在线观看最新动漫,民调异闻录第二季线上看,民调异闻录第二季免费观看,民调异闻录第二季免费播放,民调异闻录第二季在线观看,民调异闻录第二季在线播放
202254.com香蕉影视,在线观看最新动漫,民调异闻录第二季线上看,民调异闻录第二季免费观看,民调异闻录第二季免费播放,民调异闻录第二季在线观看,民调异闻录第二季在线播放
202254.com香蕉影视,在线观看最新动漫,民调异闻录第二季线上看,民调异闻录第二季免费观看,民调异闻录第二季免费播放,民调异闻录第二季在线观看,民调异闻录第二季在线播放
202254.com香蕉影视,在线观看最新动漫,民调异闻录第二季线上看,民调异闻录第二季免费观看,民调异闻录第二季免费播放,民调异闻录第二季在线观看,民调异闻录第二季在线播放
202254.com香蕉影视,在线观看最新动漫,民调异闻录第二季线上看,民调异闻录第二季免费观看,民调异闻录第二季免费播放,民调异闻录第二季在线观看,民调异闻录第二季在线播放
202254.com香蕉影视,在线观看最新动漫,民调异闻录第二季线上看,民调异闻录第二季免费观看,民调异闻录第二季免费播放,民调异闻录第二季在线观看,民调异闻录第二季在线播放
202254.com香蕉影视,在线观看最新动漫,民调异闻录第二季线上看,民调异闻录第二季免费观看,民调异闻录第二季免费播放,民调异闻录第二季在线观看,民调异闻录第二季在线播放
202254.com香蕉影视,在线观看最新动漫,民调异闻录第二季线上看,民调异闻录第二季免费观看,民调异闻录第二季免费播放,民调异闻录第二季在线观看,民调异闻录第二季在线播放
202254.com香蕉影视,在线观看最新动漫,民调异闻录第二季线上看,民调异闻录第二季免费观看,民调异闻录第二季免费播放,民调异闻录第二季在线观看,民调异闻录第二季在线播放
202254.com香蕉影视,在线观看最新动漫,民调异闻录第二季线上看,民调异闻录第二季免费观看,民调异闻录第二季免费播放,民调异闻录第二季在线观看,民调异闻录第二季在线播放
202254.com香蕉影视,在线观看最新动漫,民调异闻录第二季线上看,民调异闻录第二季免费观看,民调异闻录第二季免费播放,民调异闻录第二季在线观看,民调异闻录第二季在线播放
202254.com香蕉影视,在线观看最新动漫,民调异闻录第二季线上看,民调异闻录第二季免费观看,民调异闻录第二季免费播放,民调异闻录第二季在线观看,民调异闻录第二季在线播放
202254.com香蕉影视,在线观看最新动漫,民调异闻录第二季线上看,民调异闻录第二季免费观看,民调异闻录第二季免费播放,民调异闻录第二季在线观看,民调���闻录第二季在线播放

More Related Content

202254.com香蕉影视,在线观看最新动漫,民调异闻录第二季线上看,民调异闻录第二季免费观看,民调异闻录第二季免费播放,民调异闻录第二季在线观看,民调异闻录第二季在线播放

  • 1. Manual - Xshell Version 7 Help Exported on 10/23/2020
  • 2. Version 7 Help – Manual - Xshell – 2 Table of Contents 1 Xshell Manual .......................................................................................................7 2 Content.................................................................................................................8 2.1 About Xshell...............................................................................................................................8 2.2 Start ...........................................................................................................................................8 2.3 Session Management................................................................................................................8 2.4 Connection................................................................................................................................9 2.5 Security......................................................................................................................................9 2.6 Tab Management ......................................................................................................................9 2.7 Tunneling Service......................................................................................................................9 2.8 Terminal Window Operations ..................................................................................................9 2.9 Options Setting .......................................................................................................................10 2.10 File Transfer.............................................................................................................................10 2.11 Session Logging and Tracing..................................................................................................10 2.12 Printing....................................................................................................................................10 2.13 Using Xagent............................................................................................................................10 2.14 Using Scripts............................................................................................................................10 2.15 References...............................................................................................................................11 3 About Xshell........................................................................................................12 3.1 Key Functions..........................................................................................................................12 3.2 Minimum System Requirements............................................................................................14 3.3 Install and Uninstall................................................................................................................14 4 Start ....................................................................................................................15 4.1 Create Session.........................................................................................................................15 4.2 Connect to Remote Host.........................................................................................................16 4.3 Exit Xshell ................................................................................................................................17 5 Session Management.........................................................................................18 5.1 Session Management..............................................................................................................18 5.2 Session Properties ..................................................................................................................19
  • 3. Version 7 Help – Manual - Xshell – 3 5.2.1 Connection............................................................................................................................................................ 19 5.2.2 Connection _ Authentication ............................................................................................................................... 20 5.2.3 Connection _ Authentication _ Login Prompts ................................................................................................... 20 5.2.4 Connection _ Login Scripts................................................................................................................................... 21 5.2.5 Connection _ SSH.................................................................................................................................................. 21 5.2.6 Connection _ SSH _ Security ................................................................................................................................ 22 5.2.7 Connection _ SSH _ Tunneling............................................................................................................................. 22 5.2.8 Connection _ SSH _ SFTP ..................................................................................................................................... 22 5.2.9 Connection _ TELNET ........................................................................................................................................... 22 5.2.10 Connection _ RLOGIN ........................................................................................................................................... 22 5.2.11 Connection _ SERIAL............................................................................................................................................. 23 5.2.12 Connection _ PROXY ............................................................................................................................................. 23 5.2.13 Connection _ Keep Alive....................................................................................................................................... 23 5.2.14 Terminal ................................................................................................................................................................ 23 5.2.15 Terminal _ Keyboard............................................................................................................................................. 24 5.2.16 Terminal _ VT Mode .............................................................................................................................................. 24 5.2.17 Terminal _ Advanced ............................................................................................................................................ 25 5.2.18 Appearance ........................................................................................................................................................... 26 5.2.19 Appearance _ Window .......................................................................................................................................... 26 5.2.20 Appearance _ Highlight ........................................................................................................................................ 27 5.2.21 Advanced............................................................................................................................................................... 27 5.2.22 Advanced _ Trace.................................................................................................................................................. 27 5.2.23 Advanced _ Bell..................................................................................................................................................... 28 5.2.24 Advanced _ Logging.............................................................................................................................................. 28 5.2.25 File Transfer........................................................................................................................................................... 29 5.2.26 File Transfer _ X_YMODEM.................................................................................................................................... 29 5.2.27 File Transfer _ ZMODEM........................................................................................................................................ 29 5.3 Export ......................................................................................................................................30 5.4 Import......................................................................................................................................30 6 Connection.........................................................................................................31 6.1 Connections without Session Files ........................................................................................31 6.2 Connections with Session Files..............................................................................................31 6.3 Sessions to Run on Xshell Startup..........................................................................................32 6.4 SERIAL Connection..................................................................................................................32
  • 4. Version 7 Help – Manual - Xshell – 4 6.5 Connection with Kerberos......................................................................................................32 6.6 Connection with PKCS _11 .....................................................................................................33 6.7 Proxy Setting ...........................................................................................................................33 6.8 Jump host................................................................................................................................33 7 Security...............................................................................................................35 7.1 Public Key User Authentication0............................................................................................35 7.1.1 User Keys Dialog Box............................................................................................................................................. 36 7.2 Host Key Management............................................................................................................36 7.2.1 SSH Security Warning Dialog Box......................................................................................................................... 36 7.2.2 Host Keys Dialog Box ............................................................................................................................................ 37 7.3 Master Password.....................................................................................................................37 8 Tab Management ...............................................................................................39 8.1 Tab...........................................................................................................................................39 8.2 Tab Group................................................................................................................................39 8.3 Split and Merge Tabs ..............................................................................................................40 8.4 Arrange Tabs ...........................................................................................................................40 9 Tunneling Service...............................................................................................41 9.1 TCP_IP Port Forwarding .........................................................................................................41 9.2 X11 Forwarding .......................................................................................................................41 9.3 SOCKS4_5 Dynamic Port Forwarding ....................................................................................42 9.4 Instant Tunneling....................................................................................................................42 10 Terminal Window Operations ...........................................................................44 10.1 Copy and Paste........................................................................................................................44 10.2 Find String ...............................................................................................................................45 10.3 Font Change ............................................................................................................................45 10.4 Font Color and Background Color Setting.............................................................................45 10.5 Cursor Change.........................................................................................................................46 10.6 Window Handling....................................................................................................................47 10.7 Multi-session Handling ...........................................................................................................48 10.8 Quick Command Sets Setting.................................................................................................48 10.9 Terminal Output Encoding Change........................................................................................50
  • 5. Version 7 Help – Manual - Xshell – 5 10.10 Advanced Terminal Options Setting......................................................................................50 10.11 Layout Management...............................................................................................................51 10.12 Highlight Sets Settings............................................................................................................51 11 Options Setting ..................................................................................................53 11.1 Session Folder and Startup Session.......................................................................................53 11.2 History Clearing and Connection Log ....................................................................................53 11.3 Key Mapping Setting...............................................................................................................53 11.4 Mouse Setting..........................................................................................................................54 11.5 Transparency Setting..............................................................................................................54 11.6 Master Password Settings ......................................................................................................54 11.7 Screen Lock Settings...............................................................................................................54 11.7.1 Auto Lock............................................................................................................................................................... 55 11.8 Live Update Settings...............................................................................................................55 11.9 Advanced Settings ..................................................................................................................56 12 File Transfer........................................................................................................58 12.1 File Transfer Using SFTP.........................................................................................................58 12.2 File Transfer Using FTP ...........................................................................................................58 12.3 File Transfer Using X_Y_ZMODEM ..........................................................................................58 12.4 File Transfer Using Xftp...........................................................................................................60 13 Session Logging and Tracing.............................................................................61 13.1 Session Logging ......................................................................................................................61 13.2 Session Tracing .......................................................................................................................61 14 Printing...............................................................................................................62 15 Using Xagent.......................................................................................................63 15.1 Connecting to a Server Through Xagent................................................................................63 15.2 Using the Xagent User Key on a Remote Host .......................................................................63 16 Using Scripts.......................................................................................................65 16.1 Script Starting and Ending .....................................................................................................65 16.2 Script API .................................................................................................................................65 16.2.1 xsh.Session............................................................................................................................................................ 65 16.2.2 xsh.Screen ............................................................................................................................................................. 66
  • 6. Version 7 Help – Manual - Xshell – 6 16.2.3 xsh.Dialog .............................................................................................................................................................. 68 16.2.4 Script Example ...................................................................................................................................................... 68 16.3 Script Recording......................................................................................................................70 16.4 Multi-Session Script ................................................................................................................70 17 References..........................................................................................................71 17.1 Standard Buttons....................................................................................................................71 17.2 Address Bar..............................................................................................................................73 17.3 Xshell Local Command ...........................................................................................................74 17.4 Xshell Command Line Option.................................................................................................78 17.5 SFTP Command.......................................................................................................................80 17.6 Regular Expression..................................................................................................................81 17.6.1 Pattern Match........................................................................................................................................................ 81 17.6.2 The shorthand of character classes ..................................................................................................................... 82 17.6.3 POSIX character classes........................................................................................................................................ 83 17.6.4 Example................................................................................................................................................................. 84 17.7 Pre-defined Shortcut Key .......................................................................................................84
  • 7. Version 7 Help – Manual - Xshell Xshell Manual – 7 1 Xshell Manual The manual describe how to use the program's interface and will guide you through the basics.
  • 8. Version 7 Help – Manual - Xshell Content – 8 • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • 2 Content 2.1 About Xshell Key Functions(see page 12) Minimum System Requirements(see page 14) Install and Uninstall(see page 14) 2.2 Start Create Session(see page 15) Connect to Remote Host(see page 16) Exit Xshell(see page 17) 2.3 Session Management Session Management(see page 18) Session Properties(see page 19) Connection(see page 19) Connection _ Authentication(see page 20) Connection _ Authentication _ Login Prompts(see page 20) Connection _ Login Scripts(see page 21) Connection _ SSH(see page 21) Connection _ SSH _ Security(see page 22) Connection _ SSH _ Tunneling(see page 22) Connection _ SSH _ SFTP(see page 22) Connection _ TELNET(see page 22) Connection _ RLOGIN(see page 22) Connection _ SERIAL(see page 23) Connection _ PROXY(see page 23) Connection _ Keep Alive(see page 23) Terminal(see page 23) Terminal _ Keyboard(see page 24) Terminal _ VT Mode(see page 24) Terminal _ Advanced(see page 25) Appearance(see page 26) Appearance _ Window(see page 26) Appearance _ Highlight(see page 27) Advanced(see page 27) Advanced _ Trace(see page 27) Advanced _ Bell(see page 28) Advanced _ Logging(see page 28) File Transfer(see page 29) File Transfer _ X_YMODEM(see page 29) File Transfer _ ZMODEM(see page 29) Export(see page 30) Import(see page 30)
  • 9. Version 7 Help – Manual - Xshell Content – 9 • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • 2.4 Connection Connections without Session Files(see page 31) Connections with Session Files(see page 31) Sessions to Run on Xshell Startup(see page 32) SERIAL Connection(see page 32) Connection with Kerberos(see page 32) Connection with PKCS _11(see page 33) Proxy Setting(see page 33) Jump host(see page 33) 2.5 Security Public Key User Authentication0(see page 35) User Keys Dialog Box(see page 36) Host Key Management(see page 36) SSH Security Warning Dialog Box(see page 36) Host Keys Dialog Box(see page 37) Master Password(see page 37) 2.6 Tab Management Tab(see page 39) Tab Group(see page 39) Split and Merge Tabs(see page 40) Arrange Tabs(see page 40) 2.7 Tunneling Service TCP_IP Port Forwarding(see page 41) X11 Forwarding(see page 41) SOCKS4_5 Dynamic Port Forwarding(see page 42) Instant Tunneling(see page 42) 2.8 Terminal Window Operations Copy and Paste(see page 44) Find String(see page 45) Font Change(see page 45) Font Color and Background Color Setting(see page 45) Cursor Change(see page 46) Window Handling(see page 47) Multi-session Handling(see page 48) Quick Command Sets Setting(see page 48) Terminal Output Encoding Change(see page 50) Advanced Terminal Options Setting(see page 50) Layout Management(see page 51)
  • 10. Version 7 Help – Manual - Xshell Content – 10 • • • • • • • • • • • • • • • • • • • • • • • • • • • Highlight Sets Settings(see page 51) 2.9 Options Setting Session Folder and Startup Session(see page 53) History Clearing and Connection Log(see page 53) Key Mapping Setting(see page 53) Mouse Setting(see page 54) Transparency Setting(see page 54) Master Password Settings(see page 54) Screen Lock Settings(see page 54) Auto Lock(see page 55) Live Update Settings(see page 55) Advanced Settings(see page 56) 2.10 File Transfer File Transfer Using SFTP(see page 58) File Transfer Using FTP(see page 58) File Transfer Using X_Y_ZMODEM(see page 58) File Transfer Using Xftp(see page 60) 2.11 Session Logging and Tracing Session Logging(see page 61) Session Tracing(see page 61) 2.12 Printing 2.13 Using Xagent Connecting to a Server Through Xagent(see page 63) Using the Xagent User Key on a Remote Host(see page 63) 2.14 Using Scripts Script Starting and Ending(see page 65) Script API(see page 65) xsh.Session(see page 65) xsh.Screen(see page 66) xsh.Dialog(see page 68) Script Example(see page 68) Script Recording(see page 70) Multi-Session Script(see page 70)
  • 11. Version 7 Help – Manual - Xshell Content – 11 • • • • • • • • • • • 2.15 References Standard Buttons(see page 71) Address Bar(see page 73) Xshell Local Command(see page 74) Xshell Command Line Option(see page 78) SFTP Command(see page 80) Regular Expression(see page 81) Pattern Match(see page 81) The shorthand of character classes(see page 82) POSIX character classes(see page 83) Example(see page 84) Pre-defined Shortcut Key(see page 84)
  • 12. 1 http://ssh.com Version 7 Help – Manual - Xshell About Xshell – 12 • • • • • • • • • • • • • • • • • • • • • • • 3 About Xshell Xshell is a powerful SSH, TELNET and RLOGIN terminal emulator software operating on the Windows platform. Windows users can conveniently and securely access UNIX/Linux hosts using Xshell. SSH (secure shell) protocols support encryption and user authentication for secure connections on the Internet and can replace legacy protocols, such as TELNET and RLOGIN. 3.1 Key Functions This section provides descriptions on key functions of Xshell. General Supports SSH1, SSH2, SFTP, TELNET, RLOGIN and SERIAL protocols Supports Windows 7/8/10, Server 2008/2012/2016 Supports OpenSSH and ssh.com1 servers Supports having multi tabs in a single window Supports displaying multiple tab groups in a single window Multi-user setting Keep alive option SOCKS4/5, HTTP proxy connection Custom key mapping VB, Perl, Jscript scripting IPv6 support Kerberos(MIT Keberos, Microsoft SSPI) authentication support SSH/Telnet 추적 Session Management The Session Manager provides a convenient way to manage and run multiple sessions Create and manage session files for both local and remote hosts Supports Sessions dialog box, address bar, local prompt, shortcut to session, and links bar to open sessions Provides a default session for quick connection Simultaneous connection with multiple sessions Address bar supports URL commands and allows connection to a remote host with or without a saved session Supports automatic login and login scripts Supports folder and tree view in the Sessions dialog box Batch update sessions Import and export sessions Security
  • 13. Version 7 Help – Manual - Xshell About Xshell – 13 • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • RSA/DSA/ECDSA/ED25519 Public key, Password and Keyboard interactive user authentication RSA/DSA/ECDSA/ED25519 New Key Wizard and import/export key SSH PKCS#11 Support User authentication using Xagent (SSH user authentication agent) AES128/192/256, 3DES, BLOWFISH, CAST128, ARCFOUR and RIJNDAEL encryption algorithms SHA1, SHA1-96, MD5, MD5-96 and RIPEMD160 MAC algorithms zlib compression Host Keys dialog box User Keys dialog box Supports using master password to encrypt password Terminal Unicode-based terminal buffer VT100, VT220, VT320, XTERM, LINUX, SCOANSI and ANSI terminals Fixed terminal size option for standardized output Horizontal scroll bar while in fixed terminal size Multi-language output encoding (UTF-8) Compose Bar for sending strings to multiple sessions Compose Pane for sending multiple lines of strings to multiple sessions Scroll buffer enabling up to 2,147,483,647 lines to be saved Character string search using regular expressions Column unit text selection Supports multi-byte character strings at copy & paste Designates delimiters of double-click word selection in the terminal window Triple click selects one line Bold font and ANSI color code Xterm terminal mouse Xterm 256-color mode Linux Meta key emulation Prints terminal screen Set line spacing and margins in the terminal window Search a user specified web browser for selected text Various bell options Tunneling TCP/IP and X11 forwarding Dynamic port forwarding using SOCKS4/5 Tunneling pane for observing and managing active forwarding channels Instand tunneling to add/remove or modify tunneling to the current connected session Appearance Dockable UI for the main window Theme selection feature Convenient and powerful user interface Supports custom layout Color schemes edit/import/export feature Change cursor color and blinking Easily changeable fonts via the Font button Apply separate fonts for ASCII and non ASCII characters Designate frequently used character strings as quick commands: Quick Commands Bar, Quick Commands Pane Customizable Standard Buttons on toolbar Security–lock, session selection, and network up/down traffic information display in the status bar
  • 14. Version 7 Help – Manual - Xshell About Xshell – 14 • • • • • • • • • • • • • • • • • • • • • • • • Full screen view (Alt+Enter) Transparency options Local Command Local shell prompt for advanced users Local commands, including open, ssh, telnet, rlogin, sftp, and ftp Local Windows commands, such as ping, ipconfig, netstat, and nslookup Escape to the local prompt during connection Interoperability Interoperable with Xmanager program for X11 forwarding Interoperable with Xagent program for agent authentication and forwarding Interoperable with Xftp program for file transfers Edits scroll buffer in notepad Sequentially selects Xshell window via the menu command String Transfer and File Management Send and receives files via FTP/SFTP Send and receives files via X/Y/Z MODEM Send ASCII files Send Delay for preventing data loss Auto save and support for various logging formats during session logging Page setting and print preview 3.2 Minimum System Requirements Processor: Intel® compatible Operating System:Microsoft Windows® 7 or higher Storage Space: 50MB of available space Memory: 512 MB Network: TCP/IP network 3.3 Install and Uninstall The Xshell installation program was created using InstallShield® . A variety of installation options can be changed during installation. However, it is often sufficient to simply click [Next]. To uninstall Xshell, use the standard Windows add/remove functions. Run [Add/Remove Program] in the control panel and select to uninstall Xshell from the list. Even when the program is uninstalled, the registry information, log files and data files created by the user are not removed. The information and files are available for reuse when the program is reinstalled. If you want to remove all the files and registry information completely, remove the following explicitly: Registry Information: HKEY_CURRENT_USERSoftwareNetSarangXshell File and Folder: "User's Docuements Folder"Netsarang Computer7Xshell
  • 15. Version 7 Help – Manual - Xshell Start – 15 1. 2. 3. 4. 5. 6. 4 Start This section provides descriptions of the methods to create a TELNET/RLOGIN or SSH session and to connect to UNIX/Linux hosts. TELNET sessions are very simple. However, an SSH session occasionally requires a user key registration in the server prior to connection. If you need user key registration for SSH sessions, see 'Public Key User Authentication'. 4.1 Create Session Select [New] from the [File] menu. New Session Properties dialog box is displayed. Fig. 1: New Session Properties dialog box Enter a session name in [Name]. Select an appropriate protocol from the [Protocol] list. Enter server host name or IP address in [Host]. Enter port number used by the remote server in [Port Number]. Click [OK].
  • 16. Version 7 Help – Manual - Xshell Start – 16 1. 2. 3. 4. 5. 4.2 Connect to Remote Host The following is the process for connecting to a remote host via an SSH session. If a session is not available, see 'Create Session'. Select [Open] from the [File] menu. Sessions dialog box is displayed. Select session for connection from the sessions list and click [Connect]. SSH User Name dialog box is displayed. Fig. 2: SSH User Name dialog box Enter user name and click [OK]. SSH User Authentication dialog box is displayed. Fig. 3: SSH User Authentication dialog box To attempt Password authentication, enter password in [Password] and click [OK]. To attempt Public Key authentication, first select a user key from the list. Enter [Passphrase] of the selected user key and click [OK].
  • 17. Version 7 Help – Manual - Xshell Start – 17 6. Note If a user key is not available, see 'Public Key User Authentication'. To attempt Keyboard Interactive authentication, click [OK] and answer the questions given during connection process. 4.3 Exit Xshell To disconnect with a session, enter 'exit' in the terminal screen prompt or select [Disconnect] from the [File] menu. Note If a session is disconnected withthe [Revert to local shell when connection is closed] option selected, the session tab remains open and reverts back to local shell. Under local shell status, the current session file's path prompt is displayed in the terminal screen and local commands, such as open, telnet, ssh, and ping can be executed. To end Xshell, select [Exit] from the [File] menu.
  • 18. Version 7 Help – Manual - Xshell Session Management – 18 1. 2. 3. • • 1. 2. 3. 4. 1. 2. 3. 1. 2. 3. 1. 2. 3. 1. 2. 3. 4. 5 Session Management Session is a file containing information about remote host connection setup. By creating a session, users can set different options for different remote hosts. The Sessions dialog box shows all sessions created and enables to create and edit sessions. Users can connect to a remote computer without creating a session. For this purpose, Xshell provides a default session which is ready to use after installation. 5.1 Session Management To Create a New Session: Open the New Session Properties dialog box by selecting [New] in the [File] menu. Enter connection information. Click [OK]. To Open the Sessions Dialog Box: Select [Open] in the [File] menu. Click the standard [Open] button. To Edit a Session: Open the Sessions dialog box. Select a session to edit. Click the standard [Properties] button. Click [OK] after completing session editing. Note You can edit multiple sessions simultaneously simply by selecting all the sessions you want to edit and clicking [Properties]. To Rename a Session: Open the Sessions dialog box. Right-click on the session to rename. Select [Rename] in menu. Note Session name must be a valid file name. To Copy a Session Under Different Name: Open the Sessions dialog box. Select a session to copy under a different name. Click the standard [Save As] button. To Delete a Session: Open the Sessions dialog box. Select the session to delete. Click the standard [Delete] button. To Create a Shortcut to Session: Open the Sessions dialog box. Select a session for which to create shortcut. Click the standard [Create Shortcut] button. Select a folder to save shortcut.
  • 19. Version 7 Help – Manual - Xshell Session Management – 19 5. • • 1. 2. 3. 1. 2. 3. 4. 5. • • • Click [OK]. To Change Default Session Properties: To open the default Session Properties dialog box, select one of the following: Select [Properties] from the [File] menu in local shell. Click the arrow next to the standard [Properties] button in the main toolbar and select [Default Session] from the list. Note Default session is used when connecting withSSH, TELNET, RLOGIN and SFTP using a local prompt or the Address Bar. To use a connection command in the local prompt, see 'Xshell Local Command'. For connections using the address bar, see 'Address Bar'. To Create a New Session Folder: Open the Sessions dialog box. Click an arrow next to the standard [New] button and select [Folder] from the list. Enter folder name. To Copy a Session file to Another Computer: Select [Export] from the [File] Menu. If you would like to use the session file's password on another device, set the Master Password. Copy a session file (*.xsh) or email it to another computer. On the device to use the session file, set the exact same Master Password. Select [Import] from the [File] Menu. 5.2 Session Properties Open the Session Properties dialog box to create a new session or to edit a session. To Open the Session Properties Dialog Box: Select [New] from the [File] menu. Select [Properties] from the [File] menu. Click the standard [Properties] button. 5.2.1 Connection In the connection settings, information about session connections may be set. In most cases, users can connect to a remote host with the connection settings only. Name Enter an intrinsic name for the session. The name becomes the session file name, and must be comprised of a valid characters for a file name. Protocol Select a connection protocol to use when connecting to a remote computer. The protocols supported are SSH, SFTP, TELNET, RLOGIN, SERIAL, and LOCAL. Host Enter host name or IP address of the remote computer. Port Number Enter the port number of the protocol selected above. When a protocol is selected from the protocols list, the default protocol port number is automatically entered. If a remote computer is using another port number, the port number must be directly entered. Default port numbers for each protocol are 22 for SSH/SFTP, 23 for TELNET, and 513 for RLOGIN. SERIAL and LOCAL sessions do not require a port number.
  • 20. Version 7 Help – Manual - Xshell Session Management – 20 Description Add a short description about the session. This information will be displayed on the session tab after running the session. Reconnect This setting is used to restart the session if the connection is lost. Set the number of seconds desired between reconnection attempts. If a connection is not established during the user specified duration of minutes, the connection will cease. If the specified time is set to 0, a connection will be attempted. Use Nagle's algorithm If this option is selected, transfer efficiency may be slightly higher at the expense of a slower key response rate. 5.2.2 Connection _ Authentication In the user authentication settings, the authentication method, user name, password, user key, etc. may be designated Method Select an authentication method among Password, Public Key, Keyboard Interactive, GSSAPI and PKCS11. If the selected authentication method is not supported by the SSH server, a dialog box asking about the user authentication method is displayed during connection. Note If the PC running Xshell is utilizing an Xshell supported Kerberos module, Xshell can only automatically authenticate to the SSH server if GSSAPI authentication is selected. User Name Enter a user name for login. User name is the remote computer login account. If this field is left blank, a dialog box asking for the user name is displayed during connection. Password Enter a remote user account password. This value is valid when Password authentication is selected. If this field is left blank, a dialog box asking for the user authentication is displayed during connection. The password is encoded and saved in the user's PC. For greater security, leave this field blank. User Key Select a user key to use when Public Key authentication is selected. If this field is left blank, a dialog box asking about the user authentication is displayed during connection. If a user key is not in the list, a key must be created and registered in the remote SSH server. Passphrase Enter the passphrase for the selected user key. The entered key passphrase is encoded and saved in the user's PC. For greater security, leave this field blank. 5.2.3 Connection _ Authentication _ Login Prompts It is necessary for Xshell to recognize the server user name/password prompt in order to automate the login process for the TELNET or RLOGIN protocol. In general, the default value is used. TELNET Enter the user name and password prompt to automate TELNET login process. Note that blanks are recognized as valid characters. RLOGIN Enter the password prompt for RLOGIN protocol. A password may not be needed depending on the RLOGIN server settings. Note that blanks are recognized as valid characters.
  • 21. Version 7 Help – Manual - Xshell Session Management – 21 5.2.4 Connection _ Login Scripts For the login script settings, commands to be automatically entered in the terminal may be defined. After a successful login to a remote server, commands are sequentially executed in the order displayed in the list. This feature is very useful when you login to another server after the first login to a remote server. Execute the Following Expect and Send Rule Select this option to use expect and send rule. Add Open the Expect and Send Rule dialog box. When rules editing is complete, the rule is added to the list. Edit Open the Expect and Send Rule dialog box and edit the selected rule. Remove Delete the Expect and Send Rule. Move up Move the Expect and Send Rule up. Move Down Move the Expect and Send Rule down Execute script when session starts. Set a script file to execute after a session connection. 5.2.5 Connection _ SSH Set general SSH protocol options. Remote Command Specify the remote command to run after connection.* Protocol Version Priority Select which SSH version to prioritize. SSH2 is safer than SSH1 and offers more capabilities. Use Xagent (SSH Agent) for authentication Private keys for the public key authentication are provided by Xagent.* Using Xagent, entering a passphrase is not required during the public key user authentication process. Allow agent forwarding Xagent allow the remote servers which are already connected with the SSH protocol to use its private keys. It can be used when connecting to another remote server or using a remote service through public key authentication from a remote server.* Use ZLIB Compression A compression algorithm is used to compress all SSH connection data. In an environment where network speed is slow, use this option to improve the speed. Do Not Allocate a Terminal Select this option when not using terminal. If this option is turned on, a terminal(tty) for input/output is not assigned and thus input/output on the screen is not possible. Use this option if you want to use tunneling only without terminal access. Accept and save host key automatically upon first connection If the option is turned on when connecting to a server where the host key is not registered, the host key is automatically saved without going through the authentication process.
  • 22. Version 7 Help – Manual - Xshell Session Management – 22 5.2.6 Connection _ SSH _ Security Encryption Encryption algorithms are used to encrypt and decrypt network traffics. Users may select a preferred encryption algorithm from the list. If <Cipher List> is selected from the list, multiple algorithms may be attempted in the order appearing in the list. To edit the list of <Cipher List>, click [Edit]. MAC (Message Authentication Code) MAC is added in SSH2 for greater security and to ensure data integrity. If <MAC List> is selected from the list, multiple algorithms are tried in the order appearing in the list. To edit the list of <MAC List>, click [Edit]. Key exchange Users can select the intial Key Exchange for the SSH connection. The desired algorithm can be selected from the list. If the server does not support the selected algorithm, the connection will fail. 5.2.7 Connection _ SSH _ Tunneling In the tunneling setting, TCP/IP, Dynamic and X11 forwarding rules may be set. These settings are valid only when the SSH protocol is selected in Connection setting. For details on tunneling setting, see 'Tunneling Service'. 5.2.8 Connection _ SSH _ SFTP Set SFTP protocol related options. Startup Folder Set a local and remote folder with which to start after a successful login via SFTP protocol. 5.2.9 Connection _ TELNET Set TELNET protocol related options. Use XDISPLOC Telnet Option Uses XDISPLOC Telnet option to pass display (PC X server) information to server. If you are using a PC X server such as Xmanager, use this option to execute remote X11 applications from a local PC. Display Enter the DISPLAY value to pass upon login. $PCADDR value is translated automatically to IP address of a local PC right before it is passed to server. The DISPLAY number must match the DISPLAY number of the X server currently running on the PC. Option Negotiation This option determines who initiates the attempt to negotiate additional TELNET options. When set to Active, after a connection has started, Xshell intiates the negotation. Passive waits for the server to intiate the negotiation. The values may have to be different depending on the server or firewall settings. If both the server and Xshell are set to Passive, the negotiation will not proceed. Conversely, if Active is selected and the firewall is enabled on the server, the negotiation may fail. 5.2.10 Connection _ RLOGIN Set RLOGIN protocol related options.
  • 23. Version 7 Help – Manual - Xshell Session Management – 23 Terminal Speed Designate terminal speed to be passed to rlogin server. 5.2.11 Connection _ SERIAL In serial setting, serial connection options may be set. Instead of using the traditional terminal environment, RS232C SERAL connection lets you use your PC to connect to UNIX machines that has no graphic card support or where direct access to console is not available. To use Serial connection through Xshell, serial interface must be installed in the host system. For details on serial setting, see 'Serial Connection'. 5.2.12 Connection _ PROXY Proxy Server Select a proxy server to use in this session. For details on proxy setting, see 'Proxy Setting'. 5.2.13 Connection _ Keep Alive Send keep alive messages while this session is connected Send keep alive messages every user defined interval (seconds) to a remote computer. This is useful when a connection is unexpectedly closed while the connection is idle. In some network environments, the gateway or firewall system forces a disconnection if data transfer is not made for a defined period of time. Send string when network is idle Certain systems, if there is not user key input, the sessions is automatically determined to be idle and the sesion is ended. Typically, the NF value, /n, is used. Send TCP keep alive packets when network is idle Users cannot designate the interval or cycles in which keep alive packets are sent at the OS level. 5.2.14 Terminal In the terminal setting, terminal types and other related options may be set. Terminal Type Select a terminal type to use. Xshell supports VT100, VT102, VT220, VT320, ANSI, SCOANSI, LINUX and XTERM terminals. The terminal type may change after a connection is made depending on the remote user's settings. Users can check the current terminal type using the echo $TERM command. Terminal Size : Columns Enter the number of columns in the terminal. The value is applied when the column size is fixed or if the terminal is reset after the connection is made. Terminal Size : Rows Enter the number of lines in the terminal. The value is applied once the terminal is reset after the connection is made. Fixed column size With this option selected and a connection established, even if the user changes the window size, the column size, specified by the user, will not change. If the window size is smaller than the column size, a horizontal scroll bar will be shown.
  • 24. Version 7 Help – Manual - Xshell Session Management – 24 Reset terminal size when connected When a session is run, Xshell's window will be resized to the user defined terminal size. Scroll Buffer Designate the row unit scroll buffer size. Push Erased Screen into Scroll Buffer With this option enabled, clearing the screen or resetting the terminal will push the contents into the Scroll Buffer. The erased contents can be viewed again using the mouse scroll. Encoding Select terminal output encoding. This value must be a language the remote server uses. If Default Language is selected, Xshell uses the Windows encoding. Treat Ambiguously sized characters as wide Characters without size information will be treated as 2-byte characters. 5.2.15 Terminal _ Keyboard In the keyboard settings, users may set the character strings sent by their PC's keyboard to the server. Function Key Emulation Set function keys appropriate for your terminal type. If <Default> is selected, the function key is automatically assigned according to the terminal type designated in the 'Terminal' setting. Specify an Alternate Key Mapping File Using a custom key mapping file, users can manually assign a string to each function key (F1~F20) and it will be sent to the server when pressed. Delete Key Sequence, Backspace Key Sequence Select a character string to be sent when the user presses the Delete or Backspace key. Meta Key Emulation Treat the Alt key as the Meta key for application programs which use meta keys, such as Emacs. Use Left ALT Key as Meta key Treat the Left Alt key as the Meta key. Ctrl+Alt works as Alt Gr If Ctrl + Alt are pressed simultaneously, it will be recognized as the Alt Gr key. Use Right ALT key as Meta key Treat the Right Alt key as the Meta key. 5.2.16 Terminal _ VT Mode Set the initial values for each terminal mode. Auto Wrap Mode (DECAWM) Activate auto wrap mode at startup. Origin Mode (DECOM) Activate origin mode. When this option is activated, the cursor moves based on the location designated by the server. Reverse Video Mode (DECSCNM) Enables Reverse Video Mode when the session starts. When this option is activated, the screen foreground and background colors are reversed.
  • 25. Version 7 Help – Manual - Xshell Session Management – 25 New Line Mode (NLM) Enables New Line Mode when the session starts. When this option is activated, both CR and LF are sent when Enter key is pressed. If this option is not selected, Enter key sends CR only. Insert Mode (IRM) Enables Insert Mode. When this option is selected, characters received from the remote server are inserted into where the cursor is located and the existing characters are not erased. Echo Mode (SRM) When this option is activated, a character string to send to server is displayed on screen and then transferred to server. Initial Cursor Key Mode (DECCKM) Set initial cursor key mode value. Initial Numeric Keypad Mode (DECNKM) Set default setting for Keypad mode. 5.2.17 Terminal _ Advanced Set advanced terminal options. Restrict Mouse Use at Terminal with Shift Key Some applications such as 'vi' and 'mc' can use mouse click and drag to make a selection or change the directory. When this option is selected, press the Shift key while using the mouse and Xshell uses the mouse input to perform actions such as making selection on the screen. Erase Screen Using Background Color Use the current terminal background color rather than the background color set in the color scheme when erasing screen. Receive LF as CR+LF Display both CR and LF in the terminal screen when LF is received from the server. Scroll to the Bottom when Pressing the Key Scroll to the bottom of the terminal screen when a user enters a key. Scroll to the Bottom at Terminal Input/Output Scroll to the bottom of the screen when text is displayed on the terminal screen. Enable Destructive Backspace Erase a letter to the left of the cursor, when the Backspace key is pressed, and move the cursor to the erased character's position. Disable Blinking Text Blinking texts do not blink and are displayed with solid color. Disable Terminal Title Change Do not change the Xshell title bar. In most cases, the title bar displays the folder and host name according to a request from a remote computer. Disable Terminal Printing Feature Display the terminal on screen without printing it when a request for terminal printing is received from server. Disable Switching to Alternate Terminal Screen Do not use an alternate screen for certain application programs, such as vi. When an alternate screen is used, and the application is terminated, the terminal area goes back to the screen before the application is started.
  • 26. Version 7 Help – Manual - Xshell Session Management – 26 Disable Terminal Size Change upon Request Ignore a terminal size change signal from the server. Answerback to ^E For output ^E (ENQ, Enquiry), most terminal emulators will answerback with its name. Xshell defaults to the same behavior, but the user may define which characters to answerback with. Use the built-in font to draw line characters When outputting lines or boxes with line characters (─,│,┌┘,├, etc.) use Xshell's default font instead of the user defined font. Use the built-in font to support Powerline Enable this option for a cleaner ouput when using Powerline. 5.2.18 Appearance In the appearance setting, the terminal window's colors and fonts may be set. Color Scheme Select a color scheme. Xshell provides several default color schemes. Add a new color scheme or edit an existing color scheme in the Select Color Scheme dialog box. Font Select a font to be used for Roman characters and ASCII numbers. Only fixed width fonts are listed. A font may also be selected by pressing the standard [Fonts] button. Asian Font Select the font to be used for non ASCII characters such as Chinese. If you change the font via the Standard Button toolbar, this value will be replaced by the font selected for ASCII characters. Font Size Select the desired font size. If the desired font size is not displayed, it can be manually entered. Font Quality Select the quality of the characters displayed in the terminal. Bold Select a method to express bold characters. Cursor Color Select the cursor's color. Text Color Select the color for text within the cursor. Use blinking cursor Enable this option to have the cursor blink. Speed Select the speed at which to blink the cursor. Appearance Select the type of cursor. 5.2.19 Appearance _ Window In the window settings, set the margins, spacing, tab color, and background of Xshell's terminal window.
  • 27. Version 7 Help – Manual - Xshell Session Management – 27 Margin Set terminal window margins. Spacing Set spacing between lines and characters outputted in the terminal window. Tab Color Select or choose the color of the session tab. Background Image Select a BMP image file to set as the terminal's background image. Background Image Select a BMP image file to set as the terminal's background image. 5.2.20 Appearance _ Highlight Highlighting will highlight user defined keywords with color or font conversions. Set the Highlight Set to be used to manage keywords to emphasize. For more information on settings keywords and managing highlight sets, see "Highlight Set Settings." 5.2.21 Advanced In the advanced settings, set quick command sets, tracing, bell options, and log options. Quick Command Set Select the default quick command set to be used in a session. The selected quick command set is displayed in the quick command bar when the session is started. For more information on quick commands and settings, see "Quick Command Bar Settings." Disable Shortcut Key to Quick Command Ctrl+F1 and Ctrl+F2 keys are not used as shortcut keys to quick commands. The corresponding key values are sent to the server. Xftp Option Xftp can be called from Xshell using the current connection's information. When the Telnet and Rlogin protocols are being used, Xftp will utilize the FTP protocol. A port number other than 21 can be set here. Send Delay Pasting a large number of strings into a terminal may cause some of the data to be lost depending on the network or server environment. In this case, it is recommended to use Send Delay to manually delay the transmission. Send Delay : Character Delay Set the string paste delay between the characters in milliseconds. Send Delay : Line Delay Set the string paste delay between lines in milliseconds. Send Delay : Prompt When pasting multiple lines in sequence, paste the following line only when this user defined string appears. Set a "Max Wait" time to withold pasting the following line if the specified string does not appear. 5.2.22 Advanced _ Trace In the tracing settings, set protocol tracing options. This feature is helpful when you want to trace detailed protocol messages to solve a specific problem. A tracing message is displayed in the terminal screen.
  • 28. Version 7 Help – Manual - Xshell Session Management – 28 • • • • SSH Version, Algorithm Exchange and User Authentication Display information about version exchange, encoding algorithm, compression method, and server and user authentication. SSH TCP/IP and X11 Tunneling Display port forwarding information on screen. SSH Packet Display SSH Packet message ID information. TELNET Option Negotiation Display the TELNET option exchange process between Xshell and the telnet server on the screen. 5.2.23 Advanced _ Bell Xshell incorporates several options to utilize the typical sytems' bell sounds using the ASCII character number 7(Bell character, ^G). Bell Settings Select how to acknowledge the bell character. None (Ignore bell request) : Do not respond to the server's bell character output Default system alert sound : Play Window's default alert sound PC Speaker : Play the bell sound via the PC's speakers Play the following sound : Play a user defined .wav format file Flash window and taskbar if window is not focused If the bell enabled window is behind another window or if the user is working on another program, the icon on the Windows taskbar and the window itself will flash to notifify the user that there was a bell ouput on the remote system. Ignore Bell Non system alerts and etc. may cause unintendedl bell rings due to incorrect output strings in the terminal. Time intervals can be set to avoid unintended bell rings. Temporarily disable the bell if the bell request is received more than once during the following time duration. Any bell requests made more than once during the time duration set here (seconds) will be ignored. Re-enable it after the following period of time. After a bell request has been ignored, bell requests will once again be accepted after no bell requests are made in the time duration set here (seconds). 5.2.24 Advanced _ Logging In the logging settings, set the options related to log creation. File Path Specifies the path of the log file. The string conversion formats available at file creation are %n: session name, %Y: current 4 digit year, %m: current 2 digit month, %d: current 2 digit day, %t: current time (%H-%M-%s), %h: current 2 digit hour, %M: current 2 digit minutes, %s: current 2 digit seconds. Overwrite if the file exists If a file with the same name exists in the destination folder, specify whether or not to overwrite the file. If this option is not selected, a sequence number is appended to the file name. Start Logging upon connection Logging is automatically started when a session is connected to a remote host.
  • 29. Version 7 Help – Manual - Xshell Session Management – 29 • • Prompt me to choose a file path when logging starts A prompt will be displayed when logging starts which allows the user to specify where to save the log file rather than the default path. Include terminal code Choose one of the following logging methods. Record only printable text Record terminal code as well as printable text If you include terminal code, all contents (color, string output status, etc.) will be recorded. Timestamp: Log file records Log file records will show the time the log was output. Timestamp : Format This is how the the date and time are formatted: %n: session name, %Y: current 4 digit year, %m: current 2 digit month, %d: current 2 digit day, %t: current time(%H-%M-%s), %h: current 2 digit hour, %M: current 2 digit minutes, %s: current 2 digit seconds, %a: other OS expression for date and time, %I: line number. Timestamp: Preview Displays the formatted timestamp based on current date and time. 5.2.25 File Transfer This sections deals with X/Y/Z modem protocol file transfers during a terminal connection. Folder When transferring a file from remote servers, users can specify whether to save to a predetermined path or to have a prompt displayed so the user can specifiy each transfer. Duplicate file handling When a file with the same name exists, users can specify whether to automatically rename the file or to overwrite it. Upload protocol User can upload local files by simply dragging and dropping the file into Xshell. Specify which protocol to use during these uploads. 5.2.26 File Transfer _ X_YMODEM Set various options for file transers using X/Y modem. Option Select the packet size to be sent to the remote server. If 1024 bytes is selected, the transfer speed will be faster, but it must be supported by the server. Upload Command When using the XMODEM or YMODEM commands in the File Menu or when dragging and dropping, the selected file is automatically transferred. Set the commands the server will use to prepare to receive the files at this time. For X/Y modem related commands, please refer to the related server manual. 5.2.27 File Transfer _ ZMODEM In the ZMODEM settings, set various options relating to ZMODEM file transfers.
  • 30. Version 7 Help – Manual - Xshell Session Management – 30 1. 2. 3. 1. 2. 3. 4. 5. Activate ZMODEM Automatically Automatically start file send when remote ZMODEM program starts send. If this option is not set, the file must be received by selecting [Send with ZMODEM] in the [File] > [Transfer] menu. X/YMODEM cannot automatically be received and so [Receive with X/YMODEM] must be selected" from the [File] > [Transfer] menu. 5.3 Export Sessions exported by Xshell are collected into a single convenient file. When this file is imported from another computer where Xshell is installed, the imported sessions may be used without additional setup. However, the password of the exported session file will not be available unless a Master Password has been set on the PC from which the session file was exported and the same exact Master Password has been set on the PC into which the session file is imported. To Export Session: Select [Export] from the [File] menu. The Import/Export Sessions wizard is displayed. Select the position where the exported file is to be saved and click [Next]. Session export results will be displayed. Note If 'Clear Password' is selected, the exported session file will not include the session password during the export. Also, even if 'Clear Password' is not selected, the password will only be evailable if imported into the same computer under the same user. To use the session with the session password on another device you must first set a Master Password on the computer from which the session file is being exported and the same exact Master Password must be set on the computer into which the session file is to be imported. Click [Finish] to complete sessions export. 5.4 Import Xshell can import sessions exported by other computers. To Import Session: Select [Import] from the [File] menu. The Import/Export Sessions wizard is displayed. Directly enter the file path exported from other computer or click the […] button to select the exported file and click [Next]. Sessions are imported and the result is displayed. Select how to handle sessions with the same file names. Click [Next] to select the types of sessions to import. Click [Finish] to complete session import.
  • 31. Version 7 Help – Manual - Xshell Connection – 31 1. • • • 1. • • • 2. 1. 2. 1. 2. 3. 1. 1. 6 Connection Xshell provides various connection methods, such as the Sessions dialog box, local prompt, address bar, links bar, and shortcuts to session. 6.1 Connections without Session Files Connection from the Local Prompt: Enter one of the following commands in the local prompt: [C:~]$ telnet hostname [C:~]$ ssh hostname [C:~]$ rlogin hostname Note A port number must be designated if a remote host does not use the default port number. For information on commands, see 'Xshell Local Command'. Connection from the Address Bar: Enter one of the following commands in the address bar: telnet://hostname ssh://hostname rlogin://hostname Press Enter or click [Connect]. Note A user name and port number may be entered in the address bar. For details, see 'Address Bar'. Connection from the Recent Sessions: Select [Recent Sessions] in the [File] menu. User authentication of the selected session is performed. Note If user authentication is registered in the registration information of the selected session, step 2 is skipped. 6.2 Connections with Session Files Connection from the Sessions Dialog Box: Open the Sessions dialog box. Select a session for connection. Click [Connect]. Note If a remote host connection already exists, a new tab is opened or a new Xshell is started. Connection from the Local Prompt: Enter the following command in Xshell local prompt. [C:~]$ open session file name Connection from a Shortcut: Double-click the shortcut icon of a session. Note To obtain information about shortcut to session, see 'Session Management'.
  • 32. Version 7 Help – Manual - Xshell Connection – 32 1. 2. 1. 2. 1. 2. 3. 4. 5. 6. 7. 8. 9. 10. 11. 12. 13. 1. 2. 3. 4. 5. 6. 7. Connection from the Session Manager: Make sure the "Session Manager" is enabled in the [View] menu. Select the session you want to connect to and double-click or press the Enter key. 6.3 Sessions to Run on Xshell Startup Select 'Options' from the [Tools] menu. In the 'General' tab, click 'Add' and select session files to automatically connect upon Xshell startup. 6.4 SERIAL Connection RS232C SERIAL connections lets you use your PC as a terminal when there is no video card in the UNIX system or if the console is not directly accessible. To use SERIAL connections via Xshell, the SERIAL interface must be installed in the host system. To Make Serial Connections: Select [New] from the [File] menu. New Session Properties dialog box is displayed. Enter a session name in [Session]. Select SERIAL from [Protocols] list. Enter a host name in [Host] Select [SERIAL] from [Category]. Select the RS232C serial port number connected with the PC where Xshell is installed from [Port]. If the port number is not in the list or if the name is the same as the named pipe, enter it manually. Select communication speed in [Baud Rate]. The value must match the server value. In general, 9600 is used. Select the transferred data unit bit count in [Data Bits]. It must match the server value. Select number of bits to indicate the end of data unit in [Stop Bits]. Make a selection according to server settings. [Parity] is to verify errors in transferred data. Select one from none, odd, even, mark and space according to server settings. [Flow Control] is for controlling data communications. Supported flow control methods are XON/XOFF and RTS/CTS. If a flow control is not set(None), data may be lost if data is sent faster than the serial line. Create a new session by clicking [OK]. Make a connection as described in 'Connection with Sessions Files' with the created session. 6.5 Connection with Kerberos Xshell 6 supports MIT GSSAPI Kerberos and Microsoft's SSPI Kerberos authentication. This article assumes that you have a working Kerberos server and client. To create a new Kerberos session, Select [New] from the [File] menu. Enter a session name in [Name]. Select SSH from the [Protocols] list. Enter a host name in [Host] Select [Authentication] from under [Category]. Select GSSAPI from the [Method] list. Note If the PC running Xshell is utilizing an Xshell supported Kerberos module, Xshell can only automatically authenticate to the SSH server if GSSAPI authentication is selected. To change the GSSAPI settings, click the [Setup] button.
  • 33. Version 7 Help – Manual - Xshell Connection – 33 8. 9. 10. 11. 1. 2. 3. 4. 5. 6. 7. 8. 9. 10. 11. 12. 1. 2. 3. 4. Note To connect to another server using Kerberos authentication from a server using Kerberos authentication, select the 'Allow GSSAPI credential delegation' option. Click [OK] to save the GSSAPI settings. Enter the user name. Click [OK] to save the session file. Click [Connect] to connect immediately or select the session file from the Sessions Dialog Box to connect. You have finished creating a session that will use the Kerberos module. When this session opens, it will try to use the Kerberos credential for the specified user. It has to be the same user you defined in the Network Identity Manager. 6.6 Connection with PKCS _11 PKCS #11 is one of the public key cryptography standards. Xshell 6 can connect to a remote SSH server using a PKCS #11 encrypted hardware security token (HSM) or a smart card's RSA key. To create a new PKCS #11 session: Select [New] from the [File] menu. Enter a session name in [Name]. Select SSH from the [Protocols] list. Enter a host name in [Host] Select [Authentication] from under [Category]. Select PKCS11 from the [Method] list. Click the [Setup] button. Enter the path of the middleware program that can connect to the hardware token that contains the user key. Or click […] to browse for it. If the pin number is set in the hardware token, enter the pin number. Enter the user name. Click [OK] to save the session file . Click [Connect] to connect immediately or select the session file from the Sessions Dialog Box to connect. 6.7 Proxy Setting Proxy server mediates between a network to which a user belongs and an external network to be connected with. Add, edit and delete a proxy server in Proxy List dialog box. To Add Proxy Server: In [Connection > Proxy] category of Session Properties dialog box, click [Browse] in [Proxy Server]. Click [Add] in Proxy List dialog box. Proxy Settings dialog box is displayed. Enter proxy server name, proxy server type, host information and user information. Press [OK] to add proxy server. 6.8 Jump host The Jump Host feature is a proxy feature that allows you to utilize an intermediate SSH server in order to reach the final destination server. As it uses Open-SSH’s TCP Tunneling, this feature can be used to connect to servers that cannot directly connect to the firewall or network configuration. To Connect Using the -J Parameter from the Local Shell:
  • 34. Version 7 Help – Manual - Xshell Connection – 34 1. 1. 2. 3. 4. 5. 6. In the local shell, type ssh -J user1: passwd1 @ jump_host1, user2: passwd2 @ jump_host2 destination_host. To Connect Through a Proxy: Select [New…] from the [File] meun. Enter the host of the destination server in [Host]. Select [Browse] in [Proxy Server]. Select [Add] to open the proxy creation window. In [Proxy Settings], change [Type] to JUMPHOST and enter the remaining required information. Fig 1: Proxy Settings Screen Set the created proxy as the default in [Proxy Server].
  • 35. 2 http://ssh.com Version 7 Help – Manual - Xshell Security – 35 1. 2. • • • 1. 2. 3. 4. 5. 6. 1. 2. 7 Security Xshell provides public key user authentication. Host keys and user key databases created in Xshell may be used in Xmanager and Xftp programs. Once a public key is created, it may be used in other programs without any additional configuration. 7.1 Public Key User Authentication0 For public key user authentication, a pair of user keys must be created comprised of a public key and a private key. While public key authentication is carried out, the private key is used by Xshell to create a user signature and the public key is used by the SSH server to check the signature. A user key may be created from the SSH server or Xshell. If the user key is created from the server, the private key must be registered in the Xshell private key repository using Xshell import. If the user key is created from Xshell, the public key must be registered in the server. To Create a User Key: Select [New User Key Wizard] from the [Tools] menu. Create a user key according to instructions given by the New User Key Wizard. Note Register a public key on a server at the last stage of key creation. Registration methods vary depending on server types. SSH1: Copy the public key text and save it to $HOME/.SSH/authorized_keys file. Execute the following command to turn off the write permission of the files and directories. $ cd $ chmod go-w . .SSH .SSH/authorized_keys SSH2-OpenSSH: OpenSSH servers use this format. Copy the public key text and save it to $HOME/.SSH/authorized_keys2 file. Execute the following command to turn off the write permission of the files and directories. $ cd $ chmod go-w . .SSH .SSH/authorized_keys2 SSH2-IETF SECSH: Certain commercial SSH servers, such as ssh.com2 server, use this format. Save a public key under an intrinsic name, such as mypublickey.pub and copy it to $HOME/.ssh2 directory. Add the following line to $HOME/.ssh2/authorization file: Key mypublickey.pub Execute the following command to turn off the write permission of the files and directories. $ cd $ chmod go-w . .ssh2$ chmod go-w .ssh2/authorization .ssh2/mypublickey.pub To Register a Public Key in a Server: Open the User Keys dialog box by selecting [User Key Manager] from the [Tools] menu. Select a user key to register. Click [Properties]. The User Key Properties dialog box is displayed. Click the [Public Key] tab. Select an appropriate type from the [Public Key Format] list. Click [Save as a file] to save or copy the key content and register the key to the server according to the public key registration method above. To Change the User KeyPassphrase: Open the User Keys dialog box. Select a user key for which to change the passphrase.
  • 36. 3 http://SSH.com Version 7 Help – Manual - Xshell Security – 36 3. 4. 5. Click [Properties]. The User Key Properties dialog box is displayed. Click the [General] tab. Click [Change Passphrase]. Note Import, export, rename, delete, and create a user key in the 'User Keys Dialog Box'. 7.1.1 User Keys Dialog Box The User Keys dialog box enables the creation and management of user keys. Open this dialog box by selecting [User Key Manager] from the [Tools] menu. Import Select a user key file and import it by opening the Open dialog box. Currently, Xshell can read the SSH1 protocol RSA key, the OpenSSH SSH2 protocol RSA/DSA key, the SSH.com3 key and the NetSarang Computer user key formats(*.pri). Export Save a selected user key file by opening the Save dialog box. Exported file types are NetSarang user keys or the OpenSSH SSH2 format. NetSarang Computer user key format files(*.pri) can be used in programs developed by NetSarang Computer, Inc. Delete Delete a selected user key from database. Rename Rename a selected user key. Key name must be valid as a file name. Properties Show user key attributes. Type, length, fingerprint, and public key may be viewed, and the key passphrase may be changed. Generate Open the New User Key Wizard. 7.2 Host Key Management A host key is a remote host public key, and users can verify the host via its fingerprint. When a connection is made, the remote host sends its public key to Xshell. When the host key is valid and you trust it, you can save the host key to the database in Xshell. If a host key is not saved in the database, the SSH Security Warning dialog box will appear when you try to connect to the host. 7.2.1 SSH Security Warning Dialog Box The SSH Security Warning dialog box is displayed when a remote host key is not saved in the host key database or the fingerprints of the remote host key and the saved host key are different. Accept Once Accept host key for this connection only. The host key is not saved and the same dialog box opens at the next connection. This is useful when a server host key changes often or the user rarely connects to the server.
  • 37. Version 7 Help – Manual - Xshell Security – 37 1. 2. 3. 4. 5. 6. 1. Accept and Save Save host key and process the connection. This dialog box does not open on the next connection. This is useful when the fingerprint is correct and the user connects to the host frequently. Cancel Host key is not accepted and connection is cancelled. 7.2.2 Host Keys Dialog Box The Host Keys dialog box permits users to manage host keys of remote hosts to which connection is allowed. Import Import a host key by opening the Open dialog box. The imported host key is saved in the host key database. Files saved in the SECSH public key format can be imported. Export Export a selected host key by opening the Save dialog box. The exported keys are saved in the SECSH public key format and can be used in other programs. Remove Remove a selected host key from the database. View Open a selected host key with notepad. 7.3 Master Password Master password can be used to save passwords more securely using the user defined master password. Xshell saves all password information in an encrypted format. However, since passwords are encrypted using a fixed key, it has a risk of being exploited by hackers. When the master password is enabled and set, it is mixed in during password encryption adding an additional layer of security. Master password uses a user defined keyword to encrypt the password section of the session data. When the master password is enabled, Xshell asks for the master password every time a new Xshell instance is started and a session is open. If the correct master password in not inputted, the session's password is not able to be utilized and must be entered again manually preventing unauthorized access. Note Be sure to remember your master password. If you lose your master password, there is no way to retrieve the password information stored in the session files.Maser Password settings are applied simultaneously to Xmanager, Xshell, and Xftp sessions. To Enable Master Password: Click on the Tools menu and then select Options. Select the Security tab. Click Set Master Password to open the Master Password dialog box. In the Master Password dialog box, enter a new master password in the New Password field. In the Confirm Password field, enter the new password again. Click OK to save the changes. Once master password is enabled, all sessions saved in the default location are re-encrypted using the new master password. To Change Master Password: Click on the Tools menu and then select Options.
  • 38. Version 7 Help – Manual - Xshell Security – 38 2. 3. 4. 5. 6. 7. 8. 1. 2. 3. 4. 5. 1. 2. 3. 4. 5. Select the Security tab. Click Set Master Password to open the Master Password dialog box. In the Change area click Change to open the Master Password Change dialog box.. Enter the current master password in the Current Password field. Enter the new master password in the New Password field. Enter the new password one more time in the Confirm Password field. Click OK to save the changes. To Disable Master Password: Click on the Tools menu and then select Options. Select the Security tab. Click Set Master Password to open the Master Password dialog box. Click the Remove button to open the Remove Master Password dialog box. In the Remove Master Password dialog box, enter the master password and click OK. To Reset the Master Password: Click on the Tools menu and then select Options. Select the Security tab. Click Set Master Password to open the Master Password dialog box. Click the Reset button to open the Reset Master Password dialog box. In the Reset Master Password dialog box, click Reset Master Password and click OK. Note Reset of the master password can be used if your forgot your master password or if you would like to clear all the passwords stored in your sessions.
  • 39. Version 7 Help – Manual - Xshell Tab Management – 39 • • • • • 1. 2. 1. 2. 1. 2. 3. 8 Tab Management Xshell has a powerful tab management feature. You can connect to multiple hosts and compare them side by side from a single window. The intuitive tab management feature is a unique Xshell feature that cannot be found in other terminal emulators. Each tab is associated to a single terminal and it belongs to a tab group. A tab group is a collection tabs. A single Xshell window can have multiple tab groups and can be organized as desired. 8.1 Tab There are several ways you can create a new tab. You can use any of the following methods: Click the [Tab] menu and select [New Tab] Double click on the tab bar in the background. Use the keyboard shortcut, Shift + Alt + N. To close a Tab: Click the x button on the tab. When focus is on the tab, press Ctrl+Shift+F4. To close a tab from Terminal: While connected to the remote host, enter 'exit'. In Xshell's local shell, type 'exit' again. Note To close a tab from Terminal, you must not have selected the 'Revert to local shell when connection is closed' option in the [Options] dialog box. Also, if the 'Exit Xshell when the last tab is closed' option is not selected, you must select 'Exit' from the 'File' menu to exit Xshell. 8.2 Tab Group A tab group is collection of multiple tabs. Use tab groups to neatly organize sessions. Only one tab from the tab group is visible at any given moment. To view and compare multiple tabs simultaneously, you must separate the tabs into different groups. To Create a New Tab Group: Right click on the tab background. Point to [New Tab Group] and select a location you want to create a new tab group. Note If you want to create a new tab group with an existing tab, you can drag a tab to edge of the terminal until you see the blue marker and drop it. To Move a Tab to a Different Tab Group: Select a tab you want to move to a new tab group. While holding down the left mouse button, drag the tab to a different tab group. Drop the tab to a new tab group. To Delete a Tab Group:
  • 40. Version 7 Help – Manual - Xshell Tab Management – 40 1. 2. 3. 1. 2. 1. 2. 1. 2. 1. 2. 1. 2. Select a tab group you want to close. Right click on the tab group in the background. Select the [Close This Tab Group] option. To Combine All Tab Groups into one Tab Group Select the Xshell window you would like to combine tab groups. In the [Tab] menu, select 'Merge All Tab Groups' under 'Arrange.' 8.3 Split and Merge Tabs Tabs can be separated to create new windows and you can combine tabs from different windows into one window. To use this feature, you must turn off the 'Use single-process mode for better performance' in [Options > Advanced]. To Detach a Tab and Create a New Window: Select the tab you want to detach with the mouse. Drag the tab and drop it outside of the Xshell Window. To Detach and Tab and Add it to an Existing Window: Select the tab from an Xshell Window. Drag the tab and drop it into a tab group of an existing Xshell Window. 8.4 Arrange Tabs Multiple tabs can be automatically arranged into horizontal, vertical, or tiled tab groups. This is useful for concurrent operations on multiple servers. To Arrange Tabs Horizontally, Vertically, or Tiled: Select the Xshell window to be arranged. In the [Tab] menu, under 'Arrange,' select the desired arrangement method. To Combine an Auto-Arranged Group of Tabs into One Tab Group: Select the Xshell window to be arranged. In the [Tab] menu, under 'Arrange,' select 'Merge All Tab Groups.
  • 41. Version 7 Help – Manual - Xshell Tunneling Service – 41 1. 2. 3. 4. 5. 6. 7. 8. 9. 10. 11. 12. 1. 2. 3. 4. 5. 6. 1. 2. 3. 4. 5. 6. 9 Tunneling Service Xshell provides TCP/IP and X11 forwarding functions, which creates a secure tunnel between a user's PC and another computer connected across an unreliable network enviornment providing a way to safely transmit data. 9.1 TCP_IP Port Forwarding To use port forwarding service via a secure tunnel, define port forwarding rules for each application program. Note For local forwarding, connection to alocal PC's listening port is forwarded to a specific destination host port. For remote forwarding, connection to the remote host listening port is forwarded to a specific destination host port. Dynamic forwarding works the same as local forwarding. It automatically determines the host of delivery destination and port according to the SOCKS protocol. The default port number of SOCKS protocol is 1080. To Add a New Port Forwarding Rule to a Session: Open the Sessions dialog box. Select a session for which to edit port forwarding rule. Click the standard [Properties] button. Select [Connection > SSH > Tunneling] from [Category]. Click [Add] to open the Forwarding Rule dialog box. Select connection type from the [Type] list. Enter the localhost or IP address in [Source Host]. Enter the port number in [Listening Port] or select a service name. Enter the name of the host or IP address where the server program operates in [Destination Host]. Enter the port number where server program is waiting in [Destination Port]. Enter a description of the forwarding rule in [Description]. Click [OK]. To Change Forwarding Rule: Open the Sessions dialog box. Select session for which to edit port forwarding rule. Click the standard [Properties] button. Select [Connection > SSH > Tunneling] from [Category]. Select a forwarding rule to change. Click [Edit]. To Remove Port Forwarding Rule: Open the Sessions dialog box. Select session for which to edit port forwarding rule. Click the standard [Properties] button. Select [Connection > SSH > Tunneling] from [Category]. Select a forwarding rule to remove. Click [Remove]. 9.2 X11 Forwarding X11 forwarding is a special TCP/IP port forwarding case. The X11 protocol is used by a PC X server software, such as Xmanager, and the connection is established to a user PC from a remote host. It is thus the reverse situation from other client programs, such as email or telnet. Using X11 forwarding, remote X11 application programs can be used
  • 42. Version 7 Help – Manual - Xshell Tunneling Service – 42 1. 2. 3. 4. 5. 6. 7. 1. 2. 3. 1. 2. 3. 1. 2. 3. 4. 5. 6. 7. 8. in a user's PC via a secure encoding tunnel without complicated port forwarding settings. To use the X11 forwarding service, you should configure both Xshell and the SSH server. To Activate X11 Forwarding in Xshell: Open the Sessions dialog box. Select a session for which to activate X11 forwarding. Click the standard [Properties] button. Select [Connection > SSH > Tunneling] from [Category]. Select [Forward X11 Connections to]. If Xmanager® is installed in the user's PC, select [Xmanager]. If another PC X server is used, select [X DISPLAY] and enter an appropriate DISPLAY. Click [OK]. Note In Xmanager, Xshell automatically finds the X DISPLAY option. In other PC X server programs, the option must be set manually. If PC X server uses TCP 6000 port, DISPLAY is set as 'localhost:0.0'. To Activate X11 Forwarding in an OpenSSH Server: Open the /etc/ssh/sshd_config file. Set X11Forwarding option value as follows: X11Forwarding yes Restart SSH server. To Activate X11 Forwarding in an ssh.com Server: Open the /etc/ssh2/sshd2_config file. Set AllowX11Forwarding option value as follows: AllowX11Forwarding yes Restart SSH server. 9.3 SOCKS4_5 Dynamic Port Forwarding Dynamic port forwarding is a method to forward a local network connection to an SSH server, where the destination host and port are automatically determined by the SOCKS protocol. Using dynamic port forwarding, Xshell can operate as a SOCKS proxy server. To Add New Dynamic Port Forwarding Rule to a Session: Open the Sessions dialog box. Select a session for which to edit port forwarding rule. Click the standard [Properties] button. Select [Connection > SSH > Tunneling] from [Category]. Open the Forwarding Rule dialog box by clicking [Add]. Select Dynamic (SOCKS4/5) from [Type] list. Enter port number in [Listening Port] or select a service name. The SOCKS proxy server default port is 1080. Click [OK]. Note For dynamic port forwarding, the destination host and port do not need to be entered. 9.4 Instant Tunneling Instant tunneling enables users to add, remove, suspend, and resume a forwarding rule while a session is connected. The current session tunneling status can be checked in the tunneling pane. To view the tunneling pane, select [Tunneling Pane] from the [View] menu.
  • 43. Version 7 Help – Manual - Xshell Tunneling Service – 43 1. 2. 3. 1. 2. 3. 1. 2. 3. 1. 2. 3. To Add Port Forwarding Rule in the Tunneling pane: Click the [Forwarding Rules] tab in the tunneling pane. Right-click on the list. Select [Add] from menu. Forwarding Rule dialog box is displayed. Note Newly added rules are applied to the current connection. Unless you save the rules, they are deleted when the connection is closed. To Remove Port Forwarding Rules from the Tunneling pane: Click the [Forwarding Rules] tab in the tunneling pane. Right-click on a rule to remove from the [Forwarding Rules] list. Select [Remove] from menu. To Suspend Port Forwarding Rules: Click the [Forwarding Rules] tab in the tunneling pane. Right-click on a rule to suspend from the [Forwarding Rules] list. Select [Suspend] from menu. To Retry Port Forwarding Rules: Click the [Forwarding Rules] tab in the tunneling pane. Right-click on a rule to resume in the [Forwarding Rules] list. Select [Resume] from menu. Note Resume can only be executed for a previously suspended rule.
  • 44. Version 7 Help – Manual - Xshell Terminal Window Operations – 44 1. • • • • 1. 2. 1. 2. • • • • • 1. 2. • • 1. • • �� • 10 Terminal Window Operations Xshell provides a succinct and powerful terminal window enabling users to simultaneously use the remote terminal and local prompt command interface. Terminal window provides a range of convenient functions, such as copy & paste, find character string, change font and font color, and advanced terminal options. 10.1 Copy and Paste To Select a Character String: Do one of the following: Press the left mouse button at the starting point of an area to select. While pressing the button, move the mouse to the end of the area to be selected and release the button. The selected character string is displayed in an inverted color. Click the left mouse button at the starting point of an area to select. Move mouse to the end of the area. While pressing Shift key, press the left button once again. Double-click a word to select. The double-clicked word is selected. Triple-click a row to select. The entire row is selected. To Select Character Strings in a Column Unit: Press Alt key. Press the left mouse button at the starting point of an area to select. While pressing the button, move to the end of the area to select and release the button. To Copy Selected Character Strings to the Windows Clipboard: Select a character string to copy. Do one of the following: Click the [Smart Selection] button and select [Copy]. Select [Copy] from the [Edit] menu. Click the standard [Copy] button. Press Ctrl+Insert key. If [Copy Selected Texts to the Clipboard Automatically] is set in options, the selected text is automatically copied. To Copy Selected Character String to Notepad: Select a character string to copy. Do one of the following: Click the [Smart Selection] button and select [To Text Editor]. Point to [To Text Editor] in the [Edit] menu and select [Selected Area]. Note The scroll buffer and current screen may be copied as well as the selected character strings. A notepad window is automatically displayed with the copied text. This does not copy character strings to the clipboard. To Paste Clipboard Contents to the Terminal Screen: Do one of the following: Select [Paste] from the [Edit] menu. Click the standard [Paste] button. Press Shift+Insert key. If Paste the clipboard contents is selected for middle or right mouse button operation, click the corresponding mouse button.
  • 45. Version 7 Help – Manual - Xshell Terminal Window Operations – 45 1. 2. 3. 4. 5. 1. 2. 3. 1. 2. 3. 4. 1. • • 1. 2. 3. To Set Xterm Style Copy and Paste: Open the Options dialog box. Click the [Keyboard and Mouse] tab. Select [Mouse] – [Middle Button] operation as Paste the clipboard contents. Select [Selection] - [Copy Selected Texts to the Clipboard Automatically]. Click [OK]. Note When a character string is selected, the xterm program copies it to clipboard. When the middle mouse button is pressed, it is pasted to the terminal screen. 10.2 Find String Search scroll buffer using a specific keyword or a regular expression. To Find with Keyword: Select [Find] from the [Edit] menu. Enter a keyword in Find dialog box. Click [Find Next]. To Find with Regular Expression: Select [Find] from the [Edit] menu. Enter a keyword in Find dialog box. Select [Regular Expression]. Click [Find Next]. Note For detailed information on regular expression, see 'Regular Expression'. 10.3 Font Change In the terminal screen, characters must be displayed in rows and columns. In Xshell, only fixed width fonts may be selected. To Change Terminal Font and the Font Size: Do one of the following: Click the standard [Fonts] button and select a font and the font size. Select [Appearance] in Session Properties dialog box and select a font and the font size. To Change Bold Text: Open the Session Properties dialog box. Select [Appearance] from [Category]. Select an option from [Bold] field. Note As for Bold, either colors or bold font or both may be used. 10.4 Font Color and Background Color Setting In a color scheme, font colors, background colors and ANSI 16 colors are saved. Xshell enables users to select/ change color schemes anytime while using Xshell. The selected color scheme is applied immediately.
  • 46. Version 7 Help – Manual - Xshell Terminal Window Operations – 46 1. • • 1. 2. 3. 4. 1. 2. 3. 4. 5. 6. 1. 2. 3. 4. 5. 1. 2. 3. 4. 1. 2. 3. 4. 5. To Change Terminal Color: Do one of the following: Click the standard [Color Schemes] button to display the Select Color Scheme dialog box. Select a color scheme in the dialog box and click [OK]. Select [Appearance] from [Category] in Session Properties dialog box, select a color scheme from the [Color Scheme] and click [OK]. Note Xshell provides several default color schemes. Users may edit the existing color schemes or create new color schemes. To Create New Color Scheme: Open the Select Color Scheme dialog box. Click [New]. A new color scheme is added to the list. Select the new color scheme created. Click [Edit]. Edit Color Scheme dialog box is displayed. To Edit Color Scheme: Open the Select Color Scheme dialog box. Select a color scheme to edit. Click [Edit]. Edit Color Scheme dialog box is displayed. Select colors for normal text in [Normal Text]. Select colors for bold text in [Bold Text]. In general, colors lighter than the normal text are used for bold text. [ANSI Colors] is used to express ANSI color code in terminal. The colors on top are for normal text, such as black, red, green, yellow, blue, magenta, cyan and white, and the colors on the bottom are for bold text. To Export Color Scheme: Open the Select Color Scheme dialog box. Select a color scheme to export. Click [Export]. Save dialog box is displayed. Select a folder and enter the file name to save. Click [Save]. Note Exported file is in '.xcs' format and may be used in Xshell only. A number of color schemes may be saved in a single file. The color scheme names are also saved in the file. To Import Color Scheme: Open the Select Color Scheme dialog box. Click [Import]. Open dialog box is displayed. Select a color scheme file (.xcs) to import. Click [Open]. 10.5 Cursor Change To Change Cursor Color: Open the Session Properties dialog box. Select [Appearance] from [Category]. Select [Cursor Color] value. Select [Text Color] value. Click [OK].
  • 47. Version 7 Help – Manual - Xshell Terminal Window Operations – 47 1. 2. 3. 4. 1. 2. 3. 4. 5. 1. 2. 3. 4. 1. 2. 3. 4. 1. 2. 3. 4. 1. 2. 3. 4. 1. 1. 1. To Change Cursor Blinking: Open the Session Properties dialog box. Select [Appearance] from [Category]. Select or deselect [Use blinking cursor]. Click [OK]. To Change Cursor Blinking Speed: Open the Session Properties dialog box. Select [Appearance] from [Category]. Check [Use blinking cursor]. Enter cursor blinking speed by millisecond in [Speed]. Click [OK]. 10.6 Window Handling To Minimize to Notification Area: Open the Options dialog box. Click the [Advanced] tab. Check [Send to the notification area when minimized] in [Window] options. Save changes by clicking [OK]. To Minimize to Notification Area at Startup: Open the Options dialog box. Click the [Advanced] tab. Check [Minimize to the notification area at Xshell startup] in [Window] options. Save changes by clicking [OK]. To Exit Xshell when All Connections are Closed: Open the Options dialog box. Click the [Advanced] tab. Check [Exit Xshell when all connections are closed] in [Session] options. Click [OK]. To Exit to Local Shell when Connections are Closed: Open the Options dialog box. Click the [Advanced] tab. Check [Revert to local shell when connection is closed] in [Session] options. Click [OK]. To Create New Xshell Window: Select [New Window] from the [Window] menu. To Move to Another Xshell Window: Select [Next] or [Previous] from the [Window] menu. Note The same functionmay be executed using Alt+Right and Alt+Leftkeys. To Close All Xshell Windows Simultaneously: Select [Close All] from the [Window] menu. To Close All Xshell Windows Except the Current Window:
  • 48. Version 7 Help – Manual - Xshell Terminal Window Operations – 48 1. 1. 2. 3. 4. 1. 2. 1. 2. 1. 2. 1. • • • • 1. Select [Close All but This] from the [Window] menu. 10.7 Multi-session Handling 'Multi-session' enables users to work and move between sessions using the sessions tab or sessions bar while maintaining multiple connections in a single Xshell window. To Open the Multiple Sessions in Single Xshell Window: Open the Options dialog box. Click the [Advanced] tab. Check [Open multiple sessions in a single Xshell window] in [Session] options. Save changes by clicking [OK]. To Create a New Connection in Sessions Tab: Click the [+(Add Tab)] button at the far left of the sessions tab. Select one from sessions list. The selected session is opened in a new tab. To Create New Connection in Sessions Bar: Click an icon at the far left of the sessions bar. Select one from the sessions list. The selected session is opened in a new tab. Note To create a new connection, use a session as described in 'Session Management' or try a connectionwithout a session. To Connect with a Remote Computer by Entering a Command in Local Shell: To open a local shell, click the [+(Add Tab)] button of the sessions tab and select [Local Shell] or double- click a blank in the sessions tab. In the local command prompt, connect to a remote computer using commands, such as ssh, telnet and sftp. For details on using command, enter '?'. Note For detailed information on local commands, see 'Xshell Local Command'. To Move Between Sessions at Multi-session Connection: Do one of the following: Click a sessions tab. Click a session button from the sessions bar. Use Ctrl+Tab, Shift+Tab or Ctrl+Shift+Tab. Move between sessions using Alt+'session number'. To Connect with Session in New Xshell Window: Select [New Terminal] from the [Window] menu or click the standard [New Terminal] button. A new Xshell window opens and connection is attempted with the same session information as the currently connected session. 10.8 Quick Command Sets Setting By designating frequently used character strings as quick commands, Users can avoid repeated keyboard inputs and use simple mouse clicks to execute the commands. To display quick commands bar, check [Quick Commands] in the [View] menu. To Add Quick Command Set: