PowerTermreg
WebConnect Version 56
Getting Started PowerTerm WebConnect Enterprise
PowerTerm WebConnect RemoteView
PowerTerm WebConnect DeskView
PowerTerm WebConnect for Oracle VM
PowerTerm WebConnect HostView
PowerTerm WebConnect 2 Getting Started Guide
Legal Notice
This manual is subject to the following conditions and restrictions
bull This Getting Started guide provides documentation for PowerTermreg WebConnect
Your specific product might include only a portion of the features documented in
this manual
bull The proprietary information belonging to Ericomreg Software Ltd is supplied solely for
the purpose of assisting explicitly and property authorized users of PowerTermreg
WebConnect
bull No part of its contents may be used for any purpose disclosed to any person or
firm or reproduced by any means electronic and mechanical without the express
prior written permission of Ericomreg Software Ltd
bull The text and graphics are for the purpose of illustration and reference only The
specifications on which they are based are subject to change without notice
bull The software described in this document is furnished under a license agreement
The software may be used or copied only in accordance with the terms of that
agreement
bull Information in this document is subject to change without notice Corporate and
individual names and data used in examples herein are fictitious unless otherwise
noted
Copyrightcopy 1999-2008 Ericomreg Software Ltd
Ericomreg and PowerTermreg are registered trademarks of Ericomreg Software Ltd which may
be registered in certain jurisdictions Other company and brand and product and service
names are trademarks or registered trademarks of their respective holders
PowerTerm WebConnect 3 Getting Started Guide
Table of Contents
ABOUT THIS DOCUMENT 5
1 PRODUCT OVERVIEW 6
2 INSTALLING AND STARTING POWERTERM WEBCONNECT 8
21 Install PowerTerm WebConnect (Windows edition) 8
22 StartStopRestart PowerTerm WebConnect Server (Windows edition) 8
23 Install Run and Stop PowerTerm WebConnect Server (Linux edition) 9
24 Install the Terminal Server Agent 10
25 Install PowerTerm WebConnect DeskView Server 10
26 Start the PowerTerm WebConnect Administration Tool 10
3 POWERTERM WEBCONNECT ADMINISTRATION TOOL AT A GLANCE 12
31 Publishing Applications and Documents 14
32 Create Terminal Emulation Connections 16
33 Test Connections 16
34 Launch the Application Zone or the Application Portal 17
35 Monitor a Users Sessions 17
36 View Intruders 17
4 ACCESSING VIRTUAL DESKTOPS AND BLADE PCS WITH POWERTERM WEBCONNECT 18
41 Step 1 Launch DeskView Administration Tool 18
42 Step 2 Add a Host 19
43 Step 3 Create a Pool 20
44 Step 4 Publish an ApplicationDesktop 20
5 DOWNLOAD AND RUN POWERTERM WEBCONNECT CLIENTS 22
6 POWERTERM WEBCONNECT CLIENT FOR LOTUS EXPEDITOR 23
61 Installation Package 23
62 Pre-installation steps 23
63 Install PowerTerm WebConnect Portlet on IBM Workplace server (for Windows OS) 24
PowerTerm WebConnect 4 Getting Started Guide
64 Install PowerTerm WebConnect Portlet on IBM Workplace server (for Linux OS) 26
65 Install PowerTerm WebConnect Portlet on IBM WebSphere 61 server (for Windows OS) 27
66 PowerTerm WebConnect Server Configuration 29
67 PowerTerm WebConnect Client Configuration 29
68 Installing PowerTerm WebConnect Client on Lotus Expeditor 35
69 Running PowerTerm WebConnect Client for Lotus Expeditor 35
610 Troubleshooting 36
ABOUT ERICOM 39
PowerTerm WebConnect 5 Getting Started Guide
About this Document
This guide explains how to install and get started with PowerTerm WebConnect (PowerTerm
WebConnect Enterprise PowerTerm WebConnect RemoteView PowerTerm WebConnect
DeskView PowerTerm WebConnect HostView and PowerTerm WebConnect for Oracle) It
is intended for Administrators of PowerTerm WebConnect If you need more detailed
explanations on the different options in the administration tools or more information about
how to work with PowerTerm WebConnect please refer to the PowerTerm WebConnect
Administrators Manual
This document contains the following chapters
Chap 1 Product Overview Important information for
easy installation
Pg 6
Chap 2 Installing and Starting
PowerTerm WebConnect
Describes how to install and
start PowerTerm
WebConnect (Windows and
Linux editions) and its
different components as well
on how to launch the
PowerTerm WebConnect
Administration Tool
Pg 8
Chap 3 PowerTerm WebConnect
Administration Tool at a
Glance
Describes some main
features of the PowerTerm
WebConnect Administration
Tool and how to create
Connections and Publish
Applications
Pg 12
Chap 4 Accessing Virtual Desktops
and Blade PCs with
PowerTerm WebConnect
Describes how to configure
hosts and create pools with
PowerTerm WebConnect
DeskView and PowerTerm
WebConnect for Oracle VM
Pg 18
Chap 5 Download and Run
PowerTerm WebConnect
Clients
Describes where you can
download and run the
various PowerTerm
WebConnect clients
Pg 22
Chap 6 PowerTerm WebConnect
Client for Lotus Expeditor
Describes how to install
configure and run
PowerTerm WebConnect
Client for Lotus Expeditor
Pg 23
PowerTerm WebConnect 6 Getting Started Guide
1 Product Overview
PowerTerm WebConnect is an Enterprise-Wide Application Access solution that enables you
to publish and provide secure remote access to applications running on Windows Terminal
Servers Virtual Desktops (on top of hypervisors such as VMWare Microsoft Xen and
Virtual Iron) Blade PCs and legacy hosts Once published applications can be accessed
and used by end-users in a secure and managed fashion
Major components of the PowerTerm WebConnect product include
bull PowerTerm WebConnect Server
Choose between either Windows or Linux editions of the server
bull PowerTerm WebConnect DeskView Server
This component makes it possible to publish Desktops and applications that run on
Virtual Machines and physical machines
bull PowerTerm Load Balancer
Install the PowerTerm Load Balancer as a part of PowerTerm WebConnect Server
installation on the same computer or independently on a separate computer
Once installed it provides System and Application Load Balancing
bull PowerTerm WebConnect Web Components
Install these components on a compatible Web server in order to provide end-
users with a Web interface to published applications
bull PowerTerm WebConnect Administration Tool
Install the PowerTerm WebConnect Administration Tool on the server or on an
administration workstation It can also be downloaded on-demand
bull Client-side components
These components are installed as a part of the ldquoWeb server componentsrdquo
installation option and are usually downloaded by users the first time they need
the corresponding functionality Some components can be pre-installed if needed
Client side components include
RemoteView for accessing Windows Terminal Server applications and Virtual
Desktops from Windows and Linux workstations as well as from Windows Based
Terminals and Windows XPe and Linux based thin clients
HostView for accessing character-based applications running on legacy hosts
including IBM Mainframe IBM AS400 OpenVMS Unix Linux Tandem from
Windows and Linux workstations as well as from Windows Based Terminals and
Windows XPe and Linux based thin clients
SupportView for remote desktop support
PrintView for managing print queues
QuickVNC for remote desktop connectivity
bull PowerTerm Terminal Server Agent
Install this component on Windows Terminal Servers This component enables
PowerTerm WebConnect 7 Getting Started Guide
True Seamless Windows for published applications remote application browsing
and publishing and Application Load Balancing
bull PowerTerm WebConnect Portlet for JSR 168 Portals
Install this component if you plan to access Windows published applications and
Legacy hosts from within JSR 168 compatible portal environments such as IBM
Workplace or WebSphere Oracle Portal Vignette Portal and the like
bull PowerTerm WebConnect Plugin for IBM Lotus Expeditor
Install this plugin if you plan to access Windows published applications and Legacy
Hosts from within the IBM Lotus Expeditor environment
bull PowerTerm WebConnect DeskView
This component makes it possible to publish Desktops and applications that run on
Virtual Machines and physical machines
The evaluation package of PowerTerm WebConnect that you can download and
install contains the PowerTerm WebConnect Enterprise product with all its
components Once activated the product will only include the components and
features of the specific PowerTerm WebConnect product you purchased
PowerTerm WebConnect 8 Getting Started Guide
2 Installing and Starting PowerTerm WebConnect
PowerTerm WebConnect includes both server-side and client-side components The server
side includes
bull PowerTerm WebConnect Server
bull PowerTerm WebConnect DeskView Server
bull PowerTerm WebConnect Load Balancer
bull PowerTerm WebConnect Administration tools (for WebConnect Server PowerTerm
Load Balancer and DeskView Server)
The client side has numerous clients such as
bull RemoteView
bull HostView (for both Windows and Linux)
bull QuickVNC etc
21 Install PowerTerm WebConnect (Windows edition)
1 Run the installation file typically named PowerTermWebConnect5xexe You will find
the file on the installation CD or you can download it from Ericoms website
2 Click Install and then enter your Serial Number or click Evaluate when prompted
3 Continue with installation and select Full Installation Server Administration Tool and
WebServer Components (default) in the Setup Type dialog
4 Complete the installation and click Exit and run PowerTerm WebConnect in the last
dialog of the installation Depending on your computer this may take a few minutes
The first time you launch the PowerTerm WebConnect server it will generate a
Diffie-Hellman key for SSL encryption This process may take several minutes
depending on the speed of your computer A visual progress indicator will show
you when this process is completed While this process is taking place PowerTerm
WebConnect clients will not be able to connect to the server
22 StartStopRestart PowerTerm WebConnect Server (Windows edition)
PowerTerm WebConnect server is installed as a Windows service
1 Launch the standard Services console from the Windows Control Panel On some
computers it may be located under the Administrative Tools group You can also run
the command SERVICESMSC The Services window is displayed
PowerTerm WebConnect 9 Getting Started Guide
2 Select PowerTerm WebConnect Server 5x service (the primary service of PowerTerm
WebConnect) where x is the version number and use standard StartStopRestart
options
The PowerTerm WebConnect Server Starter 5x service (the secondary service of
PowerTerm WebConnect) is designated for restarting the primary service in
cases of failure or any unexpected problems The secondary service is
controlled by internal logic of PowerTerm WebConnect and cannot be stopped
from the Services console
23 Install Run and Stop PowerTerm WebConnect Server (Linux edition)
Transfer the installation file to your Linux server and install the PowerTerm WebConnect
components in the RPM package using the following shell command
rpm ndashi WebConnecct-5x-0i586rpm
(lsquoxrsquo is the version number)
The PowerTerm WebConnect server will be installed to
optWebConnect5x
All PowerTerm WebConnect clients including PowerTerm WebConnect
Administration Tool are published via the Web server Therefore you need to
manually configure the Web server to publish the path optWebConnect56web
The name of the virtual directory has to be WebConnect5x
After configuring the virtual directory you can launch any client from httpltservernamegtWebConnect5xClientURLshtml
Users of Red Hat 72
If you installed the PowerTerm WebConnect server on Red Hat 72 you also have to install
the file libgcc-304-1i386rpm (44Kb) in order for PowerTerm WebConnect Server to run
This file can be downloaded from
ftprpmfindnetlinuxredhatupdates72enosi386libgcc-304-1i386rpm The file is
also available on the installation CD and can as well be downloaded from the ldquoEvaluate
PowerTerm WebConnect Linux x86 Editionrdquo web page
Use the following commands to run the PowerTerm WebConnect server
On RedHat
sbinservice webconnectd start
On Suse
etcrcdwebconnectd start
Use the following commands to stop the PowerTerm WebConnect server
On RedHat
sbinservice webconnectd stop
PowerTerm WebConnect 10 Getting Started Guide
On Suse
etcrcdwebconnectd stop
24 Install the Terminal Server Agent
PowerTerm WebConnect Terminal Server Agent must be installed on a Terminal Server
accessed using PowerTerm WebConnect It provides the True Seamless Windows
functionality for published applications remote browsing and publishing and Application
Load Balancing
The PowerTerm WebConnect Terminal Server Agent must be installed on every Terminal
Server in the cluster If you install the PowerTerm WebConnect server itself on a Terminal
Server you will be given the option to install the Terminal Server Agent as a part of the
server installation Alternatively use the PowerTermTerminalServerAgentexe file located in
the AddOnsTerminalServerAgent subdirectory under the PowerTerm WebConnect server
installation directory
To complete the installation you might need to restart the Terminal Server machine
25 Install PowerTerm WebConnect DeskView Server
PowerTerm WebConnect DeskView is automatically installed when you run PowerTerm
WebConnect Installation wizard ndash Full installation To run PowerTerm WebConnect
DeskView Server you also need Microsoft NET Framework v30 to be installed on your
computer If you do not have it installed then the installation wizard will place the
DeskViewServerSetupmsi and DeskViewAdminSetupmsi files in the AddOns folder
(ltPowerTerm WebConnect Installation FoldergtWebConnect 5xAddOnsDeskView
VDI) from where you can run the msi files at a later stage to install PowerTerm
WebConnect DeskView
26 Start the PowerTerm WebConnect Administration Tool
There are several ways to launch the PowerTerm WebConnect Administration Tool Select
the one most convenient for you
bull From Windows Start menu select Programs | Ericom Software | PowerTerm WebConnect
5x | PowerTerm WebConnect Administration Tool
If you changed the Program Folder during installation the Start menu path
may vary
bull Double-click PtAdminexe PtAdminexe is located in the bin directory of the
PowerTerm WebConnect installation folder
bull Rather than installing you can choose to download the Administration Tool to any
Windows computer Please refer to the PowerTerm WebConnect Sample URLs
page (httpltweb_servergtWebConnect5xClientURLshtml) for more details
A few things to remember
PowerTerm WebConnect 11 Getting Started Guide
When you launch the PowerTerm WebConnect Administration Tool for the first time the Connection dialog is displayed with the user Administrator No
password is required to enter just click Connect
In the Connection dialog (displayed when launching the Administration Tool) the
Host Name is localhost by default This is correct only if the Administration Tool
runs on the same machine as the server If the Administration Tool runs on a different machine you need to change the Host Name to the IP addressHostname
of the PowerTerm WebConnect server
When using the PowerTerm WebConnect Windows edition by default the
Administration Tool will deny any connection attempts from any computer other
than the local machine
PowerTerm WebConnect 12 Getting Started Guide
3 PowerTerm WebConnect Administration Tool at a Glance
PowerTerm WebConnect Administration Tool manages published applications user sessions
and server configuration The administrator can perform operations such as multiple
application publishing sending messages to logged-on users shutting down sessions and
monitor user activity
To perform the tasks described in this chapter you must launch the Administration Tool via one of the methods detailed in chapter Start the PowerTerm
WebConnect Administration Tool
Launching the Administration Tool from the system tray or using the
Administration Tool launched after completed installation will not allow you to
activate certain features
After you launched the Administration Tool and connected to the server you will receive a
Welcome screen where you select desired activity
bull Publish Multiple Applications opens the Publish Multiple Applications wizard
bull Configure Load Balancer opens PowerTerm Load Balancer Administration Tool
bull Create a Host Connection opens the Add Connection dialog
bull Configure Active Directory opens the Directory Services dialog
PowerTerm WebConnect 13 Getting Started Guide
Close the Welcome screen to enter the Administration Tool main
screen
The Administration Tool main screen has three sections
bull User section lists all users defined in the server
bull Group section lists all groups defined in the server
bull Connection section lists all connections and published applications defined in the
server
By default only the Connection section is displayed when you first open Administration Tool
There are three predefined example-connections ldquoExample_As400rdquo ldquoExample_VTrdquo and
ldquolocalhostrdquo You can test them prior to defining your own
1 Right click the connection you want to test and select Test The PowerTerm
WebConnect HostView Login dialog appears
2 Type example for User Name and example for Password
Credential fields are case sensitive
3 Click Login The desired connection with its pre-programmed demo application is
launched
PowerTerm WebConnect 14 Getting Started Guide
31 Publishing Applications and Documents
In order to enable access to applications and documents on Windows Terminal Servers
publish these applications and documents from the Administration Tool When publishing
applications and content you can specify which servers will be used in a Terminal Server
cluster and which users and groups will have access to these services Once you have
published such applications and documents the RemoteView client can be used to access
them
If you need to provide access to multiple applications on a Terminal Server use the Multiple Application Publishing wizard to significantly reduce the time and
effort required to publish these applications
To publish multiple Windows applications
1 Click Publish Multiple Applications in the Welcome screen The Choose Terminal Server
for Browsing dialog appears
2 Provide the address of the Terminal Server which will be used for browsing and click OK The Application Publisher Step 1 dialog appears This dialog lists all the
applications available in the specified serverrsquos Start menu
3 Select those applications found in the Programs folder of the designated server that you want to publish and click Next The Application Publisher Step 2 dialog appears
4 Determine the destination of your publishing and click Next The Application Publisher
Step 3 dialog appears
5 Determine the Color Quality of your published application
6 Determine the start mode in which you want to run the published application - normal maximized or minimized - and click Next The Application Publisher Step 4
dialog appears
7 Choose the connection speed that matches your infrastructure The connection speed
setting determines the value of three visual effects settings You can also override
these settings specifically
8 Determine whether you prefer the window to display their content while being
dragged or just the outline By default the same setting is used as the client desktop
9 Click Next The Application Publisher Step 5 dialog appears
10 Specify where sounds are to be played ndash locally or remotely
11 Determine which local devices the remote session will have access to (local drivers printer etc) and click Next The Application Publisher Step 6 dialog appears
12 If you have the PowerTerm Load Balancer installed Use all Servers (default) allows the application to run on any Terminal Server in the
cluster This setting is appropriate when the application is installed on all the Terminal
Servers Alternatively you select specific Terminal Servers on which to run this
application
If you have not installed the PowerTerm Load Balancer you will need to explicitly
specify the address of the Terminal Server on which the application will be run
PowerTerm WebConnect 15 Getting Started Guide
13 Click Next The Application Publisher Step 7 dialog appears
14 Select the users groups or OUs to which you wish to publish the applications and click Next The Application Publisher Step 8 dialog appears By default applications will
be published to everybody
15 Click Advanced Settings to modify settings such as the login credentials to the
Terminal Servers By default PowerTerm WebConnect credentials will be passed
through to the Terminal Server
16 Click Finish The published applications appears in the Connection List
Right-click and select Properties or double click on the published application in the
Connections list to view and modify any of the settings which you previously
defined
To publish a remote Desktop
1 Select Action | New | Remote Desktop The Application Publisher Step 1 dialog appears
2 Type the Display Name which will be the name presented to the end-users and click
Next The Application Publisher Step 2 dialog appears
3 Specify where icons for the published desktop will be displayed to the end-user in Publish to
4 Click Choose Icon to replace the desktoprsquos default icon Select the desired icon from
the list that appears
5 Click Next The Application Publisher Step 3 dialog appears
6 Determine Screen Size and the Color Quality of the published desktop
7 If desirable select Show Connection Bar in Full Screen Mode
8 Click Next The Application Publisher Step 4 dialog appears
9 Choose the connection speed that matches your infrastructure The connection speed
setting determines the value of three visual effects settings You can also override
these settings specifically
10 Click Next The Application Publisher Step 5 dialog appears
11 Specify where sounds are to be played ndash locally or remotely Where to Apply Window
Key Combinations and which local devices you want to automatically connect to when
logged on to the remote computer
12 Click Next The Application Publisher Step 6 dialog appears
13 Specify the Server Address and Port Number of the Terminal Server that weill provide
the desktop and click Next The Application Publisher Step 7 dialog appears
14 Select the users groups or OUs to which you wish to publish the desktop and click Next The Application Publisher Step 8 dialog appears
Select the Server group to allow all users to access the published application
15 Click Advanced Settings to modify settings such as the login credentials to the
Terminal Servers By default PowerTerm WebConnect credentials will be used
PowerTerm WebConnect 16 Getting Started Guide
16 Click Finish The published application appears in the Connection List
Right-click Properties or double click on the published application in the
Connections list to modify any of the settings which you previously defined
32 Create Terminal Emulation Connections
To provide access to legacy host systems you will need to create Terminal Emulation
connections For each such connection you can specify the host address emulation type
login script and more Once you have created these connections users will be able to
launch them using HostView (Windows or Linux) WebView or the Java client as
appropriate
1 Click Create a Host Connection in the Welcome screen The Add Connection dialog
appears
2 Enter a Name for the new connection
3 Specify an Owner for the new connection The possibilities are
[None] the connection will not be allowed to run by anyone and it will not be
displayed in any Connection list Server the connection will be accessible for all users of this PowerTerm
WebConnect server A specific group the connection will be accessible for all users of the specified
group A specific user the connection will be accessible for a specified user only
4 Leave category Terminal Emulation selected
5 Select Terminal Type Terminal Model and Communication Type as needed
6 Specify the Host Name or IP address of your host
7 Specify other parameters as needed
8 Select the Security Type as needed if your host supports SSL or SSH and specify
the appropriate details in the Details dialog
9 Use the Settings Key Mapping and Power Pad options to further customize the
connection
10 Click OK and the connection is created
33 Test Connections
It is recommended to test published applications or host connections before they are made
available to end-users
To test a connection
bull Right-click the target connection from the Connection section of the main screen and
select Test
Alternatively
PowerTerm WebConnect 17 Getting Started Guide
1 Select Tools | Run ltdesired clientgt The Login to WebConnect dialog appears
2 Enter the User Name and Password for the individual who owns the connection that
you want to test and click Login The desired PowerTerm WebConnect client is started
and the Connect dialog appears
3 Select the desired connection and click Connect The test is executed
34 Launch the Application Zone or the Application Portal
Users can access the published applications from the Application Zone application launcher
or from the Application Portal web interface
To use the Application Zone go to Start menuProgramsEricom SoftwarePowerTerm
WebConnect 5x and select Client URLs Alternatively type the following URL into your Web
browserrsquos address bar httpltserver addressgtWebConnect5xClientURLshtml In the
page that opens click on the Run button next to the Application Zone to launch it
To use the Application Portal go to Start menuProgramsEricom SoftwarePowerTerm
WebConnect 5x and select it Alternatively type the following URL into the Web browserrsquos
address bar httpltserver addressgtWebConenct5xportalwindowsindexasp
35 Monitor a Users Sessions
From the Administration Tool you can monitor the users sessions and may intervene if
necessary This intervention may result in your input appearing on the users screen The
user receives a notification when an administrator begins and ends monitoring the session
1 Select View | Client Sessions or click to see all the active client sessions
2 Select the desired active session and right-click Attach The Password Verify dialog
appears
3 Enter your password and click OK Some notification dialogs appears and the selected
PowerTerm WebConnect session is viewed
36 View Intruders
bull The Intruders window shows suspected attempts at breaching security After several
suspected intrusion attempts users are blocked temporarily
bull In addition to showing suspected intrusion attempts the Intruders window allows
you to remove restrictions on users
bull Select View | All Intruders or click
PowerTerm WebConnect 18 Getting Started Guide
4 Accessing Virtual Desktops and Blade PCs with PowerTerm WebConnect
This chapter provides instructions on configuring PowerTerm WebConnect for Virtual
Desktop Infrastructure (VDI)
41 Step 1 Launch DeskView Administration Tool
Verify that PowerTerm WebConnect is installed on your server and launch PowerTerm
WebConnect Admin Tool
bull Select Tools | Open VDI Manager The PowerTerm WebConnect DeskView Administration
Tool opens
The first time you launch the DeskView Administration Tool you will be prompted to install
the tool
PowerTerm WebConnect 19 Getting Started Guide
Microsoft Management Console 30 is required for PowerTerm WebConnect DeskView
Administration Tool If you do not have this installed you will also automatically be
prompted to install this update
Follow the installation processes when you are prompted for either install PowerTerm
WebConnect DeskView Administration Tool will automatically launch when these
installations are completed
42 Step 2 Add a Host
1 Right-click Virtualization Hosts and select Add Host The Add a New Host wizard
opens Click Next
2 Enter a Host Name as you would like it to appear in PowerTerm WebConnect
DeskView Administration Tool and a description (optional) Click Next
3 Specify the Virtualization Server type and click Next
4 Specify the connection information and click Next
VMWare Virtual Center v1x and 2x
Specify the HTTPS Web Service address and a UsernamePassword that can access
the host
VMWare Virtual Server 2005
Click Start and then Run
Type ldquoservicesmscrdquo and click OK
Scroll down to PowerTerm WebConnect DeskView Server service and open
Properties
Change the Login Account for the service to match the Domain Administrator
account and password used when setting up Microsoft Virtual Server 2005 and
restart the service Enter the IP or NETBIOS name of the Microsoft Virtual Server 2005 server as the
Server Address in the Connection Broker Wizard
Xen Server
Specify the hypervisor IP address or NETBIOS name the Root UsernamePassword
to the hypervisor and the Service port (default 80)
Oracle VM
Specify the Serverrsquos agent URL and Port (default 8899) for example
httpsltservernamegt8899
Specify the Oracle VM hypervisorrsquos Oracle Agent UsernamePassword (default
username oracle)
5 Click Finish to add the new Host
To configure Virtual Machines for use install the Ericom Tools (vmagentmsi) on each of the
virtual machines on the new host for PowerTerm WebConnect DeskView to recognize them
The vmagentmsi installer is located on the PowerTerm WebConnect server in ltPowerTerm
WebConnect installation foldergtAddOnsDeskView VDI folder (default installation
PowerTerm WebConnect 20 Getting Started Guide
folder is xProgram FilesEricom SoftwareWebConnect 56) During installation you
will need to enter the DeskView IP address or NETBIOS name
If you are using Microsoft Virtual Server 2005 as your Virtualization Host use the
IP address of the DeskView server only when installing the Ericom Tool package
43 Step 3 Create a Pool
Pools are used to organize Virtual Machines (VM) into logical groups This enables
organizations to combine and order resources from multiple systems into one entity To
access available resources end-users simply connect to PowerTerm WebConnect to access
any configured resource
1 Right-click Pools and select Create Pool The Create a Pool wizard opens Click
Next
2 Enter a Pool name as you wish it to appear and a description (optional) and click
Next
3 Specify the Pool type and click Next
4 Specify the Assignment type and click Next
Permanently will cause a virtual machine to affix to the user who has launched
that virtual machine For the duration of the session will cause any virtual machine that is not in use to
be returned to the pool for any user to launch
5 Specify the LogoffDisconnect event and click Next
Select what you would like to happen after a user logs off from a virtual machine
in this pool
Select what you would like to happen when a user is disconnected from a virtual
machine in this pool
6 Click Finish to add the new Pool
You will need to assign virtual machines from your virtualization hosts to your created pool
1 Right-click the pool and select Assign Machines The Assign Machines to ltyour
pool namegt dialog opens
2 Highlight the desired virtual machine(s) and click Select Click OK
44 Step 4 Publish an ApplicationDesktop
1 Return to PowerTerm WebConnect Admin Tool to publish DeskView pools
2 Determine whether to publish a full desktop or a seamless application running
from a virtual desktop
For a full desktop
Select Action | New | Remote Windows Desktop
For a seamless application
Select Action | New | Windows Application
PowerTerm WebConnect 21 Getting Started Guide
3 Select Virtual Desktop in the first step of the wizard and click Next
4 Follow the wizardrsquos instructions until you reach the Virtual Desktops step
5 Select a pool that you previously created and that you would like this connection to choose virtual machines from Click Next
6 Continue and complete the reminder of the wizardrsquos steps
Once the resource is published users who have been assigned access will be able to use it
immediately
PowerTerm WebConnect 22 Getting Started Guide
5 Download and Run PowerTerm WebConnect Clients
PowerTerm WebConnect clients are automatically downloaded and installed onto the client
devices For detailed information and samples please refer to the PowerTerm WebConnect
Sample URLs page To see this page navigate your browser to
httpltweb_servergtWebConnect5xClientURLshtml
PowerTerm WebConnect 23 Getting Started Guide
6 PowerTerm WebConnect Client for Lotus Expeditor
61 Installation Package
PowerTerm WebConnect client for Lotus Expeditor is provided to IBM in an Update Site
package This is a ZIP archive containing the Update Site with the Eclipse feature and plug-
in that comprises the PowerTerm WebConnect client
Extract the ZIP file keeping the foldersrsquo structure intact
NOTE In Winzip verify that the ldquoUse folder namesrdquo option is set to TRUE
Package structure
Update Site
- plugins
- PowerTermWebConnectClient_560365jar
- features
- comericomWebConnect_560365jar
- sitexml
config
- webconnectxml
Definitions
bull webconnectxml PowerTerm WebConnect client configuration file
bull comericomWebConnect_560365jar PowerTerm WebConnect client feature file
bull PowerTermWebConnectClient_560365jar PowerTerm WebConnect client plugin file
62 Pre-installation steps
PowerTerm WebConnect client for Lotus Expeditor does not run independently but in
conjunction with PowerTerm WebConnect Server You can either install it and define your
users groups and applications or use Ericom Softwarersquos Demo PowerTerm WebConnect
Server
bull If you decide to install PowerTerm WebConnect Server you will need the full
installation ie the PowerTerm WebConnect Server and the Web components If you
do not have the installation CD you can download and install a trial version from
wwwericomcom
PowerTerm WebConnect 24 Getting Started Guide
bull If you decide to use Ericom Softwarersquos Demo PowerTerm WebConnect Server then
skip to the chapter Installing PowerTerm WebConnect Client on Lotus Expeditor
63 Install PowerTerm WebConnect Portlet on IBM Workplace server (for Windows OS)
Step 1 Install PowerTerm WebConnect Server
If PowerTerm WebConnect Server and IBM Workplace Server are on separate machines
bull Configure PowerTerm WebConnect Server
Launch PowerTerm WebConnect Administration Tool
Open Files | Configuration | Main
In the [Portal] section edit
Machines=localhostltIBM sever machinegt
bull Configure PowerTerm WebConnect Web components
Copy the ldquowebrdquo folder from the PowerTerm WebConnect server installation to the
IBM Workplace server machine
Create an Alias or a Virtual directory to it named WebConnect on the Web
server providing access to it for the users This is in order to enable the users to
download the necessary files to run their applications
Step 2 Enable JSR portlets
1 On IBM Workplace Server go to ltPortalServergtsharedappconfigservicesConfigServiceproperties
2 Edit portalenablejsr168=true
3 Save and close the file
Step 3 Enable SSO
1 On IBM Workplace Server go to ltPortalServergtsharedappconfigservicesLoaderServiceproperties
2 Edit commandpath=comericomportalcommandscomibmwpsenginecommands
3 Save and close the file
Step 4 Copy Files
The following files need to be copied from WebConnect ServerAddOnsIBM
WorkplacePortlet folder to IBM Workplace Server
File name to copy Destination folder
OpenSSLdll ltAppServergtjavajrebin
IbmPortaldll ltAppServergtjavajrebin
IbmPortalini ltAppServergtjavajrebin
PowerTerm WebConnect 25 Getting Started Guide
WebConnectPortaljar ltAppServergtlib
EricomLoginjar ltPortalServergtsharedapp
Step 5 Portlet Configuration
1 On IBM Workplace Server go to ltAppServergtjavajrebinIbmPortalini
2 You can modify the following parameters in the [Server=WebConnect] section webserverport=ltIBM web server portgt
Specifies the Web server port for accessing the PowerTerm WebConnect clients folder
Default 80 Address
Specifies the address of the PowerTerm WebConnect Server machine for Portlet to
connect to when PowerTerm WebConnect Server is located on a different machine
than the IBM Workplace Server CustomAddress
Specifies the addresss of the PowerTerm WebConnect Server machine for Clients to connect to If CustomAddress is the same as Address then this may be omitted webserveraddr
Specifies the address of the Web Server machine when it is located on a different
machine than the IBM Workplace Server
3 Restart the IBM server ltPortalServergtrootscriptsstopWorkplaceServicesbat ltPortalServergtrootscriptsstartWorkplaceServicesbat
This procedure may take about 20 minutes
Step 6 Install the Portlet
1 In a Web browser open the URL httpltIBM Workplace
Servergt9081lwpmyworkplace to open the IBM Workplace Portal
2 Login as administrator
3 Go to Administration | Portlets | Install
4 Browse to the PowerTerm WebConnectwar file located on PowerTerm WebConnect
Server and click Next
5 Click Install
Step 7 Create an Application page
1 Login to the Workplace
2 Go to Portal User Interface | Manage Pages
3 Search for My Work
4 Click the My Work link and select New Page
5 Name the page PowerTerm WebConnect and click OK
6 Click OK again You will see the created page on the list
7 Click the pencil icon on the new page and select the 1 square layout
PowerTerm WebConnect 26 Getting Started Guide
8 Click Add Portlet and search for PowerTerm WebConnect
9 Select it and click OK
10 Click Done
11 Click My work at the top of the page PowerTerm WebConnect is displayed on the list
Step 8 Run the Portlet
1 Restart IBM Workplace Server
2 Open IBM Workplace Portal in a browser httpltportal servergtlwpmyworkplace
3 Login to IBM Workplace Server
4 Click My work PowerTerm WebConnect portlet is displayed
5 Launch it The Userrsquos applications as defined on PowerTerm WebConnect Server
appear
6 Click an application to launch it
64 Install PowerTerm WebConnect Portlet on IBM Workplace server (for Linux OS)
Step 1 Enable JSR 168 portlets
1 Go to optIBMWorkplacePortalServersharedappconfigservicesConfigServiceproperties
2 Modify the portalenablejsr168 property to ldquotruerdquo
3 Restart the server cd optIBMWorkplacePortalServerrootscripts
Run stopWorkplaceServicessh
Run startWorkplaceServicessh
This procedure can take up to 20 minutes
4 Log on to the workplace server at httpltworkplace servergt9081lwpmyworkplace using
the administrators username and password
Step 2 Install the portlet
1 Restart IBM Workplace Server
2 In a Web browser open the URL httpltworkplace server IPgtlwpmyworkplace
3 Login to IBM Workplace Server as an administrator
4 Go to Administration | Portlets | Install
5 Browse to the PowerTerm WebConnectwar file located on PowerTerm WebConnect
Server and click Next
6 Click Install
PowerTerm WebConnect 27 Getting Started Guide
Step 3 Install the Application page
1 Login to the workplace as administrator
2 Go to Administration | Portal User Interface | Manage Pages
3 Search for My Work
4 Click the My Work link and select New Page
5 Name the page PowerTerm WebConnect and click OK
6 Click OK again You will see the created page on the list
7 Click the pencil icon and select the 1-square layout
8 Click Add Portlet and search for PowerTerm WebConnect
9 Select it and click OK
10 Click Done
11 Click My work on top and PowerTerm WebConnect is displayed on the left bar
Step 4 Run the portlet
1 Restart IBM Workplace Server
2 Open IBM Workplace Portal in a browser httpltportal servergtlwpmyworkplace
3 Login to IBM Workplace Server
4 Click My work PowerTerm WebConnect portlet is displayed
5 Launch it The Userrsquos applications as defined on PowerTerm WebConnect Server
appear
6 Click an application to launch it
65 Install PowerTerm WebConnect Portlet on IBM WebSphere 61 server (for Windows OS)
Step 1 Install PowerTerm WebConnect Server
You have to configure PowerTerm WebConnect Server if it and the IBM WebSphere Server
are on separate machines
1 Launch PowerTerm WebConnect Administration Tool
2 Open Files | Configuration | Main
3 In the [Portal] section edit Machines=localhostltIBM sever machinegt
Step 2 Copy Files
The following files need to be copied from WebConnect ServerAddOnsIBM
WebSpherePortlet folder to IBM WebSphere Server
PowerTerm WebConnect 28 Getting Started Guide
File name to copy Destination folder
OpenSSLdll ltAppServergtjavajrebin
IbmPortaldll ltAppServergtjavajrebin
IbmPortalini ltAppServergtjavajrebin
WebConnectPortaljar ltAppServergtlib
Step 3 Portlet Configuration
1 On IBM Workplace Server go to ltAppServergtjavajrebinIbmPortalini
2 You can modify the following parameters in the [Server=WebConnect] section webserverport=ltIBM web server portgt
Specifies the Web server port for accessing the PowerTerm WebConnect clients folder
Default 80 Address
Specifies the address of the PowerTerm WebConnect Server machine for Portlet to
connect to when PowerTerm WebConnect Server is located on a different machine
than the IBM Workplace Server CustomAddress
Specifies the addresss of the PowerTerm WebConnect Server machine for Clients to connect to If CustomAddress is the same as Address then this may be omitted webserveraddr
Specifies the address of the Web Server machine when it is located on a different
machine than the IBM Workplace Server
3 Restart the IBM server ltAppServergtProfilesAppServer01binstopServerbat ltAppServergtProfilesAppServer01binstartServerbat
This procedure may take about 20 minutes
Step 4 Install the Portlet and create an Application page
1 In a Web browser open the URL httpltIBM WebSphere Servergt9060ibmconsole
to open the IBM WebSphere Portal
2 Login and go to Applications | Install New Application
3 Browse to the PowerTerm WebConnectwar file located on PowerTerm WebConnect
Server
4 Enter Context root and click Next The Select installation options dialog appears
5 Optional change options to your preference or keep the default
6 Click Next
7 Select Ericom in the Module column click Apply and then Next
8 Click Finish and then Save
9 Select Applications | Enterprise Applications
10 Select PowerTerm WebConnectwar checkbox and click Start
PowerTerm WebConnect 29 Getting Started Guide
11 Enter in the Web browser the URL httpltIBM WebSphere
Servergt9080ltContext rootgtEricom portlet The Login dialog appears
12 Login and you will see PowerTerm WebConnect displayed on the list
Step 5 Run the Portlet
1 Restart IBM WebSphere Server
2 Open IBM WebSphere Portal in a browser httpltportal servergt9080ltContext
rootgtEricom portlet
3 Login to IBM WebSphere Server
4 Launch it The Userrsquos applications as defined on PowerTerm WebConnect Server
appear
5 Click an application to launch it
66 PowerTerm WebConnect Server Configuration
bull To enable the Lotus Expeditor to run the PowerTerm WebConnect client the
System Administrator must provide the users with accounts on PowerTerm
WebConnect Server (see the PowerTerm WebConnect Administratorrsquos Manual for
instructions on how to create users groups and connections on the PowerTerm
WebConnect Server)
bull To enable PowerTerm WebConnectrsquos Single Sign-On feature the System
Administrator must create a PowerTerm WebConnect user with the same
username and password as used for the Lotus Expeditor For a managed Lotus
Expeditor the credentials used are the username and password sent to the
managing server For an unmanaged Lotus Expeditor the operation system
username and the Lotus Expeditor password are used as credentials
NOTE If a password is not defined then the Single Sign-On will fail and the user will be
prompted with a login dialog
67 PowerTerm WebConnect Client Configuration
The PowerTerm WebConnect client is configured in webconnectxml located in the config
folder webconnectxml parameters are
url The PowerTerm WebConnect Agent url
server The PowerTerm WebConnect Server address
sso The Single Sign-On feature
dst The local destination for downloading PowerTerm WebConnect
components
PowerTerm WebConnect 30 Getting Started Guide
url
PowerTerm WebConnect components are installed on a Web server Their default url is
Windows Agent
httpltWebServer IPgtWebConnectwindowsptagentcab
Linux Agent
httpltWebServer IPgtWebConnectlinuxix86qterm-wczip
The url parameter must include the first part of the url (which is identical for both Windows
and Linux agents)
The PowerTerm WebConnect client will automatically append the appropriate suffix in
order to create a full accurate url
Example
ltitem key=rdquourlrdquo value=httpadminserverWebConnectgt
server
The computer name or IP address of the PowerTerm WebConnect Server machine
The PowerTerm WebConnect client will log in to this PowerTerm WebConnect Server
display the applications defined on it and run them according to this serverrsquos configuration
Format ltserver IPgt[ltportgt]
where default port is 4000 (can be edited)
Example
ltitem key=rdquoserverrdquo value=rdquoadmin24000rdquogt
sso
Determines whether Single Sign-on will be used to log in to PowerTerm WebConnect
Server Values
bull True (default) the client should automatically log in to the PowerTerm WebConnect
Server using the same credentials as the ones used to log in to the Lotus Expeditor
client
The System Administrator must verify that these credentials can log in to the
PowerTerm WebConnect Server
bull False the user will be prompted with a login dialog or will log in automatically using
previously saved credentials
Example
ltitem key=rdquossordquo value=rdquotruerdquogt
Autologin mode
PowerTerm WebConnect 31 Getting Started Guide
If sso is set to True the user is not prompted for credentials and the login process to
PowerTerm WebConnect Server is done automatically sending the credentials used for the
Lotus Expeditor unless the Lotus Expeditor does not have a password defined (In the
Lotus Expeditor preferences page | Password| Prompt me for a password at start up checkbox)
However if Single Sign-on is not used there are several options regarding Autologin that
can be defined in the PowerTerm WebConnect Preferences page Options
bull Yes
bull No
bull Interactive
bull First time interactive (default) ndash Simplifies the login process to PowerTerm
WebConnect Server In this mode the first time the user logs in to PowerTerm
WebConnect Server he will be prompted for his credentials with the Login dialog
These credentials will be stored in the machine and from then on the login process to
PowerTerm WebConnect Server will be done automatically
1 Open File | Preferences from the Lotus Expeditor and select PowerTerm WebConnect
2 In the Autologin to WebConnect Server section select First Interactive and click OK
3 Start PowerTerm WebConnect Client for Lotus Expeditor If credentials were entered
at least once then the next time the client will connect to PowerTerm WebConnect
Server without prompting for the user name and password
The Administrator must configure the Agent to do nothing when it exits for the
feature to work this way See PowerTerm WebConnect Administratorrsquos Manual for more information about defining Autologin
bull Allow multiple selection ndash Defines whether the user can launch more than one
application at a time (by using the ltCtrlgt or ltShiftgt button while selecting applications)
dst
Defines the path to download PowerTerm WebConnect components on the client machine
The dst parameter can contain macros which are translated by the PowerTerm WebConnect
Client for Lotus Expeditor during runtime The macros should be placed between percent
symbols () for example WebServer
When such a value is defined the PowerTerm WebConnect Client for Lotus Expeditor
substitutes the entire expression for the macrorsquos value
The PowerTerm WebConnect Client for Lotus Expeditor does not support the use
of environment variables as macros
Macros are not case sensitive
Macros supported by PowerTerm WebConnect Client for Lotus Expeditor
Macro name Description
WebServer The name of the Web server
It is obtained from the PowerTerm WebConnect Agent url
PowerTerm WebConnect 32 Getting Started Guide
parameter
Name The name of the clientrsquos CAB or ZIP file eg ldquoptagentrdquo
Display The clientrsquos display name from the version file
Version The clientrsquos version value It is obtained from the version
file
Root The default root location
Windows ldquoCrdquo
LinuxUnix an empty string
OSDir Windows Windowsrsquo installation directory for example
ldquoCWindowsrdquo
Linux an empty string
OSDrive Windows Windowsrsquo installation drive for example ldquoCrdquo
Linux an empty string
HomePath Windows The HOMEPATH environment variable
Linux The HOME environment variable
Home The Ericom folder in the userrsquos home directory
Windows CDocuments and SettingsltusergtApplication
DataEricom
Linux ltusergtEricom
In addition to the predefined macros listed above the PowerTerm WebConnect client
supports the usage of Java System Properties
Java System Properties available for users on Windows XP SP2
Java System Property Name Value Example
javaversion 150
javavendorurl httpwwwibmcom
javahome CIBMcommonpluginscomibmpvcwctruntim
esj2sewin32x86_150SR2-
20060511rcpeclipsepluginscomibmrcpj2sew
in32x86_150SR2-20060511jre
javavmspecificationversion 10
javavmversion 23
javavmvendor IBM Corporation
javavmname IBM J9 VM
PowerTerm WebConnect 33 Getting Started Guide
javaiotmpdir CDOCUME~1dianaLOCALS~1Temp
javacompiler j9jit23
javaextdirs CIBMcommonpluginscomibmpvcwctruntim
esj2sewin32x86_150SR2-
20060511rcpeclipsepluginscomibmrcpj2sew
in32x86_150SR2-20060511jrelibext
osname Windows XP
osarch x86
osversion 51 build 2600 Service Pack 2
pathseparator
username Jone
userhome CDocuments and SettingsJone
userdir CIBMRSA
usertimezone GMT+0200
System properties available for users on Linux RedHat 9
Java System Property Name Value Example
javaversion 150
javavendorurl httpwwwibmcom
javahome usrjavajre150_07
javavmversion 150
javavmvendor IBM Corporation
javavmname IBM J9 VM
javaclasspath
javalibrarypath
javaiotmpdir tmp
javacompiler
javaextdirs
osname Linux
osarch i386
osversion 2420-8
pathseparator
PowerTerm WebConnect 34 Getting Started Guide
username root
userhome root
userdir root
System properties names are placed in the configuration file within percent symbols ()
(like macros)
671 Configure the PowerTerm WebConnect Client
1 Open the Config Folder and edit the webconnectxml file Example
ltxml version =rdquo10rdquo encoding=rdquoUTF-8rdquogt
ltsection name=rdquoparametersrdquogt
ltitem key=rdquourlrdquo value=httpadminserverWebConnect56gt
ltitem key=rdquoserverrdquo value=rdquoadmin24000rdquogt
ltitem key=rdquossordquo value=rdquotruerdquogt
ltitem key=rdquodestrdquo value=rdquoCProgram FilesEricomrdquogt
ltsectiongt
2 Save the customized webconnectxml to a Web server folder available to all users It is
recommended to use the same Web server as the PowerTerm WebConnect Agent
Example
ltWebConnect installation foldergtwebwebconnectxml
3 Test the accessibility to this file - Type the URL of webconnectxml in the browser
Example
httpltWebServer IPgtWebConnectwebconnectxml
The contents of the file should be displayed
672 Configure the Preferences File
1 Open the plugins folder and open the PowerTermWebConnectClient_560365jar file
You can use Winzip version 70 and up or in Windows XP ndash Create a new file type for the
jar extension click advanced and select compressed (zipped) folder in the drop down list
Now you can open the JAR files in the Windows Explorer
The default contents of the file
configURL=httpleericomcomWebConnectwebconnectxml
2 Specify the accurate URL of the webconnectxml file Example
httpltWebServer IPgtWebConnectwebconnectxml
3 Save the file and close it The WinZip will display the following dialog
ldquoFile preferencesini has been changed since it was extracted Update archive
with this filerdquo
PowerTerm WebConnect 35 Getting Started Guide
4 Click Yes and close the archive
If you are editing the file from within the explorer you will have to save the file elsewhere
and then drag it to the explorer window where the JAR file is open
68 Installing PowerTerm WebConnect Client on Lotus Expeditor
1 Start the Lotus Expeditor client
2 Select File | Application | Install
3 Select Search for new features to install and click Next
4 Select Add Folder Location and type or select the location of the update site folder from
the provided package Click OK
5 Select the location you have just created and click Finish
6 In the Select the feature to install tree select Powerterm WebConnectUpdate Site Click
Next
7 Select I accept the terms in the license agreements and click Next
8 Click Finish
9 When prompted restart the platform
69 Running PowerTerm WebConnect Client for Lotus Expeditor
1 Click Open The PowerTerm WebConnect option is displayed
2 Select PowerTerm WebConnect The application will automatically connect and start
downloading the components from PowerTerm WebConnect Server
IMPORTANT
If you did not install PowerTerm WebConnect Server and are instead connecting to Ericom
Softwarersquos Demo WebConnect Server then you need to open port 443 in the firewall
691 PowerTerm WebConnect Client Workflow
1 PowerTerm WebConnect client reads the URL of webconnectxml from the preferencesini
file and requests it
2 When the webconnectxml is successfully downloaded the application reads the
configuration connects to the specified Web server downloads the PowerTerm
WebConnect components and connects to the PowerTerm WebConnect Server
3 The user is requested to login to the PowerTerm WebConnect Server For testing you
can use the username Example and password example
This step will be skipped if Single Sign-on is set to ldquotruerdquo
PowerTerm WebConnect 36 Getting Started Guide
4 After logging in to PowerTerm WebConnect Server the userrsquos applications are displayed
as defined by the administrator
5 To run an application select the desired application from the list and click Launch or
double-click the application The application will be launched in a separate window
610 Troubleshooting
When you encounter a problem the first step is to open the log file This file is located on
the client machine in the Ericom folder
Windows
CDocuments and SettingsltusernamegtEricomleclientEricomPluginlog
Linux
ltuser-home-directorygtEricomleclientEricomPluginlog
Following is a guide for diagnosing and fixing the problems in cases of error messages and
additional information
Error
Message
Solution
Version File
reading error
1 Check the lsquourlrsquo parameter in the webconnectxml file on the Web
server The value should be
httpltWebServerIPgtWebConnect
2 Try to run the following URL on the browser
Windows
httpltWebServerIPgtWebConnectwindowsptagentvertxt
Linux
httpltWebServerIPgtWebConnectlinuxix86qterm-
wcvertxt
The file contents displayed in the browser window should be in
the following form
560-rel14546
PowerTerm WebConnect Application Zone
560 - Main Release
ltrootgtPowerTerm WebConnect 56ltWebServergt
If the version file contents are not as shown check
- Is the Web Server running
- Are PowerTerm WebConnect Web Components and version files
PowerTerm WebConnect 37 Getting Started Guide
in place
3 On the Web server check ltPowerTerm WebConnect
rootgtwebwindowsptagentvertxt If the contents ldquolook wrongrdquo or
not in the proper form reinstall the PowerTerm WebConnect Web
components
4 On the client machine open the aforementioned URL in the
browser The file content should appear in the browser If it does
not it could be that the Web server is down
Web Server is
shut down
The webconnectxml configuration file must be located on the Web
server The explicit URL to this file is defined in the preferencesini
file (see Configure the Preferences File)
The error message contains the IP address of the Web server
Verify that the Web server on this machine is running
Version file
does not exist
on ltURLgt
See Version File reading error
The
configuration
file is not
accessible or
has a wrong
format
The webconnectxml configuration file must be located on the Web
server and the explicit URL to the configuration must be defined in
the preferencesini file (see Configure the Preferences File)
Try to open the URL specified in the error message in the
browser If it does not open then it either does not exist or it has
a wrong format
Preferences
file does not
exist in the
application
bundle
The preferencesini file containing the URL to the configuration
file was removed from the update site folder
Uninstall the current PowerTerm WebConnect client from the
client machine Create a new customized package (see
PowerTerm WebConnect Client Configuration) and reinstall it
Configuration
file URL is not
defined in
preference
file
The URL to the configuration file does not appear in the
preferencesini file (see Configure the Preferences File)
Uninstall the current PowerTerm WebConnect client from the
client machine Create a new customized package (see
PowerTerm WebConnect Client Configuration) and reinstall it
No IP address
could be
found for the
host
The Web server URL specified in the preferencesini file (see
Configure the Preferences File) or in the webconnectxml file (see
Configure the PowerTerm WebConnect Client) is an unknown
host
If the mistake is in the preferencesini file uninstall the current
PowerTerm WebConnect client from the client machine Create a
new customized package (see PowerTerm WebConnect Client
Configuration) and reinstall it
PowerTerm WebConnect 38 Getting Started Guide
If the mistake is in the webconnectxml file correct the file reopen
the Lotus Expeditor client
Cannot write
to destination
The temporary file cannot be written to the defined destination
Check the write permissions
Copied
configuration
file has wrong
format
The webconnectxml file as received from the specified URL has a
wrong format Correct the file and try again
PowerTerm
WebConnect
Agent URL is
malformed
The PowerTerm WebConnect Agent URL specified in the
webconnectxml file (see Configure the PowerTerm WebConnect
Client) does not have a proper HTTP format Correct the file and
try again
PowerTerm
WebConnect
Agent URL is
not defined
The PowerTerm WebConnect Agent URL parameter is not specified
in the webconnectxml file (see Configure the PowerTerm
WebConnect Client)
Correct the file and try again
The specified
destination
folder name
is wrong
The destination folder name contains illegal characters
ltgt|
Check the dst parameter in the webconnectxml file Correct the
file and try again
You do not
have
permissions
to write to
ltpathgt
The PowerTerm WebConnect Agent cannot be written to the
destination as defined Check the write permissions
The default destination defined in the version file should not to
be changed
A customized destination for PowerTerm WebConnect Agent
downloading can be defined in the webconnectxml file (See
Configure the PowerTerm WebConnect Client)
Check the destination value correct and try again
PowerTerm WebConnect 39 Getting Started Guide
About Ericom
Ericomreg Software is a leading provider of Application Access and Virtualization Solutions
Since 1993 Ericom has been helping users access enterprise mission-critical applications
running on a broad range of Microsoftreg Windowsreg Terminal Servers virtual Desktops
Blade PCs legacy hosts and other systems Ericom provides concrete business value by
helping organizations realize the benefits of their IT investments With offices in the United
States United Kingdom EMEA India and China Ericom also has an extensive network of
distributors and partners throughout North America Europe Asia and the Far East Our
expanding customer base is more than 30 thousand strong with over 7 million
installations
For more information on our products and services contact us at the location nearest to you
And visit our web site httpwwwericomcom
North America Western Europe International
Ericom Software Inc Ericom Software (UK) Ltd Ericom Software Ltd
231 Herbert Avenue Bldg 4 11a Victoria Square 8 Hamarpeh Street
Closter NJ 07624 USA Droitwich Worcestershire Har Hotzvim Technology Park
Tel +1 (201) 767 2210 WR9 8DE United Kingdom Jerusalem 91450 Israel
Fax +1 (201) 767 2205 Tel +44 (0) 845 644 3597 Tel +972 (2) 591 1700
Toll-free 1 (888) 769 7876 Fax +44 (0) 845 644 3598 Fax +972 (2) 571 4737
Email infoericomcom Email infoericomcouk Email infoericomcom
PowerTerm WebConnect 2 Getting Started Guide
Legal Notice
This manual is subject to the following conditions and restrictions
bull This Getting Started guide provides documentation for PowerTermreg WebConnect
Your specific product might include only a portion of the features documented in
this manual
bull The proprietary information belonging to Ericomreg Software Ltd is supplied solely for
the purpose of assisting explicitly and property authorized users of PowerTermreg
WebConnect
bull No part of its contents may be used for any purpose disclosed to any person or
firm or reproduced by any means electronic and mechanical without the express
prior written permission of Ericomreg Software Ltd
bull The text and graphics are for the purpose of illustration and reference only The
specifications on which they are based are subject to change without notice
bull The software described in this document is furnished under a license agreement
The software may be used or copied only in accordance with the terms of that
agreement
bull Information in this document is subject to change without notice Corporate and
individual names and data used in examples herein are fictitious unless otherwise
noted
Copyrightcopy 1999-2008 Ericomreg Software Ltd
Ericomreg and PowerTermreg are registered trademarks of Ericomreg Software Ltd which may
be registered in certain jurisdictions Other company and brand and product and service
names are trademarks or registered trademarks of their respective holders
PowerTerm WebConnect 3 Getting Started Guide
Table of Contents
ABOUT THIS DOCUMENT 5
1 PRODUCT OVERVIEW 6
2 INSTALLING AND STARTING POWERTERM WEBCONNECT 8
21 Install PowerTerm WebConnect (Windows edition) 8
22 StartStopRestart PowerTerm WebConnect Server (Windows edition) 8
23 Install Run and Stop PowerTerm WebConnect Server (Linux edition) 9
24 Install the Terminal Server Agent 10
25 Install PowerTerm WebConnect DeskView Server 10
26 Start the PowerTerm WebConnect Administration Tool 10
3 POWERTERM WEBCONNECT ADMINISTRATION TOOL AT A GLANCE 12
31 Publishing Applications and Documents 14
32 Create Terminal Emulation Connections 16
33 Test Connections 16
34 Launch the Application Zone or the Application Portal 17
35 Monitor a Users Sessions 17
36 View Intruders 17
4 ACCESSING VIRTUAL DESKTOPS AND BLADE PCS WITH POWERTERM WEBCONNECT 18
41 Step 1 Launch DeskView Administration Tool 18
42 Step 2 Add a Host 19
43 Step 3 Create a Pool 20
44 Step 4 Publish an ApplicationDesktop 20
5 DOWNLOAD AND RUN POWERTERM WEBCONNECT CLIENTS 22
6 POWERTERM WEBCONNECT CLIENT FOR LOTUS EXPEDITOR 23
61 Installation Package 23
62 Pre-installation steps 23
63 Install PowerTerm WebConnect Portlet on IBM Workplace server (for Windows OS) 24
PowerTerm WebConnect 4 Getting Started Guide
64 Install PowerTerm WebConnect Portlet on IBM Workplace server (for Linux OS) 26
65 Install PowerTerm WebConnect Portlet on IBM WebSphere 61 server (for Windows OS) 27
66 PowerTerm WebConnect Server Configuration 29
67 PowerTerm WebConnect Client Configuration 29
68 Installing PowerTerm WebConnect Client on Lotus Expeditor 35
69 Running PowerTerm WebConnect Client for Lotus Expeditor 35
610 Troubleshooting 36
ABOUT ERICOM 39
PowerTerm WebConnect 5 Getting Started Guide
About this Document
This guide explains how to install and get started with PowerTerm WebConnect (PowerTerm
WebConnect Enterprise PowerTerm WebConnect RemoteView PowerTerm WebConnect
DeskView PowerTerm WebConnect HostView and PowerTerm WebConnect for Oracle) It
is intended for Administrators of PowerTerm WebConnect If you need more detailed
explanations on the different options in the administration tools or more information about
how to work with PowerTerm WebConnect please refer to the PowerTerm WebConnect
Administrators Manual
This document contains the following chapters
Chap 1 Product Overview Important information for
easy installation
Pg 6
Chap 2 Installing and Starting
PowerTerm WebConnect
Describes how to install and
start PowerTerm
WebConnect (Windows and
Linux editions) and its
different components as well
on how to launch the
PowerTerm WebConnect
Administration Tool
Pg 8
Chap 3 PowerTerm WebConnect
Administration Tool at a
Glance
Describes some main
features of the PowerTerm
WebConnect Administration
Tool and how to create
Connections and Publish
Applications
Pg 12
Chap 4 Accessing Virtual Desktops
and Blade PCs with
PowerTerm WebConnect
Describes how to configure
hosts and create pools with
PowerTerm WebConnect
DeskView and PowerTerm
WebConnect for Oracle VM
Pg 18
Chap 5 Download and Run
PowerTerm WebConnect
Clients
Describes where you can
download and run the
various PowerTerm
WebConnect clients
Pg 22
Chap 6 PowerTerm WebConnect
Client for Lotus Expeditor
Describes how to install
configure and run
PowerTerm WebConnect
Client for Lotus Expeditor
Pg 23
PowerTerm WebConnect 6 Getting Started Guide
1 Product Overview
PowerTerm WebConnect is an Enterprise-Wide Application Access solution that enables you
to publish and provide secure remote access to applications running on Windows Terminal
Servers Virtual Desktops (on top of hypervisors such as VMWare Microsoft Xen and
Virtual Iron) Blade PCs and legacy hosts Once published applications can be accessed
and used by end-users in a secure and managed fashion
Major components of the PowerTerm WebConnect product include
bull PowerTerm WebConnect Server
Choose between either Windows or Linux editions of the server
bull PowerTerm WebConnect DeskView Server
This component makes it possible to publish Desktops and applications that run on
Virtual Machines and physical machines
bull PowerTerm Load Balancer
Install the PowerTerm Load Balancer as a part of PowerTerm WebConnect Server
installation on the same computer or independently on a separate computer
Once installed it provides System and Application Load Balancing
bull PowerTerm WebConnect Web Components
Install these components on a compatible Web server in order to provide end-
users with a Web interface to published applications
bull PowerTerm WebConnect Administration Tool
Install the PowerTerm WebConnect Administration Tool on the server or on an
administration workstation It can also be downloaded on-demand
bull Client-side components
These components are installed as a part of the ldquoWeb server componentsrdquo
installation option and are usually downloaded by users the first time they need
the corresponding functionality Some components can be pre-installed if needed
Client side components include
RemoteView for accessing Windows Terminal Server applications and Virtual
Desktops from Windows and Linux workstations as well as from Windows Based
Terminals and Windows XPe and Linux based thin clients
HostView for accessing character-based applications running on legacy hosts
including IBM Mainframe IBM AS400 OpenVMS Unix Linux Tandem from
Windows and Linux workstations as well as from Windows Based Terminals and
Windows XPe and Linux based thin clients
SupportView for remote desktop support
PrintView for managing print queues
QuickVNC for remote desktop connectivity
bull PowerTerm Terminal Server Agent
Install this component on Windows Terminal Servers This component enables
PowerTerm WebConnect 7 Getting Started Guide
True Seamless Windows for published applications remote application browsing
and publishing and Application Load Balancing
bull PowerTerm WebConnect Portlet for JSR 168 Portals
Install this component if you plan to access Windows published applications and
Legacy hosts from within JSR 168 compatible portal environments such as IBM
Workplace or WebSphere Oracle Portal Vignette Portal and the like
bull PowerTerm WebConnect Plugin for IBM Lotus Expeditor
Install this plugin if you plan to access Windows published applications and Legacy
Hosts from within the IBM Lotus Expeditor environment
bull PowerTerm WebConnect DeskView
This component makes it possible to publish Desktops and applications that run on
Virtual Machines and physical machines
The evaluation package of PowerTerm WebConnect that you can download and
install contains the PowerTerm WebConnect Enterprise product with all its
components Once activated the product will only include the components and
features of the specific PowerTerm WebConnect product you purchased
PowerTerm WebConnect 8 Getting Started Guide
2 Installing and Starting PowerTerm WebConnect
PowerTerm WebConnect includes both server-side and client-side components The server
side includes
bull PowerTerm WebConnect Server
bull PowerTerm WebConnect DeskView Server
bull PowerTerm WebConnect Load Balancer
bull PowerTerm WebConnect Administration tools (for WebConnect Server PowerTerm
Load Balancer and DeskView Server)
The client side has numerous clients such as
bull RemoteView
bull HostView (for both Windows and Linux)
bull QuickVNC etc
21 Install PowerTerm WebConnect (Windows edition)
1 Run the installation file typically named PowerTermWebConnect5xexe You will find
the file on the installation CD or you can download it from Ericoms website
2 Click Install and then enter your Serial Number or click Evaluate when prompted
3 Continue with installation and select Full Installation Server Administration Tool and
WebServer Components (default) in the Setup Type dialog
4 Complete the installation and click Exit and run PowerTerm WebConnect in the last
dialog of the installation Depending on your computer this may take a few minutes
The first time you launch the PowerTerm WebConnect server it will generate a
Diffie-Hellman key for SSL encryption This process may take several minutes
depending on the speed of your computer A visual progress indicator will show
you when this process is completed While this process is taking place PowerTerm
WebConnect clients will not be able to connect to the server
22 StartStopRestart PowerTerm WebConnect Server (Windows edition)
PowerTerm WebConnect server is installed as a Windows service
1 Launch the standard Services console from the Windows Control Panel On some
computers it may be located under the Administrative Tools group You can also run
the command SERVICESMSC The Services window is displayed
PowerTerm WebConnect 9 Getting Started Guide
2 Select PowerTerm WebConnect Server 5x service (the primary service of PowerTerm
WebConnect) where x is the version number and use standard StartStopRestart
options
The PowerTerm WebConnect Server Starter 5x service (the secondary service of
PowerTerm WebConnect) is designated for restarting the primary service in
cases of failure or any unexpected problems The secondary service is
controlled by internal logic of PowerTerm WebConnect and cannot be stopped
from the Services console
23 Install Run and Stop PowerTerm WebConnect Server (Linux edition)
Transfer the installation file to your Linux server and install the PowerTerm WebConnect
components in the RPM package using the following shell command
rpm ndashi WebConnecct-5x-0i586rpm
(lsquoxrsquo is the version number)
The PowerTerm WebConnect server will be installed to
optWebConnect5x
All PowerTerm WebConnect clients including PowerTerm WebConnect
Administration Tool are published via the Web server Therefore you need to
manually configure the Web server to publish the path optWebConnect56web
The name of the virtual directory has to be WebConnect5x
After configuring the virtual directory you can launch any client from httpltservernamegtWebConnect5xClientURLshtml
Users of Red Hat 72
If you installed the PowerTerm WebConnect server on Red Hat 72 you also have to install
the file libgcc-304-1i386rpm (44Kb) in order for PowerTerm WebConnect Server to run
This file can be downloaded from
ftprpmfindnetlinuxredhatupdates72enosi386libgcc-304-1i386rpm The file is
also available on the installation CD and can as well be downloaded from the ldquoEvaluate
PowerTerm WebConnect Linux x86 Editionrdquo web page
Use the following commands to run the PowerTerm WebConnect server
On RedHat
sbinservice webconnectd start
On Suse
etcrcdwebconnectd start
Use the following commands to stop the PowerTerm WebConnect server
On RedHat
sbinservice webconnectd stop
PowerTerm WebConnect 10 Getting Started Guide
On Suse
etcrcdwebconnectd stop
24 Install the Terminal Server Agent
PowerTerm WebConnect Terminal Server Agent must be installed on a Terminal Server
accessed using PowerTerm WebConnect It provides the True Seamless Windows
functionality for published applications remote browsing and publishing and Application
Load Balancing
The PowerTerm WebConnect Terminal Server Agent must be installed on every Terminal
Server in the cluster If you install the PowerTerm WebConnect server itself on a Terminal
Server you will be given the option to install the Terminal Server Agent as a part of the
server installation Alternatively use the PowerTermTerminalServerAgentexe file located in
the AddOnsTerminalServerAgent subdirectory under the PowerTerm WebConnect server
installation directory
To complete the installation you might need to restart the Terminal Server machine
25 Install PowerTerm WebConnect DeskView Server
PowerTerm WebConnect DeskView is automatically installed when you run PowerTerm
WebConnect Installation wizard ndash Full installation To run PowerTerm WebConnect
DeskView Server you also need Microsoft NET Framework v30 to be installed on your
computer If you do not have it installed then the installation wizard will place the
DeskViewServerSetupmsi and DeskViewAdminSetupmsi files in the AddOns folder
(ltPowerTerm WebConnect Installation FoldergtWebConnect 5xAddOnsDeskView
VDI) from where you can run the msi files at a later stage to install PowerTerm
WebConnect DeskView
26 Start the PowerTerm WebConnect Administration Tool
There are several ways to launch the PowerTerm WebConnect Administration Tool Select
the one most convenient for you
bull From Windows Start menu select Programs | Ericom Software | PowerTerm WebConnect
5x | PowerTerm WebConnect Administration Tool
If you changed the Program Folder during installation the Start menu path
may vary
bull Double-click PtAdminexe PtAdminexe is located in the bin directory of the
PowerTerm WebConnect installation folder
bull Rather than installing you can choose to download the Administration Tool to any
Windows computer Please refer to the PowerTerm WebConnect Sample URLs
page (httpltweb_servergtWebConnect5xClientURLshtml) for more details
A few things to remember
PowerTerm WebConnect 11 Getting Started Guide
When you launch the PowerTerm WebConnect Administration Tool for the first time the Connection dialog is displayed with the user Administrator No
password is required to enter just click Connect
In the Connection dialog (displayed when launching the Administration Tool) the
Host Name is localhost by default This is correct only if the Administration Tool
runs on the same machine as the server If the Administration Tool runs on a different machine you need to change the Host Name to the IP addressHostname
of the PowerTerm WebConnect server
When using the PowerTerm WebConnect Windows edition by default the
Administration Tool will deny any connection attempts from any computer other
than the local machine
PowerTerm WebConnect 12 Getting Started Guide
3 PowerTerm WebConnect Administration Tool at a Glance
PowerTerm WebConnect Administration Tool manages published applications user sessions
and server configuration The administrator can perform operations such as multiple
application publishing sending messages to logged-on users shutting down sessions and
monitor user activity
To perform the tasks described in this chapter you must launch the Administration Tool via one of the methods detailed in chapter Start the PowerTerm
WebConnect Administration Tool
Launching the Administration Tool from the system tray or using the
Administration Tool launched after completed installation will not allow you to
activate certain features
After you launched the Administration Tool and connected to the server you will receive a
Welcome screen where you select desired activity
bull Publish Multiple Applications opens the Publish Multiple Applications wizard
bull Configure Load Balancer opens PowerTerm Load Balancer Administration Tool
bull Create a Host Connection opens the Add Connection dialog
bull Configure Active Directory opens the Directory Services dialog
PowerTerm WebConnect 13 Getting Started Guide
Close the Welcome screen to enter the Administration Tool main
screen
The Administration Tool main screen has three sections
bull User section lists all users defined in the server
bull Group section lists all groups defined in the server
bull Connection section lists all connections and published applications defined in the
server
By default only the Connection section is displayed when you first open Administration Tool
There are three predefined example-connections ldquoExample_As400rdquo ldquoExample_VTrdquo and
ldquolocalhostrdquo You can test them prior to defining your own
1 Right click the connection you want to test and select Test The PowerTerm
WebConnect HostView Login dialog appears
2 Type example for User Name and example for Password
Credential fields are case sensitive
3 Click Login The desired connection with its pre-programmed demo application is
launched
PowerTerm WebConnect 14 Getting Started Guide
31 Publishing Applications and Documents
In order to enable access to applications and documents on Windows Terminal Servers
publish these applications and documents from the Administration Tool When publishing
applications and content you can specify which servers will be used in a Terminal Server
cluster and which users and groups will have access to these services Once you have
published such applications and documents the RemoteView client can be used to access
them
If you need to provide access to multiple applications on a Terminal Server use the Multiple Application Publishing wizard to significantly reduce the time and
effort required to publish these applications
To publish multiple Windows applications
1 Click Publish Multiple Applications in the Welcome screen The Choose Terminal Server
for Browsing dialog appears
2 Provide the address of the Terminal Server which will be used for browsing and click OK The Application Publisher Step 1 dialog appears This dialog lists all the
applications available in the specified serverrsquos Start menu
3 Select those applications found in the Programs folder of the designated server that you want to publish and click Next The Application Publisher Step 2 dialog appears
4 Determine the destination of your publishing and click Next The Application Publisher
Step 3 dialog appears
5 Determine the Color Quality of your published application
6 Determine the start mode in which you want to run the published application - normal maximized or minimized - and click Next The Application Publisher Step 4
dialog appears
7 Choose the connection speed that matches your infrastructure The connection speed
setting determines the value of three visual effects settings You can also override
these settings specifically
8 Determine whether you prefer the window to display their content while being
dragged or just the outline By default the same setting is used as the client desktop
9 Click Next The Application Publisher Step 5 dialog appears
10 Specify where sounds are to be played ndash locally or remotely
11 Determine which local devices the remote session will have access to (local drivers printer etc) and click Next The Application Publisher Step 6 dialog appears
12 If you have the PowerTerm Load Balancer installed Use all Servers (default) allows the application to run on any Terminal Server in the
cluster This setting is appropriate when the application is installed on all the Terminal
Servers Alternatively you select specific Terminal Servers on which to run this
application
If you have not installed the PowerTerm Load Balancer you will need to explicitly
specify the address of the Terminal Server on which the application will be run
PowerTerm WebConnect 15 Getting Started Guide
13 Click Next The Application Publisher Step 7 dialog appears
14 Select the users groups or OUs to which you wish to publish the applications and click Next The Application Publisher Step 8 dialog appears By default applications will
be published to everybody
15 Click Advanced Settings to modify settings such as the login credentials to the
Terminal Servers By default PowerTerm WebConnect credentials will be passed
through to the Terminal Server
16 Click Finish The published applications appears in the Connection List
Right-click and select Properties or double click on the published application in the
Connections list to view and modify any of the settings which you previously
defined
To publish a remote Desktop
1 Select Action | New | Remote Desktop The Application Publisher Step 1 dialog appears
2 Type the Display Name which will be the name presented to the end-users and click
Next The Application Publisher Step 2 dialog appears
3 Specify where icons for the published desktop will be displayed to the end-user in Publish to
4 Click Choose Icon to replace the desktoprsquos default icon Select the desired icon from
the list that appears
5 Click Next The Application Publisher Step 3 dialog appears
6 Determine Screen Size and the Color Quality of the published desktop
7 If desirable select Show Connection Bar in Full Screen Mode
8 Click Next The Application Publisher Step 4 dialog appears
9 Choose the connection speed that matches your infrastructure The connection speed
setting determines the value of three visual effects settings You can also override
these settings specifically
10 Click Next The Application Publisher Step 5 dialog appears
11 Specify where sounds are to be played ndash locally or remotely Where to Apply Window
Key Combinations and which local devices you want to automatically connect to when
logged on to the remote computer
12 Click Next The Application Publisher Step 6 dialog appears
13 Specify the Server Address and Port Number of the Terminal Server that weill provide
the desktop and click Next The Application Publisher Step 7 dialog appears
14 Select the users groups or OUs to which you wish to publish the desktop and click Next The Application Publisher Step 8 dialog appears
Select the Server group to allow all users to access the published application
15 Click Advanced Settings to modify settings such as the login credentials to the
Terminal Servers By default PowerTerm WebConnect credentials will be used
PowerTerm WebConnect 16 Getting Started Guide
16 Click Finish The published application appears in the Connection List
Right-click Properties or double click on the published application in the
Connections list to modify any of the settings which you previously defined
32 Create Terminal Emulation Connections
To provide access to legacy host systems you will need to create Terminal Emulation
connections For each such connection you can specify the host address emulation type
login script and more Once you have created these connections users will be able to
launch them using HostView (Windows or Linux) WebView or the Java client as
appropriate
1 Click Create a Host Connection in the Welcome screen The Add Connection dialog
appears
2 Enter a Name for the new connection
3 Specify an Owner for the new connection The possibilities are
[None] the connection will not be allowed to run by anyone and it will not be
displayed in any Connection list Server the connection will be accessible for all users of this PowerTerm
WebConnect server A specific group the connection will be accessible for all users of the specified
group A specific user the connection will be accessible for a specified user only
4 Leave category Terminal Emulation selected
5 Select Terminal Type Terminal Model and Communication Type as needed
6 Specify the Host Name or IP address of your host
7 Specify other parameters as needed
8 Select the Security Type as needed if your host supports SSL or SSH and specify
the appropriate details in the Details dialog
9 Use the Settings Key Mapping and Power Pad options to further customize the
connection
10 Click OK and the connection is created
33 Test Connections
It is recommended to test published applications or host connections before they are made
available to end-users
To test a connection
bull Right-click the target connection from the Connection section of the main screen and
select Test
Alternatively
PowerTerm WebConnect 17 Getting Started Guide
1 Select Tools | Run ltdesired clientgt The Login to WebConnect dialog appears
2 Enter the User Name and Password for the individual who owns the connection that
you want to test and click Login The desired PowerTerm WebConnect client is started
and the Connect dialog appears
3 Select the desired connection and click Connect The test is executed
34 Launch the Application Zone or the Application Portal
Users can access the published applications from the Application Zone application launcher
or from the Application Portal web interface
To use the Application Zone go to Start menuProgramsEricom SoftwarePowerTerm
WebConnect 5x and select Client URLs Alternatively type the following URL into your Web
browserrsquos address bar httpltserver addressgtWebConnect5xClientURLshtml In the
page that opens click on the Run button next to the Application Zone to launch it
To use the Application Portal go to Start menuProgramsEricom SoftwarePowerTerm
WebConnect 5x and select it Alternatively type the following URL into the Web browserrsquos
address bar httpltserver addressgtWebConenct5xportalwindowsindexasp
35 Monitor a Users Sessions
From the Administration Tool you can monitor the users sessions and may intervene if
necessary This intervention may result in your input appearing on the users screen The
user receives a notification when an administrator begins and ends monitoring the session
1 Select View | Client Sessions or click to see all the active client sessions
2 Select the desired active session and right-click Attach The Password Verify dialog
appears
3 Enter your password and click OK Some notification dialogs appears and the selected
PowerTerm WebConnect session is viewed
36 View Intruders
bull The Intruders window shows suspected attempts at breaching security After several
suspected intrusion attempts users are blocked temporarily
bull In addition to showing suspected intrusion attempts the Intruders window allows
you to remove restrictions on users
bull Select View | All Intruders or click
PowerTerm WebConnect 18 Getting Started Guide
4 Accessing Virtual Desktops and Blade PCs with PowerTerm WebConnect
This chapter provides instructions on configuring PowerTerm WebConnect for Virtual
Desktop Infrastructure (VDI)
41 Step 1 Launch DeskView Administration Tool
Verify that PowerTerm WebConnect is installed on your server and launch PowerTerm
WebConnect Admin Tool
bull Select Tools | Open VDI Manager The PowerTerm WebConnect DeskView Administration
Tool opens
The first time you launch the DeskView Administration Tool you will be prompted to install
the tool
PowerTerm WebConnect 19 Getting Started Guide
Microsoft Management Console 30 is required for PowerTerm WebConnect DeskView
Administration Tool If you do not have this installed you will also automatically be
prompted to install this update
Follow the installation processes when you are prompted for either install PowerTerm
WebConnect DeskView Administration Tool will automatically launch when these
installations are completed
42 Step 2 Add a Host
1 Right-click Virtualization Hosts and select Add Host The Add a New Host wizard
opens Click Next
2 Enter a Host Name as you would like it to appear in PowerTerm WebConnect
DeskView Administration Tool and a description (optional) Click Next
3 Specify the Virtualization Server type and click Next
4 Specify the connection information and click Next
VMWare Virtual Center v1x and 2x
Specify the HTTPS Web Service address and a UsernamePassword that can access
the host
VMWare Virtual Server 2005
Click Start and then Run
Type ldquoservicesmscrdquo and click OK
Scroll down to PowerTerm WebConnect DeskView Server service and open
Properties
Change the Login Account for the service to match the Domain Administrator
account and password used when setting up Microsoft Virtual Server 2005 and
restart the service Enter the IP or NETBIOS name of the Microsoft Virtual Server 2005 server as the
Server Address in the Connection Broker Wizard
Xen Server
Specify the hypervisor IP address or NETBIOS name the Root UsernamePassword
to the hypervisor and the Service port (default 80)
Oracle VM
Specify the Serverrsquos agent URL and Port (default 8899) for example
httpsltservernamegt8899
Specify the Oracle VM hypervisorrsquos Oracle Agent UsernamePassword (default
username oracle)
5 Click Finish to add the new Host
To configure Virtual Machines for use install the Ericom Tools (vmagentmsi) on each of the
virtual machines on the new host for PowerTerm WebConnect DeskView to recognize them
The vmagentmsi installer is located on the PowerTerm WebConnect server in ltPowerTerm
WebConnect installation foldergtAddOnsDeskView VDI folder (default installation
PowerTerm WebConnect 20 Getting Started Guide
folder is xProgram FilesEricom SoftwareWebConnect 56) During installation you
will need to enter the DeskView IP address or NETBIOS name
If you are using Microsoft Virtual Server 2005 as your Virtualization Host use the
IP address of the DeskView server only when installing the Ericom Tool package
43 Step 3 Create a Pool
Pools are used to organize Virtual Machines (VM) into logical groups This enables
organizations to combine and order resources from multiple systems into one entity To
access available resources end-users simply connect to PowerTerm WebConnect to access
any configured resource
1 Right-click Pools and select Create Pool The Create a Pool wizard opens Click
Next
2 Enter a Pool name as you wish it to appear and a description (optional) and click
Next
3 Specify the Pool type and click Next
4 Specify the Assignment type and click Next
Permanently will cause a virtual machine to affix to the user who has launched
that virtual machine For the duration of the session will cause any virtual machine that is not in use to
be returned to the pool for any user to launch
5 Specify the LogoffDisconnect event and click Next
Select what you would like to happen after a user logs off from a virtual machine
in this pool
Select what you would like to happen when a user is disconnected from a virtual
machine in this pool
6 Click Finish to add the new Pool
You will need to assign virtual machines from your virtualization hosts to your created pool
1 Right-click the pool and select Assign Machines The Assign Machines to ltyour
pool namegt dialog opens
2 Highlight the desired virtual machine(s) and click Select Click OK
44 Step 4 Publish an ApplicationDesktop
1 Return to PowerTerm WebConnect Admin Tool to publish DeskView pools
2 Determine whether to publish a full desktop or a seamless application running
from a virtual desktop
For a full desktop
Select Action | New | Remote Windows Desktop
For a seamless application
Select Action | New | Windows Application
PowerTerm WebConnect 21 Getting Started Guide
3 Select Virtual Desktop in the first step of the wizard and click Next
4 Follow the wizardrsquos instructions until you reach the Virtual Desktops step
5 Select a pool that you previously created and that you would like this connection to choose virtual machines from Click Next
6 Continue and complete the reminder of the wizardrsquos steps
Once the resource is published users who have been assigned access will be able to use it
immediately
PowerTerm WebConnect 22 Getting Started Guide
5 Download and Run PowerTerm WebConnect Clients
PowerTerm WebConnect clients are automatically downloaded and installed onto the client
devices For detailed information and samples please refer to the PowerTerm WebConnect
Sample URLs page To see this page navigate your browser to
httpltweb_servergtWebConnect5xClientURLshtml
PowerTerm WebConnect 23 Getting Started Guide
6 PowerTerm WebConnect Client for Lotus Expeditor
61 Installation Package
PowerTerm WebConnect client for Lotus Expeditor is provided to IBM in an Update Site
package This is a ZIP archive containing the Update Site with the Eclipse feature and plug-
in that comprises the PowerTerm WebConnect client
Extract the ZIP file keeping the foldersrsquo structure intact
NOTE In Winzip verify that the ldquoUse folder namesrdquo option is set to TRUE
Package structure
Update Site
- plugins
- PowerTermWebConnectClient_560365jar
- features
- comericomWebConnect_560365jar
- sitexml
config
- webconnectxml
Definitions
bull webconnectxml PowerTerm WebConnect client configuration file
bull comericomWebConnect_560365jar PowerTerm WebConnect client feature file
bull PowerTermWebConnectClient_560365jar PowerTerm WebConnect client plugin file
62 Pre-installation steps
PowerTerm WebConnect client for Lotus Expeditor does not run independently but in
conjunction with PowerTerm WebConnect Server You can either install it and define your
users groups and applications or use Ericom Softwarersquos Demo PowerTerm WebConnect
Server
bull If you decide to install PowerTerm WebConnect Server you will need the full
installation ie the PowerTerm WebConnect Server and the Web components If you
do not have the installation CD you can download and install a trial version from
wwwericomcom
PowerTerm WebConnect 24 Getting Started Guide
bull If you decide to use Ericom Softwarersquos Demo PowerTerm WebConnect Server then
skip to the chapter Installing PowerTerm WebConnect Client on Lotus Expeditor
63 Install PowerTerm WebConnect Portlet on IBM Workplace server (for Windows OS)
Step 1 Install PowerTerm WebConnect Server
If PowerTerm WebConnect Server and IBM Workplace Server are on separate machines
bull Configure PowerTerm WebConnect Server
Launch PowerTerm WebConnect Administration Tool
Open Files | Configuration | Main
In the [Portal] section edit
Machines=localhostltIBM sever machinegt
bull Configure PowerTerm WebConnect Web components
Copy the ldquowebrdquo folder from the PowerTerm WebConnect server installation to the
IBM Workplace server machine
Create an Alias or a Virtual directory to it named WebConnect on the Web
server providing access to it for the users This is in order to enable the users to
download the necessary files to run their applications
Step 2 Enable JSR portlets
1 On IBM Workplace Server go to ltPortalServergtsharedappconfigservicesConfigServiceproperties
2 Edit portalenablejsr168=true
3 Save and close the file
Step 3 Enable SSO
1 On IBM Workplace Server go to ltPortalServergtsharedappconfigservicesLoaderServiceproperties
2 Edit commandpath=comericomportalcommandscomibmwpsenginecommands
3 Save and close the file
Step 4 Copy Files
The following files need to be copied from WebConnect ServerAddOnsIBM
WorkplacePortlet folder to IBM Workplace Server
File name to copy Destination folder
OpenSSLdll ltAppServergtjavajrebin
IbmPortaldll ltAppServergtjavajrebin
IbmPortalini ltAppServergtjavajrebin
PowerTerm WebConnect 25 Getting Started Guide
WebConnectPortaljar ltAppServergtlib
EricomLoginjar ltPortalServergtsharedapp
Step 5 Portlet Configuration
1 On IBM Workplace Server go to ltAppServergtjavajrebinIbmPortalini
2 You can modify the following parameters in the [Server=WebConnect] section webserverport=ltIBM web server portgt
Specifies the Web server port for accessing the PowerTerm WebConnect clients folder
Default 80 Address
Specifies the address of the PowerTerm WebConnect Server machine for Portlet to
connect to when PowerTerm WebConnect Server is located on a different machine
than the IBM Workplace Server CustomAddress
Specifies the addresss of the PowerTerm WebConnect Server machine for Clients to connect to If CustomAddress is the same as Address then this may be omitted webserveraddr
Specifies the address of the Web Server machine when it is located on a different
machine than the IBM Workplace Server
3 Restart the IBM server ltPortalServergtrootscriptsstopWorkplaceServicesbat ltPortalServergtrootscriptsstartWorkplaceServicesbat
This procedure may take about 20 minutes
Step 6 Install the Portlet
1 In a Web browser open the URL httpltIBM Workplace
Servergt9081lwpmyworkplace to open the IBM Workplace Portal
2 Login as administrator
3 Go to Administration | Portlets | Install
4 Browse to the PowerTerm WebConnectwar file located on PowerTerm WebConnect
Server and click Next
5 Click Install
Step 7 Create an Application page
1 Login to the Workplace
2 Go to Portal User Interface | Manage Pages
3 Search for My Work
4 Click the My Work link and select New Page
5 Name the page PowerTerm WebConnect and click OK
6 Click OK again You will see the created page on the list
7 Click the pencil icon on the new page and select the 1 square layout
PowerTerm WebConnect 26 Getting Started Guide
8 Click Add Portlet and search for PowerTerm WebConnect
9 Select it and click OK
10 Click Done
11 Click My work at the top of the page PowerTerm WebConnect is displayed on the list
Step 8 Run the Portlet
1 Restart IBM Workplace Server
2 Open IBM Workplace Portal in a browser httpltportal servergtlwpmyworkplace
3 Login to IBM Workplace Server
4 Click My work PowerTerm WebConnect portlet is displayed
5 Launch it The Userrsquos applications as defined on PowerTerm WebConnect Server
appear
6 Click an application to launch it
64 Install PowerTerm WebConnect Portlet on IBM Workplace server (for Linux OS)
Step 1 Enable JSR 168 portlets
1 Go to optIBMWorkplacePortalServersharedappconfigservicesConfigServiceproperties
2 Modify the portalenablejsr168 property to ldquotruerdquo
3 Restart the server cd optIBMWorkplacePortalServerrootscripts
Run stopWorkplaceServicessh
Run startWorkplaceServicessh
This procedure can take up to 20 minutes
4 Log on to the workplace server at httpltworkplace servergt9081lwpmyworkplace using
the administrators username and password
Step 2 Install the portlet
1 Restart IBM Workplace Server
2 In a Web browser open the URL httpltworkplace server IPgtlwpmyworkplace
3 Login to IBM Workplace Server as an administrator
4 Go to Administration | Portlets | Install
5 Browse to the PowerTerm WebConnectwar file located on PowerTerm WebConnect
Server and click Next
6 Click Install
PowerTerm WebConnect 27 Getting Started Guide
Step 3 Install the Application page
1 Login to the workplace as administrator
2 Go to Administration | Portal User Interface | Manage Pages
3 Search for My Work
4 Click the My Work link and select New Page
5 Name the page PowerTerm WebConnect and click OK
6 Click OK again You will see the created page on the list
7 Click the pencil icon and select the 1-square layout
8 Click Add Portlet and search for PowerTerm WebConnect
9 Select it and click OK
10 Click Done
11 Click My work on top and PowerTerm WebConnect is displayed on the left bar
Step 4 Run the portlet
1 Restart IBM Workplace Server
2 Open IBM Workplace Portal in a browser httpltportal servergtlwpmyworkplace
3 Login to IBM Workplace Server
4 Click My work PowerTerm WebConnect portlet is displayed
5 Launch it The Userrsquos applications as defined on PowerTerm WebConnect Server
appear
6 Click an application to launch it
65 Install PowerTerm WebConnect Portlet on IBM WebSphere 61 server (for Windows OS)
Step 1 Install PowerTerm WebConnect Server
You have to configure PowerTerm WebConnect Server if it and the IBM WebSphere Server
are on separate machines
1 Launch PowerTerm WebConnect Administration Tool
2 Open Files | Configuration | Main
3 In the [Portal] section edit Machines=localhostltIBM sever machinegt
Step 2 Copy Files
The following files need to be copied from WebConnect ServerAddOnsIBM
WebSpherePortlet folder to IBM WebSphere Server
PowerTerm WebConnect 28 Getting Started Guide
File name to copy Destination folder
OpenSSLdll ltAppServergtjavajrebin
IbmPortaldll ltAppServergtjavajrebin
IbmPortalini ltAppServergtjavajrebin
WebConnectPortaljar ltAppServergtlib
Step 3 Portlet Configuration
1 On IBM Workplace Server go to ltAppServergtjavajrebinIbmPortalini
2 You can modify the following parameters in the [Server=WebConnect] section webserverport=ltIBM web server portgt
Specifies the Web server port for accessing the PowerTerm WebConnect clients folder
Default 80 Address
Specifies the address of the PowerTerm WebConnect Server machine for Portlet to
connect to when PowerTerm WebConnect Server is located on a different machine
than the IBM Workplace Server CustomAddress
Specifies the addresss of the PowerTerm WebConnect Server machine for Clients to connect to If CustomAddress is the same as Address then this may be omitted webserveraddr
Specifies the address of the Web Server machine when it is located on a different
machine than the IBM Workplace Server
3 Restart the IBM server ltAppServergtProfilesAppServer01binstopServerbat ltAppServergtProfilesAppServer01binstartServerbat
This procedure may take about 20 minutes
Step 4 Install the Portlet and create an Application page
1 In a Web browser open the URL httpltIBM WebSphere Servergt9060ibmconsole
to open the IBM WebSphere Portal
2 Login and go to Applications | Install New Application
3 Browse to the PowerTerm WebConnectwar file located on PowerTerm WebConnect
Server
4 Enter Context root and click Next The Select installation options dialog appears
5 Optional change options to your preference or keep the default
6 Click Next
7 Select Ericom in the Module column click Apply and then Next
8 Click Finish and then Save
9 Select Applications | Enterprise Applications
10 Select PowerTerm WebConnectwar checkbox and click Start
PowerTerm WebConnect 29 Getting Started Guide
11 Enter in the Web browser the URL httpltIBM WebSphere
Servergt9080ltContext rootgtEricom portlet The Login dialog appears
12 Login and you will see PowerTerm WebConnect displayed on the list
Step 5 Run the Portlet
1 Restart IBM WebSphere Server
2 Open IBM WebSphere Portal in a browser httpltportal servergt9080ltContext
rootgtEricom portlet
3 Login to IBM WebSphere Server
4 Launch it The Userrsquos applications as defined on PowerTerm WebConnect Server
appear
5 Click an application to launch it
66 PowerTerm WebConnect Server Configuration
bull To enable the Lotus Expeditor to run the PowerTerm WebConnect client the
System Administrator must provide the users with accounts on PowerTerm
WebConnect Server (see the PowerTerm WebConnect Administratorrsquos Manual for
instructions on how to create users groups and connections on the PowerTerm
WebConnect Server)
bull To enable PowerTerm WebConnectrsquos Single Sign-On feature the System
Administrator must create a PowerTerm WebConnect user with the same
username and password as used for the Lotus Expeditor For a managed Lotus
Expeditor the credentials used are the username and password sent to the
managing server For an unmanaged Lotus Expeditor the operation system
username and the Lotus Expeditor password are used as credentials
NOTE If a password is not defined then the Single Sign-On will fail and the user will be
prompted with a login dialog
67 PowerTerm WebConnect Client Configuration
The PowerTerm WebConnect client is configured in webconnectxml located in the config
folder webconnectxml parameters are
url The PowerTerm WebConnect Agent url
server The PowerTerm WebConnect Server address
sso The Single Sign-On feature
dst The local destination for downloading PowerTerm WebConnect
components
PowerTerm WebConnect 30 Getting Started Guide
url
PowerTerm WebConnect components are installed on a Web server Their default url is
Windows Agent
httpltWebServer IPgtWebConnectwindowsptagentcab
Linux Agent
httpltWebServer IPgtWebConnectlinuxix86qterm-wczip
The url parameter must include the first part of the url (which is identical for both Windows
and Linux agents)
The PowerTerm WebConnect client will automatically append the appropriate suffix in
order to create a full accurate url
Example
ltitem key=rdquourlrdquo value=httpadminserverWebConnectgt
server
The computer name or IP address of the PowerTerm WebConnect Server machine
The PowerTerm WebConnect client will log in to this PowerTerm WebConnect Server
display the applications defined on it and run them according to this serverrsquos configuration
Format ltserver IPgt[ltportgt]
where default port is 4000 (can be edited)
Example
ltitem key=rdquoserverrdquo value=rdquoadmin24000rdquogt
sso
Determines whether Single Sign-on will be used to log in to PowerTerm WebConnect
Server Values
bull True (default) the client should automatically log in to the PowerTerm WebConnect
Server using the same credentials as the ones used to log in to the Lotus Expeditor
client
The System Administrator must verify that these credentials can log in to the
PowerTerm WebConnect Server
bull False the user will be prompted with a login dialog or will log in automatically using
previously saved credentials
Example
ltitem key=rdquossordquo value=rdquotruerdquogt
Autologin mode
PowerTerm WebConnect 31 Getting Started Guide
If sso is set to True the user is not prompted for credentials and the login process to
PowerTerm WebConnect Server is done automatically sending the credentials used for the
Lotus Expeditor unless the Lotus Expeditor does not have a password defined (In the
Lotus Expeditor preferences page | Password| Prompt me for a password at start up checkbox)
However if Single Sign-on is not used there are several options regarding Autologin that
can be defined in the PowerTerm WebConnect Preferences page Options
bull Yes
bull No
bull Interactive
bull First time interactive (default) ndash Simplifies the login process to PowerTerm
WebConnect Server In this mode the first time the user logs in to PowerTerm
WebConnect Server he will be prompted for his credentials with the Login dialog
These credentials will be stored in the machine and from then on the login process to
PowerTerm WebConnect Server will be done automatically
1 Open File | Preferences from the Lotus Expeditor and select PowerTerm WebConnect
2 In the Autologin to WebConnect Server section select First Interactive and click OK
3 Start PowerTerm WebConnect Client for Lotus Expeditor If credentials were entered
at least once then the next time the client will connect to PowerTerm WebConnect
Server without prompting for the user name and password
The Administrator must configure the Agent to do nothing when it exits for the
feature to work this way See PowerTerm WebConnect Administratorrsquos Manual for more information about defining Autologin
bull Allow multiple selection ndash Defines whether the user can launch more than one
application at a time (by using the ltCtrlgt or ltShiftgt button while selecting applications)
dst
Defines the path to download PowerTerm WebConnect components on the client machine
The dst parameter can contain macros which are translated by the PowerTerm WebConnect
Client for Lotus Expeditor during runtime The macros should be placed between percent
symbols () for example WebServer
When such a value is defined the PowerTerm WebConnect Client for Lotus Expeditor
substitutes the entire expression for the macrorsquos value
The PowerTerm WebConnect Client for Lotus Expeditor does not support the use
of environment variables as macros
Macros are not case sensitive
Macros supported by PowerTerm WebConnect Client for Lotus Expeditor
Macro name Description
WebServer The name of the Web server
It is obtained from the PowerTerm WebConnect Agent url
PowerTerm WebConnect 32 Getting Started Guide
parameter
Name The name of the clientrsquos CAB or ZIP file eg ldquoptagentrdquo
Display The clientrsquos display name from the version file
Version The clientrsquos version value It is obtained from the version
file
Root The default root location
Windows ldquoCrdquo
LinuxUnix an empty string
OSDir Windows Windowsrsquo installation directory for example
ldquoCWindowsrdquo
Linux an empty string
OSDrive Windows Windowsrsquo installation drive for example ldquoCrdquo
Linux an empty string
HomePath Windows The HOMEPATH environment variable
Linux The HOME environment variable
Home The Ericom folder in the userrsquos home directory
Windows CDocuments and SettingsltusergtApplication
DataEricom
Linux ltusergtEricom
In addition to the predefined macros listed above the PowerTerm WebConnect client
supports the usage of Java System Properties
Java System Properties available for users on Windows XP SP2
Java System Property Name Value Example
javaversion 150
javavendorurl httpwwwibmcom
javahome CIBMcommonpluginscomibmpvcwctruntim
esj2sewin32x86_150SR2-
20060511rcpeclipsepluginscomibmrcpj2sew
in32x86_150SR2-20060511jre
javavmspecificationversion 10
javavmversion 23
javavmvendor IBM Corporation
javavmname IBM J9 VM
PowerTerm WebConnect 33 Getting Started Guide
javaiotmpdir CDOCUME~1dianaLOCALS~1Temp
javacompiler j9jit23
javaextdirs CIBMcommonpluginscomibmpvcwctruntim
esj2sewin32x86_150SR2-
20060511rcpeclipsepluginscomibmrcpj2sew
in32x86_150SR2-20060511jrelibext
osname Windows XP
osarch x86
osversion 51 build 2600 Service Pack 2
pathseparator
username Jone
userhome CDocuments and SettingsJone
userdir CIBMRSA
usertimezone GMT+0200
System properties available for users on Linux RedHat 9
Java System Property Name Value Example
javaversion 150
javavendorurl httpwwwibmcom
javahome usrjavajre150_07
javavmversion 150
javavmvendor IBM Corporation
javavmname IBM J9 VM
javaclasspath
javalibrarypath
javaiotmpdir tmp
javacompiler
javaextdirs
osname Linux
osarch i386
osversion 2420-8
pathseparator
PowerTerm WebConnect 34 Getting Started Guide
username root
userhome root
userdir root
System properties names are placed in the configuration file within percent symbols ()
(like macros)
671 Configure the PowerTerm WebConnect Client
1 Open the Config Folder and edit the webconnectxml file Example
ltxml version =rdquo10rdquo encoding=rdquoUTF-8rdquogt
ltsection name=rdquoparametersrdquogt
ltitem key=rdquourlrdquo value=httpadminserverWebConnect56gt
ltitem key=rdquoserverrdquo value=rdquoadmin24000rdquogt
ltitem key=rdquossordquo value=rdquotruerdquogt
ltitem key=rdquodestrdquo value=rdquoCProgram FilesEricomrdquogt
ltsectiongt
2 Save the customized webconnectxml to a Web server folder available to all users It is
recommended to use the same Web server as the PowerTerm WebConnect Agent
Example
ltWebConnect installation foldergtwebwebconnectxml
3 Test the accessibility to this file - Type the URL of webconnectxml in the browser
Example
httpltWebServer IPgtWebConnectwebconnectxml
The contents of the file should be displayed
672 Configure the Preferences File
1 Open the plugins folder and open the PowerTermWebConnectClient_560365jar file
You can use Winzip version 70 and up or in Windows XP ndash Create a new file type for the
jar extension click advanced and select compressed (zipped) folder in the drop down list
Now you can open the JAR files in the Windows Explorer
The default contents of the file
configURL=httpleericomcomWebConnectwebconnectxml
2 Specify the accurate URL of the webconnectxml file Example
httpltWebServer IPgtWebConnectwebconnectxml
3 Save the file and close it The WinZip will display the following dialog
ldquoFile preferencesini has been changed since it was extracted Update archive
with this filerdquo
PowerTerm WebConnect 35 Getting Started Guide
4 Click Yes and close the archive
If you are editing the file from within the explorer you will have to save the file elsewhere
and then drag it to the explorer window where the JAR file is open
68 Installing PowerTerm WebConnect Client on Lotus Expeditor
1 Start the Lotus Expeditor client
2 Select File | Application | Install
3 Select Search for new features to install and click Next
4 Select Add Folder Location and type or select the location of the update site folder from
the provided package Click OK
5 Select the location you have just created and click Finish
6 In the Select the feature to install tree select Powerterm WebConnectUpdate Site Click
Next
7 Select I accept the terms in the license agreements and click Next
8 Click Finish
9 When prompted restart the platform
69 Running PowerTerm WebConnect Client for Lotus Expeditor
1 Click Open The PowerTerm WebConnect option is displayed
2 Select PowerTerm WebConnect The application will automatically connect and start
downloading the components from PowerTerm WebConnect Server
IMPORTANT
If you did not install PowerTerm WebConnect Server and are instead connecting to Ericom
Softwarersquos Demo WebConnect Server then you need to open port 443 in the firewall
691 PowerTerm WebConnect Client Workflow
1 PowerTerm WebConnect client reads the URL of webconnectxml from the preferencesini
file and requests it
2 When the webconnectxml is successfully downloaded the application reads the
configuration connects to the specified Web server downloads the PowerTerm
WebConnect components and connects to the PowerTerm WebConnect Server
3 The user is requested to login to the PowerTerm WebConnect Server For testing you
can use the username Example and password example
This step will be skipped if Single Sign-on is set to ldquotruerdquo
PowerTerm WebConnect 36 Getting Started Guide
4 After logging in to PowerTerm WebConnect Server the userrsquos applications are displayed
as defined by the administrator
5 To run an application select the desired application from the list and click Launch or
double-click the application The application will be launched in a separate window
610 Troubleshooting
When you encounter a problem the first step is to open the log file This file is located on
the client machine in the Ericom folder
Windows
CDocuments and SettingsltusernamegtEricomleclientEricomPluginlog
Linux
ltuser-home-directorygtEricomleclientEricomPluginlog
Following is a guide for diagnosing and fixing the problems in cases of error messages and
additional information
Error
Message
Solution
Version File
reading error
1 Check the lsquourlrsquo parameter in the webconnectxml file on the Web
server The value should be
httpltWebServerIPgtWebConnect
2 Try to run the following URL on the browser
Windows
httpltWebServerIPgtWebConnectwindowsptagentvertxt
Linux
httpltWebServerIPgtWebConnectlinuxix86qterm-
wcvertxt
The file contents displayed in the browser window should be in
the following form
560-rel14546
PowerTerm WebConnect Application Zone
560 - Main Release
ltrootgtPowerTerm WebConnect 56ltWebServergt
If the version file contents are not as shown check
- Is the Web Server running
- Are PowerTerm WebConnect Web Components and version files
PowerTerm WebConnect 37 Getting Started Guide
in place
3 On the Web server check ltPowerTerm WebConnect
rootgtwebwindowsptagentvertxt If the contents ldquolook wrongrdquo or
not in the proper form reinstall the PowerTerm WebConnect Web
components
4 On the client machine open the aforementioned URL in the
browser The file content should appear in the browser If it does
not it could be that the Web server is down
Web Server is
shut down
The webconnectxml configuration file must be located on the Web
server The explicit URL to this file is defined in the preferencesini
file (see Configure the Preferences File)
The error message contains the IP address of the Web server
Verify that the Web server on this machine is running
Version file
does not exist
on ltURLgt
See Version File reading error
The
configuration
file is not
accessible or
has a wrong
format
The webconnectxml configuration file must be located on the Web
server and the explicit URL to the configuration must be defined in
the preferencesini file (see Configure the Preferences File)
Try to open the URL specified in the error message in the
browser If it does not open then it either does not exist or it has
a wrong format
Preferences
file does not
exist in the
application
bundle
The preferencesini file containing the URL to the configuration
file was removed from the update site folder
Uninstall the current PowerTerm WebConnect client from the
client machine Create a new customized package (see
PowerTerm WebConnect Client Configuration) and reinstall it
Configuration
file URL is not
defined in
preference
file
The URL to the configuration file does not appear in the
preferencesini file (see Configure the Preferences File)
Uninstall the current PowerTerm WebConnect client from the
client machine Create a new customized package (see
PowerTerm WebConnect Client Configuration) and reinstall it
No IP address
could be
found for the
host
The Web server URL specified in the preferencesini file (see
Configure the Preferences File) or in the webconnectxml file (see
Configure the PowerTerm WebConnect Client) is an unknown
host
If the mistake is in the preferencesini file uninstall the current
PowerTerm WebConnect client from the client machine Create a
new customized package (see PowerTerm WebConnect Client
Configuration) and reinstall it
PowerTerm WebConnect 38 Getting Started Guide
If the mistake is in the webconnectxml file correct the file reopen
the Lotus Expeditor client
Cannot write
to destination
The temporary file cannot be written to the defined destination
Check the write permissions
Copied
configuration
file has wrong
format
The webconnectxml file as received from the specified URL has a
wrong format Correct the file and try again
PowerTerm
WebConnect
Agent URL is
malformed
The PowerTerm WebConnect Agent URL specified in the
webconnectxml file (see Configure the PowerTerm WebConnect
Client) does not have a proper HTTP format Correct the file and
try again
PowerTerm
WebConnect
Agent URL is
not defined
The PowerTerm WebConnect Agent URL parameter is not specified
in the webconnectxml file (see Configure the PowerTerm
WebConnect Client)
Correct the file and try again
The specified
destination
folder name
is wrong
The destination folder name contains illegal characters
ltgt|
Check the dst parameter in the webconnectxml file Correct the
file and try again
You do not
have
permissions
to write to
ltpathgt
The PowerTerm WebConnect Agent cannot be written to the
destination as defined Check the write permissions
The default destination defined in the version file should not to
be changed
A customized destination for PowerTerm WebConnect Agent
downloading can be defined in the webconnectxml file (See
Configure the PowerTerm WebConnect Client)
Check the destination value correct and try again
PowerTerm WebConnect 39 Getting Started Guide
About Ericom
Ericomreg Software is a leading provider of Application Access and Virtualization Solutions
Since 1993 Ericom has been helping users access enterprise mission-critical applications
running on a broad range of Microsoftreg Windowsreg Terminal Servers virtual Desktops
Blade PCs legacy hosts and other systems Ericom provides concrete business value by
helping organizations realize the benefits of their IT investments With offices in the United
States United Kingdom EMEA India and China Ericom also has an extensive network of
distributors and partners throughout North America Europe Asia and the Far East Our
expanding customer base is more than 30 thousand strong with over 7 million
installations
For more information on our products and services contact us at the location nearest to you
And visit our web site httpwwwericomcom
North America Western Europe International
Ericom Software Inc Ericom Software (UK) Ltd Ericom Software Ltd
231 Herbert Avenue Bldg 4 11a Victoria Square 8 Hamarpeh Street
Closter NJ 07624 USA Droitwich Worcestershire Har Hotzvim Technology Park
Tel +1 (201) 767 2210 WR9 8DE United Kingdom Jerusalem 91450 Israel
Fax +1 (201) 767 2205 Tel +44 (0) 845 644 3597 Tel +972 (2) 591 1700
Toll-free 1 (888) 769 7876 Fax +44 (0) 845 644 3598 Fax +972 (2) 571 4737
Email infoericomcom Email infoericomcouk Email infoericomcom
PowerTerm WebConnect 3 Getting Started Guide
Table of Contents
ABOUT THIS DOCUMENT 5
1 PRODUCT OVERVIEW 6
2 INSTALLING AND STARTING POWERTERM WEBCONNECT 8
21 Install PowerTerm WebConnect (Windows edition) 8
22 StartStopRestart PowerTerm WebConnect Server (Windows edition) 8
23 Install Run and Stop PowerTerm WebConnect Server (Linux edition) 9
24 Install the Terminal Server Agent 10
25 Install PowerTerm WebConnect DeskView Server 10
26 Start the PowerTerm WebConnect Administration Tool 10
3 POWERTERM WEBCONNECT ADMINISTRATION TOOL AT A GLANCE 12
31 Publishing Applications and Documents 14
32 Create Terminal Emulation Connections 16
33 Test Connections 16
34 Launch the Application Zone or the Application Portal 17
35 Monitor a Users Sessions 17
36 View Intruders 17
4 ACCESSING VIRTUAL DESKTOPS AND BLADE PCS WITH POWERTERM WEBCONNECT 18
41 Step 1 Launch DeskView Administration Tool 18
42 Step 2 Add a Host 19
43 Step 3 Create a Pool 20
44 Step 4 Publish an ApplicationDesktop 20
5 DOWNLOAD AND RUN POWERTERM WEBCONNECT CLIENTS 22
6 POWERTERM WEBCONNECT CLIENT FOR LOTUS EXPEDITOR 23
61 Installation Package 23
62 Pre-installation steps 23
63 Install PowerTerm WebConnect Portlet on IBM Workplace server (for Windows OS) 24
PowerTerm WebConnect 4 Getting Started Guide
64 Install PowerTerm WebConnect Portlet on IBM Workplace server (for Linux OS) 26
65 Install PowerTerm WebConnect Portlet on IBM WebSphere 61 server (for Windows OS) 27
66 PowerTerm WebConnect Server Configuration 29
67 PowerTerm WebConnect Client Configuration 29
68 Installing PowerTerm WebConnect Client on Lotus Expeditor 35
69 Running PowerTerm WebConnect Client for Lotus Expeditor 35
610 Troubleshooting 36
ABOUT ERICOM 39
PowerTerm WebConnect 5 Getting Started Guide
About this Document
This guide explains how to install and get started with PowerTerm WebConnect (PowerTerm
WebConnect Enterprise PowerTerm WebConnect RemoteView PowerTerm WebConnect
DeskView PowerTerm WebConnect HostView and PowerTerm WebConnect for Oracle) It
is intended for Administrators of PowerTerm WebConnect If you need more detailed
explanations on the different options in the administration tools or more information about
how to work with PowerTerm WebConnect please refer to the PowerTerm WebConnect
Administrators Manual
This document contains the following chapters
Chap 1 Product Overview Important information for
easy installation
Pg 6
Chap 2 Installing and Starting
PowerTerm WebConnect
Describes how to install and
start PowerTerm
WebConnect (Windows and
Linux editions) and its
different components as well
on how to launch the
PowerTerm WebConnect
Administration Tool
Pg 8
Chap 3 PowerTerm WebConnect
Administration Tool at a
Glance
Describes some main
features of the PowerTerm
WebConnect Administration
Tool and how to create
Connections and Publish
Applications
Pg 12
Chap 4 Accessing Virtual Desktops
and Blade PCs with
PowerTerm WebConnect
Describes how to configure
hosts and create pools with
PowerTerm WebConnect
DeskView and PowerTerm
WebConnect for Oracle VM
Pg 18
Chap 5 Download and Run
PowerTerm WebConnect
Clients
Describes where you can
download and run the
various PowerTerm
WebConnect clients
Pg 22
Chap 6 PowerTerm WebConnect
Client for Lotus Expeditor
Describes how to install
configure and run
PowerTerm WebConnect
Client for Lotus Expeditor
Pg 23
PowerTerm WebConnect 6 Getting Started Guide
1 Product Overview
PowerTerm WebConnect is an Enterprise-Wide Application Access solution that enables you
to publish and provide secure remote access to applications running on Windows Terminal
Servers Virtual Desktops (on top of hypervisors such as VMWare Microsoft Xen and
Virtual Iron) Blade PCs and legacy hosts Once published applications can be accessed
and used by end-users in a secure and managed fashion
Major components of the PowerTerm WebConnect product include
bull PowerTerm WebConnect Server
Choose between either Windows or Linux editions of the server
bull PowerTerm WebConnect DeskView Server
This component makes it possible to publish Desktops and applications that run on
Virtual Machines and physical machines
bull PowerTerm Load Balancer
Install the PowerTerm Load Balancer as a part of PowerTerm WebConnect Server
installation on the same computer or independently on a separate computer
Once installed it provides System and Application Load Balancing
bull PowerTerm WebConnect Web Components
Install these components on a compatible Web server in order to provide end-
users with a Web interface to published applications
bull PowerTerm WebConnect Administration Tool
Install the PowerTerm WebConnect Administration Tool on the server or on an
administration workstation It can also be downloaded on-demand
bull Client-side components
These components are installed as a part of the ldquoWeb server componentsrdquo
installation option and are usually downloaded by users the first time they need
the corresponding functionality Some components can be pre-installed if needed
Client side components include
RemoteView for accessing Windows Terminal Server applications and Virtual
Desktops from Windows and Linux workstations as well as from Windows Based
Terminals and Windows XPe and Linux based thin clients
HostView for accessing character-based applications running on legacy hosts
including IBM Mainframe IBM AS400 OpenVMS Unix Linux Tandem from
Windows and Linux workstations as well as from Windows Based Terminals and
Windows XPe and Linux based thin clients
SupportView for remote desktop support
PrintView for managing print queues
QuickVNC for remote desktop connectivity
bull PowerTerm Terminal Server Agent
Install this component on Windows Terminal Servers This component enables
PowerTerm WebConnect 7 Getting Started Guide
True Seamless Windows for published applications remote application browsing
and publishing and Application Load Balancing
bull PowerTerm WebConnect Portlet for JSR 168 Portals
Install this component if you plan to access Windows published applications and
Legacy hosts from within JSR 168 compatible portal environments such as IBM
Workplace or WebSphere Oracle Portal Vignette Portal and the like
bull PowerTerm WebConnect Plugin for IBM Lotus Expeditor
Install this plugin if you plan to access Windows published applications and Legacy
Hosts from within the IBM Lotus Expeditor environment
bull PowerTerm WebConnect DeskView
This component makes it possible to publish Desktops and applications that run on
Virtual Machines and physical machines
The evaluation package of PowerTerm WebConnect that you can download and
install contains the PowerTerm WebConnect Enterprise product with all its
components Once activated the product will only include the components and
features of the specific PowerTerm WebConnect product you purchased
PowerTerm WebConnect 8 Getting Started Guide
2 Installing and Starting PowerTerm WebConnect
PowerTerm WebConnect includes both server-side and client-side components The server
side includes
bull PowerTerm WebConnect Server
bull PowerTerm WebConnect DeskView Server
bull PowerTerm WebConnect Load Balancer
bull PowerTerm WebConnect Administration tools (for WebConnect Server PowerTerm
Load Balancer and DeskView Server)
The client side has numerous clients such as
bull RemoteView
bull HostView (for both Windows and Linux)
bull QuickVNC etc
21 Install PowerTerm WebConnect (Windows edition)
1 Run the installation file typically named PowerTermWebConnect5xexe You will find
the file on the installation CD or you can download it from Ericoms website
2 Click Install and then enter your Serial Number or click Evaluate when prompted
3 Continue with installation and select Full Installation Server Administration Tool and
WebServer Components (default) in the Setup Type dialog
4 Complete the installation and click Exit and run PowerTerm WebConnect in the last
dialog of the installation Depending on your computer this may take a few minutes
The first time you launch the PowerTerm WebConnect server it will generate a
Diffie-Hellman key for SSL encryption This process may take several minutes
depending on the speed of your computer A visual progress indicator will show
you when this process is completed While this process is taking place PowerTerm
WebConnect clients will not be able to connect to the server
22 StartStopRestart PowerTerm WebConnect Server (Windows edition)
PowerTerm WebConnect server is installed as a Windows service
1 Launch the standard Services console from the Windows Control Panel On some
computers it may be located under the Administrative Tools group You can also run
the command SERVICESMSC The Services window is displayed
PowerTerm WebConnect 9 Getting Started Guide
2 Select PowerTerm WebConnect Server 5x service (the primary service of PowerTerm
WebConnect) where x is the version number and use standard StartStopRestart
options
The PowerTerm WebConnect Server Starter 5x service (the secondary service of
PowerTerm WebConnect) is designated for restarting the primary service in
cases of failure or any unexpected problems The secondary service is
controlled by internal logic of PowerTerm WebConnect and cannot be stopped
from the Services console
23 Install Run and Stop PowerTerm WebConnect Server (Linux edition)
Transfer the installation file to your Linux server and install the PowerTerm WebConnect
components in the RPM package using the following shell command
rpm ndashi WebConnecct-5x-0i586rpm
(lsquoxrsquo is the version number)
The PowerTerm WebConnect server will be installed to
optWebConnect5x
All PowerTerm WebConnect clients including PowerTerm WebConnect
Administration Tool are published via the Web server Therefore you need to
manually configure the Web server to publish the path optWebConnect56web
The name of the virtual directory has to be WebConnect5x
After configuring the virtual directory you can launch any client from httpltservernamegtWebConnect5xClientURLshtml
Users of Red Hat 72
If you installed the PowerTerm WebConnect server on Red Hat 72 you also have to install
the file libgcc-304-1i386rpm (44Kb) in order for PowerTerm WebConnect Server to run
This file can be downloaded from
ftprpmfindnetlinuxredhatupdates72enosi386libgcc-304-1i386rpm The file is
also available on the installation CD and can as well be downloaded from the ldquoEvaluate
PowerTerm WebConnect Linux x86 Editionrdquo web page
Use the following commands to run the PowerTerm WebConnect server
On RedHat
sbinservice webconnectd start
On Suse
etcrcdwebconnectd start
Use the following commands to stop the PowerTerm WebConnect server
On RedHat
sbinservice webconnectd stop
PowerTerm WebConnect 10 Getting Started Guide
On Suse
etcrcdwebconnectd stop
24 Install the Terminal Server Agent
PowerTerm WebConnect Terminal Server Agent must be installed on a Terminal Server
accessed using PowerTerm WebConnect It provides the True Seamless Windows
functionality for published applications remote browsing and publishing and Application
Load Balancing
The PowerTerm WebConnect Terminal Server Agent must be installed on every Terminal
Server in the cluster If you install the PowerTerm WebConnect server itself on a Terminal
Server you will be given the option to install the Terminal Server Agent as a part of the
server installation Alternatively use the PowerTermTerminalServerAgentexe file located in
the AddOnsTerminalServerAgent subdirectory under the PowerTerm WebConnect server
installation directory
To complete the installation you might need to restart the Terminal Server machine
25 Install PowerTerm WebConnect DeskView Server
PowerTerm WebConnect DeskView is automatically installed when you run PowerTerm
WebConnect Installation wizard ndash Full installation To run PowerTerm WebConnect
DeskView Server you also need Microsoft NET Framework v30 to be installed on your
computer If you do not have it installed then the installation wizard will place the
DeskViewServerSetupmsi and DeskViewAdminSetupmsi files in the AddOns folder
(ltPowerTerm WebConnect Installation FoldergtWebConnect 5xAddOnsDeskView
VDI) from where you can run the msi files at a later stage to install PowerTerm
WebConnect DeskView
26 Start the PowerTerm WebConnect Administration Tool
There are several ways to launch the PowerTerm WebConnect Administration Tool Select
the one most convenient for you
bull From Windows Start menu select Programs | Ericom Software | PowerTerm WebConnect
5x | PowerTerm WebConnect Administration Tool
If you changed the Program Folder during installation the Start menu path
may vary
bull Double-click PtAdminexe PtAdminexe is located in the bin directory of the
PowerTerm WebConnect installation folder
bull Rather than installing you can choose to download the Administration Tool to any
Windows computer Please refer to the PowerTerm WebConnect Sample URLs
page (httpltweb_servergtWebConnect5xClientURLshtml) for more details
A few things to remember
PowerTerm WebConnect 11 Getting Started Guide
When you launch the PowerTerm WebConnect Administration Tool for the first time the Connection dialog is displayed with the user Administrator No
password is required to enter just click Connect
In the Connection dialog (displayed when launching the Administration Tool) the
Host Name is localhost by default This is correct only if the Administration Tool
runs on the same machine as the server If the Administration Tool runs on a different machine you need to change the Host Name to the IP addressHostname
of the PowerTerm WebConnect server
When using the PowerTerm WebConnect Windows edition by default the
Administration Tool will deny any connection attempts from any computer other
than the local machine
PowerTerm WebConnect 12 Getting Started Guide
3 PowerTerm WebConnect Administration Tool at a Glance
PowerTerm WebConnect Administration Tool manages published applications user sessions
and server configuration The administrator can perform operations such as multiple
application publishing sending messages to logged-on users shutting down sessions and
monitor user activity
To perform the tasks described in this chapter you must launch the Administration Tool via one of the methods detailed in chapter Start the PowerTerm
WebConnect Administration Tool
Launching the Administration Tool from the system tray or using the
Administration Tool launched after completed installation will not allow you to
activate certain features
After you launched the Administration Tool and connected to the server you will receive a
Welcome screen where you select desired activity
bull Publish Multiple Applications opens the Publish Multiple Applications wizard
bull Configure Load Balancer opens PowerTerm Load Balancer Administration Tool
bull Create a Host Connection opens the Add Connection dialog
bull Configure Active Directory opens the Directory Services dialog
PowerTerm WebConnect 13 Getting Started Guide
Close the Welcome screen to enter the Administration Tool main
screen
The Administration Tool main screen has three sections
bull User section lists all users defined in the server
bull Group section lists all groups defined in the server
bull Connection section lists all connections and published applications defined in the
server
By default only the Connection section is displayed when you first open Administration Tool
There are three predefined example-connections ldquoExample_As400rdquo ldquoExample_VTrdquo and
ldquolocalhostrdquo You can test them prior to defining your own
1 Right click the connection you want to test and select Test The PowerTerm
WebConnect HostView Login dialog appears
2 Type example for User Name and example for Password
Credential fields are case sensitive
3 Click Login The desired connection with its pre-programmed demo application is
launched
PowerTerm WebConnect 14 Getting Started Guide
31 Publishing Applications and Documents
In order to enable access to applications and documents on Windows Terminal Servers
publish these applications and documents from the Administration Tool When publishing
applications and content you can specify which servers will be used in a Terminal Server
cluster and which users and groups will have access to these services Once you have
published such applications and documents the RemoteView client can be used to access
them
If you need to provide access to multiple applications on a Terminal Server use the Multiple Application Publishing wizard to significantly reduce the time and
effort required to publish these applications
To publish multiple Windows applications
1 Click Publish Multiple Applications in the Welcome screen The Choose Terminal Server
for Browsing dialog appears
2 Provide the address of the Terminal Server which will be used for browsing and click OK The Application Publisher Step 1 dialog appears This dialog lists all the
applications available in the specified serverrsquos Start menu
3 Select those applications found in the Programs folder of the designated server that you want to publish and click Next The Application Publisher Step 2 dialog appears
4 Determine the destination of your publishing and click Next The Application Publisher
Step 3 dialog appears
5 Determine the Color Quality of your published application
6 Determine the start mode in which you want to run the published application - normal maximized or minimized - and click Next The Application Publisher Step 4
dialog appears
7 Choose the connection speed that matches your infrastructure The connection speed
setting determines the value of three visual effects settings You can also override
these settings specifically
8 Determine whether you prefer the window to display their content while being
dragged or just the outline By default the same setting is used as the client desktop
9 Click Next The Application Publisher Step 5 dialog appears
10 Specify where sounds are to be played ndash locally or remotely
11 Determine which local devices the remote session will have access to (local drivers printer etc) and click Next The Application Publisher Step 6 dialog appears
12 If you have the PowerTerm Load Balancer installed Use all Servers (default) allows the application to run on any Terminal Server in the
cluster This setting is appropriate when the application is installed on all the Terminal
Servers Alternatively you select specific Terminal Servers on which to run this
application
If you have not installed the PowerTerm Load Balancer you will need to explicitly
specify the address of the Terminal Server on which the application will be run
PowerTerm WebConnect 15 Getting Started Guide
13 Click Next The Application Publisher Step 7 dialog appears
14 Select the users groups or OUs to which you wish to publish the applications and click Next The Application Publisher Step 8 dialog appears By default applications will
be published to everybody
15 Click Advanced Settings to modify settings such as the login credentials to the
Terminal Servers By default PowerTerm WebConnect credentials will be passed
through to the Terminal Server
16 Click Finish The published applications appears in the Connection List
Right-click and select Properties or double click on the published application in the
Connections list to view and modify any of the settings which you previously
defined
To publish a remote Desktop
1 Select Action | New | Remote Desktop The Application Publisher Step 1 dialog appears
2 Type the Display Name which will be the name presented to the end-users and click
Next The Application Publisher Step 2 dialog appears
3 Specify where icons for the published desktop will be displayed to the end-user in Publish to
4 Click Choose Icon to replace the desktoprsquos default icon Select the desired icon from
the list that appears
5 Click Next The Application Publisher Step 3 dialog appears
6 Determine Screen Size and the Color Quality of the published desktop
7 If desirable select Show Connection Bar in Full Screen Mode
8 Click Next The Application Publisher Step 4 dialog appears
9 Choose the connection speed that matches your infrastructure The connection speed
setting determines the value of three visual effects settings You can also override
these settings specifically
10 Click Next The Application Publisher Step 5 dialog appears
11 Specify where sounds are to be played ndash locally or remotely Where to Apply Window
Key Combinations and which local devices you want to automatically connect to when
logged on to the remote computer
12 Click Next The Application Publisher Step 6 dialog appears
13 Specify the Server Address and Port Number of the Terminal Server that weill provide
the desktop and click Next The Application Publisher Step 7 dialog appears
14 Select the users groups or OUs to which you wish to publish the desktop and click Next The Application Publisher Step 8 dialog appears
Select the Server group to allow all users to access the published application
15 Click Advanced Settings to modify settings such as the login credentials to the
Terminal Servers By default PowerTerm WebConnect credentials will be used
PowerTerm WebConnect 16 Getting Started Guide
16 Click Finish The published application appears in the Connection List
Right-click Properties or double click on the published application in the
Connections list to modify any of the settings which you previously defined
32 Create Terminal Emulation Connections
To provide access to legacy host systems you will need to create Terminal Emulation
connections For each such connection you can specify the host address emulation type
login script and more Once you have created these connections users will be able to
launch them using HostView (Windows or Linux) WebView or the Java client as
appropriate
1 Click Create a Host Connection in the Welcome screen The Add Connection dialog
appears
2 Enter a Name for the new connection
3 Specify an Owner for the new connection The possibilities are
[None] the connection will not be allowed to run by anyone and it will not be
displayed in any Connection list Server the connection will be accessible for all users of this PowerTerm
WebConnect server A specific group the connection will be accessible for all users of the specified
group A specific user the connection will be accessible for a specified user only
4 Leave category Terminal Emulation selected
5 Select Terminal Type Terminal Model and Communication Type as needed
6 Specify the Host Name or IP address of your host
7 Specify other parameters as needed
8 Select the Security Type as needed if your host supports SSL or SSH and specify
the appropriate details in the Details dialog
9 Use the Settings Key Mapping and Power Pad options to further customize the
connection
10 Click OK and the connection is created
33 Test Connections
It is recommended to test published applications or host connections before they are made
available to end-users
To test a connection
bull Right-click the target connection from the Connection section of the main screen and
select Test
Alternatively
PowerTerm WebConnect 17 Getting Started Guide
1 Select Tools | Run ltdesired clientgt The Login to WebConnect dialog appears
2 Enter the User Name and Password for the individual who owns the connection that
you want to test and click Login The desired PowerTerm WebConnect client is started
and the Connect dialog appears
3 Select the desired connection and click Connect The test is executed
34 Launch the Application Zone or the Application Portal
Users can access the published applications from the Application Zone application launcher
or from the Application Portal web interface
To use the Application Zone go to Start menuProgramsEricom SoftwarePowerTerm
WebConnect 5x and select Client URLs Alternatively type the following URL into your Web
browserrsquos address bar httpltserver addressgtWebConnect5xClientURLshtml In the
page that opens click on the Run button next to the Application Zone to launch it
To use the Application Portal go to Start menuProgramsEricom SoftwarePowerTerm
WebConnect 5x and select it Alternatively type the following URL into the Web browserrsquos
address bar httpltserver addressgtWebConenct5xportalwindowsindexasp
35 Monitor a Users Sessions
From the Administration Tool you can monitor the users sessions and may intervene if
necessary This intervention may result in your input appearing on the users screen The
user receives a notification when an administrator begins and ends monitoring the session
1 Select View | Client Sessions or click to see all the active client sessions
2 Select the desired active session and right-click Attach The Password Verify dialog
appears
3 Enter your password and click OK Some notification dialogs appears and the selected
PowerTerm WebConnect session is viewed
36 View Intruders
bull The Intruders window shows suspected attempts at breaching security After several
suspected intrusion attempts users are blocked temporarily
bull In addition to showing suspected intrusion attempts the Intruders window allows
you to remove restrictions on users
bull Select View | All Intruders or click
PowerTerm WebConnect 18 Getting Started Guide
4 Accessing Virtual Desktops and Blade PCs with PowerTerm WebConnect
This chapter provides instructions on configuring PowerTerm WebConnect for Virtual
Desktop Infrastructure (VDI)
41 Step 1 Launch DeskView Administration Tool
Verify that PowerTerm WebConnect is installed on your server and launch PowerTerm
WebConnect Admin Tool
bull Select Tools | Open VDI Manager The PowerTerm WebConnect DeskView Administration
Tool opens
The first time you launch the DeskView Administration Tool you will be prompted to install
the tool
PowerTerm WebConnect 19 Getting Started Guide
Microsoft Management Console 30 is required for PowerTerm WebConnect DeskView
Administration Tool If you do not have this installed you will also automatically be
prompted to install this update
Follow the installation processes when you are prompted for either install PowerTerm
WebConnect DeskView Administration Tool will automatically launch when these
installations are completed
42 Step 2 Add a Host
1 Right-click Virtualization Hosts and select Add Host The Add a New Host wizard
opens Click Next
2 Enter a Host Name as you would like it to appear in PowerTerm WebConnect
DeskView Administration Tool and a description (optional) Click Next
3 Specify the Virtualization Server type and click Next
4 Specify the connection information and click Next
VMWare Virtual Center v1x and 2x
Specify the HTTPS Web Service address and a UsernamePassword that can access
the host
VMWare Virtual Server 2005
Click Start and then Run
Type ldquoservicesmscrdquo and click OK
Scroll down to PowerTerm WebConnect DeskView Server service and open
Properties
Change the Login Account for the service to match the Domain Administrator
account and password used when setting up Microsoft Virtual Server 2005 and
restart the service Enter the IP or NETBIOS name of the Microsoft Virtual Server 2005 server as the
Server Address in the Connection Broker Wizard
Xen Server
Specify the hypervisor IP address or NETBIOS name the Root UsernamePassword
to the hypervisor and the Service port (default 80)
Oracle VM
Specify the Serverrsquos agent URL and Port (default 8899) for example
httpsltservernamegt8899
Specify the Oracle VM hypervisorrsquos Oracle Agent UsernamePassword (default
username oracle)
5 Click Finish to add the new Host
To configure Virtual Machines for use install the Ericom Tools (vmagentmsi) on each of the
virtual machines on the new host for PowerTerm WebConnect DeskView to recognize them
The vmagentmsi installer is located on the PowerTerm WebConnect server in ltPowerTerm
WebConnect installation foldergtAddOnsDeskView VDI folder (default installation
PowerTerm WebConnect 20 Getting Started Guide
folder is xProgram FilesEricom SoftwareWebConnect 56) During installation you
will need to enter the DeskView IP address or NETBIOS name
If you are using Microsoft Virtual Server 2005 as your Virtualization Host use the
IP address of the DeskView server only when installing the Ericom Tool package
43 Step 3 Create a Pool
Pools are used to organize Virtual Machines (VM) into logical groups This enables
organizations to combine and order resources from multiple systems into one entity To
access available resources end-users simply connect to PowerTerm WebConnect to access
any configured resource
1 Right-click Pools and select Create Pool The Create a Pool wizard opens Click
Next
2 Enter a Pool name as you wish it to appear and a description (optional) and click
Next
3 Specify the Pool type and click Next
4 Specify the Assignment type and click Next
Permanently will cause a virtual machine to affix to the user who has launched
that virtual machine For the duration of the session will cause any virtual machine that is not in use to
be returned to the pool for any user to launch
5 Specify the LogoffDisconnect event and click Next
Select what you would like to happen after a user logs off from a virtual machine
in this pool
Select what you would like to happen when a user is disconnected from a virtual
machine in this pool
6 Click Finish to add the new Pool
You will need to assign virtual machines from your virtualization hosts to your created pool
1 Right-click the pool and select Assign Machines The Assign Machines to ltyour
pool namegt dialog opens
2 Highlight the desired virtual machine(s) and click Select Click OK
44 Step 4 Publish an ApplicationDesktop
1 Return to PowerTerm WebConnect Admin Tool to publish DeskView pools
2 Determine whether to publish a full desktop or a seamless application running
from a virtual desktop
For a full desktop
Select Action | New | Remote Windows Desktop
For a seamless application
Select Action | New | Windows Application
PowerTerm WebConnect 21 Getting Started Guide
3 Select Virtual Desktop in the first step of the wizard and click Next
4 Follow the wizardrsquos instructions until you reach the Virtual Desktops step
5 Select a pool that you previously created and that you would like this connection to choose virtual machines from Click Next
6 Continue and complete the reminder of the wizardrsquos steps
Once the resource is published users who have been assigned access will be able to use it
immediately
PowerTerm WebConnect 22 Getting Started Guide
5 Download and Run PowerTerm WebConnect Clients
PowerTerm WebConnect clients are automatically downloaded and installed onto the client
devices For detailed information and samples please refer to the PowerTerm WebConnect
Sample URLs page To see this page navigate your browser to
httpltweb_servergtWebConnect5xClientURLshtml
PowerTerm WebConnect 23 Getting Started Guide
6 PowerTerm WebConnect Client for Lotus Expeditor
61 Installation Package
PowerTerm WebConnect client for Lotus Expeditor is provided to IBM in an Update Site
package This is a ZIP archive containing the Update Site with the Eclipse feature and plug-
in that comprises the PowerTerm WebConnect client
Extract the ZIP file keeping the foldersrsquo structure intact
NOTE In Winzip verify that the ldquoUse folder namesrdquo option is set to TRUE
Package structure
Update Site
- plugins
- PowerTermWebConnectClient_560365jar
- features
- comericomWebConnect_560365jar
- sitexml
config
- webconnectxml
Definitions
bull webconnectxml PowerTerm WebConnect client configuration file
bull comericomWebConnect_560365jar PowerTerm WebConnect client feature file
bull PowerTermWebConnectClient_560365jar PowerTerm WebConnect client plugin file
62 Pre-installation steps
PowerTerm WebConnect client for Lotus Expeditor does not run independently but in
conjunction with PowerTerm WebConnect Server You can either install it and define your
users groups and applications or use Ericom Softwarersquos Demo PowerTerm WebConnect
Server
bull If you decide to install PowerTerm WebConnect Server you will need the full
installation ie the PowerTerm WebConnect Server and the Web components If you
do not have the installation CD you can download and install a trial version from
wwwericomcom
PowerTerm WebConnect 24 Getting Started Guide
bull If you decide to use Ericom Softwarersquos Demo PowerTerm WebConnect Server then
skip to the chapter Installing PowerTerm WebConnect Client on Lotus Expeditor
63 Install PowerTerm WebConnect Portlet on IBM Workplace server (for Windows OS)
Step 1 Install PowerTerm WebConnect Server
If PowerTerm WebConnect Server and IBM Workplace Server are on separate machines
bull Configure PowerTerm WebConnect Server
Launch PowerTerm WebConnect Administration Tool
Open Files | Configuration | Main
In the [Portal] section edit
Machines=localhostltIBM sever machinegt
bull Configure PowerTerm WebConnect Web components
Copy the ldquowebrdquo folder from the PowerTerm WebConnect server installation to the
IBM Workplace server machine
Create an Alias or a Virtual directory to it named WebConnect on the Web
server providing access to it for the users This is in order to enable the users to
download the necessary files to run their applications
Step 2 Enable JSR portlets
1 On IBM Workplace Server go to ltPortalServergtsharedappconfigservicesConfigServiceproperties
2 Edit portalenablejsr168=true
3 Save and close the file
Step 3 Enable SSO
1 On IBM Workplace Server go to ltPortalServergtsharedappconfigservicesLoaderServiceproperties
2 Edit commandpath=comericomportalcommandscomibmwpsenginecommands
3 Save and close the file
Step 4 Copy Files
The following files need to be copied from WebConnect ServerAddOnsIBM
WorkplacePortlet folder to IBM Workplace Server
File name to copy Destination folder
OpenSSLdll ltAppServergtjavajrebin
IbmPortaldll ltAppServergtjavajrebin
IbmPortalini ltAppServergtjavajrebin
PowerTerm WebConnect 25 Getting Started Guide
WebConnectPortaljar ltAppServergtlib
EricomLoginjar ltPortalServergtsharedapp
Step 5 Portlet Configuration
1 On IBM Workplace Server go to ltAppServergtjavajrebinIbmPortalini
2 You can modify the following parameters in the [Server=WebConnect] section webserverport=ltIBM web server portgt
Specifies the Web server port for accessing the PowerTerm WebConnect clients folder
Default 80 Address
Specifies the address of the PowerTerm WebConnect Server machine for Portlet to
connect to when PowerTerm WebConnect Server is located on a different machine
than the IBM Workplace Server CustomAddress
Specifies the addresss of the PowerTerm WebConnect Server machine for Clients to connect to If CustomAddress is the same as Address then this may be omitted webserveraddr
Specifies the address of the Web Server machine when it is located on a different
machine than the IBM Workplace Server
3 Restart the IBM server ltPortalServergtrootscriptsstopWorkplaceServicesbat ltPortalServergtrootscriptsstartWorkplaceServicesbat
This procedure may take about 20 minutes
Step 6 Install the Portlet
1 In a Web browser open the URL httpltIBM Workplace
Servergt9081lwpmyworkplace to open the IBM Workplace Portal
2 Login as administrator
3 Go to Administration | Portlets | Install
4 Browse to the PowerTerm WebConnectwar file located on PowerTerm WebConnect
Server and click Next
5 Click Install
Step 7 Create an Application page
1 Login to the Workplace
2 Go to Portal User Interface | Manage Pages
3 Search for My Work
4 Click the My Work link and select New Page
5 Name the page PowerTerm WebConnect and click OK
6 Click OK again You will see the created page on the list
7 Click the pencil icon on the new page and select the 1 square layout
PowerTerm WebConnect 26 Getting Started Guide
8 Click Add Portlet and search for PowerTerm WebConnect
9 Select it and click OK
10 Click Done
11 Click My work at the top of the page PowerTerm WebConnect is displayed on the list
Step 8 Run the Portlet
1 Restart IBM Workplace Server
2 Open IBM Workplace Portal in a browser httpltportal servergtlwpmyworkplace
3 Login to IBM Workplace Server
4 Click My work PowerTerm WebConnect portlet is displayed
5 Launch it The Userrsquos applications as defined on PowerTerm WebConnect Server
appear
6 Click an application to launch it
64 Install PowerTerm WebConnect Portlet on IBM Workplace server (for Linux OS)
Step 1 Enable JSR 168 portlets
1 Go to optIBMWorkplacePortalServersharedappconfigservicesConfigServiceproperties
2 Modify the portalenablejsr168 property to ldquotruerdquo
3 Restart the server cd optIBMWorkplacePortalServerrootscripts
Run stopWorkplaceServicessh
Run startWorkplaceServicessh
This procedure can take up to 20 minutes
4 Log on to the workplace server at httpltworkplace servergt9081lwpmyworkplace using
the administrators username and password
Step 2 Install the portlet
1 Restart IBM Workplace Server
2 In a Web browser open the URL httpltworkplace server IPgtlwpmyworkplace
3 Login to IBM Workplace Server as an administrator
4 Go to Administration | Portlets | Install
5 Browse to the PowerTerm WebConnectwar file located on PowerTerm WebConnect
Server and click Next
6 Click Install
PowerTerm WebConnect 27 Getting Started Guide
Step 3 Install the Application page
1 Login to the workplace as administrator
2 Go to Administration | Portal User Interface | Manage Pages
3 Search for My Work
4 Click the My Work link and select New Page
5 Name the page PowerTerm WebConnect and click OK
6 Click OK again You will see the created page on the list
7 Click the pencil icon and select the 1-square layout
8 Click Add Portlet and search for PowerTerm WebConnect
9 Select it and click OK
10 Click Done
11 Click My work on top and PowerTerm WebConnect is displayed on the left bar
Step 4 Run the portlet
1 Restart IBM Workplace Server
2 Open IBM Workplace Portal in a browser httpltportal servergtlwpmyworkplace
3 Login to IBM Workplace Server
4 Click My work PowerTerm WebConnect portlet is displayed
5 Launch it The Userrsquos applications as defined on PowerTerm WebConnect Server
appear
6 Click an application to launch it
65 Install PowerTerm WebConnect Portlet on IBM WebSphere 61 server (for Windows OS)
Step 1 Install PowerTerm WebConnect Server
You have to configure PowerTerm WebConnect Server if it and the IBM WebSphere Server
are on separate machines
1 Launch PowerTerm WebConnect Administration Tool
2 Open Files | Configuration | Main
3 In the [Portal] section edit Machines=localhostltIBM sever machinegt
Step 2 Copy Files
The following files need to be copied from WebConnect ServerAddOnsIBM
WebSpherePortlet folder to IBM WebSphere Server
PowerTerm WebConnect 28 Getting Started Guide
File name to copy Destination folder
OpenSSLdll ltAppServergtjavajrebin
IbmPortaldll ltAppServergtjavajrebin
IbmPortalini ltAppServergtjavajrebin
WebConnectPortaljar ltAppServergtlib
Step 3 Portlet Configuration
1 On IBM Workplace Server go to ltAppServergtjavajrebinIbmPortalini
2 You can modify the following parameters in the [Server=WebConnect] section webserverport=ltIBM web server portgt
Specifies the Web server port for accessing the PowerTerm WebConnect clients folder
Default 80 Address
Specifies the address of the PowerTerm WebConnect Server machine for Portlet to
connect to when PowerTerm WebConnect Server is located on a different machine
than the IBM Workplace Server CustomAddress
Specifies the addresss of the PowerTerm WebConnect Server machine for Clients to connect to If CustomAddress is the same as Address then this may be omitted webserveraddr
Specifies the address of the Web Server machine when it is located on a different
machine than the IBM Workplace Server
3 Restart the IBM server ltAppServergtProfilesAppServer01binstopServerbat ltAppServergtProfilesAppServer01binstartServerbat
This procedure may take about 20 minutes
Step 4 Install the Portlet and create an Application page
1 In a Web browser open the URL httpltIBM WebSphere Servergt9060ibmconsole
to open the IBM WebSphere Portal
2 Login and go to Applications | Install New Application
3 Browse to the PowerTerm WebConnectwar file located on PowerTerm WebConnect
Server
4 Enter Context root and click Next The Select installation options dialog appears
5 Optional change options to your preference or keep the default
6 Click Next
7 Select Ericom in the Module column click Apply and then Next
8 Click Finish and then Save
9 Select Applications | Enterprise Applications
10 Select PowerTerm WebConnectwar checkbox and click Start
PowerTerm WebConnect 29 Getting Started Guide
11 Enter in the Web browser the URL httpltIBM WebSphere
Servergt9080ltContext rootgtEricom portlet The Login dialog appears
12 Login and you will see PowerTerm WebConnect displayed on the list
Step 5 Run the Portlet
1 Restart IBM WebSphere Server
2 Open IBM WebSphere Portal in a browser httpltportal servergt9080ltContext
rootgtEricom portlet
3 Login to IBM WebSphere Server
4 Launch it The Userrsquos applications as defined on PowerTerm WebConnect Server
appear
5 Click an application to launch it
66 PowerTerm WebConnect Server Configuration
bull To enable the Lotus Expeditor to run the PowerTerm WebConnect client the
System Administrator must provide the users with accounts on PowerTerm
WebConnect Server (see the PowerTerm WebConnect Administratorrsquos Manual for
instructions on how to create users groups and connections on the PowerTerm
WebConnect Server)
bull To enable PowerTerm WebConnectrsquos Single Sign-On feature the System
Administrator must create a PowerTerm WebConnect user with the same
username and password as used for the Lotus Expeditor For a managed Lotus
Expeditor the credentials used are the username and password sent to the
managing server For an unmanaged Lotus Expeditor the operation system
username and the Lotus Expeditor password are used as credentials
NOTE If a password is not defined then the Single Sign-On will fail and the user will be
prompted with a login dialog
67 PowerTerm WebConnect Client Configuration
The PowerTerm WebConnect client is configured in webconnectxml located in the config
folder webconnectxml parameters are
url The PowerTerm WebConnect Agent url
server The PowerTerm WebConnect Server address
sso The Single Sign-On feature
dst The local destination for downloading PowerTerm WebConnect
components
PowerTerm WebConnect 30 Getting Started Guide
url
PowerTerm WebConnect components are installed on a Web server Their default url is
Windows Agent
httpltWebServer IPgtWebConnectwindowsptagentcab
Linux Agent
httpltWebServer IPgtWebConnectlinuxix86qterm-wczip
The url parameter must include the first part of the url (which is identical for both Windows
and Linux agents)
The PowerTerm WebConnect client will automatically append the appropriate suffix in
order to create a full accurate url
Example
ltitem key=rdquourlrdquo value=httpadminserverWebConnectgt
server
The computer name or IP address of the PowerTerm WebConnect Server machine
The PowerTerm WebConnect client will log in to this PowerTerm WebConnect Server
display the applications defined on it and run them according to this serverrsquos configuration
Format ltserver IPgt[ltportgt]
where default port is 4000 (can be edited)
Example
ltitem key=rdquoserverrdquo value=rdquoadmin24000rdquogt
sso
Determines whether Single Sign-on will be used to log in to PowerTerm WebConnect
Server Values
bull True (default) the client should automatically log in to the PowerTerm WebConnect
Server using the same credentials as the ones used to log in to the Lotus Expeditor
client
The System Administrator must verify that these credentials can log in to the
PowerTerm WebConnect Server
bull False the user will be prompted with a login dialog or will log in automatically using
previously saved credentials
Example
ltitem key=rdquossordquo value=rdquotruerdquogt
Autologin mode
PowerTerm WebConnect 31 Getting Started Guide
If sso is set to True the user is not prompted for credentials and the login process to
PowerTerm WebConnect Server is done automatically sending the credentials used for the
Lotus Expeditor unless the Lotus Expeditor does not have a password defined (In the
Lotus Expeditor preferences page | Password| Prompt me for a password at start up checkbox)
However if Single Sign-on is not used there are several options regarding Autologin that
can be defined in the PowerTerm WebConnect Preferences page Options
bull Yes
bull No
bull Interactive
bull First time interactive (default) ndash Simplifies the login process to PowerTerm
WebConnect Server In this mode the first time the user logs in to PowerTerm
WebConnect Server he will be prompted for his credentials with the Login dialog
These credentials will be stored in the machine and from then on the login process to
PowerTerm WebConnect Server will be done automatically
1 Open File | Preferences from the Lotus Expeditor and select PowerTerm WebConnect
2 In the Autologin to WebConnect Server section select First Interactive and click OK
3 Start PowerTerm WebConnect Client for Lotus Expeditor If credentials were entered
at least once then the next time the client will connect to PowerTerm WebConnect
Server without prompting for the user name and password
The Administrator must configure the Agent to do nothing when it exits for the
feature to work this way See PowerTerm WebConnect Administratorrsquos Manual for more information about defining Autologin
bull Allow multiple selection ndash Defines whether the user can launch more than one
application at a time (by using the ltCtrlgt or ltShiftgt button while selecting applications)
dst
Defines the path to download PowerTerm WebConnect components on the client machine
The dst parameter can contain macros which are translated by the PowerTerm WebConnect
Client for Lotus Expeditor during runtime The macros should be placed between percent
symbols () for example WebServer
When such a value is defined the PowerTerm WebConnect Client for Lotus Expeditor
substitutes the entire expression for the macrorsquos value
The PowerTerm WebConnect Client for Lotus Expeditor does not support the use
of environment variables as macros
Macros are not case sensitive
Macros supported by PowerTerm WebConnect Client for Lotus Expeditor
Macro name Description
WebServer The name of the Web server
It is obtained from the PowerTerm WebConnect Agent url
PowerTerm WebConnect 32 Getting Started Guide
parameter
Name The name of the clientrsquos CAB or ZIP file eg ldquoptagentrdquo
Display The clientrsquos display name from the version file
Version The clientrsquos version value It is obtained from the version
file
Root The default root location
Windows ldquoCrdquo
LinuxUnix an empty string
OSDir Windows Windowsrsquo installation directory for example
ldquoCWindowsrdquo
Linux an empty string
OSDrive Windows Windowsrsquo installation drive for example ldquoCrdquo
Linux an empty string
HomePath Windows The HOMEPATH environment variable
Linux The HOME environment variable
Home The Ericom folder in the userrsquos home directory
Windows CDocuments and SettingsltusergtApplication
DataEricom
Linux ltusergtEricom
In addition to the predefined macros listed above the PowerTerm WebConnect client
supports the usage of Java System Properties
Java System Properties available for users on Windows XP SP2
Java System Property Name Value Example
javaversion 150
javavendorurl httpwwwibmcom
javahome CIBMcommonpluginscomibmpvcwctruntim
esj2sewin32x86_150SR2-
20060511rcpeclipsepluginscomibmrcpj2sew
in32x86_150SR2-20060511jre
javavmspecificationversion 10
javavmversion 23
javavmvendor IBM Corporation
javavmname IBM J9 VM
PowerTerm WebConnect 33 Getting Started Guide
javaiotmpdir CDOCUME~1dianaLOCALS~1Temp
javacompiler j9jit23
javaextdirs CIBMcommonpluginscomibmpvcwctruntim
esj2sewin32x86_150SR2-
20060511rcpeclipsepluginscomibmrcpj2sew
in32x86_150SR2-20060511jrelibext
osname Windows XP
osarch x86
osversion 51 build 2600 Service Pack 2
pathseparator
username Jone
userhome CDocuments and SettingsJone
userdir CIBMRSA
usertimezone GMT+0200
System properties available for users on Linux RedHat 9
Java System Property Name Value Example
javaversion 150
javavendorurl httpwwwibmcom
javahome usrjavajre150_07
javavmversion 150
javavmvendor IBM Corporation
javavmname IBM J9 VM
javaclasspath
javalibrarypath
javaiotmpdir tmp
javacompiler
javaextdirs
osname Linux
osarch i386
osversion 2420-8
pathseparator
PowerTerm WebConnect 34 Getting Started Guide
username root
userhome root
userdir root
System properties names are placed in the configuration file within percent symbols ()
(like macros)
671 Configure the PowerTerm WebConnect Client
1 Open the Config Folder and edit the webconnectxml file Example
ltxml version =rdquo10rdquo encoding=rdquoUTF-8rdquogt
ltsection name=rdquoparametersrdquogt
ltitem key=rdquourlrdquo value=httpadminserverWebConnect56gt
ltitem key=rdquoserverrdquo value=rdquoadmin24000rdquogt
ltitem key=rdquossordquo value=rdquotruerdquogt
ltitem key=rdquodestrdquo value=rdquoCProgram FilesEricomrdquogt
ltsectiongt
2 Save the customized webconnectxml to a Web server folder available to all users It is
recommended to use the same Web server as the PowerTerm WebConnect Agent
Example
ltWebConnect installation foldergtwebwebconnectxml
3 Test the accessibility to this file - Type the URL of webconnectxml in the browser
Example
httpltWebServer IPgtWebConnectwebconnectxml
The contents of the file should be displayed
672 Configure the Preferences File
1 Open the plugins folder and open the PowerTermWebConnectClient_560365jar file
You can use Winzip version 70 and up or in Windows XP ndash Create a new file type for the
jar extension click advanced and select compressed (zipped) folder in the drop down list
Now you can open the JAR files in the Windows Explorer
The default contents of the file
configURL=httpleericomcomWebConnectwebconnectxml
2 Specify the accurate URL of the webconnectxml file Example
httpltWebServer IPgtWebConnectwebconnectxml
3 Save the file and close it The WinZip will display the following dialog
ldquoFile preferencesini has been changed since it was extracted Update archive
with this filerdquo
PowerTerm WebConnect 35 Getting Started Guide
4 Click Yes and close the archive
If you are editing the file from within the explorer you will have to save the file elsewhere
and then drag it to the explorer window where the JAR file is open
68 Installing PowerTerm WebConnect Client on Lotus Expeditor
1 Start the Lotus Expeditor client
2 Select File | Application | Install
3 Select Search for new features to install and click Next
4 Select Add Folder Location and type or select the location of the update site folder from
the provided package Click OK
5 Select the location you have just created and click Finish
6 In the Select the feature to install tree select Powerterm WebConnectUpdate Site Click
Next
7 Select I accept the terms in the license agreements and click Next
8 Click Finish
9 When prompted restart the platform
69 Running PowerTerm WebConnect Client for Lotus Expeditor
1 Click Open The PowerTerm WebConnect option is displayed
2 Select PowerTerm WebConnect The application will automatically connect and start
downloading the components from PowerTerm WebConnect Server
IMPORTANT
If you did not install PowerTerm WebConnect Server and are instead connecting to Ericom
Softwarersquos Demo WebConnect Server then you need to open port 443 in the firewall
691 PowerTerm WebConnect Client Workflow
1 PowerTerm WebConnect client reads the URL of webconnectxml from the preferencesini
file and requests it
2 When the webconnectxml is successfully downloaded the application reads the
configuration connects to the specified Web server downloads the PowerTerm
WebConnect components and connects to the PowerTerm WebConnect Server
3 The user is requested to login to the PowerTerm WebConnect Server For testing you
can use the username Example and password example
This step will be skipped if Single Sign-on is set to ldquotruerdquo
PowerTerm WebConnect 36 Getting Started Guide
4 After logging in to PowerTerm WebConnect Server the userrsquos applications are displayed
as defined by the administrator
5 To run an application select the desired application from the list and click Launch or
double-click the application The application will be launched in a separate window
610 Troubleshooting
When you encounter a problem the first step is to open the log file This file is located on
the client machine in the Ericom folder
Windows
CDocuments and SettingsltusernamegtEricomleclientEricomPluginlog
Linux
ltuser-home-directorygtEricomleclientEricomPluginlog
Following is a guide for diagnosing and fixing the problems in cases of error messages and
additional information
Error
Message
Solution
Version File
reading error
1 Check the lsquourlrsquo parameter in the webconnectxml file on the Web
server The value should be
httpltWebServerIPgtWebConnect
2 Try to run the following URL on the browser
Windows
httpltWebServerIPgtWebConnectwindowsptagentvertxt
Linux
httpltWebServerIPgtWebConnectlinuxix86qterm-
wcvertxt
The file contents displayed in the browser window should be in
the following form
560-rel14546
PowerTerm WebConnect Application Zone
560 - Main Release
ltrootgtPowerTerm WebConnect 56ltWebServergt
If the version file contents are not as shown check
- Is the Web Server running
- Are PowerTerm WebConnect Web Components and version files
PowerTerm WebConnect 37 Getting Started Guide
in place
3 On the Web server check ltPowerTerm WebConnect
rootgtwebwindowsptagentvertxt If the contents ldquolook wrongrdquo or
not in the proper form reinstall the PowerTerm WebConnect Web
components
4 On the client machine open the aforementioned URL in the
browser The file content should appear in the browser If it does
not it could be that the Web server is down
Web Server is
shut down
The webconnectxml configuration file must be located on the Web
server The explicit URL to this file is defined in the preferencesini
file (see Configure the Preferences File)
The error message contains the IP address of the Web server
Verify that the Web server on this machine is running
Version file
does not exist
on ltURLgt
See Version File reading error
The
configuration
file is not
accessible or
has a wrong
format
The webconnectxml configuration file must be located on the Web
server and the explicit URL to the configuration must be defined in
the preferencesini file (see Configure the Preferences File)
Try to open the URL specified in the error message in the
browser If it does not open then it either does not exist or it has
a wrong format
Preferences
file does not
exist in the
application
bundle
The preferencesini file containing the URL to the configuration
file was removed from the update site folder
Uninstall the current PowerTerm WebConnect client from the
client machine Create a new customized package (see
PowerTerm WebConnect Client Configuration) and reinstall it
Configuration
file URL is not
defined in
preference
file
The URL to the configuration file does not appear in the
preferencesini file (see Configure the Preferences File)
Uninstall the current PowerTerm WebConnect client from the
client machine Create a new customized package (see
PowerTerm WebConnect Client Configuration) and reinstall it
No IP address
could be
found for the
host
The Web server URL specified in the preferencesini file (see
Configure the Preferences File) or in the webconnectxml file (see
Configure the PowerTerm WebConnect Client) is an unknown
host
If the mistake is in the preferencesini file uninstall the current
PowerTerm WebConnect client from the client machine Create a
new customized package (see PowerTerm WebConnect Client
Configuration) and reinstall it
PowerTerm WebConnect 38 Getting Started Guide
If the mistake is in the webconnectxml file correct the file reopen
the Lotus Expeditor client
Cannot write
to destination
The temporary file cannot be written to the defined destination
Check the write permissions
Copied
configuration
file has wrong
format
The webconnectxml file as received from the specified URL has a
wrong format Correct the file and try again
PowerTerm
WebConnect
Agent URL is
malformed
The PowerTerm WebConnect Agent URL specified in the
webconnectxml file (see Configure the PowerTerm WebConnect
Client) does not have a proper HTTP format Correct the file and
try again
PowerTerm
WebConnect
Agent URL is
not defined
The PowerTerm WebConnect Agent URL parameter is not specified
in the webconnectxml file (see Configure the PowerTerm
WebConnect Client)
Correct the file and try again
The specified
destination
folder name
is wrong
The destination folder name contains illegal characters
ltgt|
Check the dst parameter in the webconnectxml file Correct the
file and try again
You do not
have
permissions
to write to
ltpathgt
The PowerTerm WebConnect Agent cannot be written to the
destination as defined Check the write permissions
The default destination defined in the version file should not to
be changed
A customized destination for PowerTerm WebConnect Agent
downloading can be defined in the webconnectxml file (See
Configure the PowerTerm WebConnect Client)
Check the destination value correct and try again
PowerTerm WebConnect 39 Getting Started Guide
About Ericom
Ericomreg Software is a leading provider of Application Access and Virtualization Solutions
Since 1993 Ericom has been helping users access enterprise mission-critical applications
running on a broad range of Microsoftreg Windowsreg Terminal Servers virtual Desktops
Blade PCs legacy hosts and other systems Ericom provides concrete business value by
helping organizations realize the benefits of their IT investments With offices in the United
States United Kingdom EMEA India and China Ericom also has an extensive network of
distributors and partners throughout North America Europe Asia and the Far East Our
expanding customer base is more than 30 thousand strong with over 7 million
installations
For more information on our products and services contact us at the location nearest to you
And visit our web site httpwwwericomcom
North America Western Europe International
Ericom Software Inc Ericom Software (UK) Ltd Ericom Software Ltd
231 Herbert Avenue Bldg 4 11a Victoria Square 8 Hamarpeh Street
Closter NJ 07624 USA Droitwich Worcestershire Har Hotzvim Technology Park
Tel +1 (201) 767 2210 WR9 8DE United Kingdom Jerusalem 91450 Israel
Fax +1 (201) 767 2205 Tel +44 (0) 845 644 3597 Tel +972 (2) 591 1700
Toll-free 1 (888) 769 7876 Fax +44 (0) 845 644 3598 Fax +972 (2) 571 4737
Email infoericomcom Email infoericomcouk Email infoericomcom
PowerTerm WebConnect 4 Getting Started Guide
64 Install PowerTerm WebConnect Portlet on IBM Workplace server (for Linux OS) 26
65 Install PowerTerm WebConnect Portlet on IBM WebSphere 61 server (for Windows OS) 27
66 PowerTerm WebConnect Server Configuration 29
67 PowerTerm WebConnect Client Configuration 29
68 Installing PowerTerm WebConnect Client on Lotus Expeditor 35
69 Running PowerTerm WebConnect Client for Lotus Expeditor 35
610 Troubleshooting 36
ABOUT ERICOM 39
PowerTerm WebConnect 5 Getting Started Guide
About this Document
This guide explains how to install and get started with PowerTerm WebConnect (PowerTerm
WebConnect Enterprise PowerTerm WebConnect RemoteView PowerTerm WebConnect
DeskView PowerTerm WebConnect HostView and PowerTerm WebConnect for Oracle) It
is intended for Administrators of PowerTerm WebConnect If you need more detailed
explanations on the different options in the administration tools or more information about
how to work with PowerTerm WebConnect please refer to the PowerTerm WebConnect
Administrators Manual
This document contains the following chapters
Chap 1 Product Overview Important information for
easy installation
Pg 6
Chap 2 Installing and Starting
PowerTerm WebConnect
Describes how to install and
start PowerTerm
WebConnect (Windows and
Linux editions) and its
different components as well
on how to launch the
PowerTerm WebConnect
Administration Tool
Pg 8
Chap 3 PowerTerm WebConnect
Administration Tool at a
Glance
Describes some main
features of the PowerTerm
WebConnect Administration
Tool and how to create
Connections and Publish
Applications
Pg 12
Chap 4 Accessing Virtual Desktops
and Blade PCs with
PowerTerm WebConnect
Describes how to configure
hosts and create pools with
PowerTerm WebConnect
DeskView and PowerTerm
WebConnect for Oracle VM
Pg 18
Chap 5 Download and Run
PowerTerm WebConnect
Clients
Describes where you can
download and run the
various PowerTerm
WebConnect clients
Pg 22
Chap 6 PowerTerm WebConnect
Client for Lotus Expeditor
Describes how to install
configure and run
PowerTerm WebConnect
Client for Lotus Expeditor
Pg 23
PowerTerm WebConnect 6 Getting Started Guide
1 Product Overview
PowerTerm WebConnect is an Enterprise-Wide Application Access solution that enables you
to publish and provide secure remote access to applications running on Windows Terminal
Servers Virtual Desktops (on top of hypervisors such as VMWare Microsoft Xen and
Virtual Iron) Blade PCs and legacy hosts Once published applications can be accessed
and used by end-users in a secure and managed fashion
Major components of the PowerTerm WebConnect product include
bull PowerTerm WebConnect Server
Choose between either Windows or Linux editions of the server
bull PowerTerm WebConnect DeskView Server
This component makes it possible to publish Desktops and applications that run on
Virtual Machines and physical machines
bull PowerTerm Load Balancer
Install the PowerTerm Load Balancer as a part of PowerTerm WebConnect Server
installation on the same computer or independently on a separate computer
Once installed it provides System and Application Load Balancing
bull PowerTerm WebConnect Web Components
Install these components on a compatible Web server in order to provide end-
users with a Web interface to published applications
bull PowerTerm WebConnect Administration Tool
Install the PowerTerm WebConnect Administration Tool on the server or on an
administration workstation It can also be downloaded on-demand
bull Client-side components
These components are installed as a part of the ldquoWeb server componentsrdquo
installation option and are usually downloaded by users the first time they need
the corresponding functionality Some components can be pre-installed if needed
Client side components include
RemoteView for accessing Windows Terminal Server applications and Virtual
Desktops from Windows and Linux workstations as well as from Windows Based
Terminals and Windows XPe and Linux based thin clients
HostView for accessing character-based applications running on legacy hosts
including IBM Mainframe IBM AS400 OpenVMS Unix Linux Tandem from
Windows and Linux workstations as well as from Windows Based Terminals and
Windows XPe and Linux based thin clients
SupportView for remote desktop support
PrintView for managing print queues
QuickVNC for remote desktop connectivity
bull PowerTerm Terminal Server Agent
Install this component on Windows Terminal Servers This component enables
PowerTerm WebConnect 7 Getting Started Guide
True Seamless Windows for published applications remote application browsing
and publishing and Application Load Balancing
bull PowerTerm WebConnect Portlet for JSR 168 Portals
Install this component if you plan to access Windows published applications and
Legacy hosts from within JSR 168 compatible portal environments such as IBM
Workplace or WebSphere Oracle Portal Vignette Portal and the like
bull PowerTerm WebConnect Plugin for IBM Lotus Expeditor
Install this plugin if you plan to access Windows published applications and Legacy
Hosts from within the IBM Lotus Expeditor environment
bull PowerTerm WebConnect DeskView
This component makes it possible to publish Desktops and applications that run on
Virtual Machines and physical machines
The evaluation package of PowerTerm WebConnect that you can download and
install contains the PowerTerm WebConnect Enterprise product with all its
components Once activated the product will only include the components and
features of the specific PowerTerm WebConnect product you purchased
PowerTerm WebConnect 8 Getting Started Guide
2 Installing and Starting PowerTerm WebConnect
PowerTerm WebConnect includes both server-side and client-side components The server
side includes
bull PowerTerm WebConnect Server
bull PowerTerm WebConnect DeskView Server
bull PowerTerm WebConnect Load Balancer
bull PowerTerm WebConnect Administration tools (for WebConnect Server PowerTerm
Load Balancer and DeskView Server)
The client side has numerous clients such as
bull RemoteView
bull HostView (for both Windows and Linux)
bull QuickVNC etc
21 Install PowerTerm WebConnect (Windows edition)
1 Run the installation file typically named PowerTermWebConnect5xexe You will find
the file on the installation CD or you can download it from Ericoms website
2 Click Install and then enter your Serial Number or click Evaluate when prompted
3 Continue with installation and select Full Installation Server Administration Tool and
WebServer Components (default) in the Setup Type dialog
4 Complete the installation and click Exit and run PowerTerm WebConnect in the last
dialog of the installation Depending on your computer this may take a few minutes
The first time you launch the PowerTerm WebConnect server it will generate a
Diffie-Hellman key for SSL encryption This process may take several minutes
depending on the speed of your computer A visual progress indicator will show
you when this process is completed While this process is taking place PowerTerm
WebConnect clients will not be able to connect to the server
22 StartStopRestart PowerTerm WebConnect Server (Windows edition)
PowerTerm WebConnect server is installed as a Windows service
1 Launch the standard Services console from the Windows Control Panel On some
computers it may be located under the Administrative Tools group You can also run
the command SERVICESMSC The Services window is displayed
PowerTerm WebConnect 9 Getting Started Guide
2 Select PowerTerm WebConnect Server 5x service (the primary service of PowerTerm
WebConnect) where x is the version number and use standard StartStopRestart
options
The PowerTerm WebConnect Server Starter 5x service (the secondary service of
PowerTerm WebConnect) is designated for restarting the primary service in
cases of failure or any unexpected problems The secondary service is
controlled by internal logic of PowerTerm WebConnect and cannot be stopped
from the Services console
23 Install Run and Stop PowerTerm WebConnect Server (Linux edition)
Transfer the installation file to your Linux server and install the PowerTerm WebConnect
components in the RPM package using the following shell command
rpm ndashi WebConnecct-5x-0i586rpm
(lsquoxrsquo is the version number)
The PowerTerm WebConnect server will be installed to
optWebConnect5x
All PowerTerm WebConnect clients including PowerTerm WebConnect
Administration Tool are published via the Web server Therefore you need to
manually configure the Web server to publish the path optWebConnect56web
The name of the virtual directory has to be WebConnect5x
After configuring the virtual directory you can launch any client from httpltservernamegtWebConnect5xClientURLshtml
Users of Red Hat 72
If you installed the PowerTerm WebConnect server on Red Hat 72 you also have to install
the file libgcc-304-1i386rpm (44Kb) in order for PowerTerm WebConnect Server to run
This file can be downloaded from
ftprpmfindnetlinuxredhatupdates72enosi386libgcc-304-1i386rpm The file is
also available on the installation CD and can as well be downloaded from the ldquoEvaluate
PowerTerm WebConnect Linux x86 Editionrdquo web page
Use the following commands to run the PowerTerm WebConnect server
On RedHat
sbinservice webconnectd start
On Suse
etcrcdwebconnectd start
Use the following commands to stop the PowerTerm WebConnect server
On RedHat
sbinservice webconnectd stop
PowerTerm WebConnect 10 Getting Started Guide
On Suse
etcrcdwebconnectd stop
24 Install the Terminal Server Agent
PowerTerm WebConnect Terminal Server Agent must be installed on a Terminal Server
accessed using PowerTerm WebConnect It provides the True Seamless Windows
functionality for published applications remote browsing and publishing and Application
Load Balancing
The PowerTerm WebConnect Terminal Server Agent must be installed on every Terminal
Server in the cluster If you install the PowerTerm WebConnect server itself on a Terminal
Server you will be given the option to install the Terminal Server Agent as a part of the
server installation Alternatively use the PowerTermTerminalServerAgentexe file located in
the AddOnsTerminalServerAgent subdirectory under the PowerTerm WebConnect server
installation directory
To complete the installation you might need to restart the Terminal Server machine
25 Install PowerTerm WebConnect DeskView Server
PowerTerm WebConnect DeskView is automatically installed when you run PowerTerm
WebConnect Installation wizard ndash Full installation To run PowerTerm WebConnect
DeskView Server you also need Microsoft NET Framework v30 to be installed on your
computer If you do not have it installed then the installation wizard will place the
DeskViewServerSetupmsi and DeskViewAdminSetupmsi files in the AddOns folder
(ltPowerTerm WebConnect Installation FoldergtWebConnect 5xAddOnsDeskView
VDI) from where you can run the msi files at a later stage to install PowerTerm
WebConnect DeskView
26 Start the PowerTerm WebConnect Administration Tool
There are several ways to launch the PowerTerm WebConnect Administration Tool Select
the one most convenient for you
bull From Windows Start menu select Programs | Ericom Software | PowerTerm WebConnect
5x | PowerTerm WebConnect Administration Tool
If you changed the Program Folder during installation the Start menu path
may vary
bull Double-click PtAdminexe PtAdminexe is located in the bin directory of the
PowerTerm WebConnect installation folder
bull Rather than installing you can choose to download the Administration Tool to any
Windows computer Please refer to the PowerTerm WebConnect Sample URLs
page (httpltweb_servergtWebConnect5xClientURLshtml) for more details
A few things to remember
PowerTerm WebConnect 11 Getting Started Guide
When you launch the PowerTerm WebConnect Administration Tool for the first time the Connection dialog is displayed with the user Administrator No
password is required to enter just click Connect
In the Connection dialog (displayed when launching the Administration Tool) the
Host Name is localhost by default This is correct only if the Administration Tool
runs on the same machine as the server If the Administration Tool runs on a different machine you need to change the Host Name to the IP addressHostname
of the PowerTerm WebConnect server
When using the PowerTerm WebConnect Windows edition by default the
Administration Tool will deny any connection attempts from any computer other
than the local machine
PowerTerm WebConnect 12 Getting Started Guide
3 PowerTerm WebConnect Administration Tool at a Glance
PowerTerm WebConnect Administration Tool manages published applications user sessions
and server configuration The administrator can perform operations such as multiple
application publishing sending messages to logged-on users shutting down sessions and
monitor user activity
To perform the tasks described in this chapter you must launch the Administration Tool via one of the methods detailed in chapter Start the PowerTerm
WebConnect Administration Tool
Launching the Administration Tool from the system tray or using the
Administration Tool launched after completed installation will not allow you to
activate certain features
After you launched the Administration Tool and connected to the server you will receive a
Welcome screen where you select desired activity
bull Publish Multiple Applications opens the Publish Multiple Applications wizard
bull Configure Load Balancer opens PowerTerm Load Balancer Administration Tool
bull Create a Host Connection opens the Add Connection dialog
bull Configure Active Directory opens the Directory Services dialog
PowerTerm WebConnect 13 Getting Started Guide
Close the Welcome screen to enter the Administration Tool main
screen
The Administration Tool main screen has three sections
bull User section lists all users defined in the server
bull Group section lists all groups defined in the server
bull Connection section lists all connections and published applications defined in the
server
By default only the Connection section is displayed when you first open Administration Tool
There are three predefined example-connections ldquoExample_As400rdquo ldquoExample_VTrdquo and
ldquolocalhostrdquo You can test them prior to defining your own
1 Right click the connection you want to test and select Test The PowerTerm
WebConnect HostView Login dialog appears
2 Type example for User Name and example for Password
Credential fields are case sensitive
3 Click Login The desired connection with its pre-programmed demo application is
launched
PowerTerm WebConnect 14 Getting Started Guide
31 Publishing Applications and Documents
In order to enable access to applications and documents on Windows Terminal Servers
publish these applications and documents from the Administration Tool When publishing
applications and content you can specify which servers will be used in a Terminal Server
cluster and which users and groups will have access to these services Once you have
published such applications and documents the RemoteView client can be used to access
them
If you need to provide access to multiple applications on a Terminal Server use the Multiple Application Publishing wizard to significantly reduce the time and
effort required to publish these applications
To publish multiple Windows applications
1 Click Publish Multiple Applications in the Welcome screen The Choose Terminal Server
for Browsing dialog appears
2 Provide the address of the Terminal Server which will be used for browsing and click OK The Application Publisher Step 1 dialog appears This dialog lists all the
applications available in the specified serverrsquos Start menu
3 Select those applications found in the Programs folder of the designated server that you want to publish and click Next The Application Publisher Step 2 dialog appears
4 Determine the destination of your publishing and click Next The Application Publisher
Step 3 dialog appears
5 Determine the Color Quality of your published application
6 Determine the start mode in which you want to run the published application - normal maximized or minimized - and click Next The Application Publisher Step 4
dialog appears
7 Choose the connection speed that matches your infrastructure The connection speed
setting determines the value of three visual effects settings You can also override
these settings specifically
8 Determine whether you prefer the window to display their content while being
dragged or just the outline By default the same setting is used as the client desktop
9 Click Next The Application Publisher Step 5 dialog appears
10 Specify where sounds are to be played ndash locally or remotely
11 Determine which local devices the remote session will have access to (local drivers printer etc) and click Next The Application Publisher Step 6 dialog appears
12 If you have the PowerTerm Load Balancer installed Use all Servers (default) allows the application to run on any Terminal Server in the
cluster This setting is appropriate when the application is installed on all the Terminal
Servers Alternatively you select specific Terminal Servers on which to run this
application
If you have not installed the PowerTerm Load Balancer you will need to explicitly
specify the address of the Terminal Server on which the application will be run
PowerTerm WebConnect 15 Getting Started Guide
13 Click Next The Application Publisher Step 7 dialog appears
14 Select the users groups or OUs to which you wish to publish the applications and click Next The Application Publisher Step 8 dialog appears By default applications will
be published to everybody
15 Click Advanced Settings to modify settings such as the login credentials to the
Terminal Servers By default PowerTerm WebConnect credentials will be passed
through to the Terminal Server
16 Click Finish The published applications appears in the Connection List
Right-click and select Properties or double click on the published application in the
Connections list to view and modify any of the settings which you previously
defined
To publish a remote Desktop
1 Select Action | New | Remote Desktop The Application Publisher Step 1 dialog appears
2 Type the Display Name which will be the name presented to the end-users and click
Next The Application Publisher Step 2 dialog appears
3 Specify where icons for the published desktop will be displayed to the end-user in Publish to
4 Click Choose Icon to replace the desktoprsquos default icon Select the desired icon from
the list that appears
5 Click Next The Application Publisher Step 3 dialog appears
6 Determine Screen Size and the Color Quality of the published desktop
7 If desirable select Show Connection Bar in Full Screen Mode
8 Click Next The Application Publisher Step 4 dialog appears
9 Choose the connection speed that matches your infrastructure The connection speed
setting determines the value of three visual effects settings You can also override
these settings specifically
10 Click Next The Application Publisher Step 5 dialog appears
11 Specify where sounds are to be played ndash locally or remotely Where to Apply Window
Key Combinations and which local devices you want to automatically connect to when
logged on to the remote computer
12 Click Next The Application Publisher Step 6 dialog appears
13 Specify the Server Address and Port Number of the Terminal Server that weill provide
the desktop and click Next The Application Publisher Step 7 dialog appears
14 Select the users groups or OUs to which you wish to publish the desktop and click Next The Application Publisher Step 8 dialog appears
Select the Server group to allow all users to access the published application
15 Click Advanced Settings to modify settings such as the login credentials to the
Terminal Servers By default PowerTerm WebConnect credentials will be used
PowerTerm WebConnect 16 Getting Started Guide
16 Click Finish The published application appears in the Connection List
Right-click Properties or double click on the published application in the
Connections list to modify any of the settings which you previously defined
32 Create Terminal Emulation Connections
To provide access to legacy host systems you will need to create Terminal Emulation
connections For each such connection you can specify the host address emulation type
login script and more Once you have created these connections users will be able to
launch them using HostView (Windows or Linux) WebView or the Java client as
appropriate
1 Click Create a Host Connection in the Welcome screen The Add Connection dialog
appears
2 Enter a Name for the new connection
3 Specify an Owner for the new connection The possibilities are
[None] the connection will not be allowed to run by anyone and it will not be
displayed in any Connection list Server the connection will be accessible for all users of this PowerTerm
WebConnect server A specific group the connection will be accessible for all users of the specified
group A specific user the connection will be accessible for a specified user only
4 Leave category Terminal Emulation selected
5 Select Terminal Type Terminal Model and Communication Type as needed
6 Specify the Host Name or IP address of your host
7 Specify other parameters as needed
8 Select the Security Type as needed if your host supports SSL or SSH and specify
the appropriate details in the Details dialog
9 Use the Settings Key Mapping and Power Pad options to further customize the
connection
10 Click OK and the connection is created
33 Test Connections
It is recommended to test published applications or host connections before they are made
available to end-users
To test a connection
bull Right-click the target connection from the Connection section of the main screen and
select Test
Alternatively
PowerTerm WebConnect 17 Getting Started Guide
1 Select Tools | Run ltdesired clientgt The Login to WebConnect dialog appears
2 Enter the User Name and Password for the individual who owns the connection that
you want to test and click Login The desired PowerTerm WebConnect client is started
and the Connect dialog appears
3 Select the desired connection and click Connect The test is executed
34 Launch the Application Zone or the Application Portal
Users can access the published applications from the Application Zone application launcher
or from the Application Portal web interface
To use the Application Zone go to Start menuProgramsEricom SoftwarePowerTerm
WebConnect 5x and select Client URLs Alternatively type the following URL into your Web
browserrsquos address bar httpltserver addressgtWebConnect5xClientURLshtml In the
page that opens click on the Run button next to the Application Zone to launch it
To use the Application Portal go to Start menuProgramsEricom SoftwarePowerTerm
WebConnect 5x and select it Alternatively type the following URL into the Web browserrsquos
address bar httpltserver addressgtWebConenct5xportalwindowsindexasp
35 Monitor a Users Sessions
From the Administration Tool you can monitor the users sessions and may intervene if
necessary This intervention may result in your input appearing on the users screen The
user receives a notification when an administrator begins and ends monitoring the session
1 Select View | Client Sessions or click to see all the active client sessions
2 Select the desired active session and right-click Attach The Password Verify dialog
appears
3 Enter your password and click OK Some notification dialogs appears and the selected
PowerTerm WebConnect session is viewed
36 View Intruders
bull The Intruders window shows suspected attempts at breaching security After several
suspected intrusion attempts users are blocked temporarily
bull In addition to showing suspected intrusion attempts the Intruders window allows
you to remove restrictions on users
bull Select View | All Intruders or click
PowerTerm WebConnect 18 Getting Started Guide
4 Accessing Virtual Desktops and Blade PCs with PowerTerm WebConnect
This chapter provides instructions on configuring PowerTerm WebConnect for Virtual
Desktop Infrastructure (VDI)
41 Step 1 Launch DeskView Administration Tool
Verify that PowerTerm WebConnect is installed on your server and launch PowerTerm
WebConnect Admin Tool
bull Select Tools | Open VDI Manager The PowerTerm WebConnect DeskView Administration
Tool opens
The first time you launch the DeskView Administration Tool you will be prompted to install
the tool
PowerTerm WebConnect 19 Getting Started Guide
Microsoft Management Console 30 is required for PowerTerm WebConnect DeskView
Administration Tool If you do not have this installed you will also automatically be
prompted to install this update
Follow the installation processes when you are prompted for either install PowerTerm
WebConnect DeskView Administration Tool will automatically launch when these
installations are completed
42 Step 2 Add a Host
1 Right-click Virtualization Hosts and select Add Host The Add a New Host wizard
opens Click Next
2 Enter a Host Name as you would like it to appear in PowerTerm WebConnect
DeskView Administration Tool and a description (optional) Click Next
3 Specify the Virtualization Server type and click Next
4 Specify the connection information and click Next
VMWare Virtual Center v1x and 2x
Specify the HTTPS Web Service address and a UsernamePassword that can access
the host
VMWare Virtual Server 2005
Click Start and then Run
Type ldquoservicesmscrdquo and click OK
Scroll down to PowerTerm WebConnect DeskView Server service and open
Properties
Change the Login Account for the service to match the Domain Administrator
account and password used when setting up Microsoft Virtual Server 2005 and
restart the service Enter the IP or NETBIOS name of the Microsoft Virtual Server 2005 server as the
Server Address in the Connection Broker Wizard
Xen Server
Specify the hypervisor IP address or NETBIOS name the Root UsernamePassword
to the hypervisor and the Service port (default 80)
Oracle VM
Specify the Serverrsquos agent URL and Port (default 8899) for example
httpsltservernamegt8899
Specify the Oracle VM hypervisorrsquos Oracle Agent UsernamePassword (default
username oracle)
5 Click Finish to add the new Host
To configure Virtual Machines for use install the Ericom Tools (vmagentmsi) on each of the
virtual machines on the new host for PowerTerm WebConnect DeskView to recognize them
The vmagentmsi installer is located on the PowerTerm WebConnect server in ltPowerTerm
WebConnect installation foldergtAddOnsDeskView VDI folder (default installation
PowerTerm WebConnect 20 Getting Started Guide
folder is xProgram FilesEricom SoftwareWebConnect 56) During installation you
will need to enter the DeskView IP address or NETBIOS name
If you are using Microsoft Virtual Server 2005 as your Virtualization Host use the
IP address of the DeskView server only when installing the Ericom Tool package
43 Step 3 Create a Pool
Pools are used to organize Virtual Machines (VM) into logical groups This enables
organizations to combine and order resources from multiple systems into one entity To
access available resources end-users simply connect to PowerTerm WebConnect to access
any configured resource
1 Right-click Pools and select Create Pool The Create a Pool wizard opens Click
Next
2 Enter a Pool name as you wish it to appear and a description (optional) and click
Next
3 Specify the Pool type and click Next
4 Specify the Assignment type and click Next
Permanently will cause a virtual machine to affix to the user who has launched
that virtual machine For the duration of the session will cause any virtual machine that is not in use to
be returned to the pool for any user to launch
5 Specify the LogoffDisconnect event and click Next
Select what you would like to happen after a user logs off from a virtual machine
in this pool
Select what you would like to happen when a user is disconnected from a virtual
machine in this pool
6 Click Finish to add the new Pool
You will need to assign virtual machines from your virtualization hosts to your created pool
1 Right-click the pool and select Assign Machines The Assign Machines to ltyour
pool namegt dialog opens
2 Highlight the desired virtual machine(s) and click Select Click OK
44 Step 4 Publish an ApplicationDesktop
1 Return to PowerTerm WebConnect Admin Tool to publish DeskView pools
2 Determine whether to publish a full desktop or a seamless application running
from a virtual desktop
For a full desktop
Select Action | New | Remote Windows Desktop
For a seamless application
Select Action | New | Windows Application
PowerTerm WebConnect 21 Getting Started Guide
3 Select Virtual Desktop in the first step of the wizard and click Next
4 Follow the wizardrsquos instructions until you reach the Virtual Desktops step
5 Select a pool that you previously created and that you would like this connection to choose virtual machines from Click Next
6 Continue and complete the reminder of the wizardrsquos steps
Once the resource is published users who have been assigned access will be able to use it
immediately
PowerTerm WebConnect 22 Getting Started Guide
5 Download and Run PowerTerm WebConnect Clients
PowerTerm WebConnect clients are automatically downloaded and installed onto the client
devices For detailed information and samples please refer to the PowerTerm WebConnect
Sample URLs page To see this page navigate your browser to
httpltweb_servergtWebConnect5xClientURLshtml
PowerTerm WebConnect 23 Getting Started Guide
6 PowerTerm WebConnect Client for Lotus Expeditor
61 Installation Package
PowerTerm WebConnect client for Lotus Expeditor is provided to IBM in an Update Site
package This is a ZIP archive containing the Update Site with the Eclipse feature and plug-
in that comprises the PowerTerm WebConnect client
Extract the ZIP file keeping the foldersrsquo structure intact
NOTE In Winzip verify that the ldquoUse folder namesrdquo option is set to TRUE
Package structure
Update Site
- plugins
- PowerTermWebConnectClient_560365jar
- features
- comericomWebConnect_560365jar
- sitexml
config
- webconnectxml
Definitions
bull webconnectxml PowerTerm WebConnect client configuration file
bull comericomWebConnect_560365jar PowerTerm WebConnect client feature file
bull PowerTermWebConnectClient_560365jar PowerTerm WebConnect client plugin file
62 Pre-installation steps
PowerTerm WebConnect client for Lotus Expeditor does not run independently but in
conjunction with PowerTerm WebConnect Server You can either install it and define your
users groups and applications or use Ericom Softwarersquos Demo PowerTerm WebConnect
Server
bull If you decide to install PowerTerm WebConnect Server you will need the full
installation ie the PowerTerm WebConnect Server and the Web components If you
do not have the installation CD you can download and install a trial version from
wwwericomcom
PowerTerm WebConnect 24 Getting Started Guide
bull If you decide to use Ericom Softwarersquos Demo PowerTerm WebConnect Server then
skip to the chapter Installing PowerTerm WebConnect Client on Lotus Expeditor
63 Install PowerTerm WebConnect Portlet on IBM Workplace server (for Windows OS)
Step 1 Install PowerTerm WebConnect Server
If PowerTerm WebConnect Server and IBM Workplace Server are on separate machines
bull Configure PowerTerm WebConnect Server
Launch PowerTerm WebConnect Administration Tool
Open Files | Configuration | Main
In the [Portal] section edit
Machines=localhostltIBM sever machinegt
bull Configure PowerTerm WebConnect Web components
Copy the ldquowebrdquo folder from the PowerTerm WebConnect server installation to the
IBM Workplace server machine
Create an Alias or a Virtual directory to it named WebConnect on the Web
server providing access to it for the users This is in order to enable the users to
download the necessary files to run their applications
Step 2 Enable JSR portlets
1 On IBM Workplace Server go to ltPortalServergtsharedappconfigservicesConfigServiceproperties
2 Edit portalenablejsr168=true
3 Save and close the file
Step 3 Enable SSO
1 On IBM Workplace Server go to ltPortalServergtsharedappconfigservicesLoaderServiceproperties
2 Edit commandpath=comericomportalcommandscomibmwpsenginecommands
3 Save and close the file
Step 4 Copy Files
The following files need to be copied from WebConnect ServerAddOnsIBM
WorkplacePortlet folder to IBM Workplace Server
File name to copy Destination folder
OpenSSLdll ltAppServergtjavajrebin
IbmPortaldll ltAppServergtjavajrebin
IbmPortalini ltAppServergtjavajrebin
PowerTerm WebConnect 25 Getting Started Guide
WebConnectPortaljar ltAppServergtlib
EricomLoginjar ltPortalServergtsharedapp
Step 5 Portlet Configuration
1 On IBM Workplace Server go to ltAppServergtjavajrebinIbmPortalini
2 You can modify the following parameters in the [Server=WebConnect] section webserverport=ltIBM web server portgt
Specifies the Web server port for accessing the PowerTerm WebConnect clients folder
Default 80 Address
Specifies the address of the PowerTerm WebConnect Server machine for Portlet to
connect to when PowerTerm WebConnect Server is located on a different machine
than the IBM Workplace Server CustomAddress
Specifies the addresss of the PowerTerm WebConnect Server machine for Clients to connect to If CustomAddress is the same as Address then this may be omitted webserveraddr
Specifies the address of the Web Server machine when it is located on a different
machine than the IBM Workplace Server
3 Restart the IBM server ltPortalServergtrootscriptsstopWorkplaceServicesbat ltPortalServergtrootscriptsstartWorkplaceServicesbat
This procedure may take about 20 minutes
Step 6 Install the Portlet
1 In a Web browser open the URL httpltIBM Workplace
Servergt9081lwpmyworkplace to open the IBM Workplace Portal
2 Login as administrator
3 Go to Administration | Portlets | Install
4 Browse to the PowerTerm WebConnectwar file located on PowerTerm WebConnect
Server and click Next
5 Click Install
Step 7 Create an Application page
1 Login to the Workplace
2 Go to Portal User Interface | Manage Pages
3 Search for My Work
4 Click the My Work link and select New Page
5 Name the page PowerTerm WebConnect and click OK
6 Click OK again You will see the created page on the list
7 Click the pencil icon on the new page and select the 1 square layout
PowerTerm WebConnect 26 Getting Started Guide
8 Click Add Portlet and search for PowerTerm WebConnect
9 Select it and click OK
10 Click Done
11 Click My work at the top of the page PowerTerm WebConnect is displayed on the list
Step 8 Run the Portlet
1 Restart IBM Workplace Server
2 Open IBM Workplace Portal in a browser httpltportal servergtlwpmyworkplace
3 Login to IBM Workplace Server
4 Click My work PowerTerm WebConnect portlet is displayed
5 Launch it The Userrsquos applications as defined on PowerTerm WebConnect Server
appear
6 Click an application to launch it
64 Install PowerTerm WebConnect Portlet on IBM Workplace server (for Linux OS)
Step 1 Enable JSR 168 portlets
1 Go to optIBMWorkplacePortalServersharedappconfigservicesConfigServiceproperties
2 Modify the portalenablejsr168 property to ldquotruerdquo
3 Restart the server cd optIBMWorkplacePortalServerrootscripts
Run stopWorkplaceServicessh
Run startWorkplaceServicessh
This procedure can take up to 20 minutes
4 Log on to the workplace server at httpltworkplace servergt9081lwpmyworkplace using
the administrators username and password
Step 2 Install the portlet
1 Restart IBM Workplace Server
2 In a Web browser open the URL httpltworkplace server IPgtlwpmyworkplace
3 Login to IBM Workplace Server as an administrator
4 Go to Administration | Portlets | Install
5 Browse to the PowerTerm WebConnectwar file located on PowerTerm WebConnect
Server and click Next
6 Click Install
PowerTerm WebConnect 27 Getting Started Guide
Step 3 Install the Application page
1 Login to the workplace as administrator
2 Go to Administration | Portal User Interface | Manage Pages
3 Search for My Work
4 Click the My Work link and select New Page
5 Name the page PowerTerm WebConnect and click OK
6 Click OK again You will see the created page on the list
7 Click the pencil icon and select the 1-square layout
8 Click Add Portlet and search for PowerTerm WebConnect
9 Select it and click OK
10 Click Done
11 Click My work on top and PowerTerm WebConnect is displayed on the left bar
Step 4 Run the portlet
1 Restart IBM Workplace Server
2 Open IBM Workplace Portal in a browser httpltportal servergtlwpmyworkplace
3 Login to IBM Workplace Server
4 Click My work PowerTerm WebConnect portlet is displayed
5 Launch it The Userrsquos applications as defined on PowerTerm WebConnect Server
appear
6 Click an application to launch it
65 Install PowerTerm WebConnect Portlet on IBM WebSphere 61 server (for Windows OS)
Step 1 Install PowerTerm WebConnect Server
You have to configure PowerTerm WebConnect Server if it and the IBM WebSphere Server
are on separate machines
1 Launch PowerTerm WebConnect Administration Tool
2 Open Files | Configuration | Main
3 In the [Portal] section edit Machines=localhostltIBM sever machinegt
Step 2 Copy Files
The following files need to be copied from WebConnect ServerAddOnsIBM
WebSpherePortlet folder to IBM WebSphere Server
PowerTerm WebConnect 28 Getting Started Guide
File name to copy Destination folder
OpenSSLdll ltAppServergtjavajrebin
IbmPortaldll ltAppServergtjavajrebin
IbmPortalini ltAppServergtjavajrebin
WebConnectPortaljar ltAppServergtlib
Step 3 Portlet Configuration
1 On IBM Workplace Server go to ltAppServergtjavajrebinIbmPortalini
2 You can modify the following parameters in the [Server=WebConnect] section webserverport=ltIBM web server portgt
Specifies the Web server port for accessing the PowerTerm WebConnect clients folder
Default 80 Address
Specifies the address of the PowerTerm WebConnect Server machine for Portlet to
connect to when PowerTerm WebConnect Server is located on a different machine
than the IBM Workplace Server CustomAddress
Specifies the addresss of the PowerTerm WebConnect Server machine for Clients to connect to If CustomAddress is the same as Address then this may be omitted webserveraddr
Specifies the address of the Web Server machine when it is located on a different
machine than the IBM Workplace Server
3 Restart the IBM server ltAppServergtProfilesAppServer01binstopServerbat ltAppServergtProfilesAppServer01binstartServerbat
This procedure may take about 20 minutes
Step 4 Install the Portlet and create an Application page
1 In a Web browser open the URL httpltIBM WebSphere Servergt9060ibmconsole
to open the IBM WebSphere Portal
2 Login and go to Applications | Install New Application
3 Browse to the PowerTerm WebConnectwar file located on PowerTerm WebConnect
Server
4 Enter Context root and click Next The Select installation options dialog appears
5 Optional change options to your preference or keep the default
6 Click Next
7 Select Ericom in the Module column click Apply and then Next
8 Click Finish and then Save
9 Select Applications | Enterprise Applications
10 Select PowerTerm WebConnectwar checkbox and click Start
PowerTerm WebConnect 29 Getting Started Guide
11 Enter in the Web browser the URL httpltIBM WebSphere
Servergt9080ltContext rootgtEricom portlet The Login dialog appears
12 Login and you will see PowerTerm WebConnect displayed on the list
Step 5 Run the Portlet
1 Restart IBM WebSphere Server
2 Open IBM WebSphere Portal in a browser httpltportal servergt9080ltContext
rootgtEricom portlet
3 Login to IBM WebSphere Server
4 Launch it The Userrsquos applications as defined on PowerTerm WebConnect Server
appear
5 Click an application to launch it
66 PowerTerm WebConnect Server Configuration
bull To enable the Lotus Expeditor to run the PowerTerm WebConnect client the
System Administrator must provide the users with accounts on PowerTerm
WebConnect Server (see the PowerTerm WebConnect Administratorrsquos Manual for
instructions on how to create users groups and connections on the PowerTerm
WebConnect Server)
bull To enable PowerTerm WebConnectrsquos Single Sign-On feature the System
Administrator must create a PowerTerm WebConnect user with the same
username and password as used for the Lotus Expeditor For a managed Lotus
Expeditor the credentials used are the username and password sent to the
managing server For an unmanaged Lotus Expeditor the operation system
username and the Lotus Expeditor password are used as credentials
NOTE If a password is not defined then the Single Sign-On will fail and the user will be
prompted with a login dialog
67 PowerTerm WebConnect Client Configuration
The PowerTerm WebConnect client is configured in webconnectxml located in the config
folder webconnectxml parameters are
url The PowerTerm WebConnect Agent url
server The PowerTerm WebConnect Server address
sso The Single Sign-On feature
dst The local destination for downloading PowerTerm WebConnect
components
PowerTerm WebConnect 30 Getting Started Guide
url
PowerTerm WebConnect components are installed on a Web server Their default url is
Windows Agent
httpltWebServer IPgtWebConnectwindowsptagentcab
Linux Agent
httpltWebServer IPgtWebConnectlinuxix86qterm-wczip
The url parameter must include the first part of the url (which is identical for both Windows
and Linux agents)
The PowerTerm WebConnect client will automatically append the appropriate suffix in
order to create a full accurate url
Example
ltitem key=rdquourlrdquo value=httpadminserverWebConnectgt
server
The computer name or IP address of the PowerTerm WebConnect Server machine
The PowerTerm WebConnect client will log in to this PowerTerm WebConnect Server
display the applications defined on it and run them according to this serverrsquos configuration
Format ltserver IPgt[ltportgt]
where default port is 4000 (can be edited)
Example
ltitem key=rdquoserverrdquo value=rdquoadmin24000rdquogt
sso
Determines whether Single Sign-on will be used to log in to PowerTerm WebConnect
Server Values
bull True (default) the client should automatically log in to the PowerTerm WebConnect
Server using the same credentials as the ones used to log in to the Lotus Expeditor
client
The System Administrator must verify that these credentials can log in to the
PowerTerm WebConnect Server
bull False the user will be prompted with a login dialog or will log in automatically using
previously saved credentials
Example
ltitem key=rdquossordquo value=rdquotruerdquogt
Autologin mode
PowerTerm WebConnect 31 Getting Started Guide
If sso is set to True the user is not prompted for credentials and the login process to
PowerTerm WebConnect Server is done automatically sending the credentials used for the
Lotus Expeditor unless the Lotus Expeditor does not have a password defined (In the
Lotus Expeditor preferences page | Password| Prompt me for a password at start up checkbox)
However if Single Sign-on is not used there are several options regarding Autologin that
can be defined in the PowerTerm WebConnect Preferences page Options
bull Yes
bull No
bull Interactive
bull First time interactive (default) ndash Simplifies the login process to PowerTerm
WebConnect Server In this mode the first time the user logs in to PowerTerm
WebConnect Server he will be prompted for his credentials with the Login dialog
These credentials will be stored in the machine and from then on the login process to
PowerTerm WebConnect Server will be done automatically
1 Open File | Preferences from the Lotus Expeditor and select PowerTerm WebConnect
2 In the Autologin to WebConnect Server section select First Interactive and click OK
3 Start PowerTerm WebConnect Client for Lotus Expeditor If credentials were entered
at least once then the next time the client will connect to PowerTerm WebConnect
Server without prompting for the user name and password
The Administrator must configure the Agent to do nothing when it exits for the
feature to work this way See PowerTerm WebConnect Administratorrsquos Manual for more information about defining Autologin
bull Allow multiple selection ndash Defines whether the user can launch more than one
application at a time (by using the ltCtrlgt or ltShiftgt button while selecting applications)
dst
Defines the path to download PowerTerm WebConnect components on the client machine
The dst parameter can contain macros which are translated by the PowerTerm WebConnect
Client for Lotus Expeditor during runtime The macros should be placed between percent
symbols () for example WebServer
When such a value is defined the PowerTerm WebConnect Client for Lotus Expeditor
substitutes the entire expression for the macrorsquos value
The PowerTerm WebConnect Client for Lotus Expeditor does not support the use
of environment variables as macros
Macros are not case sensitive
Macros supported by PowerTerm WebConnect Client for Lotus Expeditor
Macro name Description
WebServer The name of the Web server
It is obtained from the PowerTerm WebConnect Agent url
PowerTerm WebConnect 32 Getting Started Guide
parameter
Name The name of the clientrsquos CAB or ZIP file eg ldquoptagentrdquo
Display The clientrsquos display name from the version file
Version The clientrsquos version value It is obtained from the version
file
Root The default root location
Windows ldquoCrdquo
LinuxUnix an empty string
OSDir Windows Windowsrsquo installation directory for example
ldquoCWindowsrdquo
Linux an empty string
OSDrive Windows Windowsrsquo installation drive for example ldquoCrdquo
Linux an empty string
HomePath Windows The HOMEPATH environment variable
Linux The HOME environment variable
Home The Ericom folder in the userrsquos home directory
Windows CDocuments and SettingsltusergtApplication
DataEricom
Linux ltusergtEricom
In addition to the predefined macros listed above the PowerTerm WebConnect client
supports the usage of Java System Properties
Java System Properties available for users on Windows XP SP2
Java System Property Name Value Example
javaversion 150
javavendorurl httpwwwibmcom
javahome CIBMcommonpluginscomibmpvcwctruntim
esj2sewin32x86_150SR2-
20060511rcpeclipsepluginscomibmrcpj2sew
in32x86_150SR2-20060511jre
javavmspecificationversion 10
javavmversion 23
javavmvendor IBM Corporation
javavmname IBM J9 VM
PowerTerm WebConnect 33 Getting Started Guide
javaiotmpdir CDOCUME~1dianaLOCALS~1Temp
javacompiler j9jit23
javaextdirs CIBMcommonpluginscomibmpvcwctruntim
esj2sewin32x86_150SR2-
20060511rcpeclipsepluginscomibmrcpj2sew
in32x86_150SR2-20060511jrelibext
osname Windows XP
osarch x86
osversion 51 build 2600 Service Pack 2
pathseparator
username Jone
userhome CDocuments and SettingsJone
userdir CIBMRSA
usertimezone GMT+0200
System properties available for users on Linux RedHat 9
Java System Property Name Value Example
javaversion 150
javavendorurl httpwwwibmcom
javahome usrjavajre150_07
javavmversion 150
javavmvendor IBM Corporation
javavmname IBM J9 VM
javaclasspath
javalibrarypath
javaiotmpdir tmp
javacompiler
javaextdirs
osname Linux
osarch i386
osversion 2420-8
pathseparator
PowerTerm WebConnect 34 Getting Started Guide
username root
userhome root
userdir root
System properties names are placed in the configuration file within percent symbols ()
(like macros)
671 Configure the PowerTerm WebConnect Client
1 Open the Config Folder and edit the webconnectxml file Example
ltxml version =rdquo10rdquo encoding=rdquoUTF-8rdquogt
ltsection name=rdquoparametersrdquogt
ltitem key=rdquourlrdquo value=httpadminserverWebConnect56gt
ltitem key=rdquoserverrdquo value=rdquoadmin24000rdquogt
ltitem key=rdquossordquo value=rdquotruerdquogt
ltitem key=rdquodestrdquo value=rdquoCProgram FilesEricomrdquogt
ltsectiongt
2 Save the customized webconnectxml to a Web server folder available to all users It is
recommended to use the same Web server as the PowerTerm WebConnect Agent
Example
ltWebConnect installation foldergtwebwebconnectxml
3 Test the accessibility to this file - Type the URL of webconnectxml in the browser
Example
httpltWebServer IPgtWebConnectwebconnectxml
The contents of the file should be displayed
672 Configure the Preferences File
1 Open the plugins folder and open the PowerTermWebConnectClient_560365jar file
You can use Winzip version 70 and up or in Windows XP ndash Create a new file type for the
jar extension click advanced and select compressed (zipped) folder in the drop down list
Now you can open the JAR files in the Windows Explorer
The default contents of the file
configURL=httpleericomcomWebConnectwebconnectxml
2 Specify the accurate URL of the webconnectxml file Example
httpltWebServer IPgtWebConnectwebconnectxml
3 Save the file and close it The WinZip will display the following dialog
ldquoFile preferencesini has been changed since it was extracted Update archive
with this filerdquo
PowerTerm WebConnect 35 Getting Started Guide
4 Click Yes and close the archive
If you are editing the file from within the explorer you will have to save the file elsewhere
and then drag it to the explorer window where the JAR file is open
68 Installing PowerTerm WebConnect Client on Lotus Expeditor
1 Start the Lotus Expeditor client
2 Select File | Application | Install
3 Select Search for new features to install and click Next
4 Select Add Folder Location and type or select the location of the update site folder from
the provided package Click OK
5 Select the location you have just created and click Finish
6 In the Select the feature to install tree select Powerterm WebConnectUpdate Site Click
Next
7 Select I accept the terms in the license agreements and click Next
8 Click Finish
9 When prompted restart the platform
69 Running PowerTerm WebConnect Client for Lotus Expeditor
1 Click Open The PowerTerm WebConnect option is displayed
2 Select PowerTerm WebConnect The application will automatically connect and start
downloading the components from PowerTerm WebConnect Server
IMPORTANT
If you did not install PowerTerm WebConnect Server and are instead connecting to Ericom
Softwarersquos Demo WebConnect Server then you need to open port 443 in the firewall
691 PowerTerm WebConnect Client Workflow
1 PowerTerm WebConnect client reads the URL of webconnectxml from the preferencesini
file and requests it
2 When the webconnectxml is successfully downloaded the application reads the
configuration connects to the specified Web server downloads the PowerTerm
WebConnect components and connects to the PowerTerm WebConnect Server
3 The user is requested to login to the PowerTerm WebConnect Server For testing you
can use the username Example and password example
This step will be skipped if Single Sign-on is set to ldquotruerdquo
PowerTerm WebConnect 36 Getting Started Guide
4 After logging in to PowerTerm WebConnect Server the userrsquos applications are displayed
as defined by the administrator
5 To run an application select the desired application from the list and click Launch or
double-click the application The application will be launched in a separate window
610 Troubleshooting
When you encounter a problem the first step is to open the log file This file is located on
the client machine in the Ericom folder
Windows
CDocuments and SettingsltusernamegtEricomleclientEricomPluginlog
Linux
ltuser-home-directorygtEricomleclientEricomPluginlog
Following is a guide for diagnosing and fixing the problems in cases of error messages and
additional information
Error
Message
Solution
Version File
reading error
1 Check the lsquourlrsquo parameter in the webconnectxml file on the Web
server The value should be
httpltWebServerIPgtWebConnect
2 Try to run the following URL on the browser
Windows
httpltWebServerIPgtWebConnectwindowsptagentvertxt
Linux
httpltWebServerIPgtWebConnectlinuxix86qterm-
wcvertxt
The file contents displayed in the browser window should be in
the following form
560-rel14546
PowerTerm WebConnect Application Zone
560 - Main Release
ltrootgtPowerTerm WebConnect 56ltWebServergt
If the version file contents are not as shown check
- Is the Web Server running
- Are PowerTerm WebConnect Web Components and version files
PowerTerm WebConnect 37 Getting Started Guide
in place
3 On the Web server check ltPowerTerm WebConnect
rootgtwebwindowsptagentvertxt If the contents ldquolook wrongrdquo or
not in the proper form reinstall the PowerTerm WebConnect Web
components
4 On the client machine open the aforementioned URL in the
browser The file content should appear in the browser If it does
not it could be that the Web server is down
Web Server is
shut down
The webconnectxml configuration file must be located on the Web
server The explicit URL to this file is defined in the preferencesini
file (see Configure the Preferences File)
The error message contains the IP address of the Web server
Verify that the Web server on this machine is running
Version file
does not exist
on ltURLgt
See Version File reading error
The
configuration
file is not
accessible or
has a wrong
format
The webconnectxml configuration file must be located on the Web
server and the explicit URL to the configuration must be defined in
the preferencesini file (see Configure the Preferences File)
Try to open the URL specified in the error message in the
browser If it does not open then it either does not exist or it has
a wrong format
Preferences
file does not
exist in the
application
bundle
The preferencesini file containing the URL to the configuration
file was removed from the update site folder
Uninstall the current PowerTerm WebConnect client from the
client machine Create a new customized package (see
PowerTerm WebConnect Client Configuration) and reinstall it
Configuration
file URL is not
defined in
preference
file
The URL to the configuration file does not appear in the
preferencesini file (see Configure the Preferences File)
Uninstall the current PowerTerm WebConnect client from the
client machine Create a new customized package (see
PowerTerm WebConnect Client Configuration) and reinstall it
No IP address
could be
found for the
host
The Web server URL specified in the preferencesini file (see
Configure the Preferences File) or in the webconnectxml file (see
Configure the PowerTerm WebConnect Client) is an unknown
host
If the mistake is in the preferencesini file uninstall the current
PowerTerm WebConnect client from the client machine Create a
new customized package (see PowerTerm WebConnect Client
Configuration) and reinstall it
PowerTerm WebConnect 38 Getting Started Guide
If the mistake is in the webconnectxml file correct the file reopen
the Lotus Expeditor client
Cannot write
to destination
The temporary file cannot be written to the defined destination
Check the write permissions
Copied
configuration
file has wrong
format
The webconnectxml file as received from the specified URL has a
wrong format Correct the file and try again
PowerTerm
WebConnect
Agent URL is
malformed
The PowerTerm WebConnect Agent URL specified in the
webconnectxml file (see Configure the PowerTerm WebConnect
Client) does not have a proper HTTP format Correct the file and
try again
PowerTerm
WebConnect
Agent URL is
not defined
The PowerTerm WebConnect Agent URL parameter is not specified
in the webconnectxml file (see Configure the PowerTerm
WebConnect Client)
Correct the file and try again
The specified
destination
folder name
is wrong
The destination folder name contains illegal characters
ltgt|
Check the dst parameter in the webconnectxml file Correct the
file and try again
You do not
have
permissions
to write to
ltpathgt
The PowerTerm WebConnect Agent cannot be written to the
destination as defined Check the write permissions
The default destination defined in the version file should not to
be changed
A customized destination for PowerTerm WebConnect Agent
downloading can be defined in the webconnectxml file (See
Configure the PowerTerm WebConnect Client)
Check the destination value correct and try again
PowerTerm WebConnect 39 Getting Started Guide
About Ericom
Ericomreg Software is a leading provider of Application Access and Virtualization Solutions
Since 1993 Ericom has been helping users access enterprise mission-critical applications
running on a broad range of Microsoftreg Windowsreg Terminal Servers virtual Desktops
Blade PCs legacy hosts and other systems Ericom provides concrete business value by
helping organizations realize the benefits of their IT investments With offices in the United
States United Kingdom EMEA India and China Ericom also has an extensive network of
distributors and partners throughout North America Europe Asia and the Far East Our
expanding customer base is more than 30 thousand strong with over 7 million
installations
For more information on our products and services contact us at the location nearest to you
And visit our web site httpwwwericomcom
North America Western Europe International
Ericom Software Inc Ericom Software (UK) Ltd Ericom Software Ltd
231 Herbert Avenue Bldg 4 11a Victoria Square 8 Hamarpeh Street
Closter NJ 07624 USA Droitwich Worcestershire Har Hotzvim Technology Park
Tel +1 (201) 767 2210 WR9 8DE United Kingdom Jerusalem 91450 Israel
Fax +1 (201) 767 2205 Tel +44 (0) 845 644 3597 Tel +972 (2) 591 1700
Toll-free 1 (888) 769 7876 Fax +44 (0) 845 644 3598 Fax +972 (2) 571 4737
Email infoericomcom Email infoericomcouk Email infoericomcom
PowerTerm WebConnect 5 Getting Started Guide
About this Document
This guide explains how to install and get started with PowerTerm WebConnect (PowerTerm
WebConnect Enterprise PowerTerm WebConnect RemoteView PowerTerm WebConnect
DeskView PowerTerm WebConnect HostView and PowerTerm WebConnect for Oracle) It
is intended for Administrators of PowerTerm WebConnect If you need more detailed
explanations on the different options in the administration tools or more information about
how to work with PowerTerm WebConnect please refer to the PowerTerm WebConnect
Administrators Manual
This document contains the following chapters
Chap 1 Product Overview Important information for
easy installation
Pg 6
Chap 2 Installing and Starting
PowerTerm WebConnect
Describes how to install and
start PowerTerm
WebConnect (Windows and
Linux editions) and its
different components as well
on how to launch the
PowerTerm WebConnect
Administration Tool
Pg 8
Chap 3 PowerTerm WebConnect
Administration Tool at a
Glance
Describes some main
features of the PowerTerm
WebConnect Administration
Tool and how to create
Connections and Publish
Applications
Pg 12
Chap 4 Accessing Virtual Desktops
and Blade PCs with
PowerTerm WebConnect
Describes how to configure
hosts and create pools with
PowerTerm WebConnect
DeskView and PowerTerm
WebConnect for Oracle VM
Pg 18
Chap 5 Download and Run
PowerTerm WebConnect
Clients
Describes where you can
download and run the
various PowerTerm
WebConnect clients
Pg 22
Chap 6 PowerTerm WebConnect
Client for Lotus Expeditor
Describes how to install
configure and run
PowerTerm WebConnect
Client for Lotus Expeditor
Pg 23
PowerTerm WebConnect 6 Getting Started Guide
1 Product Overview
PowerTerm WebConnect is an Enterprise-Wide Application Access solution that enables you
to publish and provide secure remote access to applications running on Windows Terminal
Servers Virtual Desktops (on top of hypervisors such as VMWare Microsoft Xen and
Virtual Iron) Blade PCs and legacy hosts Once published applications can be accessed
and used by end-users in a secure and managed fashion
Major components of the PowerTerm WebConnect product include
bull PowerTerm WebConnect Server
Choose between either Windows or Linux editions of the server
bull PowerTerm WebConnect DeskView Server
This component makes it possible to publish Desktops and applications that run on
Virtual Machines and physical machines
bull PowerTerm Load Balancer
Install the PowerTerm Load Balancer as a part of PowerTerm WebConnect Server
installation on the same computer or independently on a separate computer
Once installed it provides System and Application Load Balancing
bull PowerTerm WebConnect Web Components
Install these components on a compatible Web server in order to provide end-
users with a Web interface to published applications
bull PowerTerm WebConnect Administration Tool
Install the PowerTerm WebConnect Administration Tool on the server or on an
administration workstation It can also be downloaded on-demand
bull Client-side components
These components are installed as a part of the ldquoWeb server componentsrdquo
installation option and are usually downloaded by users the first time they need
the corresponding functionality Some components can be pre-installed if needed
Client side components include
RemoteView for accessing Windows Terminal Server applications and Virtual
Desktops from Windows and Linux workstations as well as from Windows Based
Terminals and Windows XPe and Linux based thin clients
HostView for accessing character-based applications running on legacy hosts
including IBM Mainframe IBM AS400 OpenVMS Unix Linux Tandem from
Windows and Linux workstations as well as from Windows Based Terminals and
Windows XPe and Linux based thin clients
SupportView for remote desktop support
PrintView for managing print queues
QuickVNC for remote desktop connectivity
bull PowerTerm Terminal Server Agent
Install this component on Windows Terminal Servers This component enables
PowerTerm WebConnect 7 Getting Started Guide
True Seamless Windows for published applications remote application browsing
and publishing and Application Load Balancing
bull PowerTerm WebConnect Portlet for JSR 168 Portals
Install this component if you plan to access Windows published applications and
Legacy hosts from within JSR 168 compatible portal environments such as IBM
Workplace or WebSphere Oracle Portal Vignette Portal and the like
bull PowerTerm WebConnect Plugin for IBM Lotus Expeditor
Install this plugin if you plan to access Windows published applications and Legacy
Hosts from within the IBM Lotus Expeditor environment
bull PowerTerm WebConnect DeskView
This component makes it possible to publish Desktops and applications that run on
Virtual Machines and physical machines
The evaluation package of PowerTerm WebConnect that you can download and
install contains the PowerTerm WebConnect Enterprise product with all its
components Once activated the product will only include the components and
features of the specific PowerTerm WebConnect product you purchased
PowerTerm WebConnect 8 Getting Started Guide
2 Installing and Starting PowerTerm WebConnect
PowerTerm WebConnect includes both server-side and client-side components The server
side includes
bull PowerTerm WebConnect Server
bull PowerTerm WebConnect DeskView Server
bull PowerTerm WebConnect Load Balancer
bull PowerTerm WebConnect Administration tools (for WebConnect Server PowerTerm
Load Balancer and DeskView Server)
The client side has numerous clients such as
bull RemoteView
bull HostView (for both Windows and Linux)
bull QuickVNC etc
21 Install PowerTerm WebConnect (Windows edition)
1 Run the installation file typically named PowerTermWebConnect5xexe You will find
the file on the installation CD or you can download it from Ericoms website
2 Click Install and then enter your Serial Number or click Evaluate when prompted
3 Continue with installation and select Full Installation Server Administration Tool and
WebServer Components (default) in the Setup Type dialog
4 Complete the installation and click Exit and run PowerTerm WebConnect in the last
dialog of the installation Depending on your computer this may take a few minutes
The first time you launch the PowerTerm WebConnect server it will generate a
Diffie-Hellman key for SSL encryption This process may take several minutes
depending on the speed of your computer A visual progress indicator will show
you when this process is completed While this process is taking place PowerTerm
WebConnect clients will not be able to connect to the server
22 StartStopRestart PowerTerm WebConnect Server (Windows edition)
PowerTerm WebConnect server is installed as a Windows service
1 Launch the standard Services console from the Windows Control Panel On some
computers it may be located under the Administrative Tools group You can also run
the command SERVICESMSC The Services window is displayed
PowerTerm WebConnect 9 Getting Started Guide
2 Select PowerTerm WebConnect Server 5x service (the primary service of PowerTerm
WebConnect) where x is the version number and use standard StartStopRestart
options
The PowerTerm WebConnect Server Starter 5x service (the secondary service of
PowerTerm WebConnect) is designated for restarting the primary service in
cases of failure or any unexpected problems The secondary service is
controlled by internal logic of PowerTerm WebConnect and cannot be stopped
from the Services console
23 Install Run and Stop PowerTerm WebConnect Server (Linux edition)
Transfer the installation file to your Linux server and install the PowerTerm WebConnect
components in the RPM package using the following shell command
rpm ndashi WebConnecct-5x-0i586rpm
(lsquoxrsquo is the version number)
The PowerTerm WebConnect server will be installed to
optWebConnect5x
All PowerTerm WebConnect clients including PowerTerm WebConnect
Administration Tool are published via the Web server Therefore you need to
manually configure the Web server to publish the path optWebConnect56web
The name of the virtual directory has to be WebConnect5x
After configuring the virtual directory you can launch any client from httpltservernamegtWebConnect5xClientURLshtml
Users of Red Hat 72
If you installed the PowerTerm WebConnect server on Red Hat 72 you also have to install
the file libgcc-304-1i386rpm (44Kb) in order for PowerTerm WebConnect Server to run
This file can be downloaded from
ftprpmfindnetlinuxredhatupdates72enosi386libgcc-304-1i386rpm The file is
also available on the installation CD and can as well be downloaded from the ldquoEvaluate
PowerTerm WebConnect Linux x86 Editionrdquo web page
Use the following commands to run the PowerTerm WebConnect server
On RedHat
sbinservice webconnectd start
On Suse
etcrcdwebconnectd start
Use the following commands to stop the PowerTerm WebConnect server
On RedHat
sbinservice webconnectd stop
PowerTerm WebConnect 10 Getting Started Guide
On Suse
etcrcdwebconnectd stop
24 Install the Terminal Server Agent
PowerTerm WebConnect Terminal Server Agent must be installed on a Terminal Server
accessed using PowerTerm WebConnect It provides the True Seamless Windows
functionality for published applications remote browsing and publishing and Application
Load Balancing
The PowerTerm WebConnect Terminal Server Agent must be installed on every Terminal
Server in the cluster If you install the PowerTerm WebConnect server itself on a Terminal
Server you will be given the option to install the Terminal Server Agent as a part of the
server installation Alternatively use the PowerTermTerminalServerAgentexe file located in
the AddOnsTerminalServerAgent subdirectory under the PowerTerm WebConnect server
installation directory
To complete the installation you might need to restart the Terminal Server machine
25 Install PowerTerm WebConnect DeskView Server
PowerTerm WebConnect DeskView is automatically installed when you run PowerTerm
WebConnect Installation wizard ndash Full installation To run PowerTerm WebConnect
DeskView Server you also need Microsoft NET Framework v30 to be installed on your
computer If you do not have it installed then the installation wizard will place the
DeskViewServerSetupmsi and DeskViewAdminSetupmsi files in the AddOns folder
(ltPowerTerm WebConnect Installation FoldergtWebConnect 5xAddOnsDeskView
VDI) from where you can run the msi files at a later stage to install PowerTerm
WebConnect DeskView
26 Start the PowerTerm WebConnect Administration Tool
There are several ways to launch the PowerTerm WebConnect Administration Tool Select
the one most convenient for you
bull From Windows Start menu select Programs | Ericom Software | PowerTerm WebConnect
5x | PowerTerm WebConnect Administration Tool
If you changed the Program Folder during installation the Start menu path
may vary
bull Double-click PtAdminexe PtAdminexe is located in the bin directory of the
PowerTerm WebConnect installation folder
bull Rather than installing you can choose to download the Administration Tool to any
Windows computer Please refer to the PowerTerm WebConnect Sample URLs
page (httpltweb_servergtWebConnect5xClientURLshtml) for more details
A few things to remember
PowerTerm WebConnect 11 Getting Started Guide
When you launch the PowerTerm WebConnect Administration Tool for the first time the Connection dialog is displayed with the user Administrator No
password is required to enter just click Connect
In the Connection dialog (displayed when launching the Administration Tool) the
Host Name is localhost by default This is correct only if the Administration Tool
runs on the same machine as the server If the Administration Tool runs on a different machine you need to change the Host Name to the IP addressHostname
of the PowerTerm WebConnect server
When using the PowerTerm WebConnect Windows edition by default the
Administration Tool will deny any connection attempts from any computer other
than the local machine
PowerTerm WebConnect 12 Getting Started Guide
3 PowerTerm WebConnect Administration Tool at a Glance
PowerTerm WebConnect Administration Tool manages published applications user sessions
and server configuration The administrator can perform operations such as multiple
application publishing sending messages to logged-on users shutting down sessions and
monitor user activity
To perform the tasks described in this chapter you must launch the Administration Tool via one of the methods detailed in chapter Start the PowerTerm
WebConnect Administration Tool
Launching the Administration Tool from the system tray or using the
Administration Tool launched after completed installation will not allow you to
activate certain features
After you launched the Administration Tool and connected to the server you will receive a
Welcome screen where you select desired activity
bull Publish Multiple Applications opens the Publish Multiple Applications wizard
bull Configure Load Balancer opens PowerTerm Load Balancer Administration Tool
bull Create a Host Connection opens the Add Connection dialog
bull Configure Active Directory opens the Directory Services dialog
PowerTerm WebConnect 13 Getting Started Guide
Close the Welcome screen to enter the Administration Tool main
screen
The Administration Tool main screen has three sections
bull User section lists all users defined in the server
bull Group section lists all groups defined in the server
bull Connection section lists all connections and published applications defined in the
server
By default only the Connection section is displayed when you first open Administration Tool
There are three predefined example-connections ldquoExample_As400rdquo ldquoExample_VTrdquo and
ldquolocalhostrdquo You can test them prior to defining your own
1 Right click the connection you want to test and select Test The PowerTerm
WebConnect HostView Login dialog appears
2 Type example for User Name and example for Password
Credential fields are case sensitive
3 Click Login The desired connection with its pre-programmed demo application is
launched
PowerTerm WebConnect 14 Getting Started Guide
31 Publishing Applications and Documents
In order to enable access to applications and documents on Windows Terminal Servers
publish these applications and documents from the Administration Tool When publishing
applications and content you can specify which servers will be used in a Terminal Server
cluster and which users and groups will have access to these services Once you have
published such applications and documents the RemoteView client can be used to access
them
If you need to provide access to multiple applications on a Terminal Server use the Multiple Application Publishing wizard to significantly reduce the time and
effort required to publish these applications
To publish multiple Windows applications
1 Click Publish Multiple Applications in the Welcome screen The Choose Terminal Server
for Browsing dialog appears
2 Provide the address of the Terminal Server which will be used for browsing and click OK The Application Publisher Step 1 dialog appears This dialog lists all the
applications available in the specified serverrsquos Start menu
3 Select those applications found in the Programs folder of the designated server that you want to publish and click Next The Application Publisher Step 2 dialog appears
4 Determine the destination of your publishing and click Next The Application Publisher
Step 3 dialog appears
5 Determine the Color Quality of your published application
6 Determine the start mode in which you want to run the published application - normal maximized or minimized - and click Next The Application Publisher Step 4
dialog appears
7 Choose the connection speed that matches your infrastructure The connection speed
setting determines the value of three visual effects settings You can also override
these settings specifically
8 Determine whether you prefer the window to display their content while being
dragged or just the outline By default the same setting is used as the client desktop
9 Click Next The Application Publisher Step 5 dialog appears
10 Specify where sounds are to be played ndash locally or remotely
11 Determine which local devices the remote session will have access to (local drivers printer etc) and click Next The Application Publisher Step 6 dialog appears
12 If you have the PowerTerm Load Balancer installed Use all Servers (default) allows the application to run on any Terminal Server in the
cluster This setting is appropriate when the application is installed on all the Terminal
Servers Alternatively you select specific Terminal Servers on which to run this
application
If you have not installed the PowerTerm Load Balancer you will need to explicitly
specify the address of the Terminal Server on which the application will be run
PowerTerm WebConnect 15 Getting Started Guide
13 Click Next The Application Publisher Step 7 dialog appears
14 Select the users groups or OUs to which you wish to publish the applications and click Next The Application Publisher Step 8 dialog appears By default applications will
be published to everybody
15 Click Advanced Settings to modify settings such as the login credentials to the
Terminal Servers By default PowerTerm WebConnect credentials will be passed
through to the Terminal Server
16 Click Finish The published applications appears in the Connection List
Right-click and select Properties or double click on the published application in the
Connections list to view and modify any of the settings which you previously
defined
To publish a remote Desktop
1 Select Action | New | Remote Desktop The Application Publisher Step 1 dialog appears
2 Type the Display Name which will be the name presented to the end-users and click
Next The Application Publisher Step 2 dialog appears
3 Specify where icons for the published desktop will be displayed to the end-user in Publish to
4 Click Choose Icon to replace the desktoprsquos default icon Select the desired icon from
the list that appears
5 Click Next The Application Publisher Step 3 dialog appears
6 Determine Screen Size and the Color Quality of the published desktop
7 If desirable select Show Connection Bar in Full Screen Mode
8 Click Next The Application Publisher Step 4 dialog appears
9 Choose the connection speed that matches your infrastructure The connection speed
setting determines the value of three visual effects settings You can also override
these settings specifically
10 Click Next The Application Publisher Step 5 dialog appears
11 Specify where sounds are to be played ndash locally or remotely Where to Apply Window
Key Combinations and which local devices you want to automatically connect to when
logged on to the remote computer
12 Click Next The Application Publisher Step 6 dialog appears
13 Specify the Server Address and Port Number of the Terminal Server that weill provide
the desktop and click Next The Application Publisher Step 7 dialog appears
14 Select the users groups or OUs to which you wish to publish the desktop and click Next The Application Publisher Step 8 dialog appears
Select the Server group to allow all users to access the published application
15 Click Advanced Settings to modify settings such as the login credentials to the
Terminal Servers By default PowerTerm WebConnect credentials will be used
PowerTerm WebConnect 16 Getting Started Guide
16 Click Finish The published application appears in the Connection List
Right-click Properties or double click on the published application in the
Connections list to modify any of the settings which you previously defined
32 Create Terminal Emulation Connections
To provide access to legacy host systems you will need to create Terminal Emulation
connections For each such connection you can specify the host address emulation type
login script and more Once you have created these connections users will be able to
launch them using HostView (Windows or Linux) WebView or the Java client as
appropriate
1 Click Create a Host Connection in the Welcome screen The Add Connection dialog
appears
2 Enter a Name for the new connection
3 Specify an Owner for the new connection The possibilities are
[None] the connection will not be allowed to run by anyone and it will not be
displayed in any Connection list Server the connection will be accessible for all users of this PowerTerm
WebConnect server A specific group the connection will be accessible for all users of the specified
group A specific user the connection will be accessible for a specified user only
4 Leave category Terminal Emulation selected
5 Select Terminal Type Terminal Model and Communication Type as needed
6 Specify the Host Name or IP address of your host
7 Specify other parameters as needed
8 Select the Security Type as needed if your host supports SSL or SSH and specify
the appropriate details in the Details dialog
9 Use the Settings Key Mapping and Power Pad options to further customize the
connection
10 Click OK and the connection is created
33 Test Connections
It is recommended to test published applications or host connections before they are made
available to end-users
To test a connection
bull Right-click the target connection from the Connection section of the main screen and
select Test
Alternatively
PowerTerm WebConnect 17 Getting Started Guide
1 Select Tools | Run ltdesired clientgt The Login to WebConnect dialog appears
2 Enter the User Name and Password for the individual who owns the connection that
you want to test and click Login The desired PowerTerm WebConnect client is started
and the Connect dialog appears
3 Select the desired connection and click Connect The test is executed
34 Launch the Application Zone or the Application Portal
Users can access the published applications from the Application Zone application launcher
or from the Application Portal web interface
To use the Application Zone go to Start menuProgramsEricom SoftwarePowerTerm
WebConnect 5x and select Client URLs Alternatively type the following URL into your Web
browserrsquos address bar httpltserver addressgtWebConnect5xClientURLshtml In the
page that opens click on the Run button next to the Application Zone to launch it
To use the Application Portal go to Start menuProgramsEricom SoftwarePowerTerm
WebConnect 5x and select it Alternatively type the following URL into the Web browserrsquos
address bar httpltserver addressgtWebConenct5xportalwindowsindexasp
35 Monitor a Users Sessions
From the Administration Tool you can monitor the users sessions and may intervene if
necessary This intervention may result in your input appearing on the users screen The
user receives a notification when an administrator begins and ends monitoring the session
1 Select View | Client Sessions or click to see all the active client sessions
2 Select the desired active session and right-click Attach The Password Verify dialog
appears
3 Enter your password and click OK Some notification dialogs appears and the selected
PowerTerm WebConnect session is viewed
36 View Intruders
bull The Intruders window shows suspected attempts at breaching security After several
suspected intrusion attempts users are blocked temporarily
bull In addition to showing suspected intrusion attempts the Intruders window allows
you to remove restrictions on users
bull Select View | All Intruders or click
PowerTerm WebConnect 18 Getting Started Guide
4 Accessing Virtual Desktops and Blade PCs with PowerTerm WebConnect
This chapter provides instructions on configuring PowerTerm WebConnect for Virtual
Desktop Infrastructure (VDI)
41 Step 1 Launch DeskView Administration Tool
Verify that PowerTerm WebConnect is installed on your server and launch PowerTerm
WebConnect Admin Tool
bull Select Tools | Open VDI Manager The PowerTerm WebConnect DeskView Administration
Tool opens
The first time you launch the DeskView Administration Tool you will be prompted to install
the tool
PowerTerm WebConnect 19 Getting Started Guide
Microsoft Management Console 30 is required for PowerTerm WebConnect DeskView
Administration Tool If you do not have this installed you will also automatically be
prompted to install this update
Follow the installation processes when you are prompted for either install PowerTerm
WebConnect DeskView Administration Tool will automatically launch when these
installations are completed
42 Step 2 Add a Host
1 Right-click Virtualization Hosts and select Add Host The Add a New Host wizard
opens Click Next
2 Enter a Host Name as you would like it to appear in PowerTerm WebConnect
DeskView Administration Tool and a description (optional) Click Next
3 Specify the Virtualization Server type and click Next
4 Specify the connection information and click Next
VMWare Virtual Center v1x and 2x
Specify the HTTPS Web Service address and a UsernamePassword that can access
the host
VMWare Virtual Server 2005
Click Start and then Run
Type ldquoservicesmscrdquo and click OK
Scroll down to PowerTerm WebConnect DeskView Server service and open
Properties
Change the Login Account for the service to match the Domain Administrator
account and password used when setting up Microsoft Virtual Server 2005 and
restart the service Enter the IP or NETBIOS name of the Microsoft Virtual Server 2005 server as the
Server Address in the Connection Broker Wizard
Xen Server
Specify the hypervisor IP address or NETBIOS name the Root UsernamePassword
to the hypervisor and the Service port (default 80)
Oracle VM
Specify the Serverrsquos agent URL and Port (default 8899) for example
httpsltservernamegt8899
Specify the Oracle VM hypervisorrsquos Oracle Agent UsernamePassword (default
username oracle)
5 Click Finish to add the new Host
To configure Virtual Machines for use install the Ericom Tools (vmagentmsi) on each of the
virtual machines on the new host for PowerTerm WebConnect DeskView to recognize them
The vmagentmsi installer is located on the PowerTerm WebConnect server in ltPowerTerm
WebConnect installation foldergtAddOnsDeskView VDI folder (default installation
PowerTerm WebConnect 20 Getting Started Guide
folder is xProgram FilesEricom SoftwareWebConnect 56) During installation you
will need to enter the DeskView IP address or NETBIOS name
If you are using Microsoft Virtual Server 2005 as your Virtualization Host use the
IP address of the DeskView server only when installing the Ericom Tool package
43 Step 3 Create a Pool
Pools are used to organize Virtual Machines (VM) into logical groups This enables
organizations to combine and order resources from multiple systems into one entity To
access available resources end-users simply connect to PowerTerm WebConnect to access
any configured resource
1 Right-click Pools and select Create Pool The Create a Pool wizard opens Click
Next
2 Enter a Pool name as you wish it to appear and a description (optional) and click
Next
3 Specify the Pool type and click Next
4 Specify the Assignment type and click Next
Permanently will cause a virtual machine to affix to the user who has launched
that virtual machine For the duration of the session will cause any virtual machine that is not in use to
be returned to the pool for any user to launch
5 Specify the LogoffDisconnect event and click Next
Select what you would like to happen after a user logs off from a virtual machine
in this pool
Select what you would like to happen when a user is disconnected from a virtual
machine in this pool
6 Click Finish to add the new Pool
You will need to assign virtual machines from your virtualization hosts to your created pool
1 Right-click the pool and select Assign Machines The Assign Machines to ltyour
pool namegt dialog opens
2 Highlight the desired virtual machine(s) and click Select Click OK
44 Step 4 Publish an ApplicationDesktop
1 Return to PowerTerm WebConnect Admin Tool to publish DeskView pools
2 Determine whether to publish a full desktop or a seamless application running
from a virtual desktop
For a full desktop
Select Action | New | Remote Windows Desktop
For a seamless application
Select Action | New | Windows Application
PowerTerm WebConnect 21 Getting Started Guide
3 Select Virtual Desktop in the first step of the wizard and click Next
4 Follow the wizardrsquos instructions until you reach the Virtual Desktops step
5 Select a pool that you previously created and that you would like this connection to choose virtual machines from Click Next
6 Continue and complete the reminder of the wizardrsquos steps
Once the resource is published users who have been assigned access will be able to use it
immediately
PowerTerm WebConnect 22 Getting Started Guide
5 Download and Run PowerTerm WebConnect Clients
PowerTerm WebConnect clients are automatically downloaded and installed onto the client
devices For detailed information and samples please refer to the PowerTerm WebConnect
Sample URLs page To see this page navigate your browser to
httpltweb_servergtWebConnect5xClientURLshtml
PowerTerm WebConnect 23 Getting Started Guide
6 PowerTerm WebConnect Client for Lotus Expeditor
61 Installation Package
PowerTerm WebConnect client for Lotus Expeditor is provided to IBM in an Update Site
package This is a ZIP archive containing the Update Site with the Eclipse feature and plug-
in that comprises the PowerTerm WebConnect client
Extract the ZIP file keeping the foldersrsquo structure intact
NOTE In Winzip verify that the ldquoUse folder namesrdquo option is set to TRUE
Package structure
Update Site
- plugins
- PowerTermWebConnectClient_560365jar
- features
- comericomWebConnect_560365jar
- sitexml
config
- webconnectxml
Definitions
bull webconnectxml PowerTerm WebConnect client configuration file
bull comericomWebConnect_560365jar PowerTerm WebConnect client feature file
bull PowerTermWebConnectClient_560365jar PowerTerm WebConnect client plugin file
62 Pre-installation steps
PowerTerm WebConnect client for Lotus Expeditor does not run independently but in
conjunction with PowerTerm WebConnect Server You can either install it and define your
users groups and applications or use Ericom Softwarersquos Demo PowerTerm WebConnect
Server
bull If you decide to install PowerTerm WebConnect Server you will need the full
installation ie the PowerTerm WebConnect Server and the Web components If you
do not have the installation CD you can download and install a trial version from
wwwericomcom
PowerTerm WebConnect 24 Getting Started Guide
bull If you decide to use Ericom Softwarersquos Demo PowerTerm WebConnect Server then
skip to the chapter Installing PowerTerm WebConnect Client on Lotus Expeditor
63 Install PowerTerm WebConnect Portlet on IBM Workplace server (for Windows OS)
Step 1 Install PowerTerm WebConnect Server
If PowerTerm WebConnect Server and IBM Workplace Server are on separate machines
bull Configure PowerTerm WebConnect Server
Launch PowerTerm WebConnect Administration Tool
Open Files | Configuration | Main
In the [Portal] section edit
Machines=localhostltIBM sever machinegt
bull Configure PowerTerm WebConnect Web components
Copy the ldquowebrdquo folder from the PowerTerm WebConnect server installation to the
IBM Workplace server machine
Create an Alias or a Virtual directory to it named WebConnect on the Web
server providing access to it for the users This is in order to enable the users to
download the necessary files to run their applications
Step 2 Enable JSR portlets
1 On IBM Workplace Server go to ltPortalServergtsharedappconfigservicesConfigServiceproperties
2 Edit portalenablejsr168=true
3 Save and close the file
Step 3 Enable SSO
1 On IBM Workplace Server go to ltPortalServergtsharedappconfigservicesLoaderServiceproperties
2 Edit commandpath=comericomportalcommandscomibmwpsenginecommands
3 Save and close the file
Step 4 Copy Files
The following files need to be copied from WebConnect ServerAddOnsIBM
WorkplacePortlet folder to IBM Workplace Server
File name to copy Destination folder
OpenSSLdll ltAppServergtjavajrebin
IbmPortaldll ltAppServergtjavajrebin
IbmPortalini ltAppServergtjavajrebin
PowerTerm WebConnect 25 Getting Started Guide
WebConnectPortaljar ltAppServergtlib
EricomLoginjar ltPortalServergtsharedapp
Step 5 Portlet Configuration
1 On IBM Workplace Server go to ltAppServergtjavajrebinIbmPortalini
2 You can modify the following parameters in the [Server=WebConnect] section webserverport=ltIBM web server portgt
Specifies the Web server port for accessing the PowerTerm WebConnect clients folder
Default 80 Address
Specifies the address of the PowerTerm WebConnect Server machine for Portlet to
connect to when PowerTerm WebConnect Server is located on a different machine
than the IBM Workplace Server CustomAddress
Specifies the addresss of the PowerTerm WebConnect Server machine for Clients to connect to If CustomAddress is the same as Address then this may be omitted webserveraddr
Specifies the address of the Web Server machine when it is located on a different
machine than the IBM Workplace Server
3 Restart the IBM server ltPortalServergtrootscriptsstopWorkplaceServicesbat ltPortalServergtrootscriptsstartWorkplaceServicesbat
This procedure may take about 20 minutes
Step 6 Install the Portlet
1 In a Web browser open the URL httpltIBM Workplace
Servergt9081lwpmyworkplace to open the IBM Workplace Portal
2 Login as administrator
3 Go to Administration | Portlets | Install
4 Browse to the PowerTerm WebConnectwar file located on PowerTerm WebConnect
Server and click Next
5 Click Install
Step 7 Create an Application page
1 Login to the Workplace
2 Go to Portal User Interface | Manage Pages
3 Search for My Work
4 Click the My Work link and select New Page
5 Name the page PowerTerm WebConnect and click OK
6 Click OK again You will see the created page on the list
7 Click the pencil icon on the new page and select the 1 square layout
PowerTerm WebConnect 26 Getting Started Guide
8 Click Add Portlet and search for PowerTerm WebConnect
9 Select it and click OK
10 Click Done
11 Click My work at the top of the page PowerTerm WebConnect is displayed on the list
Step 8 Run the Portlet
1 Restart IBM Workplace Server
2 Open IBM Workplace Portal in a browser httpltportal servergtlwpmyworkplace
3 Login to IBM Workplace Server
4 Click My work PowerTerm WebConnect portlet is displayed
5 Launch it The Userrsquos applications as defined on PowerTerm WebConnect Server
appear
6 Click an application to launch it
64 Install PowerTerm WebConnect Portlet on IBM Workplace server (for Linux OS)
Step 1 Enable JSR 168 portlets
1 Go to optIBMWorkplacePortalServersharedappconfigservicesConfigServiceproperties
2 Modify the portalenablejsr168 property to ldquotruerdquo
3 Restart the server cd optIBMWorkplacePortalServerrootscripts
Run stopWorkplaceServicessh
Run startWorkplaceServicessh
This procedure can take up to 20 minutes
4 Log on to the workplace server at httpltworkplace servergt9081lwpmyworkplace using
the administrators username and password
Step 2 Install the portlet
1 Restart IBM Workplace Server
2 In a Web browser open the URL httpltworkplace server IPgtlwpmyworkplace
3 Login to IBM Workplace Server as an administrator
4 Go to Administration | Portlets | Install
5 Browse to the PowerTerm WebConnectwar file located on PowerTerm WebConnect
Server and click Next
6 Click Install
PowerTerm WebConnect 27 Getting Started Guide
Step 3 Install the Application page
1 Login to the workplace as administrator
2 Go to Administration | Portal User Interface | Manage Pages
3 Search for My Work
4 Click the My Work link and select New Page
5 Name the page PowerTerm WebConnect and click OK
6 Click OK again You will see the created page on the list
7 Click the pencil icon and select the 1-square layout
8 Click Add Portlet and search for PowerTerm WebConnect
9 Select it and click OK
10 Click Done
11 Click My work on top and PowerTerm WebConnect is displayed on the left bar
Step 4 Run the portlet
1 Restart IBM Workplace Server
2 Open IBM Workplace Portal in a browser httpltportal servergtlwpmyworkplace
3 Login to IBM Workplace Server
4 Click My work PowerTerm WebConnect portlet is displayed
5 Launch it The Userrsquos applications as defined on PowerTerm WebConnect Server
appear
6 Click an application to launch it
65 Install PowerTerm WebConnect Portlet on IBM WebSphere 61 server (for Windows OS)
Step 1 Install PowerTerm WebConnect Server
You have to configure PowerTerm WebConnect Server if it and the IBM WebSphere Server
are on separate machines
1 Launch PowerTerm WebConnect Administration Tool
2 Open Files | Configuration | Main
3 In the [Portal] section edit Machines=localhostltIBM sever machinegt
Step 2 Copy Files
The following files need to be copied from WebConnect ServerAddOnsIBM
WebSpherePortlet folder to IBM WebSphere Server
PowerTerm WebConnect 28 Getting Started Guide
File name to copy Destination folder
OpenSSLdll ltAppServergtjavajrebin
IbmPortaldll ltAppServergtjavajrebin
IbmPortalini ltAppServergtjavajrebin
WebConnectPortaljar ltAppServergtlib
Step 3 Portlet Configuration
1 On IBM Workplace Server go to ltAppServergtjavajrebinIbmPortalini
2 You can modify the following parameters in the [Server=WebConnect] section webserverport=ltIBM web server portgt
Specifies the Web server port for accessing the PowerTerm WebConnect clients folder
Default 80 Address
Specifies the address of the PowerTerm WebConnect Server machine for Portlet to
connect to when PowerTerm WebConnect Server is located on a different machine
than the IBM Workplace Server CustomAddress
Specifies the addresss of the PowerTerm WebConnect Server machine for Clients to connect to If CustomAddress is the same as Address then this may be omitted webserveraddr
Specifies the address of the Web Server machine when it is located on a different
machine than the IBM Workplace Server
3 Restart the IBM server ltAppServergtProfilesAppServer01binstopServerbat ltAppServergtProfilesAppServer01binstartServerbat
This procedure may take about 20 minutes
Step 4 Install the Portlet and create an Application page
1 In a Web browser open the URL httpltIBM WebSphere Servergt9060ibmconsole
to open the IBM WebSphere Portal
2 Login and go to Applications | Install New Application
3 Browse to the PowerTerm WebConnectwar file located on PowerTerm WebConnect
Server
4 Enter Context root and click Next The Select installation options dialog appears
5 Optional change options to your preference or keep the default
6 Click Next
7 Select Ericom in the Module column click Apply and then Next
8 Click Finish and then Save
9 Select Applications | Enterprise Applications
10 Select PowerTerm WebConnectwar checkbox and click Start
PowerTerm WebConnect 29 Getting Started Guide
11 Enter in the Web browser the URL httpltIBM WebSphere
Servergt9080ltContext rootgtEricom portlet The Login dialog appears
12 Login and you will see PowerTerm WebConnect displayed on the list
Step 5 Run the Portlet
1 Restart IBM WebSphere Server
2 Open IBM WebSphere Portal in a browser httpltportal servergt9080ltContext
rootgtEricom portlet
3 Login to IBM WebSphere Server
4 Launch it The Userrsquos applications as defined on PowerTerm WebConnect Server
appear
5 Click an application to launch it
66 PowerTerm WebConnect Server Configuration
bull To enable the Lotus Expeditor to run the PowerTerm WebConnect client the
System Administrator must provide the users with accounts on PowerTerm
WebConnect Server (see the PowerTerm WebConnect Administratorrsquos Manual for
instructions on how to create users groups and connections on the PowerTerm
WebConnect Server)
bull To enable PowerTerm WebConnectrsquos Single Sign-On feature the System
Administrator must create a PowerTerm WebConnect user with the same
username and password as used for the Lotus Expeditor For a managed Lotus
Expeditor the credentials used are the username and password sent to the
managing server For an unmanaged Lotus Expeditor the operation system
username and the Lotus Expeditor password are used as credentials
NOTE If a password is not defined then the Single Sign-On will fail and the user will be
prompted with a login dialog
67 PowerTerm WebConnect Client Configuration
The PowerTerm WebConnect client is configured in webconnectxml located in the config
folder webconnectxml parameters are
url The PowerTerm WebConnect Agent url
server The PowerTerm WebConnect Server address
sso The Single Sign-On feature
dst The local destination for downloading PowerTerm WebConnect
components
PowerTerm WebConnect 30 Getting Started Guide
url
PowerTerm WebConnect components are installed on a Web server Their default url is
Windows Agent
httpltWebServer IPgtWebConnectwindowsptagentcab
Linux Agent
httpltWebServer IPgtWebConnectlinuxix86qterm-wczip
The url parameter must include the first part of the url (which is identical for both Windows
and Linux agents)
The PowerTerm WebConnect client will automatically append the appropriate suffix in
order to create a full accurate url
Example
ltitem key=rdquourlrdquo value=httpadminserverWebConnectgt
server
The computer name or IP address of the PowerTerm WebConnect Server machine
The PowerTerm WebConnect client will log in to this PowerTerm WebConnect Server
display the applications defined on it and run them according to this serverrsquos configuration
Format ltserver IPgt[ltportgt]
where default port is 4000 (can be edited)
Example
ltitem key=rdquoserverrdquo value=rdquoadmin24000rdquogt
sso
Determines whether Single Sign-on will be used to log in to PowerTerm WebConnect
Server Values
bull True (default) the client should automatically log in to the PowerTerm WebConnect
Server using the same credentials as the ones used to log in to the Lotus Expeditor
client
The System Administrator must verify that these credentials can log in to the
PowerTerm WebConnect Server
bull False the user will be prompted with a login dialog or will log in automatically using
previously saved credentials
Example
ltitem key=rdquossordquo value=rdquotruerdquogt
Autologin mode
PowerTerm WebConnect 31 Getting Started Guide
If sso is set to True the user is not prompted for credentials and the login process to
PowerTerm WebConnect Server is done automatically sending the credentials used for the
Lotus Expeditor unless the Lotus Expeditor does not have a password defined (In the
Lotus Expeditor preferences page | Password| Prompt me for a password at start up checkbox)
However if Single Sign-on is not used there are several options regarding Autologin that
can be defined in the PowerTerm WebConnect Preferences page Options
bull Yes
bull No
bull Interactive
bull First time interactive (default) ndash Simplifies the login process to PowerTerm
WebConnect Server In this mode the first time the user logs in to PowerTerm
WebConnect Server he will be prompted for his credentials with the Login dialog
These credentials will be stored in the machine and from then on the login process to
PowerTerm WebConnect Server will be done automatically
1 Open File | Preferences from the Lotus Expeditor and select PowerTerm WebConnect
2 In the Autologin to WebConnect Server section select First Interactive and click OK
3 Start PowerTerm WebConnect Client for Lotus Expeditor If credentials were entered
at least once then the next time the client will connect to PowerTerm WebConnect
Server without prompting for the user name and password
The Administrator must configure the Agent to do nothing when it exits for the
feature to work this way See PowerTerm WebConnect Administratorrsquos Manual for more information about defining Autologin
bull Allow multiple selection ndash Defines whether the user can launch more than one
application at a time (by using the ltCtrlgt or ltShiftgt button while selecting applications)
dst
Defines the path to download PowerTerm WebConnect components on the client machine
The dst parameter can contain macros which are translated by the PowerTerm WebConnect
Client for Lotus Expeditor during runtime The macros should be placed between percent
symbols () for example WebServer
When such a value is defined the PowerTerm WebConnect Client for Lotus Expeditor
substitutes the entire expression for the macrorsquos value
The PowerTerm WebConnect Client for Lotus Expeditor does not support the use
of environment variables as macros
Macros are not case sensitive
Macros supported by PowerTerm WebConnect Client for Lotus Expeditor
Macro name Description
WebServer The name of the Web server
It is obtained from the PowerTerm WebConnect Agent url
PowerTerm WebConnect 32 Getting Started Guide
parameter
Name The name of the clientrsquos CAB or ZIP file eg ldquoptagentrdquo
Display The clientrsquos display name from the version file
Version The clientrsquos version value It is obtained from the version
file
Root The default root location
Windows ldquoCrdquo
LinuxUnix an empty string
OSDir Windows Windowsrsquo installation directory for example
ldquoCWindowsrdquo
Linux an empty string
OSDrive Windows Windowsrsquo installation drive for example ldquoCrdquo
Linux an empty string
HomePath Windows The HOMEPATH environment variable
Linux The HOME environment variable
Home The Ericom folder in the userrsquos home directory
Windows CDocuments and SettingsltusergtApplication
DataEricom
Linux ltusergtEricom
In addition to the predefined macros listed above the PowerTerm WebConnect client
supports the usage of Java System Properties
Java System Properties available for users on Windows XP SP2
Java System Property Name Value Example
javaversion 150
javavendorurl httpwwwibmcom
javahome CIBMcommonpluginscomibmpvcwctruntim
esj2sewin32x86_150SR2-
20060511rcpeclipsepluginscomibmrcpj2sew
in32x86_150SR2-20060511jre
javavmspecificationversion 10
javavmversion 23
javavmvendor IBM Corporation
javavmname IBM J9 VM
PowerTerm WebConnect 33 Getting Started Guide
javaiotmpdir CDOCUME~1dianaLOCALS~1Temp
javacompiler j9jit23
javaextdirs CIBMcommonpluginscomibmpvcwctruntim
esj2sewin32x86_150SR2-
20060511rcpeclipsepluginscomibmrcpj2sew
in32x86_150SR2-20060511jrelibext
osname Windows XP
osarch x86
osversion 51 build 2600 Service Pack 2
pathseparator
username Jone
userhome CDocuments and SettingsJone
userdir CIBMRSA
usertimezone GMT+0200
System properties available for users on Linux RedHat 9
Java System Property Name Value Example
javaversion 150
javavendorurl httpwwwibmcom
javahome usrjavajre150_07
javavmversion 150
javavmvendor IBM Corporation
javavmname IBM J9 VM
javaclasspath
javalibrarypath
javaiotmpdir tmp
javacompiler
javaextdirs
osname Linux
osarch i386
osversion 2420-8
pathseparator
PowerTerm WebConnect 34 Getting Started Guide
username root
userhome root
userdir root
System properties names are placed in the configuration file within percent symbols ()
(like macros)
671 Configure the PowerTerm WebConnect Client
1 Open the Config Folder and edit the webconnectxml file Example
ltxml version =rdquo10rdquo encoding=rdquoUTF-8rdquogt
ltsection name=rdquoparametersrdquogt
ltitem key=rdquourlrdquo value=httpadminserverWebConnect56gt
ltitem key=rdquoserverrdquo value=rdquoadmin24000rdquogt
ltitem key=rdquossordquo value=rdquotruerdquogt
ltitem key=rdquodestrdquo value=rdquoCProgram FilesEricomrdquogt
ltsectiongt
2 Save the customized webconnectxml to a Web server folder available to all users It is
recommended to use the same Web server as the PowerTerm WebConnect Agent
Example
ltWebConnect installation foldergtwebwebconnectxml
3 Test the accessibility to this file - Type the URL of webconnectxml in the browser
Example
httpltWebServer IPgtWebConnectwebconnectxml
The contents of the file should be displayed
672 Configure the Preferences File
1 Open the plugins folder and open the PowerTermWebConnectClient_560365jar file
You can use Winzip version 70 and up or in Windows XP ndash Create a new file type for the
jar extension click advanced and select compressed (zipped) folder in the drop down list
Now you can open the JAR files in the Windows Explorer
The default contents of the file
configURL=httpleericomcomWebConnectwebconnectxml
2 Specify the accurate URL of the webconnectxml file Example
httpltWebServer IPgtWebConnectwebconnectxml
3 Save the file and close it The WinZip will display the following dialog
ldquoFile preferencesini has been changed since it was extracted Update archive
with this filerdquo
PowerTerm WebConnect 35 Getting Started Guide
4 Click Yes and close the archive
If you are editing the file from within the explorer you will have to save the file elsewhere
and then drag it to the explorer window where the JAR file is open
68 Installing PowerTerm WebConnect Client on Lotus Expeditor
1 Start the Lotus Expeditor client
2 Select File | Application | Install
3 Select Search for new features to install and click Next
4 Select Add Folder Location and type or select the location of the update site folder from
the provided package Click OK
5 Select the location you have just created and click Finish
6 In the Select the feature to install tree select Powerterm WebConnectUpdate Site Click
Next
7 Select I accept the terms in the license agreements and click Next
8 Click Finish
9 When prompted restart the platform
69 Running PowerTerm WebConnect Client for Lotus Expeditor
1 Click Open The PowerTerm WebConnect option is displayed
2 Select PowerTerm WebConnect The application will automatically connect and start
downloading the components from PowerTerm WebConnect Server
IMPORTANT
If you did not install PowerTerm WebConnect Server and are instead connecting to Ericom
Softwarersquos Demo WebConnect Server then you need to open port 443 in the firewall
691 PowerTerm WebConnect Client Workflow
1 PowerTerm WebConnect client reads the URL of webconnectxml from the preferencesini
file and requests it
2 When the webconnectxml is successfully downloaded the application reads the
configuration connects to the specified Web server downloads the PowerTerm
WebConnect components and connects to the PowerTerm WebConnect Server
3 The user is requested to login to the PowerTerm WebConnect Server For testing you
can use the username Example and password example
This step will be skipped if Single Sign-on is set to ldquotruerdquo
PowerTerm WebConnect 36 Getting Started Guide
4 After logging in to PowerTerm WebConnect Server the userrsquos applications are displayed
as defined by the administrator
5 To run an application select the desired application from the list and click Launch or
double-click the application The application will be launched in a separate window
610 Troubleshooting
When you encounter a problem the first step is to open the log file This file is located on
the client machine in the Ericom folder
Windows
CDocuments and SettingsltusernamegtEricomleclientEricomPluginlog
Linux
ltuser-home-directorygtEricomleclientEricomPluginlog
Following is a guide for diagnosing and fixing the problems in cases of error messages and
additional information
Error
Message
Solution
Version File
reading error
1 Check the lsquourlrsquo parameter in the webconnectxml file on the Web
server The value should be
httpltWebServerIPgtWebConnect
2 Try to run the following URL on the browser
Windows
httpltWebServerIPgtWebConnectwindowsptagentvertxt
Linux
httpltWebServerIPgtWebConnectlinuxix86qterm-
wcvertxt
The file contents displayed in the browser window should be in
the following form
560-rel14546
PowerTerm WebConnect Application Zone
560 - Main Release
ltrootgtPowerTerm WebConnect 56ltWebServergt
If the version file contents are not as shown check
- Is the Web Server running
- Are PowerTerm WebConnect Web Components and version files
PowerTerm WebConnect 37 Getting Started Guide
in place
3 On the Web server check ltPowerTerm WebConnect
rootgtwebwindowsptagentvertxt If the contents ldquolook wrongrdquo or
not in the proper form reinstall the PowerTerm WebConnect Web
components
4 On the client machine open the aforementioned URL in the
browser The file content should appear in the browser If it does
not it could be that the Web server is down
Web Server is
shut down
The webconnectxml configuration file must be located on the Web
server The explicit URL to this file is defined in the preferencesini
file (see Configure the Preferences File)
The error message contains the IP address of the Web server
Verify that the Web server on this machine is running
Version file
does not exist
on ltURLgt
See Version File reading error
The
configuration
file is not
accessible or
has a wrong
format
The webconnectxml configuration file must be located on the Web
server and the explicit URL to the configuration must be defined in
the preferencesini file (see Configure the Preferences File)
Try to open the URL specified in the error message in the
browser If it does not open then it either does not exist or it has
a wrong format
Preferences
file does not
exist in the
application
bundle
The preferencesini file containing the URL to the configuration
file was removed from the update site folder
Uninstall the current PowerTerm WebConnect client from the
client machine Create a new customized package (see
PowerTerm WebConnect Client Configuration) and reinstall it
Configuration
file URL is not
defined in
preference
file
The URL to the configuration file does not appear in the
preferencesini file (see Configure the Preferences File)
Uninstall the current PowerTerm WebConnect client from the
client machine Create a new customized package (see
PowerTerm WebConnect Client Configuration) and reinstall it
No IP address
could be
found for the
host
The Web server URL specified in the preferencesini file (see
Configure the Preferences File) or in the webconnectxml file (see
Configure the PowerTerm WebConnect Client) is an unknown
host
If the mistake is in the preferencesini file uninstall the current
PowerTerm WebConnect client from the client machine Create a
new customized package (see PowerTerm WebConnect Client
Configuration) and reinstall it
PowerTerm WebConnect 38 Getting Started Guide
If the mistake is in the webconnectxml file correct the file reopen
the Lotus Expeditor client
Cannot write
to destination
The temporary file cannot be written to the defined destination
Check the write permissions
Copied
configuration
file has wrong
format
The webconnectxml file as received from the specified URL has a
wrong format Correct the file and try again
PowerTerm
WebConnect
Agent URL is
malformed
The PowerTerm WebConnect Agent URL specified in the
webconnectxml file (see Configure the PowerTerm WebConnect
Client) does not have a proper HTTP format Correct the file and
try again
PowerTerm
WebConnect
Agent URL is
not defined
The PowerTerm WebConnect Agent URL parameter is not specified
in the webconnectxml file (see Configure the PowerTerm
WebConnect Client)
Correct the file and try again
The specified
destination
folder name
is wrong
The destination folder name contains illegal characters
ltgt|
Check the dst parameter in the webconnectxml file Correct the
file and try again
You do not
have
permissions
to write to
ltpathgt
The PowerTerm WebConnect Agent cannot be written to the
destination as defined Check the write permissions
The default destination defined in the version file should not to
be changed
A customized destination for PowerTerm WebConnect Agent
downloading can be defined in the webconnectxml file (See
Configure the PowerTerm WebConnect Client)
Check the destination value correct and try again
PowerTerm WebConnect 39 Getting Started Guide
About Ericom
Ericomreg Software is a leading provider of Application Access and Virtualization Solutions
Since 1993 Ericom has been helping users access enterprise mission-critical applications
running on a broad range of Microsoftreg Windowsreg Terminal Servers virtual Desktops
Blade PCs legacy hosts and other systems Ericom provides concrete business value by
helping organizations realize the benefits of their IT investments With offices in the United
States United Kingdom EMEA India and China Ericom also has an extensive network of
distributors and partners throughout North America Europe Asia and the Far East Our
expanding customer base is more than 30 thousand strong with over 7 million
installations
For more information on our products and services contact us at the location nearest to you
And visit our web site httpwwwericomcom
North America Western Europe International
Ericom Software Inc Ericom Software (UK) Ltd Ericom Software Ltd
231 Herbert Avenue Bldg 4 11a Victoria Square 8 Hamarpeh Street
Closter NJ 07624 USA Droitwich Worcestershire Har Hotzvim Technology Park
Tel +1 (201) 767 2210 WR9 8DE United Kingdom Jerusalem 91450 Israel
Fax +1 (201) 767 2205 Tel +44 (0) 845 644 3597 Tel +972 (2) 591 1700
Toll-free 1 (888) 769 7876 Fax +44 (0) 845 644 3598 Fax +972 (2) 571 4737
Email infoericomcom Email infoericomcouk Email infoericomcom
PowerTerm WebConnect 6 Getting Started Guide
1 Product Overview
PowerTerm WebConnect is an Enterprise-Wide Application Access solution that enables you
to publish and provide secure remote access to applications running on Windows Terminal
Servers Virtual Desktops (on top of hypervisors such as VMWare Microsoft Xen and
Virtual Iron) Blade PCs and legacy hosts Once published applications can be accessed
and used by end-users in a secure and managed fashion
Major components of the PowerTerm WebConnect product include
bull PowerTerm WebConnect Server
Choose between either Windows or Linux editions of the server
bull PowerTerm WebConnect DeskView Server
This component makes it possible to publish Desktops and applications that run on
Virtual Machines and physical machines
bull PowerTerm Load Balancer
Install the PowerTerm Load Balancer as a part of PowerTerm WebConnect Server
installation on the same computer or independently on a separate computer
Once installed it provides System and Application Load Balancing
bull PowerTerm WebConnect Web Components
Install these components on a compatible Web server in order to provide end-
users with a Web interface to published applications
bull PowerTerm WebConnect Administration Tool
Install the PowerTerm WebConnect Administration Tool on the server or on an
administration workstation It can also be downloaded on-demand
bull Client-side components
These components are installed as a part of the ldquoWeb server componentsrdquo
installation option and are usually downloaded by users the first time they need
the corresponding functionality Some components can be pre-installed if needed
Client side components include
RemoteView for accessing Windows Terminal Server applications and Virtual
Desktops from Windows and Linux workstations as well as from Windows Based
Terminals and Windows XPe and Linux based thin clients
HostView for accessing character-based applications running on legacy hosts
including IBM Mainframe IBM AS400 OpenVMS Unix Linux Tandem from
Windows and Linux workstations as well as from Windows Based Terminals and
Windows XPe and Linux based thin clients
SupportView for remote desktop support
PrintView for managing print queues
QuickVNC for remote desktop connectivity
bull PowerTerm Terminal Server Agent
Install this component on Windows Terminal Servers This component enables
PowerTerm WebConnect 7 Getting Started Guide
True Seamless Windows for published applications remote application browsing
and publishing and Application Load Balancing
bull PowerTerm WebConnect Portlet for JSR 168 Portals
Install this component if you plan to access Windows published applications and
Legacy hosts from within JSR 168 compatible portal environments such as IBM
Workplace or WebSphere Oracle Portal Vignette Portal and the like
bull PowerTerm WebConnect Plugin for IBM Lotus Expeditor
Install this plugin if you plan to access Windows published applications and Legacy
Hosts from within the IBM Lotus Expeditor environment
bull PowerTerm WebConnect DeskView
This component makes it possible to publish Desktops and applications that run on
Virtual Machines and physical machines
The evaluation package of PowerTerm WebConnect that you can download and
install contains the PowerTerm WebConnect Enterprise product with all its
components Once activated the product will only include the components and
features of the specific PowerTerm WebConnect product you purchased
PowerTerm WebConnect 8 Getting Started Guide
2 Installing and Starting PowerTerm WebConnect
PowerTerm WebConnect includes both server-side and client-side components The server
side includes
bull PowerTerm WebConnect Server
bull PowerTerm WebConnect DeskView Server
bull PowerTerm WebConnect Load Balancer
bull PowerTerm WebConnect Administration tools (for WebConnect Server PowerTerm
Load Balancer and DeskView Server)
The client side has numerous clients such as
bull RemoteView
bull HostView (for both Windows and Linux)
bull QuickVNC etc
21 Install PowerTerm WebConnect (Windows edition)
1 Run the installation file typically named PowerTermWebConnect5xexe You will find
the file on the installation CD or you can download it from Ericoms website
2 Click Install and then enter your Serial Number or click Evaluate when prompted
3 Continue with installation and select Full Installation Server Administration Tool and
WebServer Components (default) in the Setup Type dialog
4 Complete the installation and click Exit and run PowerTerm WebConnect in the last
dialog of the installation Depending on your computer this may take a few minutes
The first time you launch the PowerTerm WebConnect server it will generate a
Diffie-Hellman key for SSL encryption This process may take several minutes
depending on the speed of your computer A visual progress indicator will show
you when this process is completed While this process is taking place PowerTerm
WebConnect clients will not be able to connect to the server
22 StartStopRestart PowerTerm WebConnect Server (Windows edition)
PowerTerm WebConnect server is installed as a Windows service
1 Launch the standard Services console from the Windows Control Panel On some
computers it may be located under the Administrative Tools group You can also run
the command SERVICESMSC The Services window is displayed
PowerTerm WebConnect 9 Getting Started Guide
2 Select PowerTerm WebConnect Server 5x service (the primary service of PowerTerm
WebConnect) where x is the version number and use standard StartStopRestart
options
The PowerTerm WebConnect Server Starter 5x service (the secondary service of
PowerTerm WebConnect) is designated for restarting the primary service in
cases of failure or any unexpected problems The secondary service is
controlled by internal logic of PowerTerm WebConnect and cannot be stopped
from the Services console
23 Install Run and Stop PowerTerm WebConnect Server (Linux edition)
Transfer the installation file to your Linux server and install the PowerTerm WebConnect
components in the RPM package using the following shell command
rpm ndashi WebConnecct-5x-0i586rpm
(lsquoxrsquo is the version number)
The PowerTerm WebConnect server will be installed to
optWebConnect5x
All PowerTerm WebConnect clients including PowerTerm WebConnect
Administration Tool are published via the Web server Therefore you need to
manually configure the Web server to publish the path optWebConnect56web
The name of the virtual directory has to be WebConnect5x
After configuring the virtual directory you can launch any client from httpltservernamegtWebConnect5xClientURLshtml
Users of Red Hat 72
If you installed the PowerTerm WebConnect server on Red Hat 72 you also have to install
the file libgcc-304-1i386rpm (44Kb) in order for PowerTerm WebConnect Server to run
This file can be downloaded from
ftprpmfindnetlinuxredhatupdates72enosi386libgcc-304-1i386rpm The file is
also available on the installation CD and can as well be downloaded from the ldquoEvaluate
PowerTerm WebConnect Linux x86 Editionrdquo web page
Use the following commands to run the PowerTerm WebConnect server
On RedHat
sbinservice webconnectd start
On Suse
etcrcdwebconnectd start
Use the following commands to stop the PowerTerm WebConnect server
On RedHat
sbinservice webconnectd stop
PowerTerm WebConnect 10 Getting Started Guide
On Suse
etcrcdwebconnectd stop
24 Install the Terminal Server Agent
PowerTerm WebConnect Terminal Server Agent must be installed on a Terminal Server
accessed using PowerTerm WebConnect It provides the True Seamless Windows
functionality for published applications remote browsing and publishing and Application
Load Balancing
The PowerTerm WebConnect Terminal Server Agent must be installed on every Terminal
Server in the cluster If you install the PowerTerm WebConnect server itself on a Terminal
Server you will be given the option to install the Terminal Server Agent as a part of the
server installation Alternatively use the PowerTermTerminalServerAgentexe file located in
the AddOnsTerminalServerAgent subdirectory under the PowerTerm WebConnect server
installation directory
To complete the installation you might need to restart the Terminal Server machine
25 Install PowerTerm WebConnect DeskView Server
PowerTerm WebConnect DeskView is automatically installed when you run PowerTerm
WebConnect Installation wizard ndash Full installation To run PowerTerm WebConnect
DeskView Server you also need Microsoft NET Framework v30 to be installed on your
computer If you do not have it installed then the installation wizard will place the
DeskViewServerSetupmsi and DeskViewAdminSetupmsi files in the AddOns folder
(ltPowerTerm WebConnect Installation FoldergtWebConnect 5xAddOnsDeskView
VDI) from where you can run the msi files at a later stage to install PowerTerm
WebConnect DeskView
26 Start the PowerTerm WebConnect Administration Tool
There are several ways to launch the PowerTerm WebConnect Administration Tool Select
the one most convenient for you
bull From Windows Start menu select Programs | Ericom Software | PowerTerm WebConnect
5x | PowerTerm WebConnect Administration Tool
If you changed the Program Folder during installation the Start menu path
may vary
bull Double-click PtAdminexe PtAdminexe is located in the bin directory of the
PowerTerm WebConnect installation folder
bull Rather than installing you can choose to download the Administration Tool to any
Windows computer Please refer to the PowerTerm WebConnect Sample URLs
page (httpltweb_servergtWebConnect5xClientURLshtml) for more details
A few things to remember
PowerTerm WebConnect 11 Getting Started Guide
When you launch the PowerTerm WebConnect Administration Tool for the first time the Connection dialog is displayed with the user Administrator No
password is required to enter just click Connect
In the Connection dialog (displayed when launching the Administration Tool) the
Host Name is localhost by default This is correct only if the Administration Tool
runs on the same machine as the server If the Administration Tool runs on a different machine you need to change the Host Name to the IP addressHostname
of the PowerTerm WebConnect server
When using the PowerTerm WebConnect Windows edition by default the
Administration Tool will deny any connection attempts from any computer other
than the local machine
PowerTerm WebConnect 12 Getting Started Guide
3 PowerTerm WebConnect Administration Tool at a Glance
PowerTerm WebConnect Administration Tool manages published applications user sessions
and server configuration The administrator can perform operations such as multiple
application publishing sending messages to logged-on users shutting down sessions and
monitor user activity
To perform the tasks described in this chapter you must launch the Administration Tool via one of the methods detailed in chapter Start the PowerTerm
WebConnect Administration Tool
Launching the Administration Tool from the system tray or using the
Administration Tool launched after completed installation will not allow you to
activate certain features
After you launched the Administration Tool and connected to the server you will receive a
Welcome screen where you select desired activity
bull Publish Multiple Applications opens the Publish Multiple Applications wizard
bull Configure Load Balancer opens PowerTerm Load Balancer Administration Tool
bull Create a Host Connection opens the Add Connection dialog
bull Configure Active Directory opens the Directory Services dialog
PowerTerm WebConnect 13 Getting Started Guide
Close the Welcome screen to enter the Administration Tool main
screen
The Administration Tool main screen has three sections
bull User section lists all users defined in the server
bull Group section lists all groups defined in the server
bull Connection section lists all connections and published applications defined in the
server
By default only the Connection section is displayed when you first open Administration Tool
There are three predefined example-connections ldquoExample_As400rdquo ldquoExample_VTrdquo and
ldquolocalhostrdquo You can test them prior to defining your own
1 Right click the connection you want to test and select Test The PowerTerm
WebConnect HostView Login dialog appears
2 Type example for User Name and example for Password
Credential fields are case sensitive
3 Click Login The desired connection with its pre-programmed demo application is
launched
PowerTerm WebConnect 14 Getting Started Guide
31 Publishing Applications and Documents
In order to enable access to applications and documents on Windows Terminal Servers
publish these applications and documents from the Administration Tool When publishing
applications and content you can specify which servers will be used in a Terminal Server
cluster and which users and groups will have access to these services Once you have
published such applications and documents the RemoteView client can be used to access
them
If you need to provide access to multiple applications on a Terminal Server use the Multiple Application Publishing wizard to significantly reduce the time and
effort required to publish these applications
To publish multiple Windows applications
1 Click Publish Multiple Applications in the Welcome screen The Choose Terminal Server
for Browsing dialog appears
2 Provide the address of the Terminal Server which will be used for browsing and click OK The Application Publisher Step 1 dialog appears This dialog lists all the
applications available in the specified serverrsquos Start menu
3 Select those applications found in the Programs folder of the designated server that you want to publish and click Next The Application Publisher Step 2 dialog appears
4 Determine the destination of your publishing and click Next The Application Publisher
Step 3 dialog appears
5 Determine the Color Quality of your published application
6 Determine the start mode in which you want to run the published application - normal maximized or minimized - and click Next The Application Publisher Step 4
dialog appears
7 Choose the connection speed that matches your infrastructure The connection speed
setting determines the value of three visual effects settings You can also override
these settings specifically
8 Determine whether you prefer the window to display their content while being
dragged or just the outline By default the same setting is used as the client desktop
9 Click Next The Application Publisher Step 5 dialog appears
10 Specify where sounds are to be played ndash locally or remotely
11 Determine which local devices the remote session will have access to (local drivers printer etc) and click Next The Application Publisher Step 6 dialog appears
12 If you have the PowerTerm Load Balancer installed Use all Servers (default) allows the application to run on any Terminal Server in the
cluster This setting is appropriate when the application is installed on all the Terminal
Servers Alternatively you select specific Terminal Servers on which to run this
application
If you have not installed the PowerTerm Load Balancer you will need to explicitly
specify the address of the Terminal Server on which the application will be run
PowerTerm WebConnect 15 Getting Started Guide
13 Click Next The Application Publisher Step 7 dialog appears
14 Select the users groups or OUs to which you wish to publish the applications and click Next The Application Publisher Step 8 dialog appears By default applications will
be published to everybody
15 Click Advanced Settings to modify settings such as the login credentials to the
Terminal Servers By default PowerTerm WebConnect credentials will be passed
through to the Terminal Server
16 Click Finish The published applications appears in the Connection List
Right-click and select Properties or double click on the published application in the
Connections list to view and modify any of the settings which you previously
defined
To publish a remote Desktop
1 Select Action | New | Remote Desktop The Application Publisher Step 1 dialog appears
2 Type the Display Name which will be the name presented to the end-users and click
Next The Application Publisher Step 2 dialog appears
3 Specify where icons for the published desktop will be displayed to the end-user in Publish to
4 Click Choose Icon to replace the desktoprsquos default icon Select the desired icon from
the list that appears
5 Click Next The Application Publisher Step 3 dialog appears
6 Determine Screen Size and the Color Quality of the published desktop
7 If desirable select Show Connection Bar in Full Screen Mode
8 Click Next The Application Publisher Step 4 dialog appears
9 Choose the connection speed that matches your infrastructure The connection speed
setting determines the value of three visual effects settings You can also override
these settings specifically
10 Click Next The Application Publisher Step 5 dialog appears
11 Specify where sounds are to be played ndash locally or remotely Where to Apply Window
Key Combinations and which local devices you want to automatically connect to when
logged on to the remote computer
12 Click Next The Application Publisher Step 6 dialog appears
13 Specify the Server Address and Port Number of the Terminal Server that weill provide
the desktop and click Next The Application Publisher Step 7 dialog appears
14 Select the users groups or OUs to which you wish to publish the desktop and click Next The Application Publisher Step 8 dialog appears
Select the Server group to allow all users to access the published application
15 Click Advanced Settings to modify settings such as the login credentials to the
Terminal Servers By default PowerTerm WebConnect credentials will be used
PowerTerm WebConnect 16 Getting Started Guide
16 Click Finish The published application appears in the Connection List
Right-click Properties or double click on the published application in the
Connections list to modify any of the settings which you previously defined
32 Create Terminal Emulation Connections
To provide access to legacy host systems you will need to create Terminal Emulation
connections For each such connection you can specify the host address emulation type
login script and more Once you have created these connections users will be able to
launch them using HostView (Windows or Linux) WebView or the Java client as
appropriate
1 Click Create a Host Connection in the Welcome screen The Add Connection dialog
appears
2 Enter a Name for the new connection
3 Specify an Owner for the new connection The possibilities are
[None] the connection will not be allowed to run by anyone and it will not be
displayed in any Connection list Server the connection will be accessible for all users of this PowerTerm
WebConnect server A specific group the connection will be accessible for all users of the specified
group A specific user the connection will be accessible for a specified user only
4 Leave category Terminal Emulation selected
5 Select Terminal Type Terminal Model and Communication Type as needed
6 Specify the Host Name or IP address of your host
7 Specify other parameters as needed
8 Select the Security Type as needed if your host supports SSL or SSH and specify
the appropriate details in the Details dialog
9 Use the Settings Key Mapping and Power Pad options to further customize the
connection
10 Click OK and the connection is created
33 Test Connections
It is recommended to test published applications or host connections before they are made
available to end-users
To test a connection
bull Right-click the target connection from the Connection section of the main screen and
select Test
Alternatively
PowerTerm WebConnect 17 Getting Started Guide
1 Select Tools | Run ltdesired clientgt The Login to WebConnect dialog appears
2 Enter the User Name and Password for the individual who owns the connection that
you want to test and click Login The desired PowerTerm WebConnect client is started
and the Connect dialog appears
3 Select the desired connection and click Connect The test is executed
34 Launch the Application Zone or the Application Portal
Users can access the published applications from the Application Zone application launcher
or from the Application Portal web interface
To use the Application Zone go to Start menuProgramsEricom SoftwarePowerTerm
WebConnect 5x and select Client URLs Alternatively type the following URL into your Web
browserrsquos address bar httpltserver addressgtWebConnect5xClientURLshtml In the
page that opens click on the Run button next to the Application Zone to launch it
To use the Application Portal go to Start menuProgramsEricom SoftwarePowerTerm
WebConnect 5x and select it Alternatively type the following URL into the Web browserrsquos
address bar httpltserver addressgtWebConenct5xportalwindowsindexasp
35 Monitor a Users Sessions
From the Administration Tool you can monitor the users sessions and may intervene if
necessary This intervention may result in your input appearing on the users screen The
user receives a notification when an administrator begins and ends monitoring the session
1 Select View | Client Sessions or click to see all the active client sessions
2 Select the desired active session and right-click Attach The Password Verify dialog
appears
3 Enter your password and click OK Some notification dialogs appears and the selected
PowerTerm WebConnect session is viewed
36 View Intruders
bull The Intruders window shows suspected attempts at breaching security After several
suspected intrusion attempts users are blocked temporarily
bull In addition to showing suspected intrusion attempts the Intruders window allows
you to remove restrictions on users
bull Select View | All Intruders or click
PowerTerm WebConnect 18 Getting Started Guide
4 Accessing Virtual Desktops and Blade PCs with PowerTerm WebConnect
This chapter provides instructions on configuring PowerTerm WebConnect for Virtual
Desktop Infrastructure (VDI)
41 Step 1 Launch DeskView Administration Tool
Verify that PowerTerm WebConnect is installed on your server and launch PowerTerm
WebConnect Admin Tool
bull Select Tools | Open VDI Manager The PowerTerm WebConnect DeskView Administration
Tool opens
The first time you launch the DeskView Administration Tool you will be prompted to install
the tool
PowerTerm WebConnect 19 Getting Started Guide
Microsoft Management Console 30 is required for PowerTerm WebConnect DeskView
Administration Tool If you do not have this installed you will also automatically be
prompted to install this update
Follow the installation processes when you are prompted for either install PowerTerm
WebConnect DeskView Administration Tool will automatically launch when these
installations are completed
42 Step 2 Add a Host
1 Right-click Virtualization Hosts and select Add Host The Add a New Host wizard
opens Click Next
2 Enter a Host Name as you would like it to appear in PowerTerm WebConnect
DeskView Administration Tool and a description (optional) Click Next
3 Specify the Virtualization Server type and click Next
4 Specify the connection information and click Next
VMWare Virtual Center v1x and 2x
Specify the HTTPS Web Service address and a UsernamePassword that can access
the host
VMWare Virtual Server 2005
Click Start and then Run
Type ldquoservicesmscrdquo and click OK
Scroll down to PowerTerm WebConnect DeskView Server service and open
Properties
Change the Login Account for the service to match the Domain Administrator
account and password used when setting up Microsoft Virtual Server 2005 and
restart the service Enter the IP or NETBIOS name of the Microsoft Virtual Server 2005 server as the
Server Address in the Connection Broker Wizard
Xen Server
Specify the hypervisor IP address or NETBIOS name the Root UsernamePassword
to the hypervisor and the Service port (default 80)
Oracle VM
Specify the Serverrsquos agent URL and Port (default 8899) for example
httpsltservernamegt8899
Specify the Oracle VM hypervisorrsquos Oracle Agent UsernamePassword (default
username oracle)
5 Click Finish to add the new Host
To configure Virtual Machines for use install the Ericom Tools (vmagentmsi) on each of the
virtual machines on the new host for PowerTerm WebConnect DeskView to recognize them
The vmagentmsi installer is located on the PowerTerm WebConnect server in ltPowerTerm
WebConnect installation foldergtAddOnsDeskView VDI folder (default installation
PowerTerm WebConnect 20 Getting Started Guide
folder is xProgram FilesEricom SoftwareWebConnect 56) During installation you
will need to enter the DeskView IP address or NETBIOS name
If you are using Microsoft Virtual Server 2005 as your Virtualization Host use the
IP address of the DeskView server only when installing the Ericom Tool package
43 Step 3 Create a Pool
Pools are used to organize Virtual Machines (VM) into logical groups This enables
organizations to combine and order resources from multiple systems into one entity To
access available resources end-users simply connect to PowerTerm WebConnect to access
any configured resource
1 Right-click Pools and select Create Pool The Create a Pool wizard opens Click
Next
2 Enter a Pool name as you wish it to appear and a description (optional) and click
Next
3 Specify the Pool type and click Next
4 Specify the Assignment type and click Next
Permanently will cause a virtual machine to affix to the user who has launched
that virtual machine For the duration of the session will cause any virtual machine that is not in use to
be returned to the pool for any user to launch
5 Specify the LogoffDisconnect event and click Next
Select what you would like to happen after a user logs off from a virtual machine
in this pool
Select what you would like to happen when a user is disconnected from a virtual
machine in this pool
6 Click Finish to add the new Pool
You will need to assign virtual machines from your virtualization hosts to your created pool
1 Right-click the pool and select Assign Machines The Assign Machines to ltyour
pool namegt dialog opens
2 Highlight the desired virtual machine(s) and click Select Click OK
44 Step 4 Publish an ApplicationDesktop
1 Return to PowerTerm WebConnect Admin Tool to publish DeskView pools
2 Determine whether to publish a full desktop or a seamless application running
from a virtual desktop
For a full desktop
Select Action | New | Remote Windows Desktop
For a seamless application
Select Action | New | Windows Application
PowerTerm WebConnect 21 Getting Started Guide
3 Select Virtual Desktop in the first step of the wizard and click Next
4 Follow the wizardrsquos instructions until you reach the Virtual Desktops step
5 Select a pool that you previously created and that you would like this connection to choose virtual machines from Click Next
6 Continue and complete the reminder of the wizardrsquos steps
Once the resource is published users who have been assigned access will be able to use it
immediately
PowerTerm WebConnect 22 Getting Started Guide
5 Download and Run PowerTerm WebConnect Clients
PowerTerm WebConnect clients are automatically downloaded and installed onto the client
devices For detailed information and samples please refer to the PowerTerm WebConnect
Sample URLs page To see this page navigate your browser to
httpltweb_servergtWebConnect5xClientURLshtml
PowerTerm WebConnect 23 Getting Started Guide
6 PowerTerm WebConnect Client for Lotus Expeditor
61 Installation Package
PowerTerm WebConnect client for Lotus Expeditor is provided to IBM in an Update Site
package This is a ZIP archive containing the Update Site with the Eclipse feature and plug-
in that comprises the PowerTerm WebConnect client
Extract the ZIP file keeping the foldersrsquo structure intact
NOTE In Winzip verify that the ldquoUse folder namesrdquo option is set to TRUE
Package structure
Update Site
- plugins
- PowerTermWebConnectClient_560365jar
- features
- comericomWebConnect_560365jar
- sitexml
config
- webconnectxml
Definitions
bull webconnectxml PowerTerm WebConnect client configuration file
bull comericomWebConnect_560365jar PowerTerm WebConnect client feature file
bull PowerTermWebConnectClient_560365jar PowerTerm WebConnect client plugin file
62 Pre-installation steps
PowerTerm WebConnect client for Lotus Expeditor does not run independently but in
conjunction with PowerTerm WebConnect Server You can either install it and define your
users groups and applications or use Ericom Softwarersquos Demo PowerTerm WebConnect
Server
bull If you decide to install PowerTerm WebConnect Server you will need the full
installation ie the PowerTerm WebConnect Server and the Web components If you
do not have the installation CD you can download and install a trial version from
wwwericomcom
PowerTerm WebConnect 24 Getting Started Guide
bull If you decide to use Ericom Softwarersquos Demo PowerTerm WebConnect Server then
skip to the chapter Installing PowerTerm WebConnect Client on Lotus Expeditor
63 Install PowerTerm WebConnect Portlet on IBM Workplace server (for Windows OS)
Step 1 Install PowerTerm WebConnect Server
If PowerTerm WebConnect Server and IBM Workplace Server are on separate machines
bull Configure PowerTerm WebConnect Server
Launch PowerTerm WebConnect Administration Tool
Open Files | Configuration | Main
In the [Portal] section edit
Machines=localhostltIBM sever machinegt
bull Configure PowerTerm WebConnect Web components
Copy the ldquowebrdquo folder from the PowerTerm WebConnect server installation to the
IBM Workplace server machine
Create an Alias or a Virtual directory to it named WebConnect on the Web
server providing access to it for the users This is in order to enable the users to
download the necessary files to run their applications
Step 2 Enable JSR portlets
1 On IBM Workplace Server go to ltPortalServergtsharedappconfigservicesConfigServiceproperties
2 Edit portalenablejsr168=true
3 Save and close the file
Step 3 Enable SSO
1 On IBM Workplace Server go to ltPortalServergtsharedappconfigservicesLoaderServiceproperties
2 Edit commandpath=comericomportalcommandscomibmwpsenginecommands
3 Save and close the file
Step 4 Copy Files
The following files need to be copied from WebConnect ServerAddOnsIBM
WorkplacePortlet folder to IBM Workplace Server
File name to copy Destination folder
OpenSSLdll ltAppServergtjavajrebin
IbmPortaldll ltAppServergtjavajrebin
IbmPortalini ltAppServergtjavajrebin
PowerTerm WebConnect 25 Getting Started Guide
WebConnectPortaljar ltAppServergtlib
EricomLoginjar ltPortalServergtsharedapp
Step 5 Portlet Configuration
1 On IBM Workplace Server go to ltAppServergtjavajrebinIbmPortalini
2 You can modify the following parameters in the [Server=WebConnect] section webserverport=ltIBM web server portgt
Specifies the Web server port for accessing the PowerTerm WebConnect clients folder
Default 80 Address
Specifies the address of the PowerTerm WebConnect Server machine for Portlet to
connect to when PowerTerm WebConnect Server is located on a different machine
than the IBM Workplace Server CustomAddress
Specifies the addresss of the PowerTerm WebConnect Server machine for Clients to connect to If CustomAddress is the same as Address then this may be omitted webserveraddr
Specifies the address of the Web Server machine when it is located on a different
machine than the IBM Workplace Server
3 Restart the IBM server ltPortalServergtrootscriptsstopWorkplaceServicesbat ltPortalServergtrootscriptsstartWorkplaceServicesbat
This procedure may take about 20 minutes
Step 6 Install the Portlet
1 In a Web browser open the URL httpltIBM Workplace
Servergt9081lwpmyworkplace to open the IBM Workplace Portal
2 Login as administrator
3 Go to Administration | Portlets | Install
4 Browse to the PowerTerm WebConnectwar file located on PowerTerm WebConnect
Server and click Next
5 Click Install
Step 7 Create an Application page
1 Login to the Workplace
2 Go to Portal User Interface | Manage Pages
3 Search for My Work
4 Click the My Work link and select New Page
5 Name the page PowerTerm WebConnect and click OK
6 Click OK again You will see the created page on the list
7 Click the pencil icon on the new page and select the 1 square layout
PowerTerm WebConnect 26 Getting Started Guide
8 Click Add Portlet and search for PowerTerm WebConnect
9 Select it and click OK
10 Click Done
11 Click My work at the top of the page PowerTerm WebConnect is displayed on the list
Step 8 Run the Portlet
1 Restart IBM Workplace Server
2 Open IBM Workplace Portal in a browser httpltportal servergtlwpmyworkplace
3 Login to IBM Workplace Server
4 Click My work PowerTerm WebConnect portlet is displayed
5 Launch it The Userrsquos applications as defined on PowerTerm WebConnect Server
appear
6 Click an application to launch it
64 Install PowerTerm WebConnect Portlet on IBM Workplace server (for Linux OS)
Step 1 Enable JSR 168 portlets
1 Go to optIBMWorkplacePortalServersharedappconfigservicesConfigServiceproperties
2 Modify the portalenablejsr168 property to ldquotruerdquo
3 Restart the server cd optIBMWorkplacePortalServerrootscripts
Run stopWorkplaceServicessh
Run startWorkplaceServicessh
This procedure can take up to 20 minutes
4 Log on to the workplace server at httpltworkplace servergt9081lwpmyworkplace using
the administrators username and password
Step 2 Install the portlet
1 Restart IBM Workplace Server
2 In a Web browser open the URL httpltworkplace server IPgtlwpmyworkplace
3 Login to IBM Workplace Server as an administrator
4 Go to Administration | Portlets | Install
5 Browse to the PowerTerm WebConnectwar file located on PowerTerm WebConnect
Server and click Next
6 Click Install
PowerTerm WebConnect 27 Getting Started Guide
Step 3 Install the Application page
1 Login to the workplace as administrator
2 Go to Administration | Portal User Interface | Manage Pages
3 Search for My Work
4 Click the My Work link and select New Page
5 Name the page PowerTerm WebConnect and click OK
6 Click OK again You will see the created page on the list
7 Click the pencil icon and select the 1-square layout
8 Click Add Portlet and search for PowerTerm WebConnect
9 Select it and click OK
10 Click Done
11 Click My work on top and PowerTerm WebConnect is displayed on the left bar
Step 4 Run the portlet
1 Restart IBM Workplace Server
2 Open IBM Workplace Portal in a browser httpltportal servergtlwpmyworkplace
3 Login to IBM Workplace Server
4 Click My work PowerTerm WebConnect portlet is displayed
5 Launch it The Userrsquos applications as defined on PowerTerm WebConnect Server
appear
6 Click an application to launch it
65 Install PowerTerm WebConnect Portlet on IBM WebSphere 61 server (for Windows OS)
Step 1 Install PowerTerm WebConnect Server
You have to configure PowerTerm WebConnect Server if it and the IBM WebSphere Server
are on separate machines
1 Launch PowerTerm WebConnect Administration Tool
2 Open Files | Configuration | Main
3 In the [Portal] section edit Machines=localhostltIBM sever machinegt
Step 2 Copy Files
The following files need to be copied from WebConnect ServerAddOnsIBM
WebSpherePortlet folder to IBM WebSphere Server
PowerTerm WebConnect 28 Getting Started Guide
File name to copy Destination folder
OpenSSLdll ltAppServergtjavajrebin
IbmPortaldll ltAppServergtjavajrebin
IbmPortalini ltAppServergtjavajrebin
WebConnectPortaljar ltAppServergtlib
Step 3 Portlet Configuration
1 On IBM Workplace Server go to ltAppServergtjavajrebinIbmPortalini
2 You can modify the following parameters in the [Server=WebConnect] section webserverport=ltIBM web server portgt
Specifies the Web server port for accessing the PowerTerm WebConnect clients folder
Default 80 Address
Specifies the address of the PowerTerm WebConnect Server machine for Portlet to
connect to when PowerTerm WebConnect Server is located on a different machine
than the IBM Workplace Server CustomAddress
Specifies the addresss of the PowerTerm WebConnect Server machine for Clients to connect to If CustomAddress is the same as Address then this may be omitted webserveraddr
Specifies the address of the Web Server machine when it is located on a different
machine than the IBM Workplace Server
3 Restart the IBM server ltAppServergtProfilesAppServer01binstopServerbat ltAppServergtProfilesAppServer01binstartServerbat
This procedure may take about 20 minutes
Step 4 Install the Portlet and create an Application page
1 In a Web browser open the URL httpltIBM WebSphere Servergt9060ibmconsole
to open the IBM WebSphere Portal
2 Login and go to Applications | Install New Application
3 Browse to the PowerTerm WebConnectwar file located on PowerTerm WebConnect
Server
4 Enter Context root and click Next The Select installation options dialog appears
5 Optional change options to your preference or keep the default
6 Click Next
7 Select Ericom in the Module column click Apply and then Next
8 Click Finish and then Save
9 Select Applications | Enterprise Applications
10 Select PowerTerm WebConnectwar checkbox and click Start
PowerTerm WebConnect 29 Getting Started Guide
11 Enter in the Web browser the URL httpltIBM WebSphere
Servergt9080ltContext rootgtEricom portlet The Login dialog appears
12 Login and you will see PowerTerm WebConnect displayed on the list
Step 5 Run the Portlet
1 Restart IBM WebSphere Server
2 Open IBM WebSphere Portal in a browser httpltportal servergt9080ltContext
rootgtEricom portlet
3 Login to IBM WebSphere Server
4 Launch it The Userrsquos applications as defined on PowerTerm WebConnect Server
appear
5 Click an application to launch it
66 PowerTerm WebConnect Server Configuration
bull To enable the Lotus Expeditor to run the PowerTerm WebConnect client the
System Administrator must provide the users with accounts on PowerTerm
WebConnect Server (see the PowerTerm WebConnect Administratorrsquos Manual for
instructions on how to create users groups and connections on the PowerTerm
WebConnect Server)
bull To enable PowerTerm WebConnectrsquos Single Sign-On feature the System
Administrator must create a PowerTerm WebConnect user with the same
username and password as used for the Lotus Expeditor For a managed Lotus
Expeditor the credentials used are the username and password sent to the
managing server For an unmanaged Lotus Expeditor the operation system
username and the Lotus Expeditor password are used as credentials
NOTE If a password is not defined then the Single Sign-On will fail and the user will be
prompted with a login dialog
67 PowerTerm WebConnect Client Configuration
The PowerTerm WebConnect client is configured in webconnectxml located in the config
folder webconnectxml parameters are
url The PowerTerm WebConnect Agent url
server The PowerTerm WebConnect Server address
sso The Single Sign-On feature
dst The local destination for downloading PowerTerm WebConnect
components
PowerTerm WebConnect 30 Getting Started Guide
url
PowerTerm WebConnect components are installed on a Web server Their default url is
Windows Agent
httpltWebServer IPgtWebConnectwindowsptagentcab
Linux Agent
httpltWebServer IPgtWebConnectlinuxix86qterm-wczip
The url parameter must include the first part of the url (which is identical for both Windows
and Linux agents)
The PowerTerm WebConnect client will automatically append the appropriate suffix in
order to create a full accurate url
Example
ltitem key=rdquourlrdquo value=httpadminserverWebConnectgt
server
The computer name or IP address of the PowerTerm WebConnect Server machine
The PowerTerm WebConnect client will log in to this PowerTerm WebConnect Server
display the applications defined on it and run them according to this serverrsquos configuration
Format ltserver IPgt[ltportgt]
where default port is 4000 (can be edited)
Example
ltitem key=rdquoserverrdquo value=rdquoadmin24000rdquogt
sso
Determines whether Single Sign-on will be used to log in to PowerTerm WebConnect
Server Values
bull True (default) the client should automatically log in to the PowerTerm WebConnect
Server using the same credentials as the ones used to log in to the Lotus Expeditor
client
The System Administrator must verify that these credentials can log in to the
PowerTerm WebConnect Server
bull False the user will be prompted with a login dialog or will log in automatically using
previously saved credentials
Example
ltitem key=rdquossordquo value=rdquotruerdquogt
Autologin mode
PowerTerm WebConnect 31 Getting Started Guide
If sso is set to True the user is not prompted for credentials and the login process to
PowerTerm WebConnect Server is done automatically sending the credentials used for the
Lotus Expeditor unless the Lotus Expeditor does not have a password defined (In the
Lotus Expeditor preferences page | Password| Prompt me for a password at start up checkbox)
However if Single Sign-on is not used there are several options regarding Autologin that
can be defined in the PowerTerm WebConnect Preferences page Options
bull Yes
bull No
bull Interactive
bull First time interactive (default) ndash Simplifies the login process to PowerTerm
WebConnect Server In this mode the first time the user logs in to PowerTerm
WebConnect Server he will be prompted for his credentials with the Login dialog
These credentials will be stored in the machine and from then on the login process to
PowerTerm WebConnect Server will be done automatically
1 Open File | Preferences from the Lotus Expeditor and select PowerTerm WebConnect
2 In the Autologin to WebConnect Server section select First Interactive and click OK
3 Start PowerTerm WebConnect Client for Lotus Expeditor If credentials were entered
at least once then the next time the client will connect to PowerTerm WebConnect
Server without prompting for the user name and password
The Administrator must configure the Agent to do nothing when it exits for the
feature to work this way See PowerTerm WebConnect Administratorrsquos Manual for more information about defining Autologin
bull Allow multiple selection ndash Defines whether the user can launch more than one
application at a time (by using the ltCtrlgt or ltShiftgt button while selecting applications)
dst
Defines the path to download PowerTerm WebConnect components on the client machine
The dst parameter can contain macros which are translated by the PowerTerm WebConnect
Client for Lotus Expeditor during runtime The macros should be placed between percent
symbols () for example WebServer
When such a value is defined the PowerTerm WebConnect Client for Lotus Expeditor
substitutes the entire expression for the macrorsquos value
The PowerTerm WebConnect Client for Lotus Expeditor does not support the use
of environment variables as macros
Macros are not case sensitive
Macros supported by PowerTerm WebConnect Client for Lotus Expeditor
Macro name Description
WebServer The name of the Web server
It is obtained from the PowerTerm WebConnect Agent url
PowerTerm WebConnect 32 Getting Started Guide
parameter
Name The name of the clientrsquos CAB or ZIP file eg ldquoptagentrdquo
Display The clientrsquos display name from the version file
Version The clientrsquos version value It is obtained from the version
file
Root The default root location
Windows ldquoCrdquo
LinuxUnix an empty string
OSDir Windows Windowsrsquo installation directory for example
ldquoCWindowsrdquo
Linux an empty string
OSDrive Windows Windowsrsquo installation drive for example ldquoCrdquo
Linux an empty string
HomePath Windows The HOMEPATH environment variable
Linux The HOME environment variable
Home The Ericom folder in the userrsquos home directory
Windows CDocuments and SettingsltusergtApplication
DataEricom
Linux ltusergtEricom
In addition to the predefined macros listed above the PowerTerm WebConnect client
supports the usage of Java System Properties
Java System Properties available for users on Windows XP SP2
Java System Property Name Value Example
javaversion 150
javavendorurl httpwwwibmcom
javahome CIBMcommonpluginscomibmpvcwctruntim
esj2sewin32x86_150SR2-
20060511rcpeclipsepluginscomibmrcpj2sew
in32x86_150SR2-20060511jre
javavmspecificationversion 10
javavmversion 23
javavmvendor IBM Corporation
javavmname IBM J9 VM
PowerTerm WebConnect 33 Getting Started Guide
javaiotmpdir CDOCUME~1dianaLOCALS~1Temp
javacompiler j9jit23
javaextdirs CIBMcommonpluginscomibmpvcwctruntim
esj2sewin32x86_150SR2-
20060511rcpeclipsepluginscomibmrcpj2sew
in32x86_150SR2-20060511jrelibext
osname Windows XP
osarch x86
osversion 51 build 2600 Service Pack 2
pathseparator
username Jone
userhome CDocuments and SettingsJone
userdir CIBMRSA
usertimezone GMT+0200
System properties available for users on Linux RedHat 9
Java System Property Name Value Example
javaversion 150
javavendorurl httpwwwibmcom
javahome usrjavajre150_07
javavmversion 150
javavmvendor IBM Corporation
javavmname IBM J9 VM
javaclasspath
javalibrarypath
javaiotmpdir tmp
javacompiler
javaextdirs
osname Linux
osarch i386
osversion 2420-8
pathseparator
PowerTerm WebConnect 34 Getting Started Guide
username root
userhome root
userdir root
System properties names are placed in the configuration file within percent symbols ()
(like macros)
671 Configure the PowerTerm WebConnect Client
1 Open the Config Folder and edit the webconnectxml file Example
ltxml version =rdquo10rdquo encoding=rdquoUTF-8rdquogt
ltsection name=rdquoparametersrdquogt
ltitem key=rdquourlrdquo value=httpadminserverWebConnect56gt
ltitem key=rdquoserverrdquo value=rdquoadmin24000rdquogt
ltitem key=rdquossordquo value=rdquotruerdquogt
ltitem key=rdquodestrdquo value=rdquoCProgram FilesEricomrdquogt
ltsectiongt
2 Save the customized webconnectxml to a Web server folder available to all users It is
recommended to use the same Web server as the PowerTerm WebConnect Agent
Example
ltWebConnect installation foldergtwebwebconnectxml
3 Test the accessibility to this file - Type the URL of webconnectxml in the browser
Example
httpltWebServer IPgtWebConnectwebconnectxml
The contents of the file should be displayed
672 Configure the Preferences File
1 Open the plugins folder and open the PowerTermWebConnectClient_560365jar file
You can use Winzip version 70 and up or in Windows XP ndash Create a new file type for the
jar extension click advanced and select compressed (zipped) folder in the drop down list
Now you can open the JAR files in the Windows Explorer
The default contents of the file
configURL=httpleericomcomWebConnectwebconnectxml
2 Specify the accurate URL of the webconnectxml file Example
httpltWebServer IPgtWebConnectwebconnectxml
3 Save the file and close it The WinZip will display the following dialog
ldquoFile preferencesini has been changed since it was extracted Update archive
with this filerdquo
PowerTerm WebConnect 35 Getting Started Guide
4 Click Yes and close the archive
If you are editing the file from within the explorer you will have to save the file elsewhere
and then drag it to the explorer window where the JAR file is open
68 Installing PowerTerm WebConnect Client on Lotus Expeditor
1 Start the Lotus Expeditor client
2 Select File | Application | Install
3 Select Search for new features to install and click Next
4 Select Add Folder Location and type or select the location of the update site folder from
the provided package Click OK
5 Select the location you have just created and click Finish
6 In the Select the feature to install tree select Powerterm WebConnectUpdate Site Click
Next
7 Select I accept the terms in the license agreements and click Next
8 Click Finish
9 When prompted restart the platform
69 Running PowerTerm WebConnect Client for Lotus Expeditor
1 Click Open The PowerTerm WebConnect option is displayed
2 Select PowerTerm WebConnect The application will automatically connect and start
downloading the components from PowerTerm WebConnect Server
IMPORTANT
If you did not install PowerTerm WebConnect Server and are instead connecting to Ericom
Softwarersquos Demo WebConnect Server then you need to open port 443 in the firewall
691 PowerTerm WebConnect Client Workflow
1 PowerTerm WebConnect client reads the URL of webconnectxml from the preferencesini
file and requests it
2 When the webconnectxml is successfully downloaded the application reads the
configuration connects to the specified Web server downloads the PowerTerm
WebConnect components and connects to the PowerTerm WebConnect Server
3 The user is requested to login to the PowerTerm WebConnect Server For testing you
can use the username Example and password example
This step will be skipped if Single Sign-on is set to ldquotruerdquo
PowerTerm WebConnect 36 Getting Started Guide
4 After logging in to PowerTerm WebConnect Server the userrsquos applications are displayed
as defined by the administrator
5 To run an application select the desired application from the list and click Launch or
double-click the application The application will be launched in a separate window
610 Troubleshooting
When you encounter a problem the first step is to open the log file This file is located on
the client machine in the Ericom folder
Windows
CDocuments and SettingsltusernamegtEricomleclientEricomPluginlog
Linux
ltuser-home-directorygtEricomleclientEricomPluginlog
Following is a guide for diagnosing and fixing the problems in cases of error messages and
additional information
Error
Message
Solution
Version File
reading error
1 Check the lsquourlrsquo parameter in the webconnectxml file on the Web
server The value should be
httpltWebServerIPgtWebConnect
2 Try to run the following URL on the browser
Windows
httpltWebServerIPgtWebConnectwindowsptagentvertxt
Linux
httpltWebServerIPgtWebConnectlinuxix86qterm-
wcvertxt
The file contents displayed in the browser window should be in
the following form
560-rel14546
PowerTerm WebConnect Application Zone
560 - Main Release
ltrootgtPowerTerm WebConnect 56ltWebServergt
If the version file contents are not as shown check
- Is the Web Server running
- Are PowerTerm WebConnect Web Components and version files
PowerTerm WebConnect 37 Getting Started Guide
in place
3 On the Web server check ltPowerTerm WebConnect
rootgtwebwindowsptagentvertxt If the contents ldquolook wrongrdquo or
not in the proper form reinstall the PowerTerm WebConnect Web
components
4 On the client machine open the aforementioned URL in the
browser The file content should appear in the browser If it does
not it could be that the Web server is down
Web Server is
shut down
The webconnectxml configuration file must be located on the Web
server The explicit URL to this file is defined in the preferencesini
file (see Configure the Preferences File)
The error message contains the IP address of the Web server
Verify that the Web server on this machine is running
Version file
does not exist
on ltURLgt
See Version File reading error
The
configuration
file is not
accessible or
has a wrong
format
The webconnectxml configuration file must be located on the Web
server and the explicit URL to the configuration must be defined in
the preferencesini file (see Configure the Preferences File)
Try to open the URL specified in the error message in the
browser If it does not open then it either does not exist or it has
a wrong format
Preferences
file does not
exist in the
application
bundle
The preferencesini file containing the URL to the configuration
file was removed from the update site folder
Uninstall the current PowerTerm WebConnect client from the
client machine Create a new customized package (see
PowerTerm WebConnect Client Configuration) and reinstall it
Configuration
file URL is not
defined in
preference
file
The URL to the configuration file does not appear in the
preferencesini file (see Configure the Preferences File)
Uninstall the current PowerTerm WebConnect client from the
client machine Create a new customized package (see
PowerTerm WebConnect Client Configuration) and reinstall it
No IP address
could be
found for the
host
The Web server URL specified in the preferencesini file (see
Configure the Preferences File) or in the webconnectxml file (see
Configure the PowerTerm WebConnect Client) is an unknown
host
If the mistake is in the preferencesini file uninstall the current
PowerTerm WebConnect client from the client machine Create a
new customized package (see PowerTerm WebConnect Client
Configuration) and reinstall it
PowerTerm WebConnect 38 Getting Started Guide
If the mistake is in the webconnectxml file correct the file reopen
the Lotus Expeditor client
Cannot write
to destination
The temporary file cannot be written to the defined destination
Check the write permissions
Copied
configuration
file has wrong
format
The webconnectxml file as received from the specified URL has a
wrong format Correct the file and try again
PowerTerm
WebConnect
Agent URL is
malformed
The PowerTerm WebConnect Agent URL specified in the
webconnectxml file (see Configure the PowerTerm WebConnect
Client) does not have a proper HTTP format Correct the file and
try again
PowerTerm
WebConnect
Agent URL is
not defined
The PowerTerm WebConnect Agent URL parameter is not specified
in the webconnectxml file (see Configure the PowerTerm
WebConnect Client)
Correct the file and try again
The specified
destination
folder name
is wrong
The destination folder name contains illegal characters
ltgt|
Check the dst parameter in the webconnectxml file Correct the
file and try again
You do not
have
permissions
to write to
ltpathgt
The PowerTerm WebConnect Agent cannot be written to the
destination as defined Check the write permissions
The default destination defined in the version file should not to
be changed
A customized destination for PowerTerm WebConnect Agent
downloading can be defined in the webconnectxml file (See
Configure the PowerTerm WebConnect Client)
Check the destination value correct and try again
PowerTerm WebConnect 39 Getting Started Guide
About Ericom
Ericomreg Software is a leading provider of Application Access and Virtualization Solutions
Since 1993 Ericom has been helping users access enterprise mission-critical applications
running on a broad range of Microsoftreg Windowsreg Terminal Servers virtual Desktops
Blade PCs legacy hosts and other systems Ericom provides concrete business value by
helping organizations realize the benefits of their IT investments With offices in the United
States United Kingdom EMEA India and China Ericom also has an extensive network of
distributors and partners throughout North America Europe Asia and the Far East Our
expanding customer base is more than 30 thousand strong with over 7 million
installations
For more information on our products and services contact us at the location nearest to you
And visit our web site httpwwwericomcom
North America Western Europe International
Ericom Software Inc Ericom Software (UK) Ltd Ericom Software Ltd
231 Herbert Avenue Bldg 4 11a Victoria Square 8 Hamarpeh Street
Closter NJ 07624 USA Droitwich Worcestershire Har Hotzvim Technology Park
Tel +1 (201) 767 2210 WR9 8DE United Kingdom Jerusalem 91450 Israel
Fax +1 (201) 767 2205 Tel +44 (0) 845 644 3597 Tel +972 (2) 591 1700
Toll-free 1 (888) 769 7876 Fax +44 (0) 845 644 3598 Fax +972 (2) 571 4737
Email infoericomcom Email infoericomcouk Email infoericomcom
PowerTerm WebConnect 7 Getting Started Guide
True Seamless Windows for published applications remote application browsing
and publishing and Application Load Balancing
bull PowerTerm WebConnect Portlet for JSR 168 Portals
Install this component if you plan to access Windows published applications and
Legacy hosts from within JSR 168 compatible portal environments such as IBM
Workplace or WebSphere Oracle Portal Vignette Portal and the like
bull PowerTerm WebConnect Plugin for IBM Lotus Expeditor
Install this plugin if you plan to access Windows published applications and Legacy
Hosts from within the IBM Lotus Expeditor environment
bull PowerTerm WebConnect DeskView
This component makes it possible to publish Desktops and applications that run on
Virtual Machines and physical machines
The evaluation package of PowerTerm WebConnect that you can download and
install contains the PowerTerm WebConnect Enterprise product with all its
components Once activated the product will only include the components and
features of the specific PowerTerm WebConnect product you purchased
PowerTerm WebConnect 8 Getting Started Guide
2 Installing and Starting PowerTerm WebConnect
PowerTerm WebConnect includes both server-side and client-side components The server
side includes
bull PowerTerm WebConnect Server
bull PowerTerm WebConnect DeskView Server
bull PowerTerm WebConnect Load Balancer
bull PowerTerm WebConnect Administration tools (for WebConnect Server PowerTerm
Load Balancer and DeskView Server)
The client side has numerous clients such as
bull RemoteView
bull HostView (for both Windows and Linux)
bull QuickVNC etc
21 Install PowerTerm WebConnect (Windows edition)
1 Run the installation file typically named PowerTermWebConnect5xexe You will find
the file on the installation CD or you can download it from Ericoms website
2 Click Install and then enter your Serial Number or click Evaluate when prompted
3 Continue with installation and select Full Installation Server Administration Tool and
WebServer Components (default) in the Setup Type dialog
4 Complete the installation and click Exit and run PowerTerm WebConnect in the last
dialog of the installation Depending on your computer this may take a few minutes
The first time you launch the PowerTerm WebConnect server it will generate a
Diffie-Hellman key for SSL encryption This process may take several minutes
depending on the speed of your computer A visual progress indicator will show
you when this process is completed While this process is taking place PowerTerm
WebConnect clients will not be able to connect to the server
22 StartStopRestart PowerTerm WebConnect Server (Windows edition)
PowerTerm WebConnect server is installed as a Windows service
1 Launch the standard Services console from the Windows Control Panel On some
computers it may be located under the Administrative Tools group You can also run
the command SERVICESMSC The Services window is displayed
PowerTerm WebConnect 9 Getting Started Guide
2 Select PowerTerm WebConnect Server 5x service (the primary service of PowerTerm
WebConnect) where x is the version number and use standard StartStopRestart
options
The PowerTerm WebConnect Server Starter 5x service (the secondary service of
PowerTerm WebConnect) is designated for restarting the primary service in
cases of failure or any unexpected problems The secondary service is
controlled by internal logic of PowerTerm WebConnect and cannot be stopped
from the Services console
23 Install Run and Stop PowerTerm WebConnect Server (Linux edition)
Transfer the installation file to your Linux server and install the PowerTerm WebConnect
components in the RPM package using the following shell command
rpm ndashi WebConnecct-5x-0i586rpm
(lsquoxrsquo is the version number)
The PowerTerm WebConnect server will be installed to
optWebConnect5x
All PowerTerm WebConnect clients including PowerTerm WebConnect
Administration Tool are published via the Web server Therefore you need to
manually configure the Web server to publish the path optWebConnect56web
The name of the virtual directory has to be WebConnect5x
After configuring the virtual directory you can launch any client from httpltservernamegtWebConnect5xClientURLshtml
Users of Red Hat 72
If you installed the PowerTerm WebConnect server on Red Hat 72 you also have to install
the file libgcc-304-1i386rpm (44Kb) in order for PowerTerm WebConnect Server to run
This file can be downloaded from
ftprpmfindnetlinuxredhatupdates72enosi386libgcc-304-1i386rpm The file is
also available on the installation CD and can as well be downloaded from the ldquoEvaluate
PowerTerm WebConnect Linux x86 Editionrdquo web page
Use the following commands to run the PowerTerm WebConnect server
On RedHat
sbinservice webconnectd start
On Suse
etcrcdwebconnectd start
Use the following commands to stop the PowerTerm WebConnect server
On RedHat
sbinservice webconnectd stop
PowerTerm WebConnect 10 Getting Started Guide
On Suse
etcrcdwebconnectd stop
24 Install the Terminal Server Agent
PowerTerm WebConnect Terminal Server Agent must be installed on a Terminal Server
accessed using PowerTerm WebConnect It provides the True Seamless Windows
functionality for published applications remote browsing and publishing and Application
Load Balancing
The PowerTerm WebConnect Terminal Server Agent must be installed on every Terminal
Server in the cluster If you install the PowerTerm WebConnect server itself on a Terminal
Server you will be given the option to install the Terminal Server Agent as a part of the
server installation Alternatively use the PowerTermTerminalServerAgentexe file located in
the AddOnsTerminalServerAgent subdirectory under the PowerTerm WebConnect server
installation directory
To complete the installation you might need to restart the Terminal Server machine
25 Install PowerTerm WebConnect DeskView Server
PowerTerm WebConnect DeskView is automatically installed when you run PowerTerm
WebConnect Installation wizard ndash Full installation To run PowerTerm WebConnect
DeskView Server you also need Microsoft NET Framework v30 to be installed on your
computer If you do not have it installed then the installation wizard will place the
DeskViewServerSetupmsi and DeskViewAdminSetupmsi files in the AddOns folder
(ltPowerTerm WebConnect Installation FoldergtWebConnect 5xAddOnsDeskView
VDI) from where you can run the msi files at a later stage to install PowerTerm
WebConnect DeskView
26 Start the PowerTerm WebConnect Administration Tool
There are several ways to launch the PowerTerm WebConnect Administration Tool Select
the one most convenient for you
bull From Windows Start menu select Programs | Ericom Software | PowerTerm WebConnect
5x | PowerTerm WebConnect Administration Tool
If you changed the Program Folder during installation the Start menu path
may vary
bull Double-click PtAdminexe PtAdminexe is located in the bin directory of the
PowerTerm WebConnect installation folder
bull Rather than installing you can choose to download the Administration Tool to any
Windows computer Please refer to the PowerTerm WebConnect Sample URLs
page (httpltweb_servergtWebConnect5xClientURLshtml) for more details
A few things to remember
PowerTerm WebConnect 11 Getting Started Guide
When you launch the PowerTerm WebConnect Administration Tool for the first time the Connection dialog is displayed with the user Administrator No
password is required to enter just click Connect
In the Connection dialog (displayed when launching the Administration Tool) the
Host Name is localhost by default This is correct only if the Administration Tool
runs on the same machine as the server If the Administration Tool runs on a different machine you need to change the Host Name to the IP addressHostname
of the PowerTerm WebConnect server
When using the PowerTerm WebConnect Windows edition by default the
Administration Tool will deny any connection attempts from any computer other
than the local machine
PowerTerm WebConnect 12 Getting Started Guide
3 PowerTerm WebConnect Administration Tool at a Glance
PowerTerm WebConnect Administration Tool manages published applications user sessions
and server configuration The administrator can perform operations such as multiple
application publishing sending messages to logged-on users shutting down sessions and
monitor user activity
To perform the tasks described in this chapter you must launch the Administration Tool via one of the methods detailed in chapter Start the PowerTerm
WebConnect Administration Tool
Launching the Administration Tool from the system tray or using the
Administration Tool launched after completed installation will not allow you to
activate certain features
After you launched the Administration Tool and connected to the server you will receive a
Welcome screen where you select desired activity
bull Publish Multiple Applications opens the Publish Multiple Applications wizard
bull Configure Load Balancer opens PowerTerm Load Balancer Administration Tool
bull Create a Host Connection opens the Add Connection dialog
bull Configure Active Directory opens the Directory Services dialog
PowerTerm WebConnect 13 Getting Started Guide
Close the Welcome screen to enter the Administration Tool main
screen
The Administration Tool main screen has three sections
bull User section lists all users defined in the server
bull Group section lists all groups defined in the server
bull Connection section lists all connections and published applications defined in the
server
By default only the Connection section is displayed when you first open Administration Tool
There are three predefined example-connections ldquoExample_As400rdquo ldquoExample_VTrdquo and
ldquolocalhostrdquo You can test them prior to defining your own
1 Right click the connection you want to test and select Test The PowerTerm
WebConnect HostView Login dialog appears
2 Type example for User Name and example for Password
Credential fields are case sensitive
3 Click Login The desired connection with its pre-programmed demo application is
launched
PowerTerm WebConnect 14 Getting Started Guide
31 Publishing Applications and Documents
In order to enable access to applications and documents on Windows Terminal Servers
publish these applications and documents from the Administration Tool When publishing
applications and content you can specify which servers will be used in a Terminal Server
cluster and which users and groups will have access to these services Once you have
published such applications and documents the RemoteView client can be used to access
them
If you need to provide access to multiple applications on a Terminal Server use the Multiple Application Publishing wizard to significantly reduce the time and
effort required to publish these applications
To publish multiple Windows applications
1 Click Publish Multiple Applications in the Welcome screen The Choose Terminal Server
for Browsing dialog appears
2 Provide the address of the Terminal Server which will be used for browsing and click OK The Application Publisher Step 1 dialog appears This dialog lists all the
applications available in the specified serverrsquos Start menu
3 Select those applications found in the Programs folder of the designated server that you want to publish and click Next The Application Publisher Step 2 dialog appears
4 Determine the destination of your publishing and click Next The Application Publisher
Step 3 dialog appears
5 Determine the Color Quality of your published application
6 Determine the start mode in which you want to run the published application - normal maximized or minimized - and click Next The Application Publisher Step 4
dialog appears
7 Choose the connection speed that matches your infrastructure The connection speed
setting determines the value of three visual effects settings You can also override
these settings specifically
8 Determine whether you prefer the window to display their content while being
dragged or just the outline By default the same setting is used as the client desktop
9 Click Next The Application Publisher Step 5 dialog appears
10 Specify where sounds are to be played ndash locally or remotely
11 Determine which local devices the remote session will have access to (local drivers printer etc) and click Next The Application Publisher Step 6 dialog appears
12 If you have the PowerTerm Load Balancer installed Use all Servers (default) allows the application to run on any Terminal Server in the
cluster This setting is appropriate when the application is installed on all the Terminal
Servers Alternatively you select specific Terminal Servers on which to run this
application
If you have not installed the PowerTerm Load Balancer you will need to explicitly
specify the address of the Terminal Server on which the application will be run
PowerTerm WebConnect 15 Getting Started Guide
13 Click Next The Application Publisher Step 7 dialog appears
14 Select the users groups or OUs to which you wish to publish the applications and click Next The Application Publisher Step 8 dialog appears By default applications will
be published to everybody
15 Click Advanced Settings to modify settings such as the login credentials to the
Terminal Servers By default PowerTerm WebConnect credentials will be passed
through to the Terminal Server
16 Click Finish The published applications appears in the Connection List
Right-click and select Properties or double click on the published application in the
Connections list to view and modify any of the settings which you previously
defined
To publish a remote Desktop
1 Select Action | New | Remote Desktop The Application Publisher Step 1 dialog appears
2 Type the Display Name which will be the name presented to the end-users and click
Next The Application Publisher Step 2 dialog appears
3 Specify where icons for the published desktop will be displayed to the end-user in Publish to
4 Click Choose Icon to replace the desktoprsquos default icon Select the desired icon from
the list that appears
5 Click Next The Application Publisher Step 3 dialog appears
6 Determine Screen Size and the Color Quality of the published desktop
7 If desirable select Show Connection Bar in Full Screen Mode
8 Click Next The Application Publisher Step 4 dialog appears
9 Choose the connection speed that matches your infrastructure The connection speed
setting determines the value of three visual effects settings You can also override
these settings specifically
10 Click Next The Application Publisher Step 5 dialog appears
11 Specify where sounds are to be played ndash locally or remotely Where to Apply Window
Key Combinations and which local devices you want to automatically connect to when
logged on to the remote computer
12 Click Next The Application Publisher Step 6 dialog appears
13 Specify the Server Address and Port Number of the Terminal Server that weill provide
the desktop and click Next The Application Publisher Step 7 dialog appears
14 Select the users groups or OUs to which you wish to publish the desktop and click Next The Application Publisher Step 8 dialog appears
Select the Server group to allow all users to access the published application
15 Click Advanced Settings to modify settings such as the login credentials to the
Terminal Servers By default PowerTerm WebConnect credentials will be used
PowerTerm WebConnect 16 Getting Started Guide
16 Click Finish The published application appears in the Connection List
Right-click Properties or double click on the published application in the
Connections list to modify any of the settings which you previously defined
32 Create Terminal Emulation Connections
To provide access to legacy host systems you will need to create Terminal Emulation
connections For each such connection you can specify the host address emulation type
login script and more Once you have created these connections users will be able to
launch them using HostView (Windows or Linux) WebView or the Java client as
appropriate
1 Click Create a Host Connection in the Welcome screen The Add Connection dialog
appears
2 Enter a Name for the new connection
3 Specify an Owner for the new connection The possibilities are
[None] the connection will not be allowed to run by anyone and it will not be
displayed in any Connection list Server the connection will be accessible for all users of this PowerTerm
WebConnect server A specific group the connection will be accessible for all users of the specified
group A specific user the connection will be accessible for a specified user only
4 Leave category Terminal Emulation selected
5 Select Terminal Type Terminal Model and Communication Type as needed
6 Specify the Host Name or IP address of your host
7 Specify other parameters as needed
8 Select the Security Type as needed if your host supports SSL or SSH and specify
the appropriate details in the Details dialog
9 Use the Settings Key Mapping and Power Pad options to further customize the
connection
10 Click OK and the connection is created
33 Test Connections
It is recommended to test published applications or host connections before they are made
available to end-users
To test a connection
bull Right-click the target connection from the Connection section of the main screen and
select Test
Alternatively
PowerTerm WebConnect 17 Getting Started Guide
1 Select Tools | Run ltdesired clientgt The Login to WebConnect dialog appears
2 Enter the User Name and Password for the individual who owns the connection that
you want to test and click Login The desired PowerTerm WebConnect client is started
and the Connect dialog appears
3 Select the desired connection and click Connect The test is executed
34 Launch the Application Zone or the Application Portal
Users can access the published applications from the Application Zone application launcher
or from the Application Portal web interface
To use the Application Zone go to Start menuProgramsEricom SoftwarePowerTerm
WebConnect 5x and select Client URLs Alternatively type the following URL into your Web
browserrsquos address bar httpltserver addressgtWebConnect5xClientURLshtml In the
page that opens click on the Run button next to the Application Zone to launch it
To use the Application Portal go to Start menuProgramsEricom SoftwarePowerTerm
WebConnect 5x and select it Alternatively type the following URL into the Web browserrsquos
address bar httpltserver addressgtWebConenct5xportalwindowsindexasp
35 Monitor a Users Sessions
From the Administration Tool you can monitor the users sessions and may intervene if
necessary This intervention may result in your input appearing on the users screen The
user receives a notification when an administrator begins and ends monitoring the session
1 Select View | Client Sessions or click to see all the active client sessions
2 Select the desired active session and right-click Attach The Password Verify dialog
appears
3 Enter your password and click OK Some notification dialogs appears and the selected
PowerTerm WebConnect session is viewed
36 View Intruders
bull The Intruders window shows suspected attempts at breaching security After several
suspected intrusion attempts users are blocked temporarily
bull In addition to showing suspected intrusion attempts the Intruders window allows
you to remove restrictions on users
bull Select View | All Intruders or click
PowerTerm WebConnect 18 Getting Started Guide
4 Accessing Virtual Desktops and Blade PCs with PowerTerm WebConnect
This chapter provides instructions on configuring PowerTerm WebConnect for Virtual
Desktop Infrastructure (VDI)
41 Step 1 Launch DeskView Administration Tool
Verify that PowerTerm WebConnect is installed on your server and launch PowerTerm
WebConnect Admin Tool
bull Select Tools | Open VDI Manager The PowerTerm WebConnect DeskView Administration
Tool opens
The first time you launch the DeskView Administration Tool you will be prompted to install
the tool
PowerTerm WebConnect 19 Getting Started Guide
Microsoft Management Console 30 is required for PowerTerm WebConnect DeskView
Administration Tool If you do not have this installed you will also automatically be
prompted to install this update
Follow the installation processes when you are prompted for either install PowerTerm
WebConnect DeskView Administration Tool will automatically launch when these
installations are completed
42 Step 2 Add a Host
1 Right-click Virtualization Hosts and select Add Host The Add a New Host wizard
opens Click Next
2 Enter a Host Name as you would like it to appear in PowerTerm WebConnect
DeskView Administration Tool and a description (optional) Click Next
3 Specify the Virtualization Server type and click Next
4 Specify the connection information and click Next
VMWare Virtual Center v1x and 2x
Specify the HTTPS Web Service address and a UsernamePassword that can access
the host
VMWare Virtual Server 2005
Click Start and then Run
Type ldquoservicesmscrdquo and click OK
Scroll down to PowerTerm WebConnect DeskView Server service and open
Properties
Change the Login Account for the service to match the Domain Administrator
account and password used when setting up Microsoft Virtual Server 2005 and
restart the service Enter the IP or NETBIOS name of the Microsoft Virtual Server 2005 server as the
Server Address in the Connection Broker Wizard
Xen Server
Specify the hypervisor IP address or NETBIOS name the Root UsernamePassword
to the hypervisor and the Service port (default 80)
Oracle VM
Specify the Serverrsquos agent URL and Port (default 8899) for example
httpsltservernamegt8899
Specify the Oracle VM hypervisorrsquos Oracle Agent UsernamePassword (default
username oracle)
5 Click Finish to add the new Host
To configure Virtual Machines for use install the Ericom Tools (vmagentmsi) on each of the
virtual machines on the new host for PowerTerm WebConnect DeskView to recognize them
The vmagentmsi installer is located on the PowerTerm WebConnect server in ltPowerTerm
WebConnect installation foldergtAddOnsDeskView VDI folder (default installation
PowerTerm WebConnect 20 Getting Started Guide
folder is xProgram FilesEricom SoftwareWebConnect 56) During installation you
will need to enter the DeskView IP address or NETBIOS name
If you are using Microsoft Virtual Server 2005 as your Virtualization Host use the
IP address of the DeskView server only when installing the Ericom Tool package
43 Step 3 Create a Pool
Pools are used to organize Virtual Machines (VM) into logical groups This enables
organizations to combine and order resources from multiple systems into one entity To
access available resources end-users simply connect to PowerTerm WebConnect to access
any configured resource
1 Right-click Pools and select Create Pool The Create a Pool wizard opens Click
Next
2 Enter a Pool name as you wish it to appear and a description (optional) and click
Next
3 Specify the Pool type and click Next
4 Specify the Assignment type and click Next
Permanently will cause a virtual machine to affix to the user who has launched
that virtual machine For the duration of the session will cause any virtual machine that is not in use to
be returned to the pool for any user to launch
5 Specify the LogoffDisconnect event and click Next
Select what you would like to happen after a user logs off from a virtual machine
in this pool
Select what you would like to happen when a user is disconnected from a virtual
machine in this pool
6 Click Finish to add the new Pool
You will need to assign virtual machines from your virtualization hosts to your created pool
1 Right-click the pool and select Assign Machines The Assign Machines to ltyour
pool namegt dialog opens
2 Highlight the desired virtual machine(s) and click Select Click OK
44 Step 4 Publish an ApplicationDesktop
1 Return to PowerTerm WebConnect Admin Tool to publish DeskView pools
2 Determine whether to publish a full desktop or a seamless application running
from a virtual desktop
For a full desktop
Select Action | New | Remote Windows Desktop
For a seamless application
Select Action | New | Windows Application
PowerTerm WebConnect 21 Getting Started Guide
3 Select Virtual Desktop in the first step of the wizard and click Next
4 Follow the wizardrsquos instructions until you reach the Virtual Desktops step
5 Select a pool that you previously created and that you would like this connection to choose virtual machines from Click Next
6 Continue and complete the reminder of the wizardrsquos steps
Once the resource is published users who have been assigned access will be able to use it
immediately
PowerTerm WebConnect 22 Getting Started Guide
5 Download and Run PowerTerm WebConnect Clients
PowerTerm WebConnect clients are automatically downloaded and installed onto the client
devices For detailed information and samples please refer to the PowerTerm WebConnect
Sample URLs page To see this page navigate your browser to
httpltweb_servergtWebConnect5xClientURLshtml
PowerTerm WebConnect 23 Getting Started Guide
6 PowerTerm WebConnect Client for Lotus Expeditor
61 Installation Package
PowerTerm WebConnect client for Lotus Expeditor is provided to IBM in an Update Site
package This is a ZIP archive containing the Update Site with the Eclipse feature and plug-
in that comprises the PowerTerm WebConnect client
Extract the ZIP file keeping the foldersrsquo structure intact
NOTE In Winzip verify that the ldquoUse folder namesrdquo option is set to TRUE
Package structure
Update Site
- plugins
- PowerTermWebConnectClient_560365jar
- features
- comericomWebConnect_560365jar
- sitexml
config
- webconnectxml
Definitions
bull webconnectxml PowerTerm WebConnect client configuration file
bull comericomWebConnect_560365jar PowerTerm WebConnect client feature file
bull PowerTermWebConnectClient_560365jar PowerTerm WebConnect client plugin file
62 Pre-installation steps
PowerTerm WebConnect client for Lotus Expeditor does not run independently but in
conjunction with PowerTerm WebConnect Server You can either install it and define your
users groups and applications or use Ericom Softwarersquos Demo PowerTerm WebConnect
Server
bull If you decide to install PowerTerm WebConnect Server you will need the full
installation ie the PowerTerm WebConnect Server and the Web components If you
do not have the installation CD you can download and install a trial version from
wwwericomcom
PowerTerm WebConnect 24 Getting Started Guide
bull If you decide to use Ericom Softwarersquos Demo PowerTerm WebConnect Server then
skip to the chapter Installing PowerTerm WebConnect Client on Lotus Expeditor
63 Install PowerTerm WebConnect Portlet on IBM Workplace server (for Windows OS)
Step 1 Install PowerTerm WebConnect Server
If PowerTerm WebConnect Server and IBM Workplace Server are on separate machines
bull Configure PowerTerm WebConnect Server
Launch PowerTerm WebConnect Administration Tool
Open Files | Configuration | Main
In the [Portal] section edit
Machines=localhostltIBM sever machinegt
bull Configure PowerTerm WebConnect Web components
Copy the ldquowebrdquo folder from the PowerTerm WebConnect server installation to the
IBM Workplace server machine
Create an Alias or a Virtual directory to it named WebConnect on the Web
server providing access to it for the users This is in order to enable the users to
download the necessary files to run their applications
Step 2 Enable JSR portlets
1 On IBM Workplace Server go to ltPortalServergtsharedappconfigservicesConfigServiceproperties
2 Edit portalenablejsr168=true
3 Save and close the file
Step 3 Enable SSO
1 On IBM Workplace Server go to ltPortalServergtsharedappconfigservicesLoaderServiceproperties
2 Edit commandpath=comericomportalcommandscomibmwpsenginecommands
3 Save and close the file
Step 4 Copy Files
The following files need to be copied from WebConnect ServerAddOnsIBM
WorkplacePortlet folder to IBM Workplace Server
File name to copy Destination folder
OpenSSLdll ltAppServergtjavajrebin
IbmPortaldll ltAppServergtjavajrebin
IbmPortalini ltAppServergtjavajrebin
PowerTerm WebConnect 25 Getting Started Guide
WebConnectPortaljar ltAppServergtlib
EricomLoginjar ltPortalServergtsharedapp
Step 5 Portlet Configuration
1 On IBM Workplace Server go to ltAppServergtjavajrebinIbmPortalini
2 You can modify the following parameters in the [Server=WebConnect] section webserverport=ltIBM web server portgt
Specifies the Web server port for accessing the PowerTerm WebConnect clients folder
Default 80 Address
Specifies the address of the PowerTerm WebConnect Server machine for Portlet to
connect to when PowerTerm WebConnect Server is located on a different machine
than the IBM Workplace Server CustomAddress
Specifies the addresss of the PowerTerm WebConnect Server machine for Clients to connect to If CustomAddress is the same as Address then this may be omitted webserveraddr
Specifies the address of the Web Server machine when it is located on a different
machine than the IBM Workplace Server
3 Restart the IBM server ltPortalServergtrootscriptsstopWorkplaceServicesbat ltPortalServergtrootscriptsstartWorkplaceServicesbat
This procedure may take about 20 minutes
Step 6 Install the Portlet
1 In a Web browser open the URL httpltIBM Workplace
Servergt9081lwpmyworkplace to open the IBM Workplace Portal
2 Login as administrator
3 Go to Administration | Portlets | Install
4 Browse to the PowerTerm WebConnectwar file located on PowerTerm WebConnect
Server and click Next
5 Click Install
Step 7 Create an Application page
1 Login to the Workplace
2 Go to Portal User Interface | Manage Pages
3 Search for My Work
4 Click the My Work link and select New Page
5 Name the page PowerTerm WebConnect and click OK
6 Click OK again You will see the created page on the list
7 Click the pencil icon on the new page and select the 1 square layout
PowerTerm WebConnect 26 Getting Started Guide
8 Click Add Portlet and search for PowerTerm WebConnect
9 Select it and click OK
10 Click Done
11 Click My work at the top of the page PowerTerm WebConnect is displayed on the list
Step 8 Run the Portlet
1 Restart IBM Workplace Server
2 Open IBM Workplace Portal in a browser httpltportal servergtlwpmyworkplace
3 Login to IBM Workplace Server
4 Click My work PowerTerm WebConnect portlet is displayed
5 Launch it The Userrsquos applications as defined on PowerTerm WebConnect Server
appear
6 Click an application to launch it
64 Install PowerTerm WebConnect Portlet on IBM Workplace server (for Linux OS)
Step 1 Enable JSR 168 portlets
1 Go to optIBMWorkplacePortalServersharedappconfigservicesConfigServiceproperties
2 Modify the portalenablejsr168 property to ldquotruerdquo
3 Restart the server cd optIBMWorkplacePortalServerrootscripts
Run stopWorkplaceServicessh
Run startWorkplaceServicessh
This procedure can take up to 20 minutes
4 Log on to the workplace server at httpltworkplace servergt9081lwpmyworkplace using
the administrators username and password
Step 2 Install the portlet
1 Restart IBM Workplace Server
2 In a Web browser open the URL httpltworkplace server IPgtlwpmyworkplace
3 Login to IBM Workplace Server as an administrator
4 Go to Administration | Portlets | Install
5 Browse to the PowerTerm WebConnectwar file located on PowerTerm WebConnect
Server and click Next
6 Click Install
PowerTerm WebConnect 27 Getting Started Guide
Step 3 Install the Application page
1 Login to the workplace as administrator
2 Go to Administration | Portal User Interface | Manage Pages
3 Search for My Work
4 Click the My Work link and select New Page
5 Name the page PowerTerm WebConnect and click OK
6 Click OK again You will see the created page on the list
7 Click the pencil icon and select the 1-square layout
8 Click Add Portlet and search for PowerTerm WebConnect
9 Select it and click OK
10 Click Done
11 Click My work on top and PowerTerm WebConnect is displayed on the left bar
Step 4 Run the portlet
1 Restart IBM Workplace Server
2 Open IBM Workplace Portal in a browser httpltportal servergtlwpmyworkplace
3 Login to IBM Workplace Server
4 Click My work PowerTerm WebConnect portlet is displayed
5 Launch it The Userrsquos applications as defined on PowerTerm WebConnect Server
appear
6 Click an application to launch it
65 Install PowerTerm WebConnect Portlet on IBM WebSphere 61 server (for Windows OS)
Step 1 Install PowerTerm WebConnect Server
You have to configure PowerTerm WebConnect Server if it and the IBM WebSphere Server
are on separate machines
1 Launch PowerTerm WebConnect Administration Tool
2 Open Files | Configuration | Main
3 In the [Portal] section edit Machines=localhostltIBM sever machinegt
Step 2 Copy Files
The following files need to be copied from WebConnect ServerAddOnsIBM
WebSpherePortlet folder to IBM WebSphere Server
PowerTerm WebConnect 28 Getting Started Guide
File name to copy Destination folder
OpenSSLdll ltAppServergtjavajrebin
IbmPortaldll ltAppServergtjavajrebin
IbmPortalini ltAppServergtjavajrebin
WebConnectPortaljar ltAppServergtlib
Step 3 Portlet Configuration
1 On IBM Workplace Server go to ltAppServergtjavajrebinIbmPortalini
2 You can modify the following parameters in the [Server=WebConnect] section webserverport=ltIBM web server portgt
Specifies the Web server port for accessing the PowerTerm WebConnect clients folder
Default 80 Address
Specifies the address of the PowerTerm WebConnect Server machine for Portlet to
connect to when PowerTerm WebConnect Server is located on a different machine
than the IBM Workplace Server CustomAddress
Specifies the addresss of the PowerTerm WebConnect Server machine for Clients to connect to If CustomAddress is the same as Address then this may be omitted webserveraddr
Specifies the address of the Web Server machine when it is located on a different
machine than the IBM Workplace Server
3 Restart the IBM server ltAppServergtProfilesAppServer01binstopServerbat ltAppServergtProfilesAppServer01binstartServerbat
This procedure may take about 20 minutes
Step 4 Install the Portlet and create an Application page
1 In a Web browser open the URL httpltIBM WebSphere Servergt9060ibmconsole
to open the IBM WebSphere Portal
2 Login and go to Applications | Install New Application
3 Browse to the PowerTerm WebConnectwar file located on PowerTerm WebConnect
Server
4 Enter Context root and click Next The Select installation options dialog appears
5 Optional change options to your preference or keep the default
6 Click Next
7 Select Ericom in the Module column click Apply and then Next
8 Click Finish and then Save
9 Select Applications | Enterprise Applications
10 Select PowerTerm WebConnectwar checkbox and click Start
PowerTerm WebConnect 29 Getting Started Guide
11 Enter in the Web browser the URL httpltIBM WebSphere
Servergt9080ltContext rootgtEricom portlet The Login dialog appears
12 Login and you will see PowerTerm WebConnect displayed on the list
Step 5 Run the Portlet
1 Restart IBM WebSphere Server
2 Open IBM WebSphere Portal in a browser httpltportal servergt9080ltContext
rootgtEricom portlet
3 Login to IBM WebSphere Server
4 Launch it The Userrsquos applications as defined on PowerTerm WebConnect Server
appear
5 Click an application to launch it
66 PowerTerm WebConnect Server Configuration
bull To enable the Lotus Expeditor to run the PowerTerm WebConnect client the
System Administrator must provide the users with accounts on PowerTerm
WebConnect Server (see the PowerTerm WebConnect Administratorrsquos Manual for
instructions on how to create users groups and connections on the PowerTerm
WebConnect Server)
bull To enable PowerTerm WebConnectrsquos Single Sign-On feature the System
Administrator must create a PowerTerm WebConnect user with the same
username and password as used for the Lotus Expeditor For a managed Lotus
Expeditor the credentials used are the username and password sent to the
managing server For an unmanaged Lotus Expeditor the operation system
username and the Lotus Expeditor password are used as credentials
NOTE If a password is not defined then the Single Sign-On will fail and the user will be
prompted with a login dialog
67 PowerTerm WebConnect Client Configuration
The PowerTerm WebConnect client is configured in webconnectxml located in the config
folder webconnectxml parameters are
url The PowerTerm WebConnect Agent url
server The PowerTerm WebConnect Server address
sso The Single Sign-On feature
dst The local destination for downloading PowerTerm WebConnect
components
PowerTerm WebConnect 30 Getting Started Guide
url
PowerTerm WebConnect components are installed on a Web server Their default url is
Windows Agent
httpltWebServer IPgtWebConnectwindowsptagentcab
Linux Agent
httpltWebServer IPgtWebConnectlinuxix86qterm-wczip
The url parameter must include the first part of the url (which is identical for both Windows
and Linux agents)
The PowerTerm WebConnect client will automatically append the appropriate suffix in
order to create a full accurate url
Example
ltitem key=rdquourlrdquo value=httpadminserverWebConnectgt
server
The computer name or IP address of the PowerTerm WebConnect Server machine
The PowerTerm WebConnect client will log in to this PowerTerm WebConnect Server
display the applications defined on it and run them according to this serverrsquos configuration
Format ltserver IPgt[ltportgt]
where default port is 4000 (can be edited)
Example
ltitem key=rdquoserverrdquo value=rdquoadmin24000rdquogt
sso
Determines whether Single Sign-on will be used to log in to PowerTerm WebConnect
Server Values
bull True (default) the client should automatically log in to the PowerTerm WebConnect
Server using the same credentials as the ones used to log in to the Lotus Expeditor
client
The System Administrator must verify that these credentials can log in to the
PowerTerm WebConnect Server
bull False the user will be prompted with a login dialog or will log in automatically using
previously saved credentials
Example
ltitem key=rdquossordquo value=rdquotruerdquogt
Autologin mode
PowerTerm WebConnect 31 Getting Started Guide
If sso is set to True the user is not prompted for credentials and the login process to
PowerTerm WebConnect Server is done automatically sending the credentials used for the
Lotus Expeditor unless the Lotus Expeditor does not have a password defined (In the
Lotus Expeditor preferences page | Password| Prompt me for a password at start up checkbox)
However if Single Sign-on is not used there are several options regarding Autologin that
can be defined in the PowerTerm WebConnect Preferences page Options
bull Yes
bull No
bull Interactive
bull First time interactive (default) ndash Simplifies the login process to PowerTerm
WebConnect Server In this mode the first time the user logs in to PowerTerm
WebConnect Server he will be prompted for his credentials with the Login dialog
These credentials will be stored in the machine and from then on the login process to
PowerTerm WebConnect Server will be done automatically
1 Open File | Preferences from the Lotus Expeditor and select PowerTerm WebConnect
2 In the Autologin to WebConnect Server section select First Interactive and click OK
3 Start PowerTerm WebConnect Client for Lotus Expeditor If credentials were entered
at least once then the next time the client will connect to PowerTerm WebConnect
Server without prompting for the user name and password
The Administrator must configure the Agent to do nothing when it exits for the
feature to work this way See PowerTerm WebConnect Administratorrsquos Manual for more information about defining Autologin
bull Allow multiple selection ndash Defines whether the user can launch more than one
application at a time (by using the ltCtrlgt or ltShiftgt button while selecting applications)
dst
Defines the path to download PowerTerm WebConnect components on the client machine
The dst parameter can contain macros which are translated by the PowerTerm WebConnect
Client for Lotus Expeditor during runtime The macros should be placed between percent
symbols () for example WebServer
When such a value is defined the PowerTerm WebConnect Client for Lotus Expeditor
substitutes the entire expression for the macrorsquos value
The PowerTerm WebConnect Client for Lotus Expeditor does not support the use
of environment variables as macros
Macros are not case sensitive
Macros supported by PowerTerm WebConnect Client for Lotus Expeditor
Macro name Description
WebServer The name of the Web server
It is obtained from the PowerTerm WebConnect Agent url
PowerTerm WebConnect 32 Getting Started Guide
parameter
Name The name of the clientrsquos CAB or ZIP file eg ldquoptagentrdquo
Display The clientrsquos display name from the version file
Version The clientrsquos version value It is obtained from the version
file
Root The default root location
Windows ldquoCrdquo
LinuxUnix an empty string
OSDir Windows Windowsrsquo installation directory for example
ldquoCWindowsrdquo
Linux an empty string
OSDrive Windows Windowsrsquo installation drive for example ldquoCrdquo
Linux an empty string
HomePath Windows The HOMEPATH environment variable
Linux The HOME environment variable
Home The Ericom folder in the userrsquos home directory
Windows CDocuments and SettingsltusergtApplication
DataEricom
Linux ltusergtEricom
In addition to the predefined macros listed above the PowerTerm WebConnect client
supports the usage of Java System Properties
Java System Properties available for users on Windows XP SP2
Java System Property Name Value Example
javaversion 150
javavendorurl httpwwwibmcom
javahome CIBMcommonpluginscomibmpvcwctruntim
esj2sewin32x86_150SR2-
20060511rcpeclipsepluginscomibmrcpj2sew
in32x86_150SR2-20060511jre
javavmspecificationversion 10
javavmversion 23
javavmvendor IBM Corporation
javavmname IBM J9 VM
PowerTerm WebConnect 33 Getting Started Guide
javaiotmpdir CDOCUME~1dianaLOCALS~1Temp
javacompiler j9jit23
javaextdirs CIBMcommonpluginscomibmpvcwctruntim
esj2sewin32x86_150SR2-
20060511rcpeclipsepluginscomibmrcpj2sew
in32x86_150SR2-20060511jrelibext
osname Windows XP
osarch x86
osversion 51 build 2600 Service Pack 2
pathseparator
username Jone
userhome CDocuments and SettingsJone
userdir CIBMRSA
usertimezone GMT+0200
System properties available for users on Linux RedHat 9
Java System Property Name Value Example
javaversion 150
javavendorurl httpwwwibmcom
javahome usrjavajre150_07
javavmversion 150
javavmvendor IBM Corporation
javavmname IBM J9 VM
javaclasspath
javalibrarypath
javaiotmpdir tmp
javacompiler
javaextdirs
osname Linux
osarch i386
osversion 2420-8
pathseparator
PowerTerm WebConnect 34 Getting Started Guide
username root
userhome root
userdir root
System properties names are placed in the configuration file within percent symbols ()
(like macros)
671 Configure the PowerTerm WebConnect Client
1 Open the Config Folder and edit the webconnectxml file Example
ltxml version =rdquo10rdquo encoding=rdquoUTF-8rdquogt
ltsection name=rdquoparametersrdquogt
ltitem key=rdquourlrdquo value=httpadminserverWebConnect56gt
ltitem key=rdquoserverrdquo value=rdquoadmin24000rdquogt
ltitem key=rdquossordquo value=rdquotruerdquogt
ltitem key=rdquodestrdquo value=rdquoCProgram FilesEricomrdquogt
ltsectiongt
2 Save the customized webconnectxml to a Web server folder available to all users It is
recommended to use the same Web server as the PowerTerm WebConnect Agent
Example
ltWebConnect installation foldergtwebwebconnectxml
3 Test the accessibility to this file - Type the URL of webconnectxml in the browser
Example
httpltWebServer IPgtWebConnectwebconnectxml
The contents of the file should be displayed
672 Configure the Preferences File
1 Open the plugins folder and open the PowerTermWebConnectClient_560365jar file
You can use Winzip version 70 and up or in Windows XP ndash Create a new file type for the
jar extension click advanced and select compressed (zipped) folder in the drop down list
Now you can open the JAR files in the Windows Explorer
The default contents of the file
configURL=httpleericomcomWebConnectwebconnectxml
2 Specify the accurate URL of the webconnectxml file Example
httpltWebServer IPgtWebConnectwebconnectxml
3 Save the file and close it The WinZip will display the following dialog
ldquoFile preferencesini has been changed since it was extracted Update archive
with this filerdquo
PowerTerm WebConnect 35 Getting Started Guide
4 Click Yes and close the archive
If you are editing the file from within the explorer you will have to save the file elsewhere
and then drag it to the explorer window where the JAR file is open
68 Installing PowerTerm WebConnect Client on Lotus Expeditor
1 Start the Lotus Expeditor client
2 Select File | Application | Install
3 Select Search for new features to install and click Next
4 Select Add Folder Location and type or select the location of the update site folder from
the provided package Click OK
5 Select the location you have just created and click Finish
6 In the Select the feature to install tree select Powerterm WebConnectUpdate Site Click
Next
7 Select I accept the terms in the license agreements and click Next
8 Click Finish
9 When prompted restart the platform
69 Running PowerTerm WebConnect Client for Lotus Expeditor
1 Click Open The PowerTerm WebConnect option is displayed
2 Select PowerTerm WebConnect The application will automatically connect and start
downloading the components from PowerTerm WebConnect Server
IMPORTANT
If you did not install PowerTerm WebConnect Server and are instead connecting to Ericom
Softwarersquos Demo WebConnect Server then you need to open port 443 in the firewall
691 PowerTerm WebConnect Client Workflow
1 PowerTerm WebConnect client reads the URL of webconnectxml from the preferencesini
file and requests it
2 When the webconnectxml is successfully downloaded the application reads the
configuration connects to the specified Web server downloads the PowerTerm
WebConnect components and connects to the PowerTerm WebConnect Server
3 The user is requested to login to the PowerTerm WebConnect Server For testing you
can use the username Example and password example
This step will be skipped if Single Sign-on is set to ldquotruerdquo
PowerTerm WebConnect 36 Getting Started Guide
4 After logging in to PowerTerm WebConnect Server the userrsquos applications are displayed
as defined by the administrator
5 To run an application select the desired application from the list and click Launch or
double-click the application The application will be launched in a separate window
610 Troubleshooting
When you encounter a problem the first step is to open the log file This file is located on
the client machine in the Ericom folder
Windows
CDocuments and SettingsltusernamegtEricomleclientEricomPluginlog
Linux
ltuser-home-directorygtEricomleclientEricomPluginlog
Following is a guide for diagnosing and fixing the problems in cases of error messages and
additional information
Error
Message
Solution
Version File
reading error
1 Check the lsquourlrsquo parameter in the webconnectxml file on the Web
server The value should be
httpltWebServerIPgtWebConnect
2 Try to run the following URL on the browser
Windows
httpltWebServerIPgtWebConnectwindowsptagentvertxt
Linux
httpltWebServerIPgtWebConnectlinuxix86qterm-
wcvertxt
The file contents displayed in the browser window should be in
the following form
560-rel14546
PowerTerm WebConnect Application Zone
560 - Main Release
ltrootgtPowerTerm WebConnect 56ltWebServergt
If the version file contents are not as shown check
- Is the Web Server running
- Are PowerTerm WebConnect Web Components and version files
PowerTerm WebConnect 37 Getting Started Guide
in place
3 On the Web server check ltPowerTerm WebConnect
rootgtwebwindowsptagentvertxt If the contents ldquolook wrongrdquo or
not in the proper form reinstall the PowerTerm WebConnect Web
components
4 On the client machine open the aforementioned URL in the
browser The file content should appear in the browser If it does
not it could be that the Web server is down
Web Server is
shut down
The webconnectxml configuration file must be located on the Web
server The explicit URL to this file is defined in the preferencesini
file (see Configure the Preferences File)
The error message contains the IP address of the Web server
Verify that the Web server on this machine is running
Version file
does not exist
on ltURLgt
See Version File reading error
The
configuration
file is not
accessible or
has a wrong
format
The webconnectxml configuration file must be located on the Web
server and the explicit URL to the configuration must be defined in
the preferencesini file (see Configure the Preferences File)
Try to open the URL specified in the error message in the
browser If it does not open then it either does not exist or it has
a wrong format
Preferences
file does not
exist in the
application
bundle
The preferencesini file containing the URL to the configuration
file was removed from the update site folder
Uninstall the current PowerTerm WebConnect client from the
client machine Create a new customized package (see
PowerTerm WebConnect Client Configuration) and reinstall it
Configuration
file URL is not
defined in
preference
file
The URL to the configuration file does not appear in the
preferencesini file (see Configure the Preferences File)
Uninstall the current PowerTerm WebConnect client from the
client machine Create a new customized package (see
PowerTerm WebConnect Client Configuration) and reinstall it
No IP address
could be
found for the
host
The Web server URL specified in the preferencesini file (see
Configure the Preferences File) or in the webconnectxml file (see
Configure the PowerTerm WebConnect Client) is an unknown
host
If the mistake is in the preferencesini file uninstall the current
PowerTerm WebConnect client from the client machine Create a
new customized package (see PowerTerm WebConnect Client
Configuration) and reinstall it
PowerTerm WebConnect 38 Getting Started Guide
If the mistake is in the webconnectxml file correct the file reopen
the Lotus Expeditor client
Cannot write
to destination
The temporary file cannot be written to the defined destination
Check the write permissions
Copied
configuration
file has wrong
format
The webconnectxml file as received from the specified URL has a
wrong format Correct the file and try again
PowerTerm
WebConnect
Agent URL is
malformed
The PowerTerm WebConnect Agent URL specified in the
webconnectxml file (see Configure the PowerTerm WebConnect
Client) does not have a proper HTTP format Correct the file and
try again
PowerTerm
WebConnect
Agent URL is
not defined
The PowerTerm WebConnect Agent URL parameter is not specified
in the webconnectxml file (see Configure the PowerTerm
WebConnect Client)
Correct the file and try again
The specified
destination
folder name
is wrong
The destination folder name contains illegal characters
ltgt|
Check the dst parameter in the webconnectxml file Correct the
file and try again
You do not
have
permissions
to write to
ltpathgt
The PowerTerm WebConnect Agent cannot be written to the
destination as defined Check the write permissions
The default destination defined in the version file should not to
be changed
A customized destination for PowerTerm WebConnect Agent
downloading can be defined in the webconnectxml file (See
Configure the PowerTerm WebConnect Client)
Check the destination value correct and try again
PowerTerm WebConnect 39 Getting Started Guide
About Ericom
Ericomreg Software is a leading provider of Application Access and Virtualization Solutions
Since 1993 Ericom has been helping users access enterprise mission-critical applications
running on a broad range of Microsoftreg Windowsreg Terminal Servers virtual Desktops
Blade PCs legacy hosts and other systems Ericom provides concrete business value by
helping organizations realize the benefits of their IT investments With offices in the United
States United Kingdom EMEA India and China Ericom also has an extensive network of
distributors and partners throughout North America Europe Asia and the Far East Our
expanding customer base is more than 30 thousand strong with over 7 million
installations
For more information on our products and services contact us at the location nearest to you
And visit our web site httpwwwericomcom
North America Western Europe International
Ericom Software Inc Ericom Software (UK) Ltd Ericom Software Ltd
231 Herbert Avenue Bldg 4 11a Victoria Square 8 Hamarpeh Street
Closter NJ 07624 USA Droitwich Worcestershire Har Hotzvim Technology Park
Tel +1 (201) 767 2210 WR9 8DE United Kingdom Jerusalem 91450 Israel
Fax +1 (201) 767 2205 Tel +44 (0) 845 644 3597 Tel +972 (2) 591 1700
Toll-free 1 (888) 769 7876 Fax +44 (0) 845 644 3598 Fax +972 (2) 571 4737
Email infoericomcom Email infoericomcouk Email infoericomcom
PowerTerm WebConnect 8 Getting Started Guide
2 Installing and Starting PowerTerm WebConnect
PowerTerm WebConnect includes both server-side and client-side components The server
side includes
bull PowerTerm WebConnect Server
bull PowerTerm WebConnect DeskView Server
bull PowerTerm WebConnect Load Balancer
bull PowerTerm WebConnect Administration tools (for WebConnect Server PowerTerm
Load Balancer and DeskView Server)
The client side has numerous clients such as
bull RemoteView
bull HostView (for both Windows and Linux)
bull QuickVNC etc
21 Install PowerTerm WebConnect (Windows edition)
1 Run the installation file typically named PowerTermWebConnect5xexe You will find
the file on the installation CD or you can download it from Ericoms website
2 Click Install and then enter your Serial Number or click Evaluate when prompted
3 Continue with installation and select Full Installation Server Administration Tool and
WebServer Components (default) in the Setup Type dialog
4 Complete the installation and click Exit and run PowerTerm WebConnect in the last
dialog of the installation Depending on your computer this may take a few minutes
The first time you launch the PowerTerm WebConnect server it will generate a
Diffie-Hellman key for SSL encryption This process may take several minutes
depending on the speed of your computer A visual progress indicator will show
you when this process is completed While this process is taking place PowerTerm
WebConnect clients will not be able to connect to the server
22 StartStopRestart PowerTerm WebConnect Server (Windows edition)
PowerTerm WebConnect server is installed as a Windows service
1 Launch the standard Services console from the Windows Control Panel On some
computers it may be located under the Administrative Tools group You can also run
the command SERVICESMSC The Services window is displayed
PowerTerm WebConnect 9 Getting Started Guide
2 Select PowerTerm WebConnect Server 5x service (the primary service of PowerTerm
WebConnect) where x is the version number and use standard StartStopRestart
options
The PowerTerm WebConnect Server Starter 5x service (the secondary service of
PowerTerm WebConnect) is designated for restarting the primary service in
cases of failure or any unexpected problems The secondary service is
controlled by internal logic of PowerTerm WebConnect and cannot be stopped
from the Services console
23 Install Run and Stop PowerTerm WebConnect Server (Linux edition)
Transfer the installation file to your Linux server and install the PowerTerm WebConnect
components in the RPM package using the following shell command
rpm ndashi WebConnecct-5x-0i586rpm
(lsquoxrsquo is the version number)
The PowerTerm WebConnect server will be installed to
optWebConnect5x
All PowerTerm WebConnect clients including PowerTerm WebConnect
Administration Tool are published via the Web server Therefore you need to
manually configure the Web server to publish the path optWebConnect56web
The name of the virtual directory has to be WebConnect5x
After configuring the virtual directory you can launch any client from httpltservernamegtWebConnect5xClientURLshtml
Users of Red Hat 72
If you installed the PowerTerm WebConnect server on Red Hat 72 you also have to install
the file libgcc-304-1i386rpm (44Kb) in order for PowerTerm WebConnect Server to run
This file can be downloaded from
ftprpmfindnetlinuxredhatupdates72enosi386libgcc-304-1i386rpm The file is
also available on the installation CD and can as well be downloaded from the ldquoEvaluate
PowerTerm WebConnect Linux x86 Editionrdquo web page
Use the following commands to run the PowerTerm WebConnect server
On RedHat
sbinservice webconnectd start
On Suse
etcrcdwebconnectd start
Use the following commands to stop the PowerTerm WebConnect server
On RedHat
sbinservice webconnectd stop
PowerTerm WebConnect 10 Getting Started Guide
On Suse
etcrcdwebconnectd stop
24 Install the Terminal Server Agent
PowerTerm WebConnect Terminal Server Agent must be installed on a Terminal Server
accessed using PowerTerm WebConnect It provides the True Seamless Windows
functionality for published applications remote browsing and publishing and Application
Load Balancing
The PowerTerm WebConnect Terminal Server Agent must be installed on every Terminal
Server in the cluster If you install the PowerTerm WebConnect server itself on a Terminal
Server you will be given the option to install the Terminal Server Agent as a part of the
server installation Alternatively use the PowerTermTerminalServerAgentexe file located in
the AddOnsTerminalServerAgent subdirectory under the PowerTerm WebConnect server
installation directory
To complete the installation you might need to restart the Terminal Server machine
25 Install PowerTerm WebConnect DeskView Server
PowerTerm WebConnect DeskView is automatically installed when you run PowerTerm
WebConnect Installation wizard ndash Full installation To run PowerTerm WebConnect
DeskView Server you also need Microsoft NET Framework v30 to be installed on your
computer If you do not have it installed then the installation wizard will place the
DeskViewServerSetupmsi and DeskViewAdminSetupmsi files in the AddOns folder
(ltPowerTerm WebConnect Installation FoldergtWebConnect 5xAddOnsDeskView
VDI) from where you can run the msi files at a later stage to install PowerTerm
WebConnect DeskView
26 Start the PowerTerm WebConnect Administration Tool
There are several ways to launch the PowerTerm WebConnect Administration Tool Select
the one most convenient for you
bull From Windows Start menu select Programs | Ericom Software | PowerTerm WebConnect
5x | PowerTerm WebConnect Administration Tool
If you changed the Program Folder during installation the Start menu path
may vary
bull Double-click PtAdminexe PtAdminexe is located in the bin directory of the
PowerTerm WebConnect installation folder
bull Rather than installing you can choose to download the Administration Tool to any
Windows computer Please refer to the PowerTerm WebConnect Sample URLs
page (httpltweb_servergtWebConnect5xClientURLshtml) for more details
A few things to remember
PowerTerm WebConnect 11 Getting Started Guide
When you launch the PowerTerm WebConnect Administration Tool for the first time the Connection dialog is displayed with the user Administrator No
password is required to enter just click Connect
In the Connection dialog (displayed when launching the Administration Tool) the
Host Name is localhost by default This is correct only if the Administration Tool
runs on the same machine as the server If the Administration Tool runs on a different machine you need to change the Host Name to the IP addressHostname
of the PowerTerm WebConnect server
When using the PowerTerm WebConnect Windows edition by default the
Administration Tool will deny any connection attempts from any computer other
than the local machine
PowerTerm WebConnect 12 Getting Started Guide
3 PowerTerm WebConnect Administration Tool at a Glance
PowerTerm WebConnect Administration Tool manages published applications user sessions
and server configuration The administrator can perform operations such as multiple
application publishing sending messages to logged-on users shutting down sessions and
monitor user activity
To perform the tasks described in this chapter you must launch the Administration Tool via one of the methods detailed in chapter Start the PowerTerm
WebConnect Administration Tool
Launching the Administration Tool from the system tray or using the
Administration Tool launched after completed installation will not allow you to
activate certain features
After you launched the Administration Tool and connected to the server you will receive a
Welcome screen where you select desired activity
bull Publish Multiple Applications opens the Publish Multiple Applications wizard
bull Configure Load Balancer opens PowerTerm Load Balancer Administration Tool
bull Create a Host Connection opens the Add Connection dialog
bull Configure Active Directory opens the Directory Services dialog
PowerTerm WebConnect 13 Getting Started Guide
Close the Welcome screen to enter the Administration Tool main
screen
The Administration Tool main screen has three sections
bull User section lists all users defined in the server
bull Group section lists all groups defined in the server
bull Connection section lists all connections and published applications defined in the
server
By default only the Connection section is displayed when you first open Administration Tool
There are three predefined example-connections ldquoExample_As400rdquo ldquoExample_VTrdquo and
ldquolocalhostrdquo You can test them prior to defining your own
1 Right click the connection you want to test and select Test The PowerTerm
WebConnect HostView Login dialog appears
2 Type example for User Name and example for Password
Credential fields are case sensitive
3 Click Login The desired connection with its pre-programmed demo application is
launched
PowerTerm WebConnect 14 Getting Started Guide
31 Publishing Applications and Documents
In order to enable access to applications and documents on Windows Terminal Servers
publish these applications and documents from the Administration Tool When publishing
applications and content you can specify which servers will be used in a Terminal Server
cluster and which users and groups will have access to these services Once you have
published such applications and documents the RemoteView client can be used to access
them
If you need to provide access to multiple applications on a Terminal Server use the Multiple Application Publishing wizard to significantly reduce the time and
effort required to publish these applications
To publish multiple Windows applications
1 Click Publish Multiple Applications in the Welcome screen The Choose Terminal Server
for Browsing dialog appears
2 Provide the address of the Terminal Server which will be used for browsing and click OK The Application Publisher Step 1 dialog appears This dialog lists all the
applications available in the specified serverrsquos Start menu
3 Select those applications found in the Programs folder of the designated server that you want to publish and click Next The Application Publisher Step 2 dialog appears
4 Determine the destination of your publishing and click Next The Application Publisher
Step 3 dialog appears
5 Determine the Color Quality of your published application
6 Determine the start mode in which you want to run the published application - normal maximized or minimized - and click Next The Application Publisher Step 4
dialog appears
7 Choose the connection speed that matches your infrastructure The connection speed
setting determines the value of three visual effects settings You can also override
these settings specifically
8 Determine whether you prefer the window to display their content while being
dragged or just the outline By default the same setting is used as the client desktop
9 Click Next The Application Publisher Step 5 dialog appears
10 Specify where sounds are to be played ndash locally or remotely
11 Determine which local devices the remote session will have access to (local drivers printer etc) and click Next The Application Publisher Step 6 dialog appears
12 If you have the PowerTerm Load Balancer installed Use all Servers (default) allows the application to run on any Terminal Server in the
cluster This setting is appropriate when the application is installed on all the Terminal
Servers Alternatively you select specific Terminal Servers on which to run this
application
If you have not installed the PowerTerm Load Balancer you will need to explicitly
specify the address of the Terminal Server on which the application will be run
PowerTerm WebConnect 15 Getting Started Guide
13 Click Next The Application Publisher Step 7 dialog appears
14 Select the users groups or OUs to which you wish to publish the applications and click Next The Application Publisher Step 8 dialog appears By default applications will
be published to everybody
15 Click Advanced Settings to modify settings such as the login credentials to the
Terminal Servers By default PowerTerm WebConnect credentials will be passed
through to the Terminal Server
16 Click Finish The published applications appears in the Connection List
Right-click and select Properties or double click on the published application in the
Connections list to view and modify any of the settings which you previously
defined
To publish a remote Desktop
1 Select Action | New | Remote Desktop The Application Publisher Step 1 dialog appears
2 Type the Display Name which will be the name presented to the end-users and click
Next The Application Publisher Step 2 dialog appears
3 Specify where icons for the published desktop will be displayed to the end-user in Publish to
4 Click Choose Icon to replace the desktoprsquos default icon Select the desired icon from
the list that appears
5 Click Next The Application Publisher Step 3 dialog appears
6 Determine Screen Size and the Color Quality of the published desktop
7 If desirable select Show Connection Bar in Full Screen Mode
8 Click Next The Application Publisher Step 4 dialog appears
9 Choose the connection speed that matches your infrastructure The connection speed
setting determines the value of three visual effects settings You can also override
these settings specifically
10 Click Next The Application Publisher Step 5 dialog appears
11 Specify where sounds are to be played ndash locally or remotely Where to Apply Window
Key Combinations and which local devices you want to automatically connect to when
logged on to the remote computer
12 Click Next The Application Publisher Step 6 dialog appears
13 Specify the Server Address and Port Number of the Terminal Server that weill provide
the desktop and click Next The Application Publisher Step 7 dialog appears
14 Select the users groups or OUs to which you wish to publish the desktop and click Next The Application Publisher Step 8 dialog appears
Select the Server group to allow all users to access the published application
15 Click Advanced Settings to modify settings such as the login credentials to the
Terminal Servers By default PowerTerm WebConnect credentials will be used
PowerTerm WebConnect 16 Getting Started Guide
16 Click Finish The published application appears in the Connection List
Right-click Properties or double click on the published application in the
Connections list to modify any of the settings which you previously defined
32 Create Terminal Emulation Connections
To provide access to legacy host systems you will need to create Terminal Emulation
connections For each such connection you can specify the host address emulation type
login script and more Once you have created these connections users will be able to
launch them using HostView (Windows or Linux) WebView or the Java client as
appropriate
1 Click Create a Host Connection in the Welcome screen The Add Connection dialog
appears
2 Enter a Name for the new connection
3 Specify an Owner for the new connection The possibilities are
[None] the connection will not be allowed to run by anyone and it will not be
displayed in any Connection list Server the connection will be accessible for all users of this PowerTerm
WebConnect server A specific group the connection will be accessible for all users of the specified
group A specific user the connection will be accessible for a specified user only
4 Leave category Terminal Emulation selected
5 Select Terminal Type Terminal Model and Communication Type as needed
6 Specify the Host Name or IP address of your host
7 Specify other parameters as needed
8 Select the Security Type as needed if your host supports SSL or SSH and specify
the appropriate details in the Details dialog
9 Use the Settings Key Mapping and Power Pad options to further customize the
connection
10 Click OK and the connection is created
33 Test Connections
It is recommended to test published applications or host connections before they are made
available to end-users
To test a connection
bull Right-click the target connection from the Connection section of the main screen and
select Test
Alternatively
PowerTerm WebConnect 17 Getting Started Guide
1 Select Tools | Run ltdesired clientgt The Login to WebConnect dialog appears
2 Enter the User Name and Password for the individual who owns the connection that
you want to test and click Login The desired PowerTerm WebConnect client is started
and the Connect dialog appears
3 Select the desired connection and click Connect The test is executed
34 Launch the Application Zone or the Application Portal
Users can access the published applications from the Application Zone application launcher
or from the Application Portal web interface
To use the Application Zone go to Start menuProgramsEricom SoftwarePowerTerm
WebConnect 5x and select Client URLs Alternatively type the following URL into your Web
browserrsquos address bar httpltserver addressgtWebConnect5xClientURLshtml In the
page that opens click on the Run button next to the Application Zone to launch it
To use the Application Portal go to Start menuProgramsEricom SoftwarePowerTerm
WebConnect 5x and select it Alternatively type the following URL into the Web browserrsquos
address bar httpltserver addressgtWebConenct5xportalwindowsindexasp
35 Monitor a Users Sessions
From the Administration Tool you can monitor the users sessions and may intervene if
necessary This intervention may result in your input appearing on the users screen The
user receives a notification when an administrator begins and ends monitoring the session
1 Select View | Client Sessions or click to see all the active client sessions
2 Select the desired active session and right-click Attach The Password Verify dialog
appears
3 Enter your password and click OK Some notification dialogs appears and the selected
PowerTerm WebConnect session is viewed
36 View Intruders
bull The Intruders window shows suspected attempts at breaching security After several
suspected intrusion attempts users are blocked temporarily
bull In addition to showing suspected intrusion attempts the Intruders window allows
you to remove restrictions on users
bull Select View | All Intruders or click
PowerTerm WebConnect 18 Getting Started Guide
4 Accessing Virtual Desktops and Blade PCs with PowerTerm WebConnect
This chapter provides instructions on configuring PowerTerm WebConnect for Virtual
Desktop Infrastructure (VDI)
41 Step 1 Launch DeskView Administration Tool
Verify that PowerTerm WebConnect is installed on your server and launch PowerTerm
WebConnect Admin Tool
bull Select Tools | Open VDI Manager The PowerTerm WebConnect DeskView Administration
Tool opens
The first time you launch the DeskView Administration Tool you will be prompted to install
the tool
PowerTerm WebConnect 19 Getting Started Guide
Microsoft Management Console 30 is required for PowerTerm WebConnect DeskView
Administration Tool If you do not have this installed you will also automatically be
prompted to install this update
Follow the installation processes when you are prompted for either install PowerTerm
WebConnect DeskView Administration Tool will automatically launch when these
installations are completed
42 Step 2 Add a Host
1 Right-click Virtualization Hosts and select Add Host The Add a New Host wizard
opens Click Next
2 Enter a Host Name as you would like it to appear in PowerTerm WebConnect
DeskView Administration Tool and a description (optional) Click Next
3 Specify the Virtualization Server type and click Next
4 Specify the connection information and click Next
VMWare Virtual Center v1x and 2x
Specify the HTTPS Web Service address and a UsernamePassword that can access
the host
VMWare Virtual Server 2005
Click Start and then Run
Type ldquoservicesmscrdquo and click OK
Scroll down to PowerTerm WebConnect DeskView Server service and open
Properties
Change the Login Account for the service to match the Domain Administrator
account and password used when setting up Microsoft Virtual Server 2005 and
restart the service Enter the IP or NETBIOS name of the Microsoft Virtual Server 2005 server as the
Server Address in the Connection Broker Wizard
Xen Server
Specify the hypervisor IP address or NETBIOS name the Root UsernamePassword
to the hypervisor and the Service port (default 80)
Oracle VM
Specify the Serverrsquos agent URL and Port (default 8899) for example
httpsltservernamegt8899
Specify the Oracle VM hypervisorrsquos Oracle Agent UsernamePassword (default
username oracle)
5 Click Finish to add the new Host
To configure Virtual Machines for use install the Ericom Tools (vmagentmsi) on each of the
virtual machines on the new host for PowerTerm WebConnect DeskView to recognize them
The vmagentmsi installer is located on the PowerTerm WebConnect server in ltPowerTerm
WebConnect installation foldergtAddOnsDeskView VDI folder (default installation
PowerTerm WebConnect 20 Getting Started Guide
folder is xProgram FilesEricom SoftwareWebConnect 56) During installation you
will need to enter the DeskView IP address or NETBIOS name
If you are using Microsoft Virtual Server 2005 as your Virtualization Host use the
IP address of the DeskView server only when installing the Ericom Tool package
43 Step 3 Create a Pool
Pools are used to organize Virtual Machines (VM) into logical groups This enables
organizations to combine and order resources from multiple systems into one entity To
access available resources end-users simply connect to PowerTerm WebConnect to access
any configured resource
1 Right-click Pools and select Create Pool The Create a Pool wizard opens Click
Next
2 Enter a Pool name as you wish it to appear and a description (optional) and click
Next
3 Specify the Pool type and click Next
4 Specify the Assignment type and click Next
Permanently will cause a virtual machine to affix to the user who has launched
that virtual machine For the duration of the session will cause any virtual machine that is not in use to
be returned to the pool for any user to launch
5 Specify the LogoffDisconnect event and click Next
Select what you would like to happen after a user logs off from a virtual machine
in this pool
Select what you would like to happen when a user is disconnected from a virtual
machine in this pool
6 Click Finish to add the new Pool
You will need to assign virtual machines from your virtualization hosts to your created pool
1 Right-click the pool and select Assign Machines The Assign Machines to ltyour
pool namegt dialog opens
2 Highlight the desired virtual machine(s) and click Select Click OK
44 Step 4 Publish an ApplicationDesktop
1 Return to PowerTerm WebConnect Admin Tool to publish DeskView pools
2 Determine whether to publish a full desktop or a seamless application running
from a virtual desktop
For a full desktop
Select Action | New | Remote Windows Desktop
For a seamless application
Select Action | New | Windows Application
PowerTerm WebConnect 21 Getting Started Guide
3 Select Virtual Desktop in the first step of the wizard and click Next
4 Follow the wizardrsquos instructions until you reach the Virtual Desktops step
5 Select a pool that you previously created and that you would like this connection to choose virtual machines from Click Next
6 Continue and complete the reminder of the wizardrsquos steps
Once the resource is published users who have been assigned access will be able to use it
immediately
PowerTerm WebConnect 22 Getting Started Guide
5 Download and Run PowerTerm WebConnect Clients
PowerTerm WebConnect clients are automatically downloaded and installed onto the client
devices For detailed information and samples please refer to the PowerTerm WebConnect
Sample URLs page To see this page navigate your browser to
httpltweb_servergtWebConnect5xClientURLshtml
PowerTerm WebConnect 23 Getting Started Guide
6 PowerTerm WebConnect Client for Lotus Expeditor
61 Installation Package
PowerTerm WebConnect client for Lotus Expeditor is provided to IBM in an Update Site
package This is a ZIP archive containing the Update Site with the Eclipse feature and plug-
in that comprises the PowerTerm WebConnect client
Extract the ZIP file keeping the foldersrsquo structure intact
NOTE In Winzip verify that the ldquoUse folder namesrdquo option is set to TRUE
Package structure
Update Site
- plugins
- PowerTermWebConnectClient_560365jar
- features
- comericomWebConnect_560365jar
- sitexml
config
- webconnectxml
Definitions
bull webconnectxml PowerTerm WebConnect client configuration file
bull comericomWebConnect_560365jar PowerTerm WebConnect client feature file
bull PowerTermWebConnectClient_560365jar PowerTerm WebConnect client plugin file
62 Pre-installation steps
PowerTerm WebConnect client for Lotus Expeditor does not run independently but in
conjunction with PowerTerm WebConnect Server You can either install it and define your
users groups and applications or use Ericom Softwarersquos Demo PowerTerm WebConnect
Server
bull If you decide to install PowerTerm WebConnect Server you will need the full
installation ie the PowerTerm WebConnect Server and the Web components If you
do not have the installation CD you can download and install a trial version from
wwwericomcom
PowerTerm WebConnect 24 Getting Started Guide
bull If you decide to use Ericom Softwarersquos Demo PowerTerm WebConnect Server then
skip to the chapter Installing PowerTerm WebConnect Client on Lotus Expeditor
63 Install PowerTerm WebConnect Portlet on IBM Workplace server (for Windows OS)
Step 1 Install PowerTerm WebConnect Server
If PowerTerm WebConnect Server and IBM Workplace Server are on separate machines
bull Configure PowerTerm WebConnect Server
Launch PowerTerm WebConnect Administration Tool
Open Files | Configuration | Main
In the [Portal] section edit
Machines=localhostltIBM sever machinegt
bull Configure PowerTerm WebConnect Web components
Copy the ldquowebrdquo folder from the PowerTerm WebConnect server installation to the
IBM Workplace server machine
Create an Alias or a Virtual directory to it named WebConnect on the Web
server providing access to it for the users This is in order to enable the users to
download the necessary files to run their applications
Step 2 Enable JSR portlets
1 On IBM Workplace Server go to ltPortalServergtsharedappconfigservicesConfigServiceproperties
2 Edit portalenablejsr168=true
3 Save and close the file
Step 3 Enable SSO
1 On IBM Workplace Server go to ltPortalServergtsharedappconfigservicesLoaderServiceproperties
2 Edit commandpath=comericomportalcommandscomibmwpsenginecommands
3 Save and close the file
Step 4 Copy Files
The following files need to be copied from WebConnect ServerAddOnsIBM
WorkplacePortlet folder to IBM Workplace Server
File name to copy Destination folder
OpenSSLdll ltAppServergtjavajrebin
IbmPortaldll ltAppServergtjavajrebin
IbmPortalini ltAppServergtjavajrebin
PowerTerm WebConnect 25 Getting Started Guide
WebConnectPortaljar ltAppServergtlib
EricomLoginjar ltPortalServergtsharedapp
Step 5 Portlet Configuration
1 On IBM Workplace Server go to ltAppServergtjavajrebinIbmPortalini
2 You can modify the following parameters in the [Server=WebConnect] section webserverport=ltIBM web server portgt
Specifies the Web server port for accessing the PowerTerm WebConnect clients folder
Default 80 Address
Specifies the address of the PowerTerm WebConnect Server machine for Portlet to
connect to when PowerTerm WebConnect Server is located on a different machine
than the IBM Workplace Server CustomAddress
Specifies the addresss of the PowerTerm WebConnect Server machine for Clients to connect to If CustomAddress is the same as Address then this may be omitted webserveraddr
Specifies the address of the Web Server machine when it is located on a different
machine than the IBM Workplace Server
3 Restart the IBM server ltPortalServergtrootscriptsstopWorkplaceServicesbat ltPortalServergtrootscriptsstartWorkplaceServicesbat
This procedure may take about 20 minutes
Step 6 Install the Portlet
1 In a Web browser open the URL httpltIBM Workplace
Servergt9081lwpmyworkplace to open the IBM Workplace Portal
2 Login as administrator
3 Go to Administration | Portlets | Install
4 Browse to the PowerTerm WebConnectwar file located on PowerTerm WebConnect
Server and click Next
5 Click Install
Step 7 Create an Application page
1 Login to the Workplace
2 Go to Portal User Interface | Manage Pages
3 Search for My Work
4 Click the My Work link and select New Page
5 Name the page PowerTerm WebConnect and click OK
6 Click OK again You will see the created page on the list
7 Click the pencil icon on the new page and select the 1 square layout
PowerTerm WebConnect 26 Getting Started Guide
8 Click Add Portlet and search for PowerTerm WebConnect
9 Select it and click OK
10 Click Done
11 Click My work at the top of the page PowerTerm WebConnect is displayed on the list
Step 8 Run the Portlet
1 Restart IBM Workplace Server
2 Open IBM Workplace Portal in a browser httpltportal servergtlwpmyworkplace
3 Login to IBM Workplace Server
4 Click My work PowerTerm WebConnect portlet is displayed
5 Launch it The Userrsquos applications as defined on PowerTerm WebConnect Server
appear
6 Click an application to launch it
64 Install PowerTerm WebConnect Portlet on IBM Workplace server (for Linux OS)
Step 1 Enable JSR 168 portlets
1 Go to optIBMWorkplacePortalServersharedappconfigservicesConfigServiceproperties
2 Modify the portalenablejsr168 property to ldquotruerdquo
3 Restart the server cd optIBMWorkplacePortalServerrootscripts
Run stopWorkplaceServicessh
Run startWorkplaceServicessh
This procedure can take up to 20 minutes
4 Log on to the workplace server at httpltworkplace servergt9081lwpmyworkplace using
the administrators username and password
Step 2 Install the portlet
1 Restart IBM Workplace Server
2 In a Web browser open the URL httpltworkplace server IPgtlwpmyworkplace
3 Login to IBM Workplace Server as an administrator
4 Go to Administration | Portlets | Install
5 Browse to the PowerTerm WebConnectwar file located on PowerTerm WebConnect
Server and click Next
6 Click Install
PowerTerm WebConnect 27 Getting Started Guide
Step 3 Install the Application page
1 Login to the workplace as administrator
2 Go to Administration | Portal User Interface | Manage Pages
3 Search for My Work
4 Click the My Work link and select New Page
5 Name the page PowerTerm WebConnect and click OK
6 Click OK again You will see the created page on the list
7 Click the pencil icon and select the 1-square layout
8 Click Add Portlet and search for PowerTerm WebConnect
9 Select it and click OK
10 Click Done
11 Click My work on top and PowerTerm WebConnect is displayed on the left bar
Step 4 Run the portlet
1 Restart IBM Workplace Server
2 Open IBM Workplace Portal in a browser httpltportal servergtlwpmyworkplace
3 Login to IBM Workplace Server
4 Click My work PowerTerm WebConnect portlet is displayed
5 Launch it The Userrsquos applications as defined on PowerTerm WebConnect Server
appear
6 Click an application to launch it
65 Install PowerTerm WebConnect Portlet on IBM WebSphere 61 server (for Windows OS)
Step 1 Install PowerTerm WebConnect Server
You have to configure PowerTerm WebConnect Server if it and the IBM WebSphere Server
are on separate machines
1 Launch PowerTerm WebConnect Administration Tool
2 Open Files | Configuration | Main
3 In the [Portal] section edit Machines=localhostltIBM sever machinegt
Step 2 Copy Files
The following files need to be copied from WebConnect ServerAddOnsIBM
WebSpherePortlet folder to IBM WebSphere Server
PowerTerm WebConnect 28 Getting Started Guide
File name to copy Destination folder
OpenSSLdll ltAppServergtjavajrebin
IbmPortaldll ltAppServergtjavajrebin
IbmPortalini ltAppServergtjavajrebin
WebConnectPortaljar ltAppServergtlib
Step 3 Portlet Configuration
1 On IBM Workplace Server go to ltAppServergtjavajrebinIbmPortalini
2 You can modify the following parameters in the [Server=WebConnect] section webserverport=ltIBM web server portgt
Specifies the Web server port for accessing the PowerTerm WebConnect clients folder
Default 80 Address
Specifies the address of the PowerTerm WebConnect Server machine for Portlet to
connect to when PowerTerm WebConnect Server is located on a different machine
than the IBM Workplace Server CustomAddress
Specifies the addresss of the PowerTerm WebConnect Server machine for Clients to connect to If CustomAddress is the same as Address then this may be omitted webserveraddr
Specifies the address of the Web Server machine when it is located on a different
machine than the IBM Workplace Server
3 Restart the IBM server ltAppServergtProfilesAppServer01binstopServerbat ltAppServergtProfilesAppServer01binstartServerbat
This procedure may take about 20 minutes
Step 4 Install the Portlet and create an Application page
1 In a Web browser open the URL httpltIBM WebSphere Servergt9060ibmconsole
to open the IBM WebSphere Portal
2 Login and go to Applications | Install New Application
3 Browse to the PowerTerm WebConnectwar file located on PowerTerm WebConnect
Server
4 Enter Context root and click Next The Select installation options dialog appears
5 Optional change options to your preference or keep the default
6 Click Next
7 Select Ericom in the Module column click Apply and then Next
8 Click Finish and then Save
9 Select Applications | Enterprise Applications
10 Select PowerTerm WebConnectwar checkbox and click Start
PowerTerm WebConnect 29 Getting Started Guide
11 Enter in the Web browser the URL httpltIBM WebSphere
Servergt9080ltContext rootgtEricom portlet The Login dialog appears
12 Login and you will see PowerTerm WebConnect displayed on the list
Step 5 Run the Portlet
1 Restart IBM WebSphere Server
2 Open IBM WebSphere Portal in a browser httpltportal servergt9080ltContext
rootgtEricom portlet
3 Login to IBM WebSphere Server
4 Launch it The Userrsquos applications as defined on PowerTerm WebConnect Server
appear
5 Click an application to launch it
66 PowerTerm WebConnect Server Configuration
bull To enable the Lotus Expeditor to run the PowerTerm WebConnect client the
System Administrator must provide the users with accounts on PowerTerm
WebConnect Server (see the PowerTerm WebConnect Administratorrsquos Manual for
instructions on how to create users groups and connections on the PowerTerm
WebConnect Server)
bull To enable PowerTerm WebConnectrsquos Single Sign-On feature the System
Administrator must create a PowerTerm WebConnect user with the same
username and password as used for the Lotus Expeditor For a managed Lotus
Expeditor the credentials used are the username and password sent to the
managing server For an unmanaged Lotus Expeditor the operation system
username and the Lotus Expeditor password are used as credentials
NOTE If a password is not defined then the Single Sign-On will fail and the user will be
prompted with a login dialog
67 PowerTerm WebConnect Client Configuration
The PowerTerm WebConnect client is configured in webconnectxml located in the config
folder webconnectxml parameters are
url The PowerTerm WebConnect Agent url
server The PowerTerm WebConnect Server address
sso The Single Sign-On feature
dst The local destination for downloading PowerTerm WebConnect
components
PowerTerm WebConnect 30 Getting Started Guide
url
PowerTerm WebConnect components are installed on a Web server Their default url is
Windows Agent
httpltWebServer IPgtWebConnectwindowsptagentcab
Linux Agent
httpltWebServer IPgtWebConnectlinuxix86qterm-wczip
The url parameter must include the first part of the url (which is identical for both Windows
and Linux agents)
The PowerTerm WebConnect client will automatically append the appropriate suffix in
order to create a full accurate url
Example
ltitem key=rdquourlrdquo value=httpadminserverWebConnectgt
server
The computer name or IP address of the PowerTerm WebConnect Server machine
The PowerTerm WebConnect client will log in to this PowerTerm WebConnect Server
display the applications defined on it and run them according to this serverrsquos configuration
Format ltserver IPgt[ltportgt]
where default port is 4000 (can be edited)
Example
ltitem key=rdquoserverrdquo value=rdquoadmin24000rdquogt
sso
Determines whether Single Sign-on will be used to log in to PowerTerm WebConnect
Server Values
bull True (default) the client should automatically log in to the PowerTerm WebConnect
Server using the same credentials as the ones used to log in to the Lotus Expeditor
client
The System Administrator must verify that these credentials can log in to the
PowerTerm WebConnect Server
bull False the user will be prompted with a login dialog or will log in automatically using
previously saved credentials
Example
ltitem key=rdquossordquo value=rdquotruerdquogt
Autologin mode
PowerTerm WebConnect 31 Getting Started Guide
If sso is set to True the user is not prompted for credentials and the login process to
PowerTerm WebConnect Server is done automatically sending the credentials used for the
Lotus Expeditor unless the Lotus Expeditor does not have a password defined (In the
Lotus Expeditor preferences page | Password| Prompt me for a password at start up checkbox)
However if Single Sign-on is not used there are several options regarding Autologin that
can be defined in the PowerTerm WebConnect Preferences page Options
bull Yes
bull No
bull Interactive
bull First time interactive (default) ndash Simplifies the login process to PowerTerm
WebConnect Server In this mode the first time the user logs in to PowerTerm
WebConnect Server he will be prompted for his credentials with the Login dialog
These credentials will be stored in the machine and from then on the login process to
PowerTerm WebConnect Server will be done automatically
1 Open File | Preferences from the Lotus Expeditor and select PowerTerm WebConnect
2 In the Autologin to WebConnect Server section select First Interactive and click OK
3 Start PowerTerm WebConnect Client for Lotus Expeditor If credentials were entered
at least once then the next time the client will connect to PowerTerm WebConnect
Server without prompting for the user name and password
The Administrator must configure the Agent to do nothing when it exits for the
feature to work this way See PowerTerm WebConnect Administratorrsquos Manual for more information about defining Autologin
bull Allow multiple selection ndash Defines whether the user can launch more than one
application at a time (by using the ltCtrlgt or ltShiftgt button while selecting applications)
dst
Defines the path to download PowerTerm WebConnect components on the client machine
The dst parameter can contain macros which are translated by the PowerTerm WebConnect
Client for Lotus Expeditor during runtime The macros should be placed between percent
symbols () for example WebServer
When such a value is defined the PowerTerm WebConnect Client for Lotus Expeditor
substitutes the entire expression for the macrorsquos value
The PowerTerm WebConnect Client for Lotus Expeditor does not support the use
of environment variables as macros
Macros are not case sensitive
Macros supported by PowerTerm WebConnect Client for Lotus Expeditor
Macro name Description
WebServer The name of the Web server
It is obtained from the PowerTerm WebConnect Agent url
PowerTerm WebConnect 32 Getting Started Guide
parameter
Name The name of the clientrsquos CAB or ZIP file eg ldquoptagentrdquo
Display The clientrsquos display name from the version file
Version The clientrsquos version value It is obtained from the version
file
Root The default root location
Windows ldquoCrdquo
LinuxUnix an empty string
OSDir Windows Windowsrsquo installation directory for example
ldquoCWindowsrdquo
Linux an empty string
OSDrive Windows Windowsrsquo installation drive for example ldquoCrdquo
Linux an empty string
HomePath Windows The HOMEPATH environment variable
Linux The HOME environment variable
Home The Ericom folder in the userrsquos home directory
Windows CDocuments and SettingsltusergtApplication
DataEricom
Linux ltusergtEricom
In addition to the predefined macros listed above the PowerTerm WebConnect client
supports the usage of Java System Properties
Java System Properties available for users on Windows XP SP2
Java System Property Name Value Example
javaversion 150
javavendorurl httpwwwibmcom
javahome CIBMcommonpluginscomibmpvcwctruntim
esj2sewin32x86_150SR2-
20060511rcpeclipsepluginscomibmrcpj2sew
in32x86_150SR2-20060511jre
javavmspecificationversion 10
javavmversion 23
javavmvendor IBM Corporation
javavmname IBM J9 VM
PowerTerm WebConnect 33 Getting Started Guide
javaiotmpdir CDOCUME~1dianaLOCALS~1Temp
javacompiler j9jit23
javaextdirs CIBMcommonpluginscomibmpvcwctruntim
esj2sewin32x86_150SR2-
20060511rcpeclipsepluginscomibmrcpj2sew
in32x86_150SR2-20060511jrelibext
osname Windows XP
osarch x86
osversion 51 build 2600 Service Pack 2
pathseparator
username Jone
userhome CDocuments and SettingsJone
userdir CIBMRSA
usertimezone GMT+0200
System properties available for users on Linux RedHat 9
Java System Property Name Value Example
javaversion 150
javavendorurl httpwwwibmcom
javahome usrjavajre150_07
javavmversion 150
javavmvendor IBM Corporation
javavmname IBM J9 VM
javaclasspath
javalibrarypath
javaiotmpdir tmp
javacompiler
javaextdirs
osname Linux
osarch i386
osversion 2420-8
pathseparator
PowerTerm WebConnect 34 Getting Started Guide
username root
userhome root
userdir root
System properties names are placed in the configuration file within percent symbols ()
(like macros)
671 Configure the PowerTerm WebConnect Client
1 Open the Config Folder and edit the webconnectxml file Example
ltxml version =rdquo10rdquo encoding=rdquoUTF-8rdquogt
ltsection name=rdquoparametersrdquogt
ltitem key=rdquourlrdquo value=httpadminserverWebConnect56gt
ltitem key=rdquoserverrdquo value=rdquoadmin24000rdquogt
ltitem key=rdquossordquo value=rdquotruerdquogt
ltitem key=rdquodestrdquo value=rdquoCProgram FilesEricomrdquogt
ltsectiongt
2 Save the customized webconnectxml to a Web server folder available to all users It is
recommended to use the same Web server as the PowerTerm WebConnect Agent
Example
ltWebConnect installation foldergtwebwebconnectxml
3 Test the accessibility to this file - Type the URL of webconnectxml in the browser
Example
httpltWebServer IPgtWebConnectwebconnectxml
The contents of the file should be displayed
672 Configure the Preferences File
1 Open the plugins folder and open the PowerTermWebConnectClient_560365jar file
You can use Winzip version 70 and up or in Windows XP ndash Create a new file type for the
jar extension click advanced and select compressed (zipped) folder in the drop down list
Now you can open the JAR files in the Windows Explorer
The default contents of the file
configURL=httpleericomcomWebConnectwebconnectxml
2 Specify the accurate URL of the webconnectxml file Example
httpltWebServer IPgtWebConnectwebconnectxml
3 Save the file and close it The WinZip will display the following dialog
ldquoFile preferencesini has been changed since it was extracted Update archive
with this filerdquo
PowerTerm WebConnect 35 Getting Started Guide
4 Click Yes and close the archive
If you are editing the file from within the explorer you will have to save the file elsewhere
and then drag it to the explorer window where the JAR file is open
68 Installing PowerTerm WebConnect Client on Lotus Expeditor
1 Start the Lotus Expeditor client
2 Select File | Application | Install
3 Select Search for new features to install and click Next
4 Select Add Folder Location and type or select the location of the update site folder from
the provided package Click OK
5 Select the location you have just created and click Finish
6 In the Select the feature to install tree select Powerterm WebConnectUpdate Site Click
Next
7 Select I accept the terms in the license agreements and click Next
8 Click Finish
9 When prompted restart the platform
69 Running PowerTerm WebConnect Client for Lotus Expeditor
1 Click Open The PowerTerm WebConnect option is displayed
2 Select PowerTerm WebConnect The application will automatically connect and start
downloading the components from PowerTerm WebConnect Server
IMPORTANT
If you did not install PowerTerm WebConnect Server and are instead connecting to Ericom
Softwarersquos Demo WebConnect Server then you need to open port 443 in the firewall
691 PowerTerm WebConnect Client Workflow
1 PowerTerm WebConnect client reads the URL of webconnectxml from the preferencesini
file and requests it
2 When the webconnectxml is successfully downloaded the application reads the
configuration connects to the specified Web server downloads the PowerTerm
WebConnect components and connects to the PowerTerm WebConnect Server
3 The user is requested to login to the PowerTerm WebConnect Server For testing you
can use the username Example and password example
This step will be skipped if Single Sign-on is set to ldquotruerdquo
PowerTerm WebConnect 36 Getting Started Guide
4 After logging in to PowerTerm WebConnect Server the userrsquos applications are displayed
as defined by the administrator
5 To run an application select the desired application from the list and click Launch or
double-click the application The application will be launched in a separate window
610 Troubleshooting
When you encounter a problem the first step is to open the log file This file is located on
the client machine in the Ericom folder
Windows
CDocuments and SettingsltusernamegtEricomleclientEricomPluginlog
Linux
ltuser-home-directorygtEricomleclientEricomPluginlog
Following is a guide for diagnosing and fixing the problems in cases of error messages and
additional information
Error
Message
Solution
Version File
reading error
1 Check the lsquourlrsquo parameter in the webconnectxml file on the Web
server The value should be
httpltWebServerIPgtWebConnect
2 Try to run the following URL on the browser
Windows
httpltWebServerIPgtWebConnectwindowsptagentvertxt
Linux
httpltWebServerIPgtWebConnectlinuxix86qterm-
wcvertxt
The file contents displayed in the browser window should be in
the following form
560-rel14546
PowerTerm WebConnect Application Zone
560 - Main Release
ltrootgtPowerTerm WebConnect 56ltWebServergt
If the version file contents are not as shown check
- Is the Web Server running
- Are PowerTerm WebConnect Web Components and version files
PowerTerm WebConnect 37 Getting Started Guide
in place
3 On the Web server check ltPowerTerm WebConnect
rootgtwebwindowsptagentvertxt If the contents ldquolook wrongrdquo or
not in the proper form reinstall the PowerTerm WebConnect Web
components
4 On the client machine open the aforementioned URL in the
browser The file content should appear in the browser If it does
not it could be that the Web server is down
Web Server is
shut down
The webconnectxml configuration file must be located on the Web
server The explicit URL to this file is defined in the preferencesini
file (see Configure the Preferences File)
The error message contains the IP address of the Web server
Verify that the Web server on this machine is running
Version file
does not exist
on ltURLgt
See Version File reading error
The
configuration
file is not
accessible or
has a wrong
format
The webconnectxml configuration file must be located on the Web
server and the explicit URL to the configuration must be defined in
the preferencesini file (see Configure the Preferences File)
Try to open the URL specified in the error message in the
browser If it does not open then it either does not exist or it has
a wrong format
Preferences
file does not
exist in the
application
bundle
The preferencesini file containing the URL to the configuration
file was removed from the update site folder
Uninstall the current PowerTerm WebConnect client from the
client machine Create a new customized package (see
PowerTerm WebConnect Client Configuration) and reinstall it
Configuration
file URL is not
defined in
preference
file
The URL to the configuration file does not appear in the
preferencesini file (see Configure the Preferences File)
Uninstall the current PowerTerm WebConnect client from the
client machine Create a new customized package (see
PowerTerm WebConnect Client Configuration) and reinstall it
No IP address
could be
found for the
host
The Web server URL specified in the preferencesini file (see
Configure the Preferences File) or in the webconnectxml file (see
Configure the PowerTerm WebConnect Client) is an unknown
host
If the mistake is in the preferencesini file uninstall the current
PowerTerm WebConnect client from the client machine Create a
new customized package (see PowerTerm WebConnect Client
Configuration) and reinstall it
PowerTerm WebConnect 38 Getting Started Guide
If the mistake is in the webconnectxml file correct the file reopen
the Lotus Expeditor client
Cannot write
to destination
The temporary file cannot be written to the defined destination
Check the write permissions
Copied
configuration
file has wrong
format
The webconnectxml file as received from the specified URL has a
wrong format Correct the file and try again
PowerTerm
WebConnect
Agent URL is
malformed
The PowerTerm WebConnect Agent URL specified in the
webconnectxml file (see Configure the PowerTerm WebConnect
Client) does not have a proper HTTP format Correct the file and
try again
PowerTerm
WebConnect
Agent URL is
not defined
The PowerTerm WebConnect Agent URL parameter is not specified
in the webconnectxml file (see Configure the PowerTerm
WebConnect Client)
Correct the file and try again
The specified
destination
folder name
is wrong
The destination folder name contains illegal characters
ltgt|
Check the dst parameter in the webconnectxml file Correct the
file and try again
You do not
have
permissions
to write to
ltpathgt
The PowerTerm WebConnect Agent cannot be written to the
destination as defined Check the write permissions
The default destination defined in the version file should not to
be changed
A customized destination for PowerTerm WebConnect Agent
downloading can be defined in the webconnectxml file (See
Configure the PowerTerm WebConnect Client)
Check the destination value correct and try again
PowerTerm WebConnect 39 Getting Started Guide
About Ericom
Ericomreg Software is a leading provider of Application Access and Virtualization Solutions
Since 1993 Ericom has been helping users access enterprise mission-critical applications
running on a broad range of Microsoftreg Windowsreg Terminal Servers virtual Desktops
Blade PCs legacy hosts and other systems Ericom provides concrete business value by
helping organizations realize the benefits of their IT investments With offices in the United
States United Kingdom EMEA India and China Ericom also has an extensive network of
distributors and partners throughout North America Europe Asia and the Far East Our
expanding customer base is more than 30 thousand strong with over 7 million
installations
For more information on our products and services contact us at the location nearest to you
And visit our web site httpwwwericomcom
North America Western Europe International
Ericom Software Inc Ericom Software (UK) Ltd Ericom Software Ltd
231 Herbert Avenue Bldg 4 11a Victoria Square 8 Hamarpeh Street
Closter NJ 07624 USA Droitwich Worcestershire Har Hotzvim Technology Park
Tel +1 (201) 767 2210 WR9 8DE United Kingdom Jerusalem 91450 Israel
Fax +1 (201) 767 2205 Tel +44 (0) 845 644 3597 Tel +972 (2) 591 1700
Toll-free 1 (888) 769 7876 Fax +44 (0) 845 644 3598 Fax +972 (2) 571 4737
Email infoericomcom Email infoericomcouk Email infoericomcom
PowerTerm WebConnect 9 Getting Started Guide
2 Select PowerTerm WebConnect Server 5x service (the primary service of PowerTerm
WebConnect) where x is the version number and use standard StartStopRestart
options
The PowerTerm WebConnect Server Starter 5x service (the secondary service of
PowerTerm WebConnect) is designated for restarting the primary service in
cases of failure or any unexpected problems The secondary service is
controlled by internal logic of PowerTerm WebConnect and cannot be stopped
from the Services console
23 Install Run and Stop PowerTerm WebConnect Server (Linux edition)
Transfer the installation file to your Linux server and install the PowerTerm WebConnect
components in the RPM package using the following shell command
rpm ndashi WebConnecct-5x-0i586rpm
(lsquoxrsquo is the version number)
The PowerTerm WebConnect server will be installed to
optWebConnect5x
All PowerTerm WebConnect clients including PowerTerm WebConnect
Administration Tool are published via the Web server Therefore you need to
manually configure the Web server to publish the path optWebConnect56web
The name of the virtual directory has to be WebConnect5x
After configuring the virtual directory you can launch any client from httpltservernamegtWebConnect5xClientURLshtml
Users of Red Hat 72
If you installed the PowerTerm WebConnect server on Red Hat 72 you also have to install
the file libgcc-304-1i386rpm (44Kb) in order for PowerTerm WebConnect Server to run
This file can be downloaded from
ftprpmfindnetlinuxredhatupdates72enosi386libgcc-304-1i386rpm The file is
also available on the installation CD and can as well be downloaded from the ldquoEvaluate
PowerTerm WebConnect Linux x86 Editionrdquo web page
Use the following commands to run the PowerTerm WebConnect server
On RedHat
sbinservice webconnectd start
On Suse
etcrcdwebconnectd start
Use the following commands to stop the PowerTerm WebConnect server
On RedHat
sbinservice webconnectd stop
PowerTerm WebConnect 10 Getting Started Guide
On Suse
etcrcdwebconnectd stop
24 Install the Terminal Server Agent
PowerTerm WebConnect Terminal Server Agent must be installed on a Terminal Server
accessed using PowerTerm WebConnect It provides the True Seamless Windows
functionality for published applications remote browsing and publishing and Application
Load Balancing
The PowerTerm WebConnect Terminal Server Agent must be installed on every Terminal
Server in the cluster If you install the PowerTerm WebConnect server itself on a Terminal
Server you will be given the option to install the Terminal Server Agent as a part of the
server installation Alternatively use the PowerTermTerminalServerAgentexe file located in
the AddOnsTerminalServerAgent subdirectory under the PowerTerm WebConnect server
installation directory
To complete the installation you might need to restart the Terminal Server machine
25 Install PowerTerm WebConnect DeskView Server
PowerTerm WebConnect DeskView is automatically installed when you run PowerTerm
WebConnect Installation wizard ndash Full installation To run PowerTerm WebConnect
DeskView Server you also need Microsoft NET Framework v30 to be installed on your
computer If you do not have it installed then the installation wizard will place the
DeskViewServerSetupmsi and DeskViewAdminSetupmsi files in the AddOns folder
(ltPowerTerm WebConnect Installation FoldergtWebConnect 5xAddOnsDeskView
VDI) from where you can run the msi files at a later stage to install PowerTerm
WebConnect DeskView
26 Start the PowerTerm WebConnect Administration Tool
There are several ways to launch the PowerTerm WebConnect Administration Tool Select
the one most convenient for you
bull From Windows Start menu select Programs | Ericom Software | PowerTerm WebConnect
5x | PowerTerm WebConnect Administration Tool
If you changed the Program Folder during installation the Start menu path
may vary
bull Double-click PtAdminexe PtAdminexe is located in the bin directory of the
PowerTerm WebConnect installation folder
bull Rather than installing you can choose to download the Administration Tool to any
Windows computer Please refer to the PowerTerm WebConnect Sample URLs
page (httpltweb_servergtWebConnect5xClientURLshtml) for more details
A few things to remember
PowerTerm WebConnect 11 Getting Started Guide
When you launch the PowerTerm WebConnect Administration Tool for the first time the Connection dialog is displayed with the user Administrator No
password is required to enter just click Connect
In the Connection dialog (displayed when launching the Administration Tool) the
Host Name is localhost by default This is correct only if the Administration Tool
runs on the same machine as the server If the Administration Tool runs on a different machine you need to change the Host Name to the IP addressHostname
of the PowerTerm WebConnect server
When using the PowerTerm WebConnect Windows edition by default the
Administration Tool will deny any connection attempts from any computer other
than the local machine
PowerTerm WebConnect 12 Getting Started Guide
3 PowerTerm WebConnect Administration Tool at a Glance
PowerTerm WebConnect Administration Tool manages published applications user sessions
and server configuration The administrator can perform operations such as multiple
application publishing sending messages to logged-on users shutting down sessions and
monitor user activity
To perform the tasks described in this chapter you must launch the Administration Tool via one of the methods detailed in chapter Start the PowerTerm
WebConnect Administration Tool
Launching the Administration Tool from the system tray or using the
Administration Tool launched after completed installation will not allow you to
activate certain features
After you launched the Administration Tool and connected to the server you will receive a
Welcome screen where you select desired activity
bull Publish Multiple Applications opens the Publish Multiple Applications wizard
bull Configure Load Balancer opens PowerTerm Load Balancer Administration Tool
bull Create a Host Connection opens the Add Connection dialog
bull Configure Active Directory opens the Directory Services dialog
PowerTerm WebConnect 13 Getting Started Guide
Close the Welcome screen to enter the Administration Tool main
screen
The Administration Tool main screen has three sections
bull User section lists all users defined in the server
bull Group section lists all groups defined in the server
bull Connection section lists all connections and published applications defined in the
server
By default only the Connection section is displayed when you first open Administration Tool
There are three predefined example-connections ldquoExample_As400rdquo ldquoExample_VTrdquo and
ldquolocalhostrdquo You can test them prior to defining your own
1 Right click the connection you want to test and select Test The PowerTerm
WebConnect HostView Login dialog appears
2 Type example for User Name and example for Password
Credential fields are case sensitive
3 Click Login The desired connection with its pre-programmed demo application is
launched
PowerTerm WebConnect 14 Getting Started Guide
31 Publishing Applications and Documents
In order to enable access to applications and documents on Windows Terminal Servers
publish these applications and documents from the Administration Tool When publishing
applications and content you can specify which servers will be used in a Terminal Server
cluster and which users and groups will have access to these services Once you have
published such applications and documents the RemoteView client can be used to access
them
If you need to provide access to multiple applications on a Terminal Server use the Multiple Application Publishing wizard to significantly reduce the time and
effort required to publish these applications
To publish multiple Windows applications
1 Click Publish Multiple Applications in the Welcome screen The Choose Terminal Server
for Browsing dialog appears
2 Provide the address of the Terminal Server which will be used for browsing and click OK The Application Publisher Step 1 dialog appears This dialog lists all the
applications available in the specified serverrsquos Start menu
3 Select those applications found in the Programs folder of the designated server that you want to publish and click Next The Application Publisher Step 2 dialog appears
4 Determine the destination of your publishing and click Next The Application Publisher
Step 3 dialog appears
5 Determine the Color Quality of your published application
6 Determine the start mode in which you want to run the published application - normal maximized or minimized - and click Next The Application Publisher Step 4
dialog appears
7 Choose the connection speed that matches your infrastructure The connection speed
setting determines the value of three visual effects settings You can also override
these settings specifically
8 Determine whether you prefer the window to display their content while being
dragged or just the outline By default the same setting is used as the client desktop
9 Click Next The Application Publisher Step 5 dialog appears
10 Specify where sounds are to be played ndash locally or remotely
11 Determine which local devices the remote session will have access to (local drivers printer etc) and click Next The Application Publisher Step 6 dialog appears
12 If you have the PowerTerm Load Balancer installed Use all Servers (default) allows the application to run on any Terminal Server in the
cluster This setting is appropriate when the application is installed on all the Terminal
Servers Alternatively you select specific Terminal Servers on which to run this
application
If you have not installed the PowerTerm Load Balancer you will need to explicitly
specify the address of the Terminal Server on which the application will be run
PowerTerm WebConnect 15 Getting Started Guide
13 Click Next The Application Publisher Step 7 dialog appears
14 Select the users groups or OUs to which you wish to publish the applications and click Next The Application Publisher Step 8 dialog appears By default applications will
be published to everybody
15 Click Advanced Settings to modify settings such as the login credentials to the
Terminal Servers By default PowerTerm WebConnect credentials will be passed
through to the Terminal Server
16 Click Finish The published applications appears in the Connection List
Right-click and select Properties or double click on the published application in the
Connections list to view and modify any of the settings which you previously
defined
To publish a remote Desktop
1 Select Action | New | Remote Desktop The Application Publisher Step 1 dialog appears
2 Type the Display Name which will be the name presented to the end-users and click
Next The Application Publisher Step 2 dialog appears
3 Specify where icons for the published desktop will be displayed to the end-user in Publish to
4 Click Choose Icon to replace the desktoprsquos default icon Select the desired icon from
the list that appears
5 Click Next The Application Publisher Step 3 dialog appears
6 Determine Screen Size and the Color Quality of the published desktop
7 If desirable select Show Connection Bar in Full Screen Mode
8 Click Next The Application Publisher Step 4 dialog appears
9 Choose the connection speed that matches your infrastructure The connection speed
setting determines the value of three visual effects settings You can also override
these settings specifically
10 Click Next The Application Publisher Step 5 dialog appears
11 Specify where sounds are to be played ndash locally or remotely Where to Apply Window
Key Combinations and which local devices you want to automatically connect to when
logged on to the remote computer
12 Click Next The Application Publisher Step 6 dialog appears
13 Specify the Server Address and Port Number of the Terminal Server that weill provide
the desktop and click Next The Application Publisher Step 7 dialog appears
14 Select the users groups or OUs to which you wish to publish the desktop and click Next The Application Publisher Step 8 dialog appears
Select the Server group to allow all users to access the published application
15 Click Advanced Settings to modify settings such as the login credentials to the
Terminal Servers By default PowerTerm WebConnect credentials will be used
PowerTerm WebConnect 16 Getting Started Guide
16 Click Finish The published application appears in the Connection List
Right-click Properties or double click on the published application in the
Connections list to modify any of the settings which you previously defined
32 Create Terminal Emulation Connections
To provide access to legacy host systems you will need to create Terminal Emulation
connections For each such connection you can specify the host address emulation type
login script and more Once you have created these connections users will be able to
launch them using HostView (Windows or Linux) WebView or the Java client as
appropriate
1 Click Create a Host Connection in the Welcome screen The Add Connection dialog
appears
2 Enter a Name for the new connection
3 Specify an Owner for the new connection The possibilities are
[None] the connection will not be allowed to run by anyone and it will not be
displayed in any Connection list Server the connection will be accessible for all users of this PowerTerm
WebConnect server A specific group the connection will be accessible for all users of the specified
group A specific user the connection will be accessible for a specified user only
4 Leave category Terminal Emulation selected
5 Select Terminal Type Terminal Model and Communication Type as needed
6 Specify the Host Name or IP address of your host
7 Specify other parameters as needed
8 Select the Security Type as needed if your host supports SSL or SSH and specify
the appropriate details in the Details dialog
9 Use the Settings Key Mapping and Power Pad options to further customize the
connection
10 Click OK and the connection is created
33 Test Connections
It is recommended to test published applications or host connections before they are made
available to end-users
To test a connection
bull Right-click the target connection from the Connection section of the main screen and
select Test
Alternatively
PowerTerm WebConnect 17 Getting Started Guide
1 Select Tools | Run ltdesired clientgt The Login to WebConnect dialog appears
2 Enter the User Name and Password for the individual who owns the connection that
you want to test and click Login The desired PowerTerm WebConnect client is started
and the Connect dialog appears
3 Select the desired connection and click Connect The test is executed
34 Launch the Application Zone or the Application Portal
Users can access the published applications from the Application Zone application launcher
or from the Application Portal web interface
To use the Application Zone go to Start menuProgramsEricom SoftwarePowerTerm
WebConnect 5x and select Client URLs Alternatively type the following URL into your Web
browserrsquos address bar httpltserver addressgtWebConnect5xClientURLshtml In the
page that opens click on the Run button next to the Application Zone to launch it
To use the Application Portal go to Start menuProgramsEricom SoftwarePowerTerm
WebConnect 5x and select it Alternatively type the following URL into the Web browserrsquos
address bar httpltserver addressgtWebConenct5xportalwindowsindexasp
35 Monitor a Users Sessions
From the Administration Tool you can monitor the users sessions and may intervene if
necessary This intervention may result in your input appearing on the users screen The
user receives a notification when an administrator begins and ends monitoring the session
1 Select View | Client Sessions or click to see all the active client sessions
2 Select the desired active session and right-click Attach The Password Verify dialog
appears
3 Enter your password and click OK Some notification dialogs appears and the selected
PowerTerm WebConnect session is viewed
36 View Intruders
bull The Intruders window shows suspected attempts at breaching security After several
suspected intrusion attempts users are blocked temporarily
bull In addition to showing suspected intrusion attempts the Intruders window allows
you to remove restrictions on users
bull Select View | All Intruders or click
PowerTerm WebConnect 18 Getting Started Guide
4 Accessing Virtual Desktops and Blade PCs with PowerTerm WebConnect
This chapter provides instructions on configuring PowerTerm WebConnect for Virtual
Desktop Infrastructure (VDI)
41 Step 1 Launch DeskView Administration Tool
Verify that PowerTerm WebConnect is installed on your server and launch PowerTerm
WebConnect Admin Tool
bull Select Tools | Open VDI Manager The PowerTerm WebConnect DeskView Administration
Tool opens
The first time you launch the DeskView Administration Tool you will be prompted to install
the tool
PowerTerm WebConnect 19 Getting Started Guide
Microsoft Management Console 30 is required for PowerTerm WebConnect DeskView
Administration Tool If you do not have this installed you will also automatically be
prompted to install this update
Follow the installation processes when you are prompted for either install PowerTerm
WebConnect DeskView Administration Tool will automatically launch when these
installations are completed
42 Step 2 Add a Host
1 Right-click Virtualization Hosts and select Add Host The Add a New Host wizard
opens Click Next
2 Enter a Host Name as you would like it to appear in PowerTerm WebConnect
DeskView Administration Tool and a description (optional) Click Next
3 Specify the Virtualization Server type and click Next
4 Specify the connection information and click Next
VMWare Virtual Center v1x and 2x
Specify the HTTPS Web Service address and a UsernamePassword that can access
the host
VMWare Virtual Server 2005
Click Start and then Run
Type ldquoservicesmscrdquo and click OK
Scroll down to PowerTerm WebConnect DeskView Server service and open
Properties
Change the Login Account for the service to match the Domain Administrator
account and password used when setting up Microsoft Virtual Server 2005 and
restart the service Enter the IP or NETBIOS name of the Microsoft Virtual Server 2005 server as the
Server Address in the Connection Broker Wizard
Xen Server
Specify the hypervisor IP address or NETBIOS name the Root UsernamePassword
to the hypervisor and the Service port (default 80)
Oracle VM
Specify the Serverrsquos agent URL and Port (default 8899) for example
httpsltservernamegt8899
Specify the Oracle VM hypervisorrsquos Oracle Agent UsernamePassword (default
username oracle)
5 Click Finish to add the new Host
To configure Virtual Machines for use install the Ericom Tools (vmagentmsi) on each of the
virtual machines on the new host for PowerTerm WebConnect DeskView to recognize them
The vmagentmsi installer is located on the PowerTerm WebConnect server in ltPowerTerm
WebConnect installation foldergtAddOnsDeskView VDI folder (default installation
PowerTerm WebConnect 20 Getting Started Guide
folder is xProgram FilesEricom SoftwareWebConnect 56) During installation you
will need to enter the DeskView IP address or NETBIOS name
If you are using Microsoft Virtual Server 2005 as your Virtualization Host use the
IP address of the DeskView server only when installing the Ericom Tool package
43 Step 3 Create a Pool
Pools are used to organize Virtual Machines (VM) into logical groups This enables
organizations to combine and order resources from multiple systems into one entity To
access available resources end-users simply connect to PowerTerm WebConnect to access
any configured resource
1 Right-click Pools and select Create Pool The Create a Pool wizard opens Click
Next
2 Enter a Pool name as you wish it to appear and a description (optional) and click
Next
3 Specify the Pool type and click Next
4 Specify the Assignment type and click Next
Permanently will cause a virtual machine to affix to the user who has launched
that virtual machine For the duration of the session will cause any virtual machine that is not in use to
be returned to the pool for any user to launch
5 Specify the LogoffDisconnect event and click Next
Select what you would like to happen after a user logs off from a virtual machine
in this pool
Select what you would like to happen when a user is disconnected from a virtual
machine in this pool
6 Click Finish to add the new Pool
You will need to assign virtual machines from your virtualization hosts to your created pool
1 Right-click the pool and select Assign Machines The Assign Machines to ltyour
pool namegt dialog opens
2 Highlight the desired virtual machine(s) and click Select Click OK
44 Step 4 Publish an ApplicationDesktop
1 Return to PowerTerm WebConnect Admin Tool to publish DeskView pools
2 Determine whether to publish a full desktop or a seamless application running
from a virtual desktop
For a full desktop
Select Action | New | Remote Windows Desktop
For a seamless application
Select Action | New | Windows Application
PowerTerm WebConnect 21 Getting Started Guide
3 Select Virtual Desktop in the first step of the wizard and click Next
4 Follow the wizardrsquos instructions until you reach the Virtual Desktops step
5 Select a pool that you previously created and that you would like this connection to choose virtual machines from Click Next
6 Continue and complete the reminder of the wizardrsquos steps
Once the resource is published users who have been assigned access will be able to use it
immediately
PowerTerm WebConnect 22 Getting Started Guide
5 Download and Run PowerTerm WebConnect Clients
PowerTerm WebConnect clients are automatically downloaded and installed onto the client
devices For detailed information and samples please refer to the PowerTerm WebConnect
Sample URLs page To see this page navigate your browser to
httpltweb_servergtWebConnect5xClientURLshtml
PowerTerm WebConnect 23 Getting Started Guide
6 PowerTerm WebConnect Client for Lotus Expeditor
61 Installation Package
PowerTerm WebConnect client for Lotus Expeditor is provided to IBM in an Update Site
package This is a ZIP archive containing the Update Site with the Eclipse feature and plug-
in that comprises the PowerTerm WebConnect client
Extract the ZIP file keeping the foldersrsquo structure intact
NOTE In Winzip verify that the ldquoUse folder namesrdquo option is set to TRUE
Package structure
Update Site
- plugins
- PowerTermWebConnectClient_560365jar
- features
- comericomWebConnect_560365jar
- sitexml
config
- webconnectxml
Definitions
bull webconnectxml PowerTerm WebConnect client configuration file
bull comericomWebConnect_560365jar PowerTerm WebConnect client feature file
bull PowerTermWebConnectClient_560365jar PowerTerm WebConnect client plugin file
62 Pre-installation steps
PowerTerm WebConnect client for Lotus Expeditor does not run independently but in
conjunction with PowerTerm WebConnect Server You can either install it and define your
users groups and applications or use Ericom Softwarersquos Demo PowerTerm WebConnect
Server
bull If you decide to install PowerTerm WebConnect Server you will need the full
installation ie the PowerTerm WebConnect Server and the Web components If you
do not have the installation CD you can download and install a trial version from
wwwericomcom
PowerTerm WebConnect 24 Getting Started Guide
bull If you decide to use Ericom Softwarersquos Demo PowerTerm WebConnect Server then
skip to the chapter Installing PowerTerm WebConnect Client on Lotus Expeditor
63 Install PowerTerm WebConnect Portlet on IBM Workplace server (for Windows OS)
Step 1 Install PowerTerm WebConnect Server
If PowerTerm WebConnect Server and IBM Workplace Server are on separate machines
bull Configure PowerTerm WebConnect Server
Launch PowerTerm WebConnect Administration Tool
Open Files | Configuration | Main
In the [Portal] section edit
Machines=localhostltIBM sever machinegt
bull Configure PowerTerm WebConnect Web components
Copy the ldquowebrdquo folder from the PowerTerm WebConnect server installation to the
IBM Workplace server machine
Create an Alias or a Virtual directory to it named WebConnect on the Web
server providing access to it for the users This is in order to enable the users to
download the necessary files to run their applications
Step 2 Enable JSR portlets
1 On IBM Workplace Server go to ltPortalServergtsharedappconfigservicesConfigServiceproperties
2 Edit portalenablejsr168=true
3 Save and close the file
Step 3 Enable SSO
1 On IBM Workplace Server go to ltPortalServergtsharedappconfigservicesLoaderServiceproperties
2 Edit commandpath=comericomportalcommandscomibmwpsenginecommands
3 Save and close the file
Step 4 Copy Files
The following files need to be copied from WebConnect ServerAddOnsIBM
WorkplacePortlet folder to IBM Workplace Server
File name to copy Destination folder
OpenSSLdll ltAppServergtjavajrebin
IbmPortaldll ltAppServergtjavajrebin
IbmPortalini ltAppServergtjavajrebin
PowerTerm WebConnect 25 Getting Started Guide
WebConnectPortaljar ltAppServergtlib
EricomLoginjar ltPortalServergtsharedapp
Step 5 Portlet Configuration
1 On IBM Workplace Server go to ltAppServergtjavajrebinIbmPortalini
2 You can modify the following parameters in the [Server=WebConnect] section webserverport=ltIBM web server portgt
Specifies the Web server port for accessing the PowerTerm WebConnect clients folder
Default 80 Address
Specifies the address of the PowerTerm WebConnect Server machine for Portlet to
connect to when PowerTerm WebConnect Server is located on a different machine
than the IBM Workplace Server CustomAddress
Specifies the addresss of the PowerTerm WebConnect Server machine for Clients to connect to If CustomAddress is the same as Address then this may be omitted webserveraddr
Specifies the address of the Web Server machine when it is located on a different
machine than the IBM Workplace Server
3 Restart the IBM server ltPortalServergtrootscriptsstopWorkplaceServicesbat ltPortalServergtrootscriptsstartWorkplaceServicesbat
This procedure may take about 20 minutes
Step 6 Install the Portlet
1 In a Web browser open the URL httpltIBM Workplace
Servergt9081lwpmyworkplace to open the IBM Workplace Portal
2 Login as administrator
3 Go to Administration | Portlets | Install
4 Browse to the PowerTerm WebConnectwar file located on PowerTerm WebConnect
Server and click Next
5 Click Install
Step 7 Create an Application page
1 Login to the Workplace
2 Go to Portal User Interface | Manage Pages
3 Search for My Work
4 Click the My Work link and select New Page
5 Name the page PowerTerm WebConnect and click OK
6 Click OK again You will see the created page on the list
7 Click the pencil icon on the new page and select the 1 square layout
PowerTerm WebConnect 26 Getting Started Guide
8 Click Add Portlet and search for PowerTerm WebConnect
9 Select it and click OK
10 Click Done
11 Click My work at the top of the page PowerTerm WebConnect is displayed on the list
Step 8 Run the Portlet
1 Restart IBM Workplace Server
2 Open IBM Workplace Portal in a browser httpltportal servergtlwpmyworkplace
3 Login to IBM Workplace Server
4 Click My work PowerTerm WebConnect portlet is displayed
5 Launch it The Userrsquos applications as defined on PowerTerm WebConnect Server
appear
6 Click an application to launch it
64 Install PowerTerm WebConnect Portlet on IBM Workplace server (for Linux OS)
Step 1 Enable JSR 168 portlets
1 Go to optIBMWorkplacePortalServersharedappconfigservicesConfigServiceproperties
2 Modify the portalenablejsr168 property to ldquotruerdquo
3 Restart the server cd optIBMWorkplacePortalServerrootscripts
Run stopWorkplaceServicessh
Run startWorkplaceServicessh
This procedure can take up to 20 minutes
4 Log on to the workplace server at httpltworkplace servergt9081lwpmyworkplace using
the administrators username and password
Step 2 Install the portlet
1 Restart IBM Workplace Server
2 In a Web browser open the URL httpltworkplace server IPgtlwpmyworkplace
3 Login to IBM Workplace Server as an administrator
4 Go to Administration | Portlets | Install
5 Browse to the PowerTerm WebConnectwar file located on PowerTerm WebConnect
Server and click Next
6 Click Install
PowerTerm WebConnect 27 Getting Started Guide
Step 3 Install the Application page
1 Login to the workplace as administrator
2 Go to Administration | Portal User Interface | Manage Pages
3 Search for My Work
4 Click the My Work link and select New Page
5 Name the page PowerTerm WebConnect and click OK
6 Click OK again You will see the created page on the list
7 Click the pencil icon and select the 1-square layout
8 Click Add Portlet and search for PowerTerm WebConnect
9 Select it and click OK
10 Click Done
11 Click My work on top and PowerTerm WebConnect is displayed on the left bar
Step 4 Run the portlet
1 Restart IBM Workplace Server
2 Open IBM Workplace Portal in a browser httpltportal servergtlwpmyworkplace
3 Login to IBM Workplace Server
4 Click My work PowerTerm WebConnect portlet is displayed
5 Launch it The Userrsquos applications as defined on PowerTerm WebConnect Server
appear
6 Click an application to launch it
65 Install PowerTerm WebConnect Portlet on IBM WebSphere 61 server (for Windows OS)
Step 1 Install PowerTerm WebConnect Server
You have to configure PowerTerm WebConnect Server if it and the IBM WebSphere Server
are on separate machines
1 Launch PowerTerm WebConnect Administration Tool
2 Open Files | Configuration | Main
3 In the [Portal] section edit Machines=localhostltIBM sever machinegt
Step 2 Copy Files
The following files need to be copied from WebConnect ServerAddOnsIBM
WebSpherePortlet folder to IBM WebSphere Server
PowerTerm WebConnect 28 Getting Started Guide
File name to copy Destination folder
OpenSSLdll ltAppServergtjavajrebin
IbmPortaldll ltAppServergtjavajrebin
IbmPortalini ltAppServergtjavajrebin
WebConnectPortaljar ltAppServergtlib
Step 3 Portlet Configuration
1 On IBM Workplace Server go to ltAppServergtjavajrebinIbmPortalini
2 You can modify the following parameters in the [Server=WebConnect] section webserverport=ltIBM web server portgt
Specifies the Web server port for accessing the PowerTerm WebConnect clients folder
Default 80 Address
Specifies the address of the PowerTerm WebConnect Server machine for Portlet to
connect to when PowerTerm WebConnect Server is located on a different machine
than the IBM Workplace Server CustomAddress
Specifies the addresss of the PowerTerm WebConnect Server machine for Clients to connect to If CustomAddress is the same as Address then this may be omitted webserveraddr
Specifies the address of the Web Server machine when it is located on a different
machine than the IBM Workplace Server
3 Restart the IBM server ltAppServergtProfilesAppServer01binstopServerbat ltAppServergtProfilesAppServer01binstartServerbat
This procedure may take about 20 minutes
Step 4 Install the Portlet and create an Application page
1 In a Web browser open the URL httpltIBM WebSphere Servergt9060ibmconsole
to open the IBM WebSphere Portal
2 Login and go to Applications | Install New Application
3 Browse to the PowerTerm WebConnectwar file located on PowerTerm WebConnect
Server
4 Enter Context root and click Next The Select installation options dialog appears
5 Optional change options to your preference or keep the default
6 Click Next
7 Select Ericom in the Module column click Apply and then Next
8 Click Finish and then Save
9 Select Applications | Enterprise Applications
10 Select PowerTerm WebConnectwar checkbox and click Start
PowerTerm WebConnect 29 Getting Started Guide
11 Enter in the Web browser the URL httpltIBM WebSphere
Servergt9080ltContext rootgtEricom portlet The Login dialog appears
12 Login and you will see PowerTerm WebConnect displayed on the list
Step 5 Run the Portlet
1 Restart IBM WebSphere Server
2 Open IBM WebSphere Portal in a browser httpltportal servergt9080ltContext
rootgtEricom portlet
3 Login to IBM WebSphere Server
4 Launch it The Userrsquos applications as defined on PowerTerm WebConnect Server
appear
5 Click an application to launch it
66 PowerTerm WebConnect Server Configuration
bull To enable the Lotus Expeditor to run the PowerTerm WebConnect client the
System Administrator must provide the users with accounts on PowerTerm
WebConnect Server (see the PowerTerm WebConnect Administratorrsquos Manual for
instructions on how to create users groups and connections on the PowerTerm
WebConnect Server)
bull To enable PowerTerm WebConnectrsquos Single Sign-On feature the System
Administrator must create a PowerTerm WebConnect user with the same
username and password as used for the Lotus Expeditor For a managed Lotus
Expeditor the credentials used are the username and password sent to the
managing server For an unmanaged Lotus Expeditor the operation system
username and the Lotus Expeditor password are used as credentials
NOTE If a password is not defined then the Single Sign-On will fail and the user will be
prompted with a login dialog
67 PowerTerm WebConnect Client Configuration
The PowerTerm WebConnect client is configured in webconnectxml located in the config
folder webconnectxml parameters are
url The PowerTerm WebConnect Agent url
server The PowerTerm WebConnect Server address
sso The Single Sign-On feature
dst The local destination for downloading PowerTerm WebConnect
components
PowerTerm WebConnect 30 Getting Started Guide
url
PowerTerm WebConnect components are installed on a Web server Their default url is
Windows Agent
httpltWebServer IPgtWebConnectwindowsptagentcab
Linux Agent
httpltWebServer IPgtWebConnectlinuxix86qterm-wczip
The url parameter must include the first part of the url (which is identical for both Windows
and Linux agents)
The PowerTerm WebConnect client will automatically append the appropriate suffix in
order to create a full accurate url
Example
ltitem key=rdquourlrdquo value=httpadminserverWebConnectgt
server
The computer name or IP address of the PowerTerm WebConnect Server machine
The PowerTerm WebConnect client will log in to this PowerTerm WebConnect Server
display the applications defined on it and run them according to this serverrsquos configuration
Format ltserver IPgt[ltportgt]
where default port is 4000 (can be edited)
Example
ltitem key=rdquoserverrdquo value=rdquoadmin24000rdquogt
sso
Determines whether Single Sign-on will be used to log in to PowerTerm WebConnect
Server Values
bull True (default) the client should automatically log in to the PowerTerm WebConnect
Server using the same credentials as the ones used to log in to the Lotus Expeditor
client
The System Administrator must verify that these credentials can log in to the
PowerTerm WebConnect Server
bull False the user will be prompted with a login dialog or will log in automatically using
previously saved credentials
Example
ltitem key=rdquossordquo value=rdquotruerdquogt
Autologin mode
PowerTerm WebConnect 31 Getting Started Guide
If sso is set to True the user is not prompted for credentials and the login process to
PowerTerm WebConnect Server is done automatically sending the credentials used for the
Lotus Expeditor unless the Lotus Expeditor does not have a password defined (In the
Lotus Expeditor preferences page | Password| Prompt me for a password at start up checkbox)
However if Single Sign-on is not used there are several options regarding Autologin that
can be defined in the PowerTerm WebConnect Preferences page Options
bull Yes
bull No
bull Interactive
bull First time interactive (default) ndash Simplifies the login process to PowerTerm
WebConnect Server In this mode the first time the user logs in to PowerTerm
WebConnect Server he will be prompted for his credentials with the Login dialog
These credentials will be stored in the machine and from then on the login process to
PowerTerm WebConnect Server will be done automatically
1 Open File | Preferences from the Lotus Expeditor and select PowerTerm WebConnect
2 In the Autologin to WebConnect Server section select First Interactive and click OK
3 Start PowerTerm WebConnect Client for Lotus Expeditor If credentials were entered
at least once then the next time the client will connect to PowerTerm WebConnect
Server without prompting for the user name and password
The Administrator must configure the Agent to do nothing when it exits for the
feature to work this way See PowerTerm WebConnect Administratorrsquos Manual for more information about defining Autologin
bull Allow multiple selection ndash Defines whether the user can launch more than one
application at a time (by using the ltCtrlgt or ltShiftgt button while selecting applications)
dst
Defines the path to download PowerTerm WebConnect components on the client machine
The dst parameter can contain macros which are translated by the PowerTerm WebConnect
Client for Lotus Expeditor during runtime The macros should be placed between percent
symbols () for example WebServer
When such a value is defined the PowerTerm WebConnect Client for Lotus Expeditor
substitutes the entire expression for the macrorsquos value
The PowerTerm WebConnect Client for Lotus Expeditor does not support the use
of environment variables as macros
Macros are not case sensitive
Macros supported by PowerTerm WebConnect Client for Lotus Expeditor
Macro name Description
WebServer The name of the Web server
It is obtained from the PowerTerm WebConnect Agent url
PowerTerm WebConnect 32 Getting Started Guide
parameter
Name The name of the clientrsquos CAB or ZIP file eg ldquoptagentrdquo
Display The clientrsquos display name from the version file
Version The clientrsquos version value It is obtained from the version
file
Root The default root location
Windows ldquoCrdquo
LinuxUnix an empty string
OSDir Windows Windowsrsquo installation directory for example
ldquoCWindowsrdquo
Linux an empty string
OSDrive Windows Windowsrsquo installation drive for example ldquoCrdquo
Linux an empty string
HomePath Windows The HOMEPATH environment variable
Linux The HOME environment variable
Home The Ericom folder in the userrsquos home directory
Windows CDocuments and SettingsltusergtApplication
DataEricom
Linux ltusergtEricom
In addition to the predefined macros listed above the PowerTerm WebConnect client
supports the usage of Java System Properties
Java System Properties available for users on Windows XP SP2
Java System Property Name Value Example
javaversion 150
javavendorurl httpwwwibmcom
javahome CIBMcommonpluginscomibmpvcwctruntim
esj2sewin32x86_150SR2-
20060511rcpeclipsepluginscomibmrcpj2sew
in32x86_150SR2-20060511jre
javavmspecificationversion 10
javavmversion 23
javavmvendor IBM Corporation
javavmname IBM J9 VM
PowerTerm WebConnect 33 Getting Started Guide
javaiotmpdir CDOCUME~1dianaLOCALS~1Temp
javacompiler j9jit23
javaextdirs CIBMcommonpluginscomibmpvcwctruntim
esj2sewin32x86_150SR2-
20060511rcpeclipsepluginscomibmrcpj2sew
in32x86_150SR2-20060511jrelibext
osname Windows XP
osarch x86
osversion 51 build 2600 Service Pack 2
pathseparator
username Jone
userhome CDocuments and SettingsJone
userdir CIBMRSA
usertimezone GMT+0200
System properties available for users on Linux RedHat 9
Java System Property Name Value Example
javaversion 150
javavendorurl httpwwwibmcom
javahome usrjavajre150_07
javavmversion 150
javavmvendor IBM Corporation
javavmname IBM J9 VM
javaclasspath
javalibrarypath
javaiotmpdir tmp
javacompiler
javaextdirs
osname Linux
osarch i386
osversion 2420-8
pathseparator
PowerTerm WebConnect 34 Getting Started Guide
username root
userhome root
userdir root
System properties names are placed in the configuration file within percent symbols ()
(like macros)
671 Configure the PowerTerm WebConnect Client
1 Open the Config Folder and edit the webconnectxml file Example
ltxml version =rdquo10rdquo encoding=rdquoUTF-8rdquogt
ltsection name=rdquoparametersrdquogt
ltitem key=rdquourlrdquo value=httpadminserverWebConnect56gt
ltitem key=rdquoserverrdquo value=rdquoadmin24000rdquogt
ltitem key=rdquossordquo value=rdquotruerdquogt
ltitem key=rdquodestrdquo value=rdquoCProgram FilesEricomrdquogt
ltsectiongt
2 Save the customized webconnectxml to a Web server folder available to all users It is
recommended to use the same Web server as the PowerTerm WebConnect Agent
Example
ltWebConnect installation foldergtwebwebconnectxml
3 Test the accessibility to this file - Type the URL of webconnectxml in the browser
Example
httpltWebServer IPgtWebConnectwebconnectxml
The contents of the file should be displayed
672 Configure the Preferences File
1 Open the plugins folder and open the PowerTermWebConnectClient_560365jar file
You can use Winzip version 70 and up or in Windows XP ndash Create a new file type for the
jar extension click advanced and select compressed (zipped) folder in the drop down list
Now you can open the JAR files in the Windows Explorer
The default contents of the file
configURL=httpleericomcomWebConnectwebconnectxml
2 Specify the accurate URL of the webconnectxml file Example
httpltWebServer IPgtWebConnectwebconnectxml
3 Save the file and close it The WinZip will display the following dialog
ldquoFile preferencesini has been changed since it was extracted Update archive
with this filerdquo
PowerTerm WebConnect 35 Getting Started Guide
4 Click Yes and close the archive
If you are editing the file from within the explorer you will have to save the file elsewhere
and then drag it to the explorer window where the JAR file is open
68 Installing PowerTerm WebConnect Client on Lotus Expeditor
1 Start the Lotus Expeditor client
2 Select File | Application | Install
3 Select Search for new features to install and click Next
4 Select Add Folder Location and type or select the location of the update site folder from
the provided package Click OK
5 Select the location you have just created and click Finish
6 In the Select the feature to install tree select Powerterm WebConnectUpdate Site Click
Next
7 Select I accept the terms in the license agreements and click Next
8 Click Finish
9 When prompted restart the platform
69 Running PowerTerm WebConnect Client for Lotus Expeditor
1 Click Open The PowerTerm WebConnect option is displayed
2 Select PowerTerm WebConnect The application will automatically connect and start
downloading the components from PowerTerm WebConnect Server
IMPORTANT
If you did not install PowerTerm WebConnect Server and are instead connecting to Ericom
Softwarersquos Demo WebConnect Server then you need to open port 443 in the firewall
691 PowerTerm WebConnect Client Workflow
1 PowerTerm WebConnect client reads the URL of webconnectxml from the preferencesini
file and requests it
2 When the webconnectxml is successfully downloaded the application reads the
configuration connects to the specified Web server downloads the PowerTerm
WebConnect components and connects to the PowerTerm WebConnect Server
3 The user is requested to login to the PowerTerm WebConnect Server For testing you
can use the username Example and password example
This step will be skipped if Single Sign-on is set to ldquotruerdquo
PowerTerm WebConnect 36 Getting Started Guide
4 After logging in to PowerTerm WebConnect Server the userrsquos applications are displayed
as defined by the administrator
5 To run an application select the desired application from the list and click Launch or
double-click the application The application will be launched in a separate window
610 Troubleshooting
When you encounter a problem the first step is to open the log file This file is located on
the client machine in the Ericom folder
Windows
CDocuments and SettingsltusernamegtEricomleclientEricomPluginlog
Linux
ltuser-home-directorygtEricomleclientEricomPluginlog
Following is a guide for diagnosing and fixing the problems in cases of error messages and
additional information
Error
Message
Solution
Version File
reading error
1 Check the lsquourlrsquo parameter in the webconnectxml file on the Web
server The value should be
httpltWebServerIPgtWebConnect
2 Try to run the following URL on the browser
Windows
httpltWebServerIPgtWebConnectwindowsptagentvertxt
Linux
httpltWebServerIPgtWebConnectlinuxix86qterm-
wcvertxt
The file contents displayed in the browser window should be in
the following form
560-rel14546
PowerTerm WebConnect Application Zone
560 - Main Release
ltrootgtPowerTerm WebConnect 56ltWebServergt
If the version file contents are not as shown check
- Is the Web Server running
- Are PowerTerm WebConnect Web Components and version files
PowerTerm WebConnect 37 Getting Started Guide
in place
3 On the Web server check ltPowerTerm WebConnect
rootgtwebwindowsptagentvertxt If the contents ldquolook wrongrdquo or
not in the proper form reinstall the PowerTerm WebConnect Web
components
4 On the client machine open the aforementioned URL in the
browser The file content should appear in the browser If it does
not it could be that the Web server is down
Web Server is
shut down
The webconnectxml configuration file must be located on the Web
server The explicit URL to this file is defined in the preferencesini
file (see Configure the Preferences File)
The error message contains the IP address of the Web server
Verify that the Web server on this machine is running
Version file
does not exist
on ltURLgt
See Version File reading error
The
configuration
file is not
accessible or
has a wrong
format
The webconnectxml configuration file must be located on the Web
server and the explicit URL to the configuration must be defined in
the preferencesini file (see Configure the Preferences File)
Try to open the URL specified in the error message in the
browser If it does not open then it either does not exist or it has
a wrong format
Preferences
file does not
exist in the
application
bundle
The preferencesini file containing the URL to the configuration
file was removed from the update site folder
Uninstall the current PowerTerm WebConnect client from the
client machine Create a new customized package (see
PowerTerm WebConnect Client Configuration) and reinstall it
Configuration
file URL is not
defined in
preference
file
The URL to the configuration file does not appear in the
preferencesini file (see Configure the Preferences File)
Uninstall the current PowerTerm WebConnect client from the
client machine Create a new customized package (see
PowerTerm WebConnect Client Configuration) and reinstall it
No IP address
could be
found for the
host
The Web server URL specified in the preferencesini file (see
Configure the Preferences File) or in the webconnectxml file (see
Configure the PowerTerm WebConnect Client) is an unknown
host
If the mistake is in the preferencesini file uninstall the current
PowerTerm WebConnect client from the client machine Create a
new customized package (see PowerTerm WebConnect Client
Configuration) and reinstall it
PowerTerm WebConnect 38 Getting Started Guide
If the mistake is in the webconnectxml file correct the file reopen
the Lotus Expeditor client
Cannot write
to destination
The temporary file cannot be written to the defined destination
Check the write permissions
Copied
configuration
file has wrong
format
The webconnectxml file as received from the specified URL has a
wrong format Correct the file and try again
PowerTerm
WebConnect
Agent URL is
malformed
The PowerTerm WebConnect Agent URL specified in the
webconnectxml file (see Configure the PowerTerm WebConnect
Client) does not have a proper HTTP format Correct the file and
try again
PowerTerm
WebConnect
Agent URL is
not defined
The PowerTerm WebConnect Agent URL parameter is not specified
in the webconnectxml file (see Configure the PowerTerm
WebConnect Client)
Correct the file and try again
The specified
destination
folder name
is wrong
The destination folder name contains illegal characters
ltgt|
Check the dst parameter in the webconnectxml file Correct the
file and try again
You do not
have
permissions
to write to
ltpathgt
The PowerTerm WebConnect Agent cannot be written to the
destination as defined Check the write permissions
The default destination defined in the version file should not to
be changed
A customized destination for PowerTerm WebConnect Agent
downloading can be defined in the webconnectxml file (See
Configure the PowerTerm WebConnect Client)
Check the destination value correct and try again
PowerTerm WebConnect 39 Getting Started Guide
About Ericom
Ericomreg Software is a leading provider of Application Access and Virtualization Solutions
Since 1993 Ericom has been helping users access enterprise mission-critical applications
running on a broad range of Microsoftreg Windowsreg Terminal Servers virtual Desktops
Blade PCs legacy hosts and other systems Ericom provides concrete business value by
helping organizations realize the benefits of their IT investments With offices in the United
States United Kingdom EMEA India and China Ericom also has an extensive network of
distributors and partners throughout North America Europe Asia and the Far East Our
expanding customer base is more than 30 thousand strong with over 7 million
installations
For more information on our products and services contact us at the location nearest to you
And visit our web site httpwwwericomcom
North America Western Europe International
Ericom Software Inc Ericom Software (UK) Ltd Ericom Software Ltd
231 Herbert Avenue Bldg 4 11a Victoria Square 8 Hamarpeh Street
Closter NJ 07624 USA Droitwich Worcestershire Har Hotzvim Technology Park
Tel +1 (201) 767 2210 WR9 8DE United Kingdom Jerusalem 91450 Israel
Fax +1 (201) 767 2205 Tel +44 (0) 845 644 3597 Tel +972 (2) 591 1700
Toll-free 1 (888) 769 7876 Fax +44 (0) 845 644 3598 Fax +972 (2) 571 4737
Email infoericomcom Email infoericomcouk Email infoericomcom
PowerTerm WebConnect 10 Getting Started Guide
On Suse
etcrcdwebconnectd stop
24 Install the Terminal Server Agent
PowerTerm WebConnect Terminal Server Agent must be installed on a Terminal Server
accessed using PowerTerm WebConnect It provides the True Seamless Windows
functionality for published applications remote browsing and publishing and Application
Load Balancing
The PowerTerm WebConnect Terminal Server Agent must be installed on every Terminal
Server in the cluster If you install the PowerTerm WebConnect server itself on a Terminal
Server you will be given the option to install the Terminal Server Agent as a part of the
server installation Alternatively use the PowerTermTerminalServerAgentexe file located in
the AddOnsTerminalServerAgent subdirectory under the PowerTerm WebConnect server
installation directory
To complete the installation you might need to restart the Terminal Server machine
25 Install PowerTerm WebConnect DeskView Server
PowerTerm WebConnect DeskView is automatically installed when you run PowerTerm
WebConnect Installation wizard ndash Full installation To run PowerTerm WebConnect
DeskView Server you also need Microsoft NET Framework v30 to be installed on your
computer If you do not have it installed then the installation wizard will place the
DeskViewServerSetupmsi and DeskViewAdminSetupmsi files in the AddOns folder
(ltPowerTerm WebConnect Installation FoldergtWebConnect 5xAddOnsDeskView
VDI) from where you can run the msi files at a later stage to install PowerTerm
WebConnect DeskView
26 Start the PowerTerm WebConnect Administration Tool
There are several ways to launch the PowerTerm WebConnect Administration Tool Select
the one most convenient for you
bull From Windows Start menu select Programs | Ericom Software | PowerTerm WebConnect
5x | PowerTerm WebConnect Administration Tool
If you changed the Program Folder during installation the Start menu path
may vary
bull Double-click PtAdminexe PtAdminexe is located in the bin directory of the
PowerTerm WebConnect installation folder
bull Rather than installing you can choose to download the Administration Tool to any
Windows computer Please refer to the PowerTerm WebConnect Sample URLs
page (httpltweb_servergtWebConnect5xClientURLshtml) for more details
A few things to remember
PowerTerm WebConnect 11 Getting Started Guide
When you launch the PowerTerm WebConnect Administration Tool for the first time the Connection dialog is displayed with the user Administrator No
password is required to enter just click Connect
In the Connection dialog (displayed when launching the Administration Tool) the
Host Name is localhost by default This is correct only if the Administration Tool
runs on the same machine as the server If the Administration Tool runs on a different machine you need to change the Host Name to the IP addressHostname
of the PowerTerm WebConnect server
When using the PowerTerm WebConnect Windows edition by default the
Administration Tool will deny any connection attempts from any computer other
than the local machine
PowerTerm WebConnect 12 Getting Started Guide
3 PowerTerm WebConnect Administration Tool at a Glance
PowerTerm WebConnect Administration Tool manages published applications user sessions
and server configuration The administrator can perform operations such as multiple
application publishing sending messages to logged-on users shutting down sessions and
monitor user activity
To perform the tasks described in this chapter you must launch the Administration Tool via one of the methods detailed in chapter Start the PowerTerm
WebConnect Administration Tool
Launching the Administration Tool from the system tray or using the
Administration Tool launched after completed installation will not allow you to
activate certain features
After you launched the Administration Tool and connected to the server you will receive a
Welcome screen where you select desired activity
bull Publish Multiple Applications opens the Publish Multiple Applications wizard
bull Configure Load Balancer opens PowerTerm Load Balancer Administration Tool
bull Create a Host Connection opens the Add Connection dialog
bull Configure Active Directory opens the Directory Services dialog
PowerTerm WebConnect 13 Getting Started Guide
Close the Welcome screen to enter the Administration Tool main
screen
The Administration Tool main screen has three sections
bull User section lists all users defined in the server
bull Group section lists all groups defined in the server
bull Connection section lists all connections and published applications defined in the
server
By default only the Connection section is displayed when you first open Administration Tool
There are three predefined example-connections ldquoExample_As400rdquo ldquoExample_VTrdquo and
ldquolocalhostrdquo You can test them prior to defining your own
1 Right click the connection you want to test and select Test The PowerTerm
WebConnect HostView Login dialog appears
2 Type example for User Name and example for Password
Credential fields are case sensitive
3 Click Login The desired connection with its pre-programmed demo application is
launched
PowerTerm WebConnect 14 Getting Started Guide
31 Publishing Applications and Documents
In order to enable access to applications and documents on Windows Terminal Servers
publish these applications and documents from the Administration Tool When publishing
applications and content you can specify which servers will be used in a Terminal Server
cluster and which users and groups will have access to these services Once you have
published such applications and documents the RemoteView client can be used to access
them
If you need to provide access to multiple applications on a Terminal Server use the Multiple Application Publishing wizard to significantly reduce the time and
effort required to publish these applications
To publish multiple Windows applications
1 Click Publish Multiple Applications in the Welcome screen The Choose Terminal Server
for Browsing dialog appears
2 Provide the address of the Terminal Server which will be used for browsing and click OK The Application Publisher Step 1 dialog appears This dialog lists all the
applications available in the specified serverrsquos Start menu
3 Select those applications found in the Programs folder of the designated server that you want to publish and click Next The Application Publisher Step 2 dialog appears
4 Determine the destination of your publishing and click Next The Application Publisher
Step 3 dialog appears
5 Determine the Color Quality of your published application
6 Determine the start mode in which you want to run the published application - normal maximized or minimized - and click Next The Application Publisher Step 4
dialog appears
7 Choose the connection speed that matches your infrastructure The connection speed
setting determines the value of three visual effects settings You can also override
these settings specifically
8 Determine whether you prefer the window to display their content while being
dragged or just the outline By default the same setting is used as the client desktop
9 Click Next The Application Publisher Step 5 dialog appears
10 Specify where sounds are to be played ndash locally or remotely
11 Determine which local devices the remote session will have access to (local drivers printer etc) and click Next The Application Publisher Step 6 dialog appears
12 If you have the PowerTerm Load Balancer installed Use all Servers (default) allows the application to run on any Terminal Server in the
cluster This setting is appropriate when the application is installed on all the Terminal
Servers Alternatively you select specific Terminal Servers on which to run this
application
If you have not installed the PowerTerm Load Balancer you will need to explicitly
specify the address of the Terminal Server on which the application will be run
PowerTerm WebConnect 15 Getting Started Guide
13 Click Next The Application Publisher Step 7 dialog appears
14 Select the users groups or OUs to which you wish to publish the applications and click Next The Application Publisher Step 8 dialog appears By default applications will
be published to everybody
15 Click Advanced Settings to modify settings such as the login credentials to the
Terminal Servers By default PowerTerm WebConnect credentials will be passed
through to the Terminal Server
16 Click Finish The published applications appears in the Connection List
Right-click and select Properties or double click on the published application in the
Connections list to view and modify any of the settings which you previously
defined
To publish a remote Desktop
1 Select Action | New | Remote Desktop The Application Publisher Step 1 dialog appears
2 Type the Display Name which will be the name presented to the end-users and click
Next The Application Publisher Step 2 dialog appears
3 Specify where icons for the published desktop will be displayed to the end-user in Publish to
4 Click Choose Icon to replace the desktoprsquos default icon Select the desired icon from
the list that appears
5 Click Next The Application Publisher Step 3 dialog appears
6 Determine Screen Size and the Color Quality of the published desktop
7 If desirable select Show Connection Bar in Full Screen Mode
8 Click Next The Application Publisher Step 4 dialog appears
9 Choose the connection speed that matches your infrastructure The connection speed
setting determines the value of three visual effects settings You can also override
these settings specifically
10 Click Next The Application Publisher Step 5 dialog appears
11 Specify where sounds are to be played ndash locally or remotely Where to Apply Window
Key Combinations and which local devices you want to automatically connect to when
logged on to the remote computer
12 Click Next The Application Publisher Step 6 dialog appears
13 Specify the Server Address and Port Number of the Terminal Server that weill provide
the desktop and click Next The Application Publisher Step 7 dialog appears
14 Select the users groups or OUs to which you wish to publish the desktop and click Next The Application Publisher Step 8 dialog appears
Select the Server group to allow all users to access the published application
15 Click Advanced Settings to modify settings such as the login credentials to the
Terminal Servers By default PowerTerm WebConnect credentials will be used
PowerTerm WebConnect 16 Getting Started Guide
16 Click Finish The published application appears in the Connection List
Right-click Properties or double click on the published application in the
Connections list to modify any of the settings which you previously defined
32 Create Terminal Emulation Connections
To provide access to legacy host systems you will need to create Terminal Emulation
connections For each such connection you can specify the host address emulation type
login script and more Once you have created these connections users will be able to
launch them using HostView (Windows or Linux) WebView or the Java client as
appropriate
1 Click Create a Host Connection in the Welcome screen The Add Connection dialog
appears
2 Enter a Name for the new connection
3 Specify an Owner for the new connection The possibilities are
[None] the connection will not be allowed to run by anyone and it will not be
displayed in any Connection list Server the connection will be accessible for all users of this PowerTerm
WebConnect server A specific group the connection will be accessible for all users of the specified
group A specific user the connection will be accessible for a specified user only
4 Leave category Terminal Emulation selected
5 Select Terminal Type Terminal Model and Communication Type as needed
6 Specify the Host Name or IP address of your host
7 Specify other parameters as needed
8 Select the Security Type as needed if your host supports SSL or SSH and specify
the appropriate details in the Details dialog
9 Use the Settings Key Mapping and Power Pad options to further customize the
connection
10 Click OK and the connection is created
33 Test Connections
It is recommended to test published applications or host connections before they are made
available to end-users
To test a connection
bull Right-click the target connection from the Connection section of the main screen and
select Test
Alternatively
PowerTerm WebConnect 17 Getting Started Guide
1 Select Tools | Run ltdesired clientgt The Login to WebConnect dialog appears
2 Enter the User Name and Password for the individual who owns the connection that
you want to test and click Login The desired PowerTerm WebConnect client is started
and the Connect dialog appears
3 Select the desired connection and click Connect The test is executed
34 Launch the Application Zone or the Application Portal
Users can access the published applications from the Application Zone application launcher
or from the Application Portal web interface
To use the Application Zone go to Start menuProgramsEricom SoftwarePowerTerm
WebConnect 5x and select Client URLs Alternatively type the following URL into your Web
browserrsquos address bar httpltserver addressgtWebConnect5xClientURLshtml In the
page that opens click on the Run button next to the Application Zone to launch it
To use the Application Portal go to Start menuProgramsEricom SoftwarePowerTerm
WebConnect 5x and select it Alternatively type the following URL into the Web browserrsquos
address bar httpltserver addressgtWebConenct5xportalwindowsindexasp
35 Monitor a Users Sessions
From the Administration Tool you can monitor the users sessions and may intervene if
necessary This intervention may result in your input appearing on the users screen The
user receives a notification when an administrator begins and ends monitoring the session
1 Select View | Client Sessions or click to see all the active client sessions
2 Select the desired active session and right-click Attach The Password Verify dialog
appears
3 Enter your password and click OK Some notification dialogs appears and the selected
PowerTerm WebConnect session is viewed
36 View Intruders
bull The Intruders window shows suspected attempts at breaching security After several
suspected intrusion attempts users are blocked temporarily
bull In addition to showing suspected intrusion attempts the Intruders window allows
you to remove restrictions on users
bull Select View | All Intruders or click
PowerTerm WebConnect 18 Getting Started Guide
4 Accessing Virtual Desktops and Blade PCs with PowerTerm WebConnect
This chapter provides instructions on configuring PowerTerm WebConnect for Virtual
Desktop Infrastructure (VDI)
41 Step 1 Launch DeskView Administration Tool
Verify that PowerTerm WebConnect is installed on your server and launch PowerTerm
WebConnect Admin Tool
bull Select Tools | Open VDI Manager The PowerTerm WebConnect DeskView Administration
Tool opens
The first time you launch the DeskView Administration Tool you will be prompted to install
the tool
PowerTerm WebConnect 19 Getting Started Guide
Microsoft Management Console 30 is required for PowerTerm WebConnect DeskView
Administration Tool If you do not have this installed you will also automatically be
prompted to install this update
Follow the installation processes when you are prompted for either install PowerTerm
WebConnect DeskView Administration Tool will automatically launch when these
installations are completed
42 Step 2 Add a Host
1 Right-click Virtualization Hosts and select Add Host The Add a New Host wizard
opens Click Next
2 Enter a Host Name as you would like it to appear in PowerTerm WebConnect
DeskView Administration Tool and a description (optional) Click Next
3 Specify the Virtualization Server type and click Next
4 Specify the connection information and click Next
VMWare Virtual Center v1x and 2x
Specify the HTTPS Web Service address and a UsernamePassword that can access
the host
VMWare Virtual Server 2005
Click Start and then Run
Type ldquoservicesmscrdquo and click OK
Scroll down to PowerTerm WebConnect DeskView Server service and open
Properties
Change the Login Account for the service to match the Domain Administrator
account and password used when setting up Microsoft Virtual Server 2005 and
restart the service Enter the IP or NETBIOS name of the Microsoft Virtual Server 2005 server as the
Server Address in the Connection Broker Wizard
Xen Server
Specify the hypervisor IP address or NETBIOS name the Root UsernamePassword
to the hypervisor and the Service port (default 80)
Oracle VM
Specify the Serverrsquos agent URL and Port (default 8899) for example
httpsltservernamegt8899
Specify the Oracle VM hypervisorrsquos Oracle Agent UsernamePassword (default
username oracle)
5 Click Finish to add the new Host
To configure Virtual Machines for use install the Ericom Tools (vmagentmsi) on each of the
virtual machines on the new host for PowerTerm WebConnect DeskView to recognize them
The vmagentmsi installer is located on the PowerTerm WebConnect server in ltPowerTerm
WebConnect installation foldergtAddOnsDeskView VDI folder (default installation
PowerTerm WebConnect 20 Getting Started Guide
folder is xProgram FilesEricom SoftwareWebConnect 56) During installation you
will need to enter the DeskView IP address or NETBIOS name
If you are using Microsoft Virtual Server 2005 as your Virtualization Host use the
IP address of the DeskView server only when installing the Ericom Tool package
43 Step 3 Create a Pool
Pools are used to organize Virtual Machines (VM) into logical groups This enables
organizations to combine and order resources from multiple systems into one entity To
access available resources end-users simply connect to PowerTerm WebConnect to access
any configured resource
1 Right-click Pools and select Create Pool The Create a Pool wizard opens Click
Next
2 Enter a Pool name as you wish it to appear and a description (optional) and click
Next
3 Specify the Pool type and click Next
4 Specify the Assignment type and click Next
Permanently will cause a virtual machine to affix to the user who has launched
that virtual machine For the duration of the session will cause any virtual machine that is not in use to
be returned to the pool for any user to launch
5 Specify the LogoffDisconnect event and click Next
Select what you would like to happen after a user logs off from a virtual machine
in this pool
Select what you would like to happen when a user is disconnected from a virtual
machine in this pool
6 Click Finish to add the new Pool
You will need to assign virtual machines from your virtualization hosts to your created pool
1 Right-click the pool and select Assign Machines The Assign Machines to ltyour
pool namegt dialog opens
2 Highlight the desired virtual machine(s) and click Select Click OK
44 Step 4 Publish an ApplicationDesktop
1 Return to PowerTerm WebConnect Admin Tool to publish DeskView pools
2 Determine whether to publish a full desktop or a seamless application running
from a virtual desktop
For a full desktop
Select Action | New | Remote Windows Desktop
For a seamless application
Select Action | New | Windows Application
PowerTerm WebConnect 21 Getting Started Guide
3 Select Virtual Desktop in the first step of the wizard and click Next
4 Follow the wizardrsquos instructions until you reach the Virtual Desktops step
5 Select a pool that you previously created and that you would like this connection to choose virtual machines from Click Next
6 Continue and complete the reminder of the wizardrsquos steps
Once the resource is published users who have been assigned access will be able to use it
immediately
PowerTerm WebConnect 22 Getting Started Guide
5 Download and Run PowerTerm WebConnect Clients
PowerTerm WebConnect clients are automatically downloaded and installed onto the client
devices For detailed information and samples please refer to the PowerTerm WebConnect
Sample URLs page To see this page navigate your browser to
httpltweb_servergtWebConnect5xClientURLshtml
PowerTerm WebConnect 23 Getting Started Guide
6 PowerTerm WebConnect Client for Lotus Expeditor
61 Installation Package
PowerTerm WebConnect client for Lotus Expeditor is provided to IBM in an Update Site
package This is a ZIP archive containing the Update Site with the Eclipse feature and plug-
in that comprises the PowerTerm WebConnect client
Extract the ZIP file keeping the foldersrsquo structure intact
NOTE In Winzip verify that the ldquoUse folder namesrdquo option is set to TRUE
Package structure
Update Site
- plugins
- PowerTermWebConnectClient_560365jar
- features
- comericomWebConnect_560365jar
- sitexml
config
- webconnectxml
Definitions
bull webconnectxml PowerTerm WebConnect client configuration file
bull comericomWebConnect_560365jar PowerTerm WebConnect client feature file
bull PowerTermWebConnectClient_560365jar PowerTerm WebConnect client plugin file
62 Pre-installation steps
PowerTerm WebConnect client for Lotus Expeditor does not run independently but in
conjunction with PowerTerm WebConnect Server You can either install it and define your
users groups and applications or use Ericom Softwarersquos Demo PowerTerm WebConnect
Server
bull If you decide to install PowerTerm WebConnect Server you will need the full
installation ie the PowerTerm WebConnect Server and the Web components If you
do not have the installation CD you can download and install a trial version from
wwwericomcom
PowerTerm WebConnect 24 Getting Started Guide
bull If you decide to use Ericom Softwarersquos Demo PowerTerm WebConnect Server then
skip to the chapter Installing PowerTerm WebConnect Client on Lotus Expeditor
63 Install PowerTerm WebConnect Portlet on IBM Workplace server (for Windows OS)
Step 1 Install PowerTerm WebConnect Server
If PowerTerm WebConnect Server and IBM Workplace Server are on separate machines
bull Configure PowerTerm WebConnect Server
Launch PowerTerm WebConnect Administration Tool
Open Files | Configuration | Main
In the [Portal] section edit
Machines=localhostltIBM sever machinegt
bull Configure PowerTerm WebConnect Web components
Copy the ldquowebrdquo folder from the PowerTerm WebConnect server installation to the
IBM Workplace server machine
Create an Alias or a Virtual directory to it named WebConnect on the Web
server providing access to it for the users This is in order to enable the users to
download the necessary files to run their applications
Step 2 Enable JSR portlets
1 On IBM Workplace Server go to ltPortalServergtsharedappconfigservicesConfigServiceproperties
2 Edit portalenablejsr168=true
3 Save and close the file
Step 3 Enable SSO
1 On IBM Workplace Server go to ltPortalServergtsharedappconfigservicesLoaderServiceproperties
2 Edit commandpath=comericomportalcommandscomibmwpsenginecommands
3 Save and close the file
Step 4 Copy Files
The following files need to be copied from WebConnect ServerAddOnsIBM
WorkplacePortlet folder to IBM Workplace Server
File name to copy Destination folder
OpenSSLdll ltAppServergtjavajrebin
IbmPortaldll ltAppServergtjavajrebin
IbmPortalini ltAppServergtjavajrebin
PowerTerm WebConnect 25 Getting Started Guide
WebConnectPortaljar ltAppServergtlib
EricomLoginjar ltPortalServergtsharedapp
Step 5 Portlet Configuration
1 On IBM Workplace Server go to ltAppServergtjavajrebinIbmPortalini
2 You can modify the following parameters in the [Server=WebConnect] section webserverport=ltIBM web server portgt
Specifies the Web server port for accessing the PowerTerm WebConnect clients folder
Default 80 Address
Specifies the address of the PowerTerm WebConnect Server machine for Portlet to
connect to when PowerTerm WebConnect Server is located on a different machine
than the IBM Workplace Server CustomAddress
Specifies the addresss of the PowerTerm WebConnect Server machine for Clients to connect to If CustomAddress is the same as Address then this may be omitted webserveraddr
Specifies the address of the Web Server machine when it is located on a different
machine than the IBM Workplace Server
3 Restart the IBM server ltPortalServergtrootscriptsstopWorkplaceServicesbat ltPortalServergtrootscriptsstartWorkplaceServicesbat
This procedure may take about 20 minutes
Step 6 Install the Portlet
1 In a Web browser open the URL httpltIBM Workplace
Servergt9081lwpmyworkplace to open the IBM Workplace Portal
2 Login as administrator
3 Go to Administration | Portlets | Install
4 Browse to the PowerTerm WebConnectwar file located on PowerTerm WebConnect
Server and click Next
5 Click Install
Step 7 Create an Application page
1 Login to the Workplace
2 Go to Portal User Interface | Manage Pages
3 Search for My Work
4 Click the My Work link and select New Page
5 Name the page PowerTerm WebConnect and click OK
6 Click OK again You will see the created page on the list
7 Click the pencil icon on the new page and select the 1 square layout
PowerTerm WebConnect 26 Getting Started Guide
8 Click Add Portlet and search for PowerTerm WebConnect
9 Select it and click OK
10 Click Done
11 Click My work at the top of the page PowerTerm WebConnect is displayed on the list
Step 8 Run the Portlet
1 Restart IBM Workplace Server
2 Open IBM Workplace Portal in a browser httpltportal servergtlwpmyworkplace
3 Login to IBM Workplace Server
4 Click My work PowerTerm WebConnect portlet is displayed
5 Launch it The Userrsquos applications as defined on PowerTerm WebConnect Server
appear
6 Click an application to launch it
64 Install PowerTerm WebConnect Portlet on IBM Workplace server (for Linux OS)
Step 1 Enable JSR 168 portlets
1 Go to optIBMWorkplacePortalServersharedappconfigservicesConfigServiceproperties
2 Modify the portalenablejsr168 property to ldquotruerdquo
3 Restart the server cd optIBMWorkplacePortalServerrootscripts
Run stopWorkplaceServicessh
Run startWorkplaceServicessh
This procedure can take up to 20 minutes
4 Log on to the workplace server at httpltworkplace servergt9081lwpmyworkplace using
the administrators username and password
Step 2 Install the portlet
1 Restart IBM Workplace Server
2 In a Web browser open the URL httpltworkplace server IPgtlwpmyworkplace
3 Login to IBM Workplace Server as an administrator
4 Go to Administration | Portlets | Install
5 Browse to the PowerTerm WebConnectwar file located on PowerTerm WebConnect
Server and click Next
6 Click Install
PowerTerm WebConnect 27 Getting Started Guide
Step 3 Install the Application page
1 Login to the workplace as administrator
2 Go to Administration | Portal User Interface | Manage Pages
3 Search for My Work
4 Click the My Work link and select New Page
5 Name the page PowerTerm WebConnect and click OK
6 Click OK again You will see the created page on the list
7 Click the pencil icon and select the 1-square layout
8 Click Add Portlet and search for PowerTerm WebConnect
9 Select it and click OK
10 Click Done
11 Click My work on top and PowerTerm WebConnect is displayed on the left bar
Step 4 Run the portlet
1 Restart IBM Workplace Server
2 Open IBM Workplace Portal in a browser httpltportal servergtlwpmyworkplace
3 Login to IBM Workplace Server
4 Click My work PowerTerm WebConnect portlet is displayed
5 Launch it The Userrsquos applications as defined on PowerTerm WebConnect Server
appear
6 Click an application to launch it
65 Install PowerTerm WebConnect Portlet on IBM WebSphere 61 server (for Windows OS)
Step 1 Install PowerTerm WebConnect Server
You have to configure PowerTerm WebConnect Server if it and the IBM WebSphere Server
are on separate machines
1 Launch PowerTerm WebConnect Administration Tool
2 Open Files | Configuration | Main
3 In the [Portal] section edit Machines=localhostltIBM sever machinegt
Step 2 Copy Files
The following files need to be copied from WebConnect ServerAddOnsIBM
WebSpherePortlet folder to IBM WebSphere Server
PowerTerm WebConnect 28 Getting Started Guide
File name to copy Destination folder
OpenSSLdll ltAppServergtjavajrebin
IbmPortaldll ltAppServergtjavajrebin
IbmPortalini ltAppServergtjavajrebin
WebConnectPortaljar ltAppServergtlib
Step 3 Portlet Configuration
1 On IBM Workplace Server go to ltAppServergtjavajrebinIbmPortalini
2 You can modify the following parameters in the [Server=WebConnect] section webserverport=ltIBM web server portgt
Specifies the Web server port for accessing the PowerTerm WebConnect clients folder
Default 80 Address
Specifies the address of the PowerTerm WebConnect Server machine for Portlet to
connect to when PowerTerm WebConnect Server is located on a different machine
than the IBM Workplace Server CustomAddress
Specifies the addresss of the PowerTerm WebConnect Server machine for Clients to connect to If CustomAddress is the same as Address then this may be omitted webserveraddr
Specifies the address of the Web Server machine when it is located on a different
machine than the IBM Workplace Server
3 Restart the IBM server ltAppServergtProfilesAppServer01binstopServerbat ltAppServergtProfilesAppServer01binstartServerbat
This procedure may take about 20 minutes
Step 4 Install the Portlet and create an Application page
1 In a Web browser open the URL httpltIBM WebSphere Servergt9060ibmconsole
to open the IBM WebSphere Portal
2 Login and go to Applications | Install New Application
3 Browse to the PowerTerm WebConnectwar file located on PowerTerm WebConnect
Server
4 Enter Context root and click Next The Select installation options dialog appears
5 Optional change options to your preference or keep the default
6 Click Next
7 Select Ericom in the Module column click Apply and then Next
8 Click Finish and then Save
9 Select Applications | Enterprise Applications
10 Select PowerTerm WebConnectwar checkbox and click Start
PowerTerm WebConnect 29 Getting Started Guide
11 Enter in the Web browser the URL httpltIBM WebSphere
Servergt9080ltContext rootgtEricom portlet The Login dialog appears
12 Login and you will see PowerTerm WebConnect displayed on the list
Step 5 Run the Portlet
1 Restart IBM WebSphere Server
2 Open IBM WebSphere Portal in a browser httpltportal servergt9080ltContext
rootgtEricom portlet
3 Login to IBM WebSphere Server
4 Launch it The Userrsquos applications as defined on PowerTerm WebConnect Server
appear
5 Click an application to launch it
66 PowerTerm WebConnect Server Configuration
bull To enable the Lotus Expeditor to run the PowerTerm WebConnect client the
System Administrator must provide the users with accounts on PowerTerm
WebConnect Server (see the PowerTerm WebConnect Administratorrsquos Manual for
instructions on how to create users groups and connections on the PowerTerm
WebConnect Server)
bull To enable PowerTerm WebConnectrsquos Single Sign-On feature the System
Administrator must create a PowerTerm WebConnect user with the same
username and password as used for the Lotus Expeditor For a managed Lotus
Expeditor the credentials used are the username and password sent to the
managing server For an unmanaged Lotus Expeditor the operation system
username and the Lotus Expeditor password are used as credentials
NOTE If a password is not defined then the Single Sign-On will fail and the user will be
prompted with a login dialog
67 PowerTerm WebConnect Client Configuration
The PowerTerm WebConnect client is configured in webconnectxml located in the config
folder webconnectxml parameters are
url The PowerTerm WebConnect Agent url
server The PowerTerm WebConnect Server address
sso The Single Sign-On feature
dst The local destination for downloading PowerTerm WebConnect
components
PowerTerm WebConnect 30 Getting Started Guide
url
PowerTerm WebConnect components are installed on a Web server Their default url is
Windows Agent
httpltWebServer IPgtWebConnectwindowsptagentcab
Linux Agent
httpltWebServer IPgtWebConnectlinuxix86qterm-wczip
The url parameter must include the first part of the url (which is identical for both Windows
and Linux agents)
The PowerTerm WebConnect client will automatically append the appropriate suffix in
order to create a full accurate url
Example
ltitem key=rdquourlrdquo value=httpadminserverWebConnectgt
server
The computer name or IP address of the PowerTerm WebConnect Server machine
The PowerTerm WebConnect client will log in to this PowerTerm WebConnect Server
display the applications defined on it and run them according to this serverrsquos configuration
Format ltserver IPgt[ltportgt]
where default port is 4000 (can be edited)
Example
ltitem key=rdquoserverrdquo value=rdquoadmin24000rdquogt
sso
Determines whether Single Sign-on will be used to log in to PowerTerm WebConnect
Server Values
bull True (default) the client should automatically log in to the PowerTerm WebConnect
Server using the same credentials as the ones used to log in to the Lotus Expeditor
client
The System Administrator must verify that these credentials can log in to the
PowerTerm WebConnect Server
bull False the user will be prompted with a login dialog or will log in automatically using
previously saved credentials
Example
ltitem key=rdquossordquo value=rdquotruerdquogt
Autologin mode
PowerTerm WebConnect 31 Getting Started Guide
If sso is set to True the user is not prompted for credentials and the login process to
PowerTerm WebConnect Server is done automatically sending the credentials used for the
Lotus Expeditor unless the Lotus Expeditor does not have a password defined (In the
Lotus Expeditor preferences page | Password| Prompt me for a password at start up checkbox)
However if Single Sign-on is not used there are several options regarding Autologin that
can be defined in the PowerTerm WebConnect Preferences page Options
bull Yes
bull No
bull Interactive
bull First time interactive (default) ndash Simplifies the login process to PowerTerm
WebConnect Server In this mode the first time the user logs in to PowerTerm
WebConnect Server he will be prompted for his credentials with the Login dialog
These credentials will be stored in the machine and from then on the login process to
PowerTerm WebConnect Server will be done automatically
1 Open File | Preferences from the Lotus Expeditor and select PowerTerm WebConnect
2 In the Autologin to WebConnect Server section select First Interactive and click OK
3 Start PowerTerm WebConnect Client for Lotus Expeditor If credentials were entered
at least once then the next time the client will connect to PowerTerm WebConnect
Server without prompting for the user name and password
The Administrator must configure the Agent to do nothing when it exits for the
feature to work this way See PowerTerm WebConnect Administratorrsquos Manual for more information about defining Autologin
bull Allow multiple selection ndash Defines whether the user can launch more than one
application at a time (by using the ltCtrlgt or ltShiftgt button while selecting applications)
dst
Defines the path to download PowerTerm WebConnect components on the client machine
The dst parameter can contain macros which are translated by the PowerTerm WebConnect
Client for Lotus Expeditor during runtime The macros should be placed between percent
symbols () for example WebServer
When such a value is defined the PowerTerm WebConnect Client for Lotus Expeditor
substitutes the entire expression for the macrorsquos value
The PowerTerm WebConnect Client for Lotus Expeditor does not support the use
of environment variables as macros
Macros are not case sensitive
Macros supported by PowerTerm WebConnect Client for Lotus Expeditor
Macro name Description
WebServer The name of the Web server
It is obtained from the PowerTerm WebConnect Agent url
PowerTerm WebConnect 32 Getting Started Guide
parameter
Name The name of the clientrsquos CAB or ZIP file eg ldquoptagentrdquo
Display The clientrsquos display name from the version file
Version The clientrsquos version value It is obtained from the version
file
Root The default root location
Windows ldquoCrdquo
LinuxUnix an empty string
OSDir Windows Windowsrsquo installation directory for example
ldquoCWindowsrdquo
Linux an empty string
OSDrive Windows Windowsrsquo installation drive for example ldquoCrdquo
Linux an empty string
HomePath Windows The HOMEPATH environment variable
Linux The HOME environment variable
Home The Ericom folder in the userrsquos home directory
Windows CDocuments and SettingsltusergtApplication
DataEricom
Linux ltusergtEricom
In addition to the predefined macros listed above the PowerTerm WebConnect client
supports the usage of Java System Properties
Java System Properties available for users on Windows XP SP2
Java System Property Name Value Example
javaversion 150
javavendorurl httpwwwibmcom
javahome CIBMcommonpluginscomibmpvcwctruntim
esj2sewin32x86_150SR2-
20060511rcpeclipsepluginscomibmrcpj2sew
in32x86_150SR2-20060511jre
javavmspecificationversion 10
javavmversion 23
javavmvendor IBM Corporation
javavmname IBM J9 VM
PowerTerm WebConnect 33 Getting Started Guide
javaiotmpdir CDOCUME~1dianaLOCALS~1Temp
javacompiler j9jit23
javaextdirs CIBMcommonpluginscomibmpvcwctruntim
esj2sewin32x86_150SR2-
20060511rcpeclipsepluginscomibmrcpj2sew
in32x86_150SR2-20060511jrelibext
osname Windows XP
osarch x86
osversion 51 build 2600 Service Pack 2
pathseparator
username Jone
userhome CDocuments and SettingsJone
userdir CIBMRSA
usertimezone GMT+0200
System properties available for users on Linux RedHat 9
Java System Property Name Value Example
javaversion 150
javavendorurl httpwwwibmcom
javahome usrjavajre150_07
javavmversion 150
javavmvendor IBM Corporation
javavmname IBM J9 VM
javaclasspath
javalibrarypath
javaiotmpdir tmp
javacompiler
javaextdirs
osname Linux
osarch i386
osversion 2420-8
pathseparator
PowerTerm WebConnect 34 Getting Started Guide
username root
userhome root
userdir root
System properties names are placed in the configuration file within percent symbols ()
(like macros)
671 Configure the PowerTerm WebConnect Client
1 Open the Config Folder and edit the webconnectxml file Example
ltxml version =rdquo10rdquo encoding=rdquoUTF-8rdquogt
ltsection name=rdquoparametersrdquogt
ltitem key=rdquourlrdquo value=httpadminserverWebConnect56gt
ltitem key=rdquoserverrdquo value=rdquoadmin24000rdquogt
ltitem key=rdquossordquo value=rdquotruerdquogt
ltitem key=rdquodestrdquo value=rdquoCProgram FilesEricomrdquogt
ltsectiongt
2 Save the customized webconnectxml to a Web server folder available to all users It is
recommended to use the same Web server as the PowerTerm WebConnect Agent
Example
ltWebConnect installation foldergtwebwebconnectxml
3 Test the accessibility to this file - Type the URL of webconnectxml in the browser
Example
httpltWebServer IPgtWebConnectwebconnectxml
The contents of the file should be displayed
672 Configure the Preferences File
1 Open the plugins folder and open the PowerTermWebConnectClient_560365jar file
You can use Winzip version 70 and up or in Windows XP ndash Create a new file type for the
jar extension click advanced and select compressed (zipped) folder in the drop down list
Now you can open the JAR files in the Windows Explorer
The default contents of the file
configURL=httpleericomcomWebConnectwebconnectxml
2 Specify the accurate URL of the webconnectxml file Example
httpltWebServer IPgtWebConnectwebconnectxml
3 Save the file and close it The WinZip will display the following dialog
ldquoFile preferencesini has been changed since it was extracted Update archive
with this filerdquo
PowerTerm WebConnect 35 Getting Started Guide
4 Click Yes and close the archive
If you are editing the file from within the explorer you will have to save the file elsewhere
and then drag it to the explorer window where the JAR file is open
68 Installing PowerTerm WebConnect Client on Lotus Expeditor
1 Start the Lotus Expeditor client
2 Select File | Application | Install
3 Select Search for new features to install and click Next
4 Select Add Folder Location and type or select the location of the update site folder from
the provided package Click OK
5 Select the location you have just created and click Finish
6 In the Select the feature to install tree select Powerterm WebConnectUpdate Site Click
Next
7 Select I accept the terms in the license agreements and click Next
8 Click Finish
9 When prompted restart the platform
69 Running PowerTerm WebConnect Client for Lotus Expeditor
1 Click Open The PowerTerm WebConnect option is displayed
2 Select PowerTerm WebConnect The application will automatically connect and start
downloading the components from PowerTerm WebConnect Server
IMPORTANT
If you did not install PowerTerm WebConnect Server and are instead connecting to Ericom
Softwarersquos Demo WebConnect Server then you need to open port 443 in the firewall
691 PowerTerm WebConnect Client Workflow
1 PowerTerm WebConnect client reads the URL of webconnectxml from the preferencesini
file and requests it
2 When the webconnectxml is successfully downloaded the application reads the
configuration connects to the specified Web server downloads the PowerTerm
WebConnect components and connects to the PowerTerm WebConnect Server
3 The user is requested to login to the PowerTerm WebConnect Server For testing you
can use the username Example and password example
This step will be skipped if Single Sign-on is set to ldquotruerdquo
PowerTerm WebConnect 36 Getting Started Guide
4 After logging in to PowerTerm WebConnect Server the userrsquos applications are displayed
as defined by the administrator
5 To run an application select the desired application from the list and click Launch or
double-click the application The application will be launched in a separate window
610 Troubleshooting
When you encounter a problem the first step is to open the log file This file is located on
the client machine in the Ericom folder
Windows
CDocuments and SettingsltusernamegtEricomleclientEricomPluginlog
Linux
ltuser-home-directorygtEricomleclientEricomPluginlog
Following is a guide for diagnosing and fixing the problems in cases of error messages and
additional information
Error
Message
Solution
Version File
reading error
1 Check the lsquourlrsquo parameter in the webconnectxml file on the Web
server The value should be
httpltWebServerIPgtWebConnect
2 Try to run the following URL on the browser
Windows
httpltWebServerIPgtWebConnectwindowsptagentvertxt
Linux
httpltWebServerIPgtWebConnectlinuxix86qterm-
wcvertxt
The file contents displayed in the browser window should be in
the following form
560-rel14546
PowerTerm WebConnect Application Zone
560 - Main Release
ltrootgtPowerTerm WebConnect 56ltWebServergt
If the version file contents are not as shown check
- Is the Web Server running
- Are PowerTerm WebConnect Web Components and version files
PowerTerm WebConnect 37 Getting Started Guide
in place
3 On the Web server check ltPowerTerm WebConnect
rootgtwebwindowsptagentvertxt If the contents ldquolook wrongrdquo or
not in the proper form reinstall the PowerTerm WebConnect Web
components
4 On the client machine open the aforementioned URL in the
browser The file content should appear in the browser If it does
not it could be that the Web server is down
Web Server is
shut down
The webconnectxml configuration file must be located on the Web
server The explicit URL to this file is defined in the preferencesini
file (see Configure the Preferences File)
The error message contains the IP address of the Web server
Verify that the Web server on this machine is running
Version file
does not exist
on ltURLgt
See Version File reading error
The
configuration
file is not
accessible or
has a wrong
format
The webconnectxml configuration file must be located on the Web
server and the explicit URL to the configuration must be defined in
the preferencesini file (see Configure the Preferences File)
Try to open the URL specified in the error message in the
browser If it does not open then it either does not exist or it has
a wrong format
Preferences
file does not
exist in the
application
bundle
The preferencesini file containing the URL to the configuration
file was removed from the update site folder
Uninstall the current PowerTerm WebConnect client from the
client machine Create a new customized package (see
PowerTerm WebConnect Client Configuration) and reinstall it
Configuration
file URL is not
defined in
preference
file
The URL to the configuration file does not appear in the
preferencesini file (see Configure the Preferences File)
Uninstall the current PowerTerm WebConnect client from the
client machine Create a new customized package (see
PowerTerm WebConnect Client Configuration) and reinstall it
No IP address
could be
found for the
host
The Web server URL specified in the preferencesini file (see
Configure the Preferences File) or in the webconnectxml file (see
Configure the PowerTerm WebConnect Client) is an unknown
host
If the mistake is in the preferencesini file uninstall the current
PowerTerm WebConnect client from the client machine Create a
new customized package (see PowerTerm WebConnect Client
Configuration) and reinstall it
PowerTerm WebConnect 38 Getting Started Guide
If the mistake is in the webconnectxml file correct the file reopen
the Lotus Expeditor client
Cannot write
to destination
The temporary file cannot be written to the defined destination
Check the write permissions
Copied
configuration
file has wrong
format
The webconnectxml file as received from the specified URL has a
wrong format Correct the file and try again
PowerTerm
WebConnect
Agent URL is
malformed
The PowerTerm WebConnect Agent URL specified in the
webconnectxml file (see Configure the PowerTerm WebConnect
Client) does not have a proper HTTP format Correct the file and
try again
PowerTerm
WebConnect
Agent URL is
not defined
The PowerTerm WebConnect Agent URL parameter is not specified
in the webconnectxml file (see Configure the PowerTerm
WebConnect Client)
Correct the file and try again
The specified
destination
folder name
is wrong
The destination folder name contains illegal characters
ltgt|
Check the dst parameter in the webconnectxml file Correct the
file and try again
You do not
have
permissions
to write to
ltpathgt
The PowerTerm WebConnect Agent cannot be written to the
destination as defined Check the write permissions
The default destination defined in the version file should not to
be changed
A customized destination for PowerTerm WebConnect Agent
downloading can be defined in the webconnectxml file (See
Configure the PowerTerm WebConnect Client)
Check the destination value correct and try again
PowerTerm WebConnect 39 Getting Started Guide
About Ericom
Ericomreg Software is a leading provider of Application Access and Virtualization Solutions
Since 1993 Ericom has been helping users access enterprise mission-critical applications
running on a broad range of Microsoftreg Windowsreg Terminal Servers virtual Desktops
Blade PCs legacy hosts and other systems Ericom provides concrete business value by
helping organizations realize the benefits of their IT investments With offices in the United
States United Kingdom EMEA India and China Ericom also has an extensive network of
distributors and partners throughout North America Europe Asia and the Far East Our
expanding customer base is more than 30 thousand strong with over 7 million
installations
For more information on our products and services contact us at the location nearest to you
And visit our web site httpwwwericomcom
North America Western Europe International
Ericom Software Inc Ericom Software (UK) Ltd Ericom Software Ltd
231 Herbert Avenue Bldg 4 11a Victoria Square 8 Hamarpeh Street
Closter NJ 07624 USA Droitwich Worcestershire Har Hotzvim Technology Park
Tel +1 (201) 767 2210 WR9 8DE United Kingdom Jerusalem 91450 Israel
Fax +1 (201) 767 2205 Tel +44 (0) 845 644 3597 Tel +972 (2) 591 1700
Toll-free 1 (888) 769 7876 Fax +44 (0) 845 644 3598 Fax +972 (2) 571 4737
Email infoericomcom Email infoericomcouk Email infoericomcom
PowerTerm WebConnect 11 Getting Started Guide
When you launch the PowerTerm WebConnect Administration Tool for the first time the Connection dialog is displayed with the user Administrator No
password is required to enter just click Connect
In the Connection dialog (displayed when launching the Administration Tool) the
Host Name is localhost by default This is correct only if the Administration Tool
runs on the same machine as the server If the Administration Tool runs on a different machine you need to change the Host Name to the IP addressHostname
of the PowerTerm WebConnect server
When using the PowerTerm WebConnect Windows edition by default the
Administration Tool will deny any connection attempts from any computer other
than the local machine
PowerTerm WebConnect 12 Getting Started Guide
3 PowerTerm WebConnect Administration Tool at a Glance
PowerTerm WebConnect Administration Tool manages published applications user sessions
and server configuration The administrator can perform operations such as multiple
application publishing sending messages to logged-on users shutting down sessions and
monitor user activity
To perform the tasks described in this chapter you must launch the Administration Tool via one of the methods detailed in chapter Start the PowerTerm
WebConnect Administration Tool
Launching the Administration Tool from the system tray or using the
Administration Tool launched after completed installation will not allow you to
activate certain features
After you launched the Administration Tool and connected to the server you will receive a
Welcome screen where you select desired activity
bull Publish Multiple Applications opens the Publish Multiple Applications wizard
bull Configure Load Balancer opens PowerTerm Load Balancer Administration Tool
bull Create a Host Connection opens the Add Connection dialog
bull Configure Active Directory opens the Directory Services dialog
PowerTerm WebConnect 13 Getting Started Guide
Close the Welcome screen to enter the Administration Tool main
screen
The Administration Tool main screen has three sections
bull User section lists all users defined in the server
bull Group section lists all groups defined in the server
bull Connection section lists all connections and published applications defined in the
server
By default only the Connection section is displayed when you first open Administration Tool
There are three predefined example-connections ldquoExample_As400rdquo ldquoExample_VTrdquo and
ldquolocalhostrdquo You can test them prior to defining your own
1 Right click the connection you want to test and select Test The PowerTerm
WebConnect HostView Login dialog appears
2 Type example for User Name and example for Password
Credential fields are case sensitive
3 Click Login The desired connection with its pre-programmed demo application is
launched
PowerTerm WebConnect 14 Getting Started Guide
31 Publishing Applications and Documents
In order to enable access to applications and documents on Windows Terminal Servers
publish these applications and documents from the Administration Tool When publishing
applications and content you can specify which servers will be used in a Terminal Server
cluster and which users and groups will have access to these services Once you have
published such applications and documents the RemoteView client can be used to access
them
If you need to provide access to multiple applications on a Terminal Server use the Multiple Application Publishing wizard to significantly reduce the time and
effort required to publish these applications
To publish multiple Windows applications
1 Click Publish Multiple Applications in the Welcome screen The Choose Terminal Server
for Browsing dialog appears
2 Provide the address of the Terminal Server which will be used for browsing and click OK The Application Publisher Step 1 dialog appears This dialog lists all the
applications available in the specified serverrsquos Start menu
3 Select those applications found in the Programs folder of the designated server that you want to publish and click Next The Application Publisher Step 2 dialog appears
4 Determine the destination of your publishing and click Next The Application Publisher
Step 3 dialog appears
5 Determine the Color Quality of your published application
6 Determine the start mode in which you want to run the published application - normal maximized or minimized - and click Next The Application Publisher Step 4
dialog appears
7 Choose the connection speed that matches your infrastructure The connection speed
setting determines the value of three visual effects settings You can also override
these settings specifically
8 Determine whether you prefer the window to display their content while being
dragged or just the outline By default the same setting is used as the client desktop
9 Click Next The Application Publisher Step 5 dialog appears
10 Specify where sounds are to be played ndash locally or remotely
11 Determine which local devices the remote session will have access to (local drivers printer etc) and click Next The Application Publisher Step 6 dialog appears
12 If you have the PowerTerm Load Balancer installed Use all Servers (default) allows the application to run on any Terminal Server in the
cluster This setting is appropriate when the application is installed on all the Terminal
Servers Alternatively you select specific Terminal Servers on which to run this
application
If you have not installed the PowerTerm Load Balancer you will need to explicitly
specify the address of the Terminal Server on which the application will be run
PowerTerm WebConnect 15 Getting Started Guide
13 Click Next The Application Publisher Step 7 dialog appears
14 Select the users groups or OUs to which you wish to publish the applications and click Next The Application Publisher Step 8 dialog appears By default applications will
be published to everybody
15 Click Advanced Settings to modify settings such as the login credentials to the
Terminal Servers By default PowerTerm WebConnect credentials will be passed
through to the Terminal Server
16 Click Finish The published applications appears in the Connection List
Right-click and select Properties or double click on the published application in the
Connections list to view and modify any of the settings which you previously
defined
To publish a remote Desktop
1 Select Action | New | Remote Desktop The Application Publisher Step 1 dialog appears
2 Type the Display Name which will be the name presented to the end-users and click
Next The Application Publisher Step 2 dialog appears
3 Specify where icons for the published desktop will be displayed to the end-user in Publish to
4 Click Choose Icon to replace the desktoprsquos default icon Select the desired icon from
the list that appears
5 Click Next The Application Publisher Step 3 dialog appears
6 Determine Screen Size and the Color Quality of the published desktop
7 If desirable select Show Connection Bar in Full Screen Mode
8 Click Next The Application Publisher Step 4 dialog appears
9 Choose the connection speed that matches your infrastructure The connection speed
setting determines the value of three visual effects settings You can also override
these settings specifically
10 Click Next The Application Publisher Step 5 dialog appears
11 Specify where sounds are to be played ndash locally or remotely Where to Apply Window
Key Combinations and which local devices you want to automatically connect to when
logged on to the remote computer
12 Click Next The Application Publisher Step 6 dialog appears
13 Specify the Server Address and Port Number of the Terminal Server that weill provide
the desktop and click Next The Application Publisher Step 7 dialog appears
14 Select the users groups or OUs to which you wish to publish the desktop and click Next The Application Publisher Step 8 dialog appears
Select the Server group to allow all users to access the published application
15 Click Advanced Settings to modify settings such as the login credentials to the
Terminal Servers By default PowerTerm WebConnect credentials will be used
PowerTerm WebConnect 16 Getting Started Guide
16 Click Finish The published application appears in the Connection List
Right-click Properties or double click on the published application in the
Connections list to modify any of the settings which you previously defined
32 Create Terminal Emulation Connections
To provide access to legacy host systems you will need to create Terminal Emulation
connections For each such connection you can specify the host address emulation type
login script and more Once you have created these connections users will be able to
launch them using HostView (Windows or Linux) WebView or the Java client as
appropriate
1 Click Create a Host Connection in the Welcome screen The Add Connection dialog
appears
2 Enter a Name for the new connection
3 Specify an Owner for the new connection The possibilities are
[None] the connection will not be allowed to run by anyone and it will not be
displayed in any Connection list Server the connection will be accessible for all users of this PowerTerm
WebConnect server A specific group the connection will be accessible for all users of the specified
group A specific user the connection will be accessible for a specified user only
4 Leave category Terminal Emulation selected
5 Select Terminal Type Terminal Model and Communication Type as needed
6 Specify the Host Name or IP address of your host
7 Specify other parameters as needed
8 Select the Security Type as needed if your host supports SSL or SSH and specify
the appropriate details in the Details dialog
9 Use the Settings Key Mapping and Power Pad options to further customize the
connection
10 Click OK and the connection is created
33 Test Connections
It is recommended to test published applications or host connections before they are made
available to end-users
To test a connection
bull Right-click the target connection from the Connection section of the main screen and
select Test
Alternatively
PowerTerm WebConnect 17 Getting Started Guide
1 Select Tools | Run ltdesired clientgt The Login to WebConnect dialog appears
2 Enter the User Name and Password for the individual who owns the connection that
you want to test and click Login The desired PowerTerm WebConnect client is started
and the Connect dialog appears
3 Select the desired connection and click Connect The test is executed
34 Launch the Application Zone or the Application Portal
Users can access the published applications from the Application Zone application launcher
or from the Application Portal web interface
To use the Application Zone go to Start menuProgramsEricom SoftwarePowerTerm
WebConnect 5x and select Client URLs Alternatively type the following URL into your Web
browserrsquos address bar httpltserver addressgtWebConnect5xClientURLshtml In the
page that opens click on the Run button next to the Application Zone to launch it
To use the Application Portal go to Start menuProgramsEricom SoftwarePowerTerm
WebConnect 5x and select it Alternatively type the following URL into the Web browserrsquos
address bar httpltserver addressgtWebConenct5xportalwindowsindexasp
35 Monitor a Users Sessions
From the Administration Tool you can monitor the users sessions and may intervene if
necessary This intervention may result in your input appearing on the users screen The
user receives a notification when an administrator begins and ends monitoring the session
1 Select View | Client Sessions or click to see all the active client sessions
2 Select the desired active session and right-click Attach The Password Verify dialog
appears
3 Enter your password and click OK Some notification dialogs appears and the selected
PowerTerm WebConnect session is viewed
36 View Intruders
bull The Intruders window shows suspected attempts at breaching security After several
suspected intrusion attempts users are blocked temporarily
bull In addition to showing suspected intrusion attempts the Intruders window allows
you to remove restrictions on users
bull Select View | All Intruders or click
PowerTerm WebConnect 18 Getting Started Guide
4 Accessing Virtual Desktops and Blade PCs with PowerTerm WebConnect
This chapter provides instructions on configuring PowerTerm WebConnect for Virtual
Desktop Infrastructure (VDI)
41 Step 1 Launch DeskView Administration Tool
Verify that PowerTerm WebConnect is installed on your server and launch PowerTerm
WebConnect Admin Tool
bull Select Tools | Open VDI Manager The PowerTerm WebConnect DeskView Administration
Tool opens
The first time you launch the DeskView Administration Tool you will be prompted to install
the tool
PowerTerm WebConnect 19 Getting Started Guide
Microsoft Management Console 30 is required for PowerTerm WebConnect DeskView
Administration Tool If you do not have this installed you will also automatically be
prompted to install this update
Follow the installation processes when you are prompted for either install PowerTerm
WebConnect DeskView Administration Tool will automatically launch when these
installations are completed
42 Step 2 Add a Host
1 Right-click Virtualization Hosts and select Add Host The Add a New Host wizard
opens Click Next
2 Enter a Host Name as you would like it to appear in PowerTerm WebConnect
DeskView Administration Tool and a description (optional) Click Next
3 Specify the Virtualization Server type and click Next
4 Specify the connection information and click Next
VMWare Virtual Center v1x and 2x
Specify the HTTPS Web Service address and a UsernamePassword that can access
the host
VMWare Virtual Server 2005
Click Start and then Run
Type ldquoservicesmscrdquo and click OK
Scroll down to PowerTerm WebConnect DeskView Server service and open
Properties
Change the Login Account for the service to match the Domain Administrator
account and password used when setting up Microsoft Virtual Server 2005 and
restart the service Enter the IP or NETBIOS name of the Microsoft Virtual Server 2005 server as the
Server Address in the Connection Broker Wizard
Xen Server
Specify the hypervisor IP address or NETBIOS name the Root UsernamePassword
to the hypervisor and the Service port (default 80)
Oracle VM
Specify the Serverrsquos agent URL and Port (default 8899) for example
httpsltservernamegt8899
Specify the Oracle VM hypervisorrsquos Oracle Agent UsernamePassword (default
username oracle)
5 Click Finish to add the new Host
To configure Virtual Machines for use install the Ericom Tools (vmagentmsi) on each of the
virtual machines on the new host for PowerTerm WebConnect DeskView to recognize them
The vmagentmsi installer is located on the PowerTerm WebConnect server in ltPowerTerm
WebConnect installation foldergtAddOnsDeskView VDI folder (default installation
PowerTerm WebConnect 20 Getting Started Guide
folder is xProgram FilesEricom SoftwareWebConnect 56) During installation you
will need to enter the DeskView IP address or NETBIOS name
If you are using Microsoft Virtual Server 2005 as your Virtualization Host use the
IP address of the DeskView server only when installing the Ericom Tool package
43 Step 3 Create a Pool
Pools are used to organize Virtual Machines (VM) into logical groups This enables
organizations to combine and order resources from multiple systems into one entity To
access available resources end-users simply connect to PowerTerm WebConnect to access
any configured resource
1 Right-click Pools and select Create Pool The Create a Pool wizard opens Click
Next
2 Enter a Pool name as you wish it to appear and a description (optional) and click
Next
3 Specify the Pool type and click Next
4 Specify the Assignment type and click Next
Permanently will cause a virtual machine to affix to the user who has launched
that virtual machine For the duration of the session will cause any virtual machine that is not in use to
be returned to the pool for any user to launch
5 Specify the LogoffDisconnect event and click Next
Select what you would like to happen after a user logs off from a virtual machine
in this pool
Select what you would like to happen when a user is disconnected from a virtual
machine in this pool
6 Click Finish to add the new Pool
You will need to assign virtual machines from your virtualization hosts to your created pool
1 Right-click the pool and select Assign Machines The Assign Machines to ltyour
pool namegt dialog opens
2 Highlight the desired virtual machine(s) and click Select Click OK
44 Step 4 Publish an ApplicationDesktop
1 Return to PowerTerm WebConnect Admin Tool to publish DeskView pools
2 Determine whether to publish a full desktop or a seamless application running
from a virtual desktop
For a full desktop
Select Action | New | Remote Windows Desktop
For a seamless application
Select Action | New | Windows Application
PowerTerm WebConnect 21 Getting Started Guide
3 Select Virtual Desktop in the first step of the wizard and click Next
4 Follow the wizardrsquos instructions until you reach the Virtual Desktops step
5 Select a pool that you previously created and that you would like this connection to choose virtual machines from Click Next
6 Continue and complete the reminder of the wizardrsquos steps
Once the resource is published users who have been assigned access will be able to use it
immediately
PowerTerm WebConnect 22 Getting Started Guide
5 Download and Run PowerTerm WebConnect Clients
PowerTerm WebConnect clients are automatically downloaded and installed onto the client
devices For detailed information and samples please refer to the PowerTerm WebConnect
Sample URLs page To see this page navigate your browser to
httpltweb_servergtWebConnect5xClientURLshtml
PowerTerm WebConnect 23 Getting Started Guide
6 PowerTerm WebConnect Client for Lotus Expeditor
61 Installation Package
PowerTerm WebConnect client for Lotus Expeditor is provided to IBM in an Update Site
package This is a ZIP archive containing the Update Site with the Eclipse feature and plug-
in that comprises the PowerTerm WebConnect client
Extract the ZIP file keeping the foldersrsquo structure intact
NOTE In Winzip verify that the ldquoUse folder namesrdquo option is set to TRUE
Package structure
Update Site
- plugins
- PowerTermWebConnectClient_560365jar
- features
- comericomWebConnect_560365jar
- sitexml
config
- webconnectxml
Definitions
bull webconnectxml PowerTerm WebConnect client configuration file
bull comericomWebConnect_560365jar PowerTerm WebConnect client feature file
bull PowerTermWebConnectClient_560365jar PowerTerm WebConnect client plugin file
62 Pre-installation steps
PowerTerm WebConnect client for Lotus Expeditor does not run independently but in
conjunction with PowerTerm WebConnect Server You can either install it and define your
users groups and applications or use Ericom Softwarersquos Demo PowerTerm WebConnect
Server
bull If you decide to install PowerTerm WebConnect Server you will need the full
installation ie the PowerTerm WebConnect Server and the Web components If you
do not have the installation CD you can download and install a trial version from
wwwericomcom
PowerTerm WebConnect 24 Getting Started Guide
bull If you decide to use Ericom Softwarersquos Demo PowerTerm WebConnect Server then
skip to the chapter Installing PowerTerm WebConnect Client on Lotus Expeditor
63 Install PowerTerm WebConnect Portlet on IBM Workplace server (for Windows OS)
Step 1 Install PowerTerm WebConnect Server
If PowerTerm WebConnect Server and IBM Workplace Server are on separate machines
bull Configure PowerTerm WebConnect Server
Launch PowerTerm WebConnect Administration Tool
Open Files | Configuration | Main
In the [Portal] section edit
Machines=localhostltIBM sever machinegt
bull Configure PowerTerm WebConnect Web components
Copy the ldquowebrdquo folder from the PowerTerm WebConnect server installation to the
IBM Workplace server machine
Create an Alias or a Virtual directory to it named WebConnect on the Web
server providing access to it for the users This is in order to enable the users to
download the necessary files to run their applications
Step 2 Enable JSR portlets
1 On IBM Workplace Server go to ltPortalServergtsharedappconfigservicesConfigServiceproperties
2 Edit portalenablejsr168=true
3 Save and close the file
Step 3 Enable SSO
1 On IBM Workplace Server go to ltPortalServergtsharedappconfigservicesLoaderServiceproperties
2 Edit commandpath=comericomportalcommandscomibmwpsenginecommands
3 Save and close the file
Step 4 Copy Files
The following files need to be copied from WebConnect ServerAddOnsIBM
WorkplacePortlet folder to IBM Workplace Server
File name to copy Destination folder
OpenSSLdll ltAppServergtjavajrebin
IbmPortaldll ltAppServergtjavajrebin
IbmPortalini ltAppServergtjavajrebin
PowerTerm WebConnect 25 Getting Started Guide
WebConnectPortaljar ltAppServergtlib
EricomLoginjar ltPortalServergtsharedapp
Step 5 Portlet Configuration
1 On IBM Workplace Server go to ltAppServergtjavajrebinIbmPortalini
2 You can modify the following parameters in the [Server=WebConnect] section webserverport=ltIBM web server portgt
Specifies the Web server port for accessing the PowerTerm WebConnect clients folder
Default 80 Address
Specifies the address of the PowerTerm WebConnect Server machine for Portlet to
connect to when PowerTerm WebConnect Server is located on a different machine
than the IBM Workplace Server CustomAddress
Specifies the addresss of the PowerTerm WebConnect Server machine for Clients to connect to If CustomAddress is the same as Address then this may be omitted webserveraddr
Specifies the address of the Web Server machine when it is located on a different
machine than the IBM Workplace Server
3 Restart the IBM server ltPortalServergtrootscriptsstopWorkplaceServicesbat ltPortalServergtrootscriptsstartWorkplaceServicesbat
This procedure may take about 20 minutes
Step 6 Install the Portlet
1 In a Web browser open the URL httpltIBM Workplace
Servergt9081lwpmyworkplace to open the IBM Workplace Portal
2 Login as administrator
3 Go to Administration | Portlets | Install
4 Browse to the PowerTerm WebConnectwar file located on PowerTerm WebConnect
Server and click Next
5 Click Install
Step 7 Create an Application page
1 Login to the Workplace
2 Go to Portal User Interface | Manage Pages
3 Search for My Work
4 Click the My Work link and select New Page
5 Name the page PowerTerm WebConnect and click OK
6 Click OK again You will see the created page on the list
7 Click the pencil icon on the new page and select the 1 square layout
PowerTerm WebConnect 26 Getting Started Guide
8 Click Add Portlet and search for PowerTerm WebConnect
9 Select it and click OK
10 Click Done
11 Click My work at the top of the page PowerTerm WebConnect is displayed on the list
Step 8 Run the Portlet
1 Restart IBM Workplace Server
2 Open IBM Workplace Portal in a browser httpltportal servergtlwpmyworkplace
3 Login to IBM Workplace Server
4 Click My work PowerTerm WebConnect portlet is displayed
5 Launch it The Userrsquos applications as defined on PowerTerm WebConnect Server
appear
6 Click an application to launch it
64 Install PowerTerm WebConnect Portlet on IBM Workplace server (for Linux OS)
Step 1 Enable JSR 168 portlets
1 Go to optIBMWorkplacePortalServersharedappconfigservicesConfigServiceproperties
2 Modify the portalenablejsr168 property to ldquotruerdquo
3 Restart the server cd optIBMWorkplacePortalServerrootscripts
Run stopWorkplaceServicessh
Run startWorkplaceServicessh
This procedure can take up to 20 minutes
4 Log on to the workplace server at httpltworkplace servergt9081lwpmyworkplace using
the administrators username and password
Step 2 Install the portlet
1 Restart IBM Workplace Server
2 In a Web browser open the URL httpltworkplace server IPgtlwpmyworkplace
3 Login to IBM Workplace Server as an administrator
4 Go to Administration | Portlets | Install
5 Browse to the PowerTerm WebConnectwar file located on PowerTerm WebConnect
Server and click Next
6 Click Install
PowerTerm WebConnect 27 Getting Started Guide
Step 3 Install the Application page
1 Login to the workplace as administrator
2 Go to Administration | Portal User Interface | Manage Pages
3 Search for My Work
4 Click the My Work link and select New Page
5 Name the page PowerTerm WebConnect and click OK
6 Click OK again You will see the created page on the list
7 Click the pencil icon and select the 1-square layout
8 Click Add Portlet and search for PowerTerm WebConnect
9 Select it and click OK
10 Click Done
11 Click My work on top and PowerTerm WebConnect is displayed on the left bar
Step 4 Run the portlet
1 Restart IBM Workplace Server
2 Open IBM Workplace Portal in a browser httpltportal servergtlwpmyworkplace
3 Login to IBM Workplace Server
4 Click My work PowerTerm WebConnect portlet is displayed
5 Launch it The Userrsquos applications as defined on PowerTerm WebConnect Server
appear
6 Click an application to launch it
65 Install PowerTerm WebConnect Portlet on IBM WebSphere 61 server (for Windows OS)
Step 1 Install PowerTerm WebConnect Server
You have to configure PowerTerm WebConnect Server if it and the IBM WebSphere Server
are on separate machines
1 Launch PowerTerm WebConnect Administration Tool
2 Open Files | Configuration | Main
3 In the [Portal] section edit Machines=localhostltIBM sever machinegt
Step 2 Copy Files
The following files need to be copied from WebConnect ServerAddOnsIBM
WebSpherePortlet folder to IBM WebSphere Server
PowerTerm WebConnect 28 Getting Started Guide
File name to copy Destination folder
OpenSSLdll ltAppServergtjavajrebin
IbmPortaldll ltAppServergtjavajrebin
IbmPortalini ltAppServergtjavajrebin
WebConnectPortaljar ltAppServergtlib
Step 3 Portlet Configuration
1 On IBM Workplace Server go to ltAppServergtjavajrebinIbmPortalini
2 You can modify the following parameters in the [Server=WebConnect] section webserverport=ltIBM web server portgt
Specifies the Web server port for accessing the PowerTerm WebConnect clients folder
Default 80 Address
Specifies the address of the PowerTerm WebConnect Server machine for Portlet to
connect to when PowerTerm WebConnect Server is located on a different machine
than the IBM Workplace Server CustomAddress
Specifies the addresss of the PowerTerm WebConnect Server machine for Clients to connect to If CustomAddress is the same as Address then this may be omitted webserveraddr
Specifies the address of the Web Server machine when it is located on a different
machine than the IBM Workplace Server
3 Restart the IBM server ltAppServergtProfilesAppServer01binstopServerbat ltAppServergtProfilesAppServer01binstartServerbat
This procedure may take about 20 minutes
Step 4 Install the Portlet and create an Application page
1 In a Web browser open the URL httpltIBM WebSphere Servergt9060ibmconsole
to open the IBM WebSphere Portal
2 Login and go to Applications | Install New Application
3 Browse to the PowerTerm WebConnectwar file located on PowerTerm WebConnect
Server
4 Enter Context root and click Next The Select installation options dialog appears
5 Optional change options to your preference or keep the default
6 Click Next
7 Select Ericom in the Module column click Apply and then Next
8 Click Finish and then Save
9 Select Applications | Enterprise Applications
10 Select PowerTerm WebConnectwar checkbox and click Start
PowerTerm WebConnect 29 Getting Started Guide
11 Enter in the Web browser the URL httpltIBM WebSphere
Servergt9080ltContext rootgtEricom portlet The Login dialog appears
12 Login and you will see PowerTerm WebConnect displayed on the list
Step 5 Run the Portlet
1 Restart IBM WebSphere Server
2 Open IBM WebSphere Portal in a browser httpltportal servergt9080ltContext
rootgtEricom portlet
3 Login to IBM WebSphere Server
4 Launch it The Userrsquos applications as defined on PowerTerm WebConnect Server
appear
5 Click an application to launch it
66 PowerTerm WebConnect Server Configuration
bull To enable the Lotus Expeditor to run the PowerTerm WebConnect client the
System Administrator must provide the users with accounts on PowerTerm
WebConnect Server (see the PowerTerm WebConnect Administratorrsquos Manual for
instructions on how to create users groups and connections on the PowerTerm
WebConnect Server)
bull To enable PowerTerm WebConnectrsquos Single Sign-On feature the System
Administrator must create a PowerTerm WebConnect user with the same
username and password as used for the Lotus Expeditor For a managed Lotus
Expeditor the credentials used are the username and password sent to the
managing server For an unmanaged Lotus Expeditor the operation system
username and the Lotus Expeditor password are used as credentials
NOTE If a password is not defined then the Single Sign-On will fail and the user will be
prompted with a login dialog
67 PowerTerm WebConnect Client Configuration
The PowerTerm WebConnect client is configured in webconnectxml located in the config
folder webconnectxml parameters are
url The PowerTerm WebConnect Agent url
server The PowerTerm WebConnect Server address
sso The Single Sign-On feature
dst The local destination for downloading PowerTerm WebConnect
components
PowerTerm WebConnect 30 Getting Started Guide
url
PowerTerm WebConnect components are installed on a Web server Their default url is
Windows Agent
httpltWebServer IPgtWebConnectwindowsptagentcab
Linux Agent
httpltWebServer IPgtWebConnectlinuxix86qterm-wczip
The url parameter must include the first part of the url (which is identical for both Windows
and Linux agents)
The PowerTerm WebConnect client will automatically append the appropriate suffix in
order to create a full accurate url
Example
ltitem key=rdquourlrdquo value=httpadminserverWebConnectgt
server
The computer name or IP address of the PowerTerm WebConnect Server machine
The PowerTerm WebConnect client will log in to this PowerTerm WebConnect Server
display the applications defined on it and run them according to this serverrsquos configuration
Format ltserver IPgt[ltportgt]
where default port is 4000 (can be edited)
Example
ltitem key=rdquoserverrdquo value=rdquoadmin24000rdquogt
sso
Determines whether Single Sign-on will be used to log in to PowerTerm WebConnect
Server Values
bull True (default) the client should automatically log in to the PowerTerm WebConnect
Server using the same credentials as the ones used to log in to the Lotus Expeditor
client
The System Administrator must verify that these credentials can log in to the
PowerTerm WebConnect Server
bull False the user will be prompted with a login dialog or will log in automatically using
previously saved credentials
Example
ltitem key=rdquossordquo value=rdquotruerdquogt
Autologin mode
PowerTerm WebConnect 31 Getting Started Guide
If sso is set to True the user is not prompted for credentials and the login process to
PowerTerm WebConnect Server is done automatically sending the credentials used for the
Lotus Expeditor unless the Lotus Expeditor does not have a password defined (In the
Lotus Expeditor preferences page | Password| Prompt me for a password at start up checkbox)
However if Single Sign-on is not used there are several options regarding Autologin that
can be defined in the PowerTerm WebConnect Preferences page Options
bull Yes
bull No
bull Interactive
bull First time interactive (default) ndash Simplifies the login process to PowerTerm
WebConnect Server In this mode the first time the user logs in to PowerTerm
WebConnect Server he will be prompted for his credentials with the Login dialog
These credentials will be stored in the machine and from then on the login process to
PowerTerm WebConnect Server will be done automatically
1 Open File | Preferences from the Lotus Expeditor and select PowerTerm WebConnect
2 In the Autologin to WebConnect Server section select First Interactive and click OK
3 Start PowerTerm WebConnect Client for Lotus Expeditor If credentials were entered
at least once then the next time the client will connect to PowerTerm WebConnect
Server without prompting for the user name and password
The Administrator must configure the Agent to do nothing when it exits for the
feature to work this way See PowerTerm WebConnect Administratorrsquos Manual for more information about defining Autologin
bull Allow multiple selection ndash Defines whether the user can launch more than one
application at a time (by using the ltCtrlgt or ltShiftgt button while selecting applications)
dst
Defines the path to download PowerTerm WebConnect components on the client machine
The dst parameter can contain macros which are translated by the PowerTerm WebConnect
Client for Lotus Expeditor during runtime The macros should be placed between percent
symbols () for example WebServer
When such a value is defined the PowerTerm WebConnect Client for Lotus Expeditor
substitutes the entire expression for the macrorsquos value
The PowerTerm WebConnect Client for Lotus Expeditor does not support the use
of environment variables as macros
Macros are not case sensitive
Macros supported by PowerTerm WebConnect Client for Lotus Expeditor
Macro name Description
WebServer The name of the Web server
It is obtained from the PowerTerm WebConnect Agent url
PowerTerm WebConnect 32 Getting Started Guide
parameter
Name The name of the clientrsquos CAB or ZIP file eg ldquoptagentrdquo
Display The clientrsquos display name from the version file
Version The clientrsquos version value It is obtained from the version
file
Root The default root location
Windows ldquoCrdquo
LinuxUnix an empty string
OSDir Windows Windowsrsquo installation directory for example
ldquoCWindowsrdquo
Linux an empty string
OSDrive Windows Windowsrsquo installation drive for example ldquoCrdquo
Linux an empty string
HomePath Windows The HOMEPATH environment variable
Linux The HOME environment variable
Home The Ericom folder in the userrsquos home directory
Windows CDocuments and SettingsltusergtApplication
DataEricom
Linux ltusergtEricom
In addition to the predefined macros listed above the PowerTerm WebConnect client
supports the usage of Java System Properties
Java System Properties available for users on Windows XP SP2
Java System Property Name Value Example
javaversion 150
javavendorurl httpwwwibmcom
javahome CIBMcommonpluginscomibmpvcwctruntim
esj2sewin32x86_150SR2-
20060511rcpeclipsepluginscomibmrcpj2sew
in32x86_150SR2-20060511jre
javavmspecificationversion 10
javavmversion 23
javavmvendor IBM Corporation
javavmname IBM J9 VM
PowerTerm WebConnect 33 Getting Started Guide
javaiotmpdir CDOCUME~1dianaLOCALS~1Temp
javacompiler j9jit23
javaextdirs CIBMcommonpluginscomibmpvcwctruntim
esj2sewin32x86_150SR2-
20060511rcpeclipsepluginscomibmrcpj2sew
in32x86_150SR2-20060511jrelibext
osname Windows XP
osarch x86
osversion 51 build 2600 Service Pack 2
pathseparator
username Jone
userhome CDocuments and SettingsJone
userdir CIBMRSA
usertimezone GMT+0200
System properties available for users on Linux RedHat 9
Java System Property Name Value Example
javaversion 150
javavendorurl httpwwwibmcom
javahome usrjavajre150_07
javavmversion 150
javavmvendor IBM Corporation
javavmname IBM J9 VM
javaclasspath
javalibrarypath
javaiotmpdir tmp
javacompiler
javaextdirs
osname Linux
osarch i386
osversion 2420-8
pathseparator
PowerTerm WebConnect 34 Getting Started Guide
username root
userhome root
userdir root
System properties names are placed in the configuration file within percent symbols ()
(like macros)
671 Configure the PowerTerm WebConnect Client
1 Open the Config Folder and edit the webconnectxml file Example
ltxml version =rdquo10rdquo encoding=rdquoUTF-8rdquogt
ltsection name=rdquoparametersrdquogt
ltitem key=rdquourlrdquo value=httpadminserverWebConnect56gt
ltitem key=rdquoserverrdquo value=rdquoadmin24000rdquogt
ltitem key=rdquossordquo value=rdquotruerdquogt
ltitem key=rdquodestrdquo value=rdquoCProgram FilesEricomrdquogt
ltsectiongt
2 Save the customized webconnectxml to a Web server folder available to all users It is
recommended to use the same Web server as the PowerTerm WebConnect Agent
Example
ltWebConnect installation foldergtwebwebconnectxml
3 Test the accessibility to this file - Type the URL of webconnectxml in the browser
Example
httpltWebServer IPgtWebConnectwebconnectxml
The contents of the file should be displayed
672 Configure the Preferences File
1 Open the plugins folder and open the PowerTermWebConnectClient_560365jar file
You can use Winzip version 70 and up or in Windows XP ndash Create a new file type for the
jar extension click advanced and select compressed (zipped) folder in the drop down list
Now you can open the JAR files in the Windows Explorer
The default contents of the file
configURL=httpleericomcomWebConnectwebconnectxml
2 Specify the accurate URL of the webconnectxml file Example
httpltWebServer IPgtWebConnectwebconnectxml
3 Save the file and close it The WinZip will display the following dialog
ldquoFile preferencesini has been changed since it was extracted Update archive
with this filerdquo
PowerTerm WebConnect 35 Getting Started Guide
4 Click Yes and close the archive
If you are editing the file from within the explorer you will have to save the file elsewhere
and then drag it to the explorer window where the JAR file is open
68 Installing PowerTerm WebConnect Client on Lotus Expeditor
1 Start the Lotus Expeditor client
2 Select File | Application | Install
3 Select Search for new features to install and click Next
4 Select Add Folder Location and type or select the location of the update site folder from
the provided package Click OK
5 Select the location you have just created and click Finish
6 In the Select the feature to install tree select Powerterm WebConnectUpdate Site Click
Next
7 Select I accept the terms in the license agreements and click Next
8 Click Finish
9 When prompted restart the platform
69 Running PowerTerm WebConnect Client for Lotus Expeditor
1 Click Open The PowerTerm WebConnect option is displayed
2 Select PowerTerm WebConnect The application will automatically connect and start
downloading the components from PowerTerm WebConnect Server
IMPORTANT
If you did not install PowerTerm WebConnect Server and are instead connecting to Ericom
Softwarersquos Demo WebConnect Server then you need to open port 443 in the firewall
691 PowerTerm WebConnect Client Workflow
1 PowerTerm WebConnect client reads the URL of webconnectxml from the preferencesini
file and requests it
2 When the webconnectxml is successfully downloaded the application reads the
configuration connects to the specified Web server downloads the PowerTerm
WebConnect components and connects to the PowerTerm WebConnect Server
3 The user is requested to login to the PowerTerm WebConnect Server For testing you
can use the username Example and password example
This step will be skipped if Single Sign-on is set to ldquotruerdquo
PowerTerm WebConnect 36 Getting Started Guide
4 After logging in to PowerTerm WebConnect Server the userrsquos applications are displayed
as defined by the administrator
5 To run an application select the desired application from the list and click Launch or
double-click the application The application will be launched in a separate window
610 Troubleshooting
When you encounter a problem the first step is to open the log file This file is located on
the client machine in the Ericom folder
Windows
CDocuments and SettingsltusernamegtEricomleclientEricomPluginlog
Linux
ltuser-home-directorygtEricomleclientEricomPluginlog
Following is a guide for diagnosing and fixing the problems in cases of error messages and
additional information
Error
Message
Solution
Version File
reading error
1 Check the lsquourlrsquo parameter in the webconnectxml file on the Web
server The value should be
httpltWebServerIPgtWebConnect
2 Try to run the following URL on the browser
Windows
httpltWebServerIPgtWebConnectwindowsptagentvertxt
Linux
httpltWebServerIPgtWebConnectlinuxix86qterm-
wcvertxt
The file contents displayed in the browser window should be in
the following form
560-rel14546
PowerTerm WebConnect Application Zone
560 - Main Release
ltrootgtPowerTerm WebConnect 56ltWebServergt
If the version file contents are not as shown check
- Is the Web Server running
- Are PowerTerm WebConnect Web Components and version files
PowerTerm WebConnect 37 Getting Started Guide
in place
3 On the Web server check ltPowerTerm WebConnect
rootgtwebwindowsptagentvertxt If the contents ldquolook wrongrdquo or
not in the proper form reinstall the PowerTerm WebConnect Web
components
4 On the client machine open the aforementioned URL in the
browser The file content should appear in the browser If it does
not it could be that the Web server is down
Web Server is
shut down
The webconnectxml configuration file must be located on the Web
server The explicit URL to this file is defined in the preferencesini
file (see Configure the Preferences File)
The error message contains the IP address of the Web server
Verify that the Web server on this machine is running
Version file
does not exist
on ltURLgt
See Version File reading error
The
configuration
file is not
accessible or
has a wrong
format
The webconnectxml configuration file must be located on the Web
server and the explicit URL to the configuration must be defined in
the preferencesini file (see Configure the Preferences File)
Try to open the URL specified in the error message in the
browser If it does not open then it either does not exist or it has
a wrong format
Preferences
file does not
exist in the
application
bundle
The preferencesini file containing the URL to the configuration
file was removed from the update site folder
Uninstall the current PowerTerm WebConnect client from the
client machine Create a new customized package (see
PowerTerm WebConnect Client Configuration) and reinstall it
Configuration
file URL is not
defined in
preference
file
The URL to the configuration file does not appear in the
preferencesini file (see Configure the Preferences File)
Uninstall the current PowerTerm WebConnect client from the
client machine Create a new customized package (see
PowerTerm WebConnect Client Configuration) and reinstall it
No IP address
could be
found for the
host
The Web server URL specified in the preferencesini file (see
Configure the Preferences File) or in the webconnectxml file (see
Configure the PowerTerm WebConnect Client) is an unknown
host
If the mistake is in the preferencesini file uninstall the current
PowerTerm WebConnect client from the client machine Create a
new customized package (see PowerTerm WebConnect Client
Configuration) and reinstall it
PowerTerm WebConnect 38 Getting Started Guide
If the mistake is in the webconnectxml file correct the file reopen
the Lotus Expeditor client
Cannot write
to destination
The temporary file cannot be written to the defined destination
Check the write permissions
Copied
configuration
file has wrong
format
The webconnectxml file as received from the specified URL has a
wrong format Correct the file and try again
PowerTerm
WebConnect
Agent URL is
malformed
The PowerTerm WebConnect Agent URL specified in the
webconnectxml file (see Configure the PowerTerm WebConnect
Client) does not have a proper HTTP format Correct the file and
try again
PowerTerm
WebConnect
Agent URL is
not defined
The PowerTerm WebConnect Agent URL parameter is not specified
in the webconnectxml file (see Configure the PowerTerm
WebConnect Client)
Correct the file and try again
The specified
destination
folder name
is wrong
The destination folder name contains illegal characters
ltgt|
Check the dst parameter in the webconnectxml file Correct the
file and try again
You do not
have
permissions
to write to
ltpathgt
The PowerTerm WebConnect Agent cannot be written to the
destination as defined Check the write permissions
The default destination defined in the version file should not to
be changed
A customized destination for PowerTerm WebConnect Agent
downloading can be defined in the webconnectxml file (See
Configure the PowerTerm WebConnect Client)
Check the destination value correct and try again
PowerTerm WebConnect 39 Getting Started Guide
About Ericom
Ericomreg Software is a leading provider of Application Access and Virtualization Solutions
Since 1993 Ericom has been helping users access enterprise mission-critical applications
running on a broad range of Microsoftreg Windowsreg Terminal Servers virtual Desktops
Blade PCs legacy hosts and other systems Ericom provides concrete business value by
helping organizations realize the benefits of their IT investments With offices in the United
States United Kingdom EMEA India and China Ericom also has an extensive network of
distributors and partners throughout North America Europe Asia and the Far East Our
expanding customer base is more than 30 thousand strong with over 7 million
installations
For more information on our products and services contact us at the location nearest to you
And visit our web site httpwwwericomcom
North America Western Europe International
Ericom Software Inc Ericom Software (UK) Ltd Ericom Software Ltd
231 Herbert Avenue Bldg 4 11a Victoria Square 8 Hamarpeh Street
Closter NJ 07624 USA Droitwich Worcestershire Har Hotzvim Technology Park
Tel +1 (201) 767 2210 WR9 8DE United Kingdom Jerusalem 91450 Israel
Fax +1 (201) 767 2205 Tel +44 (0) 845 644 3597 Tel +972 (2) 591 1700
Toll-free 1 (888) 769 7876 Fax +44 (0) 845 644 3598 Fax +972 (2) 571 4737
Email infoericomcom Email infoericomcouk Email infoericomcom
PowerTerm WebConnect 12 Getting Started Guide
3 PowerTerm WebConnect Administration Tool at a Glance
PowerTerm WebConnect Administration Tool manages published applications user sessions
and server configuration The administrator can perform operations such as multiple
application publishing sending messages to logged-on users shutting down sessions and
monitor user activity
To perform the tasks described in this chapter you must launch the Administration Tool via one of the methods detailed in chapter Start the PowerTerm
WebConnect Administration Tool
Launching the Administration Tool from the system tray or using the
Administration Tool launched after completed installation will not allow you to
activate certain features
After you launched the Administration Tool and connected to the server you will receive a
Welcome screen where you select desired activity
bull Publish Multiple Applications opens the Publish Multiple Applications wizard
bull Configure Load Balancer opens PowerTerm Load Balancer Administration Tool
bull Create a Host Connection opens the Add Connection dialog
bull Configure Active Directory opens the Directory Services dialog
PowerTerm WebConnect 13 Getting Started Guide
Close the Welcome screen to enter the Administration Tool main
screen
The Administration Tool main screen has three sections
bull User section lists all users defined in the server
bull Group section lists all groups defined in the server
bull Connection section lists all connections and published applications defined in the
server
By default only the Connection section is displayed when you first open Administration Tool
There are three predefined example-connections ldquoExample_As400rdquo ldquoExample_VTrdquo and
ldquolocalhostrdquo You can test them prior to defining your own
1 Right click the connection you want to test and select Test The PowerTerm
WebConnect HostView Login dialog appears
2 Type example for User Name and example for Password
Credential fields are case sensitive
3 Click Login The desired connection with its pre-programmed demo application is
launched
PowerTerm WebConnect 14 Getting Started Guide
31 Publishing Applications and Documents
In order to enable access to applications and documents on Windows Terminal Servers
publish these applications and documents from the Administration Tool When publishing
applications and content you can specify which servers will be used in a Terminal Server
cluster and which users and groups will have access to these services Once you have
published such applications and documents the RemoteView client can be used to access
them
If you need to provide access to multiple applications on a Terminal Server use the Multiple Application Publishing wizard to significantly reduce the time and
effort required to publish these applications
To publish multiple Windows applications
1 Click Publish Multiple Applications in the Welcome screen The Choose Terminal Server
for Browsing dialog appears
2 Provide the address of the Terminal Server which will be used for browsing and click OK The Application Publisher Step 1 dialog appears This dialog lists all the
applications available in the specified serverrsquos Start menu
3 Select those applications found in the Programs folder of the designated server that you want to publish and click Next The Application Publisher Step 2 dialog appears
4 Determine the destination of your publishing and click Next The Application Publisher
Step 3 dialog appears
5 Determine the Color Quality of your published application
6 Determine the start mode in which you want to run the published application - normal maximized or minimized - and click Next The Application Publisher Step 4
dialog appears
7 Choose the connection speed that matches your infrastructure The connection speed
setting determines the value of three visual effects settings You can also override
these settings specifically
8 Determine whether you prefer the window to display their content while being
dragged or just the outline By default the same setting is used as the client desktop
9 Click Next The Application Publisher Step 5 dialog appears
10 Specify where sounds are to be played ndash locally or remotely
11 Determine which local devices the remote session will have access to (local drivers printer etc) and click Next The Application Publisher Step 6 dialog appears
12 If you have the PowerTerm Load Balancer installed Use all Servers (default) allows the application to run on any Terminal Server in the
cluster This setting is appropriate when the application is installed on all the Terminal
Servers Alternatively you select specific Terminal Servers on which to run this
application
If you have not installed the PowerTerm Load Balancer you will need to explicitly
specify the address of the Terminal Server on which the application will be run
PowerTerm WebConnect 15 Getting Started Guide
13 Click Next The Application Publisher Step 7 dialog appears
14 Select the users groups or OUs to which you wish to publish the applications and click Next The Application Publisher Step 8 dialog appears By default applications will
be published to everybody
15 Click Advanced Settings to modify settings such as the login credentials to the
Terminal Servers By default PowerTerm WebConnect credentials will be passed
through to the Terminal Server
16 Click Finish The published applications appears in the Connection List
Right-click and select Properties or double click on the published application in the
Connections list to view and modify any of the settings which you previously
defined
To publish a remote Desktop
1 Select Action | New | Remote Desktop The Application Publisher Step 1 dialog appears
2 Type the Display Name which will be the name presented to the end-users and click
Next The Application Publisher Step 2 dialog appears
3 Specify where icons for the published desktop will be displayed to the end-user in Publish to
4 Click Choose Icon to replace the desktoprsquos default icon Select the desired icon from
the list that appears
5 Click Next The Application Publisher Step 3 dialog appears
6 Determine Screen Size and the Color Quality of the published desktop
7 If desirable select Show Connection Bar in Full Screen Mode
8 Click Next The Application Publisher Step 4 dialog appears
9 Choose the connection speed that matches your infrastructure The connection speed
setting determines the value of three visual effects settings You can also override
these settings specifically
10 Click Next The Application Publisher Step 5 dialog appears
11 Specify where sounds are to be played ndash locally or remotely Where to Apply Window
Key Combinations and which local devices you want to automatically connect to when
logged on to the remote computer
12 Click Next The Application Publisher Step 6 dialog appears
13 Specify the Server Address and Port Number of the Terminal Server that weill provide
the desktop and click Next The Application Publisher Step 7 dialog appears
14 Select the users groups or OUs to which you wish to publish the desktop and click Next The Application Publisher Step 8 dialog appears
Select the Server group to allow all users to access the published application
15 Click Advanced Settings to modify settings such as the login credentials to the
Terminal Servers By default PowerTerm WebConnect credentials will be used
PowerTerm WebConnect 16 Getting Started Guide
16 Click Finish The published application appears in the Connection List
Right-click Properties or double click on the published application in the
Connections list to modify any of the settings which you previously defined
32 Create Terminal Emulation Connections
To provide access to legacy host systems you will need to create Terminal Emulation
connections For each such connection you can specify the host address emulation type
login script and more Once you have created these connections users will be able to
launch them using HostView (Windows or Linux) WebView or the Java client as
appropriate
1 Click Create a Host Connection in the Welcome screen The Add Connection dialog
appears
2 Enter a Name for the new connection
3 Specify an Owner for the new connection The possibilities are
[None] the connection will not be allowed to run by anyone and it will not be
displayed in any Connection list Server the connection will be accessible for all users of this PowerTerm
WebConnect server A specific group the connection will be accessible for all users of the specified
group A specific user the connection will be accessible for a specified user only
4 Leave category Terminal Emulation selected
5 Select Terminal Type Terminal Model and Communication Type as needed
6 Specify the Host Name or IP address of your host
7 Specify other parameters as needed
8 Select the Security Type as needed if your host supports SSL or SSH and specify
the appropriate details in the Details dialog
9 Use the Settings Key Mapping and Power Pad options to further customize the
connection
10 Click OK and the connection is created
33 Test Connections
It is recommended to test published applications or host connections before they are made
available to end-users
To test a connection
bull Right-click the target connection from the Connection section of the main screen and
select Test
Alternatively
PowerTerm WebConnect 17 Getting Started Guide
1 Select Tools | Run ltdesired clientgt The Login to WebConnect dialog appears
2 Enter the User Name and Password for the individual who owns the connection that
you want to test and click Login The desired PowerTerm WebConnect client is started
and the Connect dialog appears
3 Select the desired connection and click Connect The test is executed
34 Launch the Application Zone or the Application Portal
Users can access the published applications from the Application Zone application launcher
or from the Application Portal web interface
To use the Application Zone go to Start menuProgramsEricom SoftwarePowerTerm
WebConnect 5x and select Client URLs Alternatively type the following URL into your Web
browserrsquos address bar httpltserver addressgtWebConnect5xClientURLshtml In the
page that opens click on the Run button next to the Application Zone to launch it
To use the Application Portal go to Start menuProgramsEricom SoftwarePowerTerm
WebConnect 5x and select it Alternatively type the following URL into the Web browserrsquos
address bar httpltserver addressgtWebConenct5xportalwindowsindexasp
35 Monitor a Users Sessions
From the Administration Tool you can monitor the users sessions and may intervene if
necessary This intervention may result in your input appearing on the users screen The
user receives a notification when an administrator begins and ends monitoring the session
1 Select View | Client Sessions or click to see all the active client sessions
2 Select the desired active session and right-click Attach The Password Verify dialog
appears
3 Enter your password and click OK Some notification dialogs appears and the selected
PowerTerm WebConnect session is viewed
36 View Intruders
bull The Intruders window shows suspected attempts at breaching security After several
suspected intrusion attempts users are blocked temporarily
bull In addition to showing suspected intrusion attempts the Intruders window allows
you to remove restrictions on users
bull Select View | All Intruders or click
PowerTerm WebConnect 18 Getting Started Guide
4 Accessing Virtual Desktops and Blade PCs with PowerTerm WebConnect
This chapter provides instructions on configuring PowerTerm WebConnect for Virtual
Desktop Infrastructure (VDI)
41 Step 1 Launch DeskView Administration Tool
Verify that PowerTerm WebConnect is installed on your server and launch PowerTerm
WebConnect Admin Tool
bull Select Tools | Open VDI Manager The PowerTerm WebConnect DeskView Administration
Tool opens
The first time you launch the DeskView Administration Tool you will be prompted to install
the tool
PowerTerm WebConnect 19 Getting Started Guide
Microsoft Management Console 30 is required for PowerTerm WebConnect DeskView
Administration Tool If you do not have this installed you will also automatically be
prompted to install this update
Follow the installation processes when you are prompted for either install PowerTerm
WebConnect DeskView Administration Tool will automatically launch when these
installations are completed
42 Step 2 Add a Host
1 Right-click Virtualization Hosts and select Add Host The Add a New Host wizard
opens Click Next
2 Enter a Host Name as you would like it to appear in PowerTerm WebConnect
DeskView Administration Tool and a description (optional) Click Next
3 Specify the Virtualization Server type and click Next
4 Specify the connection information and click Next
VMWare Virtual Center v1x and 2x
Specify the HTTPS Web Service address and a UsernamePassword that can access
the host
VMWare Virtual Server 2005
Click Start and then Run
Type ldquoservicesmscrdquo and click OK
Scroll down to PowerTerm WebConnect DeskView Server service and open
Properties
Change the Login Account for the service to match the Domain Administrator
account and password used when setting up Microsoft Virtual Server 2005 and
restart the service Enter the IP or NETBIOS name of the Microsoft Virtual Server 2005 server as the
Server Address in the Connection Broker Wizard
Xen Server
Specify the hypervisor IP address or NETBIOS name the Root UsernamePassword
to the hypervisor and the Service port (default 80)
Oracle VM
Specify the Serverrsquos agent URL and Port (default 8899) for example
httpsltservernamegt8899
Specify the Oracle VM hypervisorrsquos Oracle Agent UsernamePassword (default
username oracle)
5 Click Finish to add the new Host
To configure Virtual Machines for use install the Ericom Tools (vmagentmsi) on each of the
virtual machines on the new host for PowerTerm WebConnect DeskView to recognize them
The vmagentmsi installer is located on the PowerTerm WebConnect server in ltPowerTerm
WebConnect installation foldergtAddOnsDeskView VDI folder (default installation
PowerTerm WebConnect 20 Getting Started Guide
folder is xProgram FilesEricom SoftwareWebConnect 56) During installation you
will need to enter the DeskView IP address or NETBIOS name
If you are using Microsoft Virtual Server 2005 as your Virtualization Host use the
IP address of the DeskView server only when installing the Ericom Tool package
43 Step 3 Create a Pool
Pools are used to organize Virtual Machines (VM) into logical groups This enables
organizations to combine and order resources from multiple systems into one entity To
access available resources end-users simply connect to PowerTerm WebConnect to access
any configured resource
1 Right-click Pools and select Create Pool The Create a Pool wizard opens Click
Next
2 Enter a Pool name as you wish it to appear and a description (optional) and click
Next
3 Specify the Pool type and click Next
4 Specify the Assignment type and click Next
Permanently will cause a virtual machine to affix to the user who has launched
that virtual machine For the duration of the session will cause any virtual machine that is not in use to
be returned to the pool for any user to launch
5 Specify the LogoffDisconnect event and click Next
Select what you would like to happen after a user logs off from a virtual machine
in this pool
Select what you would like to happen when a user is disconnected from a virtual
machine in this pool
6 Click Finish to add the new Pool
You will need to assign virtual machines from your virtualization hosts to your created pool
1 Right-click the pool and select Assign Machines The Assign Machines to ltyour
pool namegt dialog opens
2 Highlight the desired virtual machine(s) and click Select Click OK
44 Step 4 Publish an ApplicationDesktop
1 Return to PowerTerm WebConnect Admin Tool to publish DeskView pools
2 Determine whether to publish a full desktop or a seamless application running
from a virtual desktop
For a full desktop
Select Action | New | Remote Windows Desktop
For a seamless application
Select Action | New | Windows Application
PowerTerm WebConnect 21 Getting Started Guide
3 Select Virtual Desktop in the first step of the wizard and click Next
4 Follow the wizardrsquos instructions until you reach the Virtual Desktops step
5 Select a pool that you previously created and that you would like this connection to choose virtual machines from Click Next
6 Continue and complete the reminder of the wizardrsquos steps
Once the resource is published users who have been assigned access will be able to use it
immediately
PowerTerm WebConnect 22 Getting Started Guide
5 Download and Run PowerTerm WebConnect Clients
PowerTerm WebConnect clients are automatically downloaded and installed onto the client
devices For detailed information and samples please refer to the PowerTerm WebConnect
Sample URLs page To see this page navigate your browser to
httpltweb_servergtWebConnect5xClientURLshtml
PowerTerm WebConnect 23 Getting Started Guide
6 PowerTerm WebConnect Client for Lotus Expeditor
61 Installation Package
PowerTerm WebConnect client for Lotus Expeditor is provided to IBM in an Update Site
package This is a ZIP archive containing the Update Site with the Eclipse feature and plug-
in that comprises the PowerTerm WebConnect client
Extract the ZIP file keeping the foldersrsquo structure intact
NOTE In Winzip verify that the ldquoUse folder namesrdquo option is set to TRUE
Package structure
Update Site
- plugins
- PowerTermWebConnectClient_560365jar
- features
- comericomWebConnect_560365jar
- sitexml
config
- webconnectxml
Definitions
bull webconnectxml PowerTerm WebConnect client configuration file
bull comericomWebConnect_560365jar PowerTerm WebConnect client feature file
bull PowerTermWebConnectClient_560365jar PowerTerm WebConnect client plugin file
62 Pre-installation steps
PowerTerm WebConnect client for Lotus Expeditor does not run independently but in
conjunction with PowerTerm WebConnect Server You can either install it and define your
users groups and applications or use Ericom Softwarersquos Demo PowerTerm WebConnect
Server
bull If you decide to install PowerTerm WebConnect Server you will need the full
installation ie the PowerTerm WebConnect Server and the Web components If you
do not have the installation CD you can download and install a trial version from
wwwericomcom
PowerTerm WebConnect 24 Getting Started Guide
bull If you decide to use Ericom Softwarersquos Demo PowerTerm WebConnect Server then
skip to the chapter Installing PowerTerm WebConnect Client on Lotus Expeditor
63 Install PowerTerm WebConnect Portlet on IBM Workplace server (for Windows OS)
Step 1 Install PowerTerm WebConnect Server
If PowerTerm WebConnect Server and IBM Workplace Server are on separate machines
bull Configure PowerTerm WebConnect Server
Launch PowerTerm WebConnect Administration Tool
Open Files | Configuration | Main
In the [Portal] section edit
Machines=localhostltIBM sever machinegt
bull Configure PowerTerm WebConnect Web components
Copy the ldquowebrdquo folder from the PowerTerm WebConnect server installation to the
IBM Workplace server machine
Create an Alias or a Virtual directory to it named WebConnect on the Web
server providing access to it for the users This is in order to enable the users to
download the necessary files to run their applications
Step 2 Enable JSR portlets
1 On IBM Workplace Server go to ltPortalServergtsharedappconfigservicesConfigServiceproperties
2 Edit portalenablejsr168=true
3 Save and close the file
Step 3 Enable SSO
1 On IBM Workplace Server go to ltPortalServergtsharedappconfigservicesLoaderServiceproperties
2 Edit commandpath=comericomportalcommandscomibmwpsenginecommands
3 Save and close the file
Step 4 Copy Files
The following files need to be copied from WebConnect ServerAddOnsIBM
WorkplacePortlet folder to IBM Workplace Server
File name to copy Destination folder
OpenSSLdll ltAppServergtjavajrebin
IbmPortaldll ltAppServergtjavajrebin
IbmPortalini ltAppServergtjavajrebin
PowerTerm WebConnect 25 Getting Started Guide
WebConnectPortaljar ltAppServergtlib
EricomLoginjar ltPortalServergtsharedapp
Step 5 Portlet Configuration
1 On IBM Workplace Server go to ltAppServergtjavajrebinIbmPortalini
2 You can modify the following parameters in the [Server=WebConnect] section webserverport=ltIBM web server portgt
Specifies the Web server port for accessing the PowerTerm WebConnect clients folder
Default 80 Address
Specifies the address of the PowerTerm WebConnect Server machine for Portlet to
connect to when PowerTerm WebConnect Server is located on a different machine
than the IBM Workplace Server CustomAddress
Specifies the addresss of the PowerTerm WebConnect Server machine for Clients to connect to If CustomAddress is the same as Address then this may be omitted webserveraddr
Specifies the address of the Web Server machine when it is located on a different
machine than the IBM Workplace Server
3 Restart the IBM server ltPortalServergtrootscriptsstopWorkplaceServicesbat ltPortalServergtrootscriptsstartWorkplaceServicesbat
This procedure may take about 20 minutes
Step 6 Install the Portlet
1 In a Web browser open the URL httpltIBM Workplace
Servergt9081lwpmyworkplace to open the IBM Workplace Portal
2 Login as administrator
3 Go to Administration | Portlets | Install
4 Browse to the PowerTerm WebConnectwar file located on PowerTerm WebConnect
Server and click Next
5 Click Install
Step 7 Create an Application page
1 Login to the Workplace
2 Go to Portal User Interface | Manage Pages
3 Search for My Work
4 Click the My Work link and select New Page
5 Name the page PowerTerm WebConnect and click OK
6 Click OK again You will see the created page on the list
7 Click the pencil icon on the new page and select the 1 square layout
PowerTerm WebConnect 26 Getting Started Guide
8 Click Add Portlet and search for PowerTerm WebConnect
9 Select it and click OK
10 Click Done
11 Click My work at the top of the page PowerTerm WebConnect is displayed on the list
Step 8 Run the Portlet
1 Restart IBM Workplace Server
2 Open IBM Workplace Portal in a browser httpltportal servergtlwpmyworkplace
3 Login to IBM Workplace Server
4 Click My work PowerTerm WebConnect portlet is displayed
5 Launch it The Userrsquos applications as defined on PowerTerm WebConnect Server
appear
6 Click an application to launch it
64 Install PowerTerm WebConnect Portlet on IBM Workplace server (for Linux OS)
Step 1 Enable JSR 168 portlets
1 Go to optIBMWorkplacePortalServersharedappconfigservicesConfigServiceproperties
2 Modify the portalenablejsr168 property to ldquotruerdquo
3 Restart the server cd optIBMWorkplacePortalServerrootscripts
Run stopWorkplaceServicessh
Run startWorkplaceServicessh
This procedure can take up to 20 minutes
4 Log on to the workplace server at httpltworkplace servergt9081lwpmyworkplace using
the administrators username and password
Step 2 Install the portlet
1 Restart IBM Workplace Server
2 In a Web browser open the URL httpltworkplace server IPgtlwpmyworkplace
3 Login to IBM Workplace Server as an administrator
4 Go to Administration | Portlets | Install
5 Browse to the PowerTerm WebConnectwar file located on PowerTerm WebConnect
Server and click Next
6 Click Install
PowerTerm WebConnect 27 Getting Started Guide
Step 3 Install the Application page
1 Login to the workplace as administrator
2 Go to Administration | Portal User Interface | Manage Pages
3 Search for My Work
4 Click the My Work link and select New Page
5 Name the page PowerTerm WebConnect and click OK
6 Click OK again You will see the created page on the list
7 Click the pencil icon and select the 1-square layout
8 Click Add Portlet and search for PowerTerm WebConnect
9 Select it and click OK
10 Click Done
11 Click My work on top and PowerTerm WebConnect is displayed on the left bar
Step 4 Run the portlet
1 Restart IBM Workplace Server
2 Open IBM Workplace Portal in a browser httpltportal servergtlwpmyworkplace
3 Login to IBM Workplace Server
4 Click My work PowerTerm WebConnect portlet is displayed
5 Launch it The Userrsquos applications as defined on PowerTerm WebConnect Server
appear
6 Click an application to launch it
65 Install PowerTerm WebConnect Portlet on IBM WebSphere 61 server (for Windows OS)
Step 1 Install PowerTerm WebConnect Server
You have to configure PowerTerm WebConnect Server if it and the IBM WebSphere Server
are on separate machines
1 Launch PowerTerm WebConnect Administration Tool
2 Open Files | Configuration | Main
3 In the [Portal] section edit Machines=localhostltIBM sever machinegt
Step 2 Copy Files
The following files need to be copied from WebConnect ServerAddOnsIBM
WebSpherePortlet folder to IBM WebSphere Server
PowerTerm WebConnect 28 Getting Started Guide
File name to copy Destination folder
OpenSSLdll ltAppServergtjavajrebin
IbmPortaldll ltAppServergtjavajrebin
IbmPortalini ltAppServergtjavajrebin
WebConnectPortaljar ltAppServergtlib
Step 3 Portlet Configuration
1 On IBM Workplace Server go to ltAppServergtjavajrebinIbmPortalini
2 You can modify the following parameters in the [Server=WebConnect] section webserverport=ltIBM web server portgt
Specifies the Web server port for accessing the PowerTerm WebConnect clients folder
Default 80 Address
Specifies the address of the PowerTerm WebConnect Server machine for Portlet to
connect to when PowerTerm WebConnect Server is located on a different machine
than the IBM Workplace Server CustomAddress
Specifies the addresss of the PowerTerm WebConnect Server machine for Clients to connect to If CustomAddress is the same as Address then this may be omitted webserveraddr
Specifies the address of the Web Server machine when it is located on a different
machine than the IBM Workplace Server
3 Restart the IBM server ltAppServergtProfilesAppServer01binstopServerbat ltAppServergtProfilesAppServer01binstartServerbat
This procedure may take about 20 minutes
Step 4 Install the Portlet and create an Application page
1 In a Web browser open the URL httpltIBM WebSphere Servergt9060ibmconsole
to open the IBM WebSphere Portal
2 Login and go to Applications | Install New Application
3 Browse to the PowerTerm WebConnectwar file located on PowerTerm WebConnect
Server
4 Enter Context root and click Next The Select installation options dialog appears
5 Optional change options to your preference or keep the default
6 Click Next
7 Select Ericom in the Module column click Apply and then Next
8 Click Finish and then Save
9 Select Applications | Enterprise Applications
10 Select PowerTerm WebConnectwar checkbox and click Start
PowerTerm WebConnect 29 Getting Started Guide
11 Enter in the Web browser the URL httpltIBM WebSphere
Servergt9080ltContext rootgtEricom portlet The Login dialog appears
12 Login and you will see PowerTerm WebConnect displayed on the list
Step 5 Run the Portlet
1 Restart IBM WebSphere Server
2 Open IBM WebSphere Portal in a browser httpltportal servergt9080ltContext
rootgtEricom portlet
3 Login to IBM WebSphere Server
4 Launch it The Userrsquos applications as defined on PowerTerm WebConnect Server
appear
5 Click an application to launch it
66 PowerTerm WebConnect Server Configuration
bull To enable the Lotus Expeditor to run the PowerTerm WebConnect client the
System Administrator must provide the users with accounts on PowerTerm
WebConnect Server (see the PowerTerm WebConnect Administratorrsquos Manual for
instructions on how to create users groups and connections on the PowerTerm
WebConnect Server)
bull To enable PowerTerm WebConnectrsquos Single Sign-On feature the System
Administrator must create a PowerTerm WebConnect user with the same
username and password as used for the Lotus Expeditor For a managed Lotus
Expeditor the credentials used are the username and password sent to the
managing server For an unmanaged Lotus Expeditor the operation system
username and the Lotus Expeditor password are used as credentials
NOTE If a password is not defined then the Single Sign-On will fail and the user will be
prompted with a login dialog
67 PowerTerm WebConnect Client Configuration
The PowerTerm WebConnect client is configured in webconnectxml located in the config
folder webconnectxml parameters are
url The PowerTerm WebConnect Agent url
server The PowerTerm WebConnect Server address
sso The Single Sign-On feature
dst The local destination for downloading PowerTerm WebConnect
components
PowerTerm WebConnect 30 Getting Started Guide
url
PowerTerm WebConnect components are installed on a Web server Their default url is
Windows Agent
httpltWebServer IPgtWebConnectwindowsptagentcab
Linux Agent
httpltWebServer IPgtWebConnectlinuxix86qterm-wczip
The url parameter must include the first part of the url (which is identical for both Windows
and Linux agents)
The PowerTerm WebConnect client will automatically append the appropriate suffix in
order to create a full accurate url
Example
ltitem key=rdquourlrdquo value=httpadminserverWebConnectgt
server
The computer name or IP address of the PowerTerm WebConnect Server machine
The PowerTerm WebConnect client will log in to this PowerTerm WebConnect Server
display the applications defined on it and run them according to this serverrsquos configuration
Format ltserver IPgt[ltportgt]
where default port is 4000 (can be edited)
Example
ltitem key=rdquoserverrdquo value=rdquoadmin24000rdquogt
sso
Determines whether Single Sign-on will be used to log in to PowerTerm WebConnect
Server Values
bull True (default) the client should automatically log in to the PowerTerm WebConnect
Server using the same credentials as the ones used to log in to the Lotus Expeditor
client
The System Administrator must verify that these credentials can log in to the
PowerTerm WebConnect Server
bull False the user will be prompted with a login dialog or will log in automatically using
previously saved credentials
Example
ltitem key=rdquossordquo value=rdquotruerdquogt
Autologin mode
PowerTerm WebConnect 31 Getting Started Guide
If sso is set to True the user is not prompted for credentials and the login process to
PowerTerm WebConnect Server is done automatically sending the credentials used for the
Lotus Expeditor unless the Lotus Expeditor does not have a password defined (In the
Lotus Expeditor preferences page | Password| Prompt me for a password at start up checkbox)
However if Single Sign-on is not used there are several options regarding Autologin that
can be defined in the PowerTerm WebConnect Preferences page Options
bull Yes
bull No
bull Interactive
bull First time interactive (default) ndash Simplifies the login process to PowerTerm
WebConnect Server In this mode the first time the user logs in to PowerTerm
WebConnect Server he will be prompted for his credentials with the Login dialog
These credentials will be stored in the machine and from then on the login process to
PowerTerm WebConnect Server will be done automatically
1 Open File | Preferences from the Lotus Expeditor and select PowerTerm WebConnect
2 In the Autologin to WebConnect Server section select First Interactive and click OK
3 Start PowerTerm WebConnect Client for Lotus Expeditor If credentials were entered
at least once then the next time the client will connect to PowerTerm WebConnect
Server without prompting for the user name and password
The Administrator must configure the Agent to do nothing when it exits for the
feature to work this way See PowerTerm WebConnect Administratorrsquos Manual for more information about defining Autologin
bull Allow multiple selection ndash Defines whether the user can launch more than one
application at a time (by using the ltCtrlgt or ltShiftgt button while selecting applications)
dst
Defines the path to download PowerTerm WebConnect components on the client machine
The dst parameter can contain macros which are translated by the PowerTerm WebConnect
Client for Lotus Expeditor during runtime The macros should be placed between percent
symbols () for example WebServer
When such a value is defined the PowerTerm WebConnect Client for Lotus Expeditor
substitutes the entire expression for the macrorsquos value
The PowerTerm WebConnect Client for Lotus Expeditor does not support the use
of environment variables as macros
Macros are not case sensitive
Macros supported by PowerTerm WebConnect Client for Lotus Expeditor
Macro name Description
WebServer The name of the Web server
It is obtained from the PowerTerm WebConnect Agent url
PowerTerm WebConnect 32 Getting Started Guide
parameter
Name The name of the clientrsquos CAB or ZIP file eg ldquoptagentrdquo
Display The clientrsquos display name from the version file
Version The clientrsquos version value It is obtained from the version
file
Root The default root location
Windows ldquoCrdquo
LinuxUnix an empty string
OSDir Windows Windowsrsquo installation directory for example
ldquoCWindowsrdquo
Linux an empty string
OSDrive Windows Windowsrsquo installation drive for example ldquoCrdquo
Linux an empty string
HomePath Windows The HOMEPATH environment variable
Linux The HOME environment variable
Home The Ericom folder in the userrsquos home directory
Windows CDocuments and SettingsltusergtApplication
DataEricom
Linux ltusergtEricom
In addition to the predefined macros listed above the PowerTerm WebConnect client
supports the usage of Java System Properties
Java System Properties available for users on Windows XP SP2
Java System Property Name Value Example
javaversion 150
javavendorurl httpwwwibmcom
javahome CIBMcommonpluginscomibmpvcwctruntim
esj2sewin32x86_150SR2-
20060511rcpeclipsepluginscomibmrcpj2sew
in32x86_150SR2-20060511jre
javavmspecificationversion 10
javavmversion 23
javavmvendor IBM Corporation
javavmname IBM J9 VM
PowerTerm WebConnect 33 Getting Started Guide
javaiotmpdir CDOCUME~1dianaLOCALS~1Temp
javacompiler j9jit23
javaextdirs CIBMcommonpluginscomibmpvcwctruntim
esj2sewin32x86_150SR2-
20060511rcpeclipsepluginscomibmrcpj2sew
in32x86_150SR2-20060511jrelibext
osname Windows XP
osarch x86
osversion 51 build 2600 Service Pack 2
pathseparator
username Jone
userhome CDocuments and SettingsJone
userdir CIBMRSA
usertimezone GMT+0200
System properties available for users on Linux RedHat 9
Java System Property Name Value Example
javaversion 150
javavendorurl httpwwwibmcom
javahome usrjavajre150_07
javavmversion 150
javavmvendor IBM Corporation
javavmname IBM J9 VM
javaclasspath
javalibrarypath
javaiotmpdir tmp
javacompiler
javaextdirs
osname Linux
osarch i386
osversion 2420-8
pathseparator
PowerTerm WebConnect 34 Getting Started Guide
username root
userhome root
userdir root
System properties names are placed in the configuration file within percent symbols ()
(like macros)
671 Configure the PowerTerm WebConnect Client
1 Open the Config Folder and edit the webconnectxml file Example
ltxml version =rdquo10rdquo encoding=rdquoUTF-8rdquogt
ltsection name=rdquoparametersrdquogt
ltitem key=rdquourlrdquo value=httpadminserverWebConnect56gt
ltitem key=rdquoserverrdquo value=rdquoadmin24000rdquogt
ltitem key=rdquossordquo value=rdquotruerdquogt
ltitem key=rdquodestrdquo value=rdquoCProgram FilesEricomrdquogt
ltsectiongt
2 Save the customized webconnectxml to a Web server folder available to all users It is
recommended to use the same Web server as the PowerTerm WebConnect Agent
Example
ltWebConnect installation foldergtwebwebconnectxml
3 Test the accessibility to this file - Type the URL of webconnectxml in the browser
Example
httpltWebServer IPgtWebConnectwebconnectxml
The contents of the file should be displayed
672 Configure the Preferences File
1 Open the plugins folder and open the PowerTermWebConnectClient_560365jar file
You can use Winzip version 70 and up or in Windows XP ndash Create a new file type for the
jar extension click advanced and select compressed (zipped) folder in the drop down list
Now you can open the JAR files in the Windows Explorer
The default contents of the file
configURL=httpleericomcomWebConnectwebconnectxml
2 Specify the accurate URL of the webconnectxml file Example
httpltWebServer IPgtWebConnectwebconnectxml
3 Save the file and close it The WinZip will display the following dialog
ldquoFile preferencesini has been changed since it was extracted Update archive
with this filerdquo
PowerTerm WebConnect 35 Getting Started Guide
4 Click Yes and close the archive
If you are editing the file from within the explorer you will have to save the file elsewhere
and then drag it to the explorer window where the JAR file is open
68 Installing PowerTerm WebConnect Client on Lotus Expeditor
1 Start the Lotus Expeditor client
2 Select File | Application | Install
3 Select Search for new features to install and click Next
4 Select Add Folder Location and type or select the location of the update site folder from
the provided package Click OK
5 Select the location you have just created and click Finish
6 In the Select the feature to install tree select Powerterm WebConnectUpdate Site Click
Next
7 Select I accept the terms in the license agreements and click Next
8 Click Finish
9 When prompted restart the platform
69 Running PowerTerm WebConnect Client for Lotus Expeditor
1 Click Open The PowerTerm WebConnect option is displayed
2 Select PowerTerm WebConnect The application will automatically connect and start
downloading the components from PowerTerm WebConnect Server
IMPORTANT
If you did not install PowerTerm WebConnect Server and are instead connecting to Ericom
Softwarersquos Demo WebConnect Server then you need to open port 443 in the firewall
691 PowerTerm WebConnect Client Workflow
1 PowerTerm WebConnect client reads the URL of webconnectxml from the preferencesini
file and requests it
2 When the webconnectxml is successfully downloaded the application reads the
configuration connects to the specified Web server downloads the PowerTerm
WebConnect components and connects to the PowerTerm WebConnect Server
3 The user is requested to login to the PowerTerm WebConnect Server For testing you
can use the username Example and password example
This step will be skipped if Single Sign-on is set to ldquotruerdquo
PowerTerm WebConnect 36 Getting Started Guide
4 After logging in to PowerTerm WebConnect Server the userrsquos applications are displayed
as defined by the administrator
5 To run an application select the desired application from the list and click Launch or
double-click the application The application will be launched in a separate window
610 Troubleshooting
When you encounter a problem the first step is to open the log file This file is located on
the client machine in the Ericom folder
Windows
CDocuments and SettingsltusernamegtEricomleclientEricomPluginlog
Linux
ltuser-home-directorygtEricomleclientEricomPluginlog
Following is a guide for diagnosing and fixing the problems in cases of error messages and
additional information
Error
Message
Solution
Version File
reading error
1 Check the lsquourlrsquo parameter in the webconnectxml file on the Web
server The value should be
httpltWebServerIPgtWebConnect
2 Try to run the following URL on the browser
Windows
httpltWebServerIPgtWebConnectwindowsptagentvertxt
Linux
httpltWebServerIPgtWebConnectlinuxix86qterm-
wcvertxt
The file contents displayed in the browser window should be in
the following form
560-rel14546
PowerTerm WebConnect Application Zone
560 - Main Release
ltrootgtPowerTerm WebConnect 56ltWebServergt
If the version file contents are not as shown check
- Is the Web Server running
- Are PowerTerm WebConnect Web Components and version files
PowerTerm WebConnect 37 Getting Started Guide
in place
3 On the Web server check ltPowerTerm WebConnect
rootgtwebwindowsptagentvertxt If the contents ldquolook wrongrdquo or
not in the proper form reinstall the PowerTerm WebConnect Web
components
4 On the client machine open the aforementioned URL in the
browser The file content should appear in the browser If it does
not it could be that the Web server is down
Web Server is
shut down
The webconnectxml configuration file must be located on the Web
server The explicit URL to this file is defined in the preferencesini
file (see Configure the Preferences File)
The error message contains the IP address of the Web server
Verify that the Web server on this machine is running
Version file
does not exist
on ltURLgt
See Version File reading error
The
configuration
file is not
accessible or
has a wrong
format
The webconnectxml configuration file must be located on the Web
server and the explicit URL to the configuration must be defined in
the preferencesini file (see Configure the Preferences File)
Try to open the URL specified in the error message in the
browser If it does not open then it either does not exist or it has
a wrong format
Preferences
file does not
exist in the
application
bundle
The preferencesini file containing the URL to the configuration
file was removed from the update site folder
Uninstall the current PowerTerm WebConnect client from the
client machine Create a new customized package (see
PowerTerm WebConnect Client Configuration) and reinstall it
Configuration
file URL is not
defined in
preference
file
The URL to the configuration file does not appear in the
preferencesini file (see Configure the Preferences File)
Uninstall the current PowerTerm WebConnect client from the
client machine Create a new customized package (see
PowerTerm WebConnect Client Configuration) and reinstall it
No IP address
could be
found for the
host
The Web server URL specified in the preferencesini file (see
Configure the Preferences File) or in the webconnectxml file (see
Configure the PowerTerm WebConnect Client) is an unknown
host
If the mistake is in the preferencesini file uninstall the current
PowerTerm WebConnect client from the client machine Create a
new customized package (see PowerTerm WebConnect Client
Configuration) and reinstall it
PowerTerm WebConnect 38 Getting Started Guide
If the mistake is in the webconnectxml file correct the file reopen
the Lotus Expeditor client
Cannot write
to destination
The temporary file cannot be written to the defined destination
Check the write permissions
Copied
configuration
file has wrong
format
The webconnectxml file as received from the specified URL has a
wrong format Correct the file and try again
PowerTerm
WebConnect
Agent URL is
malformed
The PowerTerm WebConnect Agent URL specified in the
webconnectxml file (see Configure the PowerTerm WebConnect
Client) does not have a proper HTTP format Correct the file and
try again
PowerTerm
WebConnect
Agent URL is
not defined
The PowerTerm WebConnect Agent URL parameter is not specified
in the webconnectxml file (see Configure the PowerTerm
WebConnect Client)
Correct the file and try again
The specified
destination
folder name
is wrong
The destination folder name contains illegal characters
ltgt|
Check the dst parameter in the webconnectxml file Correct the
file and try again
You do not
have
permissions
to write to
ltpathgt
The PowerTerm WebConnect Agent cannot be written to the
destination as defined Check the write permissions
The default destination defined in the version file should not to
be changed
A customized destination for PowerTerm WebConnect Agent
downloading can be defined in the webconnectxml file (See
Configure the PowerTerm WebConnect Client)
Check the destination value correct and try again
PowerTerm WebConnect 39 Getting Started Guide
About Ericom
Ericomreg Software is a leading provider of Application Access and Virtualization Solutions
Since 1993 Ericom has been helping users access enterprise mission-critical applications
running on a broad range of Microsoftreg Windowsreg Terminal Servers virtual Desktops
Blade PCs legacy hosts and other systems Ericom provides concrete business value by
helping organizations realize the benefits of their IT investments With offices in the United
States United Kingdom EMEA India and China Ericom also has an extensive network of
distributors and partners throughout North America Europe Asia and the Far East Our
expanding customer base is more than 30 thousand strong with over 7 million
installations
For more information on our products and services contact us at the location nearest to you
And visit our web site httpwwwericomcom
North America Western Europe International
Ericom Software Inc Ericom Software (UK) Ltd Ericom Software Ltd
231 Herbert Avenue Bldg 4 11a Victoria Square 8 Hamarpeh Street
Closter NJ 07624 USA Droitwich Worcestershire Har Hotzvim Technology Park
Tel +1 (201) 767 2210 WR9 8DE United Kingdom Jerusalem 91450 Israel
Fax +1 (201) 767 2205 Tel +44 (0) 845 644 3597 Tel +972 (2) 591 1700
Toll-free 1 (888) 769 7876 Fax +44 (0) 845 644 3598 Fax +972 (2) 571 4737
Email infoericomcom Email infoericomcouk Email infoericomcom
PowerTerm WebConnect 13 Getting Started Guide
Close the Welcome screen to enter the Administration Tool main
screen
The Administration Tool main screen has three sections
bull User section lists all users defined in the server
bull Group section lists all groups defined in the server
bull Connection section lists all connections and published applications defined in the
server
By default only the Connection section is displayed when you first open Administration Tool
There are three predefined example-connections ldquoExample_As400rdquo ldquoExample_VTrdquo and
ldquolocalhostrdquo You can test them prior to defining your own
1 Right click the connection you want to test and select Test The PowerTerm
WebConnect HostView Login dialog appears
2 Type example for User Name and example for Password
Credential fields are case sensitive
3 Click Login The desired connection with its pre-programmed demo application is
launched
PowerTerm WebConnect 14 Getting Started Guide
31 Publishing Applications and Documents
In order to enable access to applications and documents on Windows Terminal Servers
publish these applications and documents from the Administration Tool When publishing
applications and content you can specify which servers will be used in a Terminal Server
cluster and which users and groups will have access to these services Once you have
published such applications and documents the RemoteView client can be used to access
them
If you need to provide access to multiple applications on a Terminal Server use the Multiple Application Publishing wizard to significantly reduce the time and
effort required to publish these applications
To publish multiple Windows applications
1 Click Publish Multiple Applications in the Welcome screen The Choose Terminal Server
for Browsing dialog appears
2 Provide the address of the Terminal Server which will be used for browsing and click OK The Application Publisher Step 1 dialog appears This dialog lists all the
applications available in the specified serverrsquos Start menu
3 Select those applications found in the Programs folder of the designated server that you want to publish and click Next The Application Publisher Step 2 dialog appears
4 Determine the destination of your publishing and click Next The Application Publisher
Step 3 dialog appears
5 Determine the Color Quality of your published application
6 Determine the start mode in which you want to run the published application - normal maximized or minimized - and click Next The Application Publisher Step 4
dialog appears
7 Choose the connection speed that matches your infrastructure The connection speed
setting determines the value of three visual effects settings You can also override
these settings specifically
8 Determine whether you prefer the window to display their content while being
dragged or just the outline By default the same setting is used as the client desktop
9 Click Next The Application Publisher Step 5 dialog appears
10 Specify where sounds are to be played ndash locally or remotely
11 Determine which local devices the remote session will have access to (local drivers printer etc) and click Next The Application Publisher Step 6 dialog appears
12 If you have the PowerTerm Load Balancer installed Use all Servers (default) allows the application to run on any Terminal Server in the
cluster This setting is appropriate when the application is installed on all the Terminal
Servers Alternatively you select specific Terminal Servers on which to run this
application
If you have not installed the PowerTerm Load Balancer you will need to explicitly
specify the address of the Terminal Server on which the application will be run
PowerTerm WebConnect 15 Getting Started Guide
13 Click Next The Application Publisher Step 7 dialog appears
14 Select the users groups or OUs to which you wish to publish the applications and click Next The Application Publisher Step 8 dialog appears By default applications will
be published to everybody
15 Click Advanced Settings to modify settings such as the login credentials to the
Terminal Servers By default PowerTerm WebConnect credentials will be passed
through to the Terminal Server
16 Click Finish The published applications appears in the Connection List
Right-click and select Properties or double click on the published application in the
Connections list to view and modify any of the settings which you previously
defined
To publish a remote Desktop
1 Select Action | New | Remote Desktop The Application Publisher Step 1 dialog appears
2 Type the Display Name which will be the name presented to the end-users and click
Next The Application Publisher Step 2 dialog appears
3 Specify where icons for the published desktop will be displayed to the end-user in Publish to
4 Click Choose Icon to replace the desktoprsquos default icon Select the desired icon from
the list that appears
5 Click Next The Application Publisher Step 3 dialog appears
6 Determine Screen Size and the Color Quality of the published desktop
7 If desirable select Show Connection Bar in Full Screen Mode
8 Click Next The Application Publisher Step 4 dialog appears
9 Choose the connection speed that matches your infrastructure The connection speed
setting determines the value of three visual effects settings You can also override
these settings specifically
10 Click Next The Application Publisher Step 5 dialog appears
11 Specify where sounds are to be played ndash locally or remotely Where to Apply Window
Key Combinations and which local devices you want to automatically connect to when
logged on to the remote computer
12 Click Next The Application Publisher Step 6 dialog appears
13 Specify the Server Address and Port Number of the Terminal Server that weill provide
the desktop and click Next The Application Publisher Step 7 dialog appears
14 Select the users groups or OUs to which you wish to publish the desktop and click Next The Application Publisher Step 8 dialog appears
Select the Server group to allow all users to access the published application
15 Click Advanced Settings to modify settings such as the login credentials to the
Terminal Servers By default PowerTerm WebConnect credentials will be used
PowerTerm WebConnect 16 Getting Started Guide
16 Click Finish The published application appears in the Connection List
Right-click Properties or double click on the published application in the
Connections list to modify any of the settings which you previously defined
32 Create Terminal Emulation Connections
To provide access to legacy host systems you will need to create Terminal Emulation
connections For each such connection you can specify the host address emulation type
login script and more Once you have created these connections users will be able to
launch them using HostView (Windows or Linux) WebView or the Java client as
appropriate
1 Click Create a Host Connection in the Welcome screen The Add Connection dialog
appears
2 Enter a Name for the new connection
3 Specify an Owner for the new connection The possibilities are
[None] the connection will not be allowed to run by anyone and it will not be
displayed in any Connection list Server the connection will be accessible for all users of this PowerTerm
WebConnect server A specific group the connection will be accessible for all users of the specified
group A specific user the connection will be accessible for a specified user only
4 Leave category Terminal Emulation selected
5 Select Terminal Type Terminal Model and Communication Type as needed
6 Specify the Host Name or IP address of your host
7 Specify other parameters as needed
8 Select the Security Type as needed if your host supports SSL or SSH and specify
the appropriate details in the Details dialog
9 Use the Settings Key Mapping and Power Pad options to further customize the
connection
10 Click OK and the connection is created
33 Test Connections
It is recommended to test published applications or host connections before they are made
available to end-users
To test a connection
bull Right-click the target connection from the Connection section of the main screen and
select Test
Alternatively
PowerTerm WebConnect 17 Getting Started Guide
1 Select Tools | Run ltdesired clientgt The Login to WebConnect dialog appears
2 Enter the User Name and Password for the individual who owns the connection that
you want to test and click Login The desired PowerTerm WebConnect client is started
and the Connect dialog appears
3 Select the desired connection and click Connect The test is executed
34 Launch the Application Zone or the Application Portal
Users can access the published applications from the Application Zone application launcher
or from the Application Portal web interface
To use the Application Zone go to Start menuProgramsEricom SoftwarePowerTerm
WebConnect 5x and select Client URLs Alternatively type the following URL into your Web
browserrsquos address bar httpltserver addressgtWebConnect5xClientURLshtml In the
page that opens click on the Run button next to the Application Zone to launch it
To use the Application Portal go to Start menuProgramsEricom SoftwarePowerTerm
WebConnect 5x and select it Alternatively type the following URL into the Web browserrsquos
address bar httpltserver addressgtWebConenct5xportalwindowsindexasp
35 Monitor a Users Sessions
From the Administration Tool you can monitor the users sessions and may intervene if
necessary This intervention may result in your input appearing on the users screen The
user receives a notification when an administrator begins and ends monitoring the session
1 Select View | Client Sessions or click to see all the active client sessions
2 Select the desired active session and right-click Attach The Password Verify dialog
appears
3 Enter your password and click OK Some notification dialogs appears and the selected
PowerTerm WebConnect session is viewed
36 View Intruders
bull The Intruders window shows suspected attempts at breaching security After several
suspected intrusion attempts users are blocked temporarily
bull In addition to showing suspected intrusion attempts the Intruders window allows
you to remove restrictions on users
bull Select View | All Intruders or click
PowerTerm WebConnect 18 Getting Started Guide
4 Accessing Virtual Desktops and Blade PCs with PowerTerm WebConnect
This chapter provides instructions on configuring PowerTerm WebConnect for Virtual
Desktop Infrastructure (VDI)
41 Step 1 Launch DeskView Administration Tool
Verify that PowerTerm WebConnect is installed on your server and launch PowerTerm
WebConnect Admin Tool
bull Select Tools | Open VDI Manager The PowerTerm WebConnect DeskView Administration
Tool opens
The first time you launch the DeskView Administration Tool you will be prompted to install
the tool
PowerTerm WebConnect 19 Getting Started Guide
Microsoft Management Console 30 is required for PowerTerm WebConnect DeskView
Administration Tool If you do not have this installed you will also automatically be
prompted to install this update
Follow the installation processes when you are prompted for either install PowerTerm
WebConnect DeskView Administration Tool will automatically launch when these
installations are completed
42 Step 2 Add a Host
1 Right-click Virtualization Hosts and select Add Host The Add a New Host wizard
opens Click Next
2 Enter a Host Name as you would like it to appear in PowerTerm WebConnect
DeskView Administration Tool and a description (optional) Click Next
3 Specify the Virtualization Server type and click Next
4 Specify the connection information and click Next
VMWare Virtual Center v1x and 2x
Specify the HTTPS Web Service address and a UsernamePassword that can access
the host
VMWare Virtual Server 2005
Click Start and then Run
Type ldquoservicesmscrdquo and click OK
Scroll down to PowerTerm WebConnect DeskView Server service and open
Properties
Change the Login Account for the service to match the Domain Administrator
account and password used when setting up Microsoft Virtual Server 2005 and
restart the service Enter the IP or NETBIOS name of the Microsoft Virtual Server 2005 server as the
Server Address in the Connection Broker Wizard
Xen Server
Specify the hypervisor IP address or NETBIOS name the Root UsernamePassword
to the hypervisor and the Service port (default 80)
Oracle VM
Specify the Serverrsquos agent URL and Port (default 8899) for example
httpsltservernamegt8899
Specify the Oracle VM hypervisorrsquos Oracle Agent UsernamePassword (default
username oracle)
5 Click Finish to add the new Host
To configure Virtual Machines for use install the Ericom Tools (vmagentmsi) on each of the
virtual machines on the new host for PowerTerm WebConnect DeskView to recognize them
The vmagentmsi installer is located on the PowerTerm WebConnect server in ltPowerTerm
WebConnect installation foldergtAddOnsDeskView VDI folder (default installation
PowerTerm WebConnect 20 Getting Started Guide
folder is xProgram FilesEricom SoftwareWebConnect 56) During installation you
will need to enter the DeskView IP address or NETBIOS name
If you are using Microsoft Virtual Server 2005 as your Virtualization Host use the
IP address of the DeskView server only when installing the Ericom Tool package
43 Step 3 Create a Pool
Pools are used to organize Virtual Machines (VM) into logical groups This enables
organizations to combine and order resources from multiple systems into one entity To
access available resources end-users simply connect to PowerTerm WebConnect to access
any configured resource
1 Right-click Pools and select Create Pool The Create a Pool wizard opens Click
Next
2 Enter a Pool name as you wish it to appear and a description (optional) and click
Next
3 Specify the Pool type and click Next
4 Specify the Assignment type and click Next
Permanently will cause a virtual machine to affix to the user who has launched
that virtual machine For the duration of the session will cause any virtual machine that is not in use to
be returned to the pool for any user to launch
5 Specify the LogoffDisconnect event and click Next
Select what you would like to happen after a user logs off from a virtual machine
in this pool
Select what you would like to happen when a user is disconnected from a virtual
machine in this pool
6 Click Finish to add the new Pool
You will need to assign virtual machines from your virtualization hosts to your created pool
1 Right-click the pool and select Assign Machines The Assign Machines to ltyour
pool namegt dialog opens
2 Highlight the desired virtual machine(s) and click Select Click OK
44 Step 4 Publish an ApplicationDesktop
1 Return to PowerTerm WebConnect Admin Tool to publish DeskView pools
2 Determine whether to publish a full desktop or a seamless application running
from a virtual desktop
For a full desktop
Select Action | New | Remote Windows Desktop
For a seamless application
Select Action | New | Windows Application
PowerTerm WebConnect 21 Getting Started Guide
3 Select Virtual Desktop in the first step of the wizard and click Next
4 Follow the wizardrsquos instructions until you reach the Virtual Desktops step
5 Select a pool that you previously created and that you would like this connection to choose virtual machines from Click Next
6 Continue and complete the reminder of the wizardrsquos steps
Once the resource is published users who have been assigned access will be able to use it
immediately
PowerTerm WebConnect 22 Getting Started Guide
5 Download and Run PowerTerm WebConnect Clients
PowerTerm WebConnect clients are automatically downloaded and installed onto the client
devices For detailed information and samples please refer to the PowerTerm WebConnect
Sample URLs page To see this page navigate your browser to
httpltweb_servergtWebConnect5xClientURLshtml
PowerTerm WebConnect 23 Getting Started Guide
6 PowerTerm WebConnect Client for Lotus Expeditor
61 Installation Package
PowerTerm WebConnect client for Lotus Expeditor is provided to IBM in an Update Site
package This is a ZIP archive containing the Update Site with the Eclipse feature and plug-
in that comprises the PowerTerm WebConnect client
Extract the ZIP file keeping the foldersrsquo structure intact
NOTE In Winzip verify that the ldquoUse folder namesrdquo option is set to TRUE
Package structure
Update Site
- plugins
- PowerTermWebConnectClient_560365jar
- features
- comericomWebConnect_560365jar
- sitexml
config
- webconnectxml
Definitions
bull webconnectxml PowerTerm WebConnect client configuration file
bull comericomWebConnect_560365jar PowerTerm WebConnect client feature file
bull PowerTermWebConnectClient_560365jar PowerTerm WebConnect client plugin file
62 Pre-installation steps
PowerTerm WebConnect client for Lotus Expeditor does not run independently but in
conjunction with PowerTerm WebConnect Server You can either install it and define your
users groups and applications or use Ericom Softwarersquos Demo PowerTerm WebConnect
Server
bull If you decide to install PowerTerm WebConnect Server you will need the full
installation ie the PowerTerm WebConnect Server and the Web components If you
do not have the installation CD you can download and install a trial version from
wwwericomcom
PowerTerm WebConnect 24 Getting Started Guide
bull If you decide to use Ericom Softwarersquos Demo PowerTerm WebConnect Server then
skip to the chapter Installing PowerTerm WebConnect Client on Lotus Expeditor
63 Install PowerTerm WebConnect Portlet on IBM Workplace server (for Windows OS)
Step 1 Install PowerTerm WebConnect Server
If PowerTerm WebConnect Server and IBM Workplace Server are on separate machines
bull Configure PowerTerm WebConnect Server
Launch PowerTerm WebConnect Administration Tool
Open Files | Configuration | Main
In the [Portal] section edit
Machines=localhostltIBM sever machinegt
bull Configure PowerTerm WebConnect Web components
Copy the ldquowebrdquo folder from the PowerTerm WebConnect server installation to the
IBM Workplace server machine
Create an Alias or a Virtual directory to it named WebConnect on the Web
server providing access to it for the users This is in order to enable the users to
download the necessary files to run their applications
Step 2 Enable JSR portlets
1 On IBM Workplace Server go to ltPortalServergtsharedappconfigservicesConfigServiceproperties
2 Edit portalenablejsr168=true
3 Save and close the file
Step 3 Enable SSO
1 On IBM Workplace Server go to ltPortalServergtsharedappconfigservicesLoaderServiceproperties
2 Edit commandpath=comericomportalcommandscomibmwpsenginecommands
3 Save and close the file
Step 4 Copy Files
The following files need to be copied from WebConnect ServerAddOnsIBM
WorkplacePortlet folder to IBM Workplace Server
File name to copy Destination folder
OpenSSLdll ltAppServergtjavajrebin
IbmPortaldll ltAppServergtjavajrebin
IbmPortalini ltAppServergtjavajrebin
PowerTerm WebConnect 25 Getting Started Guide
WebConnectPortaljar ltAppServergtlib
EricomLoginjar ltPortalServergtsharedapp
Step 5 Portlet Configuration
1 On IBM Workplace Server go to ltAppServergtjavajrebinIbmPortalini
2 You can modify the following parameters in the [Server=WebConnect] section webserverport=ltIBM web server portgt
Specifies the Web server port for accessing the PowerTerm WebConnect clients folder
Default 80 Address
Specifies the address of the PowerTerm WebConnect Server machine for Portlet to
connect to when PowerTerm WebConnect Server is located on a different machine
than the IBM Workplace Server CustomAddress
Specifies the addresss of the PowerTerm WebConnect Server machine for Clients to connect to If CustomAddress is the same as Address then this may be omitted webserveraddr
Specifies the address of the Web Server machine when it is located on a different
machine than the IBM Workplace Server
3 Restart the IBM server ltPortalServergtrootscriptsstopWorkplaceServicesbat ltPortalServergtrootscriptsstartWorkplaceServicesbat
This procedure may take about 20 minutes
Step 6 Install the Portlet
1 In a Web browser open the URL httpltIBM Workplace
Servergt9081lwpmyworkplace to open the IBM Workplace Portal
2 Login as administrator
3 Go to Administration | Portlets | Install
4 Browse to the PowerTerm WebConnectwar file located on PowerTerm WebConnect
Server and click Next
5 Click Install
Step 7 Create an Application page
1 Login to the Workplace
2 Go to Portal User Interface | Manage Pages
3 Search for My Work
4 Click the My Work link and select New Page
5 Name the page PowerTerm WebConnect and click OK
6 Click OK again You will see the created page on the list
7 Click the pencil icon on the new page and select the 1 square layout
PowerTerm WebConnect 26 Getting Started Guide
8 Click Add Portlet and search for PowerTerm WebConnect
9 Select it and click OK
10 Click Done
11 Click My work at the top of the page PowerTerm WebConnect is displayed on the list
Step 8 Run the Portlet
1 Restart IBM Workplace Server
2 Open IBM Workplace Portal in a browser httpltportal servergtlwpmyworkplace
3 Login to IBM Workplace Server
4 Click My work PowerTerm WebConnect portlet is displayed
5 Launch it The Userrsquos applications as defined on PowerTerm WebConnect Server
appear
6 Click an application to launch it
64 Install PowerTerm WebConnect Portlet on IBM Workplace server (for Linux OS)
Step 1 Enable JSR 168 portlets
1 Go to optIBMWorkplacePortalServersharedappconfigservicesConfigServiceproperties
2 Modify the portalenablejsr168 property to ldquotruerdquo
3 Restart the server cd optIBMWorkplacePortalServerrootscripts
Run stopWorkplaceServicessh
Run startWorkplaceServicessh
This procedure can take up to 20 minutes
4 Log on to the workplace server at httpltworkplace servergt9081lwpmyworkplace using
the administrators username and password
Step 2 Install the portlet
1 Restart IBM Workplace Server
2 In a Web browser open the URL httpltworkplace server IPgtlwpmyworkplace
3 Login to IBM Workplace Server as an administrator
4 Go to Administration | Portlets | Install
5 Browse to the PowerTerm WebConnectwar file located on PowerTerm WebConnect
Server and click Next
6 Click Install
PowerTerm WebConnect 27 Getting Started Guide
Step 3 Install the Application page
1 Login to the workplace as administrator
2 Go to Administration | Portal User Interface | Manage Pages
3 Search for My Work
4 Click the My Work link and select New Page
5 Name the page PowerTerm WebConnect and click OK
6 Click OK again You will see the created page on the list
7 Click the pencil icon and select the 1-square layout
8 Click Add Portlet and search for PowerTerm WebConnect
9 Select it and click OK
10 Click Done
11 Click My work on top and PowerTerm WebConnect is displayed on the left bar
Step 4 Run the portlet
1 Restart IBM Workplace Server
2 Open IBM Workplace Portal in a browser httpltportal servergtlwpmyworkplace
3 Login to IBM Workplace Server
4 Click My work PowerTerm WebConnect portlet is displayed
5 Launch it The Userrsquos applications as defined on PowerTerm WebConnect Server
appear
6 Click an application to launch it
65 Install PowerTerm WebConnect Portlet on IBM WebSphere 61 server (for Windows OS)
Step 1 Install PowerTerm WebConnect Server
You have to configure PowerTerm WebConnect Server if it and the IBM WebSphere Server
are on separate machines
1 Launch PowerTerm WebConnect Administration Tool
2 Open Files | Configuration | Main
3 In the [Portal] section edit Machines=localhostltIBM sever machinegt
Step 2 Copy Files
The following files need to be copied from WebConnect ServerAddOnsIBM
WebSpherePortlet folder to IBM WebSphere Server
PowerTerm WebConnect 28 Getting Started Guide
File name to copy Destination folder
OpenSSLdll ltAppServergtjavajrebin
IbmPortaldll ltAppServergtjavajrebin
IbmPortalini ltAppServergtjavajrebin
WebConnectPortaljar ltAppServergtlib
Step 3 Portlet Configuration
1 On IBM Workplace Server go to ltAppServergtjavajrebinIbmPortalini
2 You can modify the following parameters in the [Server=WebConnect] section webserverport=ltIBM web server portgt
Specifies the Web server port for accessing the PowerTerm WebConnect clients folder
Default 80 Address
Specifies the address of the PowerTerm WebConnect Server machine for Portlet to
connect to when PowerTerm WebConnect Server is located on a different machine
than the IBM Workplace Server CustomAddress
Specifies the addresss of the PowerTerm WebConnect Server machine for Clients to connect to If CustomAddress is the same as Address then this may be omitted webserveraddr
Specifies the address of the Web Server machine when it is located on a different
machine than the IBM Workplace Server
3 Restart the IBM server ltAppServergtProfilesAppServer01binstopServerbat ltAppServergtProfilesAppServer01binstartServerbat
This procedure may take about 20 minutes
Step 4 Install the Portlet and create an Application page
1 In a Web browser open the URL httpltIBM WebSphere Servergt9060ibmconsole
to open the IBM WebSphere Portal
2 Login and go to Applications | Install New Application
3 Browse to the PowerTerm WebConnectwar file located on PowerTerm WebConnect
Server
4 Enter Context root and click Next The Select installation options dialog appears
5 Optional change options to your preference or keep the default
6 Click Next
7 Select Ericom in the Module column click Apply and then Next
8 Click Finish and then Save
9 Select Applications | Enterprise Applications
10 Select PowerTerm WebConnectwar checkbox and click Start
PowerTerm WebConnect 29 Getting Started Guide
11 Enter in the Web browser the URL httpltIBM WebSphere
Servergt9080ltContext rootgtEricom portlet The Login dialog appears
12 Login and you will see PowerTerm WebConnect displayed on the list
Step 5 Run the Portlet
1 Restart IBM WebSphere Server
2 Open IBM WebSphere Portal in a browser httpltportal servergt9080ltContext
rootgtEricom portlet
3 Login to IBM WebSphere Server
4 Launch it The Userrsquos applications as defined on PowerTerm WebConnect Server
appear
5 Click an application to launch it
66 PowerTerm WebConnect Server Configuration
bull To enable the Lotus Expeditor to run the PowerTerm WebConnect client the
System Administrator must provide the users with accounts on PowerTerm
WebConnect Server (see the PowerTerm WebConnect Administratorrsquos Manual for
instructions on how to create users groups and connections on the PowerTerm
WebConnect Server)
bull To enable PowerTerm WebConnectrsquos Single Sign-On feature the System
Administrator must create a PowerTerm WebConnect user with the same
username and password as used for the Lotus Expeditor For a managed Lotus
Expeditor the credentials used are the username and password sent to the
managing server For an unmanaged Lotus Expeditor the operation system
username and the Lotus Expeditor password are used as credentials
NOTE If a password is not defined then the Single Sign-On will fail and the user will be
prompted with a login dialog
67 PowerTerm WebConnect Client Configuration
The PowerTerm WebConnect client is configured in webconnectxml located in the config
folder webconnectxml parameters are
url The PowerTerm WebConnect Agent url
server The PowerTerm WebConnect Server address
sso The Single Sign-On feature
dst The local destination for downloading PowerTerm WebConnect
components
PowerTerm WebConnect 30 Getting Started Guide
url
PowerTerm WebConnect components are installed on a Web server Their default url is
Windows Agent
httpltWebServer IPgtWebConnectwindowsptagentcab
Linux Agent
httpltWebServer IPgtWebConnectlinuxix86qterm-wczip
The url parameter must include the first part of the url (which is identical for both Windows
and Linux agents)
The PowerTerm WebConnect client will automatically append the appropriate suffix in
order to create a full accurate url
Example
ltitem key=rdquourlrdquo value=httpadminserverWebConnectgt
server
The computer name or IP address of the PowerTerm WebConnect Server machine
The PowerTerm WebConnect client will log in to this PowerTerm WebConnect Server
display the applications defined on it and run them according to this serverrsquos configuration
Format ltserver IPgt[ltportgt]
where default port is 4000 (can be edited)
Example
ltitem key=rdquoserverrdquo value=rdquoadmin24000rdquogt
sso
Determines whether Single Sign-on will be used to log in to PowerTerm WebConnect
Server Values
bull True (default) the client should automatically log in to the PowerTerm WebConnect
Server using the same credentials as the ones used to log in to the Lotus Expeditor
client
The System Administrator must verify that these credentials can log in to the
PowerTerm WebConnect Server
bull False the user will be prompted with a login dialog or will log in automatically using
previously saved credentials
Example
ltitem key=rdquossordquo value=rdquotruerdquogt
Autologin mode
PowerTerm WebConnect 31 Getting Started Guide
If sso is set to True the user is not prompted for credentials and the login process to
PowerTerm WebConnect Server is done automatically sending the credentials used for the
Lotus Expeditor unless the Lotus Expeditor does not have a password defined (In the
Lotus Expeditor preferences page | Password| Prompt me for a password at start up checkbox)
However if Single Sign-on is not used there are several options regarding Autologin that
can be defined in the PowerTerm WebConnect Preferences page Options
bull Yes
bull No
bull Interactive
bull First time interactive (default) ndash Simplifies the login process to PowerTerm
WebConnect Server In this mode the first time the user logs in to PowerTerm
WebConnect Server he will be prompted for his credentials with the Login dialog
These credentials will be stored in the machine and from then on the login process to
PowerTerm WebConnect Server will be done automatically
1 Open File | Preferences from the Lotus Expeditor and select PowerTerm WebConnect
2 In the Autologin to WebConnect Server section select First Interactive and click OK
3 Start PowerTerm WebConnect Client for Lotus Expeditor If credentials were entered
at least once then the next time the client will connect to PowerTerm WebConnect
Server without prompting for the user name and password
The Administrator must configure the Agent to do nothing when it exits for the
feature to work this way See PowerTerm WebConnect Administratorrsquos Manual for more information about defining Autologin
bull Allow multiple selection ndash Defines whether the user can launch more than one
application at a time (by using the ltCtrlgt or ltShiftgt button while selecting applications)
dst
Defines the path to download PowerTerm WebConnect components on the client machine
The dst parameter can contain macros which are translated by the PowerTerm WebConnect
Client for Lotus Expeditor during runtime The macros should be placed between percent
symbols () for example WebServer
When such a value is defined the PowerTerm WebConnect Client for Lotus Expeditor
substitutes the entire expression for the macrorsquos value
The PowerTerm WebConnect Client for Lotus Expeditor does not support the use
of environment variables as macros
Macros are not case sensitive
Macros supported by PowerTerm WebConnect Client for Lotus Expeditor
Macro name Description
WebServer The name of the Web server
It is obtained from the PowerTerm WebConnect Agent url
PowerTerm WebConnect 32 Getting Started Guide
parameter
Name The name of the clientrsquos CAB or ZIP file eg ldquoptagentrdquo
Display The clientrsquos display name from the version file
Version The clientrsquos version value It is obtained from the version
file
Root The default root location
Windows ldquoCrdquo
LinuxUnix an empty string
OSDir Windows Windowsrsquo installation directory for example
ldquoCWindowsrdquo
Linux an empty string
OSDrive Windows Windowsrsquo installation drive for example ldquoCrdquo
Linux an empty string
HomePath Windows The HOMEPATH environment variable
Linux The HOME environment variable
Home The Ericom folder in the userrsquos home directory
Windows CDocuments and SettingsltusergtApplication
DataEricom
Linux ltusergtEricom
In addition to the predefined macros listed above the PowerTerm WebConnect client
supports the usage of Java System Properties
Java System Properties available for users on Windows XP SP2
Java System Property Name Value Example
javaversion 150
javavendorurl httpwwwibmcom
javahome CIBMcommonpluginscomibmpvcwctruntim
esj2sewin32x86_150SR2-
20060511rcpeclipsepluginscomibmrcpj2sew
in32x86_150SR2-20060511jre
javavmspecificationversion 10
javavmversion 23
javavmvendor IBM Corporation
javavmname IBM J9 VM
PowerTerm WebConnect 33 Getting Started Guide
javaiotmpdir CDOCUME~1dianaLOCALS~1Temp
javacompiler j9jit23
javaextdirs CIBMcommonpluginscomibmpvcwctruntim
esj2sewin32x86_150SR2-
20060511rcpeclipsepluginscomibmrcpj2sew
in32x86_150SR2-20060511jrelibext
osname Windows XP
osarch x86
osversion 51 build 2600 Service Pack 2
pathseparator
username Jone
userhome CDocuments and SettingsJone
userdir CIBMRSA
usertimezone GMT+0200
System properties available for users on Linux RedHat 9
Java System Property Name Value Example
javaversion 150
javavendorurl httpwwwibmcom
javahome usrjavajre150_07
javavmversion 150
javavmvendor IBM Corporation
javavmname IBM J9 VM
javaclasspath
javalibrarypath
javaiotmpdir tmp
javacompiler
javaextdirs
osname Linux
osarch i386
osversion 2420-8
pathseparator
PowerTerm WebConnect 34 Getting Started Guide
username root
userhome root
userdir root
System properties names are placed in the configuration file within percent symbols ()
(like macros)
671 Configure the PowerTerm WebConnect Client
1 Open the Config Folder and edit the webconnectxml file Example
ltxml version =rdquo10rdquo encoding=rdquoUTF-8rdquogt
ltsection name=rdquoparametersrdquogt
ltitem key=rdquourlrdquo value=httpadminserverWebConnect56gt
ltitem key=rdquoserverrdquo value=rdquoadmin24000rdquogt
ltitem key=rdquossordquo value=rdquotruerdquogt
ltitem key=rdquodestrdquo value=rdquoCProgram FilesEricomrdquogt
ltsectiongt
2 Save the customized webconnectxml to a Web server folder available to all users It is
recommended to use the same Web server as the PowerTerm WebConnect Agent
Example
ltWebConnect installation foldergtwebwebconnectxml
3 Test the accessibility to this file - Type the URL of webconnectxml in the browser
Example
httpltWebServer IPgtWebConnectwebconnectxml
The contents of the file should be displayed
672 Configure the Preferences File
1 Open the plugins folder and open the PowerTermWebConnectClient_560365jar file
You can use Winzip version 70 and up or in Windows XP ndash Create a new file type for the
jar extension click advanced and select compressed (zipped) folder in the drop down list
Now you can open the JAR files in the Windows Explorer
The default contents of the file
configURL=httpleericomcomWebConnectwebconnectxml
2 Specify the accurate URL of the webconnectxml file Example
httpltWebServer IPgtWebConnectwebconnectxml
3 Save the file and close it The WinZip will display the following dialog
ldquoFile preferencesini has been changed since it was extracted Update archive
with this filerdquo
PowerTerm WebConnect 35 Getting Started Guide
4 Click Yes and close the archive
If you are editing the file from within the explorer you will have to save the file elsewhere
and then drag it to the explorer window where the JAR file is open
68 Installing PowerTerm WebConnect Client on Lotus Expeditor
1 Start the Lotus Expeditor client
2 Select File | Application | Install
3 Select Search for new features to install and click Next
4 Select Add Folder Location and type or select the location of the update site folder from
the provided package Click OK
5 Select the location you have just created and click Finish
6 In the Select the feature to install tree select Powerterm WebConnectUpdate Site Click
Next
7 Select I accept the terms in the license agreements and click Next
8 Click Finish
9 When prompted restart the platform
69 Running PowerTerm WebConnect Client for Lotus Expeditor
1 Click Open The PowerTerm WebConnect option is displayed
2 Select PowerTerm WebConnect The application will automatically connect and start
downloading the components from PowerTerm WebConnect Server
IMPORTANT
If you did not install PowerTerm WebConnect Server and are instead connecting to Ericom
Softwarersquos Demo WebConnect Server then you need to open port 443 in the firewall
691 PowerTerm WebConnect Client Workflow
1 PowerTerm WebConnect client reads the URL of webconnectxml from the preferencesini
file and requests it
2 When the webconnectxml is successfully downloaded the application reads the
configuration connects to the specified Web server downloads the PowerTerm
WebConnect components and connects to the PowerTerm WebConnect Server
3 The user is requested to login to the PowerTerm WebConnect Server For testing you
can use the username Example and password example
This step will be skipped if Single Sign-on is set to ldquotruerdquo
PowerTerm WebConnect 36 Getting Started Guide
4 After logging in to PowerTerm WebConnect Server the userrsquos applications are displayed
as defined by the administrator
5 To run an application select the desired application from the list and click Launch or
double-click the application The application will be launched in a separate window
610 Troubleshooting
When you encounter a problem the first step is to open the log file This file is located on
the client machine in the Ericom folder
Windows
CDocuments and SettingsltusernamegtEricomleclientEricomPluginlog
Linux
ltuser-home-directorygtEricomleclientEricomPluginlog
Following is a guide for diagnosing and fixing the problems in cases of error messages and
additional information
Error
Message
Solution
Version File
reading error
1 Check the lsquourlrsquo parameter in the webconnectxml file on the Web
server The value should be
httpltWebServerIPgtWebConnect
2 Try to run the following URL on the browser
Windows
httpltWebServerIPgtWebConnectwindowsptagentvertxt
Linux
httpltWebServerIPgtWebConnectlinuxix86qterm-
wcvertxt
The file contents displayed in the browser window should be in
the following form
560-rel14546
PowerTerm WebConnect Application Zone
560 - Main Release
ltrootgtPowerTerm WebConnect 56ltWebServergt
If the version file contents are not as shown check
- Is the Web Server running
- Are PowerTerm WebConnect Web Components and version files
PowerTerm WebConnect 37 Getting Started Guide
in place
3 On the Web server check ltPowerTerm WebConnect
rootgtwebwindowsptagentvertxt If the contents ldquolook wrongrdquo or
not in the proper form reinstall the PowerTerm WebConnect Web
components
4 On the client machine open the aforementioned URL in the
browser The file content should appear in the browser If it does
not it could be that the Web server is down
Web Server is
shut down
The webconnectxml configuration file must be located on the Web
server The explicit URL to this file is defined in the preferencesini
file (see Configure the Preferences File)
The error message contains the IP address of the Web server
Verify that the Web server on this machine is running
Version file
does not exist
on ltURLgt
See Version File reading error
The
configuration
file is not
accessible or
has a wrong
format
The webconnectxml configuration file must be located on the Web
server and the explicit URL to the configuration must be defined in
the preferencesini file (see Configure the Preferences File)
Try to open the URL specified in the error message in the
browser If it does not open then it either does not exist or it has
a wrong format
Preferences
file does not
exist in the
application
bundle
The preferencesini file containing the URL to the configuration
file was removed from the update site folder
Uninstall the current PowerTerm WebConnect client from the
client machine Create a new customized package (see
PowerTerm WebConnect Client Configuration) and reinstall it
Configuration
file URL is not
defined in
preference
file
The URL to the configuration file does not appear in the
preferencesini file (see Configure the Preferences File)
Uninstall the current PowerTerm WebConnect client from the
client machine Create a new customized package (see
PowerTerm WebConnect Client Configuration) and reinstall it
No IP address
could be
found for the
host
The Web server URL specified in the preferencesini file (see
Configure the Preferences File) or in the webconnectxml file (see
Configure the PowerTerm WebConnect Client) is an unknown
host
If the mistake is in the preferencesini file uninstall the current
PowerTerm WebConnect client from the client machine Create a
new customized package (see PowerTerm WebConnect Client
Configuration) and reinstall it
PowerTerm WebConnect 38 Getting Started Guide
If the mistake is in the webconnectxml file correct the file reopen
the Lotus Expeditor client
Cannot write
to destination
The temporary file cannot be written to the defined destination
Check the write permissions
Copied
configuration
file has wrong
format
The webconnectxml file as received from the specified URL has a
wrong format Correct the file and try again
PowerTerm
WebConnect
Agent URL is
malformed
The PowerTerm WebConnect Agent URL specified in the
webconnectxml file (see Configure the PowerTerm WebConnect
Client) does not have a proper HTTP format Correct the file and
try again
PowerTerm
WebConnect
Agent URL is
not defined
The PowerTerm WebConnect Agent URL parameter is not specified
in the webconnectxml file (see Configure the PowerTerm
WebConnect Client)
Correct the file and try again
The specified
destination
folder name
is wrong
The destination folder name contains illegal characters
ltgt|
Check the dst parameter in the webconnectxml file Correct the
file and try again
You do not
have
permissions
to write to
ltpathgt
The PowerTerm WebConnect Agent cannot be written to the
destination as defined Check the write permissions
The default destination defined in the version file should not to
be changed
A customized destination for PowerTerm WebConnect Agent
downloading can be defined in the webconnectxml file (See
Configure the PowerTerm WebConnect Client)
Check the destination value correct and try again
PowerTerm WebConnect 39 Getting Started Guide
About Ericom
Ericomreg Software is a leading provider of Application Access and Virtualization Solutions
Since 1993 Ericom has been helping users access enterprise mission-critical applications
running on a broad range of Microsoftreg Windowsreg Terminal Servers virtual Desktops
Blade PCs legacy hosts and other systems Ericom provides concrete business value by
helping organizations realize the benefits of their IT investments With offices in the United
States United Kingdom EMEA India and China Ericom also has an extensive network of
distributors and partners throughout North America Europe Asia and the Far East Our
expanding customer base is more than 30 thousand strong with over 7 million
installations
For more information on our products and services contact us at the location nearest to you
And visit our web site httpwwwericomcom
North America Western Europe International
Ericom Software Inc Ericom Software (UK) Ltd Ericom Software Ltd
231 Herbert Avenue Bldg 4 11a Victoria Square 8 Hamarpeh Street
Closter NJ 07624 USA Droitwich Worcestershire Har Hotzvim Technology Park
Tel +1 (201) 767 2210 WR9 8DE United Kingdom Jerusalem 91450 Israel
Fax +1 (201) 767 2205 Tel +44 (0) 845 644 3597 Tel +972 (2) 591 1700
Toll-free 1 (888) 769 7876 Fax +44 (0) 845 644 3598 Fax +972 (2) 571 4737
Email infoericomcom Email infoericomcouk Email infoericomcom
PowerTerm WebConnect 14 Getting Started Guide
31 Publishing Applications and Documents
In order to enable access to applications and documents on Windows Terminal Servers
publish these applications and documents from the Administration Tool When publishing
applications and content you can specify which servers will be used in a Terminal Server
cluster and which users and groups will have access to these services Once you have
published such applications and documents the RemoteView client can be used to access
them
If you need to provide access to multiple applications on a Terminal Server use the Multiple Application Publishing wizard to significantly reduce the time and
effort required to publish these applications
To publish multiple Windows applications
1 Click Publish Multiple Applications in the Welcome screen The Choose Terminal Server
for Browsing dialog appears
2 Provide the address of the Terminal Server which will be used for browsing and click OK The Application Publisher Step 1 dialog appears This dialog lists all the
applications available in the specified serverrsquos Start menu
3 Select those applications found in the Programs folder of the designated server that you want to publish and click Next The Application Publisher Step 2 dialog appears
4 Determine the destination of your publishing and click Next The Application Publisher
Step 3 dialog appears
5 Determine the Color Quality of your published application
6 Determine the start mode in which you want to run the published application - normal maximized or minimized - and click Next The Application Publisher Step 4
dialog appears
7 Choose the connection speed that matches your infrastructure The connection speed
setting determines the value of three visual effects settings You can also override
these settings specifically
8 Determine whether you prefer the window to display their content while being
dragged or just the outline By default the same setting is used as the client desktop
9 Click Next The Application Publisher Step 5 dialog appears
10 Specify where sounds are to be played ndash locally or remotely
11 Determine which local devices the remote session will have access to (local drivers printer etc) and click Next The Application Publisher Step 6 dialog appears
12 If you have the PowerTerm Load Balancer installed Use all Servers (default) allows the application to run on any Terminal Server in the
cluster This setting is appropriate when the application is installed on all the Terminal
Servers Alternatively you select specific Terminal Servers on which to run this
application
If you have not installed the PowerTerm Load Balancer you will need to explicitly
specify the address of the Terminal Server on which the application will be run
PowerTerm WebConnect 15 Getting Started Guide
13 Click Next The Application Publisher Step 7 dialog appears
14 Select the users groups or OUs to which you wish to publish the applications and click Next The Application Publisher Step 8 dialog appears By default applications will
be published to everybody
15 Click Advanced Settings to modify settings such as the login credentials to the
Terminal Servers By default PowerTerm WebConnect credentials will be passed
through to the Terminal Server
16 Click Finish The published applications appears in the Connection List
Right-click and select Properties or double click on the published application in the
Connections list to view and modify any of the settings which you previously
defined
To publish a remote Desktop
1 Select Action | New | Remote Desktop The Application Publisher Step 1 dialog appears
2 Type the Display Name which will be the name presented to the end-users and click
Next The Application Publisher Step 2 dialog appears
3 Specify where icons for the published desktop will be displayed to the end-user in Publish to
4 Click Choose Icon to replace the desktoprsquos default icon Select the desired icon from
the list that appears
5 Click Next The Application Publisher Step 3 dialog appears
6 Determine Screen Size and the Color Quality of the published desktop
7 If desirable select Show Connection Bar in Full Screen Mode
8 Click Next The Application Publisher Step 4 dialog appears
9 Choose the connection speed that matches your infrastructure The connection speed
setting determines the value of three visual effects settings You can also override
these settings specifically
10 Click Next The Application Publisher Step 5 dialog appears
11 Specify where sounds are to be played ndash locally or remotely Where to Apply Window
Key Combinations and which local devices you want to automatically connect to when
logged on to the remote computer
12 Click Next The Application Publisher Step 6 dialog appears
13 Specify the Server Address and Port Number of the Terminal Server that weill provide
the desktop and click Next The Application Publisher Step 7 dialog appears
14 Select the users groups or OUs to which you wish to publish the desktop and click Next The Application Publisher Step 8 dialog appears
Select the Server group to allow all users to access the published application
15 Click Advanced Settings to modify settings such as the login credentials to the
Terminal Servers By default PowerTerm WebConnect credentials will be used
PowerTerm WebConnect 16 Getting Started Guide
16 Click Finish The published application appears in the Connection List
Right-click Properties or double click on the published application in the
Connections list to modify any of the settings which you previously defined
32 Create Terminal Emulation Connections
To provide access to legacy host systems you will need to create Terminal Emulation
connections For each such connection you can specify the host address emulation type
login script and more Once you have created these connections users will be able to
launch them using HostView (Windows or Linux) WebView or the Java client as
appropriate
1 Click Create a Host Connection in the Welcome screen The Add Connection dialog
appears
2 Enter a Name for the new connection
3 Specify an Owner for the new connection The possibilities are
[None] the connection will not be allowed to run by anyone and it will not be
displayed in any Connection list Server the connection will be accessible for all users of this PowerTerm
WebConnect server A specific group the connection will be accessible for all users of the specified
group A specific user the connection will be accessible for a specified user only
4 Leave category Terminal Emulation selected
5 Select Terminal Type Terminal Model and Communication Type as needed
6 Specify the Host Name or IP address of your host
7 Specify other parameters as needed
8 Select the Security Type as needed if your host supports SSL or SSH and specify
the appropriate details in the Details dialog
9 Use the Settings Key Mapping and Power Pad options to further customize the
connection
10 Click OK and the connection is created
33 Test Connections
It is recommended to test published applications or host connections before they are made
available to end-users
To test a connection
bull Right-click the target connection from the Connection section of the main screen and
select Test
Alternatively
PowerTerm WebConnect 17 Getting Started Guide
1 Select Tools | Run ltdesired clientgt The Login to WebConnect dialog appears
2 Enter the User Name and Password for the individual who owns the connection that
you want to test and click Login The desired PowerTerm WebConnect client is started
and the Connect dialog appears
3 Select the desired connection and click Connect The test is executed
34 Launch the Application Zone or the Application Portal
Users can access the published applications from the Application Zone application launcher
or from the Application Portal web interface
To use the Application Zone go to Start menuProgramsEricom SoftwarePowerTerm
WebConnect 5x and select Client URLs Alternatively type the following URL into your Web
browserrsquos address bar httpltserver addressgtWebConnect5xClientURLshtml In the
page that opens click on the Run button next to the Application Zone to launch it
To use the Application Portal go to Start menuProgramsEricom SoftwarePowerTerm
WebConnect 5x and select it Alternatively type the following URL into the Web browserrsquos
address bar httpltserver addressgtWebConenct5xportalwindowsindexasp
35 Monitor a Users Sessions
From the Administration Tool you can monitor the users sessions and may intervene if
necessary This intervention may result in your input appearing on the users screen The
user receives a notification when an administrator begins and ends monitoring the session
1 Select View | Client Sessions or click to see all the active client sessions
2 Select the desired active session and right-click Attach The Password Verify dialog
appears
3 Enter your password and click OK Some notification dialogs appears and the selected
PowerTerm WebConnect session is viewed
36 View Intruders
bull The Intruders window shows suspected attempts at breaching security After several
suspected intrusion attempts users are blocked temporarily
bull In addition to showing suspected intrusion attempts the Intruders window allows
you to remove restrictions on users
bull Select View | All Intruders or click
PowerTerm WebConnect 18 Getting Started Guide
4 Accessing Virtual Desktops and Blade PCs with PowerTerm WebConnect
This chapter provides instructions on configuring PowerTerm WebConnect for Virtual
Desktop Infrastructure (VDI)
41 Step 1 Launch DeskView Administration Tool
Verify that PowerTerm WebConnect is installed on your server and launch PowerTerm
WebConnect Admin Tool
bull Select Tools | Open VDI Manager The PowerTerm WebConnect DeskView Administration
Tool opens
The first time you launch the DeskView Administration Tool you will be prompted to install
the tool
PowerTerm WebConnect 19 Getting Started Guide
Microsoft Management Console 30 is required for PowerTerm WebConnect DeskView
Administration Tool If you do not have this installed you will also automatically be
prompted to install this update
Follow the installation processes when you are prompted for either install PowerTerm
WebConnect DeskView Administration Tool will automatically launch when these
installations are completed
42 Step 2 Add a Host
1 Right-click Virtualization Hosts and select Add Host The Add a New Host wizard
opens Click Next
2 Enter a Host Name as you would like it to appear in PowerTerm WebConnect
DeskView Administration Tool and a description (optional) Click Next
3 Specify the Virtualization Server type and click Next
4 Specify the connection information and click Next
VMWare Virtual Center v1x and 2x
Specify the HTTPS Web Service address and a UsernamePassword that can access
the host
VMWare Virtual Server 2005
Click Start and then Run
Type ldquoservicesmscrdquo and click OK
Scroll down to PowerTerm WebConnect DeskView Server service and open
Properties
Change the Login Account for the service to match the Domain Administrator
account and password used when setting up Microsoft Virtual Server 2005 and
restart the service Enter the IP or NETBIOS name of the Microsoft Virtual Server 2005 server as the
Server Address in the Connection Broker Wizard
Xen Server
Specify the hypervisor IP address or NETBIOS name the Root UsernamePassword
to the hypervisor and the Service port (default 80)
Oracle VM
Specify the Serverrsquos agent URL and Port (default 8899) for example
httpsltservernamegt8899
Specify the Oracle VM hypervisorrsquos Oracle Agent UsernamePassword (default
username oracle)
5 Click Finish to add the new Host
To configure Virtual Machines for use install the Ericom Tools (vmagentmsi) on each of the
virtual machines on the new host for PowerTerm WebConnect DeskView to recognize them
The vmagentmsi installer is located on the PowerTerm WebConnect server in ltPowerTerm
WebConnect installation foldergtAddOnsDeskView VDI folder (default installation
PowerTerm WebConnect 20 Getting Started Guide
folder is xProgram FilesEricom SoftwareWebConnect 56) During installation you
will need to enter the DeskView IP address or NETBIOS name
If you are using Microsoft Virtual Server 2005 as your Virtualization Host use the
IP address of the DeskView server only when installing the Ericom Tool package
43 Step 3 Create a Pool
Pools are used to organize Virtual Machines (VM) into logical groups This enables
organizations to combine and order resources from multiple systems into one entity To
access available resources end-users simply connect to PowerTerm WebConnect to access
any configured resource
1 Right-click Pools and select Create Pool The Create a Pool wizard opens Click
Next
2 Enter a Pool name as you wish it to appear and a description (optional) and click
Next
3 Specify the Pool type and click Next
4 Specify the Assignment type and click Next
Permanently will cause a virtual machine to affix to the user who has launched
that virtual machine For the duration of the session will cause any virtual machine that is not in use to
be returned to the pool for any user to launch
5 Specify the LogoffDisconnect event and click Next
Select what you would like to happen after a user logs off from a virtual machine
in this pool
Select what you would like to happen when a user is disconnected from a virtual
machine in this pool
6 Click Finish to add the new Pool
You will need to assign virtual machines from your virtualization hosts to your created pool
1 Right-click the pool and select Assign Machines The Assign Machines to ltyour
pool namegt dialog opens
2 Highlight the desired virtual machine(s) and click Select Click OK
44 Step 4 Publish an ApplicationDesktop
1 Return to PowerTerm WebConnect Admin Tool to publish DeskView pools
2 Determine whether to publish a full desktop or a seamless application running
from a virtual desktop
For a full desktop
Select Action | New | Remote Windows Desktop
For a seamless application
Select Action | New | Windows Application
PowerTerm WebConnect 21 Getting Started Guide
3 Select Virtual Desktop in the first step of the wizard and click Next
4 Follow the wizardrsquos instructions until you reach the Virtual Desktops step
5 Select a pool that you previously created and that you would like this connection to choose virtual machines from Click Next
6 Continue and complete the reminder of the wizardrsquos steps
Once the resource is published users who have been assigned access will be able to use it
immediately
PowerTerm WebConnect 22 Getting Started Guide
5 Download and Run PowerTerm WebConnect Clients
PowerTerm WebConnect clients are automatically downloaded and installed onto the client
devices For detailed information and samples please refer to the PowerTerm WebConnect
Sample URLs page To see this page navigate your browser to
httpltweb_servergtWebConnect5xClientURLshtml
PowerTerm WebConnect 23 Getting Started Guide
6 PowerTerm WebConnect Client for Lotus Expeditor
61 Installation Package
PowerTerm WebConnect client for Lotus Expeditor is provided to IBM in an Update Site
package This is a ZIP archive containing the Update Site with the Eclipse feature and plug-
in that comprises the PowerTerm WebConnect client
Extract the ZIP file keeping the foldersrsquo structure intact
NOTE In Winzip verify that the ldquoUse folder namesrdquo option is set to TRUE
Package structure
Update Site
- plugins
- PowerTermWebConnectClient_560365jar
- features
- comericomWebConnect_560365jar
- sitexml
config
- webconnectxml
Definitions
bull webconnectxml PowerTerm WebConnect client configuration file
bull comericomWebConnect_560365jar PowerTerm WebConnect client feature file
bull PowerTermWebConnectClient_560365jar PowerTerm WebConnect client plugin file
62 Pre-installation steps
PowerTerm WebConnect client for Lotus Expeditor does not run independently but in
conjunction with PowerTerm WebConnect Server You can either install it and define your
users groups and applications or use Ericom Softwarersquos Demo PowerTerm WebConnect
Server
bull If you decide to install PowerTerm WebConnect Server you will need the full
installation ie the PowerTerm WebConnect Server and the Web components If you
do not have the installation CD you can download and install a trial version from
wwwericomcom
PowerTerm WebConnect 24 Getting Started Guide
bull If you decide to use Ericom Softwarersquos Demo PowerTerm WebConnect Server then
skip to the chapter Installing PowerTerm WebConnect Client on Lotus Expeditor
63 Install PowerTerm WebConnect Portlet on IBM Workplace server (for Windows OS)
Step 1 Install PowerTerm WebConnect Server
If PowerTerm WebConnect Server and IBM Workplace Server are on separate machines
bull Configure PowerTerm WebConnect Server
Launch PowerTerm WebConnect Administration Tool
Open Files | Configuration | Main
In the [Portal] section edit
Machines=localhostltIBM sever machinegt
bull Configure PowerTerm WebConnect Web components
Copy the ldquowebrdquo folder from the PowerTerm WebConnect server installation to the
IBM Workplace server machine
Create an Alias or a Virtual directory to it named WebConnect on the Web
server providing access to it for the users This is in order to enable the users to
download the necessary files to run their applications
Step 2 Enable JSR portlets
1 On IBM Workplace Server go to ltPortalServergtsharedappconfigservicesConfigServiceproperties
2 Edit portalenablejsr168=true
3 Save and close the file
Step 3 Enable SSO
1 On IBM Workplace Server go to ltPortalServergtsharedappconfigservicesLoaderServiceproperties
2 Edit commandpath=comericomportalcommandscomibmwpsenginecommands
3 Save and close the file
Step 4 Copy Files
The following files need to be copied from WebConnect ServerAddOnsIBM
WorkplacePortlet folder to IBM Workplace Server
File name to copy Destination folder
OpenSSLdll ltAppServergtjavajrebin
IbmPortaldll ltAppServergtjavajrebin
IbmPortalini ltAppServergtjavajrebin
PowerTerm WebConnect 25 Getting Started Guide
WebConnectPortaljar ltAppServergtlib
EricomLoginjar ltPortalServergtsharedapp
Step 5 Portlet Configuration
1 On IBM Workplace Server go to ltAppServergtjavajrebinIbmPortalini
2 You can modify the following parameters in the [Server=WebConnect] section webserverport=ltIBM web server portgt
Specifies the Web server port for accessing the PowerTerm WebConnect clients folder
Default 80 Address
Specifies the address of the PowerTerm WebConnect Server machine for Portlet to
connect to when PowerTerm WebConnect Server is located on a different machine
than the IBM Workplace Server CustomAddress
Specifies the addresss of the PowerTerm WebConnect Server machine for Clients to connect to If CustomAddress is the same as Address then this may be omitted webserveraddr
Specifies the address of the Web Server machine when it is located on a different
machine than the IBM Workplace Server
3 Restart the IBM server ltPortalServergtrootscriptsstopWorkplaceServicesbat ltPortalServergtrootscriptsstartWorkplaceServicesbat
This procedure may take about 20 minutes
Step 6 Install the Portlet
1 In a Web browser open the URL httpltIBM Workplace
Servergt9081lwpmyworkplace to open the IBM Workplace Portal
2 Login as administrator
3 Go to Administration | Portlets | Install
4 Browse to the PowerTerm WebConnectwar file located on PowerTerm WebConnect
Server and click Next
5 Click Install
Step 7 Create an Application page
1 Login to the Workplace
2 Go to Portal User Interface | Manage Pages
3 Search for My Work
4 Click the My Work link and select New Page
5 Name the page PowerTerm WebConnect and click OK
6 Click OK again You will see the created page on the list
7 Click the pencil icon on the new page and select the 1 square layout
PowerTerm WebConnect 26 Getting Started Guide
8 Click Add Portlet and search for PowerTerm WebConnect
9 Select it and click OK
10 Click Done
11 Click My work at the top of the page PowerTerm WebConnect is displayed on the list
Step 8 Run the Portlet
1 Restart IBM Workplace Server
2 Open IBM Workplace Portal in a browser httpltportal servergtlwpmyworkplace
3 Login to IBM Workplace Server
4 Click My work PowerTerm WebConnect portlet is displayed
5 Launch it The Userrsquos applications as defined on PowerTerm WebConnect Server
appear
6 Click an application to launch it
64 Install PowerTerm WebConnect Portlet on IBM Workplace server (for Linux OS)
Step 1 Enable JSR 168 portlets
1 Go to optIBMWorkplacePortalServersharedappconfigservicesConfigServiceproperties
2 Modify the portalenablejsr168 property to ldquotruerdquo
3 Restart the server cd optIBMWorkplacePortalServerrootscripts
Run stopWorkplaceServicessh
Run startWorkplaceServicessh
This procedure can take up to 20 minutes
4 Log on to the workplace server at httpltworkplace servergt9081lwpmyworkplace using
the administrators username and password
Step 2 Install the portlet
1 Restart IBM Workplace Server
2 In a Web browser open the URL httpltworkplace server IPgtlwpmyworkplace
3 Login to IBM Workplace Server as an administrator
4 Go to Administration | Portlets | Install
5 Browse to the PowerTerm WebConnectwar file located on PowerTerm WebConnect
Server and click Next
6 Click Install
PowerTerm WebConnect 27 Getting Started Guide
Step 3 Install the Application page
1 Login to the workplace as administrator
2 Go to Administration | Portal User Interface | Manage Pages
3 Search for My Work
4 Click the My Work link and select New Page
5 Name the page PowerTerm WebConnect and click OK
6 Click OK again You will see the created page on the list
7 Click the pencil icon and select the 1-square layout
8 Click Add Portlet and search for PowerTerm WebConnect
9 Select it and click OK
10 Click Done
11 Click My work on top and PowerTerm WebConnect is displayed on the left bar
Step 4 Run the portlet
1 Restart IBM Workplace Server
2 Open IBM Workplace Portal in a browser httpltportal servergtlwpmyworkplace
3 Login to IBM Workplace Server
4 Click My work PowerTerm WebConnect portlet is displayed
5 Launch it The Userrsquos applications as defined on PowerTerm WebConnect Server
appear
6 Click an application to launch it
65 Install PowerTerm WebConnect Portlet on IBM WebSphere 61 server (for Windows OS)
Step 1 Install PowerTerm WebConnect Server
You have to configure PowerTerm WebConnect Server if it and the IBM WebSphere Server
are on separate machines
1 Launch PowerTerm WebConnect Administration Tool
2 Open Files | Configuration | Main
3 In the [Portal] section edit Machines=localhostltIBM sever machinegt
Step 2 Copy Files
The following files need to be copied from WebConnect ServerAddOnsIBM
WebSpherePortlet folder to IBM WebSphere Server
PowerTerm WebConnect 28 Getting Started Guide
File name to copy Destination folder
OpenSSLdll ltAppServergtjavajrebin
IbmPortaldll ltAppServergtjavajrebin
IbmPortalini ltAppServergtjavajrebin
WebConnectPortaljar ltAppServergtlib
Step 3 Portlet Configuration
1 On IBM Workplace Server go to ltAppServergtjavajrebinIbmPortalini
2 You can modify the following parameters in the [Server=WebConnect] section webserverport=ltIBM web server portgt
Specifies the Web server port for accessing the PowerTerm WebConnect clients folder
Default 80 Address
Specifies the address of the PowerTerm WebConnect Server machine for Portlet to
connect to when PowerTerm WebConnect Server is located on a different machine
than the IBM Workplace Server CustomAddress
Specifies the addresss of the PowerTerm WebConnect Server machine for Clients to connect to If CustomAddress is the same as Address then this may be omitted webserveraddr
Specifies the address of the Web Server machine when it is located on a different
machine than the IBM Workplace Server
3 Restart the IBM server ltAppServergtProfilesAppServer01binstopServerbat ltAppServergtProfilesAppServer01binstartServerbat
This procedure may take about 20 minutes
Step 4 Install the Portlet and create an Application page
1 In a Web browser open the URL httpltIBM WebSphere Servergt9060ibmconsole
to open the IBM WebSphere Portal
2 Login and go to Applications | Install New Application
3 Browse to the PowerTerm WebConnectwar file located on PowerTerm WebConnect
Server
4 Enter Context root and click Next The Select installation options dialog appears
5 Optional change options to your preference or keep the default
6 Click Next
7 Select Ericom in the Module column click Apply and then Next
8 Click Finish and then Save
9 Select Applications | Enterprise Applications
10 Select PowerTerm WebConnectwar checkbox and click Start
PowerTerm WebConnect 29 Getting Started Guide
11 Enter in the Web browser the URL httpltIBM WebSphere
Servergt9080ltContext rootgtEricom portlet The Login dialog appears
12 Login and you will see PowerTerm WebConnect displayed on the list
Step 5 Run the Portlet
1 Restart IBM WebSphere Server
2 Open IBM WebSphere Portal in a browser httpltportal servergt9080ltContext
rootgtEricom portlet
3 Login to IBM WebSphere Server
4 Launch it The Userrsquos applications as defined on PowerTerm WebConnect Server
appear
5 Click an application to launch it
66 PowerTerm WebConnect Server Configuration
bull To enable the Lotus Expeditor to run the PowerTerm WebConnect client the
System Administrator must provide the users with accounts on PowerTerm
WebConnect Server (see the PowerTerm WebConnect Administratorrsquos Manual for
instructions on how to create users groups and connections on the PowerTerm
WebConnect Server)
bull To enable PowerTerm WebConnectrsquos Single Sign-On feature the System
Administrator must create a PowerTerm WebConnect user with the same
username and password as used for the Lotus Expeditor For a managed Lotus
Expeditor the credentials used are the username and password sent to the
managing server For an unmanaged Lotus Expeditor the operation system
username and the Lotus Expeditor password are used as credentials
NOTE If a password is not defined then the Single Sign-On will fail and the user will be
prompted with a login dialog
67 PowerTerm WebConnect Client Configuration
The PowerTerm WebConnect client is configured in webconnectxml located in the config
folder webconnectxml parameters are
url The PowerTerm WebConnect Agent url
server The PowerTerm WebConnect Server address
sso The Single Sign-On feature
dst The local destination for downloading PowerTerm WebConnect
components
PowerTerm WebConnect 30 Getting Started Guide
url
PowerTerm WebConnect components are installed on a Web server Their default url is
Windows Agent
httpltWebServer IPgtWebConnectwindowsptagentcab
Linux Agent
httpltWebServer IPgtWebConnectlinuxix86qterm-wczip
The url parameter must include the first part of the url (which is identical for both Windows
and Linux agents)
The PowerTerm WebConnect client will automatically append the appropriate suffix in
order to create a full accurate url
Example
ltitem key=rdquourlrdquo value=httpadminserverWebConnectgt
server
The computer name or IP address of the PowerTerm WebConnect Server machine
The PowerTerm WebConnect client will log in to this PowerTerm WebConnect Server
display the applications defined on it and run them according to this serverrsquos configuration
Format ltserver IPgt[ltportgt]
where default port is 4000 (can be edited)
Example
ltitem key=rdquoserverrdquo value=rdquoadmin24000rdquogt
sso
Determines whether Single Sign-on will be used to log in to PowerTerm WebConnect
Server Values
bull True (default) the client should automatically log in to the PowerTerm WebConnect
Server using the same credentials as the ones used to log in to the Lotus Expeditor
client
The System Administrator must verify that these credentials can log in to the
PowerTerm WebConnect Server
bull False the user will be prompted with a login dialog or will log in automatically using
previously saved credentials
Example
ltitem key=rdquossordquo value=rdquotruerdquogt
Autologin mode
PowerTerm WebConnect 31 Getting Started Guide
If sso is set to True the user is not prompted for credentials and the login process to
PowerTerm WebConnect Server is done automatically sending the credentials used for the
Lotus Expeditor unless the Lotus Expeditor does not have a password defined (In the
Lotus Expeditor preferences page | Password| Prompt me for a password at start up checkbox)
However if Single Sign-on is not used there are several options regarding Autologin that
can be defined in the PowerTerm WebConnect Preferences page Options
bull Yes
bull No
bull Interactive
bull First time interactive (default) ndash Simplifies the login process to PowerTerm
WebConnect Server In this mode the first time the user logs in to PowerTerm
WebConnect Server he will be prompted for his credentials with the Login dialog
These credentials will be stored in the machine and from then on the login process to
PowerTerm WebConnect Server will be done automatically
1 Open File | Preferences from the Lotus Expeditor and select PowerTerm WebConnect
2 In the Autologin to WebConnect Server section select First Interactive and click OK
3 Start PowerTerm WebConnect Client for Lotus Expeditor If credentials were entered
at least once then the next time the client will connect to PowerTerm WebConnect
Server without prompting for the user name and password
The Administrator must configure the Agent to do nothing when it exits for the
feature to work this way See PowerTerm WebConnect Administratorrsquos Manual for more information about defining Autologin
bull Allow multiple selection ndash Defines whether the user can launch more than one
application at a time (by using the ltCtrlgt or ltShiftgt button while selecting applications)
dst
Defines the path to download PowerTerm WebConnect components on the client machine
The dst parameter can contain macros which are translated by the PowerTerm WebConnect
Client for Lotus Expeditor during runtime The macros should be placed between percent
symbols () for example WebServer
When such a value is defined the PowerTerm WebConnect Client for Lotus Expeditor
substitutes the entire expression for the macrorsquos value
The PowerTerm WebConnect Client for Lotus Expeditor does not support the use
of environment variables as macros
Macros are not case sensitive
Macros supported by PowerTerm WebConnect Client for Lotus Expeditor
Macro name Description
WebServer The name of the Web server
It is obtained from the PowerTerm WebConnect Agent url
PowerTerm WebConnect 32 Getting Started Guide
parameter
Name The name of the clientrsquos CAB or ZIP file eg ldquoptagentrdquo
Display The clientrsquos display name from the version file
Version The clientrsquos version value It is obtained from the version
file
Root The default root location
Windows ldquoCrdquo
LinuxUnix an empty string
OSDir Windows Windowsrsquo installation directory for example
ldquoCWindowsrdquo
Linux an empty string
OSDrive Windows Windowsrsquo installation drive for example ldquoCrdquo
Linux an empty string
HomePath Windows The HOMEPATH environment variable
Linux The HOME environment variable
Home The Ericom folder in the userrsquos home directory
Windows CDocuments and SettingsltusergtApplication
DataEricom
Linux ltusergtEricom
In addition to the predefined macros listed above the PowerTerm WebConnect client
supports the usage of Java System Properties
Java System Properties available for users on Windows XP SP2
Java System Property Name Value Example
javaversion 150
javavendorurl httpwwwibmcom
javahome CIBMcommonpluginscomibmpvcwctruntim
esj2sewin32x86_150SR2-
20060511rcpeclipsepluginscomibmrcpj2sew
in32x86_150SR2-20060511jre
javavmspecificationversion 10
javavmversion 23
javavmvendor IBM Corporation
javavmname IBM J9 VM
PowerTerm WebConnect 33 Getting Started Guide
javaiotmpdir CDOCUME~1dianaLOCALS~1Temp
javacompiler j9jit23
javaextdirs CIBMcommonpluginscomibmpvcwctruntim
esj2sewin32x86_150SR2-
20060511rcpeclipsepluginscomibmrcpj2sew
in32x86_150SR2-20060511jrelibext
osname Windows XP
osarch x86
osversion 51 build 2600 Service Pack 2
pathseparator
username Jone
userhome CDocuments and SettingsJone
userdir CIBMRSA
usertimezone GMT+0200
System properties available for users on Linux RedHat 9
Java System Property Name Value Example
javaversion 150
javavendorurl httpwwwibmcom
javahome usrjavajre150_07
javavmversion 150
javavmvendor IBM Corporation
javavmname IBM J9 VM
javaclasspath
javalibrarypath
javaiotmpdir tmp
javacompiler
javaextdirs
osname Linux
osarch i386
osversion 2420-8
pathseparator
PowerTerm WebConnect 34 Getting Started Guide
username root
userhome root
userdir root
System properties names are placed in the configuration file within percent symbols ()
(like macros)
671 Configure the PowerTerm WebConnect Client
1 Open the Config Folder and edit the webconnectxml file Example
ltxml version =rdquo10rdquo encoding=rdquoUTF-8rdquogt
ltsection name=rdquoparametersrdquogt
ltitem key=rdquourlrdquo value=httpadminserverWebConnect56gt
ltitem key=rdquoserverrdquo value=rdquoadmin24000rdquogt
ltitem key=rdquossordquo value=rdquotruerdquogt
ltitem key=rdquodestrdquo value=rdquoCProgram FilesEricomrdquogt
ltsectiongt
2 Save the customized webconnectxml to a Web server folder available to all users It is
recommended to use the same Web server as the PowerTerm WebConnect Agent
Example
ltWebConnect installation foldergtwebwebconnectxml
3 Test the accessibility to this file - Type the URL of webconnectxml in the browser
Example
httpltWebServer IPgtWebConnectwebconnectxml
The contents of the file should be displayed
672 Configure the Preferences File
1 Open the plugins folder and open the PowerTermWebConnectClient_560365jar file
You can use Winzip version 70 and up or in Windows XP ndash Create a new file type for the
jar extension click advanced and select compressed (zipped) folder in the drop down list
Now you can open the JAR files in the Windows Explorer
The default contents of the file
configURL=httpleericomcomWebConnectwebconnectxml
2 Specify the accurate URL of the webconnectxml file Example
httpltWebServer IPgtWebConnectwebconnectxml
3 Save the file and close it The WinZip will display the following dialog
ldquoFile preferencesini has been changed since it was extracted Update archive
with this filerdquo
PowerTerm WebConnect 35 Getting Started Guide
4 Click Yes and close the archive
If you are editing the file from within the explorer you will have to save the file elsewhere
and then drag it to the explorer window where the JAR file is open
68 Installing PowerTerm WebConnect Client on Lotus Expeditor
1 Start the Lotus Expeditor client
2 Select File | Application | Install
3 Select Search for new features to install and click Next
4 Select Add Folder Location and type or select the location of the update site folder from
the provided package Click OK
5 Select the location you have just created and click Finish
6 In the Select the feature to install tree select Powerterm WebConnectUpdate Site Click
Next
7 Select I accept the terms in the license agreements and click Next
8 Click Finish
9 When prompted restart the platform
69 Running PowerTerm WebConnect Client for Lotus Expeditor
1 Click Open The PowerTerm WebConnect option is displayed
2 Select PowerTerm WebConnect The application will automatically connect and start
downloading the components from PowerTerm WebConnect Server
IMPORTANT
If you did not install PowerTerm WebConnect Server and are instead connecting to Ericom
Softwarersquos Demo WebConnect Server then you need to open port 443 in the firewall
691 PowerTerm WebConnect Client Workflow
1 PowerTerm WebConnect client reads the URL of webconnectxml from the preferencesini
file and requests it
2 When the webconnectxml is successfully downloaded the application reads the
configuration connects to the specified Web server downloads the PowerTerm
WebConnect components and connects to the PowerTerm WebConnect Server
3 The user is requested to login to the PowerTerm WebConnect Server For testing you
can use the username Example and password example
This step will be skipped if Single Sign-on is set to ldquotruerdquo
PowerTerm WebConnect 36 Getting Started Guide
4 After logging in to PowerTerm WebConnect Server the userrsquos applications are displayed
as defined by the administrator
5 To run an application select the desired application from the list and click Launch or
double-click the application The application will be launched in a separate window
610 Troubleshooting
When you encounter a problem the first step is to open the log file This file is located on
the client machine in the Ericom folder
Windows
CDocuments and SettingsltusernamegtEricomleclientEricomPluginlog
Linux
ltuser-home-directorygtEricomleclientEricomPluginlog
Following is a guide for diagnosing and fixing the problems in cases of error messages and
additional information
Error
Message
Solution
Version File
reading error
1 Check the lsquourlrsquo parameter in the webconnectxml file on the Web
server The value should be
httpltWebServerIPgtWebConnect
2 Try to run the following URL on the browser
Windows
httpltWebServerIPgtWebConnectwindowsptagentvertxt
Linux
httpltWebServerIPgtWebConnectlinuxix86qterm-
wcvertxt
The file contents displayed in the browser window should be in
the following form
560-rel14546
PowerTerm WebConnect Application Zone
560 - Main Release
ltrootgtPowerTerm WebConnect 56ltWebServergt
If the version file contents are not as shown check
- Is the Web Server running
- Are PowerTerm WebConnect Web Components and version files
PowerTerm WebConnect 37 Getting Started Guide
in place
3 On the Web server check ltPowerTerm WebConnect
rootgtwebwindowsptagentvertxt If the contents ldquolook wrongrdquo or
not in the proper form reinstall the PowerTerm WebConnect Web
components
4 On the client machine open the aforementioned URL in the
browser The file content should appear in the browser If it does
not it could be that the Web server is down
Web Server is
shut down
The webconnectxml configuration file must be located on the Web
server The explicit URL to this file is defined in the preferencesini
file (see Configure the Preferences File)
The error message contains the IP address of the Web server
Verify that the Web server on this machine is running
Version file
does not exist
on ltURLgt
See Version File reading error
The
configuration
file is not
accessible or
has a wrong
format
The webconnectxml configuration file must be located on the Web
server and the explicit URL to the configuration must be defined in
the preferencesini file (see Configure the Preferences File)
Try to open the URL specified in the error message in the
browser If it does not open then it either does not exist or it has
a wrong format
Preferences
file does not
exist in the
application
bundle
The preferencesini file containing the URL to the configuration
file was removed from the update site folder
Uninstall the current PowerTerm WebConnect client from the
client machine Create a new customized package (see
PowerTerm WebConnect Client Configuration) and reinstall it
Configuration
file URL is not
defined in
preference
file
The URL to the configuration file does not appear in the
preferencesini file (see Configure the Preferences File)
Uninstall the current PowerTerm WebConnect client from the
client machine Create a new customized package (see
PowerTerm WebConnect Client Configuration) and reinstall it
No IP address
could be
found for the
host
The Web server URL specified in the preferencesini file (see
Configure the Preferences File) or in the webconnectxml file (see
Configure the PowerTerm WebConnect Client) is an unknown
host
If the mistake is in the preferencesini file uninstall the current
PowerTerm WebConnect client from the client machine Create a
new customized package (see PowerTerm WebConnect Client
Configuration) and reinstall it
PowerTerm WebConnect 38 Getting Started Guide
If the mistake is in the webconnectxml file correct the file reopen
the Lotus Expeditor client
Cannot write
to destination
The temporary file cannot be written to the defined destination
Check the write permissions
Copied
configuration
file has wrong
format
The webconnectxml file as received from the specified URL has a
wrong format Correct the file and try again
PowerTerm
WebConnect
Agent URL is
malformed
The PowerTerm WebConnect Agent URL specified in the
webconnectxml file (see Configure the PowerTerm WebConnect
Client) does not have a proper HTTP format Correct the file and
try again
PowerTerm
WebConnect
Agent URL is
not defined
The PowerTerm WebConnect Agent URL parameter is not specified
in the webconnectxml file (see Configure the PowerTerm
WebConnect Client)
Correct the file and try again
The specified
destination
folder name
is wrong
The destination folder name contains illegal characters
ltgt|
Check the dst parameter in the webconnectxml file Correct the
file and try again
You do not
have
permissions
to write to
ltpathgt
The PowerTerm WebConnect Agent cannot be written to the
destination as defined Check the write permissions
The default destination defined in the version file should not to
be changed
A customized destination for PowerTerm WebConnect Agent
downloading can be defined in the webconnectxml file (See
Configure the PowerTerm WebConnect Client)
Check the destination value correct and try again
PowerTerm WebConnect 39 Getting Started Guide
About Ericom
Ericomreg Software is a leading provider of Application Access and Virtualization Solutions
Since 1993 Ericom has been helping users access enterprise mission-critical applications
running on a broad range of Microsoftreg Windowsreg Terminal Servers virtual Desktops
Blade PCs legacy hosts and other systems Ericom provides concrete business value by
helping organizations realize the benefits of their IT investments With offices in the United
States United Kingdom EMEA India and China Ericom also has an extensive network of
distributors and partners throughout North America Europe Asia and the Far East Our
expanding customer base is more than 30 thousand strong with over 7 million
installations
For more information on our products and services contact us at the location nearest to you
And visit our web site httpwwwericomcom
North America Western Europe International
Ericom Software Inc Ericom Software (UK) Ltd Ericom Software Ltd
231 Herbert Avenue Bldg 4 11a Victoria Square 8 Hamarpeh Street
Closter NJ 07624 USA Droitwich Worcestershire Har Hotzvim Technology Park
Tel +1 (201) 767 2210 WR9 8DE United Kingdom Jerusalem 91450 Israel
Fax +1 (201) 767 2205 Tel +44 (0) 845 644 3597 Tel +972 (2) 591 1700
Toll-free 1 (888) 769 7876 Fax +44 (0) 845 644 3598 Fax +972 (2) 571 4737
Email infoericomcom Email infoericomcouk Email infoericomcom
PowerTerm WebConnect 15 Getting Started Guide
13 Click Next The Application Publisher Step 7 dialog appears
14 Select the users groups or OUs to which you wish to publish the applications and click Next The Application Publisher Step 8 dialog appears By default applications will
be published to everybody
15 Click Advanced Settings to modify settings such as the login credentials to the
Terminal Servers By default PowerTerm WebConnect credentials will be passed
through to the Terminal Server
16 Click Finish The published applications appears in the Connection List
Right-click and select Properties or double click on the published application in the
Connections list to view and modify any of the settings which you previously
defined
To publish a remote Desktop
1 Select Action | New | Remote Desktop The Application Publisher Step 1 dialog appears
2 Type the Display Name which will be the name presented to the end-users and click
Next The Application Publisher Step 2 dialog appears
3 Specify where icons for the published desktop will be displayed to the end-user in Publish to
4 Click Choose Icon to replace the desktoprsquos default icon Select the desired icon from
the list that appears
5 Click Next The Application Publisher Step 3 dialog appears
6 Determine Screen Size and the Color Quality of the published desktop
7 If desirable select Show Connection Bar in Full Screen Mode
8 Click Next The Application Publisher Step 4 dialog appears
9 Choose the connection speed that matches your infrastructure The connection speed
setting determines the value of three visual effects settings You can also override
these settings specifically
10 Click Next The Application Publisher Step 5 dialog appears
11 Specify where sounds are to be played ndash locally or remotely Where to Apply Window
Key Combinations and which local devices you want to automatically connect to when
logged on to the remote computer
12 Click Next The Application Publisher Step 6 dialog appears
13 Specify the Server Address and Port Number of the Terminal Server that weill provide
the desktop and click Next The Application Publisher Step 7 dialog appears
14 Select the users groups or OUs to which you wish to publish the desktop and click Next The Application Publisher Step 8 dialog appears
Select the Server group to allow all users to access the published application
15 Click Advanced Settings to modify settings such as the login credentials to the
Terminal Servers By default PowerTerm WebConnect credentials will be used
PowerTerm WebConnect 16 Getting Started Guide
16 Click Finish The published application appears in the Connection List
Right-click Properties or double click on the published application in the
Connections list to modify any of the settings which you previously defined
32 Create Terminal Emulation Connections
To provide access to legacy host systems you will need to create Terminal Emulation
connections For each such connection you can specify the host address emulation type
login script and more Once you have created these connections users will be able to
launch them using HostView (Windows or Linux) WebView or the Java client as
appropriate
1 Click Create a Host Connection in the Welcome screen The Add Connection dialog
appears
2 Enter a Name for the new connection
3 Specify an Owner for the new connection The possibilities are
[None] the connection will not be allowed to run by anyone and it will not be
displayed in any Connection list Server the connection will be accessible for all users of this PowerTerm
WebConnect server A specific group the connection will be accessible for all users of the specified
group A specific user the connection will be accessible for a specified user only
4 Leave category Terminal Emulation selected
5 Select Terminal Type Terminal Model and Communication Type as needed
6 Specify the Host Name or IP address of your host
7 Specify other parameters as needed
8 Select the Security Type as needed if your host supports SSL or SSH and specify
the appropriate details in the Details dialog
9 Use the Settings Key Mapping and Power Pad options to further customize the
connection
10 Click OK and the connection is created
33 Test Connections
It is recommended to test published applications or host connections before they are made
available to end-users
To test a connection
bull Right-click the target connection from the Connection section of the main screen and
select Test
Alternatively
PowerTerm WebConnect 17 Getting Started Guide
1 Select Tools | Run ltdesired clientgt The Login to WebConnect dialog appears
2 Enter the User Name and Password for the individual who owns the connection that
you want to test and click Login The desired PowerTerm WebConnect client is started
and the Connect dialog appears
3 Select the desired connection and click Connect The test is executed
34 Launch the Application Zone or the Application Portal
Users can access the published applications from the Application Zone application launcher
or from the Application Portal web interface
To use the Application Zone go to Start menuProgramsEricom SoftwarePowerTerm
WebConnect 5x and select Client URLs Alternatively type the following URL into your Web
browserrsquos address bar httpltserver addressgtWebConnect5xClientURLshtml In the
page that opens click on the Run button next to the Application Zone to launch it
To use the Application Portal go to Start menuProgramsEricom SoftwarePowerTerm
WebConnect 5x and select it Alternatively type the following URL into the Web browserrsquos
address bar httpltserver addressgtWebConenct5xportalwindowsindexasp
35 Monitor a Users Sessions
From the Administration Tool you can monitor the users sessions and may intervene if
necessary This intervention may result in your input appearing on the users screen The
user receives a notification when an administrator begins and ends monitoring the session
1 Select View | Client Sessions or click to see all the active client sessions
2 Select the desired active session and right-click Attach The Password Verify dialog
appears
3 Enter your password and click OK Some notification dialogs appears and the selected
PowerTerm WebConnect session is viewed
36 View Intruders
bull The Intruders window shows suspected attempts at breaching security After several
suspected intrusion attempts users are blocked temporarily
bull In addition to showing suspected intrusion attempts the Intruders window allows
you to remove restrictions on users
bull Select View | All Intruders or click
PowerTerm WebConnect 18 Getting Started Guide
4 Accessing Virtual Desktops and Blade PCs with PowerTerm WebConnect
This chapter provides instructions on configuring PowerTerm WebConnect for Virtual
Desktop Infrastructure (VDI)
41 Step 1 Launch DeskView Administration Tool
Verify that PowerTerm WebConnect is installed on your server and launch PowerTerm
WebConnect Admin Tool
bull Select Tools | Open VDI Manager The PowerTerm WebConnect DeskView Administration
Tool opens
The first time you launch the DeskView Administration Tool you will be prompted to install
the tool
PowerTerm WebConnect 19 Getting Started Guide
Microsoft Management Console 30 is required for PowerTerm WebConnect DeskView
Administration Tool If you do not have this installed you will also automatically be
prompted to install this update
Follow the installation processes when you are prompted for either install PowerTerm
WebConnect DeskView Administration Tool will automatically launch when these
installations are completed
42 Step 2 Add a Host
1 Right-click Virtualization Hosts and select Add Host The Add a New Host wizard
opens Click Next
2 Enter a Host Name as you would like it to appear in PowerTerm WebConnect
DeskView Administration Tool and a description (optional) Click Next
3 Specify the Virtualization Server type and click Next
4 Specify the connection information and click Next
VMWare Virtual Center v1x and 2x
Specify the HTTPS Web Service address and a UsernamePassword that can access
the host
VMWare Virtual Server 2005
Click Start and then Run
Type ldquoservicesmscrdquo and click OK
Scroll down to PowerTerm WebConnect DeskView Server service and open
Properties
Change the Login Account for the service to match the Domain Administrator
account and password used when setting up Microsoft Virtual Server 2005 and
restart the service Enter the IP or NETBIOS name of the Microsoft Virtual Server 2005 server as the
Server Address in the Connection Broker Wizard
Xen Server
Specify the hypervisor IP address or NETBIOS name the Root UsernamePassword
to the hypervisor and the Service port (default 80)
Oracle VM
Specify the Serverrsquos agent URL and Port (default 8899) for example
httpsltservernamegt8899
Specify the Oracle VM hypervisorrsquos Oracle Agent UsernamePassword (default
username oracle)
5 Click Finish to add the new Host
To configure Virtual Machines for use install the Ericom Tools (vmagentmsi) on each of the
virtual machines on the new host for PowerTerm WebConnect DeskView to recognize them
The vmagentmsi installer is located on the PowerTerm WebConnect server in ltPowerTerm
WebConnect installation foldergtAddOnsDeskView VDI folder (default installation
PowerTerm WebConnect 20 Getting Started Guide
folder is xProgram FilesEricom SoftwareWebConnect 56) During installation you
will need to enter the DeskView IP address or NETBIOS name
If you are using Microsoft Virtual Server 2005 as your Virtualization Host use the
IP address of the DeskView server only when installing the Ericom Tool package
43 Step 3 Create a Pool
Pools are used to organize Virtual Machines (VM) into logical groups This enables
organizations to combine and order resources from multiple systems into one entity To
access available resources end-users simply connect to PowerTerm WebConnect to access
any configured resource
1 Right-click Pools and select Create Pool The Create a Pool wizard opens Click
Next
2 Enter a Pool name as you wish it to appear and a description (optional) and click
Next
3 Specify the Pool type and click Next
4 Specify the Assignment type and click Next
Permanently will cause a virtual machine to affix to the user who has launched
that virtual machine For the duration of the session will cause any virtual machine that is not in use to
be returned to the pool for any user to launch
5 Specify the LogoffDisconnect event and click Next
Select what you would like to happen after a user logs off from a virtual machine
in this pool
Select what you would like to happen when a user is disconnected from a virtual
machine in this pool
6 Click Finish to add the new Pool
You will need to assign virtual machines from your virtualization hosts to your created pool
1 Right-click the pool and select Assign Machines The Assign Machines to ltyour
pool namegt dialog opens
2 Highlight the desired virtual machine(s) and click Select Click OK
44 Step 4 Publish an ApplicationDesktop
1 Return to PowerTerm WebConnect Admin Tool to publish DeskView pools
2 Determine whether to publish a full desktop or a seamless application running
from a virtual desktop
For a full desktop
Select Action | New | Remote Windows Desktop
For a seamless application
Select Action | New | Windows Application
PowerTerm WebConnect 21 Getting Started Guide
3 Select Virtual Desktop in the first step of the wizard and click Next
4 Follow the wizardrsquos instructions until you reach the Virtual Desktops step
5 Select a pool that you previously created and that you would like this connection to choose virtual machines from Click Next
6 Continue and complete the reminder of the wizardrsquos steps
Once the resource is published users who have been assigned access will be able to use it
immediately
PowerTerm WebConnect 22 Getting Started Guide
5 Download and Run PowerTerm WebConnect Clients
PowerTerm WebConnect clients are automatically downloaded and installed onto the client
devices For detailed information and samples please refer to the PowerTerm WebConnect
Sample URLs page To see this page navigate your browser to
httpltweb_servergtWebConnect5xClientURLshtml
PowerTerm WebConnect 23 Getting Started Guide
6 PowerTerm WebConnect Client for Lotus Expeditor
61 Installation Package
PowerTerm WebConnect client for Lotus Expeditor is provided to IBM in an Update Site
package This is a ZIP archive containing the Update Site with the Eclipse feature and plug-
in that comprises the PowerTerm WebConnect client
Extract the ZIP file keeping the foldersrsquo structure intact
NOTE In Winzip verify that the ldquoUse folder namesrdquo option is set to TRUE
Package structure
Update Site
- plugins
- PowerTermWebConnectClient_560365jar
- features
- comericomWebConnect_560365jar
- sitexml
config
- webconnectxml
Definitions
bull webconnectxml PowerTerm WebConnect client configuration file
bull comericomWebConnect_560365jar PowerTerm WebConnect client feature file
bull PowerTermWebConnectClient_560365jar PowerTerm WebConnect client plugin file
62 Pre-installation steps
PowerTerm WebConnect client for Lotus Expeditor does not run independently but in
conjunction with PowerTerm WebConnect Server You can either install it and define your
users groups and applications or use Ericom Softwarersquos Demo PowerTerm WebConnect
Server
bull If you decide to install PowerTerm WebConnect Server you will need the full
installation ie the PowerTerm WebConnect Server and the Web components If you
do not have the installation CD you can download and install a trial version from
wwwericomcom
PowerTerm WebConnect 24 Getting Started Guide
bull If you decide to use Ericom Softwarersquos Demo PowerTerm WebConnect Server then
skip to the chapter Installing PowerTerm WebConnect Client on Lotus Expeditor
63 Install PowerTerm WebConnect Portlet on IBM Workplace server (for Windows OS)
Step 1 Install PowerTerm WebConnect Server
If PowerTerm WebConnect Server and IBM Workplace Server are on separate machines
bull Configure PowerTerm WebConnect Server
Launch PowerTerm WebConnect Administration Tool
Open Files | Configuration | Main
In the [Portal] section edit
Machines=localhostltIBM sever machinegt
bull Configure PowerTerm WebConnect Web components
Copy the ldquowebrdquo folder from the PowerTerm WebConnect server installation to the
IBM Workplace server machine
Create an Alias or a Virtual directory to it named WebConnect on the Web
server providing access to it for the users This is in order to enable the users to
download the necessary files to run their applications
Step 2 Enable JSR portlets
1 On IBM Workplace Server go to ltPortalServergtsharedappconfigservicesConfigServiceproperties
2 Edit portalenablejsr168=true
3 Save and close the file
Step 3 Enable SSO
1 On IBM Workplace Server go to ltPortalServergtsharedappconfigservicesLoaderServiceproperties
2 Edit commandpath=comericomportalcommandscomibmwpsenginecommands
3 Save and close the file
Step 4 Copy Files
The following files need to be copied from WebConnect ServerAddOnsIBM
WorkplacePortlet folder to IBM Workplace Server
File name to copy Destination folder
OpenSSLdll ltAppServergtjavajrebin
IbmPortaldll ltAppServergtjavajrebin
IbmPortalini ltAppServergtjavajrebin
PowerTerm WebConnect 25 Getting Started Guide
WebConnectPortaljar ltAppServergtlib
EricomLoginjar ltPortalServergtsharedapp
Step 5 Portlet Configuration
1 On IBM Workplace Server go to ltAppServergtjavajrebinIbmPortalini
2 You can modify the following parameters in the [Server=WebConnect] section webserverport=ltIBM web server portgt
Specifies the Web server port for accessing the PowerTerm WebConnect clients folder
Default 80 Address
Specifies the address of the PowerTerm WebConnect Server machine for Portlet to
connect to when PowerTerm WebConnect Server is located on a different machine
than the IBM Workplace Server CustomAddress
Specifies the addresss of the PowerTerm WebConnect Server machine for Clients to connect to If CustomAddress is the same as Address then this may be omitted webserveraddr
Specifies the address of the Web Server machine when it is located on a different
machine than the IBM Workplace Server
3 Restart the IBM server ltPortalServergtrootscriptsstopWorkplaceServicesbat ltPortalServergtrootscriptsstartWorkplaceServicesbat
This procedure may take about 20 minutes
Step 6 Install the Portlet
1 In a Web browser open the URL httpltIBM Workplace
Servergt9081lwpmyworkplace to open the IBM Workplace Portal
2 Login as administrator
3 Go to Administration | Portlets | Install
4 Browse to the PowerTerm WebConnectwar file located on PowerTerm WebConnect
Server and click Next
5 Click Install
Step 7 Create an Application page
1 Login to the Workplace
2 Go to Portal User Interface | Manage Pages
3 Search for My Work
4 Click the My Work link and select New Page
5 Name the page PowerTerm WebConnect and click OK
6 Click OK again You will see the created page on the list
7 Click the pencil icon on the new page and select the 1 square layout
PowerTerm WebConnect 26 Getting Started Guide
8 Click Add Portlet and search for PowerTerm WebConnect
9 Select it and click OK
10 Click Done
11 Click My work at the top of the page PowerTerm WebConnect is displayed on the list
Step 8 Run the Portlet
1 Restart IBM Workplace Server
2 Open IBM Workplace Portal in a browser httpltportal servergtlwpmyworkplace
3 Login to IBM Workplace Server
4 Click My work PowerTerm WebConnect portlet is displayed
5 Launch it The Userrsquos applications as defined on PowerTerm WebConnect Server
appear
6 Click an application to launch it
64 Install PowerTerm WebConnect Portlet on IBM Workplace server (for Linux OS)
Step 1 Enable JSR 168 portlets
1 Go to optIBMWorkplacePortalServersharedappconfigservicesConfigServiceproperties
2 Modify the portalenablejsr168 property to ldquotruerdquo
3 Restart the server cd optIBMWorkplacePortalServerrootscripts
Run stopWorkplaceServicessh
Run startWorkplaceServicessh
This procedure can take up to 20 minutes
4 Log on to the workplace server at httpltworkplace servergt9081lwpmyworkplace using
the administrators username and password
Step 2 Install the portlet
1 Restart IBM Workplace Server
2 In a Web browser open the URL httpltworkplace server IPgtlwpmyworkplace
3 Login to IBM Workplace Server as an administrator
4 Go to Administration | Portlets | Install
5 Browse to the PowerTerm WebConnectwar file located on PowerTerm WebConnect
Server and click Next
6 Click Install
PowerTerm WebConnect 27 Getting Started Guide
Step 3 Install the Application page
1 Login to the workplace as administrator
2 Go to Administration | Portal User Interface | Manage Pages
3 Search for My Work
4 Click the My Work link and select New Page
5 Name the page PowerTerm WebConnect and click OK
6 Click OK again You will see the created page on the list
7 Click the pencil icon and select the 1-square layout
8 Click Add Portlet and search for PowerTerm WebConnect
9 Select it and click OK
10 Click Done
11 Click My work on top and PowerTerm WebConnect is displayed on the left bar
Step 4 Run the portlet
1 Restart IBM Workplace Server
2 Open IBM Workplace Portal in a browser httpltportal servergtlwpmyworkplace
3 Login to IBM Workplace Server
4 Click My work PowerTerm WebConnect portlet is displayed
5 Launch it The Userrsquos applications as defined on PowerTerm WebConnect Server
appear
6 Click an application to launch it
65 Install PowerTerm WebConnect Portlet on IBM WebSphere 61 server (for Windows OS)
Step 1 Install PowerTerm WebConnect Server
You have to configure PowerTerm WebConnect Server if it and the IBM WebSphere Server
are on separate machines
1 Launch PowerTerm WebConnect Administration Tool
2 Open Files | Configuration | Main
3 In the [Portal] section edit Machines=localhostltIBM sever machinegt
Step 2 Copy Files
The following files need to be copied from WebConnect ServerAddOnsIBM
WebSpherePortlet folder to IBM WebSphere Server
PowerTerm WebConnect 28 Getting Started Guide
File name to copy Destination folder
OpenSSLdll ltAppServergtjavajrebin
IbmPortaldll ltAppServergtjavajrebin
IbmPortalini ltAppServergtjavajrebin
WebConnectPortaljar ltAppServergtlib
Step 3 Portlet Configuration
1 On IBM Workplace Server go to ltAppServergtjavajrebinIbmPortalini
2 You can modify the following parameters in the [Server=WebConnect] section webserverport=ltIBM web server portgt
Specifies the Web server port for accessing the PowerTerm WebConnect clients folder
Default 80 Address
Specifies the address of the PowerTerm WebConnect Server machine for Portlet to
connect to when PowerTerm WebConnect Server is located on a different machine
than the IBM Workplace Server CustomAddress
Specifies the addresss of the PowerTerm WebConnect Server machine for Clients to connect to If CustomAddress is the same as Address then this may be omitted webserveraddr
Specifies the address of the Web Server machine when it is located on a different
machine than the IBM Workplace Server
3 Restart the IBM server ltAppServergtProfilesAppServer01binstopServerbat ltAppServergtProfilesAppServer01binstartServerbat
This procedure may take about 20 minutes
Step 4 Install the Portlet and create an Application page
1 In a Web browser open the URL httpltIBM WebSphere Servergt9060ibmconsole
to open the IBM WebSphere Portal
2 Login and go to Applications | Install New Application
3 Browse to the PowerTerm WebConnectwar file located on PowerTerm WebConnect
Server
4 Enter Context root and click Next The Select installation options dialog appears
5 Optional change options to your preference or keep the default
6 Click Next
7 Select Ericom in the Module column click Apply and then Next
8 Click Finish and then Save
9 Select Applications | Enterprise Applications
10 Select PowerTerm WebConnectwar checkbox and click Start
PowerTerm WebConnect 29 Getting Started Guide
11 Enter in the Web browser the URL httpltIBM WebSphere
Servergt9080ltContext rootgtEricom portlet The Login dialog appears
12 Login and you will see PowerTerm WebConnect displayed on the list
Step 5 Run the Portlet
1 Restart IBM WebSphere Server
2 Open IBM WebSphere Portal in a browser httpltportal servergt9080ltContext
rootgtEricom portlet
3 Login to IBM WebSphere Server
4 Launch it The Userrsquos applications as defined on PowerTerm WebConnect Server
appear
5 Click an application to launch it
66 PowerTerm WebConnect Server Configuration
bull To enable the Lotus Expeditor to run the PowerTerm WebConnect client the
System Administrator must provide the users with accounts on PowerTerm
WebConnect Server (see the PowerTerm WebConnect Administratorrsquos Manual for
instructions on how to create users groups and connections on the PowerTerm
WebConnect Server)
bull To enable PowerTerm WebConnectrsquos Single Sign-On feature the System
Administrator must create a PowerTerm WebConnect user with the same
username and password as used for the Lotus Expeditor For a managed Lotus
Expeditor the credentials used are the username and password sent to the
managing server For an unmanaged Lotus Expeditor the operation system
username and the Lotus Expeditor password are used as credentials
NOTE If a password is not defined then the Single Sign-On will fail and the user will be
prompted with a login dialog
67 PowerTerm WebConnect Client Configuration
The PowerTerm WebConnect client is configured in webconnectxml located in the config
folder webconnectxml parameters are
url The PowerTerm WebConnect Agent url
server The PowerTerm WebConnect Server address
sso The Single Sign-On feature
dst The local destination for downloading PowerTerm WebConnect
components
PowerTerm WebConnect 30 Getting Started Guide
url
PowerTerm WebConnect components are installed on a Web server Their default url is
Windows Agent
httpltWebServer IPgtWebConnectwindowsptagentcab
Linux Agent
httpltWebServer IPgtWebConnectlinuxix86qterm-wczip
The url parameter must include the first part of the url (which is identical for both Windows
and Linux agents)
The PowerTerm WebConnect client will automatically append the appropriate suffix in
order to create a full accurate url
Example
ltitem key=rdquourlrdquo value=httpadminserverWebConnectgt
server
The computer name or IP address of the PowerTerm WebConnect Server machine
The PowerTerm WebConnect client will log in to this PowerTerm WebConnect Server
display the applications defined on it and run them according to this serverrsquos configuration
Format ltserver IPgt[ltportgt]
where default port is 4000 (can be edited)
Example
ltitem key=rdquoserverrdquo value=rdquoadmin24000rdquogt
sso
Determines whether Single Sign-on will be used to log in to PowerTerm WebConnect
Server Values
bull True (default) the client should automatically log in to the PowerTerm WebConnect
Server using the same credentials as the ones used to log in to the Lotus Expeditor
client
The System Administrator must verify that these credentials can log in to the
PowerTerm WebConnect Server
bull False the user will be prompted with a login dialog or will log in automatically using
previously saved credentials
Example
ltitem key=rdquossordquo value=rdquotruerdquogt
Autologin mode
PowerTerm WebConnect 31 Getting Started Guide
If sso is set to True the user is not prompted for credentials and the login process to
PowerTerm WebConnect Server is done automatically sending the credentials used for the
Lotus Expeditor unless the Lotus Expeditor does not have a password defined (In the
Lotus Expeditor preferences page | Password| Prompt me for a password at start up checkbox)
However if Single Sign-on is not used there are several options regarding Autologin that
can be defined in the PowerTerm WebConnect Preferences page Options
bull Yes
bull No
bull Interactive
bull First time interactive (default) ndash Simplifies the login process to PowerTerm
WebConnect Server In this mode the first time the user logs in to PowerTerm
WebConnect Server he will be prompted for his credentials with the Login dialog
These credentials will be stored in the machine and from then on the login process to
PowerTerm WebConnect Server will be done automatically
1 Open File | Preferences from the Lotus Expeditor and select PowerTerm WebConnect
2 In the Autologin to WebConnect Server section select First Interactive and click OK
3 Start PowerTerm WebConnect Client for Lotus Expeditor If credentials were entered
at least once then the next time the client will connect to PowerTerm WebConnect
Server without prompting for the user name and password
The Administrator must configure the Agent to do nothing when it exits for the
feature to work this way See PowerTerm WebConnect Administratorrsquos Manual for more information about defining Autologin
bull Allow multiple selection ndash Defines whether the user can launch more than one
application at a time (by using the ltCtrlgt or ltShiftgt button while selecting applications)
dst
Defines the path to download PowerTerm WebConnect components on the client machine
The dst parameter can contain macros which are translated by the PowerTerm WebConnect
Client for Lotus Expeditor during runtime The macros should be placed between percent
symbols () for example WebServer
When such a value is defined the PowerTerm WebConnect Client for Lotus Expeditor
substitutes the entire expression for the macrorsquos value
The PowerTerm WebConnect Client for Lotus Expeditor does not support the use
of environment variables as macros
Macros are not case sensitive
Macros supported by PowerTerm WebConnect Client for Lotus Expeditor
Macro name Description
WebServer The name of the Web server
It is obtained from the PowerTerm WebConnect Agent url
PowerTerm WebConnect 32 Getting Started Guide
parameter
Name The name of the clientrsquos CAB or ZIP file eg ldquoptagentrdquo
Display The clientrsquos display name from the version file
Version The clientrsquos version value It is obtained from the version
file
Root The default root location
Windows ldquoCrdquo
LinuxUnix an empty string
OSDir Windows Windowsrsquo installation directory for example
ldquoCWindowsrdquo
Linux an empty string
OSDrive Windows Windowsrsquo installation drive for example ldquoCrdquo
Linux an empty string
HomePath Windows The HOMEPATH environment variable
Linux The HOME environment variable
Home The Ericom folder in the userrsquos home directory
Windows CDocuments and SettingsltusergtApplication
DataEricom
Linux ltusergtEricom
In addition to the predefined macros listed above the PowerTerm WebConnect client
supports the usage of Java System Properties
Java System Properties available for users on Windows XP SP2
Java System Property Name Value Example
javaversion 150
javavendorurl httpwwwibmcom
javahome CIBMcommonpluginscomibmpvcwctruntim
esj2sewin32x86_150SR2-
20060511rcpeclipsepluginscomibmrcpj2sew
in32x86_150SR2-20060511jre
javavmspecificationversion 10
javavmversion 23
javavmvendor IBM Corporation
javavmname IBM J9 VM
PowerTerm WebConnect 33 Getting Started Guide
javaiotmpdir CDOCUME~1dianaLOCALS~1Temp
javacompiler j9jit23
javaextdirs CIBMcommonpluginscomibmpvcwctruntim
esj2sewin32x86_150SR2-
20060511rcpeclipsepluginscomibmrcpj2sew
in32x86_150SR2-20060511jrelibext
osname Windows XP
osarch x86
osversion 51 build 2600 Service Pack 2
pathseparator
username Jone
userhome CDocuments and SettingsJone
userdir CIBMRSA
usertimezone GMT+0200
System properties available for users on Linux RedHat 9
Java System Property Name Value Example
javaversion 150
javavendorurl httpwwwibmcom
javahome usrjavajre150_07
javavmversion 150
javavmvendor IBM Corporation
javavmname IBM J9 VM
javaclasspath
javalibrarypath
javaiotmpdir tmp
javacompiler
javaextdirs
osname Linux
osarch i386
osversion 2420-8
pathseparator
PowerTerm WebConnect 34 Getting Started Guide
username root
userhome root
userdir root
System properties names are placed in the configuration file within percent symbols ()
(like macros)
671 Configure the PowerTerm WebConnect Client
1 Open the Config Folder and edit the webconnectxml file Example
ltxml version =rdquo10rdquo encoding=rdquoUTF-8rdquogt
ltsection name=rdquoparametersrdquogt
ltitem key=rdquourlrdquo value=httpadminserverWebConnect56gt
ltitem key=rdquoserverrdquo value=rdquoadmin24000rdquogt
ltitem key=rdquossordquo value=rdquotruerdquogt
ltitem key=rdquodestrdquo value=rdquoCProgram FilesEricomrdquogt
ltsectiongt
2 Save the customized webconnectxml to a Web server folder available to all users It is
recommended to use the same Web server as the PowerTerm WebConnect Agent
Example
ltWebConnect installation foldergtwebwebconnectxml
3 Test the accessibility to this file - Type the URL of webconnectxml in the browser
Example
httpltWebServer IPgtWebConnectwebconnectxml
The contents of the file should be displayed
672 Configure the Preferences File
1 Open the plugins folder and open the PowerTermWebConnectClient_560365jar file
You can use Winzip version 70 and up or in Windows XP ndash Create a new file type for the
jar extension click advanced and select compressed (zipped) folder in the drop down list
Now you can open the JAR files in the Windows Explorer
The default contents of the file
configURL=httpleericomcomWebConnectwebconnectxml
2 Specify the accurate URL of the webconnectxml file Example
httpltWebServer IPgtWebConnectwebconnectxml
3 Save the file and close it The WinZip will display the following dialog
ldquoFile preferencesini has been changed since it was extracted Update archive
with this filerdquo
PowerTerm WebConnect 35 Getting Started Guide
4 Click Yes and close the archive
If you are editing the file from within the explorer you will have to save the file elsewhere
and then drag it to the explorer window where the JAR file is open
68 Installing PowerTerm WebConnect Client on Lotus Expeditor
1 Start the Lotus Expeditor client
2 Select File | Application | Install
3 Select Search for new features to install and click Next
4 Select Add Folder Location and type or select the location of the update site folder from
the provided package Click OK
5 Select the location you have just created and click Finish
6 In the Select the feature to install tree select Powerterm WebConnectUpdate Site Click
Next
7 Select I accept the terms in the license agreements and click Next
8 Click Finish
9 When prompted restart the platform
69 Running PowerTerm WebConnect Client for Lotus Expeditor
1 Click Open The PowerTerm WebConnect option is displayed
2 Select PowerTerm WebConnect The application will automatically connect and start
downloading the components from PowerTerm WebConnect Server
IMPORTANT
If you did not install PowerTerm WebConnect Server and are instead connecting to Ericom
Softwarersquos Demo WebConnect Server then you need to open port 443 in the firewall
691 PowerTerm WebConnect Client Workflow
1 PowerTerm WebConnect client reads the URL of webconnectxml from the preferencesini
file and requests it
2 When the webconnectxml is successfully downloaded the application reads the
configuration connects to the specified Web server downloads the PowerTerm
WebConnect components and connects to the PowerTerm WebConnect Server
3 The user is requested to login to the PowerTerm WebConnect Server For testing you
can use the username Example and password example
This step will be skipped if Single Sign-on is set to ldquotruerdquo
PowerTerm WebConnect 36 Getting Started Guide
4 After logging in to PowerTerm WebConnect Server the userrsquos applications are displayed
as defined by the administrator
5 To run an application select the desired application from the list and click Launch or
double-click the application The application will be launched in a separate window
610 Troubleshooting
When you encounter a problem the first step is to open the log file This file is located on
the client machine in the Ericom folder
Windows
CDocuments and SettingsltusernamegtEricomleclientEricomPluginlog
Linux
ltuser-home-directorygtEricomleclientEricomPluginlog
Following is a guide for diagnosing and fixing the problems in cases of error messages and
additional information
Error
Message
Solution
Version File
reading error
1 Check the lsquourlrsquo parameter in the webconnectxml file on the Web
server The value should be
httpltWebServerIPgtWebConnect
2 Try to run the following URL on the browser
Windows
httpltWebServerIPgtWebConnectwindowsptagentvertxt
Linux
httpltWebServerIPgtWebConnectlinuxix86qterm-
wcvertxt
The file contents displayed in the browser window should be in
the following form
560-rel14546
PowerTerm WebConnect Application Zone
560 - Main Release
ltrootgtPowerTerm WebConnect 56ltWebServergt
If the version file contents are not as shown check
- Is the Web Server running
- Are PowerTerm WebConnect Web Components and version files
PowerTerm WebConnect 37 Getting Started Guide
in place
3 On the Web server check ltPowerTerm WebConnect
rootgtwebwindowsptagentvertxt If the contents ldquolook wrongrdquo or
not in the proper form reinstall the PowerTerm WebConnect Web
components
4 On the client machine open the aforementioned URL in the
browser The file content should appear in the browser If it does
not it could be that the Web server is down
Web Server is
shut down
The webconnectxml configuration file must be located on the Web
server The explicit URL to this file is defined in the preferencesini
file (see Configure the Preferences File)
The error message contains the IP address of the Web server
Verify that the Web server on this machine is running
Version file
does not exist
on ltURLgt
See Version File reading error
The
configuration
file is not
accessible or
has a wrong
format
The webconnectxml configuration file must be located on the Web
server and the explicit URL to the configuration must be defined in
the preferencesini file (see Configure the Preferences File)
Try to open the URL specified in the error message in the
browser If it does not open then it either does not exist or it has
a wrong format
Preferences
file does not
exist in the
application
bundle
The preferencesini file containing the URL to the configuration
file was removed from the update site folder
Uninstall the current PowerTerm WebConnect client from the
client machine Create a new customized package (see
PowerTerm WebConnect Client Configuration) and reinstall it
Configuration
file URL is not
defined in
preference
file
The URL to the configuration file does not appear in the
preferencesini file (see Configure the Preferences File)
Uninstall the current PowerTerm WebConnect client from the
client machine Create a new customized package (see
PowerTerm WebConnect Client Configuration) and reinstall it
No IP address
could be
found for the
host
The Web server URL specified in the preferencesini file (see
Configure the Preferences File) or in the webconnectxml file (see
Configure the PowerTerm WebConnect Client) is an unknown
host
If the mistake is in the preferencesini file uninstall the current
PowerTerm WebConnect client from the client machine Create a
new customized package (see PowerTerm WebConnect Client
Configuration) and reinstall it
PowerTerm WebConnect 38 Getting Started Guide
If the mistake is in the webconnectxml file correct the file reopen
the Lotus Expeditor client
Cannot write
to destination
The temporary file cannot be written to the defined destination
Check the write permissions
Copied
configuration
file has wrong
format
The webconnectxml file as received from the specified URL has a
wrong format Correct the file and try again
PowerTerm
WebConnect
Agent URL is
malformed
The PowerTerm WebConnect Agent URL specified in the
webconnectxml file (see Configure the PowerTerm WebConnect
Client) does not have a proper HTTP format Correct the file and
try again
PowerTerm
WebConnect
Agent URL is
not defined
The PowerTerm WebConnect Agent URL parameter is not specified
in the webconnectxml file (see Configure the PowerTerm
WebConnect Client)
Correct the file and try again
The specified
destination
folder name
is wrong
The destination folder name contains illegal characters
ltgt|
Check the dst parameter in the webconnectxml file Correct the
file and try again
You do not
have
permissions
to write to
ltpathgt
The PowerTerm WebConnect Agent cannot be written to the
destination as defined Check the write permissions
The default destination defined in the version file should not to
be changed
A customized destination for PowerTerm WebConnect Agent
downloading can be defined in the webconnectxml file (See
Configure the PowerTerm WebConnect Client)
Check the destination value correct and try again
PowerTerm WebConnect 39 Getting Started Guide
About Ericom
Ericomreg Software is a leading provider of Application Access and Virtualization Solutions
Since 1993 Ericom has been helping users access enterprise mission-critical applications
running on a broad range of Microsoftreg Windowsreg Terminal Servers virtual Desktops
Blade PCs legacy hosts and other systems Ericom provides concrete business value by
helping organizations realize the benefits of their IT investments With offices in the United
States United Kingdom EMEA India and China Ericom also has an extensive network of
distributors and partners throughout North America Europe Asia and the Far East Our
expanding customer base is more than 30 thousand strong with over 7 million
installations
For more information on our products and services contact us at the location nearest to you
And visit our web site httpwwwericomcom
North America Western Europe International
Ericom Software Inc Ericom Software (UK) Ltd Ericom Software Ltd
231 Herbert Avenue Bldg 4 11a Victoria Square 8 Hamarpeh Street
Closter NJ 07624 USA Droitwich Worcestershire Har Hotzvim Technology Park
Tel +1 (201) 767 2210 WR9 8DE United Kingdom Jerusalem 91450 Israel
Fax +1 (201) 767 2205 Tel +44 (0) 845 644 3597 Tel +972 (2) 591 1700
Toll-free 1 (888) 769 7876 Fax +44 (0) 845 644 3598 Fax +972 (2) 571 4737
Email infoericomcom Email infoericomcouk Email infoericomcom
PowerTerm WebConnect 16 Getting Started Guide
16 Click Finish The published application appears in the Connection List
Right-click Properties or double click on the published application in the
Connections list to modify any of the settings which you previously defined
32 Create Terminal Emulation Connections
To provide access to legacy host systems you will need to create Terminal Emulation
connections For each such connection you can specify the host address emulation type
login script and more Once you have created these connections users will be able to
launch them using HostView (Windows or Linux) WebView or the Java client as
appropriate
1 Click Create a Host Connection in the Welcome screen The Add Connection dialog
appears
2 Enter a Name for the new connection
3 Specify an Owner for the new connection The possibilities are
[None] the connection will not be allowed to run by anyone and it will not be
displayed in any Connection list Server the connection will be accessible for all users of this PowerTerm
WebConnect server A specific group the connection will be accessible for all users of the specified
group A specific user the connection will be accessible for a specified user only
4 Leave category Terminal Emulation selected
5 Select Terminal Type Terminal Model and Communication Type as needed
6 Specify the Host Name or IP address of your host
7 Specify other parameters as needed
8 Select the Security Type as needed if your host supports SSL or SSH and specify
the appropriate details in the Details dialog
9 Use the Settings Key Mapping and Power Pad options to further customize the
connection
10 Click OK and the connection is created
33 Test Connections
It is recommended to test published applications or host connections before they are made
available to end-users
To test a connection
bull Right-click the target connection from the Connection section of the main screen and
select Test
Alternatively
PowerTerm WebConnect 17 Getting Started Guide
1 Select Tools | Run ltdesired clientgt The Login to WebConnect dialog appears
2 Enter the User Name and Password for the individual who owns the connection that
you want to test and click Login The desired PowerTerm WebConnect client is started
and the Connect dialog appears
3 Select the desired connection and click Connect The test is executed
34 Launch the Application Zone or the Application Portal
Users can access the published applications from the Application Zone application launcher
or from the Application Portal web interface
To use the Application Zone go to Start menuProgramsEricom SoftwarePowerTerm
WebConnect 5x and select Client URLs Alternatively type the following URL into your Web
browserrsquos address bar httpltserver addressgtWebConnect5xClientURLshtml In the
page that opens click on the Run button next to the Application Zone to launch it
To use the Application Portal go to Start menuProgramsEricom SoftwarePowerTerm
WebConnect 5x and select it Alternatively type the following URL into the Web browserrsquos
address bar httpltserver addressgtWebConenct5xportalwindowsindexasp
35 Monitor a Users Sessions
From the Administration Tool you can monitor the users sessions and may intervene if
necessary This intervention may result in your input appearing on the users screen The
user receives a notification when an administrator begins and ends monitoring the session
1 Select View | Client Sessions or click to see all the active client sessions
2 Select the desired active session and right-click Attach The Password Verify dialog
appears
3 Enter your password and click OK Some notification dialogs appears and the selected
PowerTerm WebConnect session is viewed
36 View Intruders
bull The Intruders window shows suspected attempts at breaching security After several
suspected intrusion attempts users are blocked temporarily
bull In addition to showing suspected intrusion attempts the Intruders window allows
you to remove restrictions on users
bull Select View | All Intruders or click
PowerTerm WebConnect 18 Getting Started Guide
4 Accessing Virtual Desktops and Blade PCs with PowerTerm WebConnect
This chapter provides instructions on configuring PowerTerm WebConnect for Virtual
Desktop Infrastructure (VDI)
41 Step 1 Launch DeskView Administration Tool
Verify that PowerTerm WebConnect is installed on your server and launch PowerTerm
WebConnect Admin Tool
bull Select Tools | Open VDI Manager The PowerTerm WebConnect DeskView Administration
Tool opens
The first time you launch the DeskView Administration Tool you will be prompted to install
the tool
PowerTerm WebConnect 19 Getting Started Guide
Microsoft Management Console 30 is required for PowerTerm WebConnect DeskView
Administration Tool If you do not have this installed you will also automatically be
prompted to install this update
Follow the installation processes when you are prompted for either install PowerTerm
WebConnect DeskView Administration Tool will automatically launch when these
installations are completed
42 Step 2 Add a Host
1 Right-click Virtualization Hosts and select Add Host The Add a New Host wizard
opens Click Next
2 Enter a Host Name as you would like it to appear in PowerTerm WebConnect
DeskView Administration Tool and a description (optional) Click Next
3 Specify the Virtualization Server type and click Next
4 Specify the connection information and click Next
VMWare Virtual Center v1x and 2x
Specify the HTTPS Web Service address and a UsernamePassword that can access
the host
VMWare Virtual Server 2005
Click Start and then Run
Type ldquoservicesmscrdquo and click OK
Scroll down to PowerTerm WebConnect DeskView Server service and open
Properties
Change the Login Account for the service to match the Domain Administrator
account and password used when setting up Microsoft Virtual Server 2005 and
restart the service Enter the IP or NETBIOS name of the Microsoft Virtual Server 2005 server as the
Server Address in the Connection Broker Wizard
Xen Server
Specify the hypervisor IP address or NETBIOS name the Root UsernamePassword
to the hypervisor and the Service port (default 80)
Oracle VM
Specify the Serverrsquos agent URL and Port (default 8899) for example
httpsltservernamegt8899
Specify the Oracle VM hypervisorrsquos Oracle Agent UsernamePassword (default
username oracle)
5 Click Finish to add the new Host
To configure Virtual Machines for use install the Ericom Tools (vmagentmsi) on each of the
virtual machines on the new host for PowerTerm WebConnect DeskView to recognize them
The vmagentmsi installer is located on the PowerTerm WebConnect server in ltPowerTerm
WebConnect installation foldergtAddOnsDeskView VDI folder (default installation
PowerTerm WebConnect 20 Getting Started Guide
folder is xProgram FilesEricom SoftwareWebConnect 56) During installation you
will need to enter the DeskView IP address or NETBIOS name
If you are using Microsoft Virtual Server 2005 as your Virtualization Host use the
IP address of the DeskView server only when installing the Ericom Tool package
43 Step 3 Create a Pool
Pools are used to organize Virtual Machines (VM) into logical groups This enables
organizations to combine and order resources from multiple systems into one entity To
access available resources end-users simply connect to PowerTerm WebConnect to access
any configured resource
1 Right-click Pools and select Create Pool The Create a Pool wizard opens Click
Next
2 Enter a Pool name as you wish it to appear and a description (optional) and click
Next
3 Specify the Pool type and click Next
4 Specify the Assignment type and click Next
Permanently will cause a virtual machine to affix to the user who has launched
that virtual machine For the duration of the session will cause any virtual machine that is not in use to
be returned to the pool for any user to launch
5 Specify the LogoffDisconnect event and click Next
Select what you would like to happen after a user logs off from a virtual machine
in this pool
Select what you would like to happen when a user is disconnected from a virtual
machine in this pool
6 Click Finish to add the new Pool
You will need to assign virtual machines from your virtualization hosts to your created pool
1 Right-click the pool and select Assign Machines The Assign Machines to ltyour
pool namegt dialog opens
2 Highlight the desired virtual machine(s) and click Select Click OK
44 Step 4 Publish an ApplicationDesktop
1 Return to PowerTerm WebConnect Admin Tool to publish DeskView pools
2 Determine whether to publish a full desktop or a seamless application running
from a virtual desktop
For a full desktop
Select Action | New | Remote Windows Desktop
For a seamless application
Select Action | New | Windows Application
PowerTerm WebConnect 21 Getting Started Guide
3 Select Virtual Desktop in the first step of the wizard and click Next
4 Follow the wizardrsquos instructions until you reach the Virtual Desktops step
5 Select a pool that you previously created and that you would like this connection to choose virtual machines from Click Next
6 Continue and complete the reminder of the wizardrsquos steps
Once the resource is published users who have been assigned access will be able to use it
immediately
PowerTerm WebConnect 22 Getting Started Guide
5 Download and Run PowerTerm WebConnect Clients
PowerTerm WebConnect clients are automatically downloaded and installed onto the client
devices For detailed information and samples please refer to the PowerTerm WebConnect
Sample URLs page To see this page navigate your browser to
httpltweb_servergtWebConnect5xClientURLshtml
PowerTerm WebConnect 23 Getting Started Guide
6 PowerTerm WebConnect Client for Lotus Expeditor
61 Installation Package
PowerTerm WebConnect client for Lotus Expeditor is provided to IBM in an Update Site
package This is a ZIP archive containing the Update Site with the Eclipse feature and plug-
in that comprises the PowerTerm WebConnect client
Extract the ZIP file keeping the foldersrsquo structure intact
NOTE In Winzip verify that the ldquoUse folder namesrdquo option is set to TRUE
Package structure
Update Site
- plugins
- PowerTermWebConnectClient_560365jar
- features
- comericomWebConnect_560365jar
- sitexml
config
- webconnectxml
Definitions
bull webconnectxml PowerTerm WebConnect client configuration file
bull comericomWebConnect_560365jar PowerTerm WebConnect client feature file
bull PowerTermWebConnectClient_560365jar PowerTerm WebConnect client plugin file
62 Pre-installation steps
PowerTerm WebConnect client for Lotus Expeditor does not run independently but in
conjunction with PowerTerm WebConnect Server You can either install it and define your
users groups and applications or use Ericom Softwarersquos Demo PowerTerm WebConnect
Server
bull If you decide to install PowerTerm WebConnect Server you will need the full
installation ie the PowerTerm WebConnect Server and the Web components If you
do not have the installation CD you can download and install a trial version from
wwwericomcom
PowerTerm WebConnect 24 Getting Started Guide
bull If you decide to use Ericom Softwarersquos Demo PowerTerm WebConnect Server then
skip to the chapter Installing PowerTerm WebConnect Client on Lotus Expeditor
63 Install PowerTerm WebConnect Portlet on IBM Workplace server (for Windows OS)
Step 1 Install PowerTerm WebConnect Server
If PowerTerm WebConnect Server and IBM Workplace Server are on separate machines
bull Configure PowerTerm WebConnect Server
Launch PowerTerm WebConnect Administration Tool
Open Files | Configuration | Main
In the [Portal] section edit
Machines=localhostltIBM sever machinegt
bull Configure PowerTerm WebConnect Web components
Copy the ldquowebrdquo folder from the PowerTerm WebConnect server installation to the
IBM Workplace server machine
Create an Alias or a Virtual directory to it named WebConnect on the Web
server providing access to it for the users This is in order to enable the users to
download the necessary files to run their applications
Step 2 Enable JSR portlets
1 On IBM Workplace Server go to ltPortalServergtsharedappconfigservicesConfigServiceproperties
2 Edit portalenablejsr168=true
3 Save and close the file
Step 3 Enable SSO
1 On IBM Workplace Server go to ltPortalServergtsharedappconfigservicesLoaderServiceproperties
2 Edit commandpath=comericomportalcommandscomibmwpsenginecommands
3 Save and close the file
Step 4 Copy Files
The following files need to be copied from WebConnect ServerAddOnsIBM
WorkplacePortlet folder to IBM Workplace Server
File name to copy Destination folder
OpenSSLdll ltAppServergtjavajrebin
IbmPortaldll ltAppServergtjavajrebin
IbmPortalini ltAppServergtjavajrebin
PowerTerm WebConnect 25 Getting Started Guide
WebConnectPortaljar ltAppServergtlib
EricomLoginjar ltPortalServergtsharedapp
Step 5 Portlet Configuration
1 On IBM Workplace Server go to ltAppServergtjavajrebinIbmPortalini
2 You can modify the following parameters in the [Server=WebConnect] section webserverport=ltIBM web server portgt
Specifies the Web server port for accessing the PowerTerm WebConnect clients folder
Default 80 Address
Specifies the address of the PowerTerm WebConnect Server machine for Portlet to
connect to when PowerTerm WebConnect Server is located on a different machine
than the IBM Workplace Server CustomAddress
Specifies the addresss of the PowerTerm WebConnect Server machine for Clients to connect to If CustomAddress is the same as Address then this may be omitted webserveraddr
Specifies the address of the Web Server machine when it is located on a different
machine than the IBM Workplace Server
3 Restart the IBM server ltPortalServergtrootscriptsstopWorkplaceServicesbat ltPortalServergtrootscriptsstartWorkplaceServicesbat
This procedure may take about 20 minutes
Step 6 Install the Portlet
1 In a Web browser open the URL httpltIBM Workplace
Servergt9081lwpmyworkplace to open the IBM Workplace Portal
2 Login as administrator
3 Go to Administration | Portlets | Install
4 Browse to the PowerTerm WebConnectwar file located on PowerTerm WebConnect
Server and click Next
5 Click Install
Step 7 Create an Application page
1 Login to the Workplace
2 Go to Portal User Interface | Manage Pages
3 Search for My Work
4 Click the My Work link and select New Page
5 Name the page PowerTerm WebConnect and click OK
6 Click OK again You will see the created page on the list
7 Click the pencil icon on the new page and select the 1 square layout
PowerTerm WebConnect 26 Getting Started Guide
8 Click Add Portlet and search for PowerTerm WebConnect
9 Select it and click OK
10 Click Done
11 Click My work at the top of the page PowerTerm WebConnect is displayed on the list
Step 8 Run the Portlet
1 Restart IBM Workplace Server
2 Open IBM Workplace Portal in a browser httpltportal servergtlwpmyworkplace
3 Login to IBM Workplace Server
4 Click My work PowerTerm WebConnect portlet is displayed
5 Launch it The Userrsquos applications as defined on PowerTerm WebConnect Server
appear
6 Click an application to launch it
64 Install PowerTerm WebConnect Portlet on IBM Workplace server (for Linux OS)
Step 1 Enable JSR 168 portlets
1 Go to optIBMWorkplacePortalServersharedappconfigservicesConfigServiceproperties
2 Modify the portalenablejsr168 property to ldquotruerdquo
3 Restart the server cd optIBMWorkplacePortalServerrootscripts
Run stopWorkplaceServicessh
Run startWorkplaceServicessh
This procedure can take up to 20 minutes
4 Log on to the workplace server at httpltworkplace servergt9081lwpmyworkplace using
the administrators username and password
Step 2 Install the portlet
1 Restart IBM Workplace Server
2 In a Web browser open the URL httpltworkplace server IPgtlwpmyworkplace
3 Login to IBM Workplace Server as an administrator
4 Go to Administration | Portlets | Install
5 Browse to the PowerTerm WebConnectwar file located on PowerTerm WebConnect
Server and click Next
6 Click Install
PowerTerm WebConnect 27 Getting Started Guide
Step 3 Install the Application page
1 Login to the workplace as administrator
2 Go to Administration | Portal User Interface | Manage Pages
3 Search for My Work
4 Click the My Work link and select New Page
5 Name the page PowerTerm WebConnect and click OK
6 Click OK again You will see the created page on the list
7 Click the pencil icon and select the 1-square layout
8 Click Add Portlet and search for PowerTerm WebConnect
9 Select it and click OK
10 Click Done
11 Click My work on top and PowerTerm WebConnect is displayed on the left bar
Step 4 Run the portlet
1 Restart IBM Workplace Server
2 Open IBM Workplace Portal in a browser httpltportal servergtlwpmyworkplace
3 Login to IBM Workplace Server
4 Click My work PowerTerm WebConnect portlet is displayed
5 Launch it The Userrsquos applications as defined on PowerTerm WebConnect Server
appear
6 Click an application to launch it
65 Install PowerTerm WebConnect Portlet on IBM WebSphere 61 server (for Windows OS)
Step 1 Install PowerTerm WebConnect Server
You have to configure PowerTerm WebConnect Server if it and the IBM WebSphere Server
are on separate machines
1 Launch PowerTerm WebConnect Administration Tool
2 Open Files | Configuration | Main
3 In the [Portal] section edit Machines=localhostltIBM sever machinegt
Step 2 Copy Files
The following files need to be copied from WebConnect ServerAddOnsIBM
WebSpherePortlet folder to IBM WebSphere Server
PowerTerm WebConnect 28 Getting Started Guide
File name to copy Destination folder
OpenSSLdll ltAppServergtjavajrebin
IbmPortaldll ltAppServergtjavajrebin
IbmPortalini ltAppServergtjavajrebin
WebConnectPortaljar ltAppServergtlib
Step 3 Portlet Configuration
1 On IBM Workplace Server go to ltAppServergtjavajrebinIbmPortalini
2 You can modify the following parameters in the [Server=WebConnect] section webserverport=ltIBM web server portgt
Specifies the Web server port for accessing the PowerTerm WebConnect clients folder
Default 80 Address
Specifies the address of the PowerTerm WebConnect Server machine for Portlet to
connect to when PowerTerm WebConnect Server is located on a different machine
than the IBM Workplace Server CustomAddress
Specifies the addresss of the PowerTerm WebConnect Server machine for Clients to connect to If CustomAddress is the same as Address then this may be omitted webserveraddr
Specifies the address of the Web Server machine when it is located on a different
machine than the IBM Workplace Server
3 Restart the IBM server ltAppServergtProfilesAppServer01binstopServerbat ltAppServergtProfilesAppServer01binstartServerbat
This procedure may take about 20 minutes
Step 4 Install the Portlet and create an Application page
1 In a Web browser open the URL httpltIBM WebSphere Servergt9060ibmconsole
to open the IBM WebSphere Portal
2 Login and go to Applications | Install New Application
3 Browse to the PowerTerm WebConnectwar file located on PowerTerm WebConnect
Server
4 Enter Context root and click Next The Select installation options dialog appears
5 Optional change options to your preference or keep the default
6 Click Next
7 Select Ericom in the Module column click Apply and then Next
8 Click Finish and then Save
9 Select Applications | Enterprise Applications
10 Select PowerTerm WebConnectwar checkbox and click Start
PowerTerm WebConnect 29 Getting Started Guide
11 Enter in the Web browser the URL httpltIBM WebSphere
Servergt9080ltContext rootgtEricom portlet The Login dialog appears
12 Login and you will see PowerTerm WebConnect displayed on the list
Step 5 Run the Portlet
1 Restart IBM WebSphere Server
2 Open IBM WebSphere Portal in a browser httpltportal servergt9080ltContext
rootgtEricom portlet
3 Login to IBM WebSphere Server
4 Launch it The Userrsquos applications as defined on PowerTerm WebConnect Server
appear
5 Click an application to launch it
66 PowerTerm WebConnect Server Configuration
bull To enable the Lotus Expeditor to run the PowerTerm WebConnect client the
System Administrator must provide the users with accounts on PowerTerm
WebConnect Server (see the PowerTerm WebConnect Administratorrsquos Manual for
instructions on how to create users groups and connections on the PowerTerm
WebConnect Server)
bull To enable PowerTerm WebConnectrsquos Single Sign-On feature the System
Administrator must create a PowerTerm WebConnect user with the same
username and password as used for the Lotus Expeditor For a managed Lotus
Expeditor the credentials used are the username and password sent to the
managing server For an unmanaged Lotus Expeditor the operation system
username and the Lotus Expeditor password are used as credentials
NOTE If a password is not defined then the Single Sign-On will fail and the user will be
prompted with a login dialog
67 PowerTerm WebConnect Client Configuration
The PowerTerm WebConnect client is configured in webconnectxml located in the config
folder webconnectxml parameters are
url The PowerTerm WebConnect Agent url
server The PowerTerm WebConnect Server address
sso The Single Sign-On feature
dst The local destination for downloading PowerTerm WebConnect
components
PowerTerm WebConnect 30 Getting Started Guide
url
PowerTerm WebConnect components are installed on a Web server Their default url is
Windows Agent
httpltWebServer IPgtWebConnectwindowsptagentcab
Linux Agent
httpltWebServer IPgtWebConnectlinuxix86qterm-wczip
The url parameter must include the first part of the url (which is identical for both Windows
and Linux agents)
The PowerTerm WebConnect client will automatically append the appropriate suffix in
order to create a full accurate url
Example
ltitem key=rdquourlrdquo value=httpadminserverWebConnectgt
server
The computer name or IP address of the PowerTerm WebConnect Server machine
The PowerTerm WebConnect client will log in to this PowerTerm WebConnect Server
display the applications defined on it and run them according to this serverrsquos configuration
Format ltserver IPgt[ltportgt]
where default port is 4000 (can be edited)
Example
ltitem key=rdquoserverrdquo value=rdquoadmin24000rdquogt
sso
Determines whether Single Sign-on will be used to log in to PowerTerm WebConnect
Server Values
bull True (default) the client should automatically log in to the PowerTerm WebConnect
Server using the same credentials as the ones used to log in to the Lotus Expeditor
client
The System Administrator must verify that these credentials can log in to the
PowerTerm WebConnect Server
bull False the user will be prompted with a login dialog or will log in automatically using
previously saved credentials
Example
ltitem key=rdquossordquo value=rdquotruerdquogt
Autologin mode
PowerTerm WebConnect 31 Getting Started Guide
If sso is set to True the user is not prompted for credentials and the login process to
PowerTerm WebConnect Server is done automatically sending the credentials used for the
Lotus Expeditor unless the Lotus Expeditor does not have a password defined (In the
Lotus Expeditor preferences page | Password| Prompt me for a password at start up checkbox)
However if Single Sign-on is not used there are several options regarding Autologin that
can be defined in the PowerTerm WebConnect Preferences page Options
bull Yes
bull No
bull Interactive
bull First time interactive (default) ndash Simplifies the login process to PowerTerm
WebConnect Server In this mode the first time the user logs in to PowerTerm
WebConnect Server he will be prompted for his credentials with the Login dialog
These credentials will be stored in the machine and from then on the login process to
PowerTerm WebConnect Server will be done automatically
1 Open File | Preferences from the Lotus Expeditor and select PowerTerm WebConnect
2 In the Autologin to WebConnect Server section select First Interactive and click OK
3 Start PowerTerm WebConnect Client for Lotus Expeditor If credentials were entered
at least once then the next time the client will connect to PowerTerm WebConnect
Server without prompting for the user name and password
The Administrator must configure the Agent to do nothing when it exits for the
feature to work this way See PowerTerm WebConnect Administratorrsquos Manual for more information about defining Autologin
bull Allow multiple selection ndash Defines whether the user can launch more than one
application at a time (by using the ltCtrlgt or ltShiftgt button while selecting applications)
dst
Defines the path to download PowerTerm WebConnect components on the client machine
The dst parameter can contain macros which are translated by the PowerTerm WebConnect
Client for Lotus Expeditor during runtime The macros should be placed between percent
symbols () for example WebServer
When such a value is defined the PowerTerm WebConnect Client for Lotus Expeditor
substitutes the entire expression for the macrorsquos value
The PowerTerm WebConnect Client for Lotus Expeditor does not support the use
of environment variables as macros
Macros are not case sensitive
Macros supported by PowerTerm WebConnect Client for Lotus Expeditor
Macro name Description
WebServer The name of the Web server
It is obtained from the PowerTerm WebConnect Agent url
PowerTerm WebConnect 32 Getting Started Guide
parameter
Name The name of the clientrsquos CAB or ZIP file eg ldquoptagentrdquo
Display The clientrsquos display name from the version file
Version The clientrsquos version value It is obtained from the version
file
Root The default root location
Windows ldquoCrdquo
LinuxUnix an empty string
OSDir Windows Windowsrsquo installation directory for example
ldquoCWindowsrdquo
Linux an empty string
OSDrive Windows Windowsrsquo installation drive for example ldquoCrdquo
Linux an empty string
HomePath Windows The HOMEPATH environment variable
Linux The HOME environment variable
Home The Ericom folder in the userrsquos home directory
Windows CDocuments and SettingsltusergtApplication
DataEricom
Linux ltusergtEricom
In addition to the predefined macros listed above the PowerTerm WebConnect client
supports the usage of Java System Properties
Java System Properties available for users on Windows XP SP2
Java System Property Name Value Example
javaversion 150
javavendorurl httpwwwibmcom
javahome CIBMcommonpluginscomibmpvcwctruntim
esj2sewin32x86_150SR2-
20060511rcpeclipsepluginscomibmrcpj2sew
in32x86_150SR2-20060511jre
javavmspecificationversion 10
javavmversion 23
javavmvendor IBM Corporation
javavmname IBM J9 VM
PowerTerm WebConnect 33 Getting Started Guide
javaiotmpdir CDOCUME~1dianaLOCALS~1Temp
javacompiler j9jit23
javaextdirs CIBMcommonpluginscomibmpvcwctruntim
esj2sewin32x86_150SR2-
20060511rcpeclipsepluginscomibmrcpj2sew
in32x86_150SR2-20060511jrelibext
osname Windows XP
osarch x86
osversion 51 build 2600 Service Pack 2
pathseparator
username Jone
userhome CDocuments and SettingsJone
userdir CIBMRSA
usertimezone GMT+0200
System properties available for users on Linux RedHat 9
Java System Property Name Value Example
javaversion 150
javavendorurl httpwwwibmcom
javahome usrjavajre150_07
javavmversion 150
javavmvendor IBM Corporation
javavmname IBM J9 VM
javaclasspath
javalibrarypath
javaiotmpdir tmp
javacompiler
javaextdirs
osname Linux
osarch i386
osversion 2420-8
pathseparator
PowerTerm WebConnect 34 Getting Started Guide
username root
userhome root
userdir root
System properties names are placed in the configuration file within percent symbols ()
(like macros)
671 Configure the PowerTerm WebConnect Client
1 Open the Config Folder and edit the webconnectxml file Example
ltxml version =rdquo10rdquo encoding=rdquoUTF-8rdquogt
ltsection name=rdquoparametersrdquogt
ltitem key=rdquourlrdquo value=httpadminserverWebConnect56gt
ltitem key=rdquoserverrdquo value=rdquoadmin24000rdquogt
ltitem key=rdquossordquo value=rdquotruerdquogt
ltitem key=rdquodestrdquo value=rdquoCProgram FilesEricomrdquogt
ltsectiongt
2 Save the customized webconnectxml to a Web server folder available to all users It is
recommended to use the same Web server as the PowerTerm WebConnect Agent
Example
ltWebConnect installation foldergtwebwebconnectxml
3 Test the accessibility to this file - Type the URL of webconnectxml in the browser
Example
httpltWebServer IPgtWebConnectwebconnectxml
The contents of the file should be displayed
672 Configure the Preferences File
1 Open the plugins folder and open the PowerTermWebConnectClient_560365jar file
You can use Winzip version 70 and up or in Windows XP ndash Create a new file type for the
jar extension click advanced and select compressed (zipped) folder in the drop down list
Now you can open the JAR files in the Windows Explorer
The default contents of the file
configURL=httpleericomcomWebConnectwebconnectxml
2 Specify the accurate URL of the webconnectxml file Example
httpltWebServer IPgtWebConnectwebconnectxml
3 Save the file and close it The WinZip will display the following dialog
ldquoFile preferencesini has been changed since it was extracted Update archive
with this filerdquo
PowerTerm WebConnect 35 Getting Started Guide
4 Click Yes and close the archive
If you are editing the file from within the explorer you will have to save the file elsewhere
and then drag it to the explorer window where the JAR file is open
68 Installing PowerTerm WebConnect Client on Lotus Expeditor
1 Start the Lotus Expeditor client
2 Select File | Application | Install
3 Select Search for new features to install and click Next
4 Select Add Folder Location and type or select the location of the update site folder from
the provided package Click OK
5 Select the location you have just created and click Finish
6 In the Select the feature to install tree select Powerterm WebConnectUpdate Site Click
Next
7 Select I accept the terms in the license agreements and click Next
8 Click Finish
9 When prompted restart the platform
69 Running PowerTerm WebConnect Client for Lotus Expeditor
1 Click Open The PowerTerm WebConnect option is displayed
2 Select PowerTerm WebConnect The application will automatically connect and start
downloading the components from PowerTerm WebConnect Server
IMPORTANT
If you did not install PowerTerm WebConnect Server and are instead connecting to Ericom
Softwarersquos Demo WebConnect Server then you need to open port 443 in the firewall
691 PowerTerm WebConnect Client Workflow
1 PowerTerm WebConnect client reads the URL of webconnectxml from the preferencesini
file and requests it
2 When the webconnectxml is successfully downloaded the application reads the
configuration connects to the specified Web server downloads the PowerTerm
WebConnect components and connects to the PowerTerm WebConnect Server
3 The user is requested to login to the PowerTerm WebConnect Server For testing you
can use the username Example and password example
This step will be skipped if Single Sign-on is set to ldquotruerdquo
PowerTerm WebConnect 36 Getting Started Guide
4 After logging in to PowerTerm WebConnect Server the userrsquos applications are displayed
as defined by the administrator
5 To run an application select the desired application from the list and click Launch or
double-click the application The application will be launched in a separate window
610 Troubleshooting
When you encounter a problem the first step is to open the log file This file is located on
the client machine in the Ericom folder
Windows
CDocuments and SettingsltusernamegtEricomleclientEricomPluginlog
Linux
ltuser-home-directorygtEricomleclientEricomPluginlog
Following is a guide for diagnosing and fixing the problems in cases of error messages and
additional information
Error
Message
Solution
Version File
reading error
1 Check the lsquourlrsquo parameter in the webconnectxml file on the Web
server The value should be
httpltWebServerIPgtWebConnect
2 Try to run the following URL on the browser
Windows
httpltWebServerIPgtWebConnectwindowsptagentvertxt
Linux
httpltWebServerIPgtWebConnectlinuxix86qterm-
wcvertxt
The file contents displayed in the browser window should be in
the following form
560-rel14546
PowerTerm WebConnect Application Zone
560 - Main Release
ltrootgtPowerTerm WebConnect 56ltWebServergt
If the version file contents are not as shown check
- Is the Web Server running
- Are PowerTerm WebConnect Web Components and version files
PowerTerm WebConnect 37 Getting Started Guide
in place
3 On the Web server check ltPowerTerm WebConnect
rootgtwebwindowsptagentvertxt If the contents ldquolook wrongrdquo or
not in the proper form reinstall the PowerTerm WebConnect Web
components
4 On the client machine open the aforementioned URL in the
browser The file content should appear in the browser If it does
not it could be that the Web server is down
Web Server is
shut down
The webconnectxml configuration file must be located on the Web
server The explicit URL to this file is defined in the preferencesini
file (see Configure the Preferences File)
The error message contains the IP address of the Web server
Verify that the Web server on this machine is running
Version file
does not exist
on ltURLgt
See Version File reading error
The
configuration
file is not
accessible or
has a wrong
format
The webconnectxml configuration file must be located on the Web
server and the explicit URL to the configuration must be defined in
the preferencesini file (see Configure the Preferences File)
Try to open the URL specified in the error message in the
browser If it does not open then it either does not exist or it has
a wrong format
Preferences
file does not
exist in the
application
bundle
The preferencesini file containing the URL to the configuration
file was removed from the update site folder
Uninstall the current PowerTerm WebConnect client from the
client machine Create a new customized package (see
PowerTerm WebConnect Client Configuration) and reinstall it
Configuration
file URL is not
defined in
preference
file
The URL to the configuration file does not appear in the
preferencesini file (see Configure the Preferences File)
Uninstall the current PowerTerm WebConnect client from the
client machine Create a new customized package (see
PowerTerm WebConnect Client Configuration) and reinstall it
No IP address
could be
found for the
host
The Web server URL specified in the preferencesini file (see
Configure the Preferences File) or in the webconnectxml file (see
Configure the PowerTerm WebConnect Client) is an unknown
host
If the mistake is in the preferencesini file uninstall the current
PowerTerm WebConnect client from the client machine Create a
new customized package (see PowerTerm WebConnect Client
Configuration) and reinstall it
PowerTerm WebConnect 38 Getting Started Guide
If the mistake is in the webconnectxml file correct the file reopen
the Lotus Expeditor client
Cannot write
to destination
The temporary file cannot be written to the defined destination
Check the write permissions
Copied
configuration
file has wrong
format
The webconnectxml file as received from the specified URL has a
wrong format Correct the file and try again
PowerTerm
WebConnect
Agent URL is
malformed
The PowerTerm WebConnect Agent URL specified in the
webconnectxml file (see Configure the PowerTerm WebConnect
Client) does not have a proper HTTP format Correct the file and
try again
PowerTerm
WebConnect
Agent URL is
not defined
The PowerTerm WebConnect Agent URL parameter is not specified
in the webconnectxml file (see Configure the PowerTerm
WebConnect Client)
Correct the file and try again
The specified
destination
folder name
is wrong
The destination folder name contains illegal characters
ltgt|
Check the dst parameter in the webconnectxml file Correct the
file and try again
You do not
have
permissions
to write to
ltpathgt
The PowerTerm WebConnect Agent cannot be written to the
destination as defined Check the write permissions
The default destination defined in the version file should not to
be changed
A customized destination for PowerTerm WebConnect Agent
downloading can be defined in the webconnectxml file (See
Configure the PowerTerm WebConnect Client)
Check the destination value correct and try again
PowerTerm WebConnect 39 Getting Started Guide
About Ericom
Ericomreg Software is a leading provider of Application Access and Virtualization Solutions
Since 1993 Ericom has been helping users access enterprise mission-critical applications
running on a broad range of Microsoftreg Windowsreg Terminal Servers virtual Desktops
Blade PCs legacy hosts and other systems Ericom provides concrete business value by
helping organizations realize the benefits of their IT investments With offices in the United
States United Kingdom EMEA India and China Ericom also has an extensive network of
distributors and partners throughout North America Europe Asia and the Far East Our
expanding customer base is more than 30 thousand strong with over 7 million
installations
For more information on our products and services contact us at the location nearest to you
And visit our web site httpwwwericomcom
North America Western Europe International
Ericom Software Inc Ericom Software (UK) Ltd Ericom Software Ltd
231 Herbert Avenue Bldg 4 11a Victoria Square 8 Hamarpeh Street
Closter NJ 07624 USA Droitwich Worcestershire Har Hotzvim Technology Park
Tel +1 (201) 767 2210 WR9 8DE United Kingdom Jerusalem 91450 Israel
Fax +1 (201) 767 2205 Tel +44 (0) 845 644 3597 Tel +972 (2) 591 1700
Toll-free 1 (888) 769 7876 Fax +44 (0) 845 644 3598 Fax +972 (2) 571 4737
Email infoericomcom Email infoericomcouk Email infoericomcom
PowerTerm WebConnect 17 Getting Started Guide
1 Select Tools | Run ltdesired clientgt The Login to WebConnect dialog appears
2 Enter the User Name and Password for the individual who owns the connection that
you want to test and click Login The desired PowerTerm WebConnect client is started
and the Connect dialog appears
3 Select the desired connection and click Connect The test is executed
34 Launch the Application Zone or the Application Portal
Users can access the published applications from the Application Zone application launcher
or from the Application Portal web interface
To use the Application Zone go to Start menuProgramsEricom SoftwarePowerTerm
WebConnect 5x and select Client URLs Alternatively type the following URL into your Web
browserrsquos address bar httpltserver addressgtWebConnect5xClientURLshtml In the
page that opens click on the Run button next to the Application Zone to launch it
To use the Application Portal go to Start menuProgramsEricom SoftwarePowerTerm
WebConnect 5x and select it Alternatively type the following URL into the Web browserrsquos
address bar httpltserver addressgtWebConenct5xportalwindowsindexasp
35 Monitor a Users Sessions
From the Administration Tool you can monitor the users sessions and may intervene if
necessary This intervention may result in your input appearing on the users screen The
user receives a notification when an administrator begins and ends monitoring the session
1 Select View | Client Sessions or click to see all the active client sessions
2 Select the desired active session and right-click Attach The Password Verify dialog
appears
3 Enter your password and click OK Some notification dialogs appears and the selected
PowerTerm WebConnect session is viewed
36 View Intruders
bull The Intruders window shows suspected attempts at breaching security After several
suspected intrusion attempts users are blocked temporarily
bull In addition to showing suspected intrusion attempts the Intruders window allows
you to remove restrictions on users
bull Select View | All Intruders or click
PowerTerm WebConnect 18 Getting Started Guide
4 Accessing Virtual Desktops and Blade PCs with PowerTerm WebConnect
This chapter provides instructions on configuring PowerTerm WebConnect for Virtual
Desktop Infrastructure (VDI)
41 Step 1 Launch DeskView Administration Tool
Verify that PowerTerm WebConnect is installed on your server and launch PowerTerm
WebConnect Admin Tool
bull Select Tools | Open VDI Manager The PowerTerm WebConnect DeskView Administration
Tool opens
The first time you launch the DeskView Administration Tool you will be prompted to install
the tool
PowerTerm WebConnect 19 Getting Started Guide
Microsoft Management Console 30 is required for PowerTerm WebConnect DeskView
Administration Tool If you do not have this installed you will also automatically be
prompted to install this update
Follow the installation processes when you are prompted for either install PowerTerm
WebConnect DeskView Administration Tool will automatically launch when these
installations are completed
42 Step 2 Add a Host
1 Right-click Virtualization Hosts and select Add Host The Add a New Host wizard
opens Click Next
2 Enter a Host Name as you would like it to appear in PowerTerm WebConnect
DeskView Administration Tool and a description (optional) Click Next
3 Specify the Virtualization Server type and click Next
4 Specify the connection information and click Next
VMWare Virtual Center v1x and 2x
Specify the HTTPS Web Service address and a UsernamePassword that can access
the host
VMWare Virtual Server 2005
Click Start and then Run
Type ldquoservicesmscrdquo and click OK
Scroll down to PowerTerm WebConnect DeskView Server service and open
Properties
Change the Login Account for the service to match the Domain Administrator
account and password used when setting up Microsoft Virtual Server 2005 and
restart the service Enter the IP or NETBIOS name of the Microsoft Virtual Server 2005 server as the
Server Address in the Connection Broker Wizard
Xen Server
Specify the hypervisor IP address or NETBIOS name the Root UsernamePassword
to the hypervisor and the Service port (default 80)
Oracle VM
Specify the Serverrsquos agent URL and Port (default 8899) for example
httpsltservernamegt8899
Specify the Oracle VM hypervisorrsquos Oracle Agent UsernamePassword (default
username oracle)
5 Click Finish to add the new Host
To configure Virtual Machines for use install the Ericom Tools (vmagentmsi) on each of the
virtual machines on the new host for PowerTerm WebConnect DeskView to recognize them
The vmagentmsi installer is located on the PowerTerm WebConnect server in ltPowerTerm
WebConnect installation foldergtAddOnsDeskView VDI folder (default installation
PowerTerm WebConnect 20 Getting Started Guide
folder is xProgram FilesEricom SoftwareWebConnect 56) During installation you
will need to enter the DeskView IP address or NETBIOS name
If you are using Microsoft Virtual Server 2005 as your Virtualization Host use the
IP address of the DeskView server only when installing the Ericom Tool package
43 Step 3 Create a Pool
Pools are used to organize Virtual Machines (VM) into logical groups This enables
organizations to combine and order resources from multiple systems into one entity To
access available resources end-users simply connect to PowerTerm WebConnect to access
any configured resource
1 Right-click Pools and select Create Pool The Create a Pool wizard opens Click
Next
2 Enter a Pool name as you wish it to appear and a description (optional) and click
Next
3 Specify the Pool type and click Next
4 Specify the Assignment type and click Next
Permanently will cause a virtual machine to affix to the user who has launched
that virtual machine For the duration of the session will cause any virtual machine that is not in use to
be returned to the pool for any user to launch
5 Specify the LogoffDisconnect event and click Next
Select what you would like to happen after a user logs off from a virtual machine
in this pool
Select what you would like to happen when a user is disconnected from a virtual
machine in this pool
6 Click Finish to add the new Pool
You will need to assign virtual machines from your virtualization hosts to your created pool
1 Right-click the pool and select Assign Machines The Assign Machines to ltyour
pool namegt dialog opens
2 Highlight the desired virtual machine(s) and click Select Click OK
44 Step 4 Publish an ApplicationDesktop
1 Return to PowerTerm WebConnect Admin Tool to publish DeskView pools
2 Determine whether to publish a full desktop or a seamless application running
from a virtual desktop
For a full desktop
Select Action | New | Remote Windows Desktop
For a seamless application
Select Action | New | Windows Application
PowerTerm WebConnect 21 Getting Started Guide
3 Select Virtual Desktop in the first step of the wizard and click Next
4 Follow the wizardrsquos instructions until you reach the Virtual Desktops step
5 Select a pool that you previously created and that you would like this connection to choose virtual machines from Click Next
6 Continue and complete the reminder of the wizardrsquos steps
Once the resource is published users who have been assigned access will be able to use it
immediately
PowerTerm WebConnect 22 Getting Started Guide
5 Download and Run PowerTerm WebConnect Clients
PowerTerm WebConnect clients are automatically downloaded and installed onto the client
devices For detailed information and samples please refer to the PowerTerm WebConnect
Sample URLs page To see this page navigate your browser to
httpltweb_servergtWebConnect5xClientURLshtml
PowerTerm WebConnect 23 Getting Started Guide
6 PowerTerm WebConnect Client for Lotus Expeditor
61 Installation Package
PowerTerm WebConnect client for Lotus Expeditor is provided to IBM in an Update Site
package This is a ZIP archive containing the Update Site with the Eclipse feature and plug-
in that comprises the PowerTerm WebConnect client
Extract the ZIP file keeping the foldersrsquo structure intact
NOTE In Winzip verify that the ldquoUse folder namesrdquo option is set to TRUE
Package structure
Update Site
- plugins
- PowerTermWebConnectClient_560365jar
- features
- comericomWebConnect_560365jar
- sitexml
config
- webconnectxml
Definitions
bull webconnectxml PowerTerm WebConnect client configuration file
bull comericomWebConnect_560365jar PowerTerm WebConnect client feature file
bull PowerTermWebConnectClient_560365jar PowerTerm WebConnect client plugin file
62 Pre-installation steps
PowerTerm WebConnect client for Lotus Expeditor does not run independently but in
conjunction with PowerTerm WebConnect Server You can either install it and define your
users groups and applications or use Ericom Softwarersquos Demo PowerTerm WebConnect
Server
bull If you decide to install PowerTerm WebConnect Server you will need the full
installation ie the PowerTerm WebConnect Server and the Web components If you
do not have the installation CD you can download and install a trial version from
wwwericomcom
PowerTerm WebConnect 24 Getting Started Guide
bull If you decide to use Ericom Softwarersquos Demo PowerTerm WebConnect Server then
skip to the chapter Installing PowerTerm WebConnect Client on Lotus Expeditor
63 Install PowerTerm WebConnect Portlet on IBM Workplace server (for Windows OS)
Step 1 Install PowerTerm WebConnect Server
If PowerTerm WebConnect Server and IBM Workplace Server are on separate machines
bull Configure PowerTerm WebConnect Server
Launch PowerTerm WebConnect Administration Tool
Open Files | Configuration | Main
In the [Portal] section edit
Machines=localhostltIBM sever machinegt
bull Configure PowerTerm WebConnect Web components
Copy the ldquowebrdquo folder from the PowerTerm WebConnect server installation to the
IBM Workplace server machine
Create an Alias or a Virtual directory to it named WebConnect on the Web
server providing access to it for the users This is in order to enable the users to
download the necessary files to run their applications
Step 2 Enable JSR portlets
1 On IBM Workplace Server go to ltPortalServergtsharedappconfigservicesConfigServiceproperties
2 Edit portalenablejsr168=true
3 Save and close the file
Step 3 Enable SSO
1 On IBM Workplace Server go to ltPortalServergtsharedappconfigservicesLoaderServiceproperties
2 Edit commandpath=comericomportalcommandscomibmwpsenginecommands
3 Save and close the file
Step 4 Copy Files
The following files need to be copied from WebConnect ServerAddOnsIBM
WorkplacePortlet folder to IBM Workplace Server
File name to copy Destination folder
OpenSSLdll ltAppServergtjavajrebin
IbmPortaldll ltAppServergtjavajrebin
IbmPortalini ltAppServergtjavajrebin
PowerTerm WebConnect 25 Getting Started Guide
WebConnectPortaljar ltAppServergtlib
EricomLoginjar ltPortalServergtsharedapp
Step 5 Portlet Configuration
1 On IBM Workplace Server go to ltAppServergtjavajrebinIbmPortalini
2 You can modify the following parameters in the [Server=WebConnect] section webserverport=ltIBM web server portgt
Specifies the Web server port for accessing the PowerTerm WebConnect clients folder
Default 80 Address
Specifies the address of the PowerTerm WebConnect Server machine for Portlet to
connect to when PowerTerm WebConnect Server is located on a different machine
than the IBM Workplace Server CustomAddress
Specifies the addresss of the PowerTerm WebConnect Server machine for Clients to connect to If CustomAddress is the same as Address then this may be omitted webserveraddr
Specifies the address of the Web Server machine when it is located on a different
machine than the IBM Workplace Server
3 Restart the IBM server ltPortalServergtrootscriptsstopWorkplaceServicesbat ltPortalServergtrootscriptsstartWorkplaceServicesbat
This procedure may take about 20 minutes
Step 6 Install the Portlet
1 In a Web browser open the URL httpltIBM Workplace
Servergt9081lwpmyworkplace to open the IBM Workplace Portal
2 Login as administrator
3 Go to Administration | Portlets | Install
4 Browse to the PowerTerm WebConnectwar file located on PowerTerm WebConnect
Server and click Next
5 Click Install
Step 7 Create an Application page
1 Login to the Workplace
2 Go to Portal User Interface | Manage Pages
3 Search for My Work
4 Click the My Work link and select New Page
5 Name the page PowerTerm WebConnect and click OK
6 Click OK again You will see the created page on the list
7 Click the pencil icon on the new page and select the 1 square layout
PowerTerm WebConnect 26 Getting Started Guide
8 Click Add Portlet and search for PowerTerm WebConnect
9 Select it and click OK
10 Click Done
11 Click My work at the top of the page PowerTerm WebConnect is displayed on the list
Step 8 Run the Portlet
1 Restart IBM Workplace Server
2 Open IBM Workplace Portal in a browser httpltportal servergtlwpmyworkplace
3 Login to IBM Workplace Server
4 Click My work PowerTerm WebConnect portlet is displayed
5 Launch it The Userrsquos applications as defined on PowerTerm WebConnect Server
appear
6 Click an application to launch it
64 Install PowerTerm WebConnect Portlet on IBM Workplace server (for Linux OS)
Step 1 Enable JSR 168 portlets
1 Go to optIBMWorkplacePortalServersharedappconfigservicesConfigServiceproperties
2 Modify the portalenablejsr168 property to ldquotruerdquo
3 Restart the server cd optIBMWorkplacePortalServerrootscripts
Run stopWorkplaceServicessh
Run startWorkplaceServicessh
This procedure can take up to 20 minutes
4 Log on to the workplace server at httpltworkplace servergt9081lwpmyworkplace using
the administrators username and password
Step 2 Install the portlet
1 Restart IBM Workplace Server
2 In a Web browser open the URL httpltworkplace server IPgtlwpmyworkplace
3 Login to IBM Workplace Server as an administrator
4 Go to Administration | Portlets | Install
5 Browse to the PowerTerm WebConnectwar file located on PowerTerm WebConnect
Server and click Next
6 Click Install
PowerTerm WebConnect 27 Getting Started Guide
Step 3 Install the Application page
1 Login to the workplace as administrator
2 Go to Administration | Portal User Interface | Manage Pages
3 Search for My Work
4 Click the My Work link and select New Page
5 Name the page PowerTerm WebConnect and click OK
6 Click OK again You will see the created page on the list
7 Click the pencil icon and select the 1-square layout
8 Click Add Portlet and search for PowerTerm WebConnect
9 Select it and click OK
10 Click Done
11 Click My work on top and PowerTerm WebConnect is displayed on the left bar
Step 4 Run the portlet
1 Restart IBM Workplace Server
2 Open IBM Workplace Portal in a browser httpltportal servergtlwpmyworkplace
3 Login to IBM Workplace Server
4 Click My work PowerTerm WebConnect portlet is displayed
5 Launch it The Userrsquos applications as defined on PowerTerm WebConnect Server
appear
6 Click an application to launch it
65 Install PowerTerm WebConnect Portlet on IBM WebSphere 61 server (for Windows OS)
Step 1 Install PowerTerm WebConnect Server
You have to configure PowerTerm WebConnect Server if it and the IBM WebSphere Server
are on separate machines
1 Launch PowerTerm WebConnect Administration Tool
2 Open Files | Configuration | Main
3 In the [Portal] section edit Machines=localhostltIBM sever machinegt
Step 2 Copy Files
The following files need to be copied from WebConnect ServerAddOnsIBM
WebSpherePortlet folder to IBM WebSphere Server
PowerTerm WebConnect 28 Getting Started Guide
File name to copy Destination folder
OpenSSLdll ltAppServergtjavajrebin
IbmPortaldll ltAppServergtjavajrebin
IbmPortalini ltAppServergtjavajrebin
WebConnectPortaljar ltAppServergtlib
Step 3 Portlet Configuration
1 On IBM Workplace Server go to ltAppServergtjavajrebinIbmPortalini
2 You can modify the following parameters in the [Server=WebConnect] section webserverport=ltIBM web server portgt
Specifies the Web server port for accessing the PowerTerm WebConnect clients folder
Default 80 Address
Specifies the address of the PowerTerm WebConnect Server machine for Portlet to
connect to when PowerTerm WebConnect Server is located on a different machine
than the IBM Workplace Server CustomAddress
Specifies the addresss of the PowerTerm WebConnect Server machine for Clients to connect to If CustomAddress is the same as Address then this may be omitted webserveraddr
Specifies the address of the Web Server machine when it is located on a different
machine than the IBM Workplace Server
3 Restart the IBM server ltAppServergtProfilesAppServer01binstopServerbat ltAppServergtProfilesAppServer01binstartServerbat
This procedure may take about 20 minutes
Step 4 Install the Portlet and create an Application page
1 In a Web browser open the URL httpltIBM WebSphere Servergt9060ibmconsole
to open the IBM WebSphere Portal
2 Login and go to Applications | Install New Application
3 Browse to the PowerTerm WebConnectwar file located on PowerTerm WebConnect
Server
4 Enter Context root and click Next The Select installation options dialog appears
5 Optional change options to your preference or keep the default
6 Click Next
7 Select Ericom in the Module column click Apply and then Next
8 Click Finish and then Save
9 Select Applications | Enterprise Applications
10 Select PowerTerm WebConnectwar checkbox and click Start
PowerTerm WebConnect 29 Getting Started Guide
11 Enter in the Web browser the URL httpltIBM WebSphere
Servergt9080ltContext rootgtEricom portlet The Login dialog appears
12 Login and you will see PowerTerm WebConnect displayed on the list
Step 5 Run the Portlet
1 Restart IBM WebSphere Server
2 Open IBM WebSphere Portal in a browser httpltportal servergt9080ltContext
rootgtEricom portlet
3 Login to IBM WebSphere Server
4 Launch it The Userrsquos applications as defined on PowerTerm WebConnect Server
appear
5 Click an application to launch it
66 PowerTerm WebConnect Server Configuration
bull To enable the Lotus Expeditor to run the PowerTerm WebConnect client the
System Administrator must provide the users with accounts on PowerTerm
WebConnect Server (see the PowerTerm WebConnect Administratorrsquos Manual for
instructions on how to create users groups and connections on the PowerTerm
WebConnect Server)
bull To enable PowerTerm WebConnectrsquos Single Sign-On feature the System
Administrator must create a PowerTerm WebConnect user with the same
username and password as used for the Lotus Expeditor For a managed Lotus
Expeditor the credentials used are the username and password sent to the
managing server For an unmanaged Lotus Expeditor the operation system
username and the Lotus Expeditor password are used as credentials
NOTE If a password is not defined then the Single Sign-On will fail and the user will be
prompted with a login dialog
67 PowerTerm WebConnect Client Configuration
The PowerTerm WebConnect client is configured in webconnectxml located in the config
folder webconnectxml parameters are
url The PowerTerm WebConnect Agent url
server The PowerTerm WebConnect Server address
sso The Single Sign-On feature
dst The local destination for downloading PowerTerm WebConnect
components
PowerTerm WebConnect 30 Getting Started Guide
url
PowerTerm WebConnect components are installed on a Web server Their default url is
Windows Agent
httpltWebServer IPgtWebConnectwindowsptagentcab
Linux Agent
httpltWebServer IPgtWebConnectlinuxix86qterm-wczip
The url parameter must include the first part of the url (which is identical for both Windows
and Linux agents)
The PowerTerm WebConnect client will automatically append the appropriate suffix in
order to create a full accurate url
Example
ltitem key=rdquourlrdquo value=httpadminserverWebConnectgt
server
The computer name or IP address of the PowerTerm WebConnect Server machine
The PowerTerm WebConnect client will log in to this PowerTerm WebConnect Server
display the applications defined on it and run them according to this serverrsquos configuration
Format ltserver IPgt[ltportgt]
where default port is 4000 (can be edited)
Example
ltitem key=rdquoserverrdquo value=rdquoadmin24000rdquogt
sso
Determines whether Single Sign-on will be used to log in to PowerTerm WebConnect
Server Values
bull True (default) the client should automatically log in to the PowerTerm WebConnect
Server using the same credentials as the ones used to log in to the Lotus Expeditor
client
The System Administrator must verify that these credentials can log in to the
PowerTerm WebConnect Server
bull False the user will be prompted with a login dialog or will log in automatically using
previously saved credentials
Example
ltitem key=rdquossordquo value=rdquotruerdquogt
Autologin mode
PowerTerm WebConnect 31 Getting Started Guide
If sso is set to True the user is not prompted for credentials and the login process to
PowerTerm WebConnect Server is done automatically sending the credentials used for the
Lotus Expeditor unless the Lotus Expeditor does not have a password defined (In the
Lotus Expeditor preferences page | Password| Prompt me for a password at start up checkbox)
However if Single Sign-on is not used there are several options regarding Autologin that
can be defined in the PowerTerm WebConnect Preferences page Options
bull Yes
bull No
bull Interactive
bull First time interactive (default) ndash Simplifies the login process to PowerTerm
WebConnect Server In this mode the first time the user logs in to PowerTerm
WebConnect Server he will be prompted for his credentials with the Login dialog
These credentials will be stored in the machine and from then on the login process to
PowerTerm WebConnect Server will be done automatically
1 Open File | Preferences from the Lotus Expeditor and select PowerTerm WebConnect
2 In the Autologin to WebConnect Server section select First Interactive and click OK
3 Start PowerTerm WebConnect Client for Lotus Expeditor If credentials were entered
at least once then the next time the client will connect to PowerTerm WebConnect
Server without prompting for the user name and password
The Administrator must configure the Agent to do nothing when it exits for the
feature to work this way See PowerTerm WebConnect Administratorrsquos Manual for more information about defining Autologin
bull Allow multiple selection ndash Defines whether the user can launch more than one
application at a time (by using the ltCtrlgt or ltShiftgt button while selecting applications)
dst
Defines the path to download PowerTerm WebConnect components on the client machine
The dst parameter can contain macros which are translated by the PowerTerm WebConnect
Client for Lotus Expeditor during runtime The macros should be placed between percent
symbols () for example WebServer
When such a value is defined the PowerTerm WebConnect Client for Lotus Expeditor
substitutes the entire expression for the macrorsquos value
The PowerTerm WebConnect Client for Lotus Expeditor does not support the use
of environment variables as macros
Macros are not case sensitive
Macros supported by PowerTerm WebConnect Client for Lotus Expeditor
Macro name Description
WebServer The name of the Web server
It is obtained from the PowerTerm WebConnect Agent url
PowerTerm WebConnect 32 Getting Started Guide
parameter
Name The name of the clientrsquos CAB or ZIP file eg ldquoptagentrdquo
Display The clientrsquos display name from the version file
Version The clientrsquos version value It is obtained from the version
file
Root The default root location
Windows ldquoCrdquo
LinuxUnix an empty string
OSDir Windows Windowsrsquo installation directory for example
ldquoCWindowsrdquo
Linux an empty string
OSDrive Windows Windowsrsquo installation drive for example ldquoCrdquo
Linux an empty string
HomePath Windows The HOMEPATH environment variable
Linux The HOME environment variable
Home The Ericom folder in the userrsquos home directory
Windows CDocuments and SettingsltusergtApplication
DataEricom
Linux ltusergtEricom
In addition to the predefined macros listed above the PowerTerm WebConnect client
supports the usage of Java System Properties
Java System Properties available for users on Windows XP SP2
Java System Property Name Value Example
javaversion 150
javavendorurl httpwwwibmcom
javahome CIBMcommonpluginscomibmpvcwctruntim
esj2sewin32x86_150SR2-
20060511rcpeclipsepluginscomibmrcpj2sew
in32x86_150SR2-20060511jre
javavmspecificationversion 10
javavmversion 23
javavmvendor IBM Corporation
javavmname IBM J9 VM
PowerTerm WebConnect 33 Getting Started Guide
javaiotmpdir CDOCUME~1dianaLOCALS~1Temp
javacompiler j9jit23
javaextdirs CIBMcommonpluginscomibmpvcwctruntim
esj2sewin32x86_150SR2-
20060511rcpeclipsepluginscomibmrcpj2sew
in32x86_150SR2-20060511jrelibext
osname Windows XP
osarch x86
osversion 51 build 2600 Service Pack 2
pathseparator
username Jone
userhome CDocuments and SettingsJone
userdir CIBMRSA
usertimezone GMT+0200
System properties available for users on Linux RedHat 9
Java System Property Name Value Example
javaversion 150
javavendorurl httpwwwibmcom
javahome usrjavajre150_07
javavmversion 150
javavmvendor IBM Corporation
javavmname IBM J9 VM
javaclasspath
javalibrarypath
javaiotmpdir tmp
javacompiler
javaextdirs
osname Linux
osarch i386
osversion 2420-8
pathseparator
PowerTerm WebConnect 34 Getting Started Guide
username root
userhome root
userdir root
System properties names are placed in the configuration file within percent symbols ()
(like macros)
671 Configure the PowerTerm WebConnect Client
1 Open the Config Folder and edit the webconnectxml file Example
ltxml version =rdquo10rdquo encoding=rdquoUTF-8rdquogt
ltsection name=rdquoparametersrdquogt
ltitem key=rdquourlrdquo value=httpadminserverWebConnect56gt
ltitem key=rdquoserverrdquo value=rdquoadmin24000rdquogt
ltitem key=rdquossordquo value=rdquotruerdquogt
ltitem key=rdquodestrdquo value=rdquoCProgram FilesEricomrdquogt
ltsectiongt
2 Save the customized webconnectxml to a Web server folder available to all users It is
recommended to use the same Web server as the PowerTerm WebConnect Agent
Example
ltWebConnect installation foldergtwebwebconnectxml
3 Test the accessibility to this file - Type the URL of webconnectxml in the browser
Example
httpltWebServer IPgtWebConnectwebconnectxml
The contents of the file should be displayed
672 Configure the Preferences File
1 Open the plugins folder and open the PowerTermWebConnectClient_560365jar file
You can use Winzip version 70 and up or in Windows XP ndash Create a new file type for the
jar extension click advanced and select compressed (zipped) folder in the drop down list
Now you can open the JAR files in the Windows Explorer
The default contents of the file
configURL=httpleericomcomWebConnectwebconnectxml
2 Specify the accurate URL of the webconnectxml file Example
httpltWebServer IPgtWebConnectwebconnectxml
3 Save the file and close it The WinZip will display the following dialog
ldquoFile preferencesini has been changed since it was extracted Update archive
with this filerdquo
PowerTerm WebConnect 35 Getting Started Guide
4 Click Yes and close the archive
If you are editing the file from within the explorer you will have to save the file elsewhere
and then drag it to the explorer window where the JAR file is open
68 Installing PowerTerm WebConnect Client on Lotus Expeditor
1 Start the Lotus Expeditor client
2 Select File | Application | Install
3 Select Search for new features to install and click Next
4 Select Add Folder Location and type or select the location of the update site folder from
the provided package Click OK
5 Select the location you have just created and click Finish
6 In the Select the feature to install tree select Powerterm WebConnectUpdate Site Click
Next
7 Select I accept the terms in the license agreements and click Next
8 Click Finish
9 When prompted restart the platform
69 Running PowerTerm WebConnect Client for Lotus Expeditor
1 Click Open The PowerTerm WebConnect option is displayed
2 Select PowerTerm WebConnect The application will automatically connect and start
downloading the components from PowerTerm WebConnect Server
IMPORTANT
If you did not install PowerTerm WebConnect Server and are instead connecting to Ericom
Softwarersquos Demo WebConnect Server then you need to open port 443 in the firewall
691 PowerTerm WebConnect Client Workflow
1 PowerTerm WebConnect client reads the URL of webconnectxml from the preferencesini
file and requests it
2 When the webconnectxml is successfully downloaded the application reads the
configuration connects to the specified Web server downloads the PowerTerm
WebConnect components and connects to the PowerTerm WebConnect Server
3 The user is requested to login to the PowerTerm WebConnect Server For testing you
can use the username Example and password example
This step will be skipped if Single Sign-on is set to ldquotruerdquo
PowerTerm WebConnect 36 Getting Started Guide
4 After logging in to PowerTerm WebConnect Server the userrsquos applications are displayed
as defined by the administrator
5 To run an application select the desired application from the list and click Launch or
double-click the application The application will be launched in a separate window
610 Troubleshooting
When you encounter a problem the first step is to open the log file This file is located on
the client machine in the Ericom folder
Windows
CDocuments and SettingsltusernamegtEricomleclientEricomPluginlog
Linux
ltuser-home-directorygtEricomleclientEricomPluginlog
Following is a guide for diagnosing and fixing the problems in cases of error messages and
additional information
Error
Message
Solution
Version File
reading error
1 Check the lsquourlrsquo parameter in the webconnectxml file on the Web
server The value should be
httpltWebServerIPgtWebConnect
2 Try to run the following URL on the browser
Windows
httpltWebServerIPgtWebConnectwindowsptagentvertxt
Linux
httpltWebServerIPgtWebConnectlinuxix86qterm-
wcvertxt
The file contents displayed in the browser window should be in
the following form
560-rel14546
PowerTerm WebConnect Application Zone
560 - Main Release
ltrootgtPowerTerm WebConnect 56ltWebServergt
If the version file contents are not as shown check
- Is the Web Server running
- Are PowerTerm WebConnect Web Components and version files
PowerTerm WebConnect 37 Getting Started Guide
in place
3 On the Web server check ltPowerTerm WebConnect
rootgtwebwindowsptagentvertxt If the contents ldquolook wrongrdquo or
not in the proper form reinstall the PowerTerm WebConnect Web
components
4 On the client machine open the aforementioned URL in the
browser The file content should appear in the browser If it does
not it could be that the Web server is down
Web Server is
shut down
The webconnectxml configuration file must be located on the Web
server The explicit URL to this file is defined in the preferencesini
file (see Configure the Preferences File)
The error message contains the IP address of the Web server
Verify that the Web server on this machine is running
Version file
does not exist
on ltURLgt
See Version File reading error
The
configuration
file is not
accessible or
has a wrong
format
The webconnectxml configuration file must be located on the Web
server and the explicit URL to the configuration must be defined in
the preferencesini file (see Configure the Preferences File)
Try to open the URL specified in the error message in the
browser If it does not open then it either does not exist or it has
a wrong format
Preferences
file does not
exist in the
application
bundle
The preferencesini file containing the URL to the configuration
file was removed from the update site folder
Uninstall the current PowerTerm WebConnect client from the
client machine Create a new customized package (see
PowerTerm WebConnect Client Configuration) and reinstall it
Configuration
file URL is not
defined in
preference
file
The URL to the configuration file does not appear in the
preferencesini file (see Configure the Preferences File)
Uninstall the current PowerTerm WebConnect client from the
client machine Create a new customized package (see
PowerTerm WebConnect Client Configuration) and reinstall it
No IP address
could be
found for the
host
The Web server URL specified in the preferencesini file (see
Configure the Preferences File) or in the webconnectxml file (see
Configure the PowerTerm WebConnect Client) is an unknown
host
If the mistake is in the preferencesini file uninstall the current
PowerTerm WebConnect client from the client machine Create a
new customized package (see PowerTerm WebConnect Client
Configuration) and reinstall it
PowerTerm WebConnect 38 Getting Started Guide
If the mistake is in the webconnectxml file correct the file reopen
the Lotus Expeditor client
Cannot write
to destination
The temporary file cannot be written to the defined destination
Check the write permissions
Copied
configuration
file has wrong
format
The webconnectxml file as received from the specified URL has a
wrong format Correct the file and try again
PowerTerm
WebConnect
Agent URL is
malformed
The PowerTerm WebConnect Agent URL specified in the
webconnectxml file (see Configure the PowerTerm WebConnect
Client) does not have a proper HTTP format Correct the file and
try again
PowerTerm
WebConnect
Agent URL is
not defined
The PowerTerm WebConnect Agent URL parameter is not specified
in the webconnectxml file (see Configure the PowerTerm
WebConnect Client)
Correct the file and try again
The specified
destination
folder name
is wrong
The destination folder name contains illegal characters
ltgt|
Check the dst parameter in the webconnectxml file Correct the
file and try again
You do not
have
permissions
to write to
ltpathgt
The PowerTerm WebConnect Agent cannot be written to the
destination as defined Check the write permissions
The default destination defined in the version file should not to
be changed
A customized destination for PowerTerm WebConnect Agent
downloading can be defined in the webconnectxml file (See
Configure the PowerTerm WebConnect Client)
Check the destination value correct and try again
PowerTerm WebConnect 39 Getting Started Guide
About Ericom
Ericomreg Software is a leading provider of Application Access and Virtualization Solutions
Since 1993 Ericom has been helping users access enterprise mission-critical applications
running on a broad range of Microsoftreg Windowsreg Terminal Servers virtual Desktops
Blade PCs legacy hosts and other systems Ericom provides concrete business value by
helping organizations realize the benefits of their IT investments With offices in the United
States United Kingdom EMEA India and China Ericom also has an extensive network of
distributors and partners throughout North America Europe Asia and the Far East Our
expanding customer base is more than 30 thousand strong with over 7 million
installations
For more information on our products and services contact us at the location nearest to you
And visit our web site httpwwwericomcom
North America Western Europe International
Ericom Software Inc Ericom Software (UK) Ltd Ericom Software Ltd
231 Herbert Avenue Bldg 4 11a Victoria Square 8 Hamarpeh Street
Closter NJ 07624 USA Droitwich Worcestershire Har Hotzvim Technology Park
Tel +1 (201) 767 2210 WR9 8DE United Kingdom Jerusalem 91450 Israel
Fax +1 (201) 767 2205 Tel +44 (0) 845 644 3597 Tel +972 (2) 591 1700
Toll-free 1 (888) 769 7876 Fax +44 (0) 845 644 3598 Fax +972 (2) 571 4737
Email infoericomcom Email infoericomcouk Email infoericomcom
PowerTerm WebConnect 18 Getting Started Guide
4 Accessing Virtual Desktops and Blade PCs with PowerTerm WebConnect
This chapter provides instructions on configuring PowerTerm WebConnect for Virtual
Desktop Infrastructure (VDI)
41 Step 1 Launch DeskView Administration Tool
Verify that PowerTerm WebConnect is installed on your server and launch PowerTerm
WebConnect Admin Tool
bull Select Tools | Open VDI Manager The PowerTerm WebConnect DeskView Administration
Tool opens
The first time you launch the DeskView Administration Tool you will be prompted to install
the tool
PowerTerm WebConnect 19 Getting Started Guide
Microsoft Management Console 30 is required for PowerTerm WebConnect DeskView
Administration Tool If you do not have this installed you will also automatically be
prompted to install this update
Follow the installation processes when you are prompted for either install PowerTerm
WebConnect DeskView Administration Tool will automatically launch when these
installations are completed
42 Step 2 Add a Host
1 Right-click Virtualization Hosts and select Add Host The Add a New Host wizard
opens Click Next
2 Enter a Host Name as you would like it to appear in PowerTerm WebConnect
DeskView Administration Tool and a description (optional) Click Next
3 Specify the Virtualization Server type and click Next
4 Specify the connection information and click Next
VMWare Virtual Center v1x and 2x
Specify the HTTPS Web Service address and a UsernamePassword that can access
the host
VMWare Virtual Server 2005
Click Start and then Run
Type ldquoservicesmscrdquo and click OK
Scroll down to PowerTerm WebConnect DeskView Server service and open
Properties
Change the Login Account for the service to match the Domain Administrator
account and password used when setting up Microsoft Virtual Server 2005 and
restart the service Enter the IP or NETBIOS name of the Microsoft Virtual Server 2005 server as the
Server Address in the Connection Broker Wizard
Xen Server
Specify the hypervisor IP address or NETBIOS name the Root UsernamePassword
to the hypervisor and the Service port (default 80)
Oracle VM
Specify the Serverrsquos agent URL and Port (default 8899) for example
httpsltservernamegt8899
Specify the Oracle VM hypervisorrsquos Oracle Agent UsernamePassword (default
username oracle)
5 Click Finish to add the new Host
To configure Virtual Machines for use install the Ericom Tools (vmagentmsi) on each of the
virtual machines on the new host for PowerTerm WebConnect DeskView to recognize them
The vmagentmsi installer is located on the PowerTerm WebConnect server in ltPowerTerm
WebConnect installation foldergtAddOnsDeskView VDI folder (default installation
PowerTerm WebConnect 20 Getting Started Guide
folder is xProgram FilesEricom SoftwareWebConnect 56) During installation you
will need to enter the DeskView IP address or NETBIOS name
If you are using Microsoft Virtual Server 2005 as your Virtualization Host use the
IP address of the DeskView server only when installing the Ericom Tool package
43 Step 3 Create a Pool
Pools are used to organize Virtual Machines (VM) into logical groups This enables
organizations to combine and order resources from multiple systems into one entity To
access available resources end-users simply connect to PowerTerm WebConnect to access
any configured resource
1 Right-click Pools and select Create Pool The Create a Pool wizard opens Click
Next
2 Enter a Pool name as you wish it to appear and a description (optional) and click
Next
3 Specify the Pool type and click Next
4 Specify the Assignment type and click Next
Permanently will cause a virtual machine to affix to the user who has launched
that virtual machine For the duration of the session will cause any virtual machine that is not in use to
be returned to the pool for any user to launch
5 Specify the LogoffDisconnect event and click Next
Select what you would like to happen after a user logs off from a virtual machine
in this pool
Select what you would like to happen when a user is disconnected from a virtual
machine in this pool
6 Click Finish to add the new Pool
You will need to assign virtual machines from your virtualization hosts to your created pool
1 Right-click the pool and select Assign Machines The Assign Machines to ltyour
pool namegt dialog opens
2 Highlight the desired virtual machine(s) and click Select Click OK
44 Step 4 Publish an ApplicationDesktop
1 Return to PowerTerm WebConnect Admin Tool to publish DeskView pools
2 Determine whether to publish a full desktop or a seamless application running
from a virtual desktop
For a full desktop
Select Action | New | Remote Windows Desktop
For a seamless application
Select Action | New | Windows Application
PowerTerm WebConnect 21 Getting Started Guide
3 Select Virtual Desktop in the first step of the wizard and click Next
4 Follow the wizardrsquos instructions until you reach the Virtual Desktops step
5 Select a pool that you previously created and that you would like this connection to choose virtual machines from Click Next
6 Continue and complete the reminder of the wizardrsquos steps
Once the resource is published users who have been assigned access will be able to use it
immediately
PowerTerm WebConnect 22 Getting Started Guide
5 Download and Run PowerTerm WebConnect Clients
PowerTerm WebConnect clients are automatically downloaded and installed onto the client
devices For detailed information and samples please refer to the PowerTerm WebConnect
Sample URLs page To see this page navigate your browser to
httpltweb_servergtWebConnect5xClientURLshtml
PowerTerm WebConnect 23 Getting Started Guide
6 PowerTerm WebConnect Client for Lotus Expeditor
61 Installation Package
PowerTerm WebConnect client for Lotus Expeditor is provided to IBM in an Update Site
package This is a ZIP archive containing the Update Site with the Eclipse feature and plug-
in that comprises the PowerTerm WebConnect client
Extract the ZIP file keeping the foldersrsquo structure intact
NOTE In Winzip verify that the ldquoUse folder namesrdquo option is set to TRUE
Package structure
Update Site
- plugins
- PowerTermWebConnectClient_560365jar
- features
- comericomWebConnect_560365jar
- sitexml
config
- webconnectxml
Definitions
bull webconnectxml PowerTerm WebConnect client configuration file
bull comericomWebConnect_560365jar PowerTerm WebConnect client feature file
bull PowerTermWebConnectClient_560365jar PowerTerm WebConnect client plugin file
62 Pre-installation steps
PowerTerm WebConnect client for Lotus Expeditor does not run independently but in
conjunction with PowerTerm WebConnect Server You can either install it and define your
users groups and applications or use Ericom Softwarersquos Demo PowerTerm WebConnect
Server
bull If you decide to install PowerTerm WebConnect Server you will need the full
installation ie the PowerTerm WebConnect Server and the Web components If you
do not have the installation CD you can download and install a trial version from
wwwericomcom
PowerTerm WebConnect 24 Getting Started Guide
bull If you decide to use Ericom Softwarersquos Demo PowerTerm WebConnect Server then
skip to the chapter Installing PowerTerm WebConnect Client on Lotus Expeditor
63 Install PowerTerm WebConnect Portlet on IBM Workplace server (for Windows OS)
Step 1 Install PowerTerm WebConnect Server
If PowerTerm WebConnect Server and IBM Workplace Server are on separate machines
bull Configure PowerTerm WebConnect Server
Launch PowerTerm WebConnect Administration Tool
Open Files | Configuration | Main
In the [Portal] section edit
Machines=localhostltIBM sever machinegt
bull Configure PowerTerm WebConnect Web components
Copy the ldquowebrdquo folder from the PowerTerm WebConnect server installation to the
IBM Workplace server machine
Create an Alias or a Virtual directory to it named WebConnect on the Web
server providing access to it for the users This is in order to enable the users to
download the necessary files to run their applications
Step 2 Enable JSR portlets
1 On IBM Workplace Server go to ltPortalServergtsharedappconfigservicesConfigServiceproperties
2 Edit portalenablejsr168=true
3 Save and close the file
Step 3 Enable SSO
1 On IBM Workplace Server go to ltPortalServergtsharedappconfigservicesLoaderServiceproperties
2 Edit commandpath=comericomportalcommandscomibmwpsenginecommands
3 Save and close the file
Step 4 Copy Files
The following files need to be copied from WebConnect ServerAddOnsIBM
WorkplacePortlet folder to IBM Workplace Server
File name to copy Destination folder
OpenSSLdll ltAppServergtjavajrebin
IbmPortaldll ltAppServergtjavajrebin
IbmPortalini ltAppServergtjavajrebin
PowerTerm WebConnect 25 Getting Started Guide
WebConnectPortaljar ltAppServergtlib
EricomLoginjar ltPortalServergtsharedapp
Step 5 Portlet Configuration
1 On IBM Workplace Server go to ltAppServergtjavajrebinIbmPortalini
2 You can modify the following parameters in the [Server=WebConnect] section webserverport=ltIBM web server portgt
Specifies the Web server port for accessing the PowerTerm WebConnect clients folder
Default 80 Address
Specifies the address of the PowerTerm WebConnect Server machine for Portlet to
connect to when PowerTerm WebConnect Server is located on a different machine
than the IBM Workplace Server CustomAddress
Specifies the addresss of the PowerTerm WebConnect Server machine for Clients to connect to If CustomAddress is the same as Address then this may be omitted webserveraddr
Specifies the address of the Web Server machine when it is located on a different
machine than the IBM Workplace Server
3 Restart the IBM server ltPortalServergtrootscriptsstopWorkplaceServicesbat ltPortalServergtrootscriptsstartWorkplaceServicesbat
This procedure may take about 20 minutes
Step 6 Install the Portlet
1 In a Web browser open the URL httpltIBM Workplace
Servergt9081lwpmyworkplace to open the IBM Workplace Portal
2 Login as administrator
3 Go to Administration | Portlets | Install
4 Browse to the PowerTerm WebConnectwar file located on PowerTerm WebConnect
Server and click Next
5 Click Install
Step 7 Create an Application page
1 Login to the Workplace
2 Go to Portal User Interface | Manage Pages
3 Search for My Work
4 Click the My Work link and select New Page
5 Name the page PowerTerm WebConnect and click OK
6 Click OK again You will see the created page on the list
7 Click the pencil icon on the new page and select the 1 square layout
PowerTerm WebConnect 26 Getting Started Guide
8 Click Add Portlet and search for PowerTerm WebConnect
9 Select it and click OK
10 Click Done
11 Click My work at the top of the page PowerTerm WebConnect is displayed on the list
Step 8 Run the Portlet
1 Restart IBM Workplace Server
2 Open IBM Workplace Portal in a browser httpltportal servergtlwpmyworkplace
3 Login to IBM Workplace Server
4 Click My work PowerTerm WebConnect portlet is displayed
5 Launch it The Userrsquos applications as defined on PowerTerm WebConnect Server
appear
6 Click an application to launch it
64 Install PowerTerm WebConnect Portlet on IBM Workplace server (for Linux OS)
Step 1 Enable JSR 168 portlets
1 Go to optIBMWorkplacePortalServersharedappconfigservicesConfigServiceproperties
2 Modify the portalenablejsr168 property to ldquotruerdquo
3 Restart the server cd optIBMWorkplacePortalServerrootscripts
Run stopWorkplaceServicessh
Run startWorkplaceServicessh
This procedure can take up to 20 minutes
4 Log on to the workplace server at httpltworkplace servergt9081lwpmyworkplace using
the administrators username and password
Step 2 Install the portlet
1 Restart IBM Workplace Server
2 In a Web browser open the URL httpltworkplace server IPgtlwpmyworkplace
3 Login to IBM Workplace Server as an administrator
4 Go to Administration | Portlets | Install
5 Browse to the PowerTerm WebConnectwar file located on PowerTerm WebConnect
Server and click Next
6 Click Install
PowerTerm WebConnect 27 Getting Started Guide
Step 3 Install the Application page
1 Login to the workplace as administrator
2 Go to Administration | Portal User Interface | Manage Pages
3 Search for My Work
4 Click the My Work link and select New Page
5 Name the page PowerTerm WebConnect and click OK
6 Click OK again You will see the created page on the list
7 Click the pencil icon and select the 1-square layout
8 Click Add Portlet and search for PowerTerm WebConnect
9 Select it and click OK
10 Click Done
11 Click My work on top and PowerTerm WebConnect is displayed on the left bar
Step 4 Run the portlet
1 Restart IBM Workplace Server
2 Open IBM Workplace Portal in a browser httpltportal servergtlwpmyworkplace
3 Login to IBM Workplace Server
4 Click My work PowerTerm WebConnect portlet is displayed
5 Launch it The Userrsquos applications as defined on PowerTerm WebConnect Server
appear
6 Click an application to launch it
65 Install PowerTerm WebConnect Portlet on IBM WebSphere 61 server (for Windows OS)
Step 1 Install PowerTerm WebConnect Server
You have to configure PowerTerm WebConnect Server if it and the IBM WebSphere Server
are on separate machines
1 Launch PowerTerm WebConnect Administration Tool
2 Open Files | Configuration | Main
3 In the [Portal] section edit Machines=localhostltIBM sever machinegt
Step 2 Copy Files
The following files need to be copied from WebConnect ServerAddOnsIBM
WebSpherePortlet folder to IBM WebSphere Server
PowerTerm WebConnect 28 Getting Started Guide
File name to copy Destination folder
OpenSSLdll ltAppServergtjavajrebin
IbmPortaldll ltAppServergtjavajrebin
IbmPortalini ltAppServergtjavajrebin
WebConnectPortaljar ltAppServergtlib
Step 3 Portlet Configuration
1 On IBM Workplace Server go to ltAppServergtjavajrebinIbmPortalini
2 You can modify the following parameters in the [Server=WebConnect] section webserverport=ltIBM web server portgt
Specifies the Web server port for accessing the PowerTerm WebConnect clients folder
Default 80 Address
Specifies the address of the PowerTerm WebConnect Server machine for Portlet to
connect to when PowerTerm WebConnect Server is located on a different machine
than the IBM Workplace Server CustomAddress
Specifies the addresss of the PowerTerm WebConnect Server machine for Clients to connect to If CustomAddress is the same as Address then this may be omitted webserveraddr
Specifies the address of the Web Server machine when it is located on a different
machine than the IBM Workplace Server
3 Restart the IBM server ltAppServergtProfilesAppServer01binstopServerbat ltAppServergtProfilesAppServer01binstartServerbat
This procedure may take about 20 minutes
Step 4 Install the Portlet and create an Application page
1 In a Web browser open the URL httpltIBM WebSphere Servergt9060ibmconsole
to open the IBM WebSphere Portal
2 Login and go to Applications | Install New Application
3 Browse to the PowerTerm WebConnectwar file located on PowerTerm WebConnect
Server
4 Enter Context root and click Next The Select installation options dialog appears
5 Optional change options to your preference or keep the default
6 Click Next
7 Select Ericom in the Module column click Apply and then Next
8 Click Finish and then Save
9 Select Applications | Enterprise Applications
10 Select PowerTerm WebConnectwar checkbox and click Start
PowerTerm WebConnect 29 Getting Started Guide
11 Enter in the Web browser the URL httpltIBM WebSphere
Servergt9080ltContext rootgtEricom portlet The Login dialog appears
12 Login and you will see PowerTerm WebConnect displayed on the list
Step 5 Run the Portlet
1 Restart IBM WebSphere Server
2 Open IBM WebSphere Portal in a browser httpltportal servergt9080ltContext
rootgtEricom portlet
3 Login to IBM WebSphere Server
4 Launch it The Userrsquos applications as defined on PowerTerm WebConnect Server
appear
5 Click an application to launch it
66 PowerTerm WebConnect Server Configuration
bull To enable the Lotus Expeditor to run the PowerTerm WebConnect client the
System Administrator must provide the users with accounts on PowerTerm
WebConnect Server (see the PowerTerm WebConnect Administratorrsquos Manual for
instructions on how to create users groups and connections on the PowerTerm
WebConnect Server)
bull To enable PowerTerm WebConnectrsquos Single Sign-On feature the System
Administrator must create a PowerTerm WebConnect user with the same
username and password as used for the Lotus Expeditor For a managed Lotus
Expeditor the credentials used are the username and password sent to the
managing server For an unmanaged Lotus Expeditor the operation system
username and the Lotus Expeditor password are used as credentials
NOTE If a password is not defined then the Single Sign-On will fail and the user will be
prompted with a login dialog
67 PowerTerm WebConnect Client Configuration
The PowerTerm WebConnect client is configured in webconnectxml located in the config
folder webconnectxml parameters are
url The PowerTerm WebConnect Agent url
server The PowerTerm WebConnect Server address
sso The Single Sign-On feature
dst The local destination for downloading PowerTerm WebConnect
components
PowerTerm WebConnect 30 Getting Started Guide
url
PowerTerm WebConnect components are installed on a Web server Their default url is
Windows Agent
httpltWebServer IPgtWebConnectwindowsptagentcab
Linux Agent
httpltWebServer IPgtWebConnectlinuxix86qterm-wczip
The url parameter must include the first part of the url (which is identical for both Windows
and Linux agents)
The PowerTerm WebConnect client will automatically append the appropriate suffix in
order to create a full accurate url
Example
ltitem key=rdquourlrdquo value=httpadminserverWebConnectgt
server
The computer name or IP address of the PowerTerm WebConnect Server machine
The PowerTerm WebConnect client will log in to this PowerTerm WebConnect Server
display the applications defined on it and run them according to this serverrsquos configuration
Format ltserver IPgt[ltportgt]
where default port is 4000 (can be edited)
Example
ltitem key=rdquoserverrdquo value=rdquoadmin24000rdquogt
sso
Determines whether Single Sign-on will be used to log in to PowerTerm WebConnect
Server Values
bull True (default) the client should automatically log in to the PowerTerm WebConnect
Server using the same credentials as the ones used to log in to the Lotus Expeditor
client
The System Administrator must verify that these credentials can log in to the
PowerTerm WebConnect Server
bull False the user will be prompted with a login dialog or will log in automatically using
previously saved credentials
Example
ltitem key=rdquossordquo value=rdquotruerdquogt
Autologin mode
PowerTerm WebConnect 31 Getting Started Guide
If sso is set to True the user is not prompted for credentials and the login process to
PowerTerm WebConnect Server is done automatically sending the credentials used for the
Lotus Expeditor unless the Lotus Expeditor does not have a password defined (In the
Lotus Expeditor preferences page | Password| Prompt me for a password at start up checkbox)
However if Single Sign-on is not used there are several options regarding Autologin that
can be defined in the PowerTerm WebConnect Preferences page Options
bull Yes
bull No
bull Interactive
bull First time interactive (default) ndash Simplifies the login process to PowerTerm
WebConnect Server In this mode the first time the user logs in to PowerTerm
WebConnect Server he will be prompted for his credentials with the Login dialog
These credentials will be stored in the machine and from then on the login process to
PowerTerm WebConnect Server will be done automatically
1 Open File | Preferences from the Lotus Expeditor and select PowerTerm WebConnect
2 In the Autologin to WebConnect Server section select First Interactive and click OK
3 Start PowerTerm WebConnect Client for Lotus Expeditor If credentials were entered
at least once then the next time the client will connect to PowerTerm WebConnect
Server without prompting for the user name and password
The Administrator must configure the Agent to do nothing when it exits for the
feature to work this way See PowerTerm WebConnect Administratorrsquos Manual for more information about defining Autologin
bull Allow multiple selection ndash Defines whether the user can launch more than one
application at a time (by using the ltCtrlgt or ltShiftgt button while selecting applications)
dst
Defines the path to download PowerTerm WebConnect components on the client machine
The dst parameter can contain macros which are translated by the PowerTerm WebConnect
Client for Lotus Expeditor during runtime The macros should be placed between percent
symbols () for example WebServer
When such a value is defined the PowerTerm WebConnect Client for Lotus Expeditor
substitutes the entire expression for the macrorsquos value
The PowerTerm WebConnect Client for Lotus Expeditor does not support the use
of environment variables as macros
Macros are not case sensitive
Macros supported by PowerTerm WebConnect Client for Lotus Expeditor
Macro name Description
WebServer The name of the Web server
It is obtained from the PowerTerm WebConnect Agent url
PowerTerm WebConnect 32 Getting Started Guide
parameter
Name The name of the clientrsquos CAB or ZIP file eg ldquoptagentrdquo
Display The clientrsquos display name from the version file
Version The clientrsquos version value It is obtained from the version
file
Root The default root location
Windows ldquoCrdquo
LinuxUnix an empty string
OSDir Windows Windowsrsquo installation directory for example
ldquoCWindowsrdquo
Linux an empty string
OSDrive Windows Windowsrsquo installation drive for example ldquoCrdquo
Linux an empty string
HomePath Windows The HOMEPATH environment variable
Linux The HOME environment variable
Home The Ericom folder in the userrsquos home directory
Windows CDocuments and SettingsltusergtApplication
DataEricom
Linux ltusergtEricom
In addition to the predefined macros listed above the PowerTerm WebConnect client
supports the usage of Java System Properties
Java System Properties available for users on Windows XP SP2
Java System Property Name Value Example
javaversion 150
javavendorurl httpwwwibmcom
javahome CIBMcommonpluginscomibmpvcwctruntim
esj2sewin32x86_150SR2-
20060511rcpeclipsepluginscomibmrcpj2sew
in32x86_150SR2-20060511jre
javavmspecificationversion 10
javavmversion 23
javavmvendor IBM Corporation
javavmname IBM J9 VM
PowerTerm WebConnect 33 Getting Started Guide
javaiotmpdir CDOCUME~1dianaLOCALS~1Temp
javacompiler j9jit23
javaextdirs CIBMcommonpluginscomibmpvcwctruntim
esj2sewin32x86_150SR2-
20060511rcpeclipsepluginscomibmrcpj2sew
in32x86_150SR2-20060511jrelibext
osname Windows XP
osarch x86
osversion 51 build 2600 Service Pack 2
pathseparator
username Jone
userhome CDocuments and SettingsJone
userdir CIBMRSA
usertimezone GMT+0200
System properties available for users on Linux RedHat 9
Java System Property Name Value Example
javaversion 150
javavendorurl httpwwwibmcom
javahome usrjavajre150_07
javavmversion 150
javavmvendor IBM Corporation
javavmname IBM J9 VM
javaclasspath
javalibrarypath
javaiotmpdir tmp
javacompiler
javaextdirs
osname Linux
osarch i386
osversion 2420-8
pathseparator
PowerTerm WebConnect 34 Getting Started Guide
username root
userhome root
userdir root
System properties names are placed in the configuration file within percent symbols ()
(like macros)
671 Configure the PowerTerm WebConnect Client
1 Open the Config Folder and edit the webconnectxml file Example
ltxml version =rdquo10rdquo encoding=rdquoUTF-8rdquogt
ltsection name=rdquoparametersrdquogt
ltitem key=rdquourlrdquo value=httpadminserverWebConnect56gt
ltitem key=rdquoserverrdquo value=rdquoadmin24000rdquogt
ltitem key=rdquossordquo value=rdquotruerdquogt
ltitem key=rdquodestrdquo value=rdquoCProgram FilesEricomrdquogt
ltsectiongt
2 Save the customized webconnectxml to a Web server folder available to all users It is
recommended to use the same Web server as the PowerTerm WebConnect Agent
Example
ltWebConnect installation foldergtwebwebconnectxml
3 Test the accessibility to this file - Type the URL of webconnectxml in the browser
Example
httpltWebServer IPgtWebConnectwebconnectxml
The contents of the file should be displayed
672 Configure the Preferences File
1 Open the plugins folder and open the PowerTermWebConnectClient_560365jar file
You can use Winzip version 70 and up or in Windows XP ndash Create a new file type for the
jar extension click advanced and select compressed (zipped) folder in the drop down list
Now you can open the JAR files in the Windows Explorer
The default contents of the file
configURL=httpleericomcomWebConnectwebconnectxml
2 Specify the accurate URL of the webconnectxml file Example
httpltWebServer IPgtWebConnectwebconnectxml
3 Save the file and close it The WinZip will display the following dialog
ldquoFile preferencesini has been changed since it was extracted Update archive
with this filerdquo
PowerTerm WebConnect 35 Getting Started Guide
4 Click Yes and close the archive
If you are editing the file from within the explorer you will have to save the file elsewhere
and then drag it to the explorer window where the JAR file is open
68 Installing PowerTerm WebConnect Client on Lotus Expeditor
1 Start the Lotus Expeditor client
2 Select File | Application | Install
3 Select Search for new features to install and click Next
4 Select Add Folder Location and type or select the location of the update site folder from
the provided package Click OK
5 Select the location you have just created and click Finish
6 In the Select the feature to install tree select Powerterm WebConnectUpdate Site Click
Next
7 Select I accept the terms in the license agreements and click Next
8 Click Finish
9 When prompted restart the platform
69 Running PowerTerm WebConnect Client for Lotus Expeditor
1 Click Open The PowerTerm WebConnect option is displayed
2 Select PowerTerm WebConnect The application will automatically connect and start
downloading the components from PowerTerm WebConnect Server
IMPORTANT
If you did not install PowerTerm WebConnect Server and are instead connecting to Ericom
Softwarersquos Demo WebConnect Server then you need to open port 443 in the firewall
691 PowerTerm WebConnect Client Workflow
1 PowerTerm WebConnect client reads the URL of webconnectxml from the preferencesini
file and requests it
2 When the webconnectxml is successfully downloaded the application reads the
configuration connects to the specified Web server downloads the PowerTerm
WebConnect components and connects to the PowerTerm WebConnect Server
3 The user is requested to login to the PowerTerm WebConnect Server For testing you
can use the username Example and password example
This step will be skipped if Single Sign-on is set to ldquotruerdquo
PowerTerm WebConnect 36 Getting Started Guide
4 After logging in to PowerTerm WebConnect Server the userrsquos applications are displayed
as defined by the administrator
5 To run an application select the desired application from the list and click Launch or
double-click the application The application will be launched in a separate window
610 Troubleshooting
When you encounter a problem the first step is to open the log file This file is located on
the client machine in the Ericom folder
Windows
CDocuments and SettingsltusernamegtEricomleclientEricomPluginlog
Linux
ltuser-home-directorygtEricomleclientEricomPluginlog
Following is a guide for diagnosing and fixing the problems in cases of error messages and
additional information
Error
Message
Solution
Version File
reading error
1 Check the lsquourlrsquo parameter in the webconnectxml file on the Web
server The value should be
httpltWebServerIPgtWebConnect
2 Try to run the following URL on the browser
Windows
httpltWebServerIPgtWebConnectwindowsptagentvertxt
Linux
httpltWebServerIPgtWebConnectlinuxix86qterm-
wcvertxt
The file contents displayed in the browser window should be in
the following form
560-rel14546
PowerTerm WebConnect Application Zone
560 - Main Release
ltrootgtPowerTerm WebConnect 56ltWebServergt
If the version file contents are not as shown check
- Is the Web Server running
- Are PowerTerm WebConnect Web Components and version files
PowerTerm WebConnect 37 Getting Started Guide
in place
3 On the Web server check ltPowerTerm WebConnect
rootgtwebwindowsptagentvertxt If the contents ldquolook wrongrdquo or
not in the proper form reinstall the PowerTerm WebConnect Web
components
4 On the client machine open the aforementioned URL in the
browser The file content should appear in the browser If it does
not it could be that the Web server is down
Web Server is
shut down
The webconnectxml configuration file must be located on the Web
server The explicit URL to this file is defined in the preferencesini
file (see Configure the Preferences File)
The error message contains the IP address of the Web server
Verify that the Web server on this machine is running
Version file
does not exist
on ltURLgt
See Version File reading error
The
configuration
file is not
accessible or
has a wrong
format
The webconnectxml configuration file must be located on the Web
server and the explicit URL to the configuration must be defined in
the preferencesini file (see Configure the Preferences File)
Try to open the URL specified in the error message in the
browser If it does not open then it either does not exist or it has
a wrong format
Preferences
file does not
exist in the
application
bundle
The preferencesini file containing the URL to the configuration
file was removed from the update site folder
Uninstall the current PowerTerm WebConnect client from the
client machine Create a new customized package (see
PowerTerm WebConnect Client Configuration) and reinstall it
Configuration
file URL is not
defined in
preference
file
The URL to the configuration file does not appear in the
preferencesini file (see Configure the Preferences File)
Uninstall the current PowerTerm WebConnect client from the
client machine Create a new customized package (see
PowerTerm WebConnect Client Configuration) and reinstall it
No IP address
could be
found for the
host
The Web server URL specified in the preferencesini file (see
Configure the Preferences File) or in the webconnectxml file (see
Configure the PowerTerm WebConnect Client) is an unknown
host
If the mistake is in the preferencesini file uninstall the current
PowerTerm WebConnect client from the client machine Create a
new customized package (see PowerTerm WebConnect Client
Configuration) and reinstall it
PowerTerm WebConnect 38 Getting Started Guide
If the mistake is in the webconnectxml file correct the file reopen
the Lotus Expeditor client
Cannot write
to destination
The temporary file cannot be written to the defined destination
Check the write permissions
Copied
configuration
file has wrong
format
The webconnectxml file as received from the specified URL has a
wrong format Correct the file and try again
PowerTerm
WebConnect
Agent URL is
malformed
The PowerTerm WebConnect Agent URL specified in the
webconnectxml file (see Configure the PowerTerm WebConnect
Client) does not have a proper HTTP format Correct the file and
try again
PowerTerm
WebConnect
Agent URL is
not defined
The PowerTerm WebConnect Agent URL parameter is not specified
in the webconnectxml file (see Configure the PowerTerm
WebConnect Client)
Correct the file and try again
The specified
destination
folder name
is wrong
The destination folder name contains illegal characters
ltgt|
Check the dst parameter in the webconnectxml file Correct the
file and try again
You do not
have
permissions
to write to
ltpathgt
The PowerTerm WebConnect Agent cannot be written to the
destination as defined Check the write permissions
The default destination defined in the version file should not to
be changed
A customized destination for PowerTerm WebConnect Agent
downloading can be defined in the webconnectxml file (See
Configure the PowerTerm WebConnect Client)
Check the destination value correct and try again
PowerTerm WebConnect 39 Getting Started Guide
About Ericom
Ericomreg Software is a leading provider of Application Access and Virtualization Solutions
Since 1993 Ericom has been helping users access enterprise mission-critical applications
running on a broad range of Microsoftreg Windowsreg Terminal Servers virtual Desktops
Blade PCs legacy hosts and other systems Ericom provides concrete business value by
helping organizations realize the benefits of their IT investments With offices in the United
States United Kingdom EMEA India and China Ericom also has an extensive network of
distributors and partners throughout North America Europe Asia and the Far East Our
expanding customer base is more than 30 thousand strong with over 7 million
installations
For more information on our products and services contact us at the location nearest to you
And visit our web site httpwwwericomcom
North America Western Europe International
Ericom Software Inc Ericom Software (UK) Ltd Ericom Software Ltd
231 Herbert Avenue Bldg 4 11a Victoria Square 8 Hamarpeh Street
Closter NJ 07624 USA Droitwich Worcestershire Har Hotzvim Technology Park
Tel +1 (201) 767 2210 WR9 8DE United Kingdom Jerusalem 91450 Israel
Fax +1 (201) 767 2205 Tel +44 (0) 845 644 3597 Tel +972 (2) 591 1700
Toll-free 1 (888) 769 7876 Fax +44 (0) 845 644 3598 Fax +972 (2) 571 4737
Email infoericomcom Email infoericomcouk Email infoericomcom
PowerTerm WebConnect 19 Getting Started Guide
Microsoft Management Console 30 is required for PowerTerm WebConnect DeskView
Administration Tool If you do not have this installed you will also automatically be
prompted to install this update
Follow the installation processes when you are prompted for either install PowerTerm
WebConnect DeskView Administration Tool will automatically launch when these
installations are completed
42 Step 2 Add a Host
1 Right-click Virtualization Hosts and select Add Host The Add a New Host wizard
opens Click Next
2 Enter a Host Name as you would like it to appear in PowerTerm WebConnect
DeskView Administration Tool and a description (optional) Click Next
3 Specify the Virtualization Server type and click Next
4 Specify the connection information and click Next
VMWare Virtual Center v1x and 2x
Specify the HTTPS Web Service address and a UsernamePassword that can access
the host
VMWare Virtual Server 2005
Click Start and then Run
Type ldquoservicesmscrdquo and click OK
Scroll down to PowerTerm WebConnect DeskView Server service and open
Properties
Change the Login Account for the service to match the Domain Administrator
account and password used when setting up Microsoft Virtual Server 2005 and
restart the service Enter the IP or NETBIOS name of the Microsoft Virtual Server 2005 server as the
Server Address in the Connection Broker Wizard
Xen Server
Specify the hypervisor IP address or NETBIOS name the Root UsernamePassword
to the hypervisor and the Service port (default 80)
Oracle VM
Specify the Serverrsquos agent URL and Port (default 8899) for example
httpsltservernamegt8899
Specify the Oracle VM hypervisorrsquos Oracle Agent UsernamePassword (default
username oracle)
5 Click Finish to add the new Host
To configure Virtual Machines for use install the Ericom Tools (vmagentmsi) on each of the
virtual machines on the new host for PowerTerm WebConnect DeskView to recognize them
The vmagentmsi installer is located on the PowerTerm WebConnect server in ltPowerTerm
WebConnect installation foldergtAddOnsDeskView VDI folder (default installation
PowerTerm WebConnect 20 Getting Started Guide
folder is xProgram FilesEricom SoftwareWebConnect 56) During installation you
will need to enter the DeskView IP address or NETBIOS name
If you are using Microsoft Virtual Server 2005 as your Virtualization Host use the
IP address of the DeskView server only when installing the Ericom Tool package
43 Step 3 Create a Pool
Pools are used to organize Virtual Machines (VM) into logical groups This enables
organizations to combine and order resources from multiple systems into one entity To
access available resources end-users simply connect to PowerTerm WebConnect to access
any configured resource
1 Right-click Pools and select Create Pool The Create a Pool wizard opens Click
Next
2 Enter a Pool name as you wish it to appear and a description (optional) and click
Next
3 Specify the Pool type and click Next
4 Specify the Assignment type and click Next
Permanently will cause a virtual machine to affix to the user who has launched
that virtual machine For the duration of the session will cause any virtual machine that is not in use to
be returned to the pool for any user to launch
5 Specify the LogoffDisconnect event and click Next
Select what you would like to happen after a user logs off from a virtual machine
in this pool
Select what you would like to happen when a user is disconnected from a virtual
machine in this pool
6 Click Finish to add the new Pool
You will need to assign virtual machines from your virtualization hosts to your created pool
1 Right-click the pool and select Assign Machines The Assign Machines to ltyour
pool namegt dialog opens
2 Highlight the desired virtual machine(s) and click Select Click OK
44 Step 4 Publish an ApplicationDesktop
1 Return to PowerTerm WebConnect Admin Tool to publish DeskView pools
2 Determine whether to publish a full desktop or a seamless application running
from a virtual desktop
For a full desktop
Select Action | New | Remote Windows Desktop
For a seamless application
Select Action | New | Windows Application
PowerTerm WebConnect 21 Getting Started Guide
3 Select Virtual Desktop in the first step of the wizard and click Next
4 Follow the wizardrsquos instructions until you reach the Virtual Desktops step
5 Select a pool that you previously created and that you would like this connection to choose virtual machines from Click Next
6 Continue and complete the reminder of the wizardrsquos steps
Once the resource is published users who have been assigned access will be able to use it
immediately
PowerTerm WebConnect 22 Getting Started Guide
5 Download and Run PowerTerm WebConnect Clients
PowerTerm WebConnect clients are automatically downloaded and installed onto the client
devices For detailed information and samples please refer to the PowerTerm WebConnect
Sample URLs page To see this page navigate your browser to
httpltweb_servergtWebConnect5xClientURLshtml
PowerTerm WebConnect 23 Getting Started Guide
6 PowerTerm WebConnect Client for Lotus Expeditor
61 Installation Package
PowerTerm WebConnect client for Lotus Expeditor is provided to IBM in an Update Site
package This is a ZIP archive containing the Update Site with the Eclipse feature and plug-
in that comprises the PowerTerm WebConnect client
Extract the ZIP file keeping the foldersrsquo structure intact
NOTE In Winzip verify that the ldquoUse folder namesrdquo option is set to TRUE
Package structure
Update Site
- plugins
- PowerTermWebConnectClient_560365jar
- features
- comericomWebConnect_560365jar
- sitexml
config
- webconnectxml
Definitions
bull webconnectxml PowerTerm WebConnect client configuration file
bull comericomWebConnect_560365jar PowerTerm WebConnect client feature file
bull PowerTermWebConnectClient_560365jar PowerTerm WebConnect client plugin file
62 Pre-installation steps
PowerTerm WebConnect client for Lotus Expeditor does not run independently but in
conjunction with PowerTerm WebConnect Server You can either install it and define your
users groups and applications or use Ericom Softwarersquos Demo PowerTerm WebConnect
Server
bull If you decide to install PowerTerm WebConnect Server you will need the full
installation ie the PowerTerm WebConnect Server and the Web components If you
do not have the installation CD you can download and install a trial version from
wwwericomcom
PowerTerm WebConnect 24 Getting Started Guide
bull If you decide to use Ericom Softwarersquos Demo PowerTerm WebConnect Server then
skip to the chapter Installing PowerTerm WebConnect Client on Lotus Expeditor
63 Install PowerTerm WebConnect Portlet on IBM Workplace server (for Windows OS)
Step 1 Install PowerTerm WebConnect Server
If PowerTerm WebConnect Server and IBM Workplace Server are on separate machines
bull Configure PowerTerm WebConnect Server
Launch PowerTerm WebConnect Administration Tool
Open Files | Configuration | Main
In the [Portal] section edit
Machines=localhostltIBM sever machinegt
bull Configure PowerTerm WebConnect Web components
Copy the ldquowebrdquo folder from the PowerTerm WebConnect server installation to the
IBM Workplace server machine
Create an Alias or a Virtual directory to it named WebConnect on the Web
server providing access to it for the users This is in order to enable the users to
download the necessary files to run their applications
Step 2 Enable JSR portlets
1 On IBM Workplace Server go to ltPortalServergtsharedappconfigservicesConfigServiceproperties
2 Edit portalenablejsr168=true
3 Save and close the file
Step 3 Enable SSO
1 On IBM Workplace Server go to ltPortalServergtsharedappconfigservicesLoaderServiceproperties
2 Edit commandpath=comericomportalcommandscomibmwpsenginecommands
3 Save and close the file
Step 4 Copy Files
The following files need to be copied from WebConnect ServerAddOnsIBM
WorkplacePortlet folder to IBM Workplace Server
File name to copy Destination folder
OpenSSLdll ltAppServergtjavajrebin
IbmPortaldll ltAppServergtjavajrebin
IbmPortalini ltAppServergtjavajrebin
PowerTerm WebConnect 25 Getting Started Guide
WebConnectPortaljar ltAppServergtlib
EricomLoginjar ltPortalServergtsharedapp
Step 5 Portlet Configuration
1 On IBM Workplace Server go to ltAppServergtjavajrebinIbmPortalini
2 You can modify the following parameters in the [Server=WebConnect] section webserverport=ltIBM web server portgt
Specifies the Web server port for accessing the PowerTerm WebConnect clients folder
Default 80 Address
Specifies the address of the PowerTerm WebConnect Server machine for Portlet to
connect to when PowerTerm WebConnect Server is located on a different machine
than the IBM Workplace Server CustomAddress
Specifies the addresss of the PowerTerm WebConnect Server machine for Clients to connect to If CustomAddress is the same as Address then this may be omitted webserveraddr
Specifies the address of the Web Server machine when it is located on a different
machine than the IBM Workplace Server
3 Restart the IBM server ltPortalServergtrootscriptsstopWorkplaceServicesbat ltPortalServergtrootscriptsstartWorkplaceServicesbat
This procedure may take about 20 minutes
Step 6 Install the Portlet
1 In a Web browser open the URL httpltIBM Workplace
Servergt9081lwpmyworkplace to open the IBM Workplace Portal
2 Login as administrator
3 Go to Administration | Portlets | Install
4 Browse to the PowerTerm WebConnectwar file located on PowerTerm WebConnect
Server and click Next
5 Click Install
Step 7 Create an Application page
1 Login to the Workplace
2 Go to Portal User Interface | Manage Pages
3 Search for My Work
4 Click the My Work link and select New Page
5 Name the page PowerTerm WebConnect and click OK
6 Click OK again You will see the created page on the list
7 Click the pencil icon on the new page and select the 1 square layout
PowerTerm WebConnect 26 Getting Started Guide
8 Click Add Portlet and search for PowerTerm WebConnect
9 Select it and click OK
10 Click Done
11 Click My work at the top of the page PowerTerm WebConnect is displayed on the list
Step 8 Run the Portlet
1 Restart IBM Workplace Server
2 Open IBM Workplace Portal in a browser httpltportal servergtlwpmyworkplace
3 Login to IBM Workplace Server
4 Click My work PowerTerm WebConnect portlet is displayed
5 Launch it The Userrsquos applications as defined on PowerTerm WebConnect Server
appear
6 Click an application to launch it
64 Install PowerTerm WebConnect Portlet on IBM Workplace server (for Linux OS)
Step 1 Enable JSR 168 portlets
1 Go to optIBMWorkplacePortalServersharedappconfigservicesConfigServiceproperties
2 Modify the portalenablejsr168 property to ldquotruerdquo
3 Restart the server cd optIBMWorkplacePortalServerrootscripts
Run stopWorkplaceServicessh
Run startWorkplaceServicessh
This procedure can take up to 20 minutes
4 Log on to the workplace server at httpltworkplace servergt9081lwpmyworkplace using
the administrators username and password
Step 2 Install the portlet
1 Restart IBM Workplace Server
2 In a Web browser open the URL httpltworkplace server IPgtlwpmyworkplace
3 Login to IBM Workplace Server as an administrator
4 Go to Administration | Portlets | Install
5 Browse to the PowerTerm WebConnectwar file located on PowerTerm WebConnect
Server and click Next
6 Click Install
PowerTerm WebConnect 27 Getting Started Guide
Step 3 Install the Application page
1 Login to the workplace as administrator
2 Go to Administration | Portal User Interface | Manage Pages
3 Search for My Work
4 Click the My Work link and select New Page
5 Name the page PowerTerm WebConnect and click OK
6 Click OK again You will see the created page on the list
7 Click the pencil icon and select the 1-square layout
8 Click Add Portlet and search for PowerTerm WebConnect
9 Select it and click OK
10 Click Done
11 Click My work on top and PowerTerm WebConnect is displayed on the left bar
Step 4 Run the portlet
1 Restart IBM Workplace Server
2 Open IBM Workplace Portal in a browser httpltportal servergtlwpmyworkplace
3 Login to IBM Workplace Server
4 Click My work PowerTerm WebConnect portlet is displayed
5 Launch it The Userrsquos applications as defined on PowerTerm WebConnect Server
appear
6 Click an application to launch it
65 Install PowerTerm WebConnect Portlet on IBM WebSphere 61 server (for Windows OS)
Step 1 Install PowerTerm WebConnect Server
You have to configure PowerTerm WebConnect Server if it and the IBM WebSphere Server
are on separate machines
1 Launch PowerTerm WebConnect Administration Tool
2 Open Files | Configuration | Main
3 In the [Portal] section edit Machines=localhostltIBM sever machinegt
Step 2 Copy Files
The following files need to be copied from WebConnect ServerAddOnsIBM
WebSpherePortlet folder to IBM WebSphere Server
PowerTerm WebConnect 28 Getting Started Guide
File name to copy Destination folder
OpenSSLdll ltAppServergtjavajrebin
IbmPortaldll ltAppServergtjavajrebin
IbmPortalini ltAppServergtjavajrebin
WebConnectPortaljar ltAppServergtlib
Step 3 Portlet Configuration
1 On IBM Workplace Server go to ltAppServergtjavajrebinIbmPortalini
2 You can modify the following parameters in the [Server=WebConnect] section webserverport=ltIBM web server portgt
Specifies the Web server port for accessing the PowerTerm WebConnect clients folder
Default 80 Address
Specifies the address of the PowerTerm WebConnect Server machine for Portlet to
connect to when PowerTerm WebConnect Server is located on a different machine
than the IBM Workplace Server CustomAddress
Specifies the addresss of the PowerTerm WebConnect Server machine for Clients to connect to If CustomAddress is the same as Address then this may be omitted webserveraddr
Specifies the address of the Web Server machine when it is located on a different
machine than the IBM Workplace Server
3 Restart the IBM server ltAppServergtProfilesAppServer01binstopServerbat ltAppServergtProfilesAppServer01binstartServerbat
This procedure may take about 20 minutes
Step 4 Install the Portlet and create an Application page
1 In a Web browser open the URL httpltIBM WebSphere Servergt9060ibmconsole
to open the IBM WebSphere Portal
2 Login and go to Applications | Install New Application
3 Browse to the PowerTerm WebConnectwar file located on PowerTerm WebConnect
Server
4 Enter Context root and click Next The Select installation options dialog appears
5 Optional change options to your preference or keep the default
6 Click Next
7 Select Ericom in the Module column click Apply and then Next
8 Click Finish and then Save
9 Select Applications | Enterprise Applications
10 Select PowerTerm WebConnectwar checkbox and click Start
PowerTerm WebConnect 29 Getting Started Guide
11 Enter in the Web browser the URL httpltIBM WebSphere
Servergt9080ltContext rootgtEricom portlet The Login dialog appears
12 Login and you will see PowerTerm WebConnect displayed on the list
Step 5 Run the Portlet
1 Restart IBM WebSphere Server
2 Open IBM WebSphere Portal in a browser httpltportal servergt9080ltContext
rootgtEricom portlet
3 Login to IBM WebSphere Server
4 Launch it The Userrsquos applications as defined on PowerTerm WebConnect Server
appear
5 Click an application to launch it
66 PowerTerm WebConnect Server Configuration
bull To enable the Lotus Expeditor to run the PowerTerm WebConnect client the
System Administrator must provide the users with accounts on PowerTerm
WebConnect Server (see the PowerTerm WebConnect Administratorrsquos Manual for
instructions on how to create users groups and connections on the PowerTerm
WebConnect Server)
bull To enable PowerTerm WebConnectrsquos Single Sign-On feature the System
Administrator must create a PowerTerm WebConnect user with the same
username and password as used for the Lotus Expeditor For a managed Lotus
Expeditor the credentials used are the username and password sent to the
managing server For an unmanaged Lotus Expeditor the operation system
username and the Lotus Expeditor password are used as credentials
NOTE If a password is not defined then the Single Sign-On will fail and the user will be
prompted with a login dialog
67 PowerTerm WebConnect Client Configuration
The PowerTerm WebConnect client is configured in webconnectxml located in the config
folder webconnectxml parameters are
url The PowerTerm WebConnect Agent url
server The PowerTerm WebConnect Server address
sso The Single Sign-On feature
dst The local destination for downloading PowerTerm WebConnect
components
PowerTerm WebConnect 30 Getting Started Guide
url
PowerTerm WebConnect components are installed on a Web server Their default url is
Windows Agent
httpltWebServer IPgtWebConnectwindowsptagentcab
Linux Agent
httpltWebServer IPgtWebConnectlinuxix86qterm-wczip
The url parameter must include the first part of the url (which is identical for both Windows
and Linux agents)
The PowerTerm WebConnect client will automatically append the appropriate suffix in
order to create a full accurate url
Example
ltitem key=rdquourlrdquo value=httpadminserverWebConnectgt
server
The computer name or IP address of the PowerTerm WebConnect Server machine
The PowerTerm WebConnect client will log in to this PowerTerm WebConnect Server
display the applications defined on it and run them according to this serverrsquos configuration
Format ltserver IPgt[ltportgt]
where default port is 4000 (can be edited)
Example
ltitem key=rdquoserverrdquo value=rdquoadmin24000rdquogt
sso
Determines whether Single Sign-on will be used to log in to PowerTerm WebConnect
Server Values
bull True (default) the client should automatically log in to the PowerTerm WebConnect
Server using the same credentials as the ones used to log in to the Lotus Expeditor
client
The System Administrator must verify that these credentials can log in to the
PowerTerm WebConnect Server
bull False the user will be prompted with a login dialog or will log in automatically using
previously saved credentials
Example
ltitem key=rdquossordquo value=rdquotruerdquogt
Autologin mode
PowerTerm WebConnect 31 Getting Started Guide
If sso is set to True the user is not prompted for credentials and the login process to
PowerTerm WebConnect Server is done automatically sending the credentials used for the
Lotus Expeditor unless the Lotus Expeditor does not have a password defined (In the
Lotus Expeditor preferences page | Password| Prompt me for a password at start up checkbox)
However if Single Sign-on is not used there are several options regarding Autologin that
can be defined in the PowerTerm WebConnect Preferences page Options
bull Yes
bull No
bull Interactive
bull First time interactive (default) ndash Simplifies the login process to PowerTerm
WebConnect Server In this mode the first time the user logs in to PowerTerm
WebConnect Server he will be prompted for his credentials with the Login dialog
These credentials will be stored in the machine and from then on the login process to
PowerTerm WebConnect Server will be done automatically
1 Open File | Preferences from the Lotus Expeditor and select PowerTerm WebConnect
2 In the Autologin to WebConnect Server section select First Interactive and click OK
3 Start PowerTerm WebConnect Client for Lotus Expeditor If credentials were entered
at least once then the next time the client will connect to PowerTerm WebConnect
Server without prompting for the user name and password
The Administrator must configure the Agent to do nothing when it exits for the
feature to work this way See PowerTerm WebConnect Administratorrsquos Manual for more information about defining Autologin
bull Allow multiple selection ndash Defines whether the user can launch more than one
application at a time (by using the ltCtrlgt or ltShiftgt button while selecting applications)
dst
Defines the path to download PowerTerm WebConnect components on the client machine
The dst parameter can contain macros which are translated by the PowerTerm WebConnect
Client for Lotus Expeditor during runtime The macros should be placed between percent
symbols () for example WebServer
When such a value is defined the PowerTerm WebConnect Client for Lotus Expeditor
substitutes the entire expression for the macrorsquos value
The PowerTerm WebConnect Client for Lotus Expeditor does not support the use
of environment variables as macros
Macros are not case sensitive
Macros supported by PowerTerm WebConnect Client for Lotus Expeditor
Macro name Description
WebServer The name of the Web server
It is obtained from the PowerTerm WebConnect Agent url
PowerTerm WebConnect 32 Getting Started Guide
parameter
Name The name of the clientrsquos CAB or ZIP file eg ldquoptagentrdquo
Display The clientrsquos display name from the version file
Version The clientrsquos version value It is obtained from the version
file
Root The default root location
Windows ldquoCrdquo
LinuxUnix an empty string
OSDir Windows Windowsrsquo installation directory for example
ldquoCWindowsrdquo
Linux an empty string
OSDrive Windows Windowsrsquo installation drive for example ldquoCrdquo
Linux an empty string
HomePath Windows The HOMEPATH environment variable
Linux The HOME environment variable
Home The Ericom folder in the userrsquos home directory
Windows CDocuments and SettingsltusergtApplication
DataEricom
Linux ltusergtEricom
In addition to the predefined macros listed above the PowerTerm WebConnect client
supports the usage of Java System Properties
Java System Properties available for users on Windows XP SP2
Java System Property Name Value Example
javaversion 150
javavendorurl httpwwwibmcom
javahome CIBMcommonpluginscomibmpvcwctruntim
esj2sewin32x86_150SR2-
20060511rcpeclipsepluginscomibmrcpj2sew
in32x86_150SR2-20060511jre
javavmspecificationversion 10
javavmversion 23
javavmvendor IBM Corporation
javavmname IBM J9 VM
PowerTerm WebConnect 33 Getting Started Guide
javaiotmpdir CDOCUME~1dianaLOCALS~1Temp
javacompiler j9jit23
javaextdirs CIBMcommonpluginscomibmpvcwctruntim
esj2sewin32x86_150SR2-
20060511rcpeclipsepluginscomibmrcpj2sew
in32x86_150SR2-20060511jrelibext
osname Windows XP
osarch x86
osversion 51 build 2600 Service Pack 2
pathseparator
username Jone
userhome CDocuments and SettingsJone
userdir CIBMRSA
usertimezone GMT+0200
System properties available for users on Linux RedHat 9
Java System Property Name Value Example
javaversion 150
javavendorurl httpwwwibmcom
javahome usrjavajre150_07
javavmversion 150
javavmvendor IBM Corporation
javavmname IBM J9 VM
javaclasspath
javalibrarypath
javaiotmpdir tmp
javacompiler
javaextdirs
osname Linux
osarch i386
osversion 2420-8
pathseparator
PowerTerm WebConnect 34 Getting Started Guide
username root
userhome root
userdir root
System properties names are placed in the configuration file within percent symbols ()
(like macros)
671 Configure the PowerTerm WebConnect Client
1 Open the Config Folder and edit the webconnectxml file Example
ltxml version =rdquo10rdquo encoding=rdquoUTF-8rdquogt
ltsection name=rdquoparametersrdquogt
ltitem key=rdquourlrdquo value=httpadminserverWebConnect56gt
ltitem key=rdquoserverrdquo value=rdquoadmin24000rdquogt
ltitem key=rdquossordquo value=rdquotruerdquogt
ltitem key=rdquodestrdquo value=rdquoCProgram FilesEricomrdquogt
ltsectiongt
2 Save the customized webconnectxml to a Web server folder available to all users It is
recommended to use the same Web server as the PowerTerm WebConnect Agent
Example
ltWebConnect installation foldergtwebwebconnectxml
3 Test the accessibility to this file - Type the URL of webconnectxml in the browser
Example
httpltWebServer IPgtWebConnectwebconnectxml
The contents of the file should be displayed
672 Configure the Preferences File
1 Open the plugins folder and open the PowerTermWebConnectClient_560365jar file
You can use Winzip version 70 and up or in Windows XP ndash Create a new file type for the
jar extension click advanced and select compressed (zipped) folder in the drop down list
Now you can open the JAR files in the Windows Explorer
The default contents of the file
configURL=httpleericomcomWebConnectwebconnectxml
2 Specify the accurate URL of the webconnectxml file Example
httpltWebServer IPgtWebConnectwebconnectxml
3 Save the file and close it The WinZip will display the following dialog
ldquoFile preferencesini has been changed since it was extracted Update archive
with this filerdquo
PowerTerm WebConnect 35 Getting Started Guide
4 Click Yes and close the archive
If you are editing the file from within the explorer you will have to save the file elsewhere
and then drag it to the explorer window where the JAR file is open
68 Installing PowerTerm WebConnect Client on Lotus Expeditor
1 Start the Lotus Expeditor client
2 Select File | Application | Install
3 Select Search for new features to install and click Next
4 Select Add Folder Location and type or select the location of the update site folder from
the provided package Click OK
5 Select the location you have just created and click Finish
6 In the Select the feature to install tree select Powerterm WebConnectUpdate Site Click
Next
7 Select I accept the terms in the license agreements and click Next
8 Click Finish
9 When prompted restart the platform
69 Running PowerTerm WebConnect Client for Lotus Expeditor
1 Click Open The PowerTerm WebConnect option is displayed
2 Select PowerTerm WebConnect The application will automatically connect and start
downloading the components from PowerTerm WebConnect Server
IMPORTANT
If you did not install PowerTerm WebConnect Server and are instead connecting to Ericom
Softwarersquos Demo WebConnect Server then you need to open port 443 in the firewall
691 PowerTerm WebConnect Client Workflow
1 PowerTerm WebConnect client reads the URL of webconnectxml from the preferencesini
file and requests it
2 When the webconnectxml is successfully downloaded the application reads the
configuration connects to the specified Web server downloads the PowerTerm
WebConnect components and connects to the PowerTerm WebConnect Server
3 The user is requested to login to the PowerTerm WebConnect Server For testing you
can use the username Example and password example
This step will be skipped if Single Sign-on is set to ldquotruerdquo
PowerTerm WebConnect 36 Getting Started Guide
4 After logging in to PowerTerm WebConnect Server the userrsquos applications are displayed
as defined by the administrator
5 To run an application select the desired application from the list and click Launch or
double-click the application The application will be launched in a separate window
610 Troubleshooting
When you encounter a problem the first step is to open the log file This file is located on
the client machine in the Ericom folder
Windows
CDocuments and SettingsltusernamegtEricomleclientEricomPluginlog
Linux
ltuser-home-directorygtEricomleclientEricomPluginlog
Following is a guide for diagnosing and fixing the problems in cases of error messages and
additional information
Error
Message
Solution
Version File
reading error
1 Check the lsquourlrsquo parameter in the webconnectxml file on the Web
server The value should be
httpltWebServerIPgtWebConnect
2 Try to run the following URL on the browser
Windows
httpltWebServerIPgtWebConnectwindowsptagentvertxt
Linux
httpltWebServerIPgtWebConnectlinuxix86qterm-
wcvertxt
The file contents displayed in the browser window should be in
the following form
560-rel14546
PowerTerm WebConnect Application Zone
560 - Main Release
ltrootgtPowerTerm WebConnect 56ltWebServergt
If the version file contents are not as shown check
- Is the Web Server running
- Are PowerTerm WebConnect Web Components and version files
PowerTerm WebConnect 37 Getting Started Guide
in place
3 On the Web server check ltPowerTerm WebConnect
rootgtwebwindowsptagentvertxt If the contents ldquolook wrongrdquo or
not in the proper form reinstall the PowerTerm WebConnect Web
components
4 On the client machine open the aforementioned URL in the
browser The file content should appear in the browser If it does
not it could be that the Web server is down
Web Server is
shut down
The webconnectxml configuration file must be located on the Web
server The explicit URL to this file is defined in the preferencesini
file (see Configure the Preferences File)
The error message contains the IP address of the Web server
Verify that the Web server on this machine is running
Version file
does not exist
on ltURLgt
See Version File reading error
The
configuration
file is not
accessible or
has a wrong
format
The webconnectxml configuration file must be located on the Web
server and the explicit URL to the configuration must be defined in
the preferencesini file (see Configure the Preferences File)
Try to open the URL specified in the error message in the
browser If it does not open then it either does not exist or it has
a wrong format
Preferences
file does not
exist in the
application
bundle
The preferencesini file containing the URL to the configuration
file was removed from the update site folder
Uninstall the current PowerTerm WebConnect client from the
client machine Create a new customized package (see
PowerTerm WebConnect Client Configuration) and reinstall it
Configuration
file URL is not
defined in
preference
file
The URL to the configuration file does not appear in the
preferencesini file (see Configure the Preferences File)
Uninstall the current PowerTerm WebConnect client from the
client machine Create a new customized package (see
PowerTerm WebConnect Client Configuration) and reinstall it
No IP address
could be
found for the
host
The Web server URL specified in the preferencesini file (see
Configure the Preferences File) or in the webconnectxml file (see
Configure the PowerTerm WebConnect Client) is an unknown
host
If the mistake is in the preferencesini file uninstall the current
PowerTerm WebConnect client from the client machine Create a
new customized package (see PowerTerm WebConnect Client
Configuration) and reinstall it
PowerTerm WebConnect 38 Getting Started Guide
If the mistake is in the webconnectxml file correct the file reopen
the Lotus Expeditor client
Cannot write
to destination
The temporary file cannot be written to the defined destination
Check the write permissions
Copied
configuration
file has wrong
format
The webconnectxml file as received from the specified URL has a
wrong format Correct the file and try again
PowerTerm
WebConnect
Agent URL is
malformed
The PowerTerm WebConnect Agent URL specified in the
webconnectxml file (see Configure the PowerTerm WebConnect
Client) does not have a proper HTTP format Correct the file and
try again
PowerTerm
WebConnect
Agent URL is
not defined
The PowerTerm WebConnect Agent URL parameter is not specified
in the webconnectxml file (see Configure the PowerTerm
WebConnect Client)
Correct the file and try again
The specified
destination
folder name
is wrong
The destination folder name contains illegal characters
ltgt|
Check the dst parameter in the webconnectxml file Correct the
file and try again
You do not
have
permissions
to write to
ltpathgt
The PowerTerm WebConnect Agent cannot be written to the
destination as defined Check the write permissions
The default destination defined in the version file should not to
be changed
A customized destination for PowerTerm WebConnect Agent
downloading can be defined in the webconnectxml file (See
Configure the PowerTerm WebConnect Client)
Check the destination value correct and try again
PowerTerm WebConnect 39 Getting Started Guide
About Ericom
Ericomreg Software is a leading provider of Application Access and Virtualization Solutions
Since 1993 Ericom has been helping users access enterprise mission-critical applications
running on a broad range of Microsoftreg Windowsreg Terminal Servers virtual Desktops
Blade PCs legacy hosts and other systems Ericom provides concrete business value by
helping organizations realize the benefits of their IT investments With offices in the United
States United Kingdom EMEA India and China Ericom also has an extensive network of
distributors and partners throughout North America Europe Asia and the Far East Our
expanding customer base is more than 30 thousand strong with over 7 million
installations
For more information on our products and services contact us at the location nearest to you
And visit our web site httpwwwericomcom
North America Western Europe International
Ericom Software Inc Ericom Software (UK) Ltd Ericom Software Ltd
231 Herbert Avenue Bldg 4 11a Victoria Square 8 Hamarpeh Street
Closter NJ 07624 USA Droitwich Worcestershire Har Hotzvim Technology Park
Tel +1 (201) 767 2210 WR9 8DE United Kingdom Jerusalem 91450 Israel
Fax +1 (201) 767 2205 Tel +44 (0) 845 644 3597 Tel +972 (2) 591 1700
Toll-free 1 (888) 769 7876 Fax +44 (0) 845 644 3598 Fax +972 (2) 571 4737
Email infoericomcom Email infoericomcouk Email infoericomcom
PowerTerm WebConnect 20 Getting Started Guide
folder is xProgram FilesEricom SoftwareWebConnect 56) During installation you
will need to enter the DeskView IP address or NETBIOS name
If you are using Microsoft Virtual Server 2005 as your Virtualization Host use the
IP address of the DeskView server only when installing the Ericom Tool package
43 Step 3 Create a Pool
Pools are used to organize Virtual Machines (VM) into logical groups This enables
organizations to combine and order resources from multiple systems into one entity To
access available resources end-users simply connect to PowerTerm WebConnect to access
any configured resource
1 Right-click Pools and select Create Pool The Create a Pool wizard opens Click
Next
2 Enter a Pool name as you wish it to appear and a description (optional) and click
Next
3 Specify the Pool type and click Next
4 Specify the Assignment type and click Next
Permanently will cause a virtual machine to affix to the user who has launched
that virtual machine For the duration of the session will cause any virtual machine that is not in use to
be returned to the pool for any user to launch
5 Specify the LogoffDisconnect event and click Next
Select what you would like to happen after a user logs off from a virtual machine
in this pool
Select what you would like to happen when a user is disconnected from a virtual
machine in this pool
6 Click Finish to add the new Pool
You will need to assign virtual machines from your virtualization hosts to your created pool
1 Right-click the pool and select Assign Machines The Assign Machines to ltyour
pool namegt dialog opens
2 Highlight the desired virtual machine(s) and click Select Click OK
44 Step 4 Publish an ApplicationDesktop
1 Return to PowerTerm WebConnect Admin Tool to publish DeskView pools
2 Determine whether to publish a full desktop or a seamless application running
from a virtual desktop
For a full desktop
Select Action | New | Remote Windows Desktop
For a seamless application
Select Action | New | Windows Application
PowerTerm WebConnect 21 Getting Started Guide
3 Select Virtual Desktop in the first step of the wizard and click Next
4 Follow the wizardrsquos instructions until you reach the Virtual Desktops step
5 Select a pool that you previously created and that you would like this connection to choose virtual machines from Click Next
6 Continue and complete the reminder of the wizardrsquos steps
Once the resource is published users who have been assigned access will be able to use it
immediately
PowerTerm WebConnect 22 Getting Started Guide
5 Download and Run PowerTerm WebConnect Clients
PowerTerm WebConnect clients are automatically downloaded and installed onto the client
devices For detailed information and samples please refer to the PowerTerm WebConnect
Sample URLs page To see this page navigate your browser to
httpltweb_servergtWebConnect5xClientURLshtml
PowerTerm WebConnect 23 Getting Started Guide
6 PowerTerm WebConnect Client for Lotus Expeditor
61 Installation Package
PowerTerm WebConnect client for Lotus Expeditor is provided to IBM in an Update Site
package This is a ZIP archive containing the Update Site with the Eclipse feature and plug-
in that comprises the PowerTerm WebConnect client
Extract the ZIP file keeping the foldersrsquo structure intact
NOTE In Winzip verify that the ldquoUse folder namesrdquo option is set to TRUE
Package structure
Update Site
- plugins
- PowerTermWebConnectClient_560365jar
- features
- comericomWebConnect_560365jar
- sitexml
config
- webconnectxml
Definitions
bull webconnectxml PowerTerm WebConnect client configuration file
bull comericomWebConnect_560365jar PowerTerm WebConnect client feature file
bull PowerTermWebConnectClient_560365jar PowerTerm WebConnect client plugin file
62 Pre-installation steps
PowerTerm WebConnect client for Lotus Expeditor does not run independently but in
conjunction with PowerTerm WebConnect Server You can either install it and define your
users groups and applications or use Ericom Softwarersquos Demo PowerTerm WebConnect
Server
bull If you decide to install PowerTerm WebConnect Server you will need the full
installation ie the PowerTerm WebConnect Server and the Web components If you
do not have the installation CD you can download and install a trial version from
wwwericomcom
PowerTerm WebConnect 24 Getting Started Guide
bull If you decide to use Ericom Softwarersquos Demo PowerTerm WebConnect Server then
skip to the chapter Installing PowerTerm WebConnect Client on Lotus Expeditor
63 Install PowerTerm WebConnect Portlet on IBM Workplace server (for Windows OS)
Step 1 Install PowerTerm WebConnect Server
If PowerTerm WebConnect Server and IBM Workplace Server are on separate machines
bull Configure PowerTerm WebConnect Server
Launch PowerTerm WebConnect Administration Tool
Open Files | Configuration | Main
In the [Portal] section edit
Machines=localhostltIBM sever machinegt
bull Configure PowerTerm WebConnect Web components
Copy the ldquowebrdquo folder from the PowerTerm WebConnect server installation to the
IBM Workplace server machine
Create an Alias or a Virtual directory to it named WebConnect on the Web
server providing access to it for the users This is in order to enable the users to
download the necessary files to run their applications
Step 2 Enable JSR portlets
1 On IBM Workplace Server go to ltPortalServergtsharedappconfigservicesConfigServiceproperties
2 Edit portalenablejsr168=true
3 Save and close the file
Step 3 Enable SSO
1 On IBM Workplace Server go to ltPortalServergtsharedappconfigservicesLoaderServiceproperties
2 Edit commandpath=comericomportalcommandscomibmwpsenginecommands
3 Save and close the file
Step 4 Copy Files
The following files need to be copied from WebConnect ServerAddOnsIBM
WorkplacePortlet folder to IBM Workplace Server
File name to copy Destination folder
OpenSSLdll ltAppServergtjavajrebin
IbmPortaldll ltAppServergtjavajrebin
IbmPortalini ltAppServergtjavajrebin
PowerTerm WebConnect 25 Getting Started Guide
WebConnectPortaljar ltAppServergtlib
EricomLoginjar ltPortalServergtsharedapp
Step 5 Portlet Configuration
1 On IBM Workplace Server go to ltAppServergtjavajrebinIbmPortalini
2 You can modify the following parameters in the [Server=WebConnect] section webserverport=ltIBM web server portgt
Specifies the Web server port for accessing the PowerTerm WebConnect clients folder
Default 80 Address
Specifies the address of the PowerTerm WebConnect Server machine for Portlet to
connect to when PowerTerm WebConnect Server is located on a different machine
than the IBM Workplace Server CustomAddress
Specifies the addresss of the PowerTerm WebConnect Server machine for Clients to connect to If CustomAddress is the same as Address then this may be omitted webserveraddr
Specifies the address of the Web Server machine when it is located on a different
machine than the IBM Workplace Server
3 Restart the IBM server ltPortalServergtrootscriptsstopWorkplaceServicesbat ltPortalServergtrootscriptsstartWorkplaceServicesbat
This procedure may take about 20 minutes
Step 6 Install the Portlet
1 In a Web browser open the URL httpltIBM Workplace
Servergt9081lwpmyworkplace to open the IBM Workplace Portal
2 Login as administrator
3 Go to Administration | Portlets | Install
4 Browse to the PowerTerm WebConnectwar file located on PowerTerm WebConnect
Server and click Next
5 Click Install
Step 7 Create an Application page
1 Login to the Workplace
2 Go to Portal User Interface | Manage Pages
3 Search for My Work
4 Click the My Work link and select New Page
5 Name the page PowerTerm WebConnect and click OK
6 Click OK again You will see the created page on the list
7 Click the pencil icon on the new page and select the 1 square layout
PowerTerm WebConnect 26 Getting Started Guide
8 Click Add Portlet and search for PowerTerm WebConnect
9 Select it and click OK
10 Click Done
11 Click My work at the top of the page PowerTerm WebConnect is displayed on the list
Step 8 Run the Portlet
1 Restart IBM Workplace Server
2 Open IBM Workplace Portal in a browser httpltportal servergtlwpmyworkplace
3 Login to IBM Workplace Server
4 Click My work PowerTerm WebConnect portlet is displayed
5 Launch it The Userrsquos applications as defined on PowerTerm WebConnect Server
appear
6 Click an application to launch it
64 Install PowerTerm WebConnect Portlet on IBM Workplace server (for Linux OS)
Step 1 Enable JSR 168 portlets
1 Go to optIBMWorkplacePortalServersharedappconfigservicesConfigServiceproperties
2 Modify the portalenablejsr168 property to ldquotruerdquo
3 Restart the server cd optIBMWorkplacePortalServerrootscripts
Run stopWorkplaceServicessh
Run startWorkplaceServicessh
This procedure can take up to 20 minutes
4 Log on to the workplace server at httpltworkplace servergt9081lwpmyworkplace using
the administrators username and password
Step 2 Install the portlet
1 Restart IBM Workplace Server
2 In a Web browser open the URL httpltworkplace server IPgtlwpmyworkplace
3 Login to IBM Workplace Server as an administrator
4 Go to Administration | Portlets | Install
5 Browse to the PowerTerm WebConnectwar file located on PowerTerm WebConnect
Server and click Next
6 Click Install
PowerTerm WebConnect 27 Getting Started Guide
Step 3 Install the Application page
1 Login to the workplace as administrator
2 Go to Administration | Portal User Interface | Manage Pages
3 Search for My Work
4 Click the My Work link and select New Page
5 Name the page PowerTerm WebConnect and click OK
6 Click OK again You will see the created page on the list
7 Click the pencil icon and select the 1-square layout
8 Click Add Portlet and search for PowerTerm WebConnect
9 Select it and click OK
10 Click Done
11 Click My work on top and PowerTerm WebConnect is displayed on the left bar
Step 4 Run the portlet
1 Restart IBM Workplace Server
2 Open IBM Workplace Portal in a browser httpltportal servergtlwpmyworkplace
3 Login to IBM Workplace Server
4 Click My work PowerTerm WebConnect portlet is displayed
5 Launch it The Userrsquos applications as defined on PowerTerm WebConnect Server
appear
6 Click an application to launch it
65 Install PowerTerm WebConnect Portlet on IBM WebSphere 61 server (for Windows OS)
Step 1 Install PowerTerm WebConnect Server
You have to configure PowerTerm WebConnect Server if it and the IBM WebSphere Server
are on separate machines
1 Launch PowerTerm WebConnect Administration Tool
2 Open Files | Configuration | Main
3 In the [Portal] section edit Machines=localhostltIBM sever machinegt
Step 2 Copy Files
The following files need to be copied from WebConnect ServerAddOnsIBM
WebSpherePortlet folder to IBM WebSphere Server
PowerTerm WebConnect 28 Getting Started Guide
File name to copy Destination folder
OpenSSLdll ltAppServergtjavajrebin
IbmPortaldll ltAppServergtjavajrebin
IbmPortalini ltAppServergtjavajrebin
WebConnectPortaljar ltAppServergtlib
Step 3 Portlet Configuration
1 On IBM Workplace Server go to ltAppServergtjavajrebinIbmPortalini
2 You can modify the following parameters in the [Server=WebConnect] section webserverport=ltIBM web server portgt
Specifies the Web server port for accessing the PowerTerm WebConnect clients folder
Default 80 Address
Specifies the address of the PowerTerm WebConnect Server machine for Portlet to
connect to when PowerTerm WebConnect Server is located on a different machine
than the IBM Workplace Server CustomAddress
Specifies the addresss of the PowerTerm WebConnect Server machine for Clients to connect to If CustomAddress is the same as Address then this may be omitted webserveraddr
Specifies the address of the Web Server machine when it is located on a different
machine than the IBM Workplace Server
3 Restart the IBM server ltAppServergtProfilesAppServer01binstopServerbat ltAppServergtProfilesAppServer01binstartServerbat
This procedure may take about 20 minutes
Step 4 Install the Portlet and create an Application page
1 In a Web browser open the URL httpltIBM WebSphere Servergt9060ibmconsole
to open the IBM WebSphere Portal
2 Login and go to Applications | Install New Application
3 Browse to the PowerTerm WebConnectwar file located on PowerTerm WebConnect
Server
4 Enter Context root and click Next The Select installation options dialog appears
5 Optional change options to your preference or keep the default
6 Click Next
7 Select Ericom in the Module column click Apply and then Next
8 Click Finish and then Save
9 Select Applications | Enterprise Applications
10 Select PowerTerm WebConnectwar checkbox and click Start
PowerTerm WebConnect 29 Getting Started Guide
11 Enter in the Web browser the URL httpltIBM WebSphere
Servergt9080ltContext rootgtEricom portlet The Login dialog appears
12 Login and you will see PowerTerm WebConnect displayed on the list
Step 5 Run the Portlet
1 Restart IBM WebSphere Server
2 Open IBM WebSphere Portal in a browser httpltportal servergt9080ltContext
rootgtEricom portlet
3 Login to IBM WebSphere Server
4 Launch it The Userrsquos applications as defined on PowerTerm WebConnect Server
appear
5 Click an application to launch it
66 PowerTerm WebConnect Server Configuration
bull To enable the Lotus Expeditor to run the PowerTerm WebConnect client the
System Administrator must provide the users with accounts on PowerTerm
WebConnect Server (see the PowerTerm WebConnect Administratorrsquos Manual for
instructions on how to create users groups and connections on the PowerTerm
WebConnect Server)
bull To enable PowerTerm WebConnectrsquos Single Sign-On feature the System
Administrator must create a PowerTerm WebConnect user with the same
username and password as used for the Lotus Expeditor For a managed Lotus
Expeditor the credentials used are the username and password sent to the
managing server For an unmanaged Lotus Expeditor the operation system
username and the Lotus Expeditor password are used as credentials
NOTE If a password is not defined then the Single Sign-On will fail and the user will be
prompted with a login dialog
67 PowerTerm WebConnect Client Configuration
The PowerTerm WebConnect client is configured in webconnectxml located in the config
folder webconnectxml parameters are
url The PowerTerm WebConnect Agent url
server The PowerTerm WebConnect Server address
sso The Single Sign-On feature
dst The local destination for downloading PowerTerm WebConnect
components
PowerTerm WebConnect 30 Getting Started Guide
url
PowerTerm WebConnect components are installed on a Web server Their default url is
Windows Agent
httpltWebServer IPgtWebConnectwindowsptagentcab
Linux Agent
httpltWebServer IPgtWebConnectlinuxix86qterm-wczip
The url parameter must include the first part of the url (which is identical for both Windows
and Linux agents)
The PowerTerm WebConnect client will automatically append the appropriate suffix in
order to create a full accurate url
Example
ltitem key=rdquourlrdquo value=httpadminserverWebConnectgt
server
The computer name or IP address of the PowerTerm WebConnect Server machine
The PowerTerm WebConnect client will log in to this PowerTerm WebConnect Server
display the applications defined on it and run them according to this serverrsquos configuration
Format ltserver IPgt[ltportgt]
where default port is 4000 (can be edited)
Example
ltitem key=rdquoserverrdquo value=rdquoadmin24000rdquogt
sso
Determines whether Single Sign-on will be used to log in to PowerTerm WebConnect
Server Values
bull True (default) the client should automatically log in to the PowerTerm WebConnect
Server using the same credentials as the ones used to log in to the Lotus Expeditor
client
The System Administrator must verify that these credentials can log in to the
PowerTerm WebConnect Server
bull False the user will be prompted with a login dialog or will log in automatically using
previously saved credentials
Example
ltitem key=rdquossordquo value=rdquotruerdquogt
Autologin mode
PowerTerm WebConnect 31 Getting Started Guide
If sso is set to True the user is not prompted for credentials and the login process to
PowerTerm WebConnect Server is done automatically sending the credentials used for the
Lotus Expeditor unless the Lotus Expeditor does not have a password defined (In the
Lotus Expeditor preferences page | Password| Prompt me for a password at start up checkbox)
However if Single Sign-on is not used there are several options regarding Autologin that
can be defined in the PowerTerm WebConnect Preferences page Options
bull Yes
bull No
bull Interactive
bull First time interactive (default) ndash Simplifies the login process to PowerTerm
WebConnect Server In this mode the first time the user logs in to PowerTerm
WebConnect Server he will be prompted for his credentials with the Login dialog
These credentials will be stored in the machine and from then on the login process to
PowerTerm WebConnect Server will be done automatically
1 Open File | Preferences from the Lotus Expeditor and select PowerTerm WebConnect
2 In the Autologin to WebConnect Server section select First Interactive and click OK
3 Start PowerTerm WebConnect Client for Lotus Expeditor If credentials were entered
at least once then the next time the client will connect to PowerTerm WebConnect
Server without prompting for the user name and password
The Administrator must configure the Agent to do nothing when it exits for the
feature to work this way See PowerTerm WebConnect Administratorrsquos Manual for more information about defining Autologin
bull Allow multiple selection ndash Defines whether the user can launch more than one
application at a time (by using the ltCtrlgt or ltShiftgt button while selecting applications)
dst
Defines the path to download PowerTerm WebConnect components on the client machine
The dst parameter can contain macros which are translated by the PowerTerm WebConnect
Client for Lotus Expeditor during runtime The macros should be placed between percent
symbols () for example WebServer
When such a value is defined the PowerTerm WebConnect Client for Lotus Expeditor
substitutes the entire expression for the macrorsquos value
The PowerTerm WebConnect Client for Lotus Expeditor does not support the use
of environment variables as macros
Macros are not case sensitive
Macros supported by PowerTerm WebConnect Client for Lotus Expeditor
Macro name Description
WebServer The name of the Web server
It is obtained from the PowerTerm WebConnect Agent url
PowerTerm WebConnect 32 Getting Started Guide
parameter
Name The name of the clientrsquos CAB or ZIP file eg ldquoptagentrdquo
Display The clientrsquos display name from the version file
Version The clientrsquos version value It is obtained from the version
file
Root The default root location
Windows ldquoCrdquo
LinuxUnix an empty string
OSDir Windows Windowsrsquo installation directory for example
ldquoCWindowsrdquo
Linux an empty string
OSDrive Windows Windowsrsquo installation drive for example ldquoCrdquo
Linux an empty string
HomePath Windows The HOMEPATH environment variable
Linux The HOME environment variable
Home The Ericom folder in the userrsquos home directory
Windows CDocuments and SettingsltusergtApplication
DataEricom
Linux ltusergtEricom
In addition to the predefined macros listed above the PowerTerm WebConnect client
supports the usage of Java System Properties
Java System Properties available for users on Windows XP SP2
Java System Property Name Value Example
javaversion 150
javavendorurl httpwwwibmcom
javahome CIBMcommonpluginscomibmpvcwctruntim
esj2sewin32x86_150SR2-
20060511rcpeclipsepluginscomibmrcpj2sew
in32x86_150SR2-20060511jre
javavmspecificationversion 10
javavmversion 23
javavmvendor IBM Corporation
javavmname IBM J9 VM
PowerTerm WebConnect 33 Getting Started Guide
javaiotmpdir CDOCUME~1dianaLOCALS~1Temp
javacompiler j9jit23
javaextdirs CIBMcommonpluginscomibmpvcwctruntim
esj2sewin32x86_150SR2-
20060511rcpeclipsepluginscomibmrcpj2sew
in32x86_150SR2-20060511jrelibext
osname Windows XP
osarch x86
osversion 51 build 2600 Service Pack 2
pathseparator
username Jone
userhome CDocuments and SettingsJone
userdir CIBMRSA
usertimezone GMT+0200
System properties available for users on Linux RedHat 9
Java System Property Name Value Example
javaversion 150
javavendorurl httpwwwibmcom
javahome usrjavajre150_07
javavmversion 150
javavmvendor IBM Corporation
javavmname IBM J9 VM
javaclasspath
javalibrarypath
javaiotmpdir tmp
javacompiler
javaextdirs
osname Linux
osarch i386
osversion 2420-8
pathseparator
PowerTerm WebConnect 34 Getting Started Guide
username root
userhome root
userdir root
System properties names are placed in the configuration file within percent symbols ()
(like macros)
671 Configure the PowerTerm WebConnect Client
1 Open the Config Folder and edit the webconnectxml file Example
ltxml version =rdquo10rdquo encoding=rdquoUTF-8rdquogt
ltsection name=rdquoparametersrdquogt
ltitem key=rdquourlrdquo value=httpadminserverWebConnect56gt
ltitem key=rdquoserverrdquo value=rdquoadmin24000rdquogt
ltitem key=rdquossordquo value=rdquotruerdquogt
ltitem key=rdquodestrdquo value=rdquoCProgram FilesEricomrdquogt
ltsectiongt
2 Save the customized webconnectxml to a Web server folder available to all users It is
recommended to use the same Web server as the PowerTerm WebConnect Agent
Example
ltWebConnect installation foldergtwebwebconnectxml
3 Test the accessibility to this file - Type the URL of webconnectxml in the browser
Example
httpltWebServer IPgtWebConnectwebconnectxml
The contents of the file should be displayed
672 Configure the Preferences File
1 Open the plugins folder and open the PowerTermWebConnectClient_560365jar file
You can use Winzip version 70 and up or in Windows XP ndash Create a new file type for the
jar extension click advanced and select compressed (zipped) folder in the drop down list
Now you can open the JAR files in the Windows Explorer
The default contents of the file
configURL=httpleericomcomWebConnectwebconnectxml
2 Specify the accurate URL of the webconnectxml file Example
httpltWebServer IPgtWebConnectwebconnectxml
3 Save the file and close it The WinZip will display the following dialog
ldquoFile preferencesini has been changed since it was extracted Update archive
with this filerdquo
PowerTerm WebConnect 35 Getting Started Guide
4 Click Yes and close the archive
If you are editing the file from within the explorer you will have to save the file elsewhere
and then drag it to the explorer window where the JAR file is open
68 Installing PowerTerm WebConnect Client on Lotus Expeditor
1 Start the Lotus Expeditor client
2 Select File | Application | Install
3 Select Search for new features to install and click Next
4 Select Add Folder Location and type or select the location of the update site folder from
the provided package Click OK
5 Select the location you have just created and click Finish
6 In the Select the feature to install tree select Powerterm WebConnectUpdate Site Click
Next
7 Select I accept the terms in the license agreements and click Next
8 Click Finish
9 When prompted restart the platform
69 Running PowerTerm WebConnect Client for Lotus Expeditor
1 Click Open The PowerTerm WebConnect option is displayed
2 Select PowerTerm WebConnect The application will automatically connect and start
downloading the components from PowerTerm WebConnect Server
IMPORTANT
If you did not install PowerTerm WebConnect Server and are instead connecting to Ericom
Softwarersquos Demo WebConnect Server then you need to open port 443 in the firewall
691 PowerTerm WebConnect Client Workflow
1 PowerTerm WebConnect client reads the URL of webconnectxml from the preferencesini
file and requests it
2 When the webconnectxml is successfully downloaded the application reads the
configuration connects to the specified Web server downloads the PowerTerm
WebConnect components and connects to the PowerTerm WebConnect Server
3 The user is requested to login to the PowerTerm WebConnect Server For testing you
can use the username Example and password example
This step will be skipped if Single Sign-on is set to ldquotruerdquo
PowerTerm WebConnect 36 Getting Started Guide
4 After logging in to PowerTerm WebConnect Server the userrsquos applications are displayed
as defined by the administrator
5 To run an application select the desired application from the list and click Launch or
double-click the application The application will be launched in a separate window
610 Troubleshooting
When you encounter a problem the first step is to open the log file This file is located on
the client machine in the Ericom folder
Windows
CDocuments and SettingsltusernamegtEricomleclientEricomPluginlog
Linux
ltuser-home-directorygtEricomleclientEricomPluginlog
Following is a guide for diagnosing and fixing the problems in cases of error messages and
additional information
Error
Message
Solution
Version File
reading error
1 Check the lsquourlrsquo parameter in the webconnectxml file on the Web
server The value should be
httpltWebServerIPgtWebConnect
2 Try to run the following URL on the browser
Windows
httpltWebServerIPgtWebConnectwindowsptagentvertxt
Linux
httpltWebServerIPgtWebConnectlinuxix86qterm-
wcvertxt
The file contents displayed in the browser window should be in
the following form
560-rel14546
PowerTerm WebConnect Application Zone
560 - Main Release
ltrootgtPowerTerm WebConnect 56ltWebServergt
If the version file contents are not as shown check
- Is the Web Server running
- Are PowerTerm WebConnect Web Components and version files
PowerTerm WebConnect 37 Getting Started Guide
in place
3 On the Web server check ltPowerTerm WebConnect
rootgtwebwindowsptagentvertxt If the contents ldquolook wrongrdquo or
not in the proper form reinstall the PowerTerm WebConnect Web
components
4 On the client machine open the aforementioned URL in the
browser The file content should appear in the browser If it does
not it could be that the Web server is down
Web Server is
shut down
The webconnectxml configuration file must be located on the Web
server The explicit URL to this file is defined in the preferencesini
file (see Configure the Preferences File)
The error message contains the IP address of the Web server
Verify that the Web server on this machine is running
Version file
does not exist
on ltURLgt
See Version File reading error
The
configuration
file is not
accessible or
has a wrong
format
The webconnectxml configuration file must be located on the Web
server and the explicit URL to the configuration must be defined in
the preferencesini file (see Configure the Preferences File)
Try to open the URL specified in the error message in the
browser If it does not open then it either does not exist or it has
a wrong format
Preferences
file does not
exist in the
application
bundle
The preferencesini file containing the URL to the configuration
file was removed from the update site folder
Uninstall the current PowerTerm WebConnect client from the
client machine Create a new customized package (see
PowerTerm WebConnect Client Configuration) and reinstall it
Configuration
file URL is not
defined in
preference
file
The URL to the configuration file does not appear in the
preferencesini file (see Configure the Preferences File)
Uninstall the current PowerTerm WebConnect client from the
client machine Create a new customized package (see
PowerTerm WebConnect Client Configuration) and reinstall it
No IP address
could be
found for the
host
The Web server URL specified in the preferencesini file (see
Configure the Preferences File) or in the webconnectxml file (see
Configure the PowerTerm WebConnect Client) is an unknown
host
If the mistake is in the preferencesini file uninstall the current
PowerTerm WebConnect client from the client machine Create a
new customized package (see PowerTerm WebConnect Client
Configuration) and reinstall it
PowerTerm WebConnect 38 Getting Started Guide
If the mistake is in the webconnectxml file correct the file reopen
the Lotus Expeditor client
Cannot write
to destination
The temporary file cannot be written to the defined destination
Check the write permissions
Copied
configuration
file has wrong
format
The webconnectxml file as received from the specified URL has a
wrong format Correct the file and try again
PowerTerm
WebConnect
Agent URL is
malformed
The PowerTerm WebConnect Agent URL specified in the
webconnectxml file (see Configure the PowerTerm WebConnect
Client) does not have a proper HTTP format Correct the file and
try again
PowerTerm
WebConnect
Agent URL is
not defined
The PowerTerm WebConnect Agent URL parameter is not specified
in the webconnectxml file (see Configure the PowerTerm
WebConnect Client)
Correct the file and try again
The specified
destination
folder name
is wrong
The destination folder name contains illegal characters
ltgt|
Check the dst parameter in the webconnectxml file Correct the
file and try again
You do not
have
permissions
to write to
ltpathgt
The PowerTerm WebConnect Agent cannot be written to the
destination as defined Check the write permissions
The default destination defined in the version file should not to
be changed
A customized destination for PowerTerm WebConnect Agent
downloading can be defined in the webconnectxml file (See
Configure the PowerTerm WebConnect Client)
Check the destination value correct and try again
PowerTerm WebConnect 39 Getting Started Guide
About Ericom
Ericomreg Software is a leading provider of Application Access and Virtualization Solutions
Since 1993 Ericom has been helping users access enterprise mission-critical applications
running on a broad range of Microsoftreg Windowsreg Terminal Servers virtual Desktops
Blade PCs legacy hosts and other systems Ericom provides concrete business value by
helping organizations realize the benefits of their IT investments With offices in the United
States United Kingdom EMEA India and China Ericom also has an extensive network of
distributors and partners throughout North America Europe Asia and the Far East Our
expanding customer base is more than 30 thousand strong with over 7 million
installations
For more information on our products and services contact us at the location nearest to you
And visit our web site httpwwwericomcom
North America Western Europe International
Ericom Software Inc Ericom Software (UK) Ltd Ericom Software Ltd
231 Herbert Avenue Bldg 4 11a Victoria Square 8 Hamarpeh Street
Closter NJ 07624 USA Droitwich Worcestershire Har Hotzvim Technology Park
Tel +1 (201) 767 2210 WR9 8DE United Kingdom Jerusalem 91450 Israel
Fax +1 (201) 767 2205 Tel +44 (0) 845 644 3597 Tel +972 (2) 591 1700
Toll-free 1 (888) 769 7876 Fax +44 (0) 845 644 3598 Fax +972 (2) 571 4737
Email infoericomcom Email infoericomcouk Email infoericomcom
PowerTerm WebConnect 21 Getting Started Guide
3 Select Virtual Desktop in the first step of the wizard and click Next
4 Follow the wizardrsquos instructions until you reach the Virtual Desktops step
5 Select a pool that you previously created and that you would like this connection to choose virtual machines from Click Next
6 Continue and complete the reminder of the wizardrsquos steps
Once the resource is published users who have been assigned access will be able to use it
immediately
PowerTerm WebConnect 22 Getting Started Guide
5 Download and Run PowerTerm WebConnect Clients
PowerTerm WebConnect clients are automatically downloaded and installed onto the client
devices For detailed information and samples please refer to the PowerTerm WebConnect
Sample URLs page To see this page navigate your browser to
httpltweb_servergtWebConnect5xClientURLshtml
PowerTerm WebConnect 23 Getting Started Guide
6 PowerTerm WebConnect Client for Lotus Expeditor
61 Installation Package
PowerTerm WebConnect client for Lotus Expeditor is provided to IBM in an Update Site
package This is a ZIP archive containing the Update Site with the Eclipse feature and plug-
in that comprises the PowerTerm WebConnect client
Extract the ZIP file keeping the foldersrsquo structure intact
NOTE In Winzip verify that the ldquoUse folder namesrdquo option is set to TRUE
Package structure
Update Site
- plugins
- PowerTermWebConnectClient_560365jar
- features
- comericomWebConnect_560365jar
- sitexml
config
- webconnectxml
Definitions
bull webconnectxml PowerTerm WebConnect client configuration file
bull comericomWebConnect_560365jar PowerTerm WebConnect client feature file
bull PowerTermWebConnectClient_560365jar PowerTerm WebConnect client plugin file
62 Pre-installation steps
PowerTerm WebConnect client for Lotus Expeditor does not run independently but in
conjunction with PowerTerm WebConnect Server You can either install it and define your
users groups and applications or use Ericom Softwarersquos Demo PowerTerm WebConnect
Server
bull If you decide to install PowerTerm WebConnect Server you will need the full
installation ie the PowerTerm WebConnect Server and the Web components If you
do not have the installation CD you can download and install a trial version from
wwwericomcom
PowerTerm WebConnect 24 Getting Started Guide
bull If you decide to use Ericom Softwarersquos Demo PowerTerm WebConnect Server then
skip to the chapter Installing PowerTerm WebConnect Client on Lotus Expeditor
63 Install PowerTerm WebConnect Portlet on IBM Workplace server (for Windows OS)
Step 1 Install PowerTerm WebConnect Server
If PowerTerm WebConnect Server and IBM Workplace Server are on separate machines
bull Configure PowerTerm WebConnect Server
Launch PowerTerm WebConnect Administration Tool
Open Files | Configuration | Main
In the [Portal] section edit
Machines=localhostltIBM sever machinegt
bull Configure PowerTerm WebConnect Web components
Copy the ldquowebrdquo folder from the PowerTerm WebConnect server installation to the
IBM Workplace server machine
Create an Alias or a Virtual directory to it named WebConnect on the Web
server providing access to it for the users This is in order to enable the users to
download the necessary files to run their applications
Step 2 Enable JSR portlets
1 On IBM Workplace Server go to ltPortalServergtsharedappconfigservicesConfigServiceproperties
2 Edit portalenablejsr168=true
3 Save and close the file
Step 3 Enable SSO
1 On IBM Workplace Server go to ltPortalServergtsharedappconfigservicesLoaderServiceproperties
2 Edit commandpath=comericomportalcommandscomibmwpsenginecommands
3 Save and close the file
Step 4 Copy Files
The following files need to be copied from WebConnect ServerAddOnsIBM
WorkplacePortlet folder to IBM Workplace Server
File name to copy Destination folder
OpenSSLdll ltAppServergtjavajrebin
IbmPortaldll ltAppServergtjavajrebin
IbmPortalini ltAppServergtjavajrebin
PowerTerm WebConnect 25 Getting Started Guide
WebConnectPortaljar ltAppServergtlib
EricomLoginjar ltPortalServergtsharedapp
Step 5 Portlet Configuration
1 On IBM Workplace Server go to ltAppServergtjavajrebinIbmPortalini
2 You can modify the following parameters in the [Server=WebConnect] section webserverport=ltIBM web server portgt
Specifies the Web server port for accessing the PowerTerm WebConnect clients folder
Default 80 Address
Specifies the address of the PowerTerm WebConnect Server machine for Portlet to
connect to when PowerTerm WebConnect Server is located on a different machine
than the IBM Workplace Server CustomAddress
Specifies the addresss of the PowerTerm WebConnect Server machine for Clients to connect to If CustomAddress is the same as Address then this may be omitted webserveraddr
Specifies the address of the Web Server machine when it is located on a different
machine than the IBM Workplace Server
3 Restart the IBM server ltPortalServergtrootscriptsstopWorkplaceServicesbat ltPortalServergtrootscriptsstartWorkplaceServicesbat
This procedure may take about 20 minutes
Step 6 Install the Portlet
1 In a Web browser open the URL httpltIBM Workplace
Servergt9081lwpmyworkplace to open the IBM Workplace Portal
2 Login as administrator
3 Go to Administration | Portlets | Install
4 Browse to the PowerTerm WebConnectwar file located on PowerTerm WebConnect
Server and click Next
5 Click Install
Step 7 Create an Application page
1 Login to the Workplace
2 Go to Portal User Interface | Manage Pages
3 Search for My Work
4 Click the My Work link and select New Page
5 Name the page PowerTerm WebConnect and click OK
6 Click OK again You will see the created page on the list
7 Click the pencil icon on the new page and select the 1 square layout
PowerTerm WebConnect 26 Getting Started Guide
8 Click Add Portlet and search for PowerTerm WebConnect
9 Select it and click OK
10 Click Done
11 Click My work at the top of the page PowerTerm WebConnect is displayed on the list
Step 8 Run the Portlet
1 Restart IBM Workplace Server
2 Open IBM Workplace Portal in a browser httpltportal servergtlwpmyworkplace
3 Login to IBM Workplace Server
4 Click My work PowerTerm WebConnect portlet is displayed
5 Launch it The Userrsquos applications as defined on PowerTerm WebConnect Server
appear
6 Click an application to launch it
64 Install PowerTerm WebConnect Portlet on IBM Workplace server (for Linux OS)
Step 1 Enable JSR 168 portlets
1 Go to optIBMWorkplacePortalServersharedappconfigservicesConfigServiceproperties
2 Modify the portalenablejsr168 property to ldquotruerdquo
3 Restart the server cd optIBMWorkplacePortalServerrootscripts
Run stopWorkplaceServicessh
Run startWorkplaceServicessh
This procedure can take up to 20 minutes
4 Log on to the workplace server at httpltworkplace servergt9081lwpmyworkplace using
the administrators username and password
Step 2 Install the portlet
1 Restart IBM Workplace Server
2 In a Web browser open the URL httpltworkplace server IPgtlwpmyworkplace
3 Login to IBM Workplace Server as an administrator
4 Go to Administration | Portlets | Install
5 Browse to the PowerTerm WebConnectwar file located on PowerTerm WebConnect
Server and click Next
6 Click Install
PowerTerm WebConnect 27 Getting Started Guide
Step 3 Install the Application page
1 Login to the workplace as administrator
2 Go to Administration | Portal User Interface | Manage Pages
3 Search for My Work
4 Click the My Work link and select New Page
5 Name the page PowerTerm WebConnect and click OK
6 Click OK again You will see the created page on the list
7 Click the pencil icon and select the 1-square layout
8 Click Add Portlet and search for PowerTerm WebConnect
9 Select it and click OK
10 Click Done
11 Click My work on top and PowerTerm WebConnect is displayed on the left bar
Step 4 Run the portlet
1 Restart IBM Workplace Server
2 Open IBM Workplace Portal in a browser httpltportal servergtlwpmyworkplace
3 Login to IBM Workplace Server
4 Click My work PowerTerm WebConnect portlet is displayed
5 Launch it The Userrsquos applications as defined on PowerTerm WebConnect Server
appear
6 Click an application to launch it
65 Install PowerTerm WebConnect Portlet on IBM WebSphere 61 server (for Windows OS)
Step 1 Install PowerTerm WebConnect Server
You have to configure PowerTerm WebConnect Server if it and the IBM WebSphere Server
are on separate machines
1 Launch PowerTerm WebConnect Administration Tool
2 Open Files | Configuration | Main
3 In the [Portal] section edit Machines=localhostltIBM sever machinegt
Step 2 Copy Files
The following files need to be copied from WebConnect ServerAddOnsIBM
WebSpherePortlet folder to IBM WebSphere Server
PowerTerm WebConnect 28 Getting Started Guide
File name to copy Destination folder
OpenSSLdll ltAppServergtjavajrebin
IbmPortaldll ltAppServergtjavajrebin
IbmPortalini ltAppServergtjavajrebin
WebConnectPortaljar ltAppServergtlib
Step 3 Portlet Configuration
1 On IBM Workplace Server go to ltAppServergtjavajrebinIbmPortalini
2 You can modify the following parameters in the [Server=WebConnect] section webserverport=ltIBM web server portgt
Specifies the Web server port for accessing the PowerTerm WebConnect clients folder
Default 80 Address
Specifies the address of the PowerTerm WebConnect Server machine for Portlet to
connect to when PowerTerm WebConnect Server is located on a different machine
than the IBM Workplace Server CustomAddress
Specifies the addresss of the PowerTerm WebConnect Server machine for Clients to connect to If CustomAddress is the same as Address then this may be omitted webserveraddr
Specifies the address of the Web Server machine when it is located on a different
machine than the IBM Workplace Server
3 Restart the IBM server ltAppServergtProfilesAppServer01binstopServerbat ltAppServergtProfilesAppServer01binstartServerbat
This procedure may take about 20 minutes
Step 4 Install the Portlet and create an Application page
1 In a Web browser open the URL httpltIBM WebSphere Servergt9060ibmconsole
to open the IBM WebSphere Portal
2 Login and go to Applications | Install New Application
3 Browse to the PowerTerm WebConnectwar file located on PowerTerm WebConnect
Server
4 Enter Context root and click Next The Select installation options dialog appears
5 Optional change options to your preference or keep the default
6 Click Next
7 Select Ericom in the Module column click Apply and then Next
8 Click Finish and then Save
9 Select Applications | Enterprise Applications
10 Select PowerTerm WebConnectwar checkbox and click Start
PowerTerm WebConnect 29 Getting Started Guide
11 Enter in the Web browser the URL httpltIBM WebSphere
Servergt9080ltContext rootgtEricom portlet The Login dialog appears
12 Login and you will see PowerTerm WebConnect displayed on the list
Step 5 Run the Portlet
1 Restart IBM WebSphere Server
2 Open IBM WebSphere Portal in a browser httpltportal servergt9080ltContext
rootgtEricom portlet
3 Login to IBM WebSphere Server
4 Launch it The Userrsquos applications as defined on PowerTerm WebConnect Server
appear
5 Click an application to launch it
66 PowerTerm WebConnect Server Configuration
bull To enable the Lotus Expeditor to run the PowerTerm WebConnect client the
System Administrator must provide the users with accounts on PowerTerm
WebConnect Server (see the PowerTerm WebConnect Administratorrsquos Manual for
instructions on how to create users groups and connections on the PowerTerm
WebConnect Server)
bull To enable PowerTerm WebConnectrsquos Single Sign-On feature the System
Administrator must create a PowerTerm WebConnect user with the same
username and password as used for the Lotus Expeditor For a managed Lotus
Expeditor the credentials used are the username and password sent to the
managing server For an unmanaged Lotus Expeditor the operation system
username and the Lotus Expeditor password are used as credentials
NOTE If a password is not defined then the Single Sign-On will fail and the user will be
prompted with a login dialog
67 PowerTerm WebConnect Client Configuration
The PowerTerm WebConnect client is configured in webconnectxml located in the config
folder webconnectxml parameters are
url The PowerTerm WebConnect Agent url
server The PowerTerm WebConnect Server address
sso The Single Sign-On feature
dst The local destination for downloading PowerTerm WebConnect
components
PowerTerm WebConnect 30 Getting Started Guide
url
PowerTerm WebConnect components are installed on a Web server Their default url is
Windows Agent
httpltWebServer IPgtWebConnectwindowsptagentcab
Linux Agent
httpltWebServer IPgtWebConnectlinuxix86qterm-wczip
The url parameter must include the first part of the url (which is identical for both Windows
and Linux agents)
The PowerTerm WebConnect client will automatically append the appropriate suffix in
order to create a full accurate url
Example
ltitem key=rdquourlrdquo value=httpadminserverWebConnectgt
server
The computer name or IP address of the PowerTerm WebConnect Server machine
The PowerTerm WebConnect client will log in to this PowerTerm WebConnect Server
display the applications defined on it and run them according to this serverrsquos configuration
Format ltserver IPgt[ltportgt]
where default port is 4000 (can be edited)
Example
ltitem key=rdquoserverrdquo value=rdquoadmin24000rdquogt
sso
Determines whether Single Sign-on will be used to log in to PowerTerm WebConnect
Server Values
bull True (default) the client should automatically log in to the PowerTerm WebConnect
Server using the same credentials as the ones used to log in to the Lotus Expeditor
client
The System Administrator must verify that these credentials can log in to the
PowerTerm WebConnect Server
bull False the user will be prompted with a login dialog or will log in automatically using
previously saved credentials
Example
ltitem key=rdquossordquo value=rdquotruerdquogt
Autologin mode
PowerTerm WebConnect 31 Getting Started Guide
If sso is set to True the user is not prompted for credentials and the login process to
PowerTerm WebConnect Server is done automatically sending the credentials used for the
Lotus Expeditor unless the Lotus Expeditor does not have a password defined (In the
Lotus Expeditor preferences page | Password| Prompt me for a password at start up checkbox)
However if Single Sign-on is not used there are several options regarding Autologin that
can be defined in the PowerTerm WebConnect Preferences page Options
bull Yes
bull No
bull Interactive
bull First time interactive (default) ndash Simplifies the login process to PowerTerm
WebConnect Server In this mode the first time the user logs in to PowerTerm
WebConnect Server he will be prompted for his credentials with the Login dialog
These credentials will be stored in the machine and from then on the login process to
PowerTerm WebConnect Server will be done automatically
1 Open File | Preferences from the Lotus Expeditor and select PowerTerm WebConnect
2 In the Autologin to WebConnect Server section select First Interactive and click OK
3 Start PowerTerm WebConnect Client for Lotus Expeditor If credentials were entered
at least once then the next time the client will connect to PowerTerm WebConnect
Server without prompting for the user name and password
The Administrator must configure the Agent to do nothing when it exits for the
feature to work this way See PowerTerm WebConnect Administratorrsquos Manual for more information about defining Autologin
bull Allow multiple selection ndash Defines whether the user can launch more than one
application at a time (by using the ltCtrlgt or ltShiftgt button while selecting applications)
dst
Defines the path to download PowerTerm WebConnect components on the client machine
The dst parameter can contain macros which are translated by the PowerTerm WebConnect
Client for Lotus Expeditor during runtime The macros should be placed between percent
symbols () for example WebServer
When such a value is defined the PowerTerm WebConnect Client for Lotus Expeditor
substitutes the entire expression for the macrorsquos value
The PowerTerm WebConnect Client for Lotus Expeditor does not support the use
of environment variables as macros
Macros are not case sensitive
Macros supported by PowerTerm WebConnect Client for Lotus Expeditor
Macro name Description
WebServer The name of the Web server
It is obtained from the PowerTerm WebConnect Agent url
PowerTerm WebConnect 32 Getting Started Guide
parameter
Name The name of the clientrsquos CAB or ZIP file eg ldquoptagentrdquo
Display The clientrsquos display name from the version file
Version The clientrsquos version value It is obtained from the version
file
Root The default root location
Windows ldquoCrdquo
LinuxUnix an empty string
OSDir Windows Windowsrsquo installation directory for example
ldquoCWindowsrdquo
Linux an empty string
OSDrive Windows Windowsrsquo installation drive for example ldquoCrdquo
Linux an empty string
HomePath Windows The HOMEPATH environment variable
Linux The HOME environment variable
Home The Ericom folder in the userrsquos home directory
Windows CDocuments and SettingsltusergtApplication
DataEricom
Linux ltusergtEricom
In addition to the predefined macros listed above the PowerTerm WebConnect client
supports the usage of Java System Properties
Java System Properties available for users on Windows XP SP2
Java System Property Name Value Example
javaversion 150
javavendorurl httpwwwibmcom
javahome CIBMcommonpluginscomibmpvcwctruntim
esj2sewin32x86_150SR2-
20060511rcpeclipsepluginscomibmrcpj2sew
in32x86_150SR2-20060511jre
javavmspecificationversion 10
javavmversion 23
javavmvendor IBM Corporation
javavmname IBM J9 VM
PowerTerm WebConnect 33 Getting Started Guide
javaiotmpdir CDOCUME~1dianaLOCALS~1Temp
javacompiler j9jit23
javaextdirs CIBMcommonpluginscomibmpvcwctruntim
esj2sewin32x86_150SR2-
20060511rcpeclipsepluginscomibmrcpj2sew
in32x86_150SR2-20060511jrelibext
osname Windows XP
osarch x86
osversion 51 build 2600 Service Pack 2
pathseparator
username Jone
userhome CDocuments and SettingsJone
userdir CIBMRSA
usertimezone GMT+0200
System properties available for users on Linux RedHat 9
Java System Property Name Value Example
javaversion 150
javavendorurl httpwwwibmcom
javahome usrjavajre150_07
javavmversion 150
javavmvendor IBM Corporation
javavmname IBM J9 VM
javaclasspath
javalibrarypath
javaiotmpdir tmp
javacompiler
javaextdirs
osname Linux
osarch i386
osversion 2420-8
pathseparator
PowerTerm WebConnect 34 Getting Started Guide
username root
userhome root
userdir root
System properties names are placed in the configuration file within percent symbols ()
(like macros)
671 Configure the PowerTerm WebConnect Client
1 Open the Config Folder and edit the webconnectxml file Example
ltxml version =rdquo10rdquo encoding=rdquoUTF-8rdquogt
ltsection name=rdquoparametersrdquogt
ltitem key=rdquourlrdquo value=httpadminserverWebConnect56gt
ltitem key=rdquoserverrdquo value=rdquoadmin24000rdquogt
ltitem key=rdquossordquo value=rdquotruerdquogt
ltitem key=rdquodestrdquo value=rdquoCProgram FilesEricomrdquogt
ltsectiongt
2 Save the customized webconnectxml to a Web server folder available to all users It is
recommended to use the same Web server as the PowerTerm WebConnect Agent
Example
ltWebConnect installation foldergtwebwebconnectxml
3 Test the accessibility to this file - Type the URL of webconnectxml in the browser
Example
httpltWebServer IPgtWebConnectwebconnectxml
The contents of the file should be displayed
672 Configure the Preferences File
1 Open the plugins folder and open the PowerTermWebConnectClient_560365jar file
You can use Winzip version 70 and up or in Windows XP ndash Create a new file type for the
jar extension click advanced and select compressed (zipped) folder in the drop down list
Now you can open the JAR files in the Windows Explorer
The default contents of the file
configURL=httpleericomcomWebConnectwebconnectxml
2 Specify the accurate URL of the webconnectxml file Example
httpltWebServer IPgtWebConnectwebconnectxml
3 Save the file and close it The WinZip will display the following dialog
ldquoFile preferencesini has been changed since it was extracted Update archive
with this filerdquo
PowerTerm WebConnect 35 Getting Started Guide
4 Click Yes and close the archive
If you are editing the file from within the explorer you will have to save the file elsewhere
and then drag it to the explorer window where the JAR file is open
68 Installing PowerTerm WebConnect Client on Lotus Expeditor
1 Start the Lotus Expeditor client
2 Select File | Application | Install
3 Select Search for new features to install and click Next
4 Select Add Folder Location and type or select the location of the update site folder from
the provided package Click OK
5 Select the location you have just created and click Finish
6 In the Select the feature to install tree select Powerterm WebConnectUpdate Site Click
Next
7 Select I accept the terms in the license agreements and click Next
8 Click Finish
9 When prompted restart the platform
69 Running PowerTerm WebConnect Client for Lotus Expeditor
1 Click Open The PowerTerm WebConnect option is displayed
2 Select PowerTerm WebConnect The application will automatically connect and start
downloading the components from PowerTerm WebConnect Server
IMPORTANT
If you did not install PowerTerm WebConnect Server and are instead connecting to Ericom
Softwarersquos Demo WebConnect Server then you need to open port 443 in the firewall
691 PowerTerm WebConnect Client Workflow
1 PowerTerm WebConnect client reads the URL of webconnectxml from the preferencesini
file and requests it
2 When the webconnectxml is successfully downloaded the application reads the
configuration connects to the specified Web server downloads the PowerTerm
WebConnect components and connects to the PowerTerm WebConnect Server
3 The user is requested to login to the PowerTerm WebConnect Server For testing you
can use the username Example and password example
This step will be skipped if Single Sign-on is set to ldquotruerdquo
PowerTerm WebConnect 36 Getting Started Guide
4 After logging in to PowerTerm WebConnect Server the userrsquos applications are displayed
as defined by the administrator
5 To run an application select the desired application from the list and click Launch or
double-click the application The application will be launched in a separate window
610 Troubleshooting
When you encounter a problem the first step is to open the log file This file is located on
the client machine in the Ericom folder
Windows
CDocuments and SettingsltusernamegtEricomleclientEricomPluginlog
Linux
ltuser-home-directorygtEricomleclientEricomPluginlog
Following is a guide for diagnosing and fixing the problems in cases of error messages and
additional information
Error
Message
Solution
Version File
reading error
1 Check the lsquourlrsquo parameter in the webconnectxml file on the Web
server The value should be
httpltWebServerIPgtWebConnect
2 Try to run the following URL on the browser
Windows
httpltWebServerIPgtWebConnectwindowsptagentvertxt
Linux
httpltWebServerIPgtWebConnectlinuxix86qterm-
wcvertxt
The file contents displayed in the browser window should be in
the following form
560-rel14546
PowerTerm WebConnect Application Zone
560 - Main Release
ltrootgtPowerTerm WebConnect 56ltWebServergt
If the version file contents are not as shown check
- Is the Web Server running
- Are PowerTerm WebConnect Web Components and version files
PowerTerm WebConnect 37 Getting Started Guide
in place
3 On the Web server check ltPowerTerm WebConnect
rootgtwebwindowsptagentvertxt If the contents ldquolook wrongrdquo or
not in the proper form reinstall the PowerTerm WebConnect Web
components
4 On the client machine open the aforementioned URL in the
browser The file content should appear in the browser If it does
not it could be that the Web server is down
Web Server is
shut down
The webconnectxml configuration file must be located on the Web
server The explicit URL to this file is defined in the preferencesini
file (see Configure the Preferences File)
The error message contains the IP address of the Web server
Verify that the Web server on this machine is running
Version file
does not exist
on ltURLgt
See Version File reading error
The
configuration
file is not
accessible or
has a wrong
format
The webconnectxml configuration file must be located on the Web
server and the explicit URL to the configuration must be defined in
the preferencesini file (see Configure the Preferences File)
Try to open the URL specified in the error message in the
browser If it does not open then it either does not exist or it has
a wrong format
Preferences
file does not
exist in the
application
bundle
The preferencesini file containing the URL to the configuration
file was removed from the update site folder
Uninstall the current PowerTerm WebConnect client from the
client machine Create a new customized package (see
PowerTerm WebConnect Client Configuration) and reinstall it
Configuration
file URL is not
defined in
preference
file
The URL to the configuration file does not appear in the
preferencesini file (see Configure the Preferences File)
Uninstall the current PowerTerm WebConnect client from the
client machine Create a new customized package (see
PowerTerm WebConnect Client Configuration) and reinstall it
No IP address
could be
found for the
host
The Web server URL specified in the preferencesini file (see
Configure the Preferences File) or in the webconnectxml file (see
Configure the PowerTerm WebConnect Client) is an unknown
host
If the mistake is in the preferencesini file uninstall the current
PowerTerm WebConnect client from the client machine Create a
new customized package (see PowerTerm WebConnect Client
Configuration) and reinstall it
PowerTerm WebConnect 38 Getting Started Guide
If the mistake is in the webconnectxml file correct the file reopen
the Lotus Expeditor client
Cannot write
to destination
The temporary file cannot be written to the defined destination
Check the write permissions
Copied
configuration
file has wrong
format
The webconnectxml file as received from the specified URL has a
wrong format Correct the file and try again
PowerTerm
WebConnect
Agent URL is
malformed
The PowerTerm WebConnect Agent URL specified in the
webconnectxml file (see Configure the PowerTerm WebConnect
Client) does not have a proper HTTP format Correct the file and
try again
PowerTerm
WebConnect
Agent URL is
not defined
The PowerTerm WebConnect Agent URL parameter is not specified
in the webconnectxml file (see Configure the PowerTerm
WebConnect Client)
Correct the file and try again
The specified
destination
folder name
is wrong
The destination folder name contains illegal characters
ltgt|
Check the dst parameter in the webconnectxml file Correct the
file and try again
You do not
have
permissions
to write to
ltpathgt
The PowerTerm WebConnect Agent cannot be written to the
destination as defined Check the write permissions
The default destination defined in the version file should not to
be changed
A customized destination for PowerTerm WebConnect Agent
downloading can be defined in the webconnectxml file (See
Configure the PowerTerm WebConnect Client)
Check the destination value correct and try again
PowerTerm WebConnect 39 Getting Started Guide
About Ericom
Ericomreg Software is a leading provider of Application Access and Virtualization Solutions
Since 1993 Ericom has been helping users access enterprise mission-critical applications
running on a broad range of Microsoftreg Windowsreg Terminal Servers virtual Desktops
Blade PCs legacy hosts and other systems Ericom provides concrete business value by
helping organizations realize the benefits of their IT investments With offices in the United
States United Kingdom EMEA India and China Ericom also has an extensive network of
distributors and partners throughout North America Europe Asia and the Far East Our
expanding customer base is more than 30 thousand strong with over 7 million
installations
For more information on our products and services contact us at the location nearest to you
And visit our web site httpwwwericomcom
North America Western Europe International
Ericom Software Inc Ericom Software (UK) Ltd Ericom Software Ltd
231 Herbert Avenue Bldg 4 11a Victoria Square 8 Hamarpeh Street
Closter NJ 07624 USA Droitwich Worcestershire Har Hotzvim Technology Park
Tel +1 (201) 767 2210 WR9 8DE United Kingdom Jerusalem 91450 Israel
Fax +1 (201) 767 2205 Tel +44 (0) 845 644 3597 Tel +972 (2) 591 1700
Toll-free 1 (888) 769 7876 Fax +44 (0) 845 644 3598 Fax +972 (2) 571 4737
Email infoericomcom Email infoericomcouk Email infoericomcom
PowerTerm WebConnect 22 Getting Started Guide
5 Download and Run PowerTerm WebConnect Clients
PowerTerm WebConnect clients are automatically downloaded and installed onto the client
devices For detailed information and samples please refer to the PowerTerm WebConnect
Sample URLs page To see this page navigate your browser to
httpltweb_servergtWebConnect5xClientURLshtml
PowerTerm WebConnect 23 Getting Started Guide
6 PowerTerm WebConnect Client for Lotus Expeditor
61 Installation Package
PowerTerm WebConnect client for Lotus Expeditor is provided to IBM in an Update Site
package This is a ZIP archive containing the Update Site with the Eclipse feature and plug-
in that comprises the PowerTerm WebConnect client
Extract the ZIP file keeping the foldersrsquo structure intact
NOTE In Winzip verify that the ldquoUse folder namesrdquo option is set to TRUE
Package structure
Update Site
- plugins
- PowerTermWebConnectClient_560365jar
- features
- comericomWebConnect_560365jar
- sitexml
config
- webconnectxml
Definitions
bull webconnectxml PowerTerm WebConnect client configuration file
bull comericomWebConnect_560365jar PowerTerm WebConnect client feature file
bull PowerTermWebConnectClient_560365jar PowerTerm WebConnect client plugin file
62 Pre-installation steps
PowerTerm WebConnect client for Lotus Expeditor does not run independently but in
conjunction with PowerTerm WebConnect Server You can either install it and define your
users groups and applications or use Ericom Softwarersquos Demo PowerTerm WebConnect
Server
bull If you decide to install PowerTerm WebConnect Server you will need the full
installation ie the PowerTerm WebConnect Server and the Web components If you
do not have the installation CD you can download and install a trial version from
wwwericomcom
PowerTerm WebConnect 24 Getting Started Guide
bull If you decide to use Ericom Softwarersquos Demo PowerTerm WebConnect Server then
skip to the chapter Installing PowerTerm WebConnect Client on Lotus Expeditor
63 Install PowerTerm WebConnect Portlet on IBM Workplace server (for Windows OS)
Step 1 Install PowerTerm WebConnect Server
If PowerTerm WebConnect Server and IBM Workplace Server are on separate machines
bull Configure PowerTerm WebConnect Server
Launch PowerTerm WebConnect Administration Tool
Open Files | Configuration | Main
In the [Portal] section edit
Machines=localhostltIBM sever machinegt
bull Configure PowerTerm WebConnect Web components
Copy the ldquowebrdquo folder from the PowerTerm WebConnect server installation to the
IBM Workplace server machine
Create an Alias or a Virtual directory to it named WebConnect on the Web
server providing access to it for the users This is in order to enable the users to
download the necessary files to run their applications
Step 2 Enable JSR portlets
1 On IBM Workplace Server go to ltPortalServergtsharedappconfigservicesConfigServiceproperties
2 Edit portalenablejsr168=true
3 Save and close the file
Step 3 Enable SSO
1 On IBM Workplace Server go to ltPortalServergtsharedappconfigservicesLoaderServiceproperties
2 Edit commandpath=comericomportalcommandscomibmwpsenginecommands
3 Save and close the file
Step 4 Copy Files
The following files need to be copied from WebConnect ServerAddOnsIBM
WorkplacePortlet folder to IBM Workplace Server
File name to copy Destination folder
OpenSSLdll ltAppServergtjavajrebin
IbmPortaldll ltAppServergtjavajrebin
IbmPortalini ltAppServergtjavajrebin
PowerTerm WebConnect 25 Getting Started Guide
WebConnectPortaljar ltAppServergtlib
EricomLoginjar ltPortalServergtsharedapp
Step 5 Portlet Configuration
1 On IBM Workplace Server go to ltAppServergtjavajrebinIbmPortalini
2 You can modify the following parameters in the [Server=WebConnect] section webserverport=ltIBM web server portgt
Specifies the Web server port for accessing the PowerTerm WebConnect clients folder
Default 80 Address
Specifies the address of the PowerTerm WebConnect Server machine for Portlet to
connect to when PowerTerm WebConnect Server is located on a different machine
than the IBM Workplace Server CustomAddress
Specifies the addresss of the PowerTerm WebConnect Server machine for Clients to connect to If CustomAddress is the same as Address then this may be omitted webserveraddr
Specifies the address of the Web Server machine when it is located on a different
machine than the IBM Workplace Server
3 Restart the IBM server ltPortalServergtrootscriptsstopWorkplaceServicesbat ltPortalServergtrootscriptsstartWorkplaceServicesbat
This procedure may take about 20 minutes
Step 6 Install the Portlet
1 In a Web browser open the URL httpltIBM Workplace
Servergt9081lwpmyworkplace to open the IBM Workplace Portal
2 Login as administrator
3 Go to Administration | Portlets | Install
4 Browse to the PowerTerm WebConnectwar file located on PowerTerm WebConnect
Server and click Next
5 Click Install
Step 7 Create an Application page
1 Login to the Workplace
2 Go to Portal User Interface | Manage Pages
3 Search for My Work
4 Click the My Work link and select New Page
5 Name the page PowerTerm WebConnect and click OK
6 Click OK again You will see the created page on the list
7 Click the pencil icon on the new page and select the 1 square layout
PowerTerm WebConnect 26 Getting Started Guide
8 Click Add Portlet and search for PowerTerm WebConnect
9 Select it and click OK
10 Click Done
11 Click My work at the top of the page PowerTerm WebConnect is displayed on the list
Step 8 Run the Portlet
1 Restart IBM Workplace Server
2 Open IBM Workplace Portal in a browser httpltportal servergtlwpmyworkplace
3 Login to IBM Workplace Server
4 Click My work PowerTerm WebConnect portlet is displayed
5 Launch it The Userrsquos applications as defined on PowerTerm WebConnect Server
appear
6 Click an application to launch it
64 Install PowerTerm WebConnect Portlet on IBM Workplace server (for Linux OS)
Step 1 Enable JSR 168 portlets
1 Go to optIBMWorkplacePortalServersharedappconfigservicesConfigServiceproperties
2 Modify the portalenablejsr168 property to ldquotruerdquo
3 Restart the server cd optIBMWorkplacePortalServerrootscripts
Run stopWorkplaceServicessh
Run startWorkplaceServicessh
This procedure can take up to 20 minutes
4 Log on to the workplace server at httpltworkplace servergt9081lwpmyworkplace using
the administrators username and password
Step 2 Install the portlet
1 Restart IBM Workplace Server
2 In a Web browser open the URL httpltworkplace server IPgtlwpmyworkplace
3 Login to IBM Workplace Server as an administrator
4 Go to Administration | Portlets | Install
5 Browse to the PowerTerm WebConnectwar file located on PowerTerm WebConnect
Server and click Next
6 Click Install
PowerTerm WebConnect 27 Getting Started Guide
Step 3 Install the Application page
1 Login to the workplace as administrator
2 Go to Administration | Portal User Interface | Manage Pages
3 Search for My Work
4 Click the My Work link and select New Page
5 Name the page PowerTerm WebConnect and click OK
6 Click OK again You will see the created page on the list
7 Click the pencil icon and select the 1-square layout
8 Click Add Portlet and search for PowerTerm WebConnect
9 Select it and click OK
10 Click Done
11 Click My work on top and PowerTerm WebConnect is displayed on the left bar
Step 4 Run the portlet
1 Restart IBM Workplace Server
2 Open IBM Workplace Portal in a browser httpltportal servergtlwpmyworkplace
3 Login to IBM Workplace Server
4 Click My work PowerTerm WebConnect portlet is displayed
5 Launch it The Userrsquos applications as defined on PowerTerm WebConnect Server
appear
6 Click an application to launch it
65 Install PowerTerm WebConnect Portlet on IBM WebSphere 61 server (for Windows OS)
Step 1 Install PowerTerm WebConnect Server
You have to configure PowerTerm WebConnect Server if it and the IBM WebSphere Server
are on separate machines
1 Launch PowerTerm WebConnect Administration Tool
2 Open Files | Configuration | Main
3 In the [Portal] section edit Machines=localhostltIBM sever machinegt
Step 2 Copy Files
The following files need to be copied from WebConnect ServerAddOnsIBM
WebSpherePortlet folder to IBM WebSphere Server
PowerTerm WebConnect 28 Getting Started Guide
File name to copy Destination folder
OpenSSLdll ltAppServergtjavajrebin
IbmPortaldll ltAppServergtjavajrebin
IbmPortalini ltAppServergtjavajrebin
WebConnectPortaljar ltAppServergtlib
Step 3 Portlet Configuration
1 On IBM Workplace Server go to ltAppServergtjavajrebinIbmPortalini
2 You can modify the following parameters in the [Server=WebConnect] section webserverport=ltIBM web server portgt
Specifies the Web server port for accessing the PowerTerm WebConnect clients folder
Default 80 Address
Specifies the address of the PowerTerm WebConnect Server machine for Portlet to
connect to when PowerTerm WebConnect Server is located on a different machine
than the IBM Workplace Server CustomAddress
Specifies the addresss of the PowerTerm WebConnect Server machine for Clients to connect to If CustomAddress is the same as Address then this may be omitted webserveraddr
Specifies the address of the Web Server machine when it is located on a different
machine than the IBM Workplace Server
3 Restart the IBM server ltAppServergtProfilesAppServer01binstopServerbat ltAppServergtProfilesAppServer01binstartServerbat
This procedure may take about 20 minutes
Step 4 Install the Portlet and create an Application page
1 In a Web browser open the URL httpltIBM WebSphere Servergt9060ibmconsole
to open the IBM WebSphere Portal
2 Login and go to Applications | Install New Application
3 Browse to the PowerTerm WebConnectwar file located on PowerTerm WebConnect
Server
4 Enter Context root and click Next The Select installation options dialog appears
5 Optional change options to your preference or keep the default
6 Click Next
7 Select Ericom in the Module column click Apply and then Next
8 Click Finish and then Save
9 Select Applications | Enterprise Applications
10 Select PowerTerm WebConnectwar checkbox and click Start
PowerTerm WebConnect 29 Getting Started Guide
11 Enter in the Web browser the URL httpltIBM WebSphere
Servergt9080ltContext rootgtEricom portlet The Login dialog appears
12 Login and you will see PowerTerm WebConnect displayed on the list
Step 5 Run the Portlet
1 Restart IBM WebSphere Server
2 Open IBM WebSphere Portal in a browser httpltportal servergt9080ltContext
rootgtEricom portlet
3 Login to IBM WebSphere Server
4 Launch it The Userrsquos applications as defined on PowerTerm WebConnect Server
appear
5 Click an application to launch it
66 PowerTerm WebConnect Server Configuration
bull To enable the Lotus Expeditor to run the PowerTerm WebConnect client the
System Administrator must provide the users with accounts on PowerTerm
WebConnect Server (see the PowerTerm WebConnect Administratorrsquos Manual for
instructions on how to create users groups and connections on the PowerTerm
WebConnect Server)
bull To enable PowerTerm WebConnectrsquos Single Sign-On feature the System
Administrator must create a PowerTerm WebConnect user with the same
username and password as used for the Lotus Expeditor For a managed Lotus
Expeditor the credentials used are the username and password sent to the
managing server For an unmanaged Lotus Expeditor the operation system
username and the Lotus Expeditor password are used as credentials
NOTE If a password is not defined then the Single Sign-On will fail and the user will be
prompted with a login dialog
67 PowerTerm WebConnect Client Configuration
The PowerTerm WebConnect client is configured in webconnectxml located in the config
folder webconnectxml parameters are
url The PowerTerm WebConnect Agent url
server The PowerTerm WebConnect Server address
sso The Single Sign-On feature
dst The local destination for downloading PowerTerm WebConnect
components
PowerTerm WebConnect 30 Getting Started Guide
url
PowerTerm WebConnect components are installed on a Web server Their default url is
Windows Agent
httpltWebServer IPgtWebConnectwindowsptagentcab
Linux Agent
httpltWebServer IPgtWebConnectlinuxix86qterm-wczip
The url parameter must include the first part of the url (which is identical for both Windows
and Linux agents)
The PowerTerm WebConnect client will automatically append the appropriate suffix in
order to create a full accurate url
Example
ltitem key=rdquourlrdquo value=httpadminserverWebConnectgt
server
The computer name or IP address of the PowerTerm WebConnect Server machine
The PowerTerm WebConnect client will log in to this PowerTerm WebConnect Server
display the applications defined on it and run them according to this serverrsquos configuration
Format ltserver IPgt[ltportgt]
where default port is 4000 (can be edited)
Example
ltitem key=rdquoserverrdquo value=rdquoadmin24000rdquogt
sso
Determines whether Single Sign-on will be used to log in to PowerTerm WebConnect
Server Values
bull True (default) the client should automatically log in to the PowerTerm WebConnect
Server using the same credentials as the ones used to log in to the Lotus Expeditor
client
The System Administrator must verify that these credentials can log in to the
PowerTerm WebConnect Server
bull False the user will be prompted with a login dialog or will log in automatically using
previously saved credentials
Example
ltitem key=rdquossordquo value=rdquotruerdquogt
Autologin mode
PowerTerm WebConnect 31 Getting Started Guide
If sso is set to True the user is not prompted for credentials and the login process to
PowerTerm WebConnect Server is done automatically sending the credentials used for the
Lotus Expeditor unless the Lotus Expeditor does not have a password defined (In the
Lotus Expeditor preferences page | Password| Prompt me for a password at start up checkbox)
However if Single Sign-on is not used there are several options regarding Autologin that
can be defined in the PowerTerm WebConnect Preferences page Options
bull Yes
bull No
bull Interactive
bull First time interactive (default) ndash Simplifies the login process to PowerTerm
WebConnect Server In this mode the first time the user logs in to PowerTerm
WebConnect Server he will be prompted for his credentials with the Login dialog
These credentials will be stored in the machine and from then on the login process to
PowerTerm WebConnect Server will be done automatically
1 Open File | Preferences from the Lotus Expeditor and select PowerTerm WebConnect
2 In the Autologin to WebConnect Server section select First Interactive and click OK
3 Start PowerTerm WebConnect Client for Lotus Expeditor If credentials were entered
at least once then the next time the client will connect to PowerTerm WebConnect
Server without prompting for the user name and password
The Administrator must configure the Agent to do nothing when it exits for the
feature to work this way See PowerTerm WebConnect Administratorrsquos Manual for more information about defining Autologin
bull Allow multiple selection ndash Defines whether the user can launch more than one
application at a time (by using the ltCtrlgt or ltShiftgt button while selecting applications)
dst
Defines the path to download PowerTerm WebConnect components on the client machine
The dst parameter can contain macros which are translated by the PowerTerm WebConnect
Client for Lotus Expeditor during runtime The macros should be placed between percent
symbols () for example WebServer
When such a value is defined the PowerTerm WebConnect Client for Lotus Expeditor
substitutes the entire expression for the macrorsquos value
The PowerTerm WebConnect Client for Lotus Expeditor does not support the use
of environment variables as macros
Macros are not case sensitive
Macros supported by PowerTerm WebConnect Client for Lotus Expeditor
Macro name Description
WebServer The name of the Web server
It is obtained from the PowerTerm WebConnect Agent url
PowerTerm WebConnect 32 Getting Started Guide
parameter
Name The name of the clientrsquos CAB or ZIP file eg ldquoptagentrdquo
Display The clientrsquos display name from the version file
Version The clientrsquos version value It is obtained from the version
file
Root The default root location
Windows ldquoCrdquo
LinuxUnix an empty string
OSDir Windows Windowsrsquo installation directory for example
ldquoCWindowsrdquo
Linux an empty string
OSDrive Windows Windowsrsquo installation drive for example ldquoCrdquo
Linux an empty string
HomePath Windows The HOMEPATH environment variable
Linux The HOME environment variable
Home The Ericom folder in the userrsquos home directory
Windows CDocuments and SettingsltusergtApplication
DataEricom
Linux ltusergtEricom
In addition to the predefined macros listed above the PowerTerm WebConnect client
supports the usage of Java System Properties
Java System Properties available for users on Windows XP SP2
Java System Property Name Value Example
javaversion 150
javavendorurl httpwwwibmcom
javahome CIBMcommonpluginscomibmpvcwctruntim
esj2sewin32x86_150SR2-
20060511rcpeclipsepluginscomibmrcpj2sew
in32x86_150SR2-20060511jre
javavmspecificationversion 10
javavmversion 23
javavmvendor IBM Corporation
javavmname IBM J9 VM
PowerTerm WebConnect 33 Getting Started Guide
javaiotmpdir CDOCUME~1dianaLOCALS~1Temp
javacompiler j9jit23
javaextdirs CIBMcommonpluginscomibmpvcwctruntim
esj2sewin32x86_150SR2-
20060511rcpeclipsepluginscomibmrcpj2sew
in32x86_150SR2-20060511jrelibext
osname Windows XP
osarch x86
osversion 51 build 2600 Service Pack 2
pathseparator
username Jone
userhome CDocuments and SettingsJone
userdir CIBMRSA
usertimezone GMT+0200
System properties available for users on Linux RedHat 9
Java System Property Name Value Example
javaversion 150
javavendorurl httpwwwibmcom
javahome usrjavajre150_07
javavmversion 150
javavmvendor IBM Corporation
javavmname IBM J9 VM
javaclasspath
javalibrarypath
javaiotmpdir tmp
javacompiler
javaextdirs
osname Linux
osarch i386
osversion 2420-8
pathseparator
PowerTerm WebConnect 34 Getting Started Guide
username root
userhome root
userdir root
System properties names are placed in the configuration file within percent symbols ()
(like macros)
671 Configure the PowerTerm WebConnect Client
1 Open the Config Folder and edit the webconnectxml file Example
ltxml version =rdquo10rdquo encoding=rdquoUTF-8rdquogt
ltsection name=rdquoparametersrdquogt
ltitem key=rdquourlrdquo value=httpadminserverWebConnect56gt
ltitem key=rdquoserverrdquo value=rdquoadmin24000rdquogt
ltitem key=rdquossordquo value=rdquotruerdquogt
ltitem key=rdquodestrdquo value=rdquoCProgram FilesEricomrdquogt
ltsectiongt
2 Save the customized webconnectxml to a Web server folder available to all users It is
recommended to use the same Web server as the PowerTerm WebConnect Agent
Example
ltWebConnect installation foldergtwebwebconnectxml
3 Test the accessibility to this file - Type the URL of webconnectxml in the browser
Example
httpltWebServer IPgtWebConnectwebconnectxml
The contents of the file should be displayed
672 Configure the Preferences File
1 Open the plugins folder and open the PowerTermWebConnectClient_560365jar file
You can use Winzip version 70 and up or in Windows XP ndash Create a new file type for the
jar extension click advanced and select compressed (zipped) folder in the drop down list
Now you can open the JAR files in the Windows Explorer
The default contents of the file
configURL=httpleericomcomWebConnectwebconnectxml
2 Specify the accurate URL of the webconnectxml file Example
httpltWebServer IPgtWebConnectwebconnectxml
3 Save the file and close it The WinZip will display the following dialog
ldquoFile preferencesini has been changed since it was extracted Update archive
with this filerdquo
PowerTerm WebConnect 35 Getting Started Guide
4 Click Yes and close the archive
If you are editing the file from within the explorer you will have to save the file elsewhere
and then drag it to the explorer window where the JAR file is open
68 Installing PowerTerm WebConnect Client on Lotus Expeditor
1 Start the Lotus Expeditor client
2 Select File | Application | Install
3 Select Search for new features to install and click Next
4 Select Add Folder Location and type or select the location of the update site folder from
the provided package Click OK
5 Select the location you have just created and click Finish
6 In the Select the feature to install tree select Powerterm WebConnectUpdate Site Click
Next
7 Select I accept the terms in the license agreements and click Next
8 Click Finish
9 When prompted restart the platform
69 Running PowerTerm WebConnect Client for Lotus Expeditor
1 Click Open The PowerTerm WebConnect option is displayed
2 Select PowerTerm WebConnect The application will automatically connect and start
downloading the components from PowerTerm WebConnect Server
IMPORTANT
If you did not install PowerTerm WebConnect Server and are instead connecting to Ericom
Softwarersquos Demo WebConnect Server then you need to open port 443 in the firewall
691 PowerTerm WebConnect Client Workflow
1 PowerTerm WebConnect client reads the URL of webconnectxml from the preferencesini
file and requests it
2 When the webconnectxml is successfully downloaded the application reads the
configuration connects to the specified Web server downloads the PowerTerm
WebConnect components and connects to the PowerTerm WebConnect Server
3 The user is requested to login to the PowerTerm WebConnect Server For testing you
can use the username Example and password example
This step will be skipped if Single Sign-on is set to ldquotruerdquo
PowerTerm WebConnect 36 Getting Started Guide
4 After logging in to PowerTerm WebConnect Server the userrsquos applications are displayed
as defined by the administrator
5 To run an application select the desired application from the list and click Launch or
double-click the application The application will be launched in a separate window
610 Troubleshooting
When you encounter a problem the first step is to open the log file This file is located on
the client machine in the Ericom folder
Windows
CDocuments and SettingsltusernamegtEricomleclientEricomPluginlog
Linux
ltuser-home-directorygtEricomleclientEricomPluginlog
Following is a guide for diagnosing and fixing the problems in cases of error messages and
additional information
Error
Message
Solution
Version File
reading error
1 Check the lsquourlrsquo parameter in the webconnectxml file on the Web
server The value should be
httpltWebServerIPgtWebConnect
2 Try to run the following URL on the browser
Windows
httpltWebServerIPgtWebConnectwindowsptagentvertxt
Linux
httpltWebServerIPgtWebConnectlinuxix86qterm-
wcvertxt
The file contents displayed in the browser window should be in
the following form
560-rel14546
PowerTerm WebConnect Application Zone
560 - Main Release
ltrootgtPowerTerm WebConnect 56ltWebServergt
If the version file contents are not as shown check
- Is the Web Server running
- Are PowerTerm WebConnect Web Components and version files
PowerTerm WebConnect 37 Getting Started Guide
in place
3 On the Web server check ltPowerTerm WebConnect
rootgtwebwindowsptagentvertxt If the contents ldquolook wrongrdquo or
not in the proper form reinstall the PowerTerm WebConnect Web
components
4 On the client machine open the aforementioned URL in the
browser The file content should appear in the browser If it does
not it could be that the Web server is down
Web Server is
shut down
The webconnectxml configuration file must be located on the Web
server The explicit URL to this file is defined in the preferencesini
file (see Configure the Preferences File)
The error message contains the IP address of the Web server
Verify that the Web server on this machine is running
Version file
does not exist
on ltURLgt
See Version File reading error
The
configuration
file is not
accessible or
has a wrong
format
The webconnectxml configuration file must be located on the Web
server and the explicit URL to the configuration must be defined in
the preferencesini file (see Configure the Preferences File)
Try to open the URL specified in the error message in the
browser If it does not open then it either does not exist or it has
a wrong format
Preferences
file does not
exist in the
application
bundle
The preferencesini file containing the URL to the configuration
file was removed from the update site folder
Uninstall the current PowerTerm WebConnect client from the
client machine Create a new customized package (see
PowerTerm WebConnect Client Configuration) and reinstall it
Configuration
file URL is not
defined in
preference
file
The URL to the configuration file does not appear in the
preferencesini file (see Configure the Preferences File)
Uninstall the current PowerTerm WebConnect client from the
client machine Create a new customized package (see
PowerTerm WebConnect Client Configuration) and reinstall it
No IP address
could be
found for the
host
The Web server URL specified in the preferencesini file (see
Configure the Preferences File) or in the webconnectxml file (see
Configure the PowerTerm WebConnect Client) is an unknown
host
If the mistake is in the preferencesini file uninstall the current
PowerTerm WebConnect client from the client machine Create a
new customized package (see PowerTerm WebConnect Client
Configuration) and reinstall it
PowerTerm WebConnect 38 Getting Started Guide
If the mistake is in the webconnectxml file correct the file reopen
the Lotus Expeditor client
Cannot write
to destination
The temporary file cannot be written to the defined destination
Check the write permissions
Copied
configuration
file has wrong
format
The webconnectxml file as received from the specified URL has a
wrong format Correct the file and try again
PowerTerm
WebConnect
Agent URL is
malformed
The PowerTerm WebConnect Agent URL specified in the
webconnectxml file (see Configure the PowerTerm WebConnect
Client) does not have a proper HTTP format Correct the file and
try again
PowerTerm
WebConnect
Agent URL is
not defined
The PowerTerm WebConnect Agent URL parameter is not specified
in the webconnectxml file (see Configure the PowerTerm
WebConnect Client)
Correct the file and try again
The specified
destination
folder name
is wrong
The destination folder name contains illegal characters
ltgt|
Check the dst parameter in the webconnectxml file Correct the
file and try again
You do not
have
permissions
to write to
ltpathgt
The PowerTerm WebConnect Agent cannot be written to the
destination as defined Check the write permissions
The default destination defined in the version file should not to
be changed
A customized destination for PowerTerm WebConnect Agent
downloading can be defined in the webconnectxml file (See
Configure the PowerTerm WebConnect Client)
Check the destination value correct and try again
PowerTerm WebConnect 39 Getting Started Guide
About Ericom
Ericomreg Software is a leading provider of Application Access and Virtualization Solutions
Since 1993 Ericom has been helping users access enterprise mission-critical applications
running on a broad range of Microsoftreg Windowsreg Terminal Servers virtual Desktops
Blade PCs legacy hosts and other systems Ericom provides concrete business value by
helping organizations realize the benefits of their IT investments With offices in the United
States United Kingdom EMEA India and China Ericom also has an extensive network of
distributors and partners throughout North America Europe Asia and the Far East Our
expanding customer base is more than 30 thousand strong with over 7 million
installations
For more information on our products and services contact us at the location nearest to you
And visit our web site httpwwwericomcom
North America Western Europe International
Ericom Software Inc Ericom Software (UK) Ltd Ericom Software Ltd
231 Herbert Avenue Bldg 4 11a Victoria Square 8 Hamarpeh Street
Closter NJ 07624 USA Droitwich Worcestershire Har Hotzvim Technology Park
Tel +1 (201) 767 2210 WR9 8DE United Kingdom Jerusalem 91450 Israel
Fax +1 (201) 767 2205 Tel +44 (0) 845 644 3597 Tel +972 (2) 591 1700
Toll-free 1 (888) 769 7876 Fax +44 (0) 845 644 3598 Fax +972 (2) 571 4737
Email infoericomcom Email infoericomcouk Email infoericomcom
PowerTerm WebConnect 23 Getting Started Guide
6 PowerTerm WebConnect Client for Lotus Expeditor
61 Installation Package
PowerTerm WebConnect client for Lotus Expeditor is provided to IBM in an Update Site
package This is a ZIP archive containing the Update Site with the Eclipse feature and plug-
in that comprises the PowerTerm WebConnect client
Extract the ZIP file keeping the foldersrsquo structure intact
NOTE In Winzip verify that the ldquoUse folder namesrdquo option is set to TRUE
Package structure
Update Site
- plugins
- PowerTermWebConnectClient_560365jar
- features
- comericomWebConnect_560365jar
- sitexml
config
- webconnectxml
Definitions
bull webconnectxml PowerTerm WebConnect client configuration file
bull comericomWebConnect_560365jar PowerTerm WebConnect client feature file
bull PowerTermWebConnectClient_560365jar PowerTerm WebConnect client plugin file
62 Pre-installation steps
PowerTerm WebConnect client for Lotus Expeditor does not run independently but in
conjunction with PowerTerm WebConnect Server You can either install it and define your
users groups and applications or use Ericom Softwarersquos Demo PowerTerm WebConnect
Server
bull If you decide to install PowerTerm WebConnect Server you will need the full
installation ie the PowerTerm WebConnect Server and the Web components If you
do not have the installation CD you can download and install a trial version from
wwwericomcom
PowerTerm WebConnect 24 Getting Started Guide
bull If you decide to use Ericom Softwarersquos Demo PowerTerm WebConnect Server then
skip to the chapter Installing PowerTerm WebConnect Client on Lotus Expeditor
63 Install PowerTerm WebConnect Portlet on IBM Workplace server (for Windows OS)
Step 1 Install PowerTerm WebConnect Server
If PowerTerm WebConnect Server and IBM Workplace Server are on separate machines
bull Configure PowerTerm WebConnect Server
Launch PowerTerm WebConnect Administration Tool
Open Files | Configuration | Main
In the [Portal] section edit
Machines=localhostltIBM sever machinegt
bull Configure PowerTerm WebConnect Web components
Copy the ldquowebrdquo folder from the PowerTerm WebConnect server installation to the
IBM Workplace server machine
Create an Alias or a Virtual directory to it named WebConnect on the Web
server providing access to it for the users This is in order to enable the users to
download the necessary files to run their applications
Step 2 Enable JSR portlets
1 On IBM Workplace Server go to ltPortalServergtsharedappconfigservicesConfigServiceproperties
2 Edit portalenablejsr168=true
3 Save and close the file
Step 3 Enable SSO
1 On IBM Workplace Server go to ltPortalServergtsharedappconfigservicesLoaderServiceproperties
2 Edit commandpath=comericomportalcommandscomibmwpsenginecommands
3 Save and close the file
Step 4 Copy Files
The following files need to be copied from WebConnect ServerAddOnsIBM
WorkplacePortlet folder to IBM Workplace Server
File name to copy Destination folder
OpenSSLdll ltAppServergtjavajrebin
IbmPortaldll ltAppServergtjavajrebin
IbmPortalini ltAppServergtjavajrebin
PowerTerm WebConnect 25 Getting Started Guide
WebConnectPortaljar ltAppServergtlib
EricomLoginjar ltPortalServergtsharedapp
Step 5 Portlet Configuration
1 On IBM Workplace Server go to ltAppServergtjavajrebinIbmPortalini
2 You can modify the following parameters in the [Server=WebConnect] section webserverport=ltIBM web server portgt
Specifies the Web server port for accessing the PowerTerm WebConnect clients folder
Default 80 Address
Specifies the address of the PowerTerm WebConnect Server machine for Portlet to
connect to when PowerTerm WebConnect Server is located on a different machine
than the IBM Workplace Server CustomAddress
Specifies the addresss of the PowerTerm WebConnect Server machine for Clients to connect to If CustomAddress is the same as Address then this may be omitted webserveraddr
Specifies the address of the Web Server machine when it is located on a different
machine than the IBM Workplace Server
3 Restart the IBM server ltPortalServergtrootscriptsstopWorkplaceServicesbat ltPortalServergtrootscriptsstartWorkplaceServicesbat
This procedure may take about 20 minutes
Step 6 Install the Portlet
1 In a Web browser open the URL httpltIBM Workplace
Servergt9081lwpmyworkplace to open the IBM Workplace Portal
2 Login as administrator
3 Go to Administration | Portlets | Install
4 Browse to the PowerTerm WebConnectwar file located on PowerTerm WebConnect
Server and click Next
5 Click Install
Step 7 Create an Application page
1 Login to the Workplace
2 Go to Portal User Interface | Manage Pages
3 Search for My Work
4 Click the My Work link and select New Page
5 Name the page PowerTerm WebConnect and click OK
6 Click OK again You will see the created page on the list
7 Click the pencil icon on the new page and select the 1 square layout
PowerTerm WebConnect 26 Getting Started Guide
8 Click Add Portlet and search for PowerTerm WebConnect
9 Select it and click OK
10 Click Done
11 Click My work at the top of the page PowerTerm WebConnect is displayed on the list
Step 8 Run the Portlet
1 Restart IBM Workplace Server
2 Open IBM Workplace Portal in a browser httpltportal servergtlwpmyworkplace
3 Login to IBM Workplace Server
4 Click My work PowerTerm WebConnect portlet is displayed
5 Launch it The Userrsquos applications as defined on PowerTerm WebConnect Server
appear
6 Click an application to launch it
64 Install PowerTerm WebConnect Portlet on IBM Workplace server (for Linux OS)
Step 1 Enable JSR 168 portlets
1 Go to optIBMWorkplacePortalServersharedappconfigservicesConfigServiceproperties
2 Modify the portalenablejsr168 property to ldquotruerdquo
3 Restart the server cd optIBMWorkplacePortalServerrootscripts
Run stopWorkplaceServicessh
Run startWorkplaceServicessh
This procedure can take up to 20 minutes
4 Log on to the workplace server at httpltworkplace servergt9081lwpmyworkplace using
the administrators username and password
Step 2 Install the portlet
1 Restart IBM Workplace Server
2 In a Web browser open the URL httpltworkplace server IPgtlwpmyworkplace
3 Login to IBM Workplace Server as an administrator
4 Go to Administration | Portlets | Install
5 Browse to the PowerTerm WebConnectwar file located on PowerTerm WebConnect
Server and click Next
6 Click Install
PowerTerm WebConnect 27 Getting Started Guide
Step 3 Install the Application page
1 Login to the workplace as administrator
2 Go to Administration | Portal User Interface | Manage Pages
3 Search for My Work
4 Click the My Work link and select New Page
5 Name the page PowerTerm WebConnect and click OK
6 Click OK again You will see the created page on the list
7 Click the pencil icon and select the 1-square layout
8 Click Add Portlet and search for PowerTerm WebConnect
9 Select it and click OK
10 Click Done
11 Click My work on top and PowerTerm WebConnect is displayed on the left bar
Step 4 Run the portlet
1 Restart IBM Workplace Server
2 Open IBM Workplace Portal in a browser httpltportal servergtlwpmyworkplace
3 Login to IBM Workplace Server
4 Click My work PowerTerm WebConnect portlet is displayed
5 Launch it The Userrsquos applications as defined on PowerTerm WebConnect Server
appear
6 Click an application to launch it
65 Install PowerTerm WebConnect Portlet on IBM WebSphere 61 server (for Windows OS)
Step 1 Install PowerTerm WebConnect Server
You have to configure PowerTerm WebConnect Server if it and the IBM WebSphere Server
are on separate machines
1 Launch PowerTerm WebConnect Administration Tool
2 Open Files | Configuration | Main
3 In the [Portal] section edit Machines=localhostltIBM sever machinegt
Step 2 Copy Files
The following files need to be copied from WebConnect ServerAddOnsIBM
WebSpherePortlet folder to IBM WebSphere Server
PowerTerm WebConnect 28 Getting Started Guide
File name to copy Destination folder
OpenSSLdll ltAppServergtjavajrebin
IbmPortaldll ltAppServergtjavajrebin
IbmPortalini ltAppServergtjavajrebin
WebConnectPortaljar ltAppServergtlib
Step 3 Portlet Configuration
1 On IBM Workplace Server go to ltAppServergtjavajrebinIbmPortalini
2 You can modify the following parameters in the [Server=WebConnect] section webserverport=ltIBM web server portgt
Specifies the Web server port for accessing the PowerTerm WebConnect clients folder
Default 80 Address
Specifies the address of the PowerTerm WebConnect Server machine for Portlet to
connect to when PowerTerm WebConnect Server is located on a different machine
than the IBM Workplace Server CustomAddress
Specifies the addresss of the PowerTerm WebConnect Server machine for Clients to connect to If CustomAddress is the same as Address then this may be omitted webserveraddr
Specifies the address of the Web Server machine when it is located on a different
machine than the IBM Workplace Server
3 Restart the IBM server ltAppServergtProfilesAppServer01binstopServerbat ltAppServergtProfilesAppServer01binstartServerbat
This procedure may take about 20 minutes
Step 4 Install the Portlet and create an Application page
1 In a Web browser open the URL httpltIBM WebSphere Servergt9060ibmconsole
to open the IBM WebSphere Portal
2 Login and go to Applications | Install New Application
3 Browse to the PowerTerm WebConnectwar file located on PowerTerm WebConnect
Server
4 Enter Context root and click Next The Select installation options dialog appears
5 Optional change options to your preference or keep the default
6 Click Next
7 Select Ericom in the Module column click Apply and then Next
8 Click Finish and then Save
9 Select Applications | Enterprise Applications
10 Select PowerTerm WebConnectwar checkbox and click Start
PowerTerm WebConnect 29 Getting Started Guide
11 Enter in the Web browser the URL httpltIBM WebSphere
Servergt9080ltContext rootgtEricom portlet The Login dialog appears
12 Login and you will see PowerTerm WebConnect displayed on the list
Step 5 Run the Portlet
1 Restart IBM WebSphere Server
2 Open IBM WebSphere Portal in a browser httpltportal servergt9080ltContext
rootgtEricom portlet
3 Login to IBM WebSphere Server
4 Launch it The Userrsquos applications as defined on PowerTerm WebConnect Server
appear
5 Click an application to launch it
66 PowerTerm WebConnect Server Configuration
bull To enable the Lotus Expeditor to run the PowerTerm WebConnect client the
System Administrator must provide the users with accounts on PowerTerm
WebConnect Server (see the PowerTerm WebConnect Administratorrsquos Manual for
instructions on how to create users groups and connections on the PowerTerm
WebConnect Server)
bull To enable PowerTerm WebConnectrsquos Single Sign-On feature the System
Administrator must create a PowerTerm WebConnect user with the same
username and password as used for the Lotus Expeditor For a managed Lotus
Expeditor the credentials used are the username and password sent to the
managing server For an unmanaged Lotus Expeditor the operation system
username and the Lotus Expeditor password are used as credentials
NOTE If a password is not defined then the Single Sign-On will fail and the user will be
prompted with a login dialog
67 PowerTerm WebConnect Client Configuration
The PowerTerm WebConnect client is configured in webconnectxml located in the config
folder webconnectxml parameters are
url The PowerTerm WebConnect Agent url
server The PowerTerm WebConnect Server address
sso The Single Sign-On feature
dst The local destination for downloading PowerTerm WebConnect
components
PowerTerm WebConnect 30 Getting Started Guide
url
PowerTerm WebConnect components are installed on a Web server Their default url is
Windows Agent
httpltWebServer IPgtWebConnectwindowsptagentcab
Linux Agent
httpltWebServer IPgtWebConnectlinuxix86qterm-wczip
The url parameter must include the first part of the url (which is identical for both Windows
and Linux agents)
The PowerTerm WebConnect client will automatically append the appropriate suffix in
order to create a full accurate url
Example
ltitem key=rdquourlrdquo value=httpadminserverWebConnectgt
server
The computer name or IP address of the PowerTerm WebConnect Server machine
The PowerTerm WebConnect client will log in to this PowerTerm WebConnect Server
display the applications defined on it and run them according to this serverrsquos configuration
Format ltserver IPgt[ltportgt]
where default port is 4000 (can be edited)
Example
ltitem key=rdquoserverrdquo value=rdquoadmin24000rdquogt
sso
Determines whether Single Sign-on will be used to log in to PowerTerm WebConnect
Server Values
bull True (default) the client should automatically log in to the PowerTerm WebConnect
Server using the same credentials as the ones used to log in to the Lotus Expeditor
client
The System Administrator must verify that these credentials can log in to the
PowerTerm WebConnect Server
bull False the user will be prompted with a login dialog or will log in automatically using
previously saved credentials
Example
ltitem key=rdquossordquo value=rdquotruerdquogt
Autologin mode
PowerTerm WebConnect 31 Getting Started Guide
If sso is set to True the user is not prompted for credentials and the login process to
PowerTerm WebConnect Server is done automatically sending the credentials used for the
Lotus Expeditor unless the Lotus Expeditor does not have a password defined (In the
Lotus Expeditor preferences page | Password| Prompt me for a password at start up checkbox)
However if Single Sign-on is not used there are several options regarding Autologin that
can be defined in the PowerTerm WebConnect Preferences page Options
bull Yes
bull No
bull Interactive
bull First time interactive (default) ndash Simplifies the login process to PowerTerm
WebConnect Server In this mode the first time the user logs in to PowerTerm
WebConnect Server he will be prompted for his credentials with the Login dialog
These credentials will be stored in the machine and from then on the login process to
PowerTerm WebConnect Server will be done automatically
1 Open File | Preferences from the Lotus Expeditor and select PowerTerm WebConnect
2 In the Autologin to WebConnect Server section select First Interactive and click OK
3 Start PowerTerm WebConnect Client for Lotus Expeditor If credentials were entered
at least once then the next time the client will connect to PowerTerm WebConnect
Server without prompting for the user name and password
The Administrator must configure the Agent to do nothing when it exits for the
feature to work this way See PowerTerm WebConnect Administratorrsquos Manual for more information about defining Autologin
bull Allow multiple selection ndash Defines whether the user can launch more than one
application at a time (by using the ltCtrlgt or ltShiftgt button while selecting applications)
dst
Defines the path to download PowerTerm WebConnect components on the client machine
The dst parameter can contain macros which are translated by the PowerTerm WebConnect
Client for Lotus Expeditor during runtime The macros should be placed between percent
symbols () for example WebServer
When such a value is defined the PowerTerm WebConnect Client for Lotus Expeditor
substitutes the entire expression for the macrorsquos value
The PowerTerm WebConnect Client for Lotus Expeditor does not support the use
of environment variables as macros
Macros are not case sensitive
Macros supported by PowerTerm WebConnect Client for Lotus Expeditor
Macro name Description
WebServer The name of the Web server
It is obtained from the PowerTerm WebConnect Agent url
PowerTerm WebConnect 32 Getting Started Guide
parameter
Name The name of the clientrsquos CAB or ZIP file eg ldquoptagentrdquo
Display The clientrsquos display name from the version file
Version The clientrsquos version value It is obtained from the version
file
Root The default root location
Windows ldquoCrdquo
LinuxUnix an empty string
OSDir Windows Windowsrsquo installation directory for example
ldquoCWindowsrdquo
Linux an empty string
OSDrive Windows Windowsrsquo installation drive for example ldquoCrdquo
Linux an empty string
HomePath Windows The HOMEPATH environment variable
Linux The HOME environment variable
Home The Ericom folder in the userrsquos home directory
Windows CDocuments and SettingsltusergtApplication
DataEricom
Linux ltusergtEricom
In addition to the predefined macros listed above the PowerTerm WebConnect client
supports the usage of Java System Properties
Java System Properties available for users on Windows XP SP2
Java System Property Name Value Example
javaversion 150
javavendorurl httpwwwibmcom
javahome CIBMcommonpluginscomibmpvcwctruntim
esj2sewin32x86_150SR2-
20060511rcpeclipsepluginscomibmrcpj2sew
in32x86_150SR2-20060511jre
javavmspecificationversion 10
javavmversion 23
javavmvendor IBM Corporation
javavmname IBM J9 VM
PowerTerm WebConnect 33 Getting Started Guide
javaiotmpdir CDOCUME~1dianaLOCALS~1Temp
javacompiler j9jit23
javaextdirs CIBMcommonpluginscomibmpvcwctruntim
esj2sewin32x86_150SR2-
20060511rcpeclipsepluginscomibmrcpj2sew
in32x86_150SR2-20060511jrelibext
osname Windows XP
osarch x86
osversion 51 build 2600 Service Pack 2
pathseparator
username Jone
userhome CDocuments and SettingsJone
userdir CIBMRSA
usertimezone GMT+0200
System properties available for users on Linux RedHat 9
Java System Property Name Value Example
javaversion 150
javavendorurl httpwwwibmcom
javahome usrjavajre150_07
javavmversion 150
javavmvendor IBM Corporation
javavmname IBM J9 VM
javaclasspath
javalibrarypath
javaiotmpdir tmp
javacompiler
javaextdirs
osname Linux
osarch i386
osversion 2420-8
pathseparator
PowerTerm WebConnect 34 Getting Started Guide
username root
userhome root
userdir root
System properties names are placed in the configuration file within percent symbols ()
(like macros)
671 Configure the PowerTerm WebConnect Client
1 Open the Config Folder and edit the webconnectxml file Example
ltxml version =rdquo10rdquo encoding=rdquoUTF-8rdquogt
ltsection name=rdquoparametersrdquogt
ltitem key=rdquourlrdquo value=httpadminserverWebConnect56gt
ltitem key=rdquoserverrdquo value=rdquoadmin24000rdquogt
ltitem key=rdquossordquo value=rdquotruerdquogt
ltitem key=rdquodestrdquo value=rdquoCProgram FilesEricomrdquogt
ltsectiongt
2 Save the customized webconnectxml to a Web server folder available to all users It is
recommended to use the same Web server as the PowerTerm WebConnect Agent
Example
ltWebConnect installation foldergtwebwebconnectxml
3 Test the accessibility to this file - Type the URL of webconnectxml in the browser
Example
httpltWebServer IPgtWebConnectwebconnectxml
The contents of the file should be displayed
672 Configure the Preferences File
1 Open the plugins folder and open the PowerTermWebConnectClient_560365jar file
You can use Winzip version 70 and up or in Windows XP ndash Create a new file type for the
jar extension click advanced and select compressed (zipped) folder in the drop down list
Now you can open the JAR files in the Windows Explorer
The default contents of the file
configURL=httpleericomcomWebConnectwebconnectxml
2 Specify the accurate URL of the webconnectxml file Example
httpltWebServer IPgtWebConnectwebconnectxml
3 Save the file and close it The WinZip will display the following dialog
ldquoFile preferencesini has been changed since it was extracted Update archive
with this filerdquo
PowerTerm WebConnect 35 Getting Started Guide
4 Click Yes and close the archive
If you are editing the file from within the explorer you will have to save the file elsewhere
and then drag it to the explorer window where the JAR file is open
68 Installing PowerTerm WebConnect Client on Lotus Expeditor
1 Start the Lotus Expeditor client
2 Select File | Application | Install
3 Select Search for new features to install and click Next
4 Select Add Folder Location and type or select the location of the update site folder from
the provided package Click OK
5 Select the location you have just created and click Finish
6 In the Select the feature to install tree select Powerterm WebConnectUpdate Site Click
Next
7 Select I accept the terms in the license agreements and click Next
8 Click Finish
9 When prompted restart the platform
69 Running PowerTerm WebConnect Client for Lotus Expeditor
1 Click Open The PowerTerm WebConnect option is displayed
2 Select PowerTerm WebConnect The application will automatically connect and start
downloading the components from PowerTerm WebConnect Server
IMPORTANT
If you did not install PowerTerm WebConnect Server and are instead connecting to Ericom
Softwarersquos Demo WebConnect Server then you need to open port 443 in the firewall
691 PowerTerm WebConnect Client Workflow
1 PowerTerm WebConnect client reads the URL of webconnectxml from the preferencesini
file and requests it
2 When the webconnectxml is successfully downloaded the application reads the
configuration connects to the specified Web server downloads the PowerTerm
WebConnect components and connects to the PowerTerm WebConnect Server
3 The user is requested to login to the PowerTerm WebConnect Server For testing you
can use the username Example and password example
This step will be skipped if Single Sign-on is set to ldquotruerdquo
PowerTerm WebConnect 36 Getting Started Guide
4 After logging in to PowerTerm WebConnect Server the userrsquos applications are displayed
as defined by the administrator
5 To run an application select the desired application from the list and click Launch or
double-click the application The application will be launched in a separate window
610 Troubleshooting
When you encounter a problem the first step is to open the log file This file is located on
the client machine in the Ericom folder
Windows
CDocuments and SettingsltusernamegtEricomleclientEricomPluginlog
Linux
ltuser-home-directorygtEricomleclientEricomPluginlog
Following is a guide for diagnosing and fixing the problems in cases of error messages and
additional information
Error
Message
Solution
Version File
reading error
1 Check the lsquourlrsquo parameter in the webconnectxml file on the Web
server The value should be
httpltWebServerIPgtWebConnect
2 Try to run the following URL on the browser
Windows
httpltWebServerIPgtWebConnectwindowsptagentvertxt
Linux
httpltWebServerIPgtWebConnectlinuxix86qterm-
wcvertxt
The file contents displayed in the browser window should be in
the following form
560-rel14546
PowerTerm WebConnect Application Zone
560 - Main Release
ltrootgtPowerTerm WebConnect 56ltWebServergt
If the version file contents are not as shown check
- Is the Web Server running
- Are PowerTerm WebConnect Web Components and version files
PowerTerm WebConnect 37 Getting Started Guide
in place
3 On the Web server check ltPowerTerm WebConnect
rootgtwebwindowsptagentvertxt If the contents ldquolook wrongrdquo or
not in the proper form reinstall the PowerTerm WebConnect Web
components
4 On the client machine open the aforementioned URL in the
browser The file content should appear in the browser If it does
not it could be that the Web server is down
Web Server is
shut down
The webconnectxml configuration file must be located on the Web
server The explicit URL to this file is defined in the preferencesini
file (see Configure the Preferences File)
The error message contains the IP address of the Web server
Verify that the Web server on this machine is running
Version file
does not exist
on ltURLgt
See Version File reading error
The
configuration
file is not
accessible or
has a wrong
format
The webconnectxml configuration file must be located on the Web
server and the explicit URL to the configuration must be defined in
the preferencesini file (see Configure the Preferences File)
Try to open the URL specified in the error message in the
browser If it does not open then it either does not exist or it has
a wrong format
Preferences
file does not
exist in the
application
bundle
The preferencesini file containing the URL to the configuration
file was removed from the update site folder
Uninstall the current PowerTerm WebConnect client from the
client machine Create a new customized package (see
PowerTerm WebConnect Client Configuration) and reinstall it
Configuration
file URL is not
defined in
preference
file
The URL to the configuration file does not appear in the
preferencesini file (see Configure the Preferences File)
Uninstall the current PowerTerm WebConnect client from the
client machine Create a new customized package (see
PowerTerm WebConnect Client Configuration) and reinstall it
No IP address
could be
found for the
host
The Web server URL specified in the preferencesini file (see
Configure the Preferences File) or in the webconnectxml file (see
Configure the PowerTerm WebConnect Client) is an unknown
host
If the mistake is in the preferencesini file uninstall the current
PowerTerm WebConnect client from the client machine Create a
new customized package (see PowerTerm WebConnect Client
Configuration) and reinstall it
PowerTerm WebConnect 38 Getting Started Guide
If the mistake is in the webconnectxml file correct the file reopen
the Lotus Expeditor client
Cannot write
to destination
The temporary file cannot be written to the defined destination
Check the write permissions
Copied
configuration
file has wrong
format
The webconnectxml file as received from the specified URL has a
wrong format Correct the file and try again
PowerTerm
WebConnect
Agent URL is
malformed
The PowerTerm WebConnect Agent URL specified in the
webconnectxml file (see Configure the PowerTerm WebConnect
Client) does not have a proper HTTP format Correct the file and
try again
PowerTerm
WebConnect
Agent URL is
not defined
The PowerTerm WebConnect Agent URL parameter is not specified
in the webconnectxml file (see Configure the PowerTerm
WebConnect Client)
Correct the file and try again
The specified
destination
folder name
is wrong
The destination folder name contains illegal characters
ltgt|
Check the dst parameter in the webconnectxml file Correct the
file and try again
You do not
have
permissions
to write to
ltpathgt
The PowerTerm WebConnect Agent cannot be written to the
destination as defined Check the write permissions
The default destination defined in the version file should not to
be changed
A customized destination for PowerTerm WebConnect Agent
downloading can be defined in the webconnectxml file (See
Configure the PowerTerm WebConnect Client)
Check the destination value correct and try again
PowerTerm WebConnect 39 Getting Started Guide
About Ericom
Ericomreg Software is a leading provider of Application Access and Virtualization Solutions
Since 1993 Ericom has been helping users access enterprise mission-critical applications
running on a broad range of Microsoftreg Windowsreg Terminal Servers virtual Desktops
Blade PCs legacy hosts and other systems Ericom provides concrete business value by
helping organizations realize the benefits of their IT investments With offices in the United
States United Kingdom EMEA India and China Ericom also has an extensive network of
distributors and partners throughout North America Europe Asia and the Far East Our
expanding customer base is more than 30 thousand strong with over 7 million
installations
For more information on our products and services contact us at the location nearest to you
And visit our web site httpwwwericomcom
North America Western Europe International
Ericom Software Inc Ericom Software (UK) Ltd Ericom Software Ltd
231 Herbert Avenue Bldg 4 11a Victoria Square 8 Hamarpeh Street
Closter NJ 07624 USA Droitwich Worcestershire Har Hotzvim Technology Park
Tel +1 (201) 767 2210 WR9 8DE United Kingdom Jerusalem 91450 Israel
Fax +1 (201) 767 2205 Tel +44 (0) 845 644 3597 Tel +972 (2) 591 1700
Toll-free 1 (888) 769 7876 Fax +44 (0) 845 644 3598 Fax +972 (2) 571 4737
Email infoericomcom Email infoericomcouk Email infoericomcom
PowerTerm WebConnect 24 Getting Started Guide
bull If you decide to use Ericom Softwarersquos Demo PowerTerm WebConnect Server then
skip to the chapter Installing PowerTerm WebConnect Client on Lotus Expeditor
63 Install PowerTerm WebConnect Portlet on IBM Workplace server (for Windows OS)
Step 1 Install PowerTerm WebConnect Server
If PowerTerm WebConnect Server and IBM Workplace Server are on separate machines
bull Configure PowerTerm WebConnect Server
Launch PowerTerm WebConnect Administration Tool
Open Files | Configuration | Main
In the [Portal] section edit
Machines=localhostltIBM sever machinegt
bull Configure PowerTerm WebConnect Web components
Copy the ldquowebrdquo folder from the PowerTerm WebConnect server installation to the
IBM Workplace server machine
Create an Alias or a Virtual directory to it named WebConnect on the Web
server providing access to it for the users This is in order to enable the users to
download the necessary files to run their applications
Step 2 Enable JSR portlets
1 On IBM Workplace Server go to ltPortalServergtsharedappconfigservicesConfigServiceproperties
2 Edit portalenablejsr168=true
3 Save and close the file
Step 3 Enable SSO
1 On IBM Workplace Server go to ltPortalServergtsharedappconfigservicesLoaderServiceproperties
2 Edit commandpath=comericomportalcommandscomibmwpsenginecommands
3 Save and close the file
Step 4 Copy Files
The following files need to be copied from WebConnect ServerAddOnsIBM
WorkplacePortlet folder to IBM Workplace Server
File name to copy Destination folder
OpenSSLdll ltAppServergtjavajrebin
IbmPortaldll ltAppServergtjavajrebin
IbmPortalini ltAppServergtjavajrebin
PowerTerm WebConnect 25 Getting Started Guide
WebConnectPortaljar ltAppServergtlib
EricomLoginjar ltPortalServergtsharedapp
Step 5 Portlet Configuration
1 On IBM Workplace Server go to ltAppServergtjavajrebinIbmPortalini
2 You can modify the following parameters in the [Server=WebConnect] section webserverport=ltIBM web server portgt
Specifies the Web server port for accessing the PowerTerm WebConnect clients folder
Default 80 Address
Specifies the address of the PowerTerm WebConnect Server machine for Portlet to
connect to when PowerTerm WebConnect Server is located on a different machine
than the IBM Workplace Server CustomAddress
Specifies the addresss of the PowerTerm WebConnect Server machine for Clients to connect to If CustomAddress is the same as Address then this may be omitted webserveraddr
Specifies the address of the Web Server machine when it is located on a different
machine than the IBM Workplace Server
3 Restart the IBM server ltPortalServergtrootscriptsstopWorkplaceServicesbat ltPortalServergtrootscriptsstartWorkplaceServicesbat
This procedure may take about 20 minutes
Step 6 Install the Portlet
1 In a Web browser open the URL httpltIBM Workplace
Servergt9081lwpmyworkplace to open the IBM Workplace Portal
2 Login as administrator
3 Go to Administration | Portlets | Install
4 Browse to the PowerTerm WebConnectwar file located on PowerTerm WebConnect
Server and click Next
5 Click Install
Step 7 Create an Application page
1 Login to the Workplace
2 Go to Portal User Interface | Manage Pages
3 Search for My Work
4 Click the My Work link and select New Page
5 Name the page PowerTerm WebConnect and click OK
6 Click OK again You will see the created page on the list
7 Click the pencil icon on the new page and select the 1 square layout
PowerTerm WebConnect 26 Getting Started Guide
8 Click Add Portlet and search for PowerTerm WebConnect
9 Select it and click OK
10 Click Done
11 Click My work at the top of the page PowerTerm WebConnect is displayed on the list
Step 8 Run the Portlet
1 Restart IBM Workplace Server
2 Open IBM Workplace Portal in a browser httpltportal servergtlwpmyworkplace
3 Login to IBM Workplace Server
4 Click My work PowerTerm WebConnect portlet is displayed
5 Launch it The Userrsquos applications as defined on PowerTerm WebConnect Server
appear
6 Click an application to launch it
64 Install PowerTerm WebConnect Portlet on IBM Workplace server (for Linux OS)
Step 1 Enable JSR 168 portlets
1 Go to optIBMWorkplacePortalServersharedappconfigservicesConfigServiceproperties
2 Modify the portalenablejsr168 property to ldquotruerdquo
3 Restart the server cd optIBMWorkplacePortalServerrootscripts
Run stopWorkplaceServicessh
Run startWorkplaceServicessh
This procedure can take up to 20 minutes
4 Log on to the workplace server at httpltworkplace servergt9081lwpmyworkplace using
the administrators username and password
Step 2 Install the portlet
1 Restart IBM Workplace Server
2 In a Web browser open the URL httpltworkplace server IPgtlwpmyworkplace
3 Login to IBM Workplace Server as an administrator
4 Go to Administration | Portlets | Install
5 Browse to the PowerTerm WebConnectwar file located on PowerTerm WebConnect
Server and click Next
6 Click Install
PowerTerm WebConnect 27 Getting Started Guide
Step 3 Install the Application page
1 Login to the workplace as administrator
2 Go to Administration | Portal User Interface | Manage Pages
3 Search for My Work
4 Click the My Work link and select New Page
5 Name the page PowerTerm WebConnect and click OK
6 Click OK again You will see the created page on the list
7 Click the pencil icon and select the 1-square layout
8 Click Add Portlet and search for PowerTerm WebConnect
9 Select it and click OK
10 Click Done
11 Click My work on top and PowerTerm WebConnect is displayed on the left bar
Step 4 Run the portlet
1 Restart IBM Workplace Server
2 Open IBM Workplace Portal in a browser httpltportal servergtlwpmyworkplace
3 Login to IBM Workplace Server
4 Click My work PowerTerm WebConnect portlet is displayed
5 Launch it The Userrsquos applications as defined on PowerTerm WebConnect Server
appear
6 Click an application to launch it
65 Install PowerTerm WebConnect Portlet on IBM WebSphere 61 server (for Windows OS)
Step 1 Install PowerTerm WebConnect Server
You have to configure PowerTerm WebConnect Server if it and the IBM WebSphere Server
are on separate machines
1 Launch PowerTerm WebConnect Administration Tool
2 Open Files | Configuration | Main
3 In the [Portal] section edit Machines=localhostltIBM sever machinegt
Step 2 Copy Files
The following files need to be copied from WebConnect ServerAddOnsIBM
WebSpherePortlet folder to IBM WebSphere Server
PowerTerm WebConnect 28 Getting Started Guide
File name to copy Destination folder
OpenSSLdll ltAppServergtjavajrebin
IbmPortaldll ltAppServergtjavajrebin
IbmPortalini ltAppServergtjavajrebin
WebConnectPortaljar ltAppServergtlib
Step 3 Portlet Configuration
1 On IBM Workplace Server go to ltAppServergtjavajrebinIbmPortalini
2 You can modify the following parameters in the [Server=WebConnect] section webserverport=ltIBM web server portgt
Specifies the Web server port for accessing the PowerTerm WebConnect clients folder
Default 80 Address
Specifies the address of the PowerTerm WebConnect Server machine for Portlet to
connect to when PowerTerm WebConnect Server is located on a different machine
than the IBM Workplace Server CustomAddress
Specifies the addresss of the PowerTerm WebConnect Server machine for Clients to connect to If CustomAddress is the same as Address then this may be omitted webserveraddr
Specifies the address of the Web Server machine when it is located on a different
machine than the IBM Workplace Server
3 Restart the IBM server ltAppServergtProfilesAppServer01binstopServerbat ltAppServergtProfilesAppServer01binstartServerbat
This procedure may take about 20 minutes
Step 4 Install the Portlet and create an Application page
1 In a Web browser open the URL httpltIBM WebSphere Servergt9060ibmconsole
to open the IBM WebSphere Portal
2 Login and go to Applications | Install New Application
3 Browse to the PowerTerm WebConnectwar file located on PowerTerm WebConnect
Server
4 Enter Context root and click Next The Select installation options dialog appears
5 Optional change options to your preference or keep the default
6 Click Next
7 Select Ericom in the Module column click Apply and then Next
8 Click Finish and then Save
9 Select Applications | Enterprise Applications
10 Select PowerTerm WebConnectwar checkbox and click Start
PowerTerm WebConnect 29 Getting Started Guide
11 Enter in the Web browser the URL httpltIBM WebSphere
Servergt9080ltContext rootgtEricom portlet The Login dialog appears
12 Login and you will see PowerTerm WebConnect displayed on the list
Step 5 Run the Portlet
1 Restart IBM WebSphere Server
2 Open IBM WebSphere Portal in a browser httpltportal servergt9080ltContext
rootgtEricom portlet
3 Login to IBM WebSphere Server
4 Launch it The Userrsquos applications as defined on PowerTerm WebConnect Server
appear
5 Click an application to launch it
66 PowerTerm WebConnect Server Configuration
bull To enable the Lotus Expeditor to run the PowerTerm WebConnect client the
System Administrator must provide the users with accounts on PowerTerm
WebConnect Server (see the PowerTerm WebConnect Administratorrsquos Manual for
instructions on how to create users groups and connections on the PowerTerm
WebConnect Server)
bull To enable PowerTerm WebConnectrsquos Single Sign-On feature the System
Administrator must create a PowerTerm WebConnect user with the same
username and password as used for the Lotus Expeditor For a managed Lotus
Expeditor the credentials used are the username and password sent to the
managing server For an unmanaged Lotus Expeditor the operation system
username and the Lotus Expeditor password are used as credentials
NOTE If a password is not defined then the Single Sign-On will fail and the user will be
prompted with a login dialog
67 PowerTerm WebConnect Client Configuration
The PowerTerm WebConnect client is configured in webconnectxml located in the config
folder webconnectxml parameters are
url The PowerTerm WebConnect Agent url
server The PowerTerm WebConnect Server address
sso The Single Sign-On feature
dst The local destination for downloading PowerTerm WebConnect
components
PowerTerm WebConnect 30 Getting Started Guide
url
PowerTerm WebConnect components are installed on a Web server Their default url is
Windows Agent
httpltWebServer IPgtWebConnectwindowsptagentcab
Linux Agent
httpltWebServer IPgtWebConnectlinuxix86qterm-wczip
The url parameter must include the first part of the url (which is identical for both Windows
and Linux agents)
The PowerTerm WebConnect client will automatically append the appropriate suffix in
order to create a full accurate url
Example
ltitem key=rdquourlrdquo value=httpadminserverWebConnectgt
server
The computer name or IP address of the PowerTerm WebConnect Server machine
The PowerTerm WebConnect client will log in to this PowerTerm WebConnect Server
display the applications defined on it and run them according to this serverrsquos configuration
Format ltserver IPgt[ltportgt]
where default port is 4000 (can be edited)
Example
ltitem key=rdquoserverrdquo value=rdquoadmin24000rdquogt
sso
Determines whether Single Sign-on will be used to log in to PowerTerm WebConnect
Server Values
bull True (default) the client should automatically log in to the PowerTerm WebConnect
Server using the same credentials as the ones used to log in to the Lotus Expeditor
client
The System Administrator must verify that these credentials can log in to the
PowerTerm WebConnect Server
bull False the user will be prompted with a login dialog or will log in automatically using
previously saved credentials
Example
ltitem key=rdquossordquo value=rdquotruerdquogt
Autologin mode
PowerTerm WebConnect 31 Getting Started Guide
If sso is set to True the user is not prompted for credentials and the login process to
PowerTerm WebConnect Server is done automatically sending the credentials used for the
Lotus Expeditor unless the Lotus Expeditor does not have a password defined (In the
Lotus Expeditor preferences page | Password| Prompt me for a password at start up checkbox)
However if Single Sign-on is not used there are several options regarding Autologin that
can be defined in the PowerTerm WebConnect Preferences page Options
bull Yes
bull No
bull Interactive
bull First time interactive (default) ndash Simplifies the login process to PowerTerm
WebConnect Server In this mode the first time the user logs in to PowerTerm
WebConnect Server he will be prompted for his credentials with the Login dialog
These credentials will be stored in the machine and from then on the login process to
PowerTerm WebConnect Server will be done automatically
1 Open File | Preferences from the Lotus Expeditor and select PowerTerm WebConnect
2 In the Autologin to WebConnect Server section select First Interactive and click OK
3 Start PowerTerm WebConnect Client for Lotus Expeditor If credentials were entered
at least once then the next time the client will connect to PowerTerm WebConnect
Server without prompting for the user name and password
The Administrator must configure the Agent to do nothing when it exits for the
feature to work this way See PowerTerm WebConnect Administratorrsquos Manual for more information about defining Autologin
bull Allow multiple selection ndash Defines whether the user can launch more than one
application at a time (by using the ltCtrlgt or ltShiftgt button while selecting applications)
dst
Defines the path to download PowerTerm WebConnect components on the client machine
The dst parameter can contain macros which are translated by the PowerTerm WebConnect
Client for Lotus Expeditor during runtime The macros should be placed between percent
symbols () for example WebServer
When such a value is defined the PowerTerm WebConnect Client for Lotus Expeditor
substitutes the entire expression for the macrorsquos value
The PowerTerm WebConnect Client for Lotus Expeditor does not support the use
of environment variables as macros
Macros are not case sensitive
Macros supported by PowerTerm WebConnect Client for Lotus Expeditor
Macro name Description
WebServer The name of the Web server
It is obtained from the PowerTerm WebConnect Agent url
PowerTerm WebConnect 32 Getting Started Guide
parameter
Name The name of the clientrsquos CAB or ZIP file eg ldquoptagentrdquo
Display The clientrsquos display name from the version file
Version The clientrsquos version value It is obtained from the version
file
Root The default root location
Windows ldquoCrdquo
LinuxUnix an empty string
OSDir Windows Windowsrsquo installation directory for example
ldquoCWindowsrdquo
Linux an empty string
OSDrive Windows Windowsrsquo installation drive for example ldquoCrdquo
Linux an empty string
HomePath Windows The HOMEPATH environment variable
Linux The HOME environment variable
Home The Ericom folder in the userrsquos home directory
Windows CDocuments and SettingsltusergtApplication
DataEricom
Linux ltusergtEricom
In addition to the predefined macros listed above the PowerTerm WebConnect client
supports the usage of Java System Properties
Java System Properties available for users on Windows XP SP2
Java System Property Name Value Example
javaversion 150
javavendorurl httpwwwibmcom
javahome CIBMcommonpluginscomibmpvcwctruntim
esj2sewin32x86_150SR2-
20060511rcpeclipsepluginscomibmrcpj2sew
in32x86_150SR2-20060511jre
javavmspecificationversion 10
javavmversion 23
javavmvendor IBM Corporation
javavmname IBM J9 VM
PowerTerm WebConnect 33 Getting Started Guide
javaiotmpdir CDOCUME~1dianaLOCALS~1Temp
javacompiler j9jit23
javaextdirs CIBMcommonpluginscomibmpvcwctruntim
esj2sewin32x86_150SR2-
20060511rcpeclipsepluginscomibmrcpj2sew
in32x86_150SR2-20060511jrelibext
osname Windows XP
osarch x86
osversion 51 build 2600 Service Pack 2
pathseparator
username Jone
userhome CDocuments and SettingsJone
userdir CIBMRSA
usertimezone GMT+0200
System properties available for users on Linux RedHat 9
Java System Property Name Value Example
javaversion 150
javavendorurl httpwwwibmcom
javahome usrjavajre150_07
javavmversion 150
javavmvendor IBM Corporation
javavmname IBM J9 VM
javaclasspath
javalibrarypath
javaiotmpdir tmp
javacompiler
javaextdirs
osname Linux
osarch i386
osversion 2420-8
pathseparator
PowerTerm WebConnect 34 Getting Started Guide
username root
userhome root
userdir root
System properties names are placed in the configuration file within percent symbols ()
(like macros)
671 Configure the PowerTerm WebConnect Client
1 Open the Config Folder and edit the webconnectxml file Example
ltxml version =rdquo10rdquo encoding=rdquoUTF-8rdquogt
ltsection name=rdquoparametersrdquogt
ltitem key=rdquourlrdquo value=httpadminserverWebConnect56gt
ltitem key=rdquoserverrdquo value=rdquoadmin24000rdquogt
ltitem key=rdquossordquo value=rdquotruerdquogt
ltitem key=rdquodestrdquo value=rdquoCProgram FilesEricomrdquogt
ltsectiongt
2 Save the customized webconnectxml to a Web server folder available to all users It is
recommended to use the same Web server as the PowerTerm WebConnect Agent
Example
ltWebConnect installation foldergtwebwebconnectxml
3 Test the accessibility to this file - Type the URL of webconnectxml in the browser
Example
httpltWebServer IPgtWebConnectwebconnectxml
The contents of the file should be displayed
672 Configure the Preferences File
1 Open the plugins folder and open the PowerTermWebConnectClient_560365jar file
You can use Winzip version 70 and up or in Windows XP ndash Create a new file type for the
jar extension click advanced and select compressed (zipped) folder in the drop down list
Now you can open the JAR files in the Windows Explorer
The default contents of the file
configURL=httpleericomcomWebConnectwebconnectxml
2 Specify the accurate URL of the webconnectxml file Example
httpltWebServer IPgtWebConnectwebconnectxml
3 Save the file and close it The WinZip will display the following dialog
ldquoFile preferencesini has been changed since it was extracted Update archive
with this filerdquo
PowerTerm WebConnect 35 Getting Started Guide
4 Click Yes and close the archive
If you are editing the file from within the explorer you will have to save the file elsewhere
and then drag it to the explorer window where the JAR file is open
68 Installing PowerTerm WebConnect Client on Lotus Expeditor
1 Start the Lotus Expeditor client
2 Select File | Application | Install
3 Select Search for new features to install and click Next
4 Select Add Folder Location and type or select the location of the update site folder from
the provided package Click OK
5 Select the location you have just created and click Finish
6 In the Select the feature to install tree select Powerterm WebConnectUpdate Site Click
Next
7 Select I accept the terms in the license agreements and click Next
8 Click Finish
9 When prompted restart the platform
69 Running PowerTerm WebConnect Client for Lotus Expeditor
1 Click Open The PowerTerm WebConnect option is displayed
2 Select PowerTerm WebConnect The application will automatically connect and start
downloading the components from PowerTerm WebConnect Server
IMPORTANT
If you did not install PowerTerm WebConnect Server and are instead connecting to Ericom
Softwarersquos Demo WebConnect Server then you need to open port 443 in the firewall
691 PowerTerm WebConnect Client Workflow
1 PowerTerm WebConnect client reads the URL of webconnectxml from the preferencesini
file and requests it
2 When the webconnectxml is successfully downloaded the application reads the
configuration connects to the specified Web server downloads the PowerTerm
WebConnect components and connects to the PowerTerm WebConnect Server
3 The user is requested to login to the PowerTerm WebConnect Server For testing you
can use the username Example and password example
This step will be skipped if Single Sign-on is set to ldquotruerdquo
PowerTerm WebConnect 36 Getting Started Guide
4 After logging in to PowerTerm WebConnect Server the userrsquos applications are displayed
as defined by the administrator
5 To run an application select the desired application from the list and click Launch or
double-click the application The application will be launched in a separate window
610 Troubleshooting
When you encounter a problem the first step is to open the log file This file is located on
the client machine in the Ericom folder
Windows
CDocuments and SettingsltusernamegtEricomleclientEricomPluginlog
Linux
ltuser-home-directorygtEricomleclientEricomPluginlog
Following is a guide for diagnosing and fixing the problems in cases of error messages and
additional information
Error
Message
Solution
Version File
reading error
1 Check the lsquourlrsquo parameter in the webconnectxml file on the Web
server The value should be
httpltWebServerIPgtWebConnect
2 Try to run the following URL on the browser
Windows
httpltWebServerIPgtWebConnectwindowsptagentvertxt
Linux
httpltWebServerIPgtWebConnectlinuxix86qterm-
wcvertxt
The file contents displayed in the browser window should be in
the following form
560-rel14546
PowerTerm WebConnect Application Zone
560 - Main Release
ltrootgtPowerTerm WebConnect 56ltWebServergt
If the version file contents are not as shown check
- Is the Web Server running
- Are PowerTerm WebConnect Web Components and version files
PowerTerm WebConnect 37 Getting Started Guide
in place
3 On the Web server check ltPowerTerm WebConnect
rootgtwebwindowsptagentvertxt If the contents ldquolook wrongrdquo or
not in the proper form reinstall the PowerTerm WebConnect Web
components
4 On the client machine open the aforementioned URL in the
browser The file content should appear in the browser If it does
not it could be that the Web server is down
Web Server is
shut down
The webconnectxml configuration file must be located on the Web
server The explicit URL to this file is defined in the preferencesini
file (see Configure the Preferences File)
The error message contains the IP address of the Web server
Verify that the Web server on this machine is running
Version file
does not exist
on ltURLgt
See Version File reading error
The
configuration
file is not
accessible or
has a wrong
format
The webconnectxml configuration file must be located on the Web
server and the explicit URL to the configuration must be defined in
the preferencesini file (see Configure the Preferences File)
Try to open the URL specified in the error message in the
browser If it does not open then it either does not exist or it has
a wrong format
Preferences
file does not
exist in the
application
bundle
The preferencesini file containing the URL to the configuration
file was removed from the update site folder
Uninstall the current PowerTerm WebConnect client from the
client machine Create a new customized package (see
PowerTerm WebConnect Client Configuration) and reinstall it
Configuration
file URL is not
defined in
preference
file
The URL to the configuration file does not appear in the
preferencesini file (see Configure the Preferences File)
Uninstall the current PowerTerm WebConnect client from the
client machine Create a new customized package (see
PowerTerm WebConnect Client Configuration) and reinstall it
No IP address
could be
found for the
host
The Web server URL specified in the preferencesini file (see
Configure the Preferences File) or in the webconnectxml file (see
Configure the PowerTerm WebConnect Client) is an unknown
host
If the mistake is in the preferencesini file uninstall the current
PowerTerm WebConnect client from the client machine Create a
new customized package (see PowerTerm WebConnect Client
Configuration) and reinstall it
PowerTerm WebConnect 38 Getting Started Guide
If the mistake is in the webconnectxml file correct the file reopen
the Lotus Expeditor client
Cannot write
to destination
The temporary file cannot be written to the defined destination
Check the write permissions
Copied
configuration
file has wrong
format
The webconnectxml file as received from the specified URL has a
wrong format Correct the file and try again
PowerTerm
WebConnect
Agent URL is
malformed
The PowerTerm WebConnect Agent URL specified in the
webconnectxml file (see Configure the PowerTerm WebConnect
Client) does not have a proper HTTP format Correct the file and
try again
PowerTerm
WebConnect
Agent URL is
not defined
The PowerTerm WebConnect Agent URL parameter is not specified
in the webconnectxml file (see Configure the PowerTerm
WebConnect Client)
Correct the file and try again
The specified
destination
folder name
is wrong
The destination folder name contains illegal characters
ltgt|
Check the dst parameter in the webconnectxml file Correct the
file and try again
You do not
have
permissions
to write to
ltpathgt
The PowerTerm WebConnect Agent cannot be written to the
destination as defined Check the write permissions
The default destination defined in the version file should not to
be changed
A customized destination for PowerTerm WebConnect Agent
downloading can be defined in the webconnectxml file (See
Configure the PowerTerm WebConnect Client)
Check the destination value correct and try again
PowerTerm WebConnect 39 Getting Started Guide
About Ericom
Ericomreg Software is a leading provider of Application Access and Virtualization Solutions
Since 1993 Ericom has been helping users access enterprise mission-critical applications
running on a broad range of Microsoftreg Windowsreg Terminal Servers virtual Desktops
Blade PCs legacy hosts and other systems Ericom provides concrete business value by
helping organizations realize the benefits of their IT investments With offices in the United
States United Kingdom EMEA India and China Ericom also has an extensive network of
distributors and partners throughout North America Europe Asia and the Far East Our
expanding customer base is more than 30 thousand strong with over 7 million
installations
For more information on our products and services contact us at the location nearest to you
And visit our web site httpwwwericomcom
North America Western Europe International
Ericom Software Inc Ericom Software (UK) Ltd Ericom Software Ltd
231 Herbert Avenue Bldg 4 11a Victoria Square 8 Hamarpeh Street
Closter NJ 07624 USA Droitwich Worcestershire Har Hotzvim Technology Park
Tel +1 (201) 767 2210 WR9 8DE United Kingdom Jerusalem 91450 Israel
Fax +1 (201) 767 2205 Tel +44 (0) 845 644 3597 Tel +972 (2) 591 1700
Toll-free 1 (888) 769 7876 Fax +44 (0) 845 644 3598 Fax +972 (2) 571 4737
Email infoericomcom Email infoericomcouk Email infoericomcom
PowerTerm WebConnect 25 Getting Started Guide
WebConnectPortaljar ltAppServergtlib
EricomLoginjar ltPortalServergtsharedapp
Step 5 Portlet Configuration
1 On IBM Workplace Server go to ltAppServergtjavajrebinIbmPortalini
2 You can modify the following parameters in the [Server=WebConnect] section webserverport=ltIBM web server portgt
Specifies the Web server port for accessing the PowerTerm WebConnect clients folder
Default 80 Address
Specifies the address of the PowerTerm WebConnect Server machine for Portlet to
connect to when PowerTerm WebConnect Server is located on a different machine
than the IBM Workplace Server CustomAddress
Specifies the addresss of the PowerTerm WebConnect Server machine for Clients to connect to If CustomAddress is the same as Address then this may be omitted webserveraddr
Specifies the address of the Web Server machine when it is located on a different
machine than the IBM Workplace Server
3 Restart the IBM server ltPortalServergtrootscriptsstopWorkplaceServicesbat ltPortalServergtrootscriptsstartWorkplaceServicesbat
This procedure may take about 20 minutes
Step 6 Install the Portlet
1 In a Web browser open the URL httpltIBM Workplace
Servergt9081lwpmyworkplace to open the IBM Workplace Portal
2 Login as administrator
3 Go to Administration | Portlets | Install
4 Browse to the PowerTerm WebConnectwar file located on PowerTerm WebConnect
Server and click Next
5 Click Install
Step 7 Create an Application page
1 Login to the Workplace
2 Go to Portal User Interface | Manage Pages
3 Search for My Work
4 Click the My Work link and select New Page
5 Name the page PowerTerm WebConnect and click OK
6 Click OK again You will see the created page on the list
7 Click the pencil icon on the new page and select the 1 square layout
PowerTerm WebConnect 26 Getting Started Guide
8 Click Add Portlet and search for PowerTerm WebConnect
9 Select it and click OK
10 Click Done
11 Click My work at the top of the page PowerTerm WebConnect is displayed on the list
Step 8 Run the Portlet
1 Restart IBM Workplace Server
2 Open IBM Workplace Portal in a browser httpltportal servergtlwpmyworkplace
3 Login to IBM Workplace Server
4 Click My work PowerTerm WebConnect portlet is displayed
5 Launch it The Userrsquos applications as defined on PowerTerm WebConnect Server
appear
6 Click an application to launch it
64 Install PowerTerm WebConnect Portlet on IBM Workplace server (for Linux OS)
Step 1 Enable JSR 168 portlets
1 Go to optIBMWorkplacePortalServersharedappconfigservicesConfigServiceproperties
2 Modify the portalenablejsr168 property to ldquotruerdquo
3 Restart the server cd optIBMWorkplacePortalServerrootscripts
Run stopWorkplaceServicessh
Run startWorkplaceServicessh
This procedure can take up to 20 minutes
4 Log on to the workplace server at httpltworkplace servergt9081lwpmyworkplace using
the administrators username and password
Step 2 Install the portlet
1 Restart IBM Workplace Server
2 In a Web browser open the URL httpltworkplace server IPgtlwpmyworkplace
3 Login to IBM Workplace Server as an administrator
4 Go to Administration | Portlets | Install
5 Browse to the PowerTerm WebConnectwar file located on PowerTerm WebConnect
Server and click Next
6 Click Install
PowerTerm WebConnect 27 Getting Started Guide
Step 3 Install the Application page
1 Login to the workplace as administrator
2 Go to Administration | Portal User Interface | Manage Pages
3 Search for My Work
4 Click the My Work link and select New Page
5 Name the page PowerTerm WebConnect and click OK
6 Click OK again You will see the created page on the list
7 Click the pencil icon and select the 1-square layout
8 Click Add Portlet and search for PowerTerm WebConnect
9 Select it and click OK
10 Click Done
11 Click My work on top and PowerTerm WebConnect is displayed on the left bar
Step 4 Run the portlet
1 Restart IBM Workplace Server
2 Open IBM Workplace Portal in a browser httpltportal servergtlwpmyworkplace
3 Login to IBM Workplace Server
4 Click My work PowerTerm WebConnect portlet is displayed
5 Launch it The Userrsquos applications as defined on PowerTerm WebConnect Server
appear
6 Click an application to launch it
65 Install PowerTerm WebConnect Portlet on IBM WebSphere 61 server (for Windows OS)
Step 1 Install PowerTerm WebConnect Server
You have to configure PowerTerm WebConnect Server if it and the IBM WebSphere Server
are on separate machines
1 Launch PowerTerm WebConnect Administration Tool
2 Open Files | Configuration | Main
3 In the [Portal] section edit Machines=localhostltIBM sever machinegt
Step 2 Copy Files
The following files need to be copied from WebConnect ServerAddOnsIBM
WebSpherePortlet folder to IBM WebSphere Server
PowerTerm WebConnect 28 Getting Started Guide
File name to copy Destination folder
OpenSSLdll ltAppServergtjavajrebin
IbmPortaldll ltAppServergtjavajrebin
IbmPortalini ltAppServergtjavajrebin
WebConnectPortaljar ltAppServergtlib
Step 3 Portlet Configuration
1 On IBM Workplace Server go to ltAppServergtjavajrebinIbmPortalini
2 You can modify the following parameters in the [Server=WebConnect] section webserverport=ltIBM web server portgt
Specifies the Web server port for accessing the PowerTerm WebConnect clients folder
Default 80 Address
Specifies the address of the PowerTerm WebConnect Server machine for Portlet to
connect to when PowerTerm WebConnect Server is located on a different machine
than the IBM Workplace Server CustomAddress
Specifies the addresss of the PowerTerm WebConnect Server machine for Clients to connect to If CustomAddress is the same as Address then this may be omitted webserveraddr
Specifies the address of the Web Server machine when it is located on a different
machine than the IBM Workplace Server
3 Restart the IBM server ltAppServergtProfilesAppServer01binstopServerbat ltAppServergtProfilesAppServer01binstartServerbat
This procedure may take about 20 minutes
Step 4 Install the Portlet and create an Application page
1 In a Web browser open the URL httpltIBM WebSphere Servergt9060ibmconsole
to open the IBM WebSphere Portal
2 Login and go to Applications | Install New Application
3 Browse to the PowerTerm WebConnectwar file located on PowerTerm WebConnect
Server
4 Enter Context root and click Next The Select installation options dialog appears
5 Optional change options to your preference or keep the default
6 Click Next
7 Select Ericom in the Module column click Apply and then Next
8 Click Finish and then Save
9 Select Applications | Enterprise Applications
10 Select PowerTerm WebConnectwar checkbox and click Start
PowerTerm WebConnect 29 Getting Started Guide
11 Enter in the Web browser the URL httpltIBM WebSphere
Servergt9080ltContext rootgtEricom portlet The Login dialog appears
12 Login and you will see PowerTerm WebConnect displayed on the list
Step 5 Run the Portlet
1 Restart IBM WebSphere Server
2 Open IBM WebSphere Portal in a browser httpltportal servergt9080ltContext
rootgtEricom portlet
3 Login to IBM WebSphere Server
4 Launch it The Userrsquos applications as defined on PowerTerm WebConnect Server
appear
5 Click an application to launch it
66 PowerTerm WebConnect Server Configuration
bull To enable the Lotus Expeditor to run the PowerTerm WebConnect client the
System Administrator must provide the users with accounts on PowerTerm
WebConnect Server (see the PowerTerm WebConnect Administratorrsquos Manual for
instructions on how to create users groups and connections on the PowerTerm
WebConnect Server)
bull To enable PowerTerm WebConnectrsquos Single Sign-On feature the System
Administrator must create a PowerTerm WebConnect user with the same
username and password as used for the Lotus Expeditor For a managed Lotus
Expeditor the credentials used are the username and password sent to the
managing server For an unmanaged Lotus Expeditor the operation system
username and the Lotus Expeditor password are used as credentials
NOTE If a password is not defined then the Single Sign-On will fail and the user will be
prompted with a login dialog
67 PowerTerm WebConnect Client Configuration
The PowerTerm WebConnect client is configured in webconnectxml located in the config
folder webconnectxml parameters are
url The PowerTerm WebConnect Agent url
server The PowerTerm WebConnect Server address
sso The Single Sign-On feature
dst The local destination for downloading PowerTerm WebConnect
components
PowerTerm WebConnect 30 Getting Started Guide
url
PowerTerm WebConnect components are installed on a Web server Their default url is
Windows Agent
httpltWebServer IPgtWebConnectwindowsptagentcab
Linux Agent
httpltWebServer IPgtWebConnectlinuxix86qterm-wczip
The url parameter must include the first part of the url (which is identical for both Windows
and Linux agents)
The PowerTerm WebConnect client will automatically append the appropriate suffix in
order to create a full accurate url
Example
ltitem key=rdquourlrdquo value=httpadminserverWebConnectgt
server
The computer name or IP address of the PowerTerm WebConnect Server machine
The PowerTerm WebConnect client will log in to this PowerTerm WebConnect Server
display the applications defined on it and run them according to this serverrsquos configuration
Format ltserver IPgt[ltportgt]
where default port is 4000 (can be edited)
Example
ltitem key=rdquoserverrdquo value=rdquoadmin24000rdquogt
sso
Determines whether Single Sign-on will be used to log in to PowerTerm WebConnect
Server Values
bull True (default) the client should automatically log in to the PowerTerm WebConnect
Server using the same credentials as the ones used to log in to the Lotus Expeditor
client
The System Administrator must verify that these credentials can log in to the
PowerTerm WebConnect Server
bull False the user will be prompted with a login dialog or will log in automatically using
previously saved credentials
Example
ltitem key=rdquossordquo value=rdquotruerdquogt
Autologin mode
PowerTerm WebConnect 31 Getting Started Guide
If sso is set to True the user is not prompted for credentials and the login process to
PowerTerm WebConnect Server is done automatically sending the credentials used for the
Lotus Expeditor unless the Lotus Expeditor does not have a password defined (In the
Lotus Expeditor preferences page | Password| Prompt me for a password at start up checkbox)
However if Single Sign-on is not used there are several options regarding Autologin that
can be defined in the PowerTerm WebConnect Preferences page Options
bull Yes
bull No
bull Interactive
bull First time interactive (default) ndash Simplifies the login process to PowerTerm
WebConnect Server In this mode the first time the user logs in to PowerTerm
WebConnect Server he will be prompted for his credentials with the Login dialog
These credentials will be stored in the machine and from then on the login process to
PowerTerm WebConnect Server will be done automatically
1 Open File | Preferences from the Lotus Expeditor and select PowerTerm WebConnect
2 In the Autologin to WebConnect Server section select First Interactive and click OK
3 Start PowerTerm WebConnect Client for Lotus Expeditor If credentials were entered
at least once then the next time the client will connect to PowerTerm WebConnect
Server without prompting for the user name and password
The Administrator must configure the Agent to do nothing when it exits for the
feature to work this way See PowerTerm WebConnect Administratorrsquos Manual for more information about defining Autologin
bull Allow multiple selection ndash Defines whether the user can launch more than one
application at a time (by using the ltCtrlgt or ltShiftgt button while selecting applications)
dst
Defines the path to download PowerTerm WebConnect components on the client machine
The dst parameter can contain macros which are translated by the PowerTerm WebConnect
Client for Lotus Expeditor during runtime The macros should be placed between percent
symbols () for example WebServer
When such a value is defined the PowerTerm WebConnect Client for Lotus Expeditor
substitutes the entire expression for the macrorsquos value
The PowerTerm WebConnect Client for Lotus Expeditor does not support the use
of environment variables as macros
Macros are not case sensitive
Macros supported by PowerTerm WebConnect Client for Lotus Expeditor
Macro name Description
WebServer The name of the Web server
It is obtained from the PowerTerm WebConnect Agent url
PowerTerm WebConnect 32 Getting Started Guide
parameter
Name The name of the clientrsquos CAB or ZIP file eg ldquoptagentrdquo
Display The clientrsquos display name from the version file
Version The clientrsquos version value It is obtained from the version
file
Root The default root location
Windows ldquoCrdquo
LinuxUnix an empty string
OSDir Windows Windowsrsquo installation directory for example
ldquoCWindowsrdquo
Linux an empty string
OSDrive Windows Windowsrsquo installation drive for example ldquoCrdquo
Linux an empty string
HomePath Windows The HOMEPATH environment variable
Linux The HOME environment variable
Home The Ericom folder in the userrsquos home directory
Windows CDocuments and SettingsltusergtApplication
DataEricom
Linux ltusergtEricom
In addition to the predefined macros listed above the PowerTerm WebConnect client
supports the usage of Java System Properties
Java System Properties available for users on Windows XP SP2
Java System Property Name Value Example
javaversion 150
javavendorurl httpwwwibmcom
javahome CIBMcommonpluginscomibmpvcwctruntim
esj2sewin32x86_150SR2-
20060511rcpeclipsepluginscomibmrcpj2sew
in32x86_150SR2-20060511jre
javavmspecificationversion 10
javavmversion 23
javavmvendor IBM Corporation
javavmname IBM J9 VM
PowerTerm WebConnect 33 Getting Started Guide
javaiotmpdir CDOCUME~1dianaLOCALS~1Temp
javacompiler j9jit23
javaextdirs CIBMcommonpluginscomibmpvcwctruntim
esj2sewin32x86_150SR2-
20060511rcpeclipsepluginscomibmrcpj2sew
in32x86_150SR2-20060511jrelibext
osname Windows XP
osarch x86
osversion 51 build 2600 Service Pack 2
pathseparator
username Jone
userhome CDocuments and SettingsJone
userdir CIBMRSA
usertimezone GMT+0200
System properties available for users on Linux RedHat 9
Java System Property Name Value Example
javaversion 150
javavendorurl httpwwwibmcom
javahome usrjavajre150_07
javavmversion 150
javavmvendor IBM Corporation
javavmname IBM J9 VM
javaclasspath
javalibrarypath
javaiotmpdir tmp
javacompiler
javaextdirs
osname Linux
osarch i386
osversion 2420-8
pathseparator
PowerTerm WebConnect 34 Getting Started Guide
username root
userhome root
userdir root
System properties names are placed in the configuration file within percent symbols ()
(like macros)
671 Configure the PowerTerm WebConnect Client
1 Open the Config Folder and edit the webconnectxml file Example
ltxml version =rdquo10rdquo encoding=rdquoUTF-8rdquogt
ltsection name=rdquoparametersrdquogt
ltitem key=rdquourlrdquo value=httpadminserverWebConnect56gt
ltitem key=rdquoserverrdquo value=rdquoadmin24000rdquogt
ltitem key=rdquossordquo value=rdquotruerdquogt
ltitem key=rdquodestrdquo value=rdquoCProgram FilesEricomrdquogt
ltsectiongt
2 Save the customized webconnectxml to a Web server folder available to all users It is
recommended to use the same Web server as the PowerTerm WebConnect Agent
Example
ltWebConnect installation foldergtwebwebconnectxml
3 Test the accessibility to this file - Type the URL of webconnectxml in the browser
Example
httpltWebServer IPgtWebConnectwebconnectxml
The contents of the file should be displayed
672 Configure the Preferences File
1 Open the plugins folder and open the PowerTermWebConnectClient_560365jar file
You can use Winzip version 70 and up or in Windows XP ndash Create a new file type for the
jar extension click advanced and select compressed (zipped) folder in the drop down list
Now you can open the JAR files in the Windows Explorer
The default contents of the file
configURL=httpleericomcomWebConnectwebconnectxml
2 Specify the accurate URL of the webconnectxml file Example
httpltWebServer IPgtWebConnectwebconnectxml
3 Save the file and close it The WinZip will display the following dialog
ldquoFile preferencesini has been changed since it was extracted Update archive
with this filerdquo
PowerTerm WebConnect 35 Getting Started Guide
4 Click Yes and close the archive
If you are editing the file from within the explorer you will have to save the file elsewhere
and then drag it to the explorer window where the JAR file is open
68 Installing PowerTerm WebConnect Client on Lotus Expeditor
1 Start the Lotus Expeditor client
2 Select File | Application | Install
3 Select Search for new features to install and click Next
4 Select Add Folder Location and type or select the location of the update site folder from
the provided package Click OK
5 Select the location you have just created and click Finish
6 In the Select the feature to install tree select Powerterm WebConnectUpdate Site Click
Next
7 Select I accept the terms in the license agreements and click Next
8 Click Finish
9 When prompted restart the platform
69 Running PowerTerm WebConnect Client for Lotus Expeditor
1 Click Open The PowerTerm WebConnect option is displayed
2 Select PowerTerm WebConnect The application will automatically connect and start
downloading the components from PowerTerm WebConnect Server
IMPORTANT
If you did not install PowerTerm WebConnect Server and are instead connecting to Ericom
Softwarersquos Demo WebConnect Server then you need to open port 443 in the firewall
691 PowerTerm WebConnect Client Workflow
1 PowerTerm WebConnect client reads the URL of webconnectxml from the preferencesini
file and requests it
2 When the webconnectxml is successfully downloaded the application reads the
configuration connects to the specified Web server downloads the PowerTerm
WebConnect components and connects to the PowerTerm WebConnect Server
3 The user is requested to login to the PowerTerm WebConnect Server For testing you
can use the username Example and password example
This step will be skipped if Single Sign-on is set to ldquotruerdquo
PowerTerm WebConnect 36 Getting Started Guide
4 After logging in to PowerTerm WebConnect Server the userrsquos applications are displayed
as defined by the administrator
5 To run an application select the desired application from the list and click Launch or
double-click the application The application will be launched in a separate window
610 Troubleshooting
When you encounter a problem the first step is to open the log file This file is located on
the client machine in the Ericom folder
Windows
CDocuments and SettingsltusernamegtEricomleclientEricomPluginlog
Linux
ltuser-home-directorygtEricomleclientEricomPluginlog
Following is a guide for diagnosing and fixing the problems in cases of error messages and
additional information
Error
Message
Solution
Version File
reading error
1 Check the lsquourlrsquo parameter in the webconnectxml file on the Web
server The value should be
httpltWebServerIPgtWebConnect
2 Try to run the following URL on the browser
Windows
httpltWebServerIPgtWebConnectwindowsptagentvertxt
Linux
httpltWebServerIPgtWebConnectlinuxix86qterm-
wcvertxt
The file contents displayed in the browser window should be in
the following form
560-rel14546
PowerTerm WebConnect Application Zone
560 - Main Release
ltrootgtPowerTerm WebConnect 56ltWebServergt
If the version file contents are not as shown check
- Is the Web Server running
- Are PowerTerm WebConnect Web Components and version files
PowerTerm WebConnect 37 Getting Started Guide
in place
3 On the Web server check ltPowerTerm WebConnect
rootgtwebwindowsptagentvertxt If the contents ldquolook wrongrdquo or
not in the proper form reinstall the PowerTerm WebConnect Web
components
4 On the client machine open the aforementioned URL in the
browser The file content should appear in the browser If it does
not it could be that the Web server is down
Web Server is
shut down
The webconnectxml configuration file must be located on the Web
server The explicit URL to this file is defined in the preferencesini
file (see Configure the Preferences File)
The error message contains the IP address of the Web server
Verify that the Web server on this machine is running
Version file
does not exist
on ltURLgt
See Version File reading error
The
configuration
file is not
accessible or
has a wrong
format
The webconnectxml configuration file must be located on the Web
server and the explicit URL to the configuration must be defined in
the preferencesini file (see Configure the Preferences File)
Try to open the URL specified in the error message in the
browser If it does not open then it either does not exist or it has
a wrong format
Preferences
file does not
exist in the
application
bundle
The preferencesini file containing the URL to the configuration
file was removed from the update site folder
Uninstall the current PowerTerm WebConnect client from the
client machine Create a new customized package (see
PowerTerm WebConnect Client Configuration) and reinstall it
Configuration
file URL is not
defined in
preference
file
The URL to the configuration file does not appear in the
preferencesini file (see Configure the Preferences File)
Uninstall the current PowerTerm WebConnect client from the
client machine Create a new customized package (see
PowerTerm WebConnect Client Configuration) and reinstall it
No IP address
could be
found for the
host
The Web server URL specified in the preferencesini file (see
Configure the Preferences File) or in the webconnectxml file (see
Configure the PowerTerm WebConnect Client) is an unknown
host
If the mistake is in the preferencesini file uninstall the current
PowerTerm WebConnect client from the client machine Create a
new customized package (see PowerTerm WebConnect Client
Configuration) and reinstall it
PowerTerm WebConnect 38 Getting Started Guide
If the mistake is in the webconnectxml file correct the file reopen
the Lotus Expeditor client
Cannot write
to destination
The temporary file cannot be written to the defined destination
Check the write permissions
Copied
configuration
file has wrong
format
The webconnectxml file as received from the specified URL has a
wrong format Correct the file and try again
PowerTerm
WebConnect
Agent URL is
malformed
The PowerTerm WebConnect Agent URL specified in the
webconnectxml file (see Configure the PowerTerm WebConnect
Client) does not have a proper HTTP format Correct the file and
try again
PowerTerm
WebConnect
Agent URL is
not defined
The PowerTerm WebConnect Agent URL parameter is not specified
in the webconnectxml file (see Configure the PowerTerm
WebConnect Client)
Correct the file and try again
The specified
destination
folder name
is wrong
The destination folder name contains illegal characters
ltgt|
Check the dst parameter in the webconnectxml file Correct the
file and try again
You do not
have
permissions
to write to
ltpathgt
The PowerTerm WebConnect Agent cannot be written to the
destination as defined Check the write permissions
The default destination defined in the version file should not to
be changed
A customized destination for PowerTerm WebConnect Agent
downloading can be defined in the webconnectxml file (See
Configure the PowerTerm WebConnect Client)
Check the destination value correct and try again
PowerTerm WebConnect 39 Getting Started Guide
About Ericom
Ericomreg Software is a leading provider of Application Access and Virtualization Solutions
Since 1993 Ericom has been helping users access enterprise mission-critical applications
running on a broad range of Microsoftreg Windowsreg Terminal Servers virtual Desktops
Blade PCs legacy hosts and other systems Ericom provides concrete business value by
helping organizations realize the benefits of their IT investments With offices in the United
States United Kingdom EMEA India and China Ericom also has an extensive network of
distributors and partners throughout North America Europe Asia and the Far East Our
expanding customer base is more than 30 thousand strong with over 7 million
installations
For more information on our products and services contact us at the location nearest to you
And visit our web site httpwwwericomcom
North America Western Europe International
Ericom Software Inc Ericom Software (UK) Ltd Ericom Software Ltd
231 Herbert Avenue Bldg 4 11a Victoria Square 8 Hamarpeh Street
Closter NJ 07624 USA Droitwich Worcestershire Har Hotzvim Technology Park
Tel +1 (201) 767 2210 WR9 8DE United Kingdom Jerusalem 91450 Israel
Fax +1 (201) 767 2205 Tel +44 (0) 845 644 3597 Tel +972 (2) 591 1700
Toll-free 1 (888) 769 7876 Fax +44 (0) 845 644 3598 Fax +972 (2) 571 4737
Email infoericomcom Email infoericomcouk Email infoericomcom
PowerTerm WebConnect 26 Getting Started Guide
8 Click Add Portlet and search for PowerTerm WebConnect
9 Select it and click OK
10 Click Done
11 Click My work at the top of the page PowerTerm WebConnect is displayed on the list
Step 8 Run the Portlet
1 Restart IBM Workplace Server
2 Open IBM Workplace Portal in a browser httpltportal servergtlwpmyworkplace
3 Login to IBM Workplace Server
4 Click My work PowerTerm WebConnect portlet is displayed
5 Launch it The Userrsquos applications as defined on PowerTerm WebConnect Server
appear
6 Click an application to launch it
64 Install PowerTerm WebConnect Portlet on IBM Workplace server (for Linux OS)
Step 1 Enable JSR 168 portlets
1 Go to optIBMWorkplacePortalServersharedappconfigservicesConfigServiceproperties
2 Modify the portalenablejsr168 property to ldquotruerdquo
3 Restart the server cd optIBMWorkplacePortalServerrootscripts
Run stopWorkplaceServicessh
Run startWorkplaceServicessh
This procedure can take up to 20 minutes
4 Log on to the workplace server at httpltworkplace servergt9081lwpmyworkplace using
the administrators username and password
Step 2 Install the portlet
1 Restart IBM Workplace Server
2 In a Web browser open the URL httpltworkplace server IPgtlwpmyworkplace
3 Login to IBM Workplace Server as an administrator
4 Go to Administration | Portlets | Install
5 Browse to the PowerTerm WebConnectwar file located on PowerTerm WebConnect
Server and click Next
6 Click Install
PowerTerm WebConnect 27 Getting Started Guide
Step 3 Install the Application page
1 Login to the workplace as administrator
2 Go to Administration | Portal User Interface | Manage Pages
3 Search for My Work
4 Click the My Work link and select New Page
5 Name the page PowerTerm WebConnect and click OK
6 Click OK again You will see the created page on the list
7 Click the pencil icon and select the 1-square layout
8 Click Add Portlet and search for PowerTerm WebConnect
9 Select it and click OK
10 Click Done
11 Click My work on top and PowerTerm WebConnect is displayed on the left bar
Step 4 Run the portlet
1 Restart IBM Workplace Server
2 Open IBM Workplace Portal in a browser httpltportal servergtlwpmyworkplace
3 Login to IBM Workplace Server
4 Click My work PowerTerm WebConnect portlet is displayed
5 Launch it The Userrsquos applications as defined on PowerTerm WebConnect Server
appear
6 Click an application to launch it
65 Install PowerTerm WebConnect Portlet on IBM WebSphere 61 server (for Windows OS)
Step 1 Install PowerTerm WebConnect Server
You have to configure PowerTerm WebConnect Server if it and the IBM WebSphere Server
are on separate machines
1 Launch PowerTerm WebConnect Administration Tool
2 Open Files | Configuration | Main
3 In the [Portal] section edit Machines=localhostltIBM sever machinegt
Step 2 Copy Files
The following files need to be copied from WebConnect ServerAddOnsIBM
WebSpherePortlet folder to IBM WebSphere Server
PowerTerm WebConnect 28 Getting Started Guide
File name to copy Destination folder
OpenSSLdll ltAppServergtjavajrebin
IbmPortaldll ltAppServergtjavajrebin
IbmPortalini ltAppServergtjavajrebin
WebConnectPortaljar ltAppServergtlib
Step 3 Portlet Configuration
1 On IBM Workplace Server go to ltAppServergtjavajrebinIbmPortalini
2 You can modify the following parameters in the [Server=WebConnect] section webserverport=ltIBM web server portgt
Specifies the Web server port for accessing the PowerTerm WebConnect clients folder
Default 80 Address
Specifies the address of the PowerTerm WebConnect Server machine for Portlet to
connect to when PowerTerm WebConnect Server is located on a different machine
than the IBM Workplace Server CustomAddress
Specifies the addresss of the PowerTerm WebConnect Server machine for Clients to connect to If CustomAddress is the same as Address then this may be omitted webserveraddr
Specifies the address of the Web Server machine when it is located on a different
machine than the IBM Workplace Server
3 Restart the IBM server ltAppServergtProfilesAppServer01binstopServerbat ltAppServergtProfilesAppServer01binstartServerbat
This procedure may take about 20 minutes
Step 4 Install the Portlet and create an Application page
1 In a Web browser open the URL httpltIBM WebSphere Servergt9060ibmconsole
to open the IBM WebSphere Portal
2 Login and go to Applications | Install New Application
3 Browse to the PowerTerm WebConnectwar file located on PowerTerm WebConnect
Server
4 Enter Context root and click Next The Select installation options dialog appears
5 Optional change options to your preference or keep the default
6 Click Next
7 Select Ericom in the Module column click Apply and then Next
8 Click Finish and then Save
9 Select Applications | Enterprise Applications
10 Select PowerTerm WebConnectwar checkbox and click Start
PowerTerm WebConnect 29 Getting Started Guide
11 Enter in the Web browser the URL httpltIBM WebSphere
Servergt9080ltContext rootgtEricom portlet The Login dialog appears
12 Login and you will see PowerTerm WebConnect displayed on the list
Step 5 Run the Portlet
1 Restart IBM WebSphere Server
2 Open IBM WebSphere Portal in a browser httpltportal servergt9080ltContext
rootgtEricom portlet
3 Login to IBM WebSphere Server
4 Launch it The Userrsquos applications as defined on PowerTerm WebConnect Server
appear
5 Click an application to launch it
66 PowerTerm WebConnect Server Configuration
bull To enable the Lotus Expeditor to run the PowerTerm WebConnect client the
System Administrator must provide the users with accounts on PowerTerm
WebConnect Server (see the PowerTerm WebConnect Administratorrsquos Manual for
instructions on how to create users groups and connections on the PowerTerm
WebConnect Server)
bull To enable PowerTerm WebConnectrsquos Single Sign-On feature the System
Administrator must create a PowerTerm WebConnect user with the same
username and password as used for the Lotus Expeditor For a managed Lotus
Expeditor the credentials used are the username and password sent to the
managing server For an unmanaged Lotus Expeditor the operation system
username and the Lotus Expeditor password are used as credentials
NOTE If a password is not defined then the Single Sign-On will fail and the user will be
prompted with a login dialog
67 PowerTerm WebConnect Client Configuration
The PowerTerm WebConnect client is configured in webconnectxml located in the config
folder webconnectxml parameters are
url The PowerTerm WebConnect Agent url
server The PowerTerm WebConnect Server address
sso The Single Sign-On feature
dst The local destination for downloading PowerTerm WebConnect
components
PowerTerm WebConnect 30 Getting Started Guide
url
PowerTerm WebConnect components are installed on a Web server Their default url is
Windows Agent
httpltWebServer IPgtWebConnectwindowsptagentcab
Linux Agent
httpltWebServer IPgtWebConnectlinuxix86qterm-wczip
The url parameter must include the first part of the url (which is identical for both Windows
and Linux agents)
The PowerTerm WebConnect client will automatically append the appropriate suffix in
order to create a full accurate url
Example
ltitem key=rdquourlrdquo value=httpadminserverWebConnectgt
server
The computer name or IP address of the PowerTerm WebConnect Server machine
The PowerTerm WebConnect client will log in to this PowerTerm WebConnect Server
display the applications defined on it and run them according to this serverrsquos configuration
Format ltserver IPgt[ltportgt]
where default port is 4000 (can be edited)
Example
ltitem key=rdquoserverrdquo value=rdquoadmin24000rdquogt
sso
Determines whether Single Sign-on will be used to log in to PowerTerm WebConnect
Server Values
bull True (default) the client should automatically log in to the PowerTerm WebConnect
Server using the same credentials as the ones used to log in to the Lotus Expeditor
client
The System Administrator must verify that these credentials can log in to the
PowerTerm WebConnect Server
bull False the user will be prompted with a login dialog or will log in automatically using
previously saved credentials
Example
ltitem key=rdquossordquo value=rdquotruerdquogt
Autologin mode
PowerTerm WebConnect 31 Getting Started Guide
If sso is set to True the user is not prompted for credentials and the login process to
PowerTerm WebConnect Server is done automatically sending the credentials used for the
Lotus Expeditor unless the Lotus Expeditor does not have a password defined (In the
Lotus Expeditor preferences page | Password| Prompt me for a password at start up checkbox)
However if Single Sign-on is not used there are several options regarding Autologin that
can be defined in the PowerTerm WebConnect Preferences page Options
bull Yes
bull No
bull Interactive
bull First time interactive (default) ndash Simplifies the login process to PowerTerm
WebConnect Server In this mode the first time the user logs in to PowerTerm
WebConnect Server he will be prompted for his credentials with the Login dialog
These credentials will be stored in the machine and from then on the login process to
PowerTerm WebConnect Server will be done automatically
1 Open File | Preferences from the Lotus Expeditor and select PowerTerm WebConnect
2 In the Autologin to WebConnect Server section select First Interactive and click OK
3 Start PowerTerm WebConnect Client for Lotus Expeditor If credentials were entered
at least once then the next time the client will connect to PowerTerm WebConnect
Server without prompting for the user name and password
The Administrator must configure the Agent to do nothing when it exits for the
feature to work this way See PowerTerm WebConnect Administratorrsquos Manual for more information about defining Autologin
bull Allow multiple selection ndash Defines whether the user can launch more than one
application at a time (by using the ltCtrlgt or ltShiftgt button while selecting applications)
dst
Defines the path to download PowerTerm WebConnect components on the client machine
The dst parameter can contain macros which are translated by the PowerTerm WebConnect
Client for Lotus Expeditor during runtime The macros should be placed between percent
symbols () for example WebServer
When such a value is defined the PowerTerm WebConnect Client for Lotus Expeditor
substitutes the entire expression for the macrorsquos value
The PowerTerm WebConnect Client for Lotus Expeditor does not support the use
of environment variables as macros
Macros are not case sensitive
Macros supported by PowerTerm WebConnect Client for Lotus Expeditor
Macro name Description
WebServer The name of the Web server
It is obtained from the PowerTerm WebConnect Agent url
PowerTerm WebConnect 32 Getting Started Guide
parameter
Name The name of the clientrsquos CAB or ZIP file eg ldquoptagentrdquo
Display The clientrsquos display name from the version file
Version The clientrsquos version value It is obtained from the version
file
Root The default root location
Windows ldquoCrdquo
LinuxUnix an empty string
OSDir Windows Windowsrsquo installation directory for example
ldquoCWindowsrdquo
Linux an empty string
OSDrive Windows Windowsrsquo installation drive for example ldquoCrdquo
Linux an empty string
HomePath Windows The HOMEPATH environment variable
Linux The HOME environment variable
Home The Ericom folder in the userrsquos home directory
Windows CDocuments and SettingsltusergtApplication
DataEricom
Linux ltusergtEricom
In addition to the predefined macros listed above the PowerTerm WebConnect client
supports the usage of Java System Properties
Java System Properties available for users on Windows XP SP2
Java System Property Name Value Example
javaversion 150
javavendorurl httpwwwibmcom
javahome CIBMcommonpluginscomibmpvcwctruntim
esj2sewin32x86_150SR2-
20060511rcpeclipsepluginscomibmrcpj2sew
in32x86_150SR2-20060511jre
javavmspecificationversion 10
javavmversion 23
javavmvendor IBM Corporation
javavmname IBM J9 VM
PowerTerm WebConnect 33 Getting Started Guide
javaiotmpdir CDOCUME~1dianaLOCALS~1Temp
javacompiler j9jit23
javaextdirs CIBMcommonpluginscomibmpvcwctruntim
esj2sewin32x86_150SR2-
20060511rcpeclipsepluginscomibmrcpj2sew
in32x86_150SR2-20060511jrelibext
osname Windows XP
osarch x86
osversion 51 build 2600 Service Pack 2
pathseparator
username Jone
userhome CDocuments and SettingsJone
userdir CIBMRSA
usertimezone GMT+0200
System properties available for users on Linux RedHat 9
Java System Property Name Value Example
javaversion 150
javavendorurl httpwwwibmcom
javahome usrjavajre150_07
javavmversion 150
javavmvendor IBM Corporation
javavmname IBM J9 VM
javaclasspath
javalibrarypath
javaiotmpdir tmp
javacompiler
javaextdirs
osname Linux
osarch i386
osversion 2420-8
pathseparator
PowerTerm WebConnect 34 Getting Started Guide
username root
userhome root
userdir root
System properties names are placed in the configuration file within percent symbols ()
(like macros)
671 Configure the PowerTerm WebConnect Client
1 Open the Config Folder and edit the webconnectxml file Example
ltxml version =rdquo10rdquo encoding=rdquoUTF-8rdquogt
ltsection name=rdquoparametersrdquogt
ltitem key=rdquourlrdquo value=httpadminserverWebConnect56gt
ltitem key=rdquoserverrdquo value=rdquoadmin24000rdquogt
ltitem key=rdquossordquo value=rdquotruerdquogt
ltitem key=rdquodestrdquo value=rdquoCProgram FilesEricomrdquogt
ltsectiongt
2 Save the customized webconnectxml to a Web server folder available to all users It is
recommended to use the same Web server as the PowerTerm WebConnect Agent
Example
ltWebConnect installation foldergtwebwebconnectxml
3 Test the accessibility to this file - Type the URL of webconnectxml in the browser
Example
httpltWebServer IPgtWebConnectwebconnectxml
The contents of the file should be displayed
672 Configure the Preferences File
1 Open the plugins folder and open the PowerTermWebConnectClient_560365jar file
You can use Winzip version 70 and up or in Windows XP ndash Create a new file type for the
jar extension click advanced and select compressed (zipped) folder in the drop down list
Now you can open the JAR files in the Windows Explorer
The default contents of the file
configURL=httpleericomcomWebConnectwebconnectxml
2 Specify the accurate URL of the webconnectxml file Example
httpltWebServer IPgtWebConnectwebconnectxml
3 Save the file and close it The WinZip will display the following dialog
ldquoFile preferencesini has been changed since it was extracted Update archive
with this filerdquo
PowerTerm WebConnect 35 Getting Started Guide
4 Click Yes and close the archive
If you are editing the file from within the explorer you will have to save the file elsewhere
and then drag it to the explorer window where the JAR file is open
68 Installing PowerTerm WebConnect Client on Lotus Expeditor
1 Start the Lotus Expeditor client
2 Select File | Application | Install
3 Select Search for new features to install and click Next
4 Select Add Folder Location and type or select the location of the update site folder from
the provided package Click OK
5 Select the location you have just created and click Finish
6 In the Select the feature to install tree select Powerterm WebConnectUpdate Site Click
Next
7 Select I accept the terms in the license agreements and click Next
8 Click Finish
9 When prompted restart the platform
69 Running PowerTerm WebConnect Client for Lotus Expeditor
1 Click Open The PowerTerm WebConnect option is displayed
2 Select PowerTerm WebConnect The application will automatically connect and start
downloading the components from PowerTerm WebConnect Server
IMPORTANT
If you did not install PowerTerm WebConnect Server and are instead connecting to Ericom
Softwarersquos Demo WebConnect Server then you need to open port 443 in the firewall
691 PowerTerm WebConnect Client Workflow
1 PowerTerm WebConnect client reads the URL of webconnectxml from the preferencesini
file and requests it
2 When the webconnectxml is successfully downloaded the application reads the
configuration connects to the specified Web server downloads the PowerTerm
WebConnect components and connects to the PowerTerm WebConnect Server
3 The user is requested to login to the PowerTerm WebConnect Server For testing you
can use the username Example and password example
This step will be skipped if Single Sign-on is set to ldquotruerdquo
PowerTerm WebConnect 36 Getting Started Guide
4 After logging in to PowerTerm WebConnect Server the userrsquos applications are displayed
as defined by the administrator
5 To run an application select the desired application from the list and click Launch or
double-click the application The application will be launched in a separate window
610 Troubleshooting
When you encounter a problem the first step is to open the log file This file is located on
the client machine in the Ericom folder
Windows
CDocuments and SettingsltusernamegtEricomleclientEricomPluginlog
Linux
ltuser-home-directorygtEricomleclientEricomPluginlog
Following is a guide for diagnosing and fixing the problems in cases of error messages and
additional information
Error
Message
Solution
Version File
reading error
1 Check the lsquourlrsquo parameter in the webconnectxml file on the Web
server The value should be
httpltWebServerIPgtWebConnect
2 Try to run the following URL on the browser
Windows
httpltWebServerIPgtWebConnectwindowsptagentvertxt
Linux
httpltWebServerIPgtWebConnectlinuxix86qterm-
wcvertxt
The file contents displayed in the browser window should be in
the following form
560-rel14546
PowerTerm WebConnect Application Zone
560 - Main Release
ltrootgtPowerTerm WebConnect 56ltWebServergt
If the version file contents are not as shown check
- Is the Web Server running
- Are PowerTerm WebConnect Web Components and version files
PowerTerm WebConnect 37 Getting Started Guide
in place
3 On the Web server check ltPowerTerm WebConnect
rootgtwebwindowsptagentvertxt If the contents ldquolook wrongrdquo or
not in the proper form reinstall the PowerTerm WebConnect Web
components
4 On the client machine open the aforementioned URL in the
browser The file content should appear in the browser If it does
not it could be that the Web server is down
Web Server is
shut down
The webconnectxml configuration file must be located on the Web
server The explicit URL to this file is defined in the preferencesini
file (see Configure the Preferences File)
The error message contains the IP address of the Web server
Verify that the Web server on this machine is running
Version file
does not exist
on ltURLgt
See Version File reading error
The
configuration
file is not
accessible or
has a wrong
format
The webconnectxml configuration file must be located on the Web
server and the explicit URL to the configuration must be defined in
the preferencesini file (see Configure the Preferences File)
Try to open the URL specified in the error message in the
browser If it does not open then it either does not exist or it has
a wrong format
Preferences
file does not
exist in the
application
bundle
The preferencesini file containing the URL to the configuration
file was removed from the update site folder
Uninstall the current PowerTerm WebConnect client from the
client machine Create a new customized package (see
PowerTerm WebConnect Client Configuration) and reinstall it
Configuration
file URL is not
defined in
preference
file
The URL to the configuration file does not appear in the
preferencesini file (see Configure the Preferences File)
Uninstall the current PowerTerm WebConnect client from the
client machine Create a new customized package (see
PowerTerm WebConnect Client Configuration) and reinstall it
No IP address
could be
found for the
host
The Web server URL specified in the preferencesini file (see
Configure the Preferences File) or in the webconnectxml file (see
Configure the PowerTerm WebConnect Client) is an unknown
host
If the mistake is in the preferencesini file uninstall the current
PowerTerm WebConnect client from the client machine Create a
new customized package (see PowerTerm WebConnect Client
Configuration) and reinstall it
PowerTerm WebConnect 38 Getting Started Guide
If the mistake is in the webconnectxml file correct the file reopen
the Lotus Expeditor client
Cannot write
to destination
The temporary file cannot be written to the defined destination
Check the write permissions
Copied
configuration
file has wrong
format
The webconnectxml file as received from the specified URL has a
wrong format Correct the file and try again
PowerTerm
WebConnect
Agent URL is
malformed
The PowerTerm WebConnect Agent URL specified in the
webconnectxml file (see Configure the PowerTerm WebConnect
Client) does not have a proper HTTP format Correct the file and
try again
PowerTerm
WebConnect
Agent URL is
not defined
The PowerTerm WebConnect Agent URL parameter is not specified
in the webconnectxml file (see Configure the PowerTerm
WebConnect Client)
Correct the file and try again
The specified
destination
folder name
is wrong
The destination folder name contains illegal characters
ltgt|
Check the dst parameter in the webconnectxml file Correct the
file and try again
You do not
have
permissions
to write to
ltpathgt
The PowerTerm WebConnect Agent cannot be written to the
destination as defined Check the write permissions
The default destination defined in the version file should not to
be changed
A customized destination for PowerTerm WebConnect Agent
downloading can be defined in the webconnectxml file (See
Configure the PowerTerm WebConnect Client)
Check the destination value correct and try again
PowerTerm WebConnect 39 Getting Started Guide
About Ericom
Ericomreg Software is a leading provider of Application Access and Virtualization Solutions
Since 1993 Ericom has been helping users access enterprise mission-critical applications
running on a broad range of Microsoftreg Windowsreg Terminal Servers virtual Desktops
Blade PCs legacy hosts and other systems Ericom provides concrete business value by
helping organizations realize the benefits of their IT investments With offices in the United
States United Kingdom EMEA India and China Ericom also has an extensive network of
distributors and partners throughout North America Europe Asia and the Far East Our
expanding customer base is more than 30 thousand strong with over 7 million
installations
For more information on our products and services contact us at the location nearest to you
And visit our web site httpwwwericomcom
North America Western Europe International
Ericom Software Inc Ericom Software (UK) Ltd Ericom Software Ltd
231 Herbert Avenue Bldg 4 11a Victoria Square 8 Hamarpeh Street
Closter NJ 07624 USA Droitwich Worcestershire Har Hotzvim Technology Park
Tel +1 (201) 767 2210 WR9 8DE United Kingdom Jerusalem 91450 Israel
Fax +1 (201) 767 2205 Tel +44 (0) 845 644 3597 Tel +972 (2) 591 1700
Toll-free 1 (888) 769 7876 Fax +44 (0) 845 644 3598 Fax +972 (2) 571 4737
Email infoericomcom Email infoericomcouk Email infoericomcom
PowerTerm WebConnect 27 Getting Started Guide
Step 3 Install the Application page
1 Login to the workplace as administrator
2 Go to Administration | Portal User Interface | Manage Pages
3 Search for My Work
4 Click the My Work link and select New Page
5 Name the page PowerTerm WebConnect and click OK
6 Click OK again You will see the created page on the list
7 Click the pencil icon and select the 1-square layout
8 Click Add Portlet and search for PowerTerm WebConnect
9 Select it and click OK
10 Click Done
11 Click My work on top and PowerTerm WebConnect is displayed on the left bar
Step 4 Run the portlet
1 Restart IBM Workplace Server
2 Open IBM Workplace Portal in a browser httpltportal servergtlwpmyworkplace
3 Login to IBM Workplace Server
4 Click My work PowerTerm WebConnect portlet is displayed
5 Launch it The Userrsquos applications as defined on PowerTerm WebConnect Server
appear
6 Click an application to launch it
65 Install PowerTerm WebConnect Portlet on IBM WebSphere 61 server (for Windows OS)
Step 1 Install PowerTerm WebConnect Server
You have to configure PowerTerm WebConnect Server if it and the IBM WebSphere Server
are on separate machines
1 Launch PowerTerm WebConnect Administration Tool
2 Open Files | Configuration | Main
3 In the [Portal] section edit Machines=localhostltIBM sever machinegt
Step 2 Copy Files
The following files need to be copied from WebConnect ServerAddOnsIBM
WebSpherePortlet folder to IBM WebSphere Server
PowerTerm WebConnect 28 Getting Started Guide
File name to copy Destination folder
OpenSSLdll ltAppServergtjavajrebin
IbmPortaldll ltAppServergtjavajrebin
IbmPortalini ltAppServergtjavajrebin
WebConnectPortaljar ltAppServergtlib
Step 3 Portlet Configuration
1 On IBM Workplace Server go to ltAppServergtjavajrebinIbmPortalini
2 You can modify the following parameters in the [Server=WebConnect] section webserverport=ltIBM web server portgt
Specifies the Web server port for accessing the PowerTerm WebConnect clients folder
Default 80 Address
Specifies the address of the PowerTerm WebConnect Server machine for Portlet to
connect to when PowerTerm WebConnect Server is located on a different machine
than the IBM Workplace Server CustomAddress
Specifies the addresss of the PowerTerm WebConnect Server machine for Clients to connect to If CustomAddress is the same as Address then this may be omitted webserveraddr
Specifies the address of the Web Server machine when it is located on a different
machine than the IBM Workplace Server
3 Restart the IBM server ltAppServergtProfilesAppServer01binstopServerbat ltAppServergtProfilesAppServer01binstartServerbat
This procedure may take about 20 minutes
Step 4 Install the Portlet and create an Application page
1 In a Web browser open the URL httpltIBM WebSphere Servergt9060ibmconsole
to open the IBM WebSphere Portal
2 Login and go to Applications | Install New Application
3 Browse to the PowerTerm WebConnectwar file located on PowerTerm WebConnect
Server
4 Enter Context root and click Next The Select installation options dialog appears
5 Optional change options to your preference or keep the default
6 Click Next
7 Select Ericom in the Module column click Apply and then Next
8 Click Finish and then Save
9 Select Applications | Enterprise Applications
10 Select PowerTerm WebConnectwar checkbox and click Start
PowerTerm WebConnect 29 Getting Started Guide
11 Enter in the Web browser the URL httpltIBM WebSphere
Servergt9080ltContext rootgtEricom portlet The Login dialog appears
12 Login and you will see PowerTerm WebConnect displayed on the list
Step 5 Run the Portlet
1 Restart IBM WebSphere Server
2 Open IBM WebSphere Portal in a browser httpltportal servergt9080ltContext
rootgtEricom portlet
3 Login to IBM WebSphere Server
4 Launch it The Userrsquos applications as defined on PowerTerm WebConnect Server
appear
5 Click an application to launch it
66 PowerTerm WebConnect Server Configuration
bull To enable the Lotus Expeditor to run the PowerTerm WebConnect client the
System Administrator must provide the users with accounts on PowerTerm
WebConnect Server (see the PowerTerm WebConnect Administratorrsquos Manual for
instructions on how to create users groups and connections on the PowerTerm
WebConnect Server)
bull To enable PowerTerm WebConnectrsquos Single Sign-On feature the System
Administrator must create a PowerTerm WebConnect user with the same
username and password as used for the Lotus Expeditor For a managed Lotus
Expeditor the credentials used are the username and password sent to the
managing server For an unmanaged Lotus Expeditor the operation system
username and the Lotus Expeditor password are used as credentials
NOTE If a password is not defined then the Single Sign-On will fail and the user will be
prompted with a login dialog
67 PowerTerm WebConnect Client Configuration
The PowerTerm WebConnect client is configured in webconnectxml located in the config
folder webconnectxml parameters are
url The PowerTerm WebConnect Agent url
server The PowerTerm WebConnect Server address
sso The Single Sign-On feature
dst The local destination for downloading PowerTerm WebConnect
components
PowerTerm WebConnect 30 Getting Started Guide
url
PowerTerm WebConnect components are installed on a Web server Their default url is
Windows Agent
httpltWebServer IPgtWebConnectwindowsptagentcab
Linux Agent
httpltWebServer IPgtWebConnectlinuxix86qterm-wczip
The url parameter must include the first part of the url (which is identical for both Windows
and Linux agents)
The PowerTerm WebConnect client will automatically append the appropriate suffix in
order to create a full accurate url
Example
ltitem key=rdquourlrdquo value=httpadminserverWebConnectgt
server
The computer name or IP address of the PowerTerm WebConnect Server machine
The PowerTerm WebConnect client will log in to this PowerTerm WebConnect Server
display the applications defined on it and run them according to this serverrsquos configuration
Format ltserver IPgt[ltportgt]
where default port is 4000 (can be edited)
Example
ltitem key=rdquoserverrdquo value=rdquoadmin24000rdquogt
sso
Determines whether Single Sign-on will be used to log in to PowerTerm WebConnect
Server Values
bull True (default) the client should automatically log in to the PowerTerm WebConnect
Server using the same credentials as the ones used to log in to the Lotus Expeditor
client
The System Administrator must verify that these credentials can log in to the
PowerTerm WebConnect Server
bull False the user will be prompted with a login dialog or will log in automatically using
previously saved credentials
Example
ltitem key=rdquossordquo value=rdquotruerdquogt
Autologin mode
PowerTerm WebConnect 31 Getting Started Guide
If sso is set to True the user is not prompted for credentials and the login process to
PowerTerm WebConnect Server is done automatically sending the credentials used for the
Lotus Expeditor unless the Lotus Expeditor does not have a password defined (In the
Lotus Expeditor preferences page | Password| Prompt me for a password at start up checkbox)
However if Single Sign-on is not used there are several options regarding Autologin that
can be defined in the PowerTerm WebConnect Preferences page Options
bull Yes
bull No
bull Interactive
bull First time interactive (default) ndash Simplifies the login process to PowerTerm
WebConnect Server In this mode the first time the user logs in to PowerTerm
WebConnect Server he will be prompted for his credentials with the Login dialog
These credentials will be stored in the machine and from then on the login process to
PowerTerm WebConnect Server will be done automatically
1 Open File | Preferences from the Lotus Expeditor and select PowerTerm WebConnect
2 In the Autologin to WebConnect Server section select First Interactive and click OK
3 Start PowerTerm WebConnect Client for Lotus Expeditor If credentials were entered
at least once then the next time the client will connect to PowerTerm WebConnect
Server without prompting for the user name and password
The Administrator must configure the Agent to do nothing when it exits for the
feature to work this way See PowerTerm WebConnect Administratorrsquos Manual for more information about defining Autologin
bull Allow multiple selection ndash Defines whether the user can launch more than one
application at a time (by using the ltCtrlgt or ltShiftgt button while selecting applications)
dst
Defines the path to download PowerTerm WebConnect components on the client machine
The dst parameter can contain macros which are translated by the PowerTerm WebConnect
Client for Lotus Expeditor during runtime The macros should be placed between percent
symbols () for example WebServer
When such a value is defined the PowerTerm WebConnect Client for Lotus Expeditor
substitutes the entire expression for the macrorsquos value
The PowerTerm WebConnect Client for Lotus Expeditor does not support the use
of environment variables as macros
Macros are not case sensitive
Macros supported by PowerTerm WebConnect Client for Lotus Expeditor
Macro name Description
WebServer The name of the Web server
It is obtained from the PowerTerm WebConnect Agent url
PowerTerm WebConnect 32 Getting Started Guide
parameter
Name The name of the clientrsquos CAB or ZIP file eg ldquoptagentrdquo
Display The clientrsquos display name from the version file
Version The clientrsquos version value It is obtained from the version
file
Root The default root location
Windows ldquoCrdquo
LinuxUnix an empty string
OSDir Windows Windowsrsquo installation directory for example
ldquoCWindowsrdquo
Linux an empty string
OSDrive Windows Windowsrsquo installation drive for example ldquoCrdquo
Linux an empty string
HomePath Windows The HOMEPATH environment variable
Linux The HOME environment variable
Home The Ericom folder in the userrsquos home directory
Windows CDocuments and SettingsltusergtApplication
DataEricom
Linux ltusergtEricom
In addition to the predefined macros listed above the PowerTerm WebConnect client
supports the usage of Java System Properties
Java System Properties available for users on Windows XP SP2
Java System Property Name Value Example
javaversion 150
javavendorurl httpwwwibmcom
javahome CIBMcommonpluginscomibmpvcwctruntim
esj2sewin32x86_150SR2-
20060511rcpeclipsepluginscomibmrcpj2sew
in32x86_150SR2-20060511jre
javavmspecificationversion 10
javavmversion 23
javavmvendor IBM Corporation
javavmname IBM J9 VM
PowerTerm WebConnect 33 Getting Started Guide
javaiotmpdir CDOCUME~1dianaLOCALS~1Temp
javacompiler j9jit23
javaextdirs CIBMcommonpluginscomibmpvcwctruntim
esj2sewin32x86_150SR2-
20060511rcpeclipsepluginscomibmrcpj2sew
in32x86_150SR2-20060511jrelibext
osname Windows XP
osarch x86
osversion 51 build 2600 Service Pack 2
pathseparator
username Jone
userhome CDocuments and SettingsJone
userdir CIBMRSA
usertimezone GMT+0200
System properties available for users on Linux RedHat 9
Java System Property Name Value Example
javaversion 150
javavendorurl httpwwwibmcom
javahome usrjavajre150_07
javavmversion 150
javavmvendor IBM Corporation
javavmname IBM J9 VM
javaclasspath
javalibrarypath
javaiotmpdir tmp
javacompiler
javaextdirs
osname Linux
osarch i386
osversion 2420-8
pathseparator
PowerTerm WebConnect 34 Getting Started Guide
username root
userhome root
userdir root
System properties names are placed in the configuration file within percent symbols ()
(like macros)
671 Configure the PowerTerm WebConnect Client
1 Open the Config Folder and edit the webconnectxml file Example
ltxml version =rdquo10rdquo encoding=rdquoUTF-8rdquogt
ltsection name=rdquoparametersrdquogt
ltitem key=rdquourlrdquo value=httpadminserverWebConnect56gt
ltitem key=rdquoserverrdquo value=rdquoadmin24000rdquogt
ltitem key=rdquossordquo value=rdquotruerdquogt
ltitem key=rdquodestrdquo value=rdquoCProgram FilesEricomrdquogt
ltsectiongt
2 Save the customized webconnectxml to a Web server folder available to all users It is
recommended to use the same Web server as the PowerTerm WebConnect Agent
Example
ltWebConnect installation foldergtwebwebconnectxml
3 Test the accessibility to this file - Type the URL of webconnectxml in the browser
Example
httpltWebServer IPgtWebConnectwebconnectxml
The contents of the file should be displayed
672 Configure the Preferences File
1 Open the plugins folder and open the PowerTermWebConnectClient_560365jar file
You can use Winzip version 70 and up or in Windows XP ndash Create a new file type for the
jar extension click advanced and select compressed (zipped) folder in the drop down list
Now you can open the JAR files in the Windows Explorer
The default contents of the file
configURL=httpleericomcomWebConnectwebconnectxml
2 Specify the accurate URL of the webconnectxml file Example
httpltWebServer IPgtWebConnectwebconnectxml
3 Save the file and close it The WinZip will display the following dialog
ldquoFile preferencesini has been changed since it was extracted Update archive
with this filerdquo
PowerTerm WebConnect 35 Getting Started Guide
4 Click Yes and close the archive
If you are editing the file from within the explorer you will have to save the file elsewhere
and then drag it to the explorer window where the JAR file is open
68 Installing PowerTerm WebConnect Client on Lotus Expeditor
1 Start the Lotus Expeditor client
2 Select File | Application | Install
3 Select Search for new features to install and click Next
4 Select Add Folder Location and type or select the location of the update site folder from
the provided package Click OK
5 Select the location you have just created and click Finish
6 In the Select the feature to install tree select Powerterm WebConnectUpdate Site Click
Next
7 Select I accept the terms in the license agreements and click Next
8 Click Finish
9 When prompted restart the platform
69 Running PowerTerm WebConnect Client for Lotus Expeditor
1 Click Open The PowerTerm WebConnect option is displayed
2 Select PowerTerm WebConnect The application will automatically connect and start
downloading the components from PowerTerm WebConnect Server
IMPORTANT
If you did not install PowerTerm WebConnect Server and are instead connecting to Ericom
Softwarersquos Demo WebConnect Server then you need to open port 443 in the firewall
691 PowerTerm WebConnect Client Workflow
1 PowerTerm WebConnect client reads the URL of webconnectxml from the preferencesini
file and requests it
2 When the webconnectxml is successfully downloaded the application reads the
configuration connects to the specified Web server downloads the PowerTerm
WebConnect components and connects to the PowerTerm WebConnect Server
3 The user is requested to login to the PowerTerm WebConnect Server For testing you
can use the username Example and password example
This step will be skipped if Single Sign-on is set to ldquotruerdquo
PowerTerm WebConnect 36 Getting Started Guide
4 After logging in to PowerTerm WebConnect Server the userrsquos applications are displayed
as defined by the administrator
5 To run an application select the desired application from the list and click Launch or
double-click the application The application will be launched in a separate window
610 Troubleshooting
When you encounter a problem the first step is to open the log file This file is located on
the client machine in the Ericom folder
Windows
CDocuments and SettingsltusernamegtEricomleclientEricomPluginlog
Linux
ltuser-home-directorygtEricomleclientEricomPluginlog
Following is a guide for diagnosing and fixing the problems in cases of error messages and
additional information
Error
Message
Solution
Version File
reading error
1 Check the lsquourlrsquo parameter in the webconnectxml file on the Web
server The value should be
httpltWebServerIPgtWebConnect
2 Try to run the following URL on the browser
Windows
httpltWebServerIPgtWebConnectwindowsptagentvertxt
Linux
httpltWebServerIPgtWebConnectlinuxix86qterm-
wcvertxt
The file contents displayed in the browser window should be in
the following form
560-rel14546
PowerTerm WebConnect Application Zone
560 - Main Release
ltrootgtPowerTerm WebConnect 56ltWebServergt
If the version file contents are not as shown check
- Is the Web Server running
- Are PowerTerm WebConnect Web Components and version files
PowerTerm WebConnect 37 Getting Started Guide
in place
3 On the Web server check ltPowerTerm WebConnect
rootgtwebwindowsptagentvertxt If the contents ldquolook wrongrdquo or
not in the proper form reinstall the PowerTerm WebConnect Web
components
4 On the client machine open the aforementioned URL in the
browser The file content should appear in the browser If it does
not it could be that the Web server is down
Web Server is
shut down
The webconnectxml configuration file must be located on the Web
server The explicit URL to this file is defined in the preferencesini
file (see Configure the Preferences File)
The error message contains the IP address of the Web server
Verify that the Web server on this machine is running
Version file
does not exist
on ltURLgt
See Version File reading error
The
configuration
file is not
accessible or
has a wrong
format
The webconnectxml configuration file must be located on the Web
server and the explicit URL to the configuration must be defined in
the preferencesini file (see Configure the Preferences File)
Try to open the URL specified in the error message in the
browser If it does not open then it either does not exist or it has
a wrong format
Preferences
file does not
exist in the
application
bundle
The preferencesini file containing the URL to the configuration
file was removed from the update site folder
Uninstall the current PowerTerm WebConnect client from the
client machine Create a new customized package (see
PowerTerm WebConnect Client Configuration) and reinstall it
Configuration
file URL is not
defined in
preference
file
The URL to the configuration file does not appear in the
preferencesini file (see Configure the Preferences File)
Uninstall the current PowerTerm WebConnect client from the
client machine Create a new customized package (see
PowerTerm WebConnect Client Configuration) and reinstall it
No IP address
could be
found for the
host
The Web server URL specified in the preferencesini file (see
Configure the Preferences File) or in the webconnectxml file (see
Configure the PowerTerm WebConnect Client) is an unknown
host
If the mistake is in the preferencesini file uninstall the current
PowerTerm WebConnect client from the client machine Create a
new customized package (see PowerTerm WebConnect Client
Configuration) and reinstall it
PowerTerm WebConnect 38 Getting Started Guide
If the mistake is in the webconnectxml file correct the file reopen
the Lotus Expeditor client
Cannot write
to destination
The temporary file cannot be written to the defined destination
Check the write permissions
Copied
configuration
file has wrong
format
The webconnectxml file as received from the specified URL has a
wrong format Correct the file and try again
PowerTerm
WebConnect
Agent URL is
malformed
The PowerTerm WebConnect Agent URL specified in the
webconnectxml file (see Configure the PowerTerm WebConnect
Client) does not have a proper HTTP format Correct the file and
try again
PowerTerm
WebConnect
Agent URL is
not defined
The PowerTerm WebConnect Agent URL parameter is not specified
in the webconnectxml file (see Configure the PowerTerm
WebConnect Client)
Correct the file and try again
The specified
destination
folder name
is wrong
The destination folder name contains illegal characters
ltgt|
Check the dst parameter in the webconnectxml file Correct the
file and try again
You do not
have
permissions
to write to
ltpathgt
The PowerTerm WebConnect Agent cannot be written to the
destination as defined Check the write permissions
The default destination defined in the version file should not to
be changed
A customized destination for PowerTerm WebConnect Agent
downloading can be defined in the webconnectxml file (See
Configure the PowerTerm WebConnect Client)
Check the destination value correct and try again
PowerTerm WebConnect 39 Getting Started Guide
About Ericom
Ericomreg Software is a leading provider of Application Access and Virtualization Solutions
Since 1993 Ericom has been helping users access enterprise mission-critical applications
running on a broad range of Microsoftreg Windowsreg Terminal Servers virtual Desktops
Blade PCs legacy hosts and other systems Ericom provides concrete business value by
helping organizations realize the benefits of their IT investments With offices in the United
States United Kingdom EMEA India and China Ericom also has an extensive network of
distributors and partners throughout North America Europe Asia and the Far East Our
expanding customer base is more than 30 thousand strong with over 7 million
installations
For more information on our products and services contact us at the location nearest to you
And visit our web site httpwwwericomcom
North America Western Europe International
Ericom Software Inc Ericom Software (UK) Ltd Ericom Software Ltd
231 Herbert Avenue Bldg 4 11a Victoria Square 8 Hamarpeh Street
Closter NJ 07624 USA Droitwich Worcestershire Har Hotzvim Technology Park
Tel +1 (201) 767 2210 WR9 8DE United Kingdom Jerusalem 91450 Israel
Fax +1 (201) 767 2205 Tel +44 (0) 845 644 3597 Tel +972 (2) 591 1700
Toll-free 1 (888) 769 7876 Fax +44 (0) 845 644 3598 Fax +972 (2) 571 4737
Email infoericomcom Email infoericomcouk Email infoericomcom
PowerTerm WebConnect 28 Getting Started Guide
File name to copy Destination folder
OpenSSLdll ltAppServergtjavajrebin
IbmPortaldll ltAppServergtjavajrebin
IbmPortalini ltAppServergtjavajrebin
WebConnectPortaljar ltAppServergtlib
Step 3 Portlet Configuration
1 On IBM Workplace Server go to ltAppServergtjavajrebinIbmPortalini
2 You can modify the following parameters in the [Server=WebConnect] section webserverport=ltIBM web server portgt
Specifies the Web server port for accessing the PowerTerm WebConnect clients folder
Default 80 Address
Specifies the address of the PowerTerm WebConnect Server machine for Portlet to
connect to when PowerTerm WebConnect Server is located on a different machine
than the IBM Workplace Server CustomAddress
Specifies the addresss of the PowerTerm WebConnect Server machine for Clients to connect to If CustomAddress is the same as Address then this may be omitted webserveraddr
Specifies the address of the Web Server machine when it is located on a different
machine than the IBM Workplace Server
3 Restart the IBM server ltAppServergtProfilesAppServer01binstopServerbat ltAppServergtProfilesAppServer01binstartServerbat
This procedure may take about 20 minutes
Step 4 Install the Portlet and create an Application page
1 In a Web browser open the URL httpltIBM WebSphere Servergt9060ibmconsole
to open the IBM WebSphere Portal
2 Login and go to Applications | Install New Application
3 Browse to the PowerTerm WebConnectwar file located on PowerTerm WebConnect
Server
4 Enter Context root and click Next The Select installation options dialog appears
5 Optional change options to your preference or keep the default
6 Click Next
7 Select Ericom in the Module column click Apply and then Next
8 Click Finish and then Save
9 Select Applications | Enterprise Applications
10 Select PowerTerm WebConnectwar checkbox and click Start
PowerTerm WebConnect 29 Getting Started Guide
11 Enter in the Web browser the URL httpltIBM WebSphere
Servergt9080ltContext rootgtEricom portlet The Login dialog appears
12 Login and you will see PowerTerm WebConnect displayed on the list
Step 5 Run the Portlet
1 Restart IBM WebSphere Server
2 Open IBM WebSphere Portal in a browser httpltportal servergt9080ltContext
rootgtEricom portlet
3 Login to IBM WebSphere Server
4 Launch it The Userrsquos applications as defined on PowerTerm WebConnect Server
appear
5 Click an application to launch it
66 PowerTerm WebConnect Server Configuration
bull To enable the Lotus Expeditor to run the PowerTerm WebConnect client the
System Administrator must provide the users with accounts on PowerTerm
WebConnect Server (see the PowerTerm WebConnect Administratorrsquos Manual for
instructions on how to create users groups and connections on the PowerTerm
WebConnect Server)
bull To enable PowerTerm WebConnectrsquos Single Sign-On feature the System
Administrator must create a PowerTerm WebConnect user with the same
username and password as used for the Lotus Expeditor For a managed Lotus
Expeditor the credentials used are the username and password sent to the
managing server For an unmanaged Lotus Expeditor the operation system
username and the Lotus Expeditor password are used as credentials
NOTE If a password is not defined then the Single Sign-On will fail and the user will be
prompted with a login dialog
67 PowerTerm WebConnect Client Configuration
The PowerTerm WebConnect client is configured in webconnectxml located in the config
folder webconnectxml parameters are
url The PowerTerm WebConnect Agent url
server The PowerTerm WebConnect Server address
sso The Single Sign-On feature
dst The local destination for downloading PowerTerm WebConnect
components
PowerTerm WebConnect 30 Getting Started Guide
url
PowerTerm WebConnect components are installed on a Web server Their default url is
Windows Agent
httpltWebServer IPgtWebConnectwindowsptagentcab
Linux Agent
httpltWebServer IPgtWebConnectlinuxix86qterm-wczip
The url parameter must include the first part of the url (which is identical for both Windows
and Linux agents)
The PowerTerm WebConnect client will automatically append the appropriate suffix in
order to create a full accurate url
Example
ltitem key=rdquourlrdquo value=httpadminserverWebConnectgt
server
The computer name or IP address of the PowerTerm WebConnect Server machine
The PowerTerm WebConnect client will log in to this PowerTerm WebConnect Server
display the applications defined on it and run them according to this serverrsquos configuration
Format ltserver IPgt[ltportgt]
where default port is 4000 (can be edited)
Example
ltitem key=rdquoserverrdquo value=rdquoadmin24000rdquogt
sso
Determines whether Single Sign-on will be used to log in to PowerTerm WebConnect
Server Values
bull True (default) the client should automatically log in to the PowerTerm WebConnect
Server using the same credentials as the ones used to log in to the Lotus Expeditor
client
The System Administrator must verify that these credentials can log in to the
PowerTerm WebConnect Server
bull False the user will be prompted with a login dialog or will log in automatically using
previously saved credentials
Example
ltitem key=rdquossordquo value=rdquotruerdquogt
Autologin mode
PowerTerm WebConnect 31 Getting Started Guide
If sso is set to True the user is not prompted for credentials and the login process to
PowerTerm WebConnect Server is done automatically sending the credentials used for the
Lotus Expeditor unless the Lotus Expeditor does not have a password defined (In the
Lotus Expeditor preferences page | Password| Prompt me for a password at start up checkbox)
However if Single Sign-on is not used there are several options regarding Autologin that
can be defined in the PowerTerm WebConnect Preferences page Options
bull Yes
bull No
bull Interactive
bull First time interactive (default) ndash Simplifies the login process to PowerTerm
WebConnect Server In this mode the first time the user logs in to PowerTerm
WebConnect Server he will be prompted for his credentials with the Login dialog
These credentials will be stored in the machine and from then on the login process to
PowerTerm WebConnect Server will be done automatically
1 Open File | Preferences from the Lotus Expeditor and select PowerTerm WebConnect
2 In the Autologin to WebConnect Server section select First Interactive and click OK
3 Start PowerTerm WebConnect Client for Lotus Expeditor If credentials were entered
at least once then the next time the client will connect to PowerTerm WebConnect
Server without prompting for the user name and password
The Administrator must configure the Agent to do nothing when it exits for the
feature to work this way See PowerTerm WebConnect Administratorrsquos Manual for more information about defining Autologin
bull Allow multiple selection ndash Defines whether the user can launch more than one
application at a time (by using the ltCtrlgt or ltShiftgt button while selecting applications)
dst
Defines the path to download PowerTerm WebConnect components on the client machine
The dst parameter can contain macros which are translated by the PowerTerm WebConnect
Client for Lotus Expeditor during runtime The macros should be placed between percent
symbols () for example WebServer
When such a value is defined the PowerTerm WebConnect Client for Lotus Expeditor
substitutes the entire expression for the macrorsquos value
The PowerTerm WebConnect Client for Lotus Expeditor does not support the use
of environment variables as macros
Macros are not case sensitive
Macros supported by PowerTerm WebConnect Client for Lotus Expeditor
Macro name Description
WebServer The name of the Web server
It is obtained from the PowerTerm WebConnect Agent url
PowerTerm WebConnect 32 Getting Started Guide
parameter
Name The name of the clientrsquos CAB or ZIP file eg ldquoptagentrdquo
Display The clientrsquos display name from the version file
Version The clientrsquos version value It is obtained from the version
file
Root The default root location
Windows ldquoCrdquo
LinuxUnix an empty string
OSDir Windows Windowsrsquo installation directory for example
ldquoCWindowsrdquo
Linux an empty string
OSDrive Windows Windowsrsquo installation drive for example ldquoCrdquo
Linux an empty string
HomePath Windows The HOMEPATH environment variable
Linux The HOME environment variable
Home The Ericom folder in the userrsquos home directory
Windows CDocuments and SettingsltusergtApplication
DataEricom
Linux ltusergtEricom
In addition to the predefined macros listed above the PowerTerm WebConnect client
supports the usage of Java System Properties
Java System Properties available for users on Windows XP SP2
Java System Property Name Value Example
javaversion 150
javavendorurl httpwwwibmcom
javahome CIBMcommonpluginscomibmpvcwctruntim
esj2sewin32x86_150SR2-
20060511rcpeclipsepluginscomibmrcpj2sew
in32x86_150SR2-20060511jre
javavmspecificationversion 10
javavmversion 23
javavmvendor IBM Corporation
javavmname IBM J9 VM
PowerTerm WebConnect 33 Getting Started Guide
javaiotmpdir CDOCUME~1dianaLOCALS~1Temp
javacompiler j9jit23
javaextdirs CIBMcommonpluginscomibmpvcwctruntim
esj2sewin32x86_150SR2-
20060511rcpeclipsepluginscomibmrcpj2sew
in32x86_150SR2-20060511jrelibext
osname Windows XP
osarch x86
osversion 51 build 2600 Service Pack 2
pathseparator
username Jone
userhome CDocuments and SettingsJone
userdir CIBMRSA
usertimezone GMT+0200
System properties available for users on Linux RedHat 9
Java System Property Name Value Example
javaversion 150
javavendorurl httpwwwibmcom
javahome usrjavajre150_07
javavmversion 150
javavmvendor IBM Corporation
javavmname IBM J9 VM
javaclasspath
javalibrarypath
javaiotmpdir tmp
javacompiler
javaextdirs
osname Linux
osarch i386
osversion 2420-8
pathseparator
PowerTerm WebConnect 34 Getting Started Guide
username root
userhome root
userdir root
System properties names are placed in the configuration file within percent symbols ()
(like macros)
671 Configure the PowerTerm WebConnect Client
1 Open the Config Folder and edit the webconnectxml file Example
ltxml version =rdquo10rdquo encoding=rdquoUTF-8rdquogt
ltsection name=rdquoparametersrdquogt
ltitem key=rdquourlrdquo value=httpadminserverWebConnect56gt
ltitem key=rdquoserverrdquo value=rdquoadmin24000rdquogt
ltitem key=rdquossordquo value=rdquotruerdquogt
ltitem key=rdquodestrdquo value=rdquoCProgram FilesEricomrdquogt
ltsectiongt
2 Save the customized webconnectxml to a Web server folder available to all users It is
recommended to use the same Web server as the PowerTerm WebConnect Agent
Example
ltWebConnect installation foldergtwebwebconnectxml
3 Test the accessibility to this file - Type the URL of webconnectxml in the browser
Example
httpltWebServer IPgtWebConnectwebconnectxml
The contents of the file should be displayed
672 Configure the Preferences File
1 Open the plugins folder and open the PowerTermWebConnectClient_560365jar file
You can use Winzip version 70 and up or in Windows XP ndash Create a new file type for the
jar extension click advanced and select compressed (zipped) folder in the drop down list
Now you can open the JAR files in the Windows Explorer
The default contents of the file
configURL=httpleericomcomWebConnectwebconnectxml
2 Specify the accurate URL of the webconnectxml file Example
httpltWebServer IPgtWebConnectwebconnectxml
3 Save the file and close it The WinZip will display the following dialog
ldquoFile preferencesini has been changed since it was extracted Update archive
with this filerdquo
PowerTerm WebConnect 35 Getting Started Guide
4 Click Yes and close the archive
If you are editing the file from within the explorer you will have to save the file elsewhere
and then drag it to the explorer window where the JAR file is open
68 Installing PowerTerm WebConnect Client on Lotus Expeditor
1 Start the Lotus Expeditor client
2 Select File | Application | Install
3 Select Search for new features to install and click Next
4 Select Add Folder Location and type or select the location of the update site folder from
the provided package Click OK
5 Select the location you have just created and click Finish
6 In the Select the feature to install tree select Powerterm WebConnectUpdate Site Click
Next
7 Select I accept the terms in the license agreements and click Next
8 Click Finish
9 When prompted restart the platform
69 Running PowerTerm WebConnect Client for Lotus Expeditor
1 Click Open The PowerTerm WebConnect option is displayed
2 Select PowerTerm WebConnect The application will automatically connect and start
downloading the components from PowerTerm WebConnect Server
IMPORTANT
If you did not install PowerTerm WebConnect Server and are instead connecting to Ericom
Softwarersquos Demo WebConnect Server then you need to open port 443 in the firewall
691 PowerTerm WebConnect Client Workflow
1 PowerTerm WebConnect client reads the URL of webconnectxml from the preferencesini
file and requests it
2 When the webconnectxml is successfully downloaded the application reads the
configuration connects to the specified Web server downloads the PowerTerm
WebConnect components and connects to the PowerTerm WebConnect Server
3 The user is requested to login to the PowerTerm WebConnect Server For testing you
can use the username Example and password example
This step will be skipped if Single Sign-on is set to ldquotruerdquo
PowerTerm WebConnect 36 Getting Started Guide
4 After logging in to PowerTerm WebConnect Server the userrsquos applications are displayed
as defined by the administrator
5 To run an application select the desired application from the list and click Launch or
double-click the application The application will be launched in a separate window
610 Troubleshooting
When you encounter a problem the first step is to open the log file This file is located on
the client machine in the Ericom folder
Windows
CDocuments and SettingsltusernamegtEricomleclientEricomPluginlog
Linux
ltuser-home-directorygtEricomleclientEricomPluginlog
Following is a guide for diagnosing and fixing the problems in cases of error messages and
additional information
Error
Message
Solution
Version File
reading error
1 Check the lsquourlrsquo parameter in the webconnectxml file on the Web
server The value should be
httpltWebServerIPgtWebConnect
2 Try to run the following URL on the browser
Windows
httpltWebServerIPgtWebConnectwindowsptagentvertxt
Linux
httpltWebServerIPgtWebConnectlinuxix86qterm-
wcvertxt
The file contents displayed in the browser window should be in
the following form
560-rel14546
PowerTerm WebConnect Application Zone
560 - Main Release
ltrootgtPowerTerm WebConnect 56ltWebServergt
If the version file contents are not as shown check
- Is the Web Server running
- Are PowerTerm WebConnect Web Components and version files
PowerTerm WebConnect 37 Getting Started Guide
in place
3 On the Web server check ltPowerTerm WebConnect
rootgtwebwindowsptagentvertxt If the contents ldquolook wrongrdquo or
not in the proper form reinstall the PowerTerm WebConnect Web
components
4 On the client machine open the aforementioned URL in the
browser The file content should appear in the browser If it does
not it could be that the Web server is down
Web Server is
shut down
The webconnectxml configuration file must be located on the Web
server The explicit URL to this file is defined in the preferencesini
file (see Configure the Preferences File)
The error message contains the IP address of the Web server
Verify that the Web server on this machine is running
Version file
does not exist
on ltURLgt
See Version File reading error
The
configuration
file is not
accessible or
has a wrong
format
The webconnectxml configuration file must be located on the Web
server and the explicit URL to the configuration must be defined in
the preferencesini file (see Configure the Preferences File)
Try to open the URL specified in the error message in the
browser If it does not open then it either does not exist or it has
a wrong format
Preferences
file does not
exist in the
application
bundle
The preferencesini file containing the URL to the configuration
file was removed from the update site folder
Uninstall the current PowerTerm WebConnect client from the
client machine Create a new customized package (see
PowerTerm WebConnect Client Configuration) and reinstall it
Configuration
file URL is not
defined in
preference
file
The URL to the configuration file does not appear in the
preferencesini file (see Configure the Preferences File)
Uninstall the current PowerTerm WebConnect client from the
client machine Create a new customized package (see
PowerTerm WebConnect Client Configuration) and reinstall it
No IP address
could be
found for the
host
The Web server URL specified in the preferencesini file (see
Configure the Preferences File) or in the webconnectxml file (see
Configure the PowerTerm WebConnect Client) is an unknown
host
If the mistake is in the preferencesini file uninstall the current
PowerTerm WebConnect client from the client machine Create a
new customized package (see PowerTerm WebConnect Client
Configuration) and reinstall it
PowerTerm WebConnect 38 Getting Started Guide
If the mistake is in the webconnectxml file correct the file reopen
the Lotus Expeditor client
Cannot write
to destination
The temporary file cannot be written to the defined destination
Check the write permissions
Copied
configuration
file has wrong
format
The webconnectxml file as received from the specified URL has a
wrong format Correct the file and try again
PowerTerm
WebConnect
Agent URL is
malformed
The PowerTerm WebConnect Agent URL specified in the
webconnectxml file (see Configure the PowerTerm WebConnect
Client) does not have a proper HTTP format Correct the file and
try again
PowerTerm
WebConnect
Agent URL is
not defined
The PowerTerm WebConnect Agent URL parameter is not specified
in the webconnectxml file (see Configure the PowerTerm
WebConnect Client)
Correct the file and try again
The specified
destination
folder name
is wrong
The destination folder name contains illegal characters
ltgt|
Check the dst parameter in the webconnectxml file Correct the
file and try again
You do not
have
permissions
to write to
ltpathgt
The PowerTerm WebConnect Agent cannot be written to the
destination as defined Check the write permissions
The default destination defined in the version file should not to
be changed
A customized destination for PowerTerm WebConnect Agent
downloading can be defined in the webconnectxml file (See
Configure the PowerTerm WebConnect Client)
Check the destination value correct and try again
PowerTerm WebConnect 39 Getting Started Guide
About Ericom
Ericomreg Software is a leading provider of Application Access and Virtualization Solutions
Since 1993 Ericom has been helping users access enterprise mission-critical applications
running on a broad range of Microsoftreg Windowsreg Terminal Servers virtual Desktops
Blade PCs legacy hosts and other systems Ericom provides concrete business value by
helping organizations realize the benefits of their IT investments With offices in the United
States United Kingdom EMEA India and China Ericom also has an extensive network of
distributors and partners throughout North America Europe Asia and the Far East Our
expanding customer base is more than 30 thousand strong with over 7 million
installations
For more information on our products and services contact us at the location nearest to you
And visit our web site httpwwwericomcom
North America Western Europe International
Ericom Software Inc Ericom Software (UK) Ltd Ericom Software Ltd
231 Herbert Avenue Bldg 4 11a Victoria Square 8 Hamarpeh Street
Closter NJ 07624 USA Droitwich Worcestershire Har Hotzvim Technology Park
Tel +1 (201) 767 2210 WR9 8DE United Kingdom Jerusalem 91450 Israel
Fax +1 (201) 767 2205 Tel +44 (0) 845 644 3597 Tel +972 (2) 591 1700
Toll-free 1 (888) 769 7876 Fax +44 (0) 845 644 3598 Fax +972 (2) 571 4737
Email infoericomcom Email infoericomcouk Email infoericomcom
PowerTerm WebConnect 29 Getting Started Guide
11 Enter in the Web browser the URL httpltIBM WebSphere
Servergt9080ltContext rootgtEricom portlet The Login dialog appears
12 Login and you will see PowerTerm WebConnect displayed on the list
Step 5 Run the Portlet
1 Restart IBM WebSphere Server
2 Open IBM WebSphere Portal in a browser httpltportal servergt9080ltContext
rootgtEricom portlet
3 Login to IBM WebSphere Server
4 Launch it The Userrsquos applications as defined on PowerTerm WebConnect Server
appear
5 Click an application to launch it
66 PowerTerm WebConnect Server Configuration
bull To enable the Lotus Expeditor to run the PowerTerm WebConnect client the
System Administrator must provide the users with accounts on PowerTerm
WebConnect Server (see the PowerTerm WebConnect Administratorrsquos Manual for
instructions on how to create users groups and connections on the PowerTerm
WebConnect Server)
bull To enable PowerTerm WebConnectrsquos Single Sign-On feature the System
Administrator must create a PowerTerm WebConnect user with the same
username and password as used for the Lotus Expeditor For a managed Lotus
Expeditor the credentials used are the username and password sent to the
managing server For an unmanaged Lotus Expeditor the operation system
username and the Lotus Expeditor password are used as credentials
NOTE If a password is not defined then the Single Sign-On will fail and the user will be
prompted with a login dialog
67 PowerTerm WebConnect Client Configuration
The PowerTerm WebConnect client is configured in webconnectxml located in the config
folder webconnectxml parameters are
url The PowerTerm WebConnect Agent url
server The PowerTerm WebConnect Server address
sso The Single Sign-On feature
dst The local destination for downloading PowerTerm WebConnect
components
PowerTerm WebConnect 30 Getting Started Guide
url
PowerTerm WebConnect components are installed on a Web server Their default url is
Windows Agent
httpltWebServer IPgtWebConnectwindowsptagentcab
Linux Agent
httpltWebServer IPgtWebConnectlinuxix86qterm-wczip
The url parameter must include the first part of the url (which is identical for both Windows
and Linux agents)
The PowerTerm WebConnect client will automatically append the appropriate suffix in
order to create a full accurate url
Example
ltitem key=rdquourlrdquo value=httpadminserverWebConnectgt
server
The computer name or IP address of the PowerTerm WebConnect Server machine
The PowerTerm WebConnect client will log in to this PowerTerm WebConnect Server
display the applications defined on it and run them according to this serverrsquos configuration
Format ltserver IPgt[ltportgt]
where default port is 4000 (can be edited)
Example
ltitem key=rdquoserverrdquo value=rdquoadmin24000rdquogt
sso
Determines whether Single Sign-on will be used to log in to PowerTerm WebConnect
Server Values
bull True (default) the client should automatically log in to the PowerTerm WebConnect
Server using the same credentials as the ones used to log in to the Lotus Expeditor
client
The System Administrator must verify that these credentials can log in to the
PowerTerm WebConnect Server
bull False the user will be prompted with a login dialog or will log in automatically using
previously saved credentials
Example
ltitem key=rdquossordquo value=rdquotruerdquogt
Autologin mode
PowerTerm WebConnect 31 Getting Started Guide
If sso is set to True the user is not prompted for credentials and the login process to
PowerTerm WebConnect Server is done automatically sending the credentials used for the
Lotus Expeditor unless the Lotus Expeditor does not have a password defined (In the
Lotus Expeditor preferences page | Password| Prompt me for a password at start up checkbox)
However if Single Sign-on is not used there are several options regarding Autologin that
can be defined in the PowerTerm WebConnect Preferences page Options
bull Yes
bull No
bull Interactive
bull First time interactive (default) ndash Simplifies the login process to PowerTerm
WebConnect Server In this mode the first time the user logs in to PowerTerm
WebConnect Server he will be prompted for his credentials with the Login dialog
These credentials will be stored in the machine and from then on the login process to
PowerTerm WebConnect Server will be done automatically
1 Open File | Preferences from the Lotus Expeditor and select PowerTerm WebConnect
2 In the Autologin to WebConnect Server section select First Interactive and click OK
3 Start PowerTerm WebConnect Client for Lotus Expeditor If credentials were entered
at least once then the next time the client will connect to PowerTerm WebConnect
Server without prompting for the user name and password
The Administrator must configure the Agent to do nothing when it exits for the
feature to work this way See PowerTerm WebConnect Administratorrsquos Manual for more information about defining Autologin
bull Allow multiple selection ndash Defines whether the user can launch more than one
application at a time (by using the ltCtrlgt or ltShiftgt button while selecting applications)
dst
Defines the path to download PowerTerm WebConnect components on the client machine
The dst parameter can contain macros which are translated by the PowerTerm WebConnect
Client for Lotus Expeditor during runtime The macros should be placed between percent
symbols () for example WebServer
When such a value is defined the PowerTerm WebConnect Client for Lotus Expeditor
substitutes the entire expression for the macrorsquos value
The PowerTerm WebConnect Client for Lotus Expeditor does not support the use
of environment variables as macros
Macros are not case sensitive
Macros supported by PowerTerm WebConnect Client for Lotus Expeditor
Macro name Description
WebServer The name of the Web server
It is obtained from the PowerTerm WebConnect Agent url
PowerTerm WebConnect 32 Getting Started Guide
parameter
Name The name of the clientrsquos CAB or ZIP file eg ldquoptagentrdquo
Display The clientrsquos display name from the version file
Version The clientrsquos version value It is obtained from the version
file
Root The default root location
Windows ldquoCrdquo
LinuxUnix an empty string
OSDir Windows Windowsrsquo installation directory for example
ldquoCWindowsrdquo
Linux an empty string
OSDrive Windows Windowsrsquo installation drive for example ldquoCrdquo
Linux an empty string
HomePath Windows The HOMEPATH environment variable
Linux The HOME environment variable
Home The Ericom folder in the userrsquos home directory
Windows CDocuments and SettingsltusergtApplication
DataEricom
Linux ltusergtEricom
In addition to the predefined macros listed above the PowerTerm WebConnect client
supports the usage of Java System Properties
Java System Properties available for users on Windows XP SP2
Java System Property Name Value Example
javaversion 150
javavendorurl httpwwwibmcom
javahome CIBMcommonpluginscomibmpvcwctruntim
esj2sewin32x86_150SR2-
20060511rcpeclipsepluginscomibmrcpj2sew
in32x86_150SR2-20060511jre
javavmspecificationversion 10
javavmversion 23
javavmvendor IBM Corporation
javavmname IBM J9 VM
PowerTerm WebConnect 33 Getting Started Guide
javaiotmpdir CDOCUME~1dianaLOCALS~1Temp
javacompiler j9jit23
javaextdirs CIBMcommonpluginscomibmpvcwctruntim
esj2sewin32x86_150SR2-
20060511rcpeclipsepluginscomibmrcpj2sew
in32x86_150SR2-20060511jrelibext
osname Windows XP
osarch x86
osversion 51 build 2600 Service Pack 2
pathseparator
username Jone
userhome CDocuments and SettingsJone
userdir CIBMRSA
usertimezone GMT+0200
System properties available for users on Linux RedHat 9
Java System Property Name Value Example
javaversion 150
javavendorurl httpwwwibmcom
javahome usrjavajre150_07
javavmversion 150
javavmvendor IBM Corporation
javavmname IBM J9 VM
javaclasspath
javalibrarypath
javaiotmpdir tmp
javacompiler
javaextdirs
osname Linux
osarch i386
osversion 2420-8
pathseparator
PowerTerm WebConnect 34 Getting Started Guide
username root
userhome root
userdir root
System properties names are placed in the configuration file within percent symbols ()
(like macros)
671 Configure the PowerTerm WebConnect Client
1 Open the Config Folder and edit the webconnectxml file Example
ltxml version =rdquo10rdquo encoding=rdquoUTF-8rdquogt
ltsection name=rdquoparametersrdquogt
ltitem key=rdquourlrdquo value=httpadminserverWebConnect56gt
ltitem key=rdquoserverrdquo value=rdquoadmin24000rdquogt
ltitem key=rdquossordquo value=rdquotruerdquogt
ltitem key=rdquodestrdquo value=rdquoCProgram FilesEricomrdquogt
ltsectiongt
2 Save the customized webconnectxml to a Web server folder available to all users It is
recommended to use the same Web server as the PowerTerm WebConnect Agent
Example
ltWebConnect installation foldergtwebwebconnectxml
3 Test the accessibility to this file - Type the URL of webconnectxml in the browser
Example
httpltWebServer IPgtWebConnectwebconnectxml
The contents of the file should be displayed
672 Configure the Preferences File
1 Open the plugins folder and open the PowerTermWebConnectClient_560365jar file
You can use Winzip version 70 and up or in Windows XP ndash Create a new file type for the
jar extension click advanced and select compressed (zipped) folder in the drop down list
Now you can open the JAR files in the Windows Explorer
The default contents of the file
configURL=httpleericomcomWebConnectwebconnectxml
2 Specify the accurate URL of the webconnectxml file Example
httpltWebServer IPgtWebConnectwebconnectxml
3 Save the file and close it The WinZip will display the following dialog
ldquoFile preferencesini has been changed since it was extracted Update archive
with this filerdquo
PowerTerm WebConnect 35 Getting Started Guide
4 Click Yes and close the archive
If you are editing the file from within the explorer you will have to save the file elsewhere
and then drag it to the explorer window where the JAR file is open
68 Installing PowerTerm WebConnect Client on Lotus Expeditor
1 Start the Lotus Expeditor client
2 Select File | Application | Install
3 Select Search for new features to install and click Next
4 Select Add Folder Location and type or select the location of the update site folder from
the provided package Click OK
5 Select the location you have just created and click Finish
6 In the Select the feature to install tree select Powerterm WebConnectUpdate Site Click
Next
7 Select I accept the terms in the license agreements and click Next
8 Click Finish
9 When prompted restart the platform
69 Running PowerTerm WebConnect Client for Lotus Expeditor
1 Click Open The PowerTerm WebConnect option is displayed
2 Select PowerTerm WebConnect The application will automatically connect and start
downloading the components from PowerTerm WebConnect Server
IMPORTANT
If you did not install PowerTerm WebConnect Server and are instead connecting to Ericom
Softwarersquos Demo WebConnect Server then you need to open port 443 in the firewall
691 PowerTerm WebConnect Client Workflow
1 PowerTerm WebConnect client reads the URL of webconnectxml from the preferencesini
file and requests it
2 When the webconnectxml is successfully downloaded the application reads the
configuration connects to the specified Web server downloads the PowerTerm
WebConnect components and connects to the PowerTerm WebConnect Server
3 The user is requested to login to the PowerTerm WebConnect Server For testing you
can use the username Example and password example
This step will be skipped if Single Sign-on is set to ldquotruerdquo
PowerTerm WebConnect 36 Getting Started Guide
4 After logging in to PowerTerm WebConnect Server the userrsquos applications are displayed
as defined by the administrator
5 To run an application select the desired application from the list and click Launch or
double-click the application The application will be launched in a separate window
610 Troubleshooting
When you encounter a problem the first step is to open the log file This file is located on
the client machine in the Ericom folder
Windows
CDocuments and SettingsltusernamegtEricomleclientEricomPluginlog
Linux
ltuser-home-directorygtEricomleclientEricomPluginlog
Following is a guide for diagnosing and fixing the problems in cases of error messages and
additional information
Error
Message
Solution
Version File
reading error
1 Check the lsquourlrsquo parameter in the webconnectxml file on the Web
server The value should be
httpltWebServerIPgtWebConnect
2 Try to run the following URL on the browser
Windows
httpltWebServerIPgtWebConnectwindowsptagentvertxt
Linux
httpltWebServerIPgtWebConnectlinuxix86qterm-
wcvertxt
The file contents displayed in the browser window should be in
the following form
560-rel14546
PowerTerm WebConnect Application Zone
560 - Main Release
ltrootgtPowerTerm WebConnect 56ltWebServergt
If the version file contents are not as shown check
- Is the Web Server running
- Are PowerTerm WebConnect Web Components and version files
PowerTerm WebConnect 37 Getting Started Guide
in place
3 On the Web server check ltPowerTerm WebConnect
rootgtwebwindowsptagentvertxt If the contents ldquolook wrongrdquo or
not in the proper form reinstall the PowerTerm WebConnect Web
components
4 On the client machine open the aforementioned URL in the
browser The file content should appear in the browser If it does
not it could be that the Web server is down
Web Server is
shut down
The webconnectxml configuration file must be located on the Web
server The explicit URL to this file is defined in the preferencesini
file (see Configure the Preferences File)
The error message contains the IP address of the Web server
Verify that the Web server on this machine is running
Version file
does not exist
on ltURLgt
See Version File reading error
The
configuration
file is not
accessible or
has a wrong
format
The webconnectxml configuration file must be located on the Web
server and the explicit URL to the configuration must be defined in
the preferencesini file (see Configure the Preferences File)
Try to open the URL specified in the error message in the
browser If it does not open then it either does not exist or it has
a wrong format
Preferences
file does not
exist in the
application
bundle
The preferencesini file containing the URL to the configuration
file was removed from the update site folder
Uninstall the current PowerTerm WebConnect client from the
client machine Create a new customized package (see
PowerTerm WebConnect Client Configuration) and reinstall it
Configuration
file URL is not
defined in
preference
file
The URL to the configuration file does not appear in the
preferencesini file (see Configure the Preferences File)
Uninstall the current PowerTerm WebConnect client from the
client machine Create a new customized package (see
PowerTerm WebConnect Client Configuration) and reinstall it
No IP address
could be
found for the
host
The Web server URL specified in the preferencesini file (see
Configure the Preferences File) or in the webconnectxml file (see
Configure the PowerTerm WebConnect Client) is an unknown
host
If the mistake is in the preferencesini file uninstall the current
PowerTerm WebConnect client from the client machine Create a
new customized package (see PowerTerm WebConnect Client
Configuration) and reinstall it
PowerTerm WebConnect 38 Getting Started Guide
If the mistake is in the webconnectxml file correct the file reopen
the Lotus Expeditor client
Cannot write
to destination
The temporary file cannot be written to the defined destination
Check the write permissions
Copied
configuration
file has wrong
format
The webconnectxml file as received from the specified URL has a
wrong format Correct the file and try again
PowerTerm
WebConnect
Agent URL is
malformed
The PowerTerm WebConnect Agent URL specified in the
webconnectxml file (see Configure the PowerTerm WebConnect
Client) does not have a proper HTTP format Correct the file and
try again
PowerTerm
WebConnect
Agent URL is
not defined
The PowerTerm WebConnect Agent URL parameter is not specified
in the webconnectxml file (see Configure the PowerTerm
WebConnect Client)
Correct the file and try again
The specified
destination
folder name
is wrong
The destination folder name contains illegal characters
ltgt|
Check the dst parameter in the webconnectxml file Correct the
file and try again
You do not
have
permissions
to write to
ltpathgt
The PowerTerm WebConnect Agent cannot be written to the
destination as defined Check the write permissions
The default destination defined in the version file should not to
be changed
A customized destination for PowerTerm WebConnect Agent
downloading can be defined in the webconnectxml file (See
Configure the PowerTerm WebConnect Client)
Check the destination value correct and try again
PowerTerm WebConnect 39 Getting Started Guide
About Ericom
Ericomreg Software is a leading provider of Application Access and Virtualization Solutions
Since 1993 Ericom has been helping users access enterprise mission-critical applications
running on a broad range of Microsoftreg Windowsreg Terminal Servers virtual Desktops
Blade PCs legacy hosts and other systems Ericom provides concrete business value by
helping organizations realize the benefits of their IT investments With offices in the United
States United Kingdom EMEA India and China Ericom also has an extensive network of
distributors and partners throughout North America Europe Asia and the Far East Our
expanding customer base is more than 30 thousand strong with over 7 million
installations
For more information on our products and services contact us at the location nearest to you
And visit our web site httpwwwericomcom
North America Western Europe International
Ericom Software Inc Ericom Software (UK) Ltd Ericom Software Ltd
231 Herbert Avenue Bldg 4 11a Victoria Square 8 Hamarpeh Street
Closter NJ 07624 USA Droitwich Worcestershire Har Hotzvim Technology Park
Tel +1 (201) 767 2210 WR9 8DE United Kingdom Jerusalem 91450 Israel
Fax +1 (201) 767 2205 Tel +44 (0) 845 644 3597 Tel +972 (2) 591 1700
Toll-free 1 (888) 769 7876 Fax +44 (0) 845 644 3598 Fax +972 (2) 571 4737
Email infoericomcom Email infoericomcouk Email infoericomcom
PowerTerm WebConnect 30 Getting Started Guide
url
PowerTerm WebConnect components are installed on a Web server Their default url is
Windows Agent
httpltWebServer IPgtWebConnectwindowsptagentcab
Linux Agent
httpltWebServer IPgtWebConnectlinuxix86qterm-wczip
The url parameter must include the first part of the url (which is identical for both Windows
and Linux agents)
The PowerTerm WebConnect client will automatically append the appropriate suffix in
order to create a full accurate url
Example
ltitem key=rdquourlrdquo value=httpadminserverWebConnectgt
server
The computer name or IP address of the PowerTerm WebConnect Server machine
The PowerTerm WebConnect client will log in to this PowerTerm WebConnect Server
display the applications defined on it and run them according to this serverrsquos configuration
Format ltserver IPgt[ltportgt]
where default port is 4000 (can be edited)
Example
ltitem key=rdquoserverrdquo value=rdquoadmin24000rdquogt
sso
Determines whether Single Sign-on will be used to log in to PowerTerm WebConnect
Server Values
bull True (default) the client should automatically log in to the PowerTerm WebConnect
Server using the same credentials as the ones used to log in to the Lotus Expeditor
client
The System Administrator must verify that these credentials can log in to the
PowerTerm WebConnect Server
bull False the user will be prompted with a login dialog or will log in automatically using
previously saved credentials
Example
ltitem key=rdquossordquo value=rdquotruerdquogt
Autologin mode
PowerTerm WebConnect 31 Getting Started Guide
If sso is set to True the user is not prompted for credentials and the login process to
PowerTerm WebConnect Server is done automatically sending the credentials used for the
Lotus Expeditor unless the Lotus Expeditor does not have a password defined (In the
Lotus Expeditor preferences page | Password| Prompt me for a password at start up checkbox)
However if Single Sign-on is not used there are several options regarding Autologin that
can be defined in the PowerTerm WebConnect Preferences page Options
bull Yes
bull No
bull Interactive
bull First time interactive (default) ndash Simplifies the login process to PowerTerm
WebConnect Server In this mode the first time the user logs in to PowerTerm
WebConnect Server he will be prompted for his credentials with the Login dialog
These credentials will be stored in the machine and from then on the login process to
PowerTerm WebConnect Server will be done automatically
1 Open File | Preferences from the Lotus Expeditor and select PowerTerm WebConnect
2 In the Autologin to WebConnect Server section select First Interactive and click OK
3 Start PowerTerm WebConnect Client for Lotus Expeditor If credentials were entered
at least once then the next time the client will connect to PowerTerm WebConnect
Server without prompting for the user name and password
The Administrator must configure the Agent to do nothing when it exits for the
feature to work this way See PowerTerm WebConnect Administratorrsquos Manual for more information about defining Autologin
bull Allow multiple selection ndash Defines whether the user can launch more than one
application at a time (by using the ltCtrlgt or ltShiftgt button while selecting applications)
dst
Defines the path to download PowerTerm WebConnect components on the client machine
The dst parameter can contain macros which are translated by the PowerTerm WebConnect
Client for Lotus Expeditor during runtime The macros should be placed between percent
symbols () for example WebServer
When such a value is defined the PowerTerm WebConnect Client for Lotus Expeditor
substitutes the entire expression for the macrorsquos value
The PowerTerm WebConnect Client for Lotus Expeditor does not support the use
of environment variables as macros
Macros are not case sensitive
Macros supported by PowerTerm WebConnect Client for Lotus Expeditor
Macro name Description
WebServer The name of the Web server
It is obtained from the PowerTerm WebConnect Agent url
PowerTerm WebConnect 32 Getting Started Guide
parameter
Name The name of the clientrsquos CAB or ZIP file eg ldquoptagentrdquo
Display The clientrsquos display name from the version file
Version The clientrsquos version value It is obtained from the version
file
Root The default root location
Windows ldquoCrdquo
LinuxUnix an empty string
OSDir Windows Windowsrsquo installation directory for example
ldquoCWindowsrdquo
Linux an empty string
OSDrive Windows Windowsrsquo installation drive for example ldquoCrdquo
Linux an empty string
HomePath Windows The HOMEPATH environment variable
Linux The HOME environment variable
Home The Ericom folder in the userrsquos home directory
Windows CDocuments and SettingsltusergtApplication
DataEricom
Linux ltusergtEricom
In addition to the predefined macros listed above the PowerTerm WebConnect client
supports the usage of Java System Properties
Java System Properties available for users on Windows XP SP2
Java System Property Name Value Example
javaversion 150
javavendorurl httpwwwibmcom
javahome CIBMcommonpluginscomibmpvcwctruntim
esj2sewin32x86_150SR2-
20060511rcpeclipsepluginscomibmrcpj2sew
in32x86_150SR2-20060511jre
javavmspecificationversion 10
javavmversion 23
javavmvendor IBM Corporation
javavmname IBM J9 VM
PowerTerm WebConnect 33 Getting Started Guide
javaiotmpdir CDOCUME~1dianaLOCALS~1Temp
javacompiler j9jit23
javaextdirs CIBMcommonpluginscomibmpvcwctruntim
esj2sewin32x86_150SR2-
20060511rcpeclipsepluginscomibmrcpj2sew
in32x86_150SR2-20060511jrelibext
osname Windows XP
osarch x86
osversion 51 build 2600 Service Pack 2
pathseparator
username Jone
userhome CDocuments and SettingsJone
userdir CIBMRSA
usertimezone GMT+0200
System properties available for users on Linux RedHat 9
Java System Property Name Value Example
javaversion 150
javavendorurl httpwwwibmcom
javahome usrjavajre150_07
javavmversion 150
javavmvendor IBM Corporation
javavmname IBM J9 VM
javaclasspath
javalibrarypath
javaiotmpdir tmp
javacompiler
javaextdirs
osname Linux
osarch i386
osversion 2420-8
pathseparator
PowerTerm WebConnect 34 Getting Started Guide
username root
userhome root
userdir root
System properties names are placed in the configuration file within percent symbols ()
(like macros)
671 Configure the PowerTerm WebConnect Client
1 Open the Config Folder and edit the webconnectxml file Example
ltxml version =rdquo10rdquo encoding=rdquoUTF-8rdquogt
ltsection name=rdquoparametersrdquogt
ltitem key=rdquourlrdquo value=httpadminserverWebConnect56gt
ltitem key=rdquoserverrdquo value=rdquoadmin24000rdquogt
ltitem key=rdquossordquo value=rdquotruerdquogt
ltitem key=rdquodestrdquo value=rdquoCProgram FilesEricomrdquogt
ltsectiongt
2 Save the customized webconnectxml to a Web server folder available to all users It is
recommended to use the same Web server as the PowerTerm WebConnect Agent
Example
ltWebConnect installation foldergtwebwebconnectxml
3 Test the accessibility to this file - Type the URL of webconnectxml in the browser
Example
httpltWebServer IPgtWebConnectwebconnectxml
The contents of the file should be displayed
672 Configure the Preferences File
1 Open the plugins folder and open the PowerTermWebConnectClient_560365jar file
You can use Winzip version 70 and up or in Windows XP ndash Create a new file type for the
jar extension click advanced and select compressed (zipped) folder in the drop down list
Now you can open the JAR files in the Windows Explorer
The default contents of the file
configURL=httpleericomcomWebConnectwebconnectxml
2 Specify the accurate URL of the webconnectxml file Example
httpltWebServer IPgtWebConnectwebconnectxml
3 Save the file and close it The WinZip will display the following dialog
ldquoFile preferencesini has been changed since it was extracted Update archive
with this filerdquo
PowerTerm WebConnect 35 Getting Started Guide
4 Click Yes and close the archive
If you are editing the file from within the explorer you will have to save the file elsewhere
and then drag it to the explorer window where the JAR file is open
68 Installing PowerTerm WebConnect Client on Lotus Expeditor
1 Start the Lotus Expeditor client
2 Select File | Application | Install
3 Select Search for new features to install and click Next
4 Select Add Folder Location and type or select the location of the update site folder from
the provided package Click OK
5 Select the location you have just created and click Finish
6 In the Select the feature to install tree select Powerterm WebConnectUpdate Site Click
Next
7 Select I accept the terms in the license agreements and click Next
8 Click Finish
9 When prompted restart the platform
69 Running PowerTerm WebConnect Client for Lotus Expeditor
1 Click Open The PowerTerm WebConnect option is displayed
2 Select PowerTerm WebConnect The application will automatically connect and start
downloading the components from PowerTerm WebConnect Server
IMPORTANT
If you did not install PowerTerm WebConnect Server and are instead connecting to Ericom
Softwarersquos Demo WebConnect Server then you need to open port 443 in the firewall
691 PowerTerm WebConnect Client Workflow
1 PowerTerm WebConnect client reads the URL of webconnectxml from the preferencesini
file and requests it
2 When the webconnectxml is successfully downloaded the application reads the
configuration connects to the specified Web server downloads the PowerTerm
WebConnect components and connects to the PowerTerm WebConnect Server
3 The user is requested to login to the PowerTerm WebConnect Server For testing you
can use the username Example and password example
This step will be skipped if Single Sign-on is set to ldquotruerdquo
PowerTerm WebConnect 36 Getting Started Guide
4 After logging in to PowerTerm WebConnect Server the userrsquos applications are displayed
as defined by the administrator
5 To run an application select the desired application from the list and click Launch or
double-click the application The application will be launched in a separate window
610 Troubleshooting
When you encounter a problem the first step is to open the log file This file is located on
the client machine in the Ericom folder
Windows
CDocuments and SettingsltusernamegtEricomleclientEricomPluginlog
Linux
ltuser-home-directorygtEricomleclientEricomPluginlog
Following is a guide for diagnosing and fixing the problems in cases of error messages and
additional information
Error
Message
Solution
Version File
reading error
1 Check the lsquourlrsquo parameter in the webconnectxml file on the Web
server The value should be
httpltWebServerIPgtWebConnect
2 Try to run the following URL on the browser
Windows
httpltWebServerIPgtWebConnectwindowsptagentvertxt
Linux
httpltWebServerIPgtWebConnectlinuxix86qterm-
wcvertxt
The file contents displayed in the browser window should be in
the following form
560-rel14546
PowerTerm WebConnect Application Zone
560 - Main Release
ltrootgtPowerTerm WebConnect 56ltWebServergt
If the version file contents are not as shown check
- Is the Web Server running
- Are PowerTerm WebConnect Web Components and version files
PowerTerm WebConnect 37 Getting Started Guide
in place
3 On the Web server check ltPowerTerm WebConnect
rootgtwebwindowsptagentvertxt If the contents ldquolook wrongrdquo or
not in the proper form reinstall the PowerTerm WebConnect Web
components
4 On the client machine open the aforementioned URL in the
browser The file content should appear in the browser If it does
not it could be that the Web server is down
Web Server is
shut down
The webconnectxml configuration file must be located on the Web
server The explicit URL to this file is defined in the preferencesini
file (see Configure the Preferences File)
The error message contains the IP address of the Web server
Verify that the Web server on this machine is running
Version file
does not exist
on ltURLgt
See Version File reading error
The
configuration
file is not
accessible or
has a wrong
format
The webconnectxml configuration file must be located on the Web
server and the explicit URL to the configuration must be defined in
the preferencesini file (see Configure the Preferences File)
Try to open the URL specified in the error message in the
browser If it does not open then it either does not exist or it has
a wrong format
Preferences
file does not
exist in the
application
bundle
The preferencesini file containing the URL to the configuration
file was removed from the update site folder
Uninstall the current PowerTerm WebConnect client from the
client machine Create a new customized package (see
PowerTerm WebConnect Client Configuration) and reinstall it
Configuration
file URL is not
defined in
preference
file
The URL to the configuration file does not appear in the
preferencesini file (see Configure the Preferences File)
Uninstall the current PowerTerm WebConnect client from the
client machine Create a new customized package (see
PowerTerm WebConnect Client Configuration) and reinstall it
No IP address
could be
found for the
host
The Web server URL specified in the preferencesini file (see
Configure the Preferences File) or in the webconnectxml file (see
Configure the PowerTerm WebConnect Client) is an unknown
host
If the mistake is in the preferencesini file uninstall the current
PowerTerm WebConnect client from the client machine Create a
new customized package (see PowerTerm WebConnect Client
Configuration) and reinstall it
PowerTerm WebConnect 38 Getting Started Guide
If the mistake is in the webconnectxml file correct the file reopen
the Lotus Expeditor client
Cannot write
to destination
The temporary file cannot be written to the defined destination
Check the write permissions
Copied
configuration
file has wrong
format
The webconnectxml file as received from the specified URL has a
wrong format Correct the file and try again
PowerTerm
WebConnect
Agent URL is
malformed
The PowerTerm WebConnect Agent URL specified in the
webconnectxml file (see Configure the PowerTerm WebConnect
Client) does not have a proper HTTP format Correct the file and
try again
PowerTerm
WebConnect
Agent URL is
not defined
The PowerTerm WebConnect Agent URL parameter is not specified
in the webconnectxml file (see Configure the PowerTerm
WebConnect Client)
Correct the file and try again
The specified
destination
folder name
is wrong
The destination folder name contains illegal characters
ltgt|
Check the dst parameter in the webconnectxml file Correct the
file and try again
You do not
have
permissions
to write to
ltpathgt
The PowerTerm WebConnect Agent cannot be written to the
destination as defined Check the write permissions
The default destination defined in the version file should not to
be changed
A customized destination for PowerTerm WebConnect Agent
downloading can be defined in the webconnectxml file (See
Configure the PowerTerm WebConnect Client)
Check the destination value correct and try again
PowerTerm WebConnect 39 Getting Started Guide
About Ericom
Ericomreg Software is a leading provider of Application Access and Virtualization Solutions
Since 1993 Ericom has been helping users access enterprise mission-critical applications
running on a broad range of Microsoftreg Windowsreg Terminal Servers virtual Desktops
Blade PCs legacy hosts and other systems Ericom provides concrete business value by
helping organizations realize the benefits of their IT investments With offices in the United
States United Kingdom EMEA India and China Ericom also has an extensive network of
distributors and partners throughout North America Europe Asia and the Far East Our
expanding customer base is more than 30 thousand strong with over 7 million
installations
For more information on our products and services contact us at the location nearest to you
And visit our web site httpwwwericomcom
North America Western Europe International
Ericom Software Inc Ericom Software (UK) Ltd Ericom Software Ltd
231 Herbert Avenue Bldg 4 11a Victoria Square 8 Hamarpeh Street
Closter NJ 07624 USA Droitwich Worcestershire Har Hotzvim Technology Park
Tel +1 (201) 767 2210 WR9 8DE United Kingdom Jerusalem 91450 Israel
Fax +1 (201) 767 2205 Tel +44 (0) 845 644 3597 Tel +972 (2) 591 1700
Toll-free 1 (888) 769 7876 Fax +44 (0) 845 644 3598 Fax +972 (2) 571 4737
Email infoericomcom Email infoericomcouk Email infoericomcom
PowerTerm WebConnect 31 Getting Started Guide
If sso is set to True the user is not prompted for credentials and the login process to
PowerTerm WebConnect Server is done automatically sending the credentials used for the
Lotus Expeditor unless the Lotus Expeditor does not have a password defined (In the
Lotus Expeditor preferences page | Password| Prompt me for a password at start up checkbox)
However if Single Sign-on is not used there are several options regarding Autologin that
can be defined in the PowerTerm WebConnect Preferences page Options
bull Yes
bull No
bull Interactive
bull First time interactive (default) ndash Simplifies the login process to PowerTerm
WebConnect Server In this mode the first time the user logs in to PowerTerm
WebConnect Server he will be prompted for his credentials with the Login dialog
These credentials will be stored in the machine and from then on the login process to
PowerTerm WebConnect Server will be done automatically
1 Open File | Preferences from the Lotus Expeditor and select PowerTerm WebConnect
2 In the Autologin to WebConnect Server section select First Interactive and click OK
3 Start PowerTerm WebConnect Client for Lotus Expeditor If credentials were entered
at least once then the next time the client will connect to PowerTerm WebConnect
Server without prompting for the user name and password
The Administrator must configure the Agent to do nothing when it exits for the
feature to work this way See PowerTerm WebConnect Administratorrsquos Manual for more information about defining Autologin
bull Allow multiple selection ndash Defines whether the user can launch more than one
application at a time (by using the ltCtrlgt or ltShiftgt button while selecting applications)
dst
Defines the path to download PowerTerm WebConnect components on the client machine
The dst parameter can contain macros which are translated by the PowerTerm WebConnect
Client for Lotus Expeditor during runtime The macros should be placed between percent
symbols () for example WebServer
When such a value is defined the PowerTerm WebConnect Client for Lotus Expeditor
substitutes the entire expression for the macrorsquos value
The PowerTerm WebConnect Client for Lotus Expeditor does not support the use
of environment variables as macros
Macros are not case sensitive
Macros supported by PowerTerm WebConnect Client for Lotus Expeditor
Macro name Description
WebServer The name of the Web server
It is obtained from the PowerTerm WebConnect Agent url
PowerTerm WebConnect 32 Getting Started Guide
parameter
Name The name of the clientrsquos CAB or ZIP file eg ldquoptagentrdquo
Display The clientrsquos display name from the version file
Version The clientrsquos version value It is obtained from the version
file
Root The default root location
Windows ldquoCrdquo
LinuxUnix an empty string
OSDir Windows Windowsrsquo installation directory for example
ldquoCWindowsrdquo
Linux an empty string
OSDrive Windows Windowsrsquo installation drive for example ldquoCrdquo
Linux an empty string
HomePath Windows The HOMEPATH environment variable
Linux The HOME environment variable
Home The Ericom folder in the userrsquos home directory
Windows CDocuments and SettingsltusergtApplication
DataEricom
Linux ltusergtEricom
In addition to the predefined macros listed above the PowerTerm WebConnect client
supports the usage of Java System Properties
Java System Properties available for users on Windows XP SP2
Java System Property Name Value Example
javaversion 150
javavendorurl httpwwwibmcom
javahome CIBMcommonpluginscomibmpvcwctruntim
esj2sewin32x86_150SR2-
20060511rcpeclipsepluginscomibmrcpj2sew
in32x86_150SR2-20060511jre
javavmspecificationversion 10
javavmversion 23
javavmvendor IBM Corporation
javavmname IBM J9 VM
PowerTerm WebConnect 33 Getting Started Guide
javaiotmpdir CDOCUME~1dianaLOCALS~1Temp
javacompiler j9jit23
javaextdirs CIBMcommonpluginscomibmpvcwctruntim
esj2sewin32x86_150SR2-
20060511rcpeclipsepluginscomibmrcpj2sew
in32x86_150SR2-20060511jrelibext
osname Windows XP
osarch x86
osversion 51 build 2600 Service Pack 2
pathseparator
username Jone
userhome CDocuments and SettingsJone
userdir CIBMRSA
usertimezone GMT+0200
System properties available for users on Linux RedHat 9
Java System Property Name Value Example
javaversion 150
javavendorurl httpwwwibmcom
javahome usrjavajre150_07
javavmversion 150
javavmvendor IBM Corporation
javavmname IBM J9 VM
javaclasspath
javalibrarypath
javaiotmpdir tmp
javacompiler
javaextdirs
osname Linux
osarch i386
osversion 2420-8
pathseparator
PowerTerm WebConnect 34 Getting Started Guide
username root
userhome root
userdir root
System properties names are placed in the configuration file within percent symbols ()
(like macros)
671 Configure the PowerTerm WebConnect Client
1 Open the Config Folder and edit the webconnectxml file Example
ltxml version =rdquo10rdquo encoding=rdquoUTF-8rdquogt
ltsection name=rdquoparametersrdquogt
ltitem key=rdquourlrdquo value=httpadminserverWebConnect56gt
ltitem key=rdquoserverrdquo value=rdquoadmin24000rdquogt
ltitem key=rdquossordquo value=rdquotruerdquogt
ltitem key=rdquodestrdquo value=rdquoCProgram FilesEricomrdquogt
ltsectiongt
2 Save the customized webconnectxml to a Web server folder available to all users It is
recommended to use the same Web server as the PowerTerm WebConnect Agent
Example
ltWebConnect installation foldergtwebwebconnectxml
3 Test the accessibility to this file - Type the URL of webconnectxml in the browser
Example
httpltWebServer IPgtWebConnectwebconnectxml
The contents of the file should be displayed
672 Configure the Preferences File
1 Open the plugins folder and open the PowerTermWebConnectClient_560365jar file
You can use Winzip version 70 and up or in Windows XP ndash Create a new file type for the
jar extension click advanced and select compressed (zipped) folder in the drop down list
Now you can open the JAR files in the Windows Explorer
The default contents of the file
configURL=httpleericomcomWebConnectwebconnectxml
2 Specify the accurate URL of the webconnectxml file Example
httpltWebServer IPgtWebConnectwebconnectxml
3 Save the file and close it The WinZip will display the following dialog
ldquoFile preferencesini has been changed since it was extracted Update archive
with this filerdquo
PowerTerm WebConnect 35 Getting Started Guide
4 Click Yes and close the archive
If you are editing the file from within the explorer you will have to save the file elsewhere
and then drag it to the explorer window where the JAR file is open
68 Installing PowerTerm WebConnect Client on Lotus Expeditor
1 Start the Lotus Expeditor client
2 Select File | Application | Install
3 Select Search for new features to install and click Next
4 Select Add Folder Location and type or select the location of the update site folder from
the provided package Click OK
5 Select the location you have just created and click Finish
6 In the Select the feature to install tree select Powerterm WebConnectUpdate Site Click
Next
7 Select I accept the terms in the license agreements and click Next
8 Click Finish
9 When prompted restart the platform
69 Running PowerTerm WebConnect Client for Lotus Expeditor
1 Click Open The PowerTerm WebConnect option is displayed
2 Select PowerTerm WebConnect The application will automatically connect and start
downloading the components from PowerTerm WebConnect Server
IMPORTANT
If you did not install PowerTerm WebConnect Server and are instead connecting to Ericom
Softwarersquos Demo WebConnect Server then you need to open port 443 in the firewall
691 PowerTerm WebConnect Client Workflow
1 PowerTerm WebConnect client reads the URL of webconnectxml from the preferencesini
file and requests it
2 When the webconnectxml is successfully downloaded the application reads the
configuration connects to the specified Web server downloads the PowerTerm
WebConnect components and connects to the PowerTerm WebConnect Server
3 The user is requested to login to the PowerTerm WebConnect Server For testing you
can use the username Example and password example
This step will be skipped if Single Sign-on is set to ldquotruerdquo
PowerTerm WebConnect 36 Getting Started Guide
4 After logging in to PowerTerm WebConnect Server the userrsquos applications are displayed
as defined by the administrator
5 To run an application select the desired application from the list and click Launch or
double-click the application The application will be launched in a separate window
610 Troubleshooting
When you encounter a problem the first step is to open the log file This file is located on
the client machine in the Ericom folder
Windows
CDocuments and SettingsltusernamegtEricomleclientEricomPluginlog
Linux
ltuser-home-directorygtEricomleclientEricomPluginlog
Following is a guide for diagnosing and fixing the problems in cases of error messages and
additional information
Error
Message
Solution
Version File
reading error
1 Check the lsquourlrsquo parameter in the webconnectxml file on the Web
server The value should be
httpltWebServerIPgtWebConnect
2 Try to run the following URL on the browser
Windows
httpltWebServerIPgtWebConnectwindowsptagentvertxt
Linux
httpltWebServerIPgtWebConnectlinuxix86qterm-
wcvertxt
The file contents displayed in the browser window should be in
the following form
560-rel14546
PowerTerm WebConnect Application Zone
560 - Main Release
ltrootgtPowerTerm WebConnect 56ltWebServergt
If the version file contents are not as shown check
- Is the Web Server running
- Are PowerTerm WebConnect Web Components and version files
PowerTerm WebConnect 37 Getting Started Guide
in place
3 On the Web server check ltPowerTerm WebConnect
rootgtwebwindowsptagentvertxt If the contents ldquolook wrongrdquo or
not in the proper form reinstall the PowerTerm WebConnect Web
components
4 On the client machine open the aforementioned URL in the
browser The file content should appear in the browser If it does
not it could be that the Web server is down
Web Server is
shut down
The webconnectxml configuration file must be located on the Web
server The explicit URL to this file is defined in the preferencesini
file (see Configure the Preferences File)
The error message contains the IP address of the Web server
Verify that the Web server on this machine is running
Version file
does not exist
on ltURLgt
See Version File reading error
The
configuration
file is not
accessible or
has a wrong
format
The webconnectxml configuration file must be located on the Web
server and the explicit URL to the configuration must be defined in
the preferencesini file (see Configure the Preferences File)
Try to open the URL specified in the error message in the
browser If it does not open then it either does not exist or it has
a wrong format
Preferences
file does not
exist in the
application
bundle
The preferencesini file containing the URL to the configuration
file was removed from the update site folder
Uninstall the current PowerTerm WebConnect client from the
client machine Create a new customized package (see
PowerTerm WebConnect Client Configuration) and reinstall it
Configuration
file URL is not
defined in
preference
file
The URL to the configuration file does not appear in the
preferencesini file (see Configure the Preferences File)
Uninstall the current PowerTerm WebConnect client from the
client machine Create a new customized package (see
PowerTerm WebConnect Client Configuration) and reinstall it
No IP address
could be
found for the
host
The Web server URL specified in the preferencesini file (see
Configure the Preferences File) or in the webconnectxml file (see
Configure the PowerTerm WebConnect Client) is an unknown
host
If the mistake is in the preferencesini file uninstall the current
PowerTerm WebConnect client from the client machine Create a
new customized package (see PowerTerm WebConnect Client
Configuration) and reinstall it
PowerTerm WebConnect 38 Getting Started Guide
If the mistake is in the webconnectxml file correct the file reopen
the Lotus Expeditor client
Cannot write
to destination
The temporary file cannot be written to the defined destination
Check the write permissions
Copied
configuration
file has wrong
format
The webconnectxml file as received from the specified URL has a
wrong format Correct the file and try again
PowerTerm
WebConnect
Agent URL is
malformed
The PowerTerm WebConnect Agent URL specified in the
webconnectxml file (see Configure the PowerTerm WebConnect
Client) does not have a proper HTTP format Correct the file and
try again
PowerTerm
WebConnect
Agent URL is
not defined
The PowerTerm WebConnect Agent URL parameter is not specified
in the webconnectxml file (see Configure the PowerTerm
WebConnect Client)
Correct the file and try again
The specified
destination
folder name
is wrong
The destination folder name contains illegal characters
ltgt|
Check the dst parameter in the webconnectxml file Correct the
file and try again
You do not
have
permissions
to write to
ltpathgt
The PowerTerm WebConnect Agent cannot be written to the
destination as defined Check the write permissions
The default destination defined in the version file should not to
be changed
A customized destination for PowerTerm WebConnect Agent
downloading can be defined in the webconnectxml file (See
Configure the PowerTerm WebConnect Client)
Check the destination value correct and try again
PowerTerm WebConnect 39 Getting Started Guide
About Ericom
Ericomreg Software is a leading provider of Application Access and Virtualization Solutions
Since 1993 Ericom has been helping users access enterprise mission-critical applications
running on a broad range of Microsoftreg Windowsreg Terminal Servers virtual Desktops
Blade PCs legacy hosts and other systems Ericom provides concrete business value by
helping organizations realize the benefits of their IT investments With offices in the United
States United Kingdom EMEA India and China Ericom also has an extensive network of
distributors and partners throughout North America Europe Asia and the Far East Our
expanding customer base is more than 30 thousand strong with over 7 million
installations
For more information on our products and services contact us at the location nearest to you
And visit our web site httpwwwericomcom
North America Western Europe International
Ericom Software Inc Ericom Software (UK) Ltd Ericom Software Ltd
231 Herbert Avenue Bldg 4 11a Victoria Square 8 Hamarpeh Street
Closter NJ 07624 USA Droitwich Worcestershire Har Hotzvim Technology Park
Tel +1 (201) 767 2210 WR9 8DE United Kingdom Jerusalem 91450 Israel
Fax +1 (201) 767 2205 Tel +44 (0) 845 644 3597 Tel +972 (2) 591 1700
Toll-free 1 (888) 769 7876 Fax +44 (0) 845 644 3598 Fax +972 (2) 571 4737
Email infoericomcom Email infoericomcouk Email infoericomcom
PowerTerm WebConnect 32 Getting Started Guide
parameter
Name The name of the clientrsquos CAB or ZIP file eg ldquoptagentrdquo
Display The clientrsquos display name from the version file
Version The clientrsquos version value It is obtained from the version
file
Root The default root location
Windows ldquoCrdquo
LinuxUnix an empty string
OSDir Windows Windowsrsquo installation directory for example
ldquoCWindowsrdquo
Linux an empty string
OSDrive Windows Windowsrsquo installation drive for example ldquoCrdquo
Linux an empty string
HomePath Windows The HOMEPATH environment variable
Linux The HOME environment variable
Home The Ericom folder in the userrsquos home directory
Windows CDocuments and SettingsltusergtApplication
DataEricom
Linux ltusergtEricom
In addition to the predefined macros listed above the PowerTerm WebConnect client
supports the usage of Java System Properties
Java System Properties available for users on Windows XP SP2
Java System Property Name Value Example
javaversion 150
javavendorurl httpwwwibmcom
javahome CIBMcommonpluginscomibmpvcwctruntim
esj2sewin32x86_150SR2-
20060511rcpeclipsepluginscomibmrcpj2sew
in32x86_150SR2-20060511jre
javavmspecificationversion 10
javavmversion 23
javavmvendor IBM Corporation
javavmname IBM J9 VM
PowerTerm WebConnect 33 Getting Started Guide
javaiotmpdir CDOCUME~1dianaLOCALS~1Temp
javacompiler j9jit23
javaextdirs CIBMcommonpluginscomibmpvcwctruntim
esj2sewin32x86_150SR2-
20060511rcpeclipsepluginscomibmrcpj2sew
in32x86_150SR2-20060511jrelibext
osname Windows XP
osarch x86
osversion 51 build 2600 Service Pack 2
pathseparator
username Jone
userhome CDocuments and SettingsJone
userdir CIBMRSA
usertimezone GMT+0200
System properties available for users on Linux RedHat 9
Java System Property Name Value Example
javaversion 150
javavendorurl httpwwwibmcom
javahome usrjavajre150_07
javavmversion 150
javavmvendor IBM Corporation
javavmname IBM J9 VM
javaclasspath
javalibrarypath
javaiotmpdir tmp
javacompiler
javaextdirs
osname Linux
osarch i386
osversion 2420-8
pathseparator
PowerTerm WebConnect 34 Getting Started Guide
username root
userhome root
userdir root
System properties names are placed in the configuration file within percent symbols ()
(like macros)
671 Configure the PowerTerm WebConnect Client
1 Open the Config Folder and edit the webconnectxml file Example
ltxml version =rdquo10rdquo encoding=rdquoUTF-8rdquogt
ltsection name=rdquoparametersrdquogt
ltitem key=rdquourlrdquo value=httpadminserverWebConnect56gt
ltitem key=rdquoserverrdquo value=rdquoadmin24000rdquogt
ltitem key=rdquossordquo value=rdquotruerdquogt
ltitem key=rdquodestrdquo value=rdquoCProgram FilesEricomrdquogt
ltsectiongt
2 Save the customized webconnectxml to a Web server folder available to all users It is
recommended to use the same Web server as the PowerTerm WebConnect Agent
Example
ltWebConnect installation foldergtwebwebconnectxml
3 Test the accessibility to this file - Type the URL of webconnectxml in the browser
Example
httpltWebServer IPgtWebConnectwebconnectxml
The contents of the file should be displayed
672 Configure the Preferences File
1 Open the plugins folder and open the PowerTermWebConnectClient_560365jar file
You can use Winzip version 70 and up or in Windows XP ndash Create a new file type for the
jar extension click advanced and select compressed (zipped) folder in the drop down list
Now you can open the JAR files in the Windows Explorer
The default contents of the file
configURL=httpleericomcomWebConnectwebconnectxml
2 Specify the accurate URL of the webconnectxml file Example
httpltWebServer IPgtWebConnectwebconnectxml
3 Save the file and close it The WinZip will display the following dialog
ldquoFile preferencesini has been changed since it was extracted Update archive
with this filerdquo
PowerTerm WebConnect 35 Getting Started Guide
4 Click Yes and close the archive
If you are editing the file from within the explorer you will have to save the file elsewhere
and then drag it to the explorer window where the JAR file is open
68 Installing PowerTerm WebConnect Client on Lotus Expeditor
1 Start the Lotus Expeditor client
2 Select File | Application | Install
3 Select Search for new features to install and click Next
4 Select Add Folder Location and type or select the location of the update site folder from
the provided package Click OK
5 Select the location you have just created and click Finish
6 In the Select the feature to install tree select Powerterm WebConnectUpdate Site Click
Next
7 Select I accept the terms in the license agreements and click Next
8 Click Finish
9 When prompted restart the platform
69 Running PowerTerm WebConnect Client for Lotus Expeditor
1 Click Open The PowerTerm WebConnect option is displayed
2 Select PowerTerm WebConnect The application will automatically connect and start
downloading the components from PowerTerm WebConnect Server
IMPORTANT
If you did not install PowerTerm WebConnect Server and are instead connecting to Ericom
Softwarersquos Demo WebConnect Server then you need to open port 443 in the firewall
691 PowerTerm WebConnect Client Workflow
1 PowerTerm WebConnect client reads the URL of webconnectxml from the preferencesini
file and requests it
2 When the webconnectxml is successfully downloaded the application reads the
configuration connects to the specified Web server downloads the PowerTerm
WebConnect components and connects to the PowerTerm WebConnect Server
3 The user is requested to login to the PowerTerm WebConnect Server For testing you
can use the username Example and password example
This step will be skipped if Single Sign-on is set to ldquotruerdquo
PowerTerm WebConnect 36 Getting Started Guide
4 After logging in to PowerTerm WebConnect Server the userrsquos applications are displayed
as defined by the administrator
5 To run an application select the desired application from the list and click Launch or
double-click the application The application will be launched in a separate window
610 Troubleshooting
When you encounter a problem the first step is to open the log file This file is located on
the client machine in the Ericom folder
Windows
CDocuments and SettingsltusernamegtEricomleclientEricomPluginlog
Linux
ltuser-home-directorygtEricomleclientEricomPluginlog
Following is a guide for diagnosing and fixing the problems in cases of error messages and
additional information
Error
Message
Solution
Version File
reading error
1 Check the lsquourlrsquo parameter in the webconnectxml file on the Web
server The value should be
httpltWebServerIPgtWebConnect
2 Try to run the following URL on the browser
Windows
httpltWebServerIPgtWebConnectwindowsptagentvertxt
Linux
httpltWebServerIPgtWebConnectlinuxix86qterm-
wcvertxt
The file contents displayed in the browser window should be in
the following form
560-rel14546
PowerTerm WebConnect Application Zone
560 - Main Release
ltrootgtPowerTerm WebConnect 56ltWebServergt
If the version file contents are not as shown check
- Is the Web Server running
- Are PowerTerm WebConnect Web Components and version files
PowerTerm WebConnect 37 Getting Started Guide
in place
3 On the Web server check ltPowerTerm WebConnect
rootgtwebwindowsptagentvertxt If the contents ldquolook wrongrdquo or
not in the proper form reinstall the PowerTerm WebConnect Web
components
4 On the client machine open the aforementioned URL in the
browser The file content should appear in the browser If it does
not it could be that the Web server is down
Web Server is
shut down
The webconnectxml configuration file must be located on the Web
server The explicit URL to this file is defined in the preferencesini
file (see Configure the Preferences File)
The error message contains the IP address of the Web server
Verify that the Web server on this machine is running
Version file
does not exist
on ltURLgt
See Version File reading error
The
configuration
file is not
accessible or
has a wrong
format
The webconnectxml configuration file must be located on the Web
server and the explicit URL to the configuration must be defined in
the preferencesini file (see Configure the Preferences File)
Try to open the URL specified in the error message in the
browser If it does not open then it either does not exist or it has
a wrong format
Preferences
file does not
exist in the
application
bundle
The preferencesini file containing the URL to the configuration
file was removed from the update site folder
Uninstall the current PowerTerm WebConnect client from the
client machine Create a new customized package (see
PowerTerm WebConnect Client Configuration) and reinstall it
Configuration
file URL is not
defined in
preference
file
The URL to the configuration file does not appear in the
preferencesini file (see Configure the Preferences File)
Uninstall the current PowerTerm WebConnect client from the
client machine Create a new customized package (see
PowerTerm WebConnect Client Configuration) and reinstall it
No IP address
could be
found for the
host
The Web server URL specified in the preferencesini file (see
Configure the Preferences File) or in the webconnectxml file (see
Configure the PowerTerm WebConnect Client) is an unknown
host
If the mistake is in the preferencesini file uninstall the current
PowerTerm WebConnect client from the client machine Create a
new customized package (see PowerTerm WebConnect Client
Configuration) and reinstall it
PowerTerm WebConnect 38 Getting Started Guide
If the mistake is in the webconnectxml file correct the file reopen
the Lotus Expeditor client
Cannot write
to destination
The temporary file cannot be written to the defined destination
Check the write permissions
Copied
configuration
file has wrong
format
The webconnectxml file as received from the specified URL has a
wrong format Correct the file and try again
PowerTerm
WebConnect
Agent URL is
malformed
The PowerTerm WebConnect Agent URL specified in the
webconnectxml file (see Configure the PowerTerm WebConnect
Client) does not have a proper HTTP format Correct the file and
try again
PowerTerm
WebConnect
Agent URL is
not defined
The PowerTerm WebConnect Agent URL parameter is not specified
in the webconnectxml file (see Configure the PowerTerm
WebConnect Client)
Correct the file and try again
The specified
destination
folder name
is wrong
The destination folder name contains illegal characters
ltgt|
Check the dst parameter in the webconnectxml file Correct the
file and try again
You do not
have
permissions
to write to
ltpathgt
The PowerTerm WebConnect Agent cannot be written to the
destination as defined Check the write permissions
The default destination defined in the version file should not to
be changed
A customized destination for PowerTerm WebConnect Agent
downloading can be defined in the webconnectxml file (See
Configure the PowerTerm WebConnect Client)
Check the destination value correct and try again
PowerTerm WebConnect 39 Getting Started Guide
About Ericom
Ericomreg Software is a leading provider of Application Access and Virtualization Solutions
Since 1993 Ericom has been helping users access enterprise mission-critical applications
running on a broad range of Microsoftreg Windowsreg Terminal Servers virtual Desktops
Blade PCs legacy hosts and other systems Ericom provides concrete business value by
helping organizations realize the benefits of their IT investments With offices in the United
States United Kingdom EMEA India and China Ericom also has an extensive network of
distributors and partners throughout North America Europe Asia and the Far East Our
expanding customer base is more than 30 thousand strong with over 7 million
installations
For more information on our products and services contact us at the location nearest to you
And visit our web site httpwwwericomcom
North America Western Europe International
Ericom Software Inc Ericom Software (UK) Ltd Ericom Software Ltd
231 Herbert Avenue Bldg 4 11a Victoria Square 8 Hamarpeh Street
Closter NJ 07624 USA Droitwich Worcestershire Har Hotzvim Technology Park
Tel +1 (201) 767 2210 WR9 8DE United Kingdom Jerusalem 91450 Israel
Fax +1 (201) 767 2205 Tel +44 (0) 845 644 3597 Tel +972 (2) 591 1700
Toll-free 1 (888) 769 7876 Fax +44 (0) 845 644 3598 Fax +972 (2) 571 4737
Email infoericomcom Email infoericomcouk Email infoericomcom
PowerTerm WebConnect 33 Getting Started Guide
javaiotmpdir CDOCUME~1dianaLOCALS~1Temp
javacompiler j9jit23
javaextdirs CIBMcommonpluginscomibmpvcwctruntim
esj2sewin32x86_150SR2-
20060511rcpeclipsepluginscomibmrcpj2sew
in32x86_150SR2-20060511jrelibext
osname Windows XP
osarch x86
osversion 51 build 2600 Service Pack 2
pathseparator
username Jone
userhome CDocuments and SettingsJone
userdir CIBMRSA
usertimezone GMT+0200
System properties available for users on Linux RedHat 9
Java System Property Name Value Example
javaversion 150
javavendorurl httpwwwibmcom
javahome usrjavajre150_07
javavmversion 150
javavmvendor IBM Corporation
javavmname IBM J9 VM
javaclasspath
javalibrarypath
javaiotmpdir tmp
javacompiler
javaextdirs
osname Linux
osarch i386
osversion 2420-8
pathseparator
PowerTerm WebConnect 34 Getting Started Guide
username root
userhome root
userdir root
System properties names are placed in the configuration file within percent symbols ()
(like macros)
671 Configure the PowerTerm WebConnect Client
1 Open the Config Folder and edit the webconnectxml file Example
ltxml version =rdquo10rdquo encoding=rdquoUTF-8rdquogt
ltsection name=rdquoparametersrdquogt
ltitem key=rdquourlrdquo value=httpadminserverWebConnect56gt
ltitem key=rdquoserverrdquo value=rdquoadmin24000rdquogt
ltitem key=rdquossordquo value=rdquotruerdquogt
ltitem key=rdquodestrdquo value=rdquoCProgram FilesEricomrdquogt
ltsectiongt
2 Save the customized webconnectxml to a Web server folder available to all users It is
recommended to use the same Web server as the PowerTerm WebConnect Agent
Example
ltWebConnect installation foldergtwebwebconnectxml
3 Test the accessibility to this file - Type the URL of webconnectxml in the browser
Example
httpltWebServer IPgtWebConnectwebconnectxml
The contents of the file should be displayed
672 Configure the Preferences File
1 Open the plugins folder and open the PowerTermWebConnectClient_560365jar file
You can use Winzip version 70 and up or in Windows XP ndash Create a new file type for the
jar extension click advanced and select compressed (zipped) folder in the drop down list
Now you can open the JAR files in the Windows Explorer
The default contents of the file
configURL=httpleericomcomWebConnectwebconnectxml
2 Specify the accurate URL of the webconnectxml file Example
httpltWebServer IPgtWebConnectwebconnectxml
3 Save the file and close it The WinZip will display the following dialog
ldquoFile preferencesini has been changed since it was extracted Update archive
with this filerdquo
PowerTerm WebConnect 35 Getting Started Guide
4 Click Yes and close the archive
If you are editing the file from within the explorer you will have to save the file elsewhere
and then drag it to the explorer window where the JAR file is open
68 Installing PowerTerm WebConnect Client on Lotus Expeditor
1 Start the Lotus Expeditor client
2 Select File | Application | Install
3 Select Search for new features to install and click Next
4 Select Add Folder Location and type or select the location of the update site folder from
the provided package Click OK
5 Select the location you have just created and click Finish
6 In the Select the feature to install tree select Powerterm WebConnectUpdate Site Click
Next
7 Select I accept the terms in the license agreements and click Next
8 Click Finish
9 When prompted restart the platform
69 Running PowerTerm WebConnect Client for Lotus Expeditor
1 Click Open The PowerTerm WebConnect option is displayed
2 Select PowerTerm WebConnect The application will automatically connect and start
downloading the components from PowerTerm WebConnect Server
IMPORTANT
If you did not install PowerTerm WebConnect Server and are instead connecting to Ericom
Softwarersquos Demo WebConnect Server then you need to open port 443 in the firewall
691 PowerTerm WebConnect Client Workflow
1 PowerTerm WebConnect client reads the URL of webconnectxml from the preferencesini
file and requests it
2 When the webconnectxml is successfully downloaded the application reads the
configuration connects to the specified Web server downloads the PowerTerm
WebConnect components and connects to the PowerTerm WebConnect Server
3 The user is requested to login to the PowerTerm WebConnect Server For testing you
can use the username Example and password example
This step will be skipped if Single Sign-on is set to ldquotruerdquo
PowerTerm WebConnect 36 Getting Started Guide
4 After logging in to PowerTerm WebConnect Server the userrsquos applications are displayed
as defined by the administrator
5 To run an application select the desired application from the list and click Launch or
double-click the application The application will be launched in a separate window
610 Troubleshooting
When you encounter a problem the first step is to open the log file This file is located on
the client machine in the Ericom folder
Windows
CDocuments and SettingsltusernamegtEricomleclientEricomPluginlog
Linux
ltuser-home-directorygtEricomleclientEricomPluginlog
Following is a guide for diagnosing and fixing the problems in cases of error messages and
additional information
Error
Message
Solution
Version File
reading error
1 Check the lsquourlrsquo parameter in the webconnectxml file on the Web
server The value should be
httpltWebServerIPgtWebConnect
2 Try to run the following URL on the browser
Windows
httpltWebServerIPgtWebConnectwindowsptagentvertxt
Linux
httpltWebServerIPgtWebConnectlinuxix86qterm-
wcvertxt
The file contents displayed in the browser window should be in
the following form
560-rel14546
PowerTerm WebConnect Application Zone
560 - Main Release
ltrootgtPowerTerm WebConnect 56ltWebServergt
If the version file contents are not as shown check
- Is the Web Server running
- Are PowerTerm WebConnect Web Components and version files
PowerTerm WebConnect 37 Getting Started Guide
in place
3 On the Web server check ltPowerTerm WebConnect
rootgtwebwindowsptagentvertxt If the contents ldquolook wrongrdquo or
not in the proper form reinstall the PowerTerm WebConnect Web
components
4 On the client machine open the aforementioned URL in the
browser The file content should appear in the browser If it does
not it could be that the Web server is down
Web Server is
shut down
The webconnectxml configuration file must be located on the Web
server The explicit URL to this file is defined in the preferencesini
file (see Configure the Preferences File)
The error message contains the IP address of the Web server
Verify that the Web server on this machine is running
Version file
does not exist
on ltURLgt
See Version File reading error
The
configuration
file is not
accessible or
has a wrong
format
The webconnectxml configuration file must be located on the Web
server and the explicit URL to the configuration must be defined in
the preferencesini file (see Configure the Preferences File)
Try to open the URL specified in the error message in the
browser If it does not open then it either does not exist or it has
a wrong format
Preferences
file does not
exist in the
application
bundle
The preferencesini file containing the URL to the configuration
file was removed from the update site folder
Uninstall the current PowerTerm WebConnect client from the
client machine Create a new customized package (see
PowerTerm WebConnect Client Configuration) and reinstall it
Configuration
file URL is not
defined in
preference
file
The URL to the configuration file does not appear in the
preferencesini file (see Configure the Preferences File)
Uninstall the current PowerTerm WebConnect client from the
client machine Create a new customized package (see
PowerTerm WebConnect Client Configuration) and reinstall it
No IP address
could be
found for the
host
The Web server URL specified in the preferencesini file (see
Configure the Preferences File) or in the webconnectxml file (see
Configure the PowerTerm WebConnect Client) is an unknown
host
If the mistake is in the preferencesini file uninstall the current
PowerTerm WebConnect client from the client machine Create a
new customized package (see PowerTerm WebConnect Client
Configuration) and reinstall it
PowerTerm WebConnect 38 Getting Started Guide
If the mistake is in the webconnectxml file correct the file reopen
the Lotus Expeditor client
Cannot write
to destination
The temporary file cannot be written to the defined destination
Check the write permissions
Copied
configuration
file has wrong
format
The webconnectxml file as received from the specified URL has a
wrong format Correct the file and try again
PowerTerm
WebConnect
Agent URL is
malformed
The PowerTerm WebConnect Agent URL specified in the
webconnectxml file (see Configure the PowerTerm WebConnect
Client) does not have a proper HTTP format Correct the file and
try again
PowerTerm
WebConnect
Agent URL is
not defined
The PowerTerm WebConnect Agent URL parameter is not specified
in the webconnectxml file (see Configure the PowerTerm
WebConnect Client)
Correct the file and try again
The specified
destination
folder name
is wrong
The destination folder name contains illegal characters
ltgt|
Check the dst parameter in the webconnectxml file Correct the
file and try again
You do not
have
permissions
to write to
ltpathgt
The PowerTerm WebConnect Agent cannot be written to the
destination as defined Check the write permissions
The default destination defined in the version file should not to
be changed
A customized destination for PowerTerm WebConnect Agent
downloading can be defined in the webconnectxml file (See
Configure the PowerTerm WebConnect Client)
Check the destination value correct and try again
PowerTerm WebConnect 39 Getting Started Guide
About Ericom
Ericomreg Software is a leading provider of Application Access and Virtualization Solutions
Since 1993 Ericom has been helping users access enterprise mission-critical applications
running on a broad range of Microsoftreg Windowsreg Terminal Servers virtual Desktops
Blade PCs legacy hosts and other systems Ericom provides concrete business value by
helping organizations realize the benefits of their IT investments With offices in the United
States United Kingdom EMEA India and China Ericom also has an extensive network of
distributors and partners throughout North America Europe Asia and the Far East Our
expanding customer base is more than 30 thousand strong with over 7 million
installations
For more information on our products and services contact us at the location nearest to you
And visit our web site httpwwwericomcom
North America Western Europe International
Ericom Software Inc Ericom Software (UK) Ltd Ericom Software Ltd
231 Herbert Avenue Bldg 4 11a Victoria Square 8 Hamarpeh Street
Closter NJ 07624 USA Droitwich Worcestershire Har Hotzvim Technology Park
Tel +1 (201) 767 2210 WR9 8DE United Kingdom Jerusalem 91450 Israel
Fax +1 (201) 767 2205 Tel +44 (0) 845 644 3597 Tel +972 (2) 591 1700
Toll-free 1 (888) 769 7876 Fax +44 (0) 845 644 3598 Fax +972 (2) 571 4737
Email infoericomcom Email infoericomcouk Email infoericomcom
PowerTerm WebConnect 34 Getting Started Guide
username root
userhome root
userdir root
System properties names are placed in the configuration file within percent symbols ()
(like macros)
671 Configure the PowerTerm WebConnect Client
1 Open the Config Folder and edit the webconnectxml file Example
ltxml version =rdquo10rdquo encoding=rdquoUTF-8rdquogt
ltsection name=rdquoparametersrdquogt
ltitem key=rdquourlrdquo value=httpadminserverWebConnect56gt
ltitem key=rdquoserverrdquo value=rdquoadmin24000rdquogt
ltitem key=rdquossordquo value=rdquotruerdquogt
ltitem key=rdquodestrdquo value=rdquoCProgram FilesEricomrdquogt
ltsectiongt
2 Save the customized webconnectxml to a Web server folder available to all users It is
recommended to use the same Web server as the PowerTerm WebConnect Agent
Example
ltWebConnect installation foldergtwebwebconnectxml
3 Test the accessibility to this file - Type the URL of webconnectxml in the browser
Example
httpltWebServer IPgtWebConnectwebconnectxml
The contents of the file should be displayed
672 Configure the Preferences File
1 Open the plugins folder and open the PowerTermWebConnectClient_560365jar file
You can use Winzip version 70 and up or in Windows XP ndash Create a new file type for the
jar extension click advanced and select compressed (zipped) folder in the drop down list
Now you can open the JAR files in the Windows Explorer
The default contents of the file
configURL=httpleericomcomWebConnectwebconnectxml
2 Specify the accurate URL of the webconnectxml file Example
httpltWebServer IPgtWebConnectwebconnectxml
3 Save the file and close it The WinZip will display the following dialog
ldquoFile preferencesini has been changed since it was extracted Update archive
with this filerdquo
PowerTerm WebConnect 35 Getting Started Guide
4 Click Yes and close the archive
If you are editing the file from within the explorer you will have to save the file elsewhere
and then drag it to the explorer window where the JAR file is open
68 Installing PowerTerm WebConnect Client on Lotus Expeditor
1 Start the Lotus Expeditor client
2 Select File | Application | Install
3 Select Search for new features to install and click Next
4 Select Add Folder Location and type or select the location of the update site folder from
the provided package Click OK
5 Select the location you have just created and click Finish
6 In the Select the feature to install tree select Powerterm WebConnectUpdate Site Click
Next
7 Select I accept the terms in the license agreements and click Next
8 Click Finish
9 When prompted restart the platform
69 Running PowerTerm WebConnect Client for Lotus Expeditor
1 Click Open The PowerTerm WebConnect option is displayed
2 Select PowerTerm WebConnect The application will automatically connect and start
downloading the components from PowerTerm WebConnect Server
IMPORTANT
If you did not install PowerTerm WebConnect Server and are instead connecting to Ericom
Softwarersquos Demo WebConnect Server then you need to open port 443 in the firewall
691 PowerTerm WebConnect Client Workflow
1 PowerTerm WebConnect client reads the URL of webconnectxml from the preferencesini
file and requests it
2 When the webconnectxml is successfully downloaded the application reads the
configuration connects to the specified Web server downloads the PowerTerm
WebConnect components and connects to the PowerTerm WebConnect Server
3 The user is requested to login to the PowerTerm WebConnect Server For testing you
can use the username Example and password example
This step will be skipped if Single Sign-on is set to ldquotruerdquo
PowerTerm WebConnect 36 Getting Started Guide
4 After logging in to PowerTerm WebConnect Server the userrsquos applications are displayed
as defined by the administrator
5 To run an application select the desired application from the list and click Launch or
double-click the application The application will be launched in a separate window
610 Troubleshooting
When you encounter a problem the first step is to open the log file This file is located on
the client machine in the Ericom folder
Windows
CDocuments and SettingsltusernamegtEricomleclientEricomPluginlog
Linux
ltuser-home-directorygtEricomleclientEricomPluginlog
Following is a guide for diagnosing and fixing the problems in cases of error messages and
additional information
Error
Message
Solution
Version File
reading error
1 Check the lsquourlrsquo parameter in the webconnectxml file on the Web
server The value should be
httpltWebServerIPgtWebConnect
2 Try to run the following URL on the browser
Windows
httpltWebServerIPgtWebConnectwindowsptagentvertxt
Linux
httpltWebServerIPgtWebConnectlinuxix86qterm-
wcvertxt
The file contents displayed in the browser window should be in
the following form
560-rel14546
PowerTerm WebConnect Application Zone
560 - Main Release
ltrootgtPowerTerm WebConnect 56ltWebServergt
If the version file contents are not as shown check
- Is the Web Server running
- Are PowerTerm WebConnect Web Components and version files
PowerTerm WebConnect 37 Getting Started Guide
in place
3 On the Web server check ltPowerTerm WebConnect
rootgtwebwindowsptagentvertxt If the contents ldquolook wrongrdquo or
not in the proper form reinstall the PowerTerm WebConnect Web
components
4 On the client machine open the aforementioned URL in the
browser The file content should appear in the browser If it does
not it could be that the Web server is down
Web Server is
shut down
The webconnectxml configuration file must be located on the Web
server The explicit URL to this file is defined in the preferencesini
file (see Configure the Preferences File)
The error message contains the IP address of the Web server
Verify that the Web server on this machine is running
Version file
does not exist
on ltURLgt
See Version File reading error
The
configuration
file is not
accessible or
has a wrong
format
The webconnectxml configuration file must be located on the Web
server and the explicit URL to the configuration must be defined in
the preferencesini file (see Configure the Preferences File)
Try to open the URL specified in the error message in the
browser If it does not open then it either does not exist or it has
a wrong format
Preferences
file does not
exist in the
application
bundle
The preferencesini file containing the URL to the configuration
file was removed from the update site folder
Uninstall the current PowerTerm WebConnect client from the
client machine Create a new customized package (see
PowerTerm WebConnect Client Configuration) and reinstall it
Configuration
file URL is not
defined in
preference
file
The URL to the configuration file does not appear in the
preferencesini file (see Configure the Preferences File)
Uninstall the current PowerTerm WebConnect client from the
client machine Create a new customized package (see
PowerTerm WebConnect Client Configuration) and reinstall it
No IP address
could be
found for the
host
The Web server URL specified in the preferencesini file (see
Configure the Preferences File) or in the webconnectxml file (see
Configure the PowerTerm WebConnect Client) is an unknown
host
If the mistake is in the preferencesini file uninstall the current
PowerTerm WebConnect client from the client machine Create a
new customized package (see PowerTerm WebConnect Client
Configuration) and reinstall it
PowerTerm WebConnect 38 Getting Started Guide
If the mistake is in the webconnectxml file correct the file reopen
the Lotus Expeditor client
Cannot write
to destination
The temporary file cannot be written to the defined destination
Check the write permissions
Copied
configuration
file has wrong
format
The webconnectxml file as received from the specified URL has a
wrong format Correct the file and try again
PowerTerm
WebConnect
Agent URL is
malformed
The PowerTerm WebConnect Agent URL specified in the
webconnectxml file (see Configure the PowerTerm WebConnect
Client) does not have a proper HTTP format Correct the file and
try again
PowerTerm
WebConnect
Agent URL is
not defined
The PowerTerm WebConnect Agent URL parameter is not specified
in the webconnectxml file (see Configure the PowerTerm
WebConnect Client)
Correct the file and try again
The specified
destination
folder name
is wrong
The destination folder name contains illegal characters
ltgt|
Check the dst parameter in the webconnectxml file Correct the
file and try again
You do not
have
permissions
to write to
ltpathgt
The PowerTerm WebConnect Agent cannot be written to the
destination as defined Check the write permissions
The default destination defined in the version file should not to
be changed
A customized destination for PowerTerm WebConnect Agent
downloading can be defined in the webconnectxml file (See
Configure the PowerTerm WebConnect Client)
Check the destination value correct and try again
PowerTerm WebConnect 39 Getting Started Guide
About Ericom
Ericomreg Software is a leading provider of Application Access and Virtualization Solutions
Since 1993 Ericom has been helping users access enterprise mission-critical applications
running on a broad range of Microsoftreg Windowsreg Terminal Servers virtual Desktops
Blade PCs legacy hosts and other systems Ericom provides concrete business value by
helping organizations realize the benefits of their IT investments With offices in the United
States United Kingdom EMEA India and China Ericom also has an extensive network of
distributors and partners throughout North America Europe Asia and the Far East Our
expanding customer base is more than 30 thousand strong with over 7 million
installations
For more information on our products and services contact us at the location nearest to you
And visit our web site httpwwwericomcom
North America Western Europe International
Ericom Software Inc Ericom Software (UK) Ltd Ericom Software Ltd
231 Herbert Avenue Bldg 4 11a Victoria Square 8 Hamarpeh Street
Closter NJ 07624 USA Droitwich Worcestershire Har Hotzvim Technology Park
Tel +1 (201) 767 2210 WR9 8DE United Kingdom Jerusalem 91450 Israel
Fax +1 (201) 767 2205 Tel +44 (0) 845 644 3597 Tel +972 (2) 591 1700
Toll-free 1 (888) 769 7876 Fax +44 (0) 845 644 3598 Fax +972 (2) 571 4737
Email infoericomcom Email infoericomcouk Email infoericomcom
PowerTerm WebConnect 35 Getting Started Guide
4 Click Yes and close the archive
If you are editing the file from within the explorer you will have to save the file elsewhere
and then drag it to the explorer window where the JAR file is open
68 Installing PowerTerm WebConnect Client on Lotus Expeditor
1 Start the Lotus Expeditor client
2 Select File | Application | Install
3 Select Search for new features to install and click Next
4 Select Add Folder Location and type or select the location of the update site folder from
the provided package Click OK
5 Select the location you have just created and click Finish
6 In the Select the feature to install tree select Powerterm WebConnectUpdate Site Click
Next
7 Select I accept the terms in the license agreements and click Next
8 Click Finish
9 When prompted restart the platform
69 Running PowerTerm WebConnect Client for Lotus Expeditor
1 Click Open The PowerTerm WebConnect option is displayed
2 Select PowerTerm WebConnect The application will automatically connect and start
downloading the components from PowerTerm WebConnect Server
IMPORTANT
If you did not install PowerTerm WebConnect Server and are instead connecting to Ericom
Softwarersquos Demo WebConnect Server then you need to open port 443 in the firewall
691 PowerTerm WebConnect Client Workflow
1 PowerTerm WebConnect client reads the URL of webconnectxml from the preferencesini
file and requests it
2 When the webconnectxml is successfully downloaded the application reads the
configuration connects to the specified Web server downloads the PowerTerm
WebConnect components and connects to the PowerTerm WebConnect Server
3 The user is requested to login to the PowerTerm WebConnect Server For testing you
can use the username Example and password example
This step will be skipped if Single Sign-on is set to ldquotruerdquo
PowerTerm WebConnect 36 Getting Started Guide
4 After logging in to PowerTerm WebConnect Server the userrsquos applications are displayed
as defined by the administrator
5 To run an application select the desired application from the list and click Launch or
double-click the application The application will be launched in a separate window
610 Troubleshooting
When you encounter a problem the first step is to open the log file This file is located on
the client machine in the Ericom folder
Windows
CDocuments and SettingsltusernamegtEricomleclientEricomPluginlog
Linux
ltuser-home-directorygtEricomleclientEricomPluginlog
Following is a guide for diagnosing and fixing the problems in cases of error messages and
additional information
Error
Message
Solution
Version File
reading error
1 Check the lsquourlrsquo parameter in the webconnectxml file on the Web
server The value should be
httpltWebServerIPgtWebConnect
2 Try to run the following URL on the browser
Windows
httpltWebServerIPgtWebConnectwindowsptagentvertxt
Linux
httpltWebServerIPgtWebConnectlinuxix86qterm-
wcvertxt
The file contents displayed in the browser window should be in
the following form
560-rel14546
PowerTerm WebConnect Application Zone
560 - Main Release
ltrootgtPowerTerm WebConnect 56ltWebServergt
If the version file contents are not as shown check
- Is the Web Server running
- Are PowerTerm WebConnect Web Components and version files
PowerTerm WebConnect 37 Getting Started Guide
in place
3 On the Web server check ltPowerTerm WebConnect
rootgtwebwindowsptagentvertxt If the contents ldquolook wrongrdquo or
not in the proper form reinstall the PowerTerm WebConnect Web
components
4 On the client machine open the aforementioned URL in the
browser The file content should appear in the browser If it does
not it could be that the Web server is down
Web Server is
shut down
The webconnectxml configuration file must be located on the Web
server The explicit URL to this file is defined in the preferencesini
file (see Configure the Preferences File)
The error message contains the IP address of the Web server
Verify that the Web server on this machine is running
Version file
does not exist
on ltURLgt
See Version File reading error
The
configuration
file is not
accessible or
has a wrong
format
The webconnectxml configuration file must be located on the Web
server and the explicit URL to the configuration must be defined in
the preferencesini file (see Configure the Preferences File)
Try to open the URL specified in the error message in the
browser If it does not open then it either does not exist or it has
a wrong format
Preferences
file does not
exist in the
application
bundle
The preferencesini file containing the URL to the configuration
file was removed from the update site folder
Uninstall the current PowerTerm WebConnect client from the
client machine Create a new customized package (see
PowerTerm WebConnect Client Configuration) and reinstall it
Configuration
file URL is not
defined in
preference
file
The URL to the configuration file does not appear in the
preferencesini file (see Configure the Preferences File)
Uninstall the current PowerTerm WebConnect client from the
client machine Create a new customized package (see
PowerTerm WebConnect Client Configuration) and reinstall it
No IP address
could be
found for the
host
The Web server URL specified in the preferencesini file (see
Configure the Preferences File) or in the webconnectxml file (see
Configure the PowerTerm WebConnect Client) is an unknown
host
If the mistake is in the preferencesini file uninstall the current
PowerTerm WebConnect client from the client machine Create a
new customized package (see PowerTerm WebConnect Client
Configuration) and reinstall it
PowerTerm WebConnect 38 Getting Started Guide
If the mistake is in the webconnectxml file correct the file reopen
the Lotus Expeditor client
Cannot write
to destination
The temporary file cannot be written to the defined destination
Check the write permissions
Copied
configuration
file has wrong
format
The webconnectxml file as received from the specified URL has a
wrong format Correct the file and try again
PowerTerm
WebConnect
Agent URL is
malformed
The PowerTerm WebConnect Agent URL specified in the
webconnectxml file (see Configure the PowerTerm WebConnect
Client) does not have a proper HTTP format Correct the file and
try again
PowerTerm
WebConnect
Agent URL is
not defined
The PowerTerm WebConnect Agent URL parameter is not specified
in the webconnectxml file (see Configure the PowerTerm
WebConnect Client)
Correct the file and try again
The specified
destination
folder name
is wrong
The destination folder name contains illegal characters
ltgt|
Check the dst parameter in the webconnectxml file Correct the
file and try again
You do not
have
permissions
to write to
ltpathgt
The PowerTerm WebConnect Agent cannot be written to the
destination as defined Check the write permissions
The default destination defined in the version file should not to
be changed
A customized destination for PowerTerm WebConnect Agent
downloading can be defined in the webconnectxml file (See
Configure the PowerTerm WebConnect Client)
Check the destination value correct and try again
PowerTerm WebConnect 39 Getting Started Guide
About Ericom
Ericomreg Software is a leading provider of Application Access and Virtualization Solutions
Since 1993 Ericom has been helping users access enterprise mission-critical applications
running on a broad range of Microsoftreg Windowsreg Terminal Servers virtual Desktops
Blade PCs legacy hosts and other systems Ericom provides concrete business value by
helping organizations realize the benefits of their IT investments With offices in the United
States United Kingdom EMEA India and China Ericom also has an extensive network of
distributors and partners throughout North America Europe Asia and the Far East Our
expanding customer base is more than 30 thousand strong with over 7 million
installations
For more information on our products and services contact us at the location nearest to you
And visit our web site httpwwwericomcom
North America Western Europe International
Ericom Software Inc Ericom Software (UK) Ltd Ericom Software Ltd
231 Herbert Avenue Bldg 4 11a Victoria Square 8 Hamarpeh Street
Closter NJ 07624 USA Droitwich Worcestershire Har Hotzvim Technology Park
Tel +1 (201) 767 2210 WR9 8DE United Kingdom Jerusalem 91450 Israel
Fax +1 (201) 767 2205 Tel +44 (0) 845 644 3597 Tel +972 (2) 591 1700
Toll-free 1 (888) 769 7876 Fax +44 (0) 845 644 3598 Fax +972 (2) 571 4737
Email infoericomcom Email infoericomcouk Email infoericomcom
PowerTerm WebConnect 36 Getting Started Guide
4 After logging in to PowerTerm WebConnect Server the userrsquos applications are displayed
as defined by the administrator
5 To run an application select the desired application from the list and click Launch or
double-click the application The application will be launched in a separate window
610 Troubleshooting
When you encounter a problem the first step is to open the log file This file is located on
the client machine in the Ericom folder
Windows
CDocuments and SettingsltusernamegtEricomleclientEricomPluginlog
Linux
ltuser-home-directorygtEricomleclientEricomPluginlog
Following is a guide for diagnosing and fixing the problems in cases of error messages and
additional information
Error
Message
Solution
Version File
reading error
1 Check the lsquourlrsquo parameter in the webconnectxml file on the Web
server The value should be
httpltWebServerIPgtWebConnect
2 Try to run the following URL on the browser
Windows
httpltWebServerIPgtWebConnectwindowsptagentvertxt
Linux
httpltWebServerIPgtWebConnectlinuxix86qterm-
wcvertxt
The file contents displayed in the browser window should be in
the following form
560-rel14546
PowerTerm WebConnect Application Zone
560 - Main Release
ltrootgtPowerTerm WebConnect 56ltWebServergt
If the version file contents are not as shown check
- Is the Web Server running
- Are PowerTerm WebConnect Web Components and version files
PowerTerm WebConnect 37 Getting Started Guide
in place
3 On the Web server check ltPowerTerm WebConnect
rootgtwebwindowsptagentvertxt If the contents ldquolook wrongrdquo or
not in the proper form reinstall the PowerTerm WebConnect Web
components
4 On the client machine open the aforementioned URL in the
browser The file content should appear in the browser If it does
not it could be that the Web server is down
Web Server is
shut down
The webconnectxml configuration file must be located on the Web
server The explicit URL to this file is defined in the preferencesini
file (see Configure the Preferences File)
The error message contains the IP address of the Web server
Verify that the Web server on this machine is running
Version file
does not exist
on ltURLgt
See Version File reading error
The
configuration
file is not
accessible or
has a wrong
format
The webconnectxml configuration file must be located on the Web
server and the explicit URL to the configuration must be defined in
the preferencesini file (see Configure the Preferences File)
Try to open the URL specified in the error message in the
browser If it does not open then it either does not exist or it has
a wrong format
Preferences
file does not
exist in the
application
bundle
The preferencesini file containing the URL to the configuration
file was removed from the update site folder
Uninstall the current PowerTerm WebConnect client from the
client machine Create a new customized package (see
PowerTerm WebConnect Client Configuration) and reinstall it
Configuration
file URL is not
defined in
preference
file
The URL to the configuration file does not appear in the
preferencesini file (see Configure the Preferences File)
Uninstall the current PowerTerm WebConnect client from the
client machine Create a new customized package (see
PowerTerm WebConnect Client Configuration) and reinstall it
No IP address
could be
found for the
host
The Web server URL specified in the preferencesini file (see
Configure the Preferences File) or in the webconnectxml file (see
Configure the PowerTerm WebConnect Client) is an unknown
host
If the mistake is in the preferencesini file uninstall the current
PowerTerm WebConnect client from the client machine Create a
new customized package (see PowerTerm WebConnect Client
Configuration) and reinstall it
PowerTerm WebConnect 38 Getting Started Guide
If the mistake is in the webconnectxml file correct the file reopen
the Lotus Expeditor client
Cannot write
to destination
The temporary file cannot be written to the defined destination
Check the write permissions
Copied
configuration
file has wrong
format
The webconnectxml file as received from the specified URL has a
wrong format Correct the file and try again
PowerTerm
WebConnect
Agent URL is
malformed
The PowerTerm WebConnect Agent URL specified in the
webconnectxml file (see Configure the PowerTerm WebConnect
Client) does not have a proper HTTP format Correct the file and
try again
PowerTerm
WebConnect
Agent URL is
not defined
The PowerTerm WebConnect Agent URL parameter is not specified
in the webconnectxml file (see Configure the PowerTerm
WebConnect Client)
Correct the file and try again
The specified
destination
folder name
is wrong
The destination folder name contains illegal characters
ltgt|
Check the dst parameter in the webconnectxml file Correct the
file and try again
You do not
have
permissions
to write to
ltpathgt
The PowerTerm WebConnect Agent cannot be written to the
destination as defined Check the write permissions
The default destination defined in the version file should not to
be changed
A customized destination for PowerTerm WebConnect Agent
downloading can be defined in the webconnectxml file (See
Configure the PowerTerm WebConnect Client)
Check the destination value correct and try again
PowerTerm WebConnect 39 Getting Started Guide
About Ericom
Ericomreg Software is a leading provider of Application Access and Virtualization Solutions
Since 1993 Ericom has been helping users access enterprise mission-critical applications
running on a broad range of Microsoftreg Windowsreg Terminal Servers virtual Desktops
Blade PCs legacy hosts and other systems Ericom provides concrete business value by
helping organizations realize the benefits of their IT investments With offices in the United
States United Kingdom EMEA India and China Ericom also has an extensive network of
distributors and partners throughout North America Europe Asia and the Far East Our
expanding customer base is more than 30 thousand strong with over 7 million
installations
For more information on our products and services contact us at the location nearest to you
And visit our web site httpwwwericomcom
North America Western Europe International
Ericom Software Inc Ericom Software (UK) Ltd Ericom Software Ltd
231 Herbert Avenue Bldg 4 11a Victoria Square 8 Hamarpeh Street
Closter NJ 07624 USA Droitwich Worcestershire Har Hotzvim Technology Park
Tel +1 (201) 767 2210 WR9 8DE United Kingdom Jerusalem 91450 Israel
Fax +1 (201) 767 2205 Tel +44 (0) 845 644 3597 Tel +972 (2) 591 1700
Toll-free 1 (888) 769 7876 Fax +44 (0) 845 644 3598 Fax +972 (2) 571 4737
Email infoericomcom Email infoericomcouk Email infoericomcom
PowerTerm WebConnect 37 Getting Started Guide
in place
3 On the Web server check ltPowerTerm WebConnect
rootgtwebwindowsptagentvertxt If the contents ldquolook wrongrdquo or
not in the proper form reinstall the PowerTerm WebConnect Web
components
4 On the client machine open the aforementioned URL in the
browser The file content should appear in the browser If it does
not it could be that the Web server is down
Web Server is
shut down
The webconnectxml configuration file must be located on the Web
server The explicit URL to this file is defined in the preferencesini
file (see Configure the Preferences File)
The error message contains the IP address of the Web server
Verify that the Web server on this machine is running
Version file
does not exist
on ltURLgt
See Version File reading error
The
configuration
file is not
accessible or
has a wrong
format
The webconnectxml configuration file must be located on the Web
server and the explicit URL to the configuration must be defined in
the preferencesini file (see Configure the Preferences File)
Try to open the URL specified in the error message in the
browser If it does not open then it either does not exist or it has
a wrong format
Preferences
file does not
exist in the
application
bundle
The preferencesini file containing the URL to the configuration
file was removed from the update site folder
Uninstall the current PowerTerm WebConnect client from the
client machine Create a new customized package (see
PowerTerm WebConnect Client Configuration) and reinstall it
Configuration
file URL is not
defined in
preference
file
The URL to the configuration file does not appear in the
preferencesini file (see Configure the Preferences File)
Uninstall the current PowerTerm WebConnect client from the
client machine Create a new customized package (see
PowerTerm WebConnect Client Configuration) and reinstall it
No IP address
could be
found for the
host
The Web server URL specified in the preferencesini file (see
Configure the Preferences File) or in the webconnectxml file (see
Configure the PowerTerm WebConnect Client) is an unknown
host
If the mistake is in the preferencesini file uninstall the current
PowerTerm WebConnect client from the client machine Create a
new customized package (see PowerTerm WebConnect Client
Configuration) and reinstall it
PowerTerm WebConnect 38 Getting Started Guide
If the mistake is in the webconnectxml file correct the file reopen
the Lotus Expeditor client
Cannot write
to destination
The temporary file cannot be written to the defined destination
Check the write permissions
Copied
configuration
file has wrong
format
The webconnectxml file as received from the specified URL has a
wrong format Correct the file and try again
PowerTerm
WebConnect
Agent URL is
malformed
The PowerTerm WebConnect Agent URL specified in the
webconnectxml file (see Configure the PowerTerm WebConnect
Client) does not have a proper HTTP format Correct the file and
try again
PowerTerm
WebConnect
Agent URL is
not defined
The PowerTerm WebConnect Agent URL parameter is not specified
in the webconnectxml file (see Configure the PowerTerm
WebConnect Client)
Correct the file and try again
The specified
destination
folder name
is wrong
The destination folder name contains illegal characters
ltgt|
Check the dst parameter in the webconnectxml file Correct the
file and try again
You do not
have
permissions
to write to
ltpathgt
The PowerTerm WebConnect Agent cannot be written to the
destination as defined Check the write permissions
The default destination defined in the version file should not to
be changed
A customized destination for PowerTerm WebConnect Agent
downloading can be defined in the webconnectxml file (See
Configure the PowerTerm WebConnect Client)
Check the destination value correct and try again
PowerTerm WebConnect 39 Getting Started Guide
About Ericom
Ericomreg Software is a leading provider of Application Access and Virtualization Solutions
Since 1993 Ericom has been helping users access enterprise mission-critical applications
running on a broad range of Microsoftreg Windowsreg Terminal Servers virtual Desktops
Blade PCs legacy hosts and other systems Ericom provides concrete business value by
helping organizations realize the benefits of their IT investments With offices in the United
States United Kingdom EMEA India and China Ericom also has an extensive network of
distributors and partners throughout North America Europe Asia and the Far East Our
expanding customer base is more than 30 thousand strong with over 7 million
installations
For more information on our products and services contact us at the location nearest to you
And visit our web site httpwwwericomcom
North America Western Europe International
Ericom Software Inc Ericom Software (UK) Ltd Ericom Software Ltd
231 Herbert Avenue Bldg 4 11a Victoria Square 8 Hamarpeh Street
Closter NJ 07624 USA Droitwich Worcestershire Har Hotzvim Technology Park
Tel +1 (201) 767 2210 WR9 8DE United Kingdom Jerusalem 91450 Israel
Fax +1 (201) 767 2205 Tel +44 (0) 845 644 3597 Tel +972 (2) 591 1700
Toll-free 1 (888) 769 7876 Fax +44 (0) 845 644 3598 Fax +972 (2) 571 4737
Email infoericomcom Email infoericomcouk Email infoericomcom
PowerTerm WebConnect 38 Getting Started Guide
If the mistake is in the webconnectxml file correct the file reopen
the Lotus Expeditor client
Cannot write
to destination
The temporary file cannot be written to the defined destination
Check the write permissions
Copied
configuration
file has wrong
format
The webconnectxml file as received from the specified URL has a
wrong format Correct the file and try again
PowerTerm
WebConnect
Agent URL is
malformed
The PowerTerm WebConnect Agent URL specified in the
webconnectxml file (see Configure the PowerTerm WebConnect
Client) does not have a proper HTTP format Correct the file and
try again
PowerTerm
WebConnect
Agent URL is
not defined
The PowerTerm WebConnect Agent URL parameter is not specified
in the webconnectxml file (see Configure the PowerTerm
WebConnect Client)
Correct the file and try again
The specified
destination
folder name
is wrong
The destination folder name contains illegal characters
ltgt|
Check the dst parameter in the webconnectxml file Correct the
file and try again
You do not
have
permissions
to write to
ltpathgt
The PowerTerm WebConnect Agent cannot be written to the
destination as defined Check the write permissions
The default destination defined in the version file should not to
be changed
A customized destination for PowerTerm WebConnect Agent
downloading can be defined in the webconnectxml file (See
Configure the PowerTerm WebConnect Client)
Check the destination value correct and try again
PowerTerm WebConnect 39 Getting Started Guide
About Ericom
Ericomreg Software is a leading provider of Application Access and Virtualization Solutions
Since 1993 Ericom has been helping users access enterprise mission-critical applications
running on a broad range of Microsoftreg Windowsreg Terminal Servers virtual Desktops
Blade PCs legacy hosts and other systems Ericom provides concrete business value by
helping organizations realize the benefits of their IT investments With offices in the United
States United Kingdom EMEA India and China Ericom also has an extensive network of
distributors and partners throughout North America Europe Asia and the Far East Our
expanding customer base is more than 30 thousand strong with over 7 million
installations
For more information on our products and services contact us at the location nearest to you
And visit our web site httpwwwericomcom
North America Western Europe International
Ericom Software Inc Ericom Software (UK) Ltd Ericom Software Ltd
231 Herbert Avenue Bldg 4 11a Victoria Square 8 Hamarpeh Street
Closter NJ 07624 USA Droitwich Worcestershire Har Hotzvim Technology Park
Tel +1 (201) 767 2210 WR9 8DE United Kingdom Jerusalem 91450 Israel
Fax +1 (201) 767 2205 Tel +44 (0) 845 644 3597 Tel +972 (2) 591 1700
Toll-free 1 (888) 769 7876 Fax +44 (0) 845 644 3598 Fax +972 (2) 571 4737
Email infoericomcom Email infoericomcouk Email infoericomcom
PowerTerm WebConnect 39 Getting Started Guide
About Ericom
Ericomreg Software is a leading provider of Application Access and Virtualization Solutions
Since 1993 Ericom has been helping users access enterprise mission-critical applications
running on a broad range of Microsoftreg Windowsreg Terminal Servers virtual Desktops
Blade PCs legacy hosts and other systems Ericom provides concrete business value by
helping organizations realize the benefits of their IT investments With offices in the United
States United Kingdom EMEA India and China Ericom also has an extensive network of
distributors and partners throughout North America Europe Asia and the Far East Our
expanding customer base is more than 30 thousand strong with over 7 million
installations
For more information on our products and services contact us at the location nearest to you
And visit our web site httpwwwericomcom
North America Western Europe International
Ericom Software Inc Ericom Software (UK) Ltd Ericom Software Ltd
231 Herbert Avenue Bldg 4 11a Victoria Square 8 Hamarpeh Street
Closter NJ 07624 USA Droitwich Worcestershire Har Hotzvim Technology Park
Tel +1 (201) 767 2210 WR9 8DE United Kingdom Jerusalem 91450 Israel
Fax +1 (201) 767 2205 Tel +44 (0) 845 644 3597 Tel +972 (2) 591 1700
Toll-free 1 (888) 769 7876 Fax +44 (0) 845 644 3598 Fax +972 (2) 571 4737
Email infoericomcom Email infoericomcouk Email infoericomcom