Windows Access Server
User’ s Manual
Foxit Software Company
URL: http://foxitsoftware.com
Sales information: sales@foxitsoftware.com
Technical support: support@foxitsoftware.com
Page 1 of 231
WAC Server Contents
WAC SERVER CONTENTS.................................................................................................................2
ABOUT THIS MANUAL....................................................................................................................... 8
PART ONE --- WAC SERVER.............................................................................................................. 10
CHAPTER ONE................................................................................................................................... 11
INTRODUCTION TO WAC SERVER................................................................................................11
WAC S
WAC S
WAC S
H
CHAPTER TWO.................................................................................................................................. 15
INSTALLATION................................................................................................................................. 15
P
P
E
S
U
CHAPTER THREE.............................................................................................................................. 21
GETTING STARTED.......................................................................................................................... 21
C
C
A
ERVER DESCRIPTION
ESSION AGENT
ERVER SERVICE
WAC S
OW
ROCEDURE ONE -- LOAD CD OR DOWNLOAD THE SOFTWARE
ROCEDURE TWO -- SETUP THE SOFTWARE
XPRESS UPGRADE, UPDATE OR RE-SETUP
ETUP AFFECTION
NINSTALL
ONNECTING USING
ONNECTING USING OTHER 3RD PARTY CLIENT
Adjust Terminal Settings................................................................................................................ 22
Resize terminal screen................................................................................................................... 24
UTHENTICATING USING USER PUBLIC KEY
ERVER WORKS
.............................................................................................................................. 18
........................................................................................................................................ 20
WAC N
VTNT......................................................................................................................................................22
Other Terminals....................................................................................................................................... 23
Keyboard Mapping...................................................................................................................................23
............................................................................................................... 12
........................................................................................................................ 12
...................................................................................................................... 13
................................................................................................................ 14
.............................................................. 16
......................................................................................... 16
.......................................................................................... 18
ATIVE CLIENTS
....................................................................................... 22
.................................................................................. 22
........................................................................................ 24
CHAPTER FOUR................................................................................................................................ 26
WORKING WITH WAC SERVER..................................................................................................... 26
M
ANAGING SESSIONS
Session Managing Utilities............................................................................................................ 27
Session Inter-Operations............................................................................................................... 27
Session Info View .................................................................................................................................... 28
Alert messages......................................................................................................................................... 28
Session Watch.......................................................................................................................................... 29
Abort Session...........................................................................................................................................31
M
ANAGING SERVICES
WAC Service Managing Utilities.................................................................................................... 32
ANAGING USER AND USER GROUP
M
User and Group Managing Tool.................................................................................................... 33
......................................................................................................................... 27
......................................................................................................................... 31
................................................................................................... 33
Page 2 of 231
Tips for Windows XP Users........................................................................................................... 33
M
ANAGING SYSTEM TOOLS
ANAGING FILES
M
C
HECKING MAILS
HATTING
C
ILE TRANSFER
F
............................................................................................................................... 34
............................................................................................................................... 35
.......................................................................................................................................... 35
.................................................................................................................................. 35
................................................................................................................ 34
Configuring File Transfer on Server Side....................................................................................... 36
File Directories............................................................................................................................. 36
Sending Files to Server with WAC Client Command Utility............................................................ 37
Sending Files to Terminal with WAC Explorer............................................................................... 38
Sending Files to Terminal with WAC Command Line Utility........................................................... 39
WAC C
OMMAND LINE UTILITIES
........................................................................................................ 40
WAC Info...................................................................................................................................... 41
WAC Who..................................................................................................................................... 41
WAC Whoami................................................................................................................................ 42
WAC Send..................................................................................................................................... 42
WAC Watch................................................................................................................................... 43
WAC Control................................................................................................................................. 43
WAC Takeover.............................................................................................................................. 44
WAC Reconnected.........................................................................................................................45
WAC Abort.................................................................................................................................... 46
WAC Port...................................................................................................................................... 47
WAC Term.................................................................................................................................... 47
WAC Start | Stop | Restart.............................................................................................................. 48
WAC disable | enable Telnet | SSH | Serial..................................................................................... 49
WAC SendFile............................................................................................................................... 49
WAC Shutdown | Reboot................................................................................................................ 50
WAC Password............................................................................................................................. 51
WAC SSHKey................................................................................................................................ 51
WAC Userkey................................................................................................................................ 52
CHAPTER FIVE..................................................................................................................................54
CONFIGURING WAC SERVER........................................................................................................ 54
ONFIGURATION TOOLS
C
...................................................................................................................... 55
ADVANCED CONFIGURATION FEATURES – AN OVERVIEW.................................................................... 55
Server Global Settings................................................................................................................... 56
User Logon Domain Name (UseDomain).................................................................................................. 56
User Logon Max Retry (MaxLogRetry) ....................................................................................................57
User Logon Timeout (LogonTimeOut)...................................................................................................... 58
User Logon Banner (LogonBanner) ..........................................................................................................58
Global Agent Redirection (AgentRedirection)...........................................................................................59
Session Tick for Terminal Update (SessionTick).......................................................................................60
Telnet Service (EnableTelnet)................................................................................................................... 60
Telnet Port (TelnetPort)............................................................................................................................61
SSH Service (EnableSSH)........................................................................................................................62
SSH Port (SSHPort) .................................................................................................................................63
Serial Port Service (EnableComm)............................................................................................................63
Serial Port List (CommPortList)................................................................................................................64
File Transfer (FileTransfer)....................................................................................................................... 65
Global SFTP Service (EnableSFTP).......................................................................................................... 65
Anonymous Access to SFTP Service......................................................................................................... 66
LPT Port for Client Side Printing (LTPPort)..............................................................................................67
Log Mask for WAC Event Logging (LogMask).........................................................................................68
Log Path for WAC Log File (LogPath)...................................................................................................... 68
User Settings................................................................................................................................. 68
User Preference........................................................................................................................................ 69
User Admin Settings................................................................................................................................. 70
Page 3 of 231
Access Control.............................................................................................................................. 78
User Access Control.................................................................................................................................78
Host Access Control.................................................................................................................................82
SSH Settings.................................................................................................................................. 84
SSH Server Key Regeneration..................................................................................................................85
User Public Key Authentication................................................................................................................ 86
SFTP Service........................................................................................................................................... 91
Port Forwarding....................................................................................................................................... 92
Serial Port Settings........................................................................................................................ 94
Enable the Serial Port Service (EnableComm)...........................................................................................95
Specify the Serial Port List (CommPortList).............................................................................................. 95
Set the Communication Parameters........................................................................................................... 96
Notes and Tips.........................................................................................................................................96
EFERENCES
R
...................................................................................................................................... 97
WAC Event Logging...................................................................................................................... 97
Define Log Mask (LogMask).................................................................................................................... 97
View Log File..........................................................................................................................................99
Change Log File Path (LogPath)............................................................................................................... 99
Client Side Printing..................................................................................................................... 100
Server Side Setup................................................................................................................................... 100
Client Side Setup.................................................................................................................................... 101
Troubleshooting..................................................................................................................................... 101
WAC Protected Shell................................................................................................................... 102
Introduction............................................................................................................................................ 102
Define Pshell Files..................................................................................................................................103
Use Pshell.............................................................................................................................................. 104
WAC Manager............................................................................................................................. 106
WAC Server Status ................................................................................................................................ 106
Server Global Settings............................................................................................................................ 108
More Server Settings.............................................................................................................................. 109
SSH Settings.......................................................................................................................................... 110
Serial Port Settings................................................................................................................................. 112
User Access Control...............................................................................................................................113
User Admin Settings............................................................................................................................... 115
User Preference...................................................................................................................................... 118
Host Access Control...............................................................................................................................119
Session Manager .................................................................................................................................... 121
CONFIG.EXE............................................................................................................................. 122
PART TWO – WAC NATIVE CLIENTS............................................................................................. 124
CHPATER SIX................................................................................................................................... 125
WAC NATIVE CLIENTS................................................................................................................... 125
ESCRIPTION
D
I
NSTALLATION
.................................................................................................................................... 126
.................................................................................................................................. 126
CHAPTER SEVEN............................................................................................................................ 127
GETTING STARTED......................................................................................................................... 127
REPARATORY WORK
P
....................................................................................................................... 128
Enable the Mouse Support........................................................................................................... 128
Change the Terminal Size............................................................................................................ 131
S
TARTING
… ..................................................................................................................................... 135
Establishing a Connection........................................................................................................... 135
Logging In................................................................................................................................... 135
After Logging In.......................................................................................................................... 137
Logging Out................................................................................................................................ 138
CHAPTER EIGHTE.......................................................................................................................... 139
Page 4 of 231
WAC CLIENT COMMAND LINE UTILITIES................................................................................... 139
“ HELP” --- Help Information...................................................................................................... 140
“ CD” --- Change Remote Directory............................................................................................ 140
“ LCD” ---- Change Remote Directory......................................................................................... 141
“ SEND” ---- Send Local Files to Remote Host............................................................................. 141
"FWDLOCAL" ----Local Port Forwarding (wacssh only)............................................................. 142
"FWDREMOTE" ---- Remote Port Forwarding (wacssh only)...................................................... 142
"PRINT" ---- WAC Client Side Printing....................................................................................... 143
"QUIT" ---- Quit the Client Program........................................................................................... 143
PART THREE – WAC TOOLKIT....................................................................................................... 145
CHAPTER NINE................................................................................................................................ 146
INTRODUCTION TO WAC TOOLKIT............................................................................................. 146
ESCRIPTION
D
F
EATURES
WAC T
AYS TO LAUNCH
W
.................................................................................................................................... 147
........................................................................................................................................ 147
OOLKIT LISTS
....................................................................................................................... 148
WAC T
OOLS
....................................................................................................... 149
Within a WAC session.................................................................................................................. 149
On the server machine................................................................................................................. 150
I
NSTALLATION
.................................................................................................................................. 150
CHAPTER TEN................................................................................................................................. 152
USING WAC TOOLKIT..................................................................................................................... 152
T
EXT EDITOR
................................................................................................................................... 153
Figure 10-1 Screen Snapshot....................................................................................................... 153
Using Text Editor........................................................................................................................ 153
File Menu............................................................................................................................................... 153
Edit Menu:............................................................................................................................................. 154
Search Menu..........................................................................................................................................155
Options Menu........................................................................................................................................156
Help Menu............................................................................................................................................. 157
B
INARY EDITOR
............................................................................................................................... 159
Figure 10-2 Screen Snapshot....................................................................................................... 159
Using Binary Editor.................................................................................................................... 159
File Menu............................................................................................................................................... 159
Edit Menu.............................................................................................................................................. 160
Search Menu..........................................................................................................................................161
Options Menu........................................................................................................................................162
Help Menu............................................................................................................................................. 163
WAC E
XPLORER
.............................................................................................................................. 164
Figure 10-3 Screen Snapshot....................................................................................................... 164
Using WAC Explorer................................................................................................................... 164
To create a new file or folder.................................................................................................................. 164
To delete a file or folder.......................................................................................................................... 165
To change the name of a file or folder.....................................................................................................166
To send files to terminal window ............................................................................................................ 166
To display file or folder attributes ...........................................................................................................167
To copy or move a file or folder.............................................................................................................. 167
To move files by dragging......................................................................................................................168
To Search for a file or folder................................................................................................................... 168
To show and hide the address bar............................................................................................................ 170
To show and hide the folder bar.............................................................................................................. 170
To show and hide the folder bar.............................................................................................................. 170
To crosscut to another directory.............................................................................................................. 171
To refresh contents in your screen........................................................................................................... 171
To add items to favorites......................................................................................................................... 171
Page 5 of 231
To map network driver........................................................................................................................... 172
To choose color for your window............................................................................................................173
WAC Explorer Keyboard shortcuts References ....................................................................................... 173
MAIL INBOX
E
................................................................................................................................... 175
Using WAC Email Inbox.............................................................................................................. 176
To read your mail messages.................................................................................................................... 176
To create and send new mails.................................................................................................................. 176
To reply and forward mail messages ....................................................................................................... 177
To view and save file attachments........................................................................................................... 178
To insert items into mail messages.......................................................................................................... 179
To insert items into mail messages.......................................................................................................... 179
To delete mail messages from the message list........................................................................................ 180
To search the particular emails................................................................................................................181
To change color for your Inbox screen.................................................................................................... 181
WAC P
HONE
.................................................................................................................................... 183
Figure 10 - Screen Snapshot........................................................................................................ 183
Using WAC Phone....................................................................................................................... 184
S
ESSION MANAGER
.......................................................................................................................... 187
Figure 10 - Screen Snapshot........................................................................................................ 187
Using Session Manager............................................................................................................... 188
To describe session header...................................................................................................................... 188
To send message to the specific user.......................................................................................................189
To Broadcasting message to all users......................................................................................................189
To watch other user's session screen........................................................................................................190
To control other user's session screen...................................................................................................... 190
To take over other user's session screen................................................................................................... 191
To reconnect to other user's session screen.............................................................................................. 191
To abort other user's session.................................................................................................................... 191
P
ROCESS VIEWER
............................................................................................................................. 193
Figure 10 - Screen Snapshot........................................................................................................ 193
Using Process Viewer.................................................................................................................. 193
To describe process header.....................................................................................................................193
To sort the list of processes..................................................................................................................... 194
To update the processes data................................................................................................................... 194
To end a process..................................................................................................................................... 194
ERVICE MANAGER
S
.......................................................................................................................... 196
Figure 10 - Screen Snapshot........................................................................................................ 196
Using Process Viewer.................................................................................................................. 196
To describe session headers.................................................................................................................... 196
To start, stop, pause, resume, restart, or delete a service........................................................................... 197
To change the startup type......................................................................................................................197
To view service dependencies................................................................................................................. 198
To create custom names and descriptions for the services........................................................................ 199
To set up recovery actions if a service fails.............................................................................................. 199
To log on to a remote computer...............................................................................................................200
E
VENT VIEWER
................................................................................................................................ 202
Figure 10 - Screen Snapshot........................................................................................................ 202
Using Event Viewer..................................................................................................................... 203
To refresh an event log...........................................................................................................................203
To view more details about an event ....................................................................................................... 203
To view more details about an event ....................................................................................................... 204
To clear an event log .............................................................................................................................. 204
To archive an event log........................................................................................................................... 205
To open an archived event log................................................................................................................. 206
To export event log list........................................................................................................................... 206
To specify a sort order in an event log..................................................................................................... 207
To set event logging options ................................................................................................................... 207
To use the security log............................................................................................................................208
EGISTRY EDITOR
R
............................................................................................................................ 209
Figure 10 - Screen Snapshot........................................................................................................ 209
Page 6 of 231
Using Registry Editor.................................................................................................................. 209
To describe key and value....................................................................................................................... 209
To Change keys and values..................................................................................................................... 210
To import and export the registry file..................................................................................................... 213
SER MANAGER
U
............................................................................................................................... 216
Figure 10 - Screen Snapshot........................................................................................................ 216
Using User Manager................................................................................................................... 217
Create and modify user accounts............................................................................................................. 217
Create and modify user groups................................................................................................................220
YSTEM INFORMATION
S
..................................................................................................................... 224
Figure 10 - Screen Snapshot........................................................................................................ 224
Using System Information............................................................................................................ 224
To view system information.................................................................................................................... 224
To view devices list................................................................................................................................225
APPENDIXES.................................................................................................................................... 226
A
PPENDIX A: PROGRAM LICENSE AGREEMENT
PPENDIX B: CODE SEQUENCES
A
A
PPENDIX C: PROGRAM AND EXECUTIVE NAME CONTRAST
........................................................................................................ 229
.................................................................................. 226
............................................................... 231
Page 7 of 231
About This Manual
The information in this manual is organized in three parts that again is organized in ten
chapters, and on the entry page of each part and chapter, a general description is provided
for quickly catch on the contents.
Part 1 -- WAC Server – contains five chapters providing description to WAC Server and
describing how to install, get started, work with and configure WAC Server.
If you want to get started without having to read everything,
Skip directly to the introduction in Chapter One and read the section “ WAC
x
Session Agent” , “ WAC Server Service” and “ How WAC Sever Works” .
Then Skip to Chapter Three for tips on getting started. You can choose the section
x
to read based on the client you are using. If you are using WAC Native Client,
read the section “ Connecting Using WAC Native Clients” or “ Chapter Seven” in
Part Two.
If you want to quickly familiarize yourself with the WAC Configurations without having
to read everything,
x
Skip directly to the Chapter Five for overview of the Configuration Tools and
“ Advanced Configuration Features – An Overview” .
If you want to quickly know what you can do after logging to WAC Server without
having to read everything,
x
Skip directly to the “ Chapter Seven” in Part Two and read the session “ After
Logging In” .
Alternatively, you can also scan through the “ Chapter Four – Working with WAC
x
Server” .
Part 2 -- WAC Native Clients – contains three chapters providing introduction to the
native clients and its installation, describing how to use the native client to access server
and use its command options
Part 3 – WAC Toolkit – contains two chapters providing introduction to WAC textbased applications and providing step-by-step information for using the Toolkit.
If you want to know what is WAC Toolkit and how to install it without having to read
everything,
x
Skip directly to Chapter Nine and read the section “ WAC Toolkit Lists” , and then
the “ Installation” .
Page 8 of 231
Use the Index and Table of Contents for help on specific topics when you don’ t have time
to read through the chapters.
Page 9 of 231
Part One --- WAC Server
WAC Server, a Windows Access Server, can put you at the host
computer through three access methods, and enable you to do
remote administration with its great toolkit and build-in command
line utilities.
This part covers:
x
Chapter One, “ Introduction to WAC Server” provides the
general description about WAC Server, introduces its
interactive session agent, its service, and how it works.
Chapter Two, “ Installation” provides information about
x
step-by step setup procedures including the software’ s
upgrade and re-setup, and the system changes.
Chapter Three, “ Getting Started” provides information
x
about getting connected by using the WAC native clients
and the third party clients, and the user public key
authentication method.
x
Chapter Four, “ Working with WAC Server” provides
information about all kinds of utilities that you can use to
work during an interactive WAC Session.
x
Chapter Five, “ Configuring WAC Server” provides
information about configuration tools and the advanced
configuration features including Server Global Settings,
User Settings, Access Control, SSH Settings, and Serial
Port Setting. Besides, a “ Reference” section is also attached
to this chapter for a supplement to the “ Advanced
Configuration Features” section.
Page 10 of 231
CHAPTER ONE
Introduction to WAC Server
This chapter contains the following four sections:
x The “ WAC Server Description” section simply describes WAC Server and
applications that come with it.
x The “ WAC Session Agent” section introduces the two methods of WAC session
agent to monitor the session as well as the side effect and advantages.
x The “ WAC Server Service” section introduces the WAC service and provides several
ways to start or restart WAC service.
x The “ How WAC Server Works” section describes the three steps to make WAC
server work.
Page 11 of 231
WAC Server Description
Congratulations. You choose Windows Access (WAC) Server. It is a brainchild of Foxit
Software Company.
WAC Server is a combined Windows NT 4.0/2000/XP server, integrating the telnet, ssh
and terminal server. The WAC Sever allows the client users to remotely access the Server
machine just as if they were the local users. Using ANY telnet, ssh and terminal client
program, users can login to the Server Machine.
The Server machine should be the Windows NT 4.0/2000/XP machine on which WAC
Server has been installed. And it can be anywhere on the Internet or in your local network
or in the serial cable.
In addition, WAC Server offers a gallery of text-based console applications and
Command Line Tools that are great helper facilitating you to remotely work on the
Server machine. And it also ships with two free native client programs that are used to
access Server machine and thus establish a WAC client-server talk environment.
Often while you are working in WAC talk environment, and do administration under the
help of WAC console applications, you forgot that you are working on the Server
Machine.
WAC Session Agent
A WAC session between client and server is created each time a connection is established.
For each WAC session, WAC Server makes use of a special session agent,
WACSES.EXE, which monitors the user activities, the keyboard/mouse input, and the
screen output for each of the user sessions. This session agent uses two types of
technologies to monitor the application outputs:
1. The session agent goes directly to the screen buffer of the user session and ready
content, if it finds anything changed, the change will be packaged according to the
transportation protocol and terminal type, and sent to the terminal;
2. The session agent can build a special communication instrument, called "pipe" and
redirect the application's output to that pipe, so when the application wants to write
something onto the screen, it actually goes to the pipe. At the other end of the pipe,
there sits the session agent, which interprets the output and does the actual screen
modification for the application, and at the same time it also packages and sends the
change to the terminal.
The WAC session agent can use those two methods at the same time, but the second
method has some side effect and some advantage too:
Page 12 of 231
1. Some applications don't act the right way when their output got redirected. For
example, sometimes the output disappears because it's got buffered in the memory,
also sometimes user input got affected too;
2. On the other hand, some application relies on redirection to work. Your application
might send out some special characters to the terminal and want it to perform some
special action instead of displaying it. In this case we can't detect any modification to
the screen, so the first change-detection monitoring doesn't work in this case. A very
common example is the BEL character, which is never been displayed but causes the
terminal to beep. If you disable the session agent redirection, you will never hear that
sound.
For the side effect and advantage, WAC Server introduces a configurable setting called
“ AgentRedirect” . The capacity of this configurable setting exists to enable or disable
WAC session out agent redirection, furthest optimizing you screen.
In addition, the configurable setting “ Session Tick” exists to help update the terminal,
and the “ Keep Session” exists to help specify the period for keeping a broken session so
that after that period the broken session can be terminated and make available to other
users.
For more information, please see Chapter Five – Server Global Settings - “ Global Agent
Redirection” , “ Session Tick for Terminal Update” and User Admin Settings - “ Session
Broken Keeper” .
WAC Server Service
The WAC Server is built as an NT service, which means it will be running on the
background, and by default, WAC Server will be automatically started whenever you
start the machine.
The service name for WAC Server is, quite naturally, "Foxit WAC Server". And since it's
a service, so like any other Windows NT/2000/XP services, you can use the service
utility to start and stop WAC Server, changing the startup type (whether to automatically
start the service when machine startup), etc.
WAC Service can be started and stopped in the following ways:
1. From the Windows Services
On your server machine, go to "Start/Control Panel/Administrative Tools/Services",
scroll down the list or just press "F" letter for several times and you will find "Foxit
WAC Server". Then click the Start or Stop button to execute the task. Select whether
WAC Service will start automatically or manually, double click "Foxit WAC Server"
and select Automatic or Manual from the Start type combo box.
2. From the Command Line
Page 13 of 231
x To stop the WAC service, at the command line, type "WAC STOP"
x To start the WAC Service, at the command line type "WAC START"
x To restart the WAC Service, at the command line type "WAC RESTART"
3. From the WAC Service Manager (svcma.exe)
WAC Service Manager, it performs the same functionalities as the Windows Services,
except it's a text-based application, so when you logon remotely using a terminal, you
should use the WAC Service Manager. To run it, at the command line, type
"SVCMAN.EXE" and press ENTER.
4. From the GUI CONFIG Program --- WAC Manager (wacma.exe)
Run WAC Manager, on the WAC Server Status page, click on the WAC Server Stop,
WAC Server Restart, or WA Server Start.
NOTE: Stopping and restarting WAC service will disconnect all users from the server.
How WAC Server works
Use WAC Server is as easy as 1-2-3.
Installation Set up WAC Server on your host computer of Widows systems. The setup is
easy and fast, and an extra client and tool program will be installed into your computer at
the same time. For more, see Chapter Two Installation.
Access Remotely access your host computer with a client from any workstation and PC
with network connection, or terminal with serial communication cable. For more, see
Chapter Three Getting Started
Working Begin working on your host machine as if you were sitting in front of it by
using WAC tools. You can instantly access to all its data and resources such as email,
applications, documents and even network resources. For more, see Chapter Four
Working with WAC Server.
Page 14 of 231
CHAPTER TWO
Installation
This chapter contains the following five sections:
x The “ Procedure One” section introduces the preparative work before setting up WAC
Server, -- that is how to load CD to your CD ROM or download WAC software from
the website and crate the temporary directory for it.
x The “ Procedure Two” section introduces the step-by-step process of setting up WAC
Server installation.
x The “ Express Upgrade, Update or Re-setup” introduces ways to update the WAC
Server.
x The “ Setup Affection” section introduces the system change on your host machine
after installing WAC Server.
x The “ Uninstall” section introduces the WAC Server un-installation.
Page 15 of 231
Procedure One -- Load CD or download the software
WAC Sever package is distributed through both CD pack and Web Sever.
If you have WAC Server CD pack available, following the three steps below then skip to
Procedure Two:
1. Load WAC Server CD into your computer's CD - ROM drive.
2. If the WAC Server installation program doesn't start automatically, choose Start >
Run. Click “ Browse” and choose the “ Setup.exe” file on the WAC Server CD.
3. Click OK in the Run dialog box.
The software can be downloaded from Web Server, and stored into a temporary directory
on your hard disc. The file you downloaded is zip package (WAC.ZIP), you need to
unzip the package in the temporary directory. Follow these steps:
1. Create a temporary directory on your hard disk drive. Name it anything, such as
C:\WACSETUP.
2. Download the file from the Web into C:\WACSETUP.
3. Unzip into C:\WACSETUP the package (WAC.ZIP) that gets you all the files you
need to install WAC Server.
4. Run one of the unzipped files SETUP.EXE, and follow the steps of the onscreen
instructions that will be introduced in the Procedure Two.
NOTES:
x You can remove the unzipped files from the temporary directory after successfully
installed the WAC Server.
x Before proceed the setup program, all windows running programs should be closed to
avoid conflict or errors.
x To be sure the computer you are installing is the one you want to remotely control.
Procedure Two -- Setup the Software
To complete WAC Server setup, you will be going on the following excursions:
1.
Welcome Screen
welcome screen, click "Next" to continue. If you want to read the Readme.txt, click
"About"
2.
License Agreement
is common for nearly all software. Only after you click "I agree" button to grant your
acceptance can you continue to install.
Microsoft Telnet Service Stop
3.
program will continue its way. Whereas you are recommended to choose “ Yes” , for
-- After run the SETUP.EXE program, you should be greeted with a
-- What you are seeing is WAC Server License Agreement. This
-- No matter you choose "Yes" or "No" the Setup
Page 16 of 231
the running MS Telnet service may collide with WAC Server telnet service. If choose
“ No” , you will get an alert message, just click “ OK” to proceed.
NOTES:
x You don’ t experience this step if the Microsoft Telnet service was disabled ahead
of time on your computer.
x If you hope to remain both Telnet service and WAC Server Telnet service running
at the same time, you need to change WAC Server telnet port at the later process.
x Click here for instructions of MS Telnet service and WAC Server Telnet service
Destination Folder Select
4.
-- Before copying files into your computer, the Setup
program will provide a chance for you to select the location. The default folder is "C:\
Program Files\ WAC".
Grant the default location, click "Next" to continue. If not previously specify a WAC
folder in your computer, you will get a waning message, just click "Yes" to
automatically create the folder in your computer and proceed installing. Click "No"
to go back and change the destination folder.
To change the default location, click "Browse" button to bring about "Browse for
Folder" box. In the box, select the folder you want and click "OK", then click "Next"
to continue the setup in the selected folder.
5.
LPT Port CONFIG
-- This step is serving for you to configure the LPT port for client
side printing.
6.
Telnet/ SSH / COM Port CONFIG
-- This step is provided for you to configure the
Telnet and SSH port number as well as Serial ports. The default port number for
telnet is "23" and for SSH is "22". Click "Next" after specify the ports.
In this step, if WAC Setup program detects the Telnet port or SSH port you
specified was already occupied by other services, then when you click "Next" you
will be prompted to change the port number with a pop-up message. If you just like
to use the present port anyway, click "Yes" on the message, if you like to specify
another port, click No", then you have to try other port number like "24, 40, 80...".
NOTE:
At a later day, if you want to change these port numbers, you can use
WAC CONFIG tools -- WACMAN.EXE and WAC CONFIG.EXE to do the
changing.
7.
Succeeded Screen
-- Up to now, all the required information for WAC Server Setup
has been collected and installed. Just click the "Finish" button to complete the
installation when you see the Setup successful notification screen.
Page 17 of 231
8.
WAC Manager
-- Congratulations, you have now accomplished your WAC Server
setup excursions and are ready to start using it.
Now you should see a pop-up GUI window, this is one of WAC CONFIG tools -WAC Manager, almost WAC Server settings are completed here. Before start a
connection with WAC Server, just use this program to configure WAC server by
clicking the setting category index on the left side pane.
Express Upgrade, Update or Re-setup
In case you want to update the installation or resume from a cancelled or failed
installation, you can run the SETUP.EXE program and go on the setup procedure again,
and again if needed.
x If you just want to expressly upgrade WAC Server using existing settings, run
SETUP.EXE, and press "Express Update" button update WAC Server.
x If you just want to update WAC Server with some port numbers changing, run
SETUP.EXE, and click "Next" button to go to the page that contains "Update" button,
press that button to continue your update process.
x If you just want to install WAC Server into a new place, run SETUP.EXE, and click
"Next" to go to the page that contains "Re-setup button", press that button to continue
your re-setup process. And after successfully reinstalled, you can remove those
installed files in previous installation directory.
Setup Affection
The following is a list of what the WAC Server setup will affect your system:
1. A installation directory will be created for you if not previous existing, this directory
is specified by user during installation;
2. WAC Server executable and WAC applications are copied to this installation
directory;
3. A "Program Group" called "Foxit WAC Server" is created, it includes two shortcuts,
the first is Uninstall, and the second is WAC Server Manager. And the WAC Server
Manager was automatically created at desktop as a shortcut;
4. A special print port called "WAC:" (
a special printer "WAC_PRINTER" (Fig.2) appears in your available printer lists if you
have installed "Generic / Text Only" driver on your computer;
Fig.1
) appears in your available printer ports. And
Page 18 of 231
Fig.1
Fig.2
5. A registry key is created as" HKEY_LOCAL_MACHINE\Software\ Foxit
Software\WAC Server"(
Fig.3
), all WAC Server configurations are kept under this key.
Page 19 of 231
Fig.3
6. A file named "pubkey.txt" is generated in the installation directory, it contains the
SSH server public key, you should export this file to your SSH clients if you want
them to verify the server;
7. A service named "Foxit WAC Server" will be created if not previously existing. This
service will be set to "Auto" start which means the WAC Server will be started
automatically when system restart;
8. The "Telnet" service (Microsoft's telnet server) will be stopped, and disabled so it
won't get started when system restart (if you still want to keep Microsoft telnet server,
you should change the WAC Server's telnet port, and manually re-enable the
Microsoft telnet service);
9. The WAC installation directory is added to the system path.
Uninstall
To remove WAC Server from your system, simply click Start, and go to Programs, find
the Foxit WAC Server line, and run the UNINSTALL.EXE file. It will undo all the
changes made by the installation process, except the Microsoft Telnet Server will stay
disabled, if you want to enable it, go ahead and use the Windows Service Manager.
Page 20 of 231
CHAPTER THREE
Getting Started
To access WAC Server, you can use WAC Native Clients, or Other 3rd party clients. And
even you can authenticate yourself by using user public key over other compliant SSH
clients.
This chapter contains the following three sections:
x The “ Connecting Using WAC Native Clients” section briefly introduces ways to open
WAC Native Clients to connect with WAC Server. Details of this section are
provided in Chapter Seven of Part Two – WAC Native Clients.
x The “ Connecting Using Other 3rd party Client” section introduces some notices when
using 3rd party clients like terminal settings, screen size adjustment.
x The “ Authenticating Using User Public Key” section briefly introduces how to
authenticate to WAC Server using the compliant SSH client. Details of this section
are provides in Chapter Five – User Public Key Authentication.
Page 21 of 231
Connecting Using WAC Native Clients
Follow the following instructions to open WAC Native Client Window.
x On the local server machine, you can open the client window from the Run line, the
command prompt or the icon in the WAC Server installation directory.
For example, from the Run line, click Start, click Run, in the Open line, input
"wacterm <IP Add or Host Name> or wacssh <IP Add or Host Name>", and click Ok.
If you are connecting to the local host, on the Run line, simply type "wacterm
localhost or wacssh localhost ".
At this point, WAC Client window is open with being connected, and you get WAC
Server logon banner such as welcome text, evaluation number and host information,
and the prompt for username and password to login.
x On the remote client machine, you can open the client window by directly clicking
the WAC Client desktop shortcut icon.
At this point, WAC Client Windows is open with prompt for the IP address or host name
of the machine you are connecting to.
For further information about connecting using WAC Native Client, see “ WAC Native
Clients -- Getting Started” .
Connecting Using Other 3rd Party Client
To connect to WAC Sever using 3rd party client, you might need to make adjustments to
some of the settings (like "terminal settings or size") of your client programs to get the
best result.
Adjust Terminal Settings
In this section we will be discussing some settings on “ VTNT” , “ Other terminals” , and
“ Keyboard mapping.
VTNT
An alternative client is Microsoft's telnet client for Windows 2000 and later. If you are
not running Windows 2000/XP on your client machine, you can actually copy the
TELNET.EXE file from a Windows 2000 machine and try to run it on your other
Page 22 of 231
Windows platform. This telnet client supports a special terminal type called VTNT,
which is defined by Microsoft and supported by WAC Server.
VTNT takes full advantages of PC keyboard and output attributes, but it doesn't support
mouse operations, is not quite convenient for all those WAC applications.
There are some other terminal products on the market that support VTNT terminal too.
Other Terminals
If you use clients other than WAC Native Clients or VTNT, make sure your terminal is
set to DEC-VT compatible mode, or ANSI compatible mode. Please note: some terminals
claim to be DEC-VT compatible or ANSI compatible, they are actually not. So if you
experience some problems like messy screen or input inconsistency, you should take a
look at the settings of those terminals, or use another better terminal program, like
KoalaTerm from Foxit. (http://www.Foxitsoftware.com/download.htm)
The character set of the terminal, if possible, should be set to "MS-DOS" or "IBM-PC"
character set, which will allow you to display most of the special characters in the
Windows console screen.
If your terminal support mouse, please set it to DEC compatible mode so the mouse
movement and click events can be correctly sent to the server applications.
The recommended minimum terminal screen size is 80x25, which will allow you to run
most of the console applications without program. WAC applications support larger
terminal size too.
Keyboard Mapping
If your terminals other than WAC Native Clients or VTNT, you need to carefully set your
keyboard mapping if you want to make use of special function keys and key
combinations like ALT-keys.
Keyboard mapping means you can change the settings in your terminal program so when
you press certain key or key combination at the terminal, some code sequence will be
sent to the server.
You have to set the keyboard mapping of your terminal in such a way that the code
sequences can be recognized by WAC Server so your server application gets the correct
keyboard code information.
For a list of code sequences recognized by WAC Server (equivalents of VT terminal keys
are also listed), see Appendix B.
Page 23 of 231
Resize terminal screen
While standard size for DOS command prompt is 25 lines and 80 characters per line, and
that's suitable for most of the case, you might found this standard size needs to be
changed sometimes.
You might think your screen should display more contents and of course, your monitor is
large enough to hold a large window, then you can increase the terminal size of your
WAC session.
WAC Server detects the terminal size when the session is connected, therefore, you need
to re-logon if you want to use another terminal size.
If you use a serial terminal to connect with WAC Server, there is no way for WAC Server
to automatically detect the terminal screen size, so WAC Server assume all terminals
connected through serial ports have the size of 80x24 which is the default size of VT
serial terminals. If your terminal actually has a different screen size, you have to tell the
server about it, using the following command:
WAC term [<port name>] [Width=<Mw>] [Height=<ah>]
For example:
WAC term COM1 width=80 height=25
NOTE: You have to log out from the port and re-logon again to make the new size
effective.
Authenticating Using User Public Key
Except the username/password authorization, WAC Server also supports public key
authentication for SSH2. If you want to use public key to logon, you need to do the
followings:
x Generate a public/private key pair using the generation utility of your SSH client
program (WACSSH client doesn't support user public key authentication, so you have
to use other SSH 3rd client to do this.);
x Copy the public key file to server, and on the server machine, execute "wac userkey
add <filename> <username>" command to add the key file to server accepted public
key list;
When logon, choose the private key in the client program.
Page 24 of 231
The first time logon using public key will always be rejected, unless you the user doesn't
have a password. You need to input the server's password for the user. Once the password
accepted, you won't need to input password again.
NOTES:
x Please note some clients might have bugs with the standards, if you experience
problem with third party clients, please change the SSH version or cipher algorithm
settings and try again.
x For more detailed information, see “ User Public Key Authentication” .
Page 25 of 231
CHAPTER FOUR
Working with WAC Server
This chapter contains the following nine sections:
The “ Managing Sessions” section introduces the command line utilities and console tool
that can be used to manage the session, and described what operations you do in an
interactive session with those utilities.
x The “ Managing Services” section introduces the command line utilities and console
tool that can be used to manage the session and briefly described what you can do
with those service utilities.
x The “ Managing User and Group” section introduces the console application that can
be used to manage the user and group on the remote host machine, and provides some
tips on for the XP system users.
x The “ Managing System Tools” section introduces some tools that facilitate your
remotely managing the host system, like “ Event Viewer” , “ System Information” ,
“ Process Viewer” and “ Registry Editor” .
x The “ Managing Files” section introduces some tools that facilitate your remotely
managing files and resources on the host machine, like “ Text Editor” , “ Binary Editor”
and “ WAC Explorer” .
x The “ Checking Mails” section introduces a tool that facilitates your remotely
checking and composing outlook inbox mails on the host machine, like “ WAC
Inbox” .
x The “ Chatting” section introduces a tool that facilitates your starting an instant chat
dialog with the online current users during a session.
x The “ File Transfer” section introduces on “ file transfer server side configuration” ,
“ file directories” and “ sending files with three WAC tools” .
x The “ WAC Command Line Utilities” section provides detailed introductions to all
WAC command line utilities and their usage.
Page 26 of 231
Managing Sessions
Each log-on connection is called a "session" in WAC Server. The maximum number of
concurrent session allowed in a WAC Server is determined by the license number you
purchased. For evaluation users, maximum 2 sessions can be logged onto the server at the
same time.
You can view and change the other session information using the WAC session
management utilities. To manage the sessions, you must be a member of the server's
administrator’ s group. Otherwise you can only do something on your own session(s).
Session Managing Utilities
In a WAC Server session, users in the administrator’ s group can perform many useful
tasks with session managing utilities, including a full-screen console application "Session
Manager" and a handful of command line Utilities
x The "Session Manager", a text-based application, displays the current users and
provides methods to watch, control, take over, reconnect to and abort a session, to
send messages or broadcast system messages to users. To run it from the command
line, type SesMan and press Enter. See WAC Toolkit – “ Session Manager” in Part
Three.
x The command line utilities including "wac who", "wac whoami ", " wac send", " wac
watch” , “ wac control” , “ wac takeover” , and "wac abort". These command tools serve
for you to manage the sessions from the command prompt. See Chapter Six Command Line Utilities in Part Two.
For what you can do with these session utilities, See “ Session Inter-operations” section
below.
Session Inter-Operations
There are a lot of things can be done between WAC Server user sessions. In this section,
we just succinctly guide you through the session inter-operation. If you want the detailed
how-to instructions, you need to refer to their respective help documents.
Page 27 of 231
Session Info View
WAC Server provides a mechanism for users to view and observe all current active user
sessions. The session Info contains the “ Session ID” , the “ Username” , the “ Port Type” ,
the “ IP Address” , the “ Term” (client name), and the “ Connection Start Time” .
View All Current Active Sessions Info
x When you start “ Session Manager” , you will see a list of all current sessions, when
there are new sessions and session terminated late, the list will automatically updated
with highlighting flicker.
x At the command line, you can use "wac who" to get a list of all current sessions.
View Your Current Active Session Info
x At command line, you can use "wac whoami" to get information about the session
you are currently working in.
Alert messages
WAC Server provides a mechanism for users to post short messages to other session(s).
The message will pop up on the other session's screen, and the screen will be frozen until
the user press any key to dismiss the message and return to normal screen.
You can post the message to a particular session or all sessions under a particular user, or
broadcast messages to all active sessions (yourself will get that message too!).
Post Message to Particular Session
x In "Session Manager", select the session you want to post message to, and select
Message button.
x At the command line, you can use "wac send <session id> <message>” command to
send message to the session under this session ID. Or use “ wac send <username>
<message>” to send message to the session(s) under this username.
Page 28 of 231
Broadcast Message to All Sessions
x In "Session Manager", select the session you want to post message to, and select
Broadcast to send message to everyone.
x At the command line, you can use "wac send all" command to send messages to
everyone.
Session Watch
WAC Server provides a mechanism for authorized users to watch, control, take over, and
reconnect to other session's screen. You have to be a member in the administrator’ s group
to do this. Also you can always watch the session under the same user name as yours.
Session watch features are very helpful if you want to monitor remote sessions, or do
remote demonstration. They also are great powerful training/ QA tool
Monitor Other Session
When the screen of another session is monitored, the output of the watched session will
appear on both watched session and watcher session. More than one watcher can watch
the session at the same time
In “ Session Manager” , select the session you want to watch, and select Watch
x
button, to end the watch state, press Enter key.
x
At the command line, you can use “ wac watch <session id> |<username>” command
to watch, press Enter key to end watch.
NOTES:
x In WAC Server, you can use “ User Admin Settings” in WAC configuration tools to
configure a particular user or user group to monitor your session (See Chapter Five “ Specify the Watching Users” ).
x You can't monitor the session you are currently working on, because that doesn't
make sense.
Control Other Session
When the session is controlled, the session is under interactive input. Both you and the
other side user can enter data into the session. To end the session control, press <ctrl -d>
Page 29 of 231
x In "Session Manager", select the session you want to watch, and select Control
button, to end the control, press <ctrl-d> key.
x
At the command line, you can use "wac control <session id> |<username>"
command to control, press <ctrl-d> key to end control.
NOTES:
x In WAC Server, you can use “ User Admin Settings” in WAC configuration tools to
configure users or user groups to control your session (See Chapter Five - Specify the
Controlling or Takeover Users).
x You can't control the session you are currently working on, because that doesn't make
sense.
Take Over Other Session
When the session is taken over, only you can do the operations on the session, while the
other side session is disabled and not able to enter any data except watching the session.
x In "Session Manager", select the session you want to watch, and select Takeover
button, to end the takeover, press <ctrl-d> key.
x At the command line, you can use "wac takeover <session id> |<username>"
command to take over, press <ctrl-d> key to end takeover
NOTES:
x In WAC Server, you can use “ User Admin Settings” in WAC configuration tools to
configure users or user groups to take over your session (See Chapter Five - Specify
the Controlling or Takeover Users).
x You can't take over the session you are currently working on, because that doesn't
make sense.
Reconnect to Session
During watching the session, if needed, you can reconnect to a broken or active session,
and continue work on that session.
When you perform the Reconnect task, your current session is actually terminated, and at
once got reconnect to the session you selected. If it is a broken session you reconnect to,
the broken session will be recovered and appears in your current session. If it is an active
Page 30 of 231
Loading...