Using PowerTerm WebConnect

The PowerTerm WebConnect product is comprised of three major components:

·   PowerTerm Server

·   Java Client

·   Administration Tool

Therefore the activities are broken down to two spheres: server side (which includes PowerTerm Server and Administration Tool) and client side.

 

Administration Tool

 

The Administration Tool manages PowerTerm users, their groups, connections and active PowerTerm sessions. The administrator can create or delete any one of these with the aid of the Administration Tool. He is also able to modify their properties, shutdown active users, groups or sessions. The administrator can monitor and interact with any active session thereby effectively diagnose and solve an end user’s problems.

The Administration Tool main screen has three main sections:

·         Top - lists all the users in the system.

·         Middle - lists all the user groups in the system.

·         Bottom - lists all the host connections available in the system.

 

Using Administration Tool

 

Starting

To start the PowerTerm WebConnect Administration Tool:

A.

1.      Click the Start button in the Windows taskbar.

2.      Point to the Programs icon and select the Ericom Software group.

3.      Select PowerTerm WebConnect versionnumber.

4.      Select the PowerTerm WebConnect Administration Tool submenu item. Administration Tool is launched and the Connect dialog is displayed.

Or

B.

·         Double-click on the PowerTerm Server  or Server Starter’s  tray icon. Administration Tool is launched and the Connect dialog is displayed.

 

Note Only applicable if you are operating on the server’s console.

 

User-name: User’s account name on the PowerTerm Server.

Password: Password for the user you are defining.

Host Name: PowerTerm Server’s host name.

TCP/IP port-number: PowerTerm Server’s port number.

Security Type: Determines whether to employ SSL/SSH in the connection between Administration Tool and PowerTerm Server.

 

SSL

Employs SSL in the connection.

SSH

Employs SSH in the connection.

Unsecured                                   

Does not employ SSL nor SSH in the connection.

 

 

Exiting the PowerTerm WebConnect Administration Tool

·         Choose Action|Exit.

 

Inactivity Timeout

This feature is very useful in a large organization where there is more than one administrator. The system allows only one administration session to be attached to the server at one time. In the circumstance where there is a necessity for administrator intervention and the current administration session is inactive (for example the administrator forgot to disconnect the Administration Tool from the server), a request of another administration tool session can be provided.

The Administration Tool has a request timeout defined in the .INI file, in the entry [Server]AdministratorRequestTimeoutMinutes  (default=10, range 0..60, ZERO means feature disabled). The server marks the Administration Tool as inactive if it is not used for a time interval equal to or greater than the value of this entry (expressed in minutes). 

When the current administrator is inactive, the server will accept any other client that requests to login as administrator. The server issues an appropriate acknowledgement prior to logging off the previous administrator.

 

Configuring PowerTerm WebConnect

 

Modifying the PowerTerm WebConnect Server's Configuration

 

This capability is designed for fine-tuning the server’s activity. It is recommended to exercise caution when modifying the configuration’s attributes because every change is immediately applied.

 

To modify the PowerTerm WebConnect Server's Configuration:

 

1.      Choose Server|Configuration. The Server Configuration dialog appears.

2.      Modify the desired attributes.

3.      Modify connections.

3.

Add a Connection

Select one or more connections to be used by the server from the Unlinked Connections list.

 

Note: The Unlinked Connections list consist of all those connections that have no owner specified.

 


Highlight the desired connection and click on the arrow button.

Or

Select all the connections by clicking on the double arrow button . The desired connection(s) appear in the Server’s Connections list.

 

Delete a Connection

 

Select one or more connections from the Server’s Connections list that the server has no use for.

 

Note: The Server’s Connections list consists of all those connections that are being used by the server.

 

Highlight the desired connection and click on the arrow button.

Or

Select all the connections by clicking on the double arrow button. The desired connections disappear from the Server’s Connections list and appear on the Unlinked Connections list.

 

Note: Standard Windows convention of multiple selections from a list applies here: Hold down Ctrl and select non-consecutive choices; Hold down Shift and select the first and last in a group thus encompassing the whole group.

 

4.       Create or modify Environment Variables. For more information see PowerTerm WebConnect Environment Variables Maintenance.

5.       Click OK upon completion of all modifications to the Server Configuration. The server’s configuration has been modified according to the new attributes.

 

Inactivity Timeout

Auto Refresh

Allow Other

Inactivity

Maximum Sessions 

Default Sessions

Max. Attempts

Disable Timeout

Default Group

BackgroundBmpFileName

Modifying the Server's TCP/IP Address

The default IP address used by the PowerTerm WebConnect components (the server, the starter, the administration tool and the JAVA or ActiveX client) is the first known IP address of the computer where the server runs. However, this default can be modified, as explained below:

 

To modify the server's TCP/IP address:

1.       Set the entry [Server]Address=new-IP-Address found in the configuration file used by the server and starter (the default configuration file name is PtServer.ini Connection_Points).

See also: Alternate Connection Points.

2.       Set the desired value of the applet parameter port in all of the relevant HTML files, using the following syntax:

var sParamServer  = '<param name="server" value="IP-Address">';

 

The JAVA client uses HTML files to start the applet.

Note This feature is necessary when the Web Server and the PowerTerm Server are installed on different machines.

3.       Perform the necessary modification in the HTML that uses the ActiveX component. See also ActiveX's Methods.

4.       You can pass the server’s IP address to the Administration Tool as a command line parameter, using the following syntax:

-host=IP-Address

Therefore you can create a shortcut to the Administration Tool, or modify an existing one, adding your specific IP address as a parameter in the Target field of the Shortcut property page.

Example:

"C:\Program Files\Ericom Software\PowerTerm WebConnect\bin\PtAdmin.exe –host=12.156.6.177"

 

Modifying the Server's TCP/IP Port

The default port used by the PowerTerm WebConnect components (the server, the starter, the Administration Tool and the JAVA and ActiveX client) is 4000. However, this default can be modified, as explained below:

To modify the server's TCP/IP port:

1.        Set the entry [Server]PortNo=new-port-number found in the configuration file used by the server and starter (the default configuration file name is PtServer.ini).

See also: Alternate Connection Points.

2.       Set the desired value of the applet parameter port in all of the relevant HTML files, using the following syntax:

var sParamPort    = '<param name="port"  value="port-number "> ';

The JAVA client uses HTML files to start the applet.

3.       Perform the necessary modification in the HTML that uses the ActiveX component. See also ActiveX's Methods.

4.       You can pass the port number to the Administration Tool as a command line parameter, using the following syntax:

-port=port-number

Therefore you can create a shortcut to the Administration Tool, or modify an existing one, adding your specific IP address as a parameter in the Target field of the Shortcut property page.

 Example:

"C:\Program Files\Ericom Software\PowerTerm WebConnect\bin\PtAdmin.exe –port=778"

 

Alternate Connection Points

The default installation defines the main connection point as the first known IP address of the computer and port 4000. These values are specified in the server’s configuration file (PtServer.ini), in the entries Address and PortNo of the [ConnectionPoint=name] section.

If necessary you can define alternate connection points adding new records in the ConnectionPoints table.

           

 

Example:         [ConnectionPoint=LAN]

 

Address=126.1.1.177

PortNo=7777

SSL-Required=False

LoginRequestTimeoutSeconds=10

EchoTestFrequencySeconds=60

EchoTestTimeoutSeconds=30

KeepAlive=False

UseConnectingMachineName=True

 

Hosting the Server on a Non-Web Server

It is possible to separate the PowerTerm WebConnect server from the Web server. They can exist on two separate computers.

To host the server on a non-web server:

1.   Copy the relevant Internet folders.

Web server is an NT machine

Install the client side.

Web server is a non-NT machine

Copy the folders Ericom\WebConnectversion\Secure and Ericom\ WebConnectversion\NoSSL (installed by default under \InetPub\wwwroot) to the desired Web server.

2.       Set the desired value of the applet parameter server in each of its multiple occurrences in all of the relevant HTML files, using the following syntax:

<param name="server" value="powerterm-java-server-host-name">

 

3.       Set the entry[Server]AttachURL to match the right http address where the applet is located.

This entry is found in the configuration file used by the server and is used for starting attached clients (see Monitoring session). The default file name is PtServer.ini Miscellaneous.

Example:

AttachURL=http://MyWebServer/Ericom/Client/AttachClient.html

PowerTerm Server as NT Service

The PowerTerm Server runs as an NT Service. Using special command line parameters PowerTerm Server can install (/install), uninstall (/uninstall or /uninstall version), and start (/start) itself.

The server's self uninstall capability enables you to specify the version to be uninstalled. If the version is not specified, the current version is used.

 

By default the PowerTerm Server is installed as an NT Service, with Automatic startup type. This means that the service control manager during system startup automatically starts PowerTerm Server.

The Server can be configured to support the STOP NT service event. If the boolean [Server]NTService-AcceptStop entry in the server's configuration file is True, then the server will support the Stop event. By default, STOP is not supported. NTService-AcceptStop is not supplied in the default installation.

 

Setting the PowerTerm Server's Process Priority

To set the PowerTerm Server’s process priority:

·Set the entry

[Server]ProcessPriority=priority-name

 

found in the configuration file used by the server (the default configuration file name is PtServer.ini Miscellaneous).

The supported priority-name values are: Normal, High, Realtime, Default. The meaning of the values Normal, High, Realtime are identical to the Windows NT process priorities. The meaning of Default is dependent on whether the PowerTerm Server is running as NT Service (High) or not (Normal).

 

Administration Tool Parameters

The administrator can configure his own shortcuts to the Administration Tool, adding command line parameters that are listed below:

 

-user=user-name

User’s account name on the PowerTerm Server

-pass=password

User’s password on the PowerTerm Server

-host=hostname

PowerTerm Server’s host name

-port=port-number

PowerTerm Server’s port number

 

All the parameters are optional and their order is not of any consequence.

Example:

“D:\Ericom\PtAdmin.exe -host=117.18.75.89 -port=778 -user="Lee Marshal"

 

Updating the Product License

License modification is typically applicable when:

·   Extending demo version

·   Converting demo version to real version

·    Modifying the number of license seats

 


To modify the product license:

1.       You must run the PowerTerm Server License Update.exe.

Note PowerTerm Server License Update.exe is located in the same folder as the PtServer.exe.

2.       Send the contents of the Key to Send to Ericom field to Ericom, specifying your request.

3.       On receipt of the new key from Ericom, enter it to the Key Received from Ericom field and click Activation Key. The product license is updated.

 

PowerTerm WebConnect Server's Configuration File

SERVER Section

 

Identification

 

Timeouts

 

Quotas

   

Directories

 

Intruders

   

Miscellaneous

 

STARTER Section

 

Auto Restart

 

RestartbyAuthorized

 

CONNECTION POINTS Table

 

The PowerTerm WebConnect Server’s configuration in addition to the SERVER section contains the USERS, GROUPS and USERS-to-GROUPS-LINK tables. It is highly recommended not to modify these tables manually, but rather to use the Administration Tool for this purpose.

 

Customizing the Java Client

 

Modifying the Initial GUI language

To modify the initial GUI language:

1.       Open PTJavaClient.html and search for the following string:

var sParamLanguage= '<param name="lang" value="English">';

2.       In the value tag write another language from the following list of supported languages: Czech, Danish, Dutch, English, Finnish, French, German, Greek, Hungarian, Italian, Norwegian, Polish, Portuguese, Spanish, Swedish and Turkish.

 

Example:

             var sParamLanguage= '<param name="lang" value="German">';

 

The HTML starts the PowerTerm WebConnect Client applet’s GUI text in German.

 

Note The Client for Netscape Communicator only supports English.

 

Modifying the Timezone Offset from Greenwich

To modify  the Timezone Offset:

1.       Open PTJavaClient.html and search for the following string:

var sParamTimeZone= '<param name="zone" value="2">';

2.       In the value tag write offset (in hours) of your time zone.

 

Example:

            var sParamTimeZone= '<param name="zone" value="-5">';

 

The HTML starts the PowerTerm WebConnect Client applet with the –5 time zone (corresponding to the United States Eastern Standard Time).

This modification is necessary in order that the proper times appear in the Printer Jobs List.

 

Disabling Menu Items

To disable menu items:

1.           Open NoSSLClient.html and/or SecureClient.html and search for string

        var sParamDisableMenuItems = '<param name="disable_menu"  value="">';

2.           In the value tag write sequence of numbers mapping the menu items separated by a comma.

The following table maps removable menu items to numbers:

  

 New Terminal Window

1

 Print Properties

2

 Print Job List

3

Edit       

4

Paste from Clipboard

5

Select Screen

6

Clear Screen

7

Reverse Screen

8

Send

9

Terminal Setup

10

Change Password

11

Language             

12

Time Zone Offset

13

GUI Font

14

Example:          

var sParamDisableMenuItems = '<param name="disable_menu"  value="1,3,5,6">';

 

The HTML starts the PowerTerm WebConnect Client applet with the following menu options removed:

New Terminal Window, Print Job List, Paste from Clipboard, Select Screen.