39
PowerTerm ® WebConnect Version 5.6 Getting Started PowerTerm WebConnect Enterprise PowerTerm WebConnect RemoteView PowerTerm WebConnect DeskView PowerTerm WebConnect for Oracle VM PowerTerm WebConnect HostView

PowerTerm WebConnect Getting Started - huji.ac.ilnucleon.cc.huji.ac.il/.../WebConnectGettingStarted.pdf · 2008-02-03 · 1 PRODUCT OVERVIEW 6 2 INSTALLING AND STARTING POWERTERM

  • Upload
    others

  • View
    3

  • Download
    0

Embed Size (px)

Citation preview

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

  • Users of Red Hat 72
  • Step 1 Install PowerTerm WebConnect Server
  • Step 2 Enable JSR portlets
  • Step 3 Enable SSO
  • Step 4 Copy Files
  • Step 5 Portlet Configuration
  • Step 6 Install the Portlet
  • Step 7 Create an Application page
  • Step 8 Run the Portlet
  • Step 1 Enable JSR 168 portlets
  • Step 2 Install the portlet
  • Step 3 Install the Application page
  • Step 4 Run the portlet
  • Step 1 Install PowerTerm WebConnect Server
  • Step 2 Copy Files
  • Step 3 Portlet Configuration
  • Step 4 Install the Portlet and create an Application page
  • Step 5 Run the Portlet
  • About Ericom

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

  • Users of Red Hat 72
  • Step 1 Install PowerTerm WebConnect Server
  • Step 2 Enable JSR portlets
  • Step 3 Enable SSO
  • Step 4 Copy Files
  • Step 5 Portlet Configuration
  • Step 6 Install the Portlet
  • Step 7 Create an Application page
  • Step 8 Run the Portlet
  • Step 1 Enable JSR 168 portlets
  • Step 2 Install the portlet
  • Step 3 Install the Application page
  • Step 4 Run the portlet
  • Step 1 Install PowerTerm WebConnect Server
  • Step 2 Copy Files
  • Step 3 Portlet Configuration
  • Step 4 Install the Portlet and create an Application page
  • Step 5 Run the Portlet
  • About Ericom

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

  • Users of Red Hat 72
  • Step 1 Install PowerTerm WebConnect Server
  • Step 2 Enable JSR portlets
  • Step 3 Enable SSO
  • Step 4 Copy Files
  • Step 5 Portlet Configuration
  • Step 6 Install the Portlet
  • Step 7 Create an Application page
  • Step 8 Run the Portlet
  • Step 1 Enable JSR 168 portlets
  • Step 2 Install the portlet
  • Step 3 Install the Application page
  • Step 4 Run the portlet
  • Step 1 Install PowerTerm WebConnect Server
  • Step 2 Copy Files
  • Step 3 Portlet Configuration
  • Step 4 Install the Portlet and create an Application page
  • Step 5 Run the Portlet
  • About Ericom

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

  • Users of Red Hat 72
  • Step 1 Install PowerTerm WebConnect Server
  • Step 2 Enable JSR portlets
  • Step 3 Enable SSO
  • Step 4 Copy Files
  • Step 5 Portlet Configuration
  • Step 6 Install the Portlet
  • Step 7 Create an Application page
  • Step 8 Run the Portlet
  • Step 1 Enable JSR 168 portlets
  • Step 2 Install the portlet
  • Step 3 Install the Application page
  • Step 4 Run the portlet
  • Step 1 Install PowerTerm WebConnect Server
  • Step 2 Copy Files
  • Step 3 Portlet Configuration
  • Step 4 Install the Portlet and create an Application page
  • Step 5 Run the Portlet
  • About Ericom

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

  • Users of Red Hat 72
  • Step 1 Install PowerTerm WebConnect Server
  • Step 2 Enable JSR portlets
  • Step 3 Enable SSO
  • Step 4 Copy Files
  • Step 5 Portlet Configuration
  • Step 6 Install the Portlet
  • Step 7 Create an Application page
  • Step 8 Run the Portlet
  • Step 1 Enable JSR 168 portlets
  • Step 2 Install the portlet
  • Step 3 Install the Application page
  • Step 4 Run the portlet
  • Step 1 Install PowerTerm WebConnect Server
  • Step 2 Copy Files
  • Step 3 Portlet Configuration
  • Step 4 Install the Portlet and create an Application page
  • Step 5 Run the Portlet
  • About Ericom

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

  • Users of Red Hat 72
  • Step 1 Install PowerTerm WebConnect Server
  • Step 2 Enable JSR portlets
  • Step 3 Enable SSO
  • Step 4 Copy Files
  • Step 5 Portlet Configuration
  • Step 6 Install the Portlet
  • Step 7 Create an Application page
  • Step 8 Run the Portlet
  • Step 1 Enable JSR 168 portlets
  • Step 2 Install the portlet
  • Step 3 Install the Application page
  • Step 4 Run the portlet
  • Step 1 Install PowerTerm WebConnect Server
  • Step 2 Copy Files
  • Step 3 Portlet Configuration
  • Step 4 Install the Portlet and create an Application page
  • Step 5 Run the Portlet
  • About Ericom

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

  • Users of Red Hat 72
  • Step 1 Install PowerTerm WebConnect Server
  • Step 2 Enable JSR portlets
  • Step 3 Enable SSO
  • Step 4 Copy Files
  • Step 5 Portlet Configuration
  • Step 6 Install the Portlet
  • Step 7 Create an Application page
  • Step 8 Run the Portlet
  • Step 1 Enable JSR 168 portlets
  • Step 2 Install the portlet
  • Step 3 Install the Application page
  • Step 4 Run the portlet
  • Step 1 Install PowerTerm WebConnect Server
  • Step 2 Copy Files
  • Step 3 Portlet Configuration
  • Step 4 Install the Portlet and create an Application page
  • Step 5 Run the Portlet
  • About Ericom

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

  • Users of Red Hat 72
  • Step 1 Install PowerTerm WebConnect Server
  • Step 2 Enable JSR portlets
  • Step 3 Enable SSO
  • Step 4 Copy Files
  • Step 5 Portlet Configuration
  • Step 6 Install the Portlet
  • Step 7 Create an Application page
  • Step 8 Run the Portlet
  • Step 1 Enable JSR 168 portlets
  • Step 2 Install the portlet
  • Step 3 Install the Application page
  • Step 4 Run the portlet
  • Step 1 Install PowerTerm WebConnect Server
  • Step 2 Copy Files
  • Step 3 Portlet Configuration
  • Step 4 Install the Portlet and create an Application page
  • Step 5 Run the Portlet
  • About Ericom

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

  • Users of Red Hat 72
  • Step 1 Install PowerTerm WebConnect Server
  • Step 2 Enable JSR portlets
  • Step 3 Enable SSO
  • Step 4 Copy Files
  • Step 5 Portlet Configuration
  • Step 6 Install the Portlet
  • Step 7 Create an Application page
  • Step 8 Run the Portlet
  • Step 1 Enable JSR 168 portlets
  • Step 2 Install the portlet
  • Step 3 Install the Application page
  • Step 4 Run the portlet
  • Step 1 Install PowerTerm WebConnect Server
  • Step 2 Copy Files
  • Step 3 Portlet Configuration
  • Step 4 Install the Portlet and create an Application page
  • Step 5 Run the Portlet
  • About Ericom

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

  • Users of Red Hat 72
  • Step 1 Install PowerTerm WebConnect Server
  • Step 2 Enable JSR portlets
  • Step 3 Enable SSO
  • Step 4 Copy Files
  • Step 5 Portlet Configuration
  • Step 6 Install the Portlet
  • Step 7 Create an Application page
  • Step 8 Run the Portlet
  • Step 1 Enable JSR 168 portlets
  • Step 2 Install the portlet
  • Step 3 Install the Application page
  • Step 4 Run the portlet
  • Step 1 Install PowerTerm WebConnect Server
  • Step 2 Copy Files
  • Step 3 Portlet Configuration
  • Step 4 Install the Portlet and create an Application page
  • Step 5 Run the Portlet
  • About Ericom

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

  • Users of Red Hat 72
  • Step 1 Install PowerTerm WebConnect Server
  • Step 2 Enable JSR portlets
  • Step 3 Enable SSO
  • Step 4 Copy Files
  • Step 5 Portlet Configuration
  • Step 6 Install the Portlet
  • Step 7 Create an Application page
  • Step 8 Run the Portlet
  • Step 1 Enable JSR 168 portlets
  • Step 2 Install the portlet
  • Step 3 Install the Application page
  • Step 4 Run the portlet
  • Step 1 Install PowerTerm WebConnect Server
  • Step 2 Copy Files
  • Step 3 Portlet Configuration
  • Step 4 Install the Portlet and create an Application page
  • Step 5 Run the Portlet
  • About Ericom

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

  • Users of Red Hat 72
  • Step 1 Install PowerTerm WebConnect Server
  • Step 2 Enable JSR portlets
  • Step 3 Enable SSO
  • Step 4 Copy Files
  • Step 5 Portlet Configuration
  • Step 6 Install the Portlet
  • Step 7 Create an Application page
  • Step 8 Run the Portlet
  • Step 1 Enable JSR 168 portlets
  • Step 2 Install the portlet
  • Step 3 Install the Application page
  • Step 4 Run the portlet
  • Step 1 Install PowerTerm WebConnect Server
  • Step 2 Copy Files
  • Step 3 Portlet Configuration
  • Step 4 Install the Portlet and create an Application page
  • Step 5 Run the Portlet
  • About Ericom

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

  • Users of Red Hat 72
  • Step 1 Install PowerTerm WebConnect Server
  • Step 2 Enable JSR portlets
  • Step 3 Enable SSO
  • Step 4 Copy Files
  • Step 5 Portlet Configuration
  • Step 6 Install the Portlet
  • Step 7 Create an Application page
  • Step 8 Run the Portlet
  • Step 1 Enable JSR 168 portlets
  • Step 2 Install the portlet
  • Step 3 Install the Application page
  • Step 4 Run the portlet
  • Step 1 Install PowerTerm WebConnect Server
  • Step 2 Copy Files
  • Step 3 Portlet Configuration
  • Step 4 Install the Portlet and create an Application page
  • Step 5 Run the Portlet
  • About Ericom

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

  • Users of Red Hat 72
  • Step 1 Install PowerTerm WebConnect Server
  • Step 2 Enable JSR portlets
  • Step 3 Enable SSO
  • Step 4 Copy Files
  • Step 5 Portlet Configuration
  • Step 6 Install the Portlet
  • Step 7 Create an Application page
  • Step 8 Run the Portlet
  • Step 1 Enable JSR 168 portlets
  • Step 2 Install the portlet
  • Step 3 Install the Application page
  • Step 4 Run the portlet
  • Step 1 Install PowerTerm WebConnect Server
  • Step 2 Copy Files
  • Step 3 Portlet Configuration
  • Step 4 Install the Portlet and create an Application page
  • Step 5 Run the Portlet
  • About Ericom

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

  • Users of Red Hat 72
  • Step 1 Install PowerTerm WebConnect Server
  • Step 2 Enable JSR portlets
  • Step 3 Enable SSO
  • Step 4 Copy Files
  • Step 5 Portlet Configuration
  • Step 6 Install the Portlet
  • Step 7 Create an Application page
  • Step 8 Run the Portlet
  • Step 1 Enable JSR 168 portlets
  • Step 2 Install the portlet
  • Step 3 Install the Application page
  • Step 4 Run the portlet
  • Step 1 Install PowerTerm WebConnect Server
  • Step 2 Copy Files
  • Step 3 Portlet Configuration
  • Step 4 Install the Portlet and create an Application page
  • Step 5 Run the Portlet
  • About Ericom

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

  • Users of Red Hat 72
  • Step 1 Install PowerTerm WebConnect Server
  • Step 2 Enable JSR portlets
  • Step 3 Enable SSO
  • Step 4 Copy Files
  • Step 5 Portlet Configuration
  • Step 6 Install the Portlet
  • Step 7 Create an Application page
  • Step 8 Run the Portlet
  • Step 1 Enable JSR 168 portlets
  • Step 2 Install the portlet
  • Step 3 Install the Application page
  • Step 4 Run the portlet
  • Step 1 Install PowerTerm WebConnect Server
  • Step 2 Copy Files
  • Step 3 Portlet Configuration
  • Step 4 Install the Portlet and create an Application page
  • Step 5 Run the Portlet
  • About Ericom

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

  • Users of Red Hat 72
  • Step 1 Install PowerTerm WebConnect Server
  • Step 2 Enable JSR portlets
  • Step 3 Enable SSO
  • Step 4 Copy Files
  • Step 5 Portlet Configuration
  • Step 6 Install the Portlet
  • Step 7 Create an Application page
  • Step 8 Run the Portlet
  • Step 1 Enable JSR 168 portlets
  • Step 2 Install the portlet
  • Step 3 Install the Application page
  • Step 4 Run the portlet
  • Step 1 Install PowerTerm WebConnect Server
  • Step 2 Copy Files
  • Step 3 Portlet Configuration
  • Step 4 Install the Portlet and create an Application page
  • Step 5 Run the Portlet
  • About Ericom

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

  • Users of Red Hat 72
  • Step 1 Install PowerTerm WebConnect Server
  • Step 2 Enable JSR portlets
  • Step 3 Enable SSO
  • Step 4 Copy Files
  • Step 5 Portlet Configuration
  • Step 6 Install the Portlet
  • Step 7 Create an Application page
  • Step 8 Run the Portlet
  • Step 1 Enable JSR 168 portlets
  • Step 2 Install the portlet
  • Step 3 Install the Application page
  • Step 4 Run the portlet
  • Step 1 Install PowerTerm WebConnect Server
  • Step 2 Copy Files
  • Step 3 Portlet Configuration
  • Step 4 Install the Portlet and create an Application page
  • Step 5 Run the Portlet
  • About Ericom

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

  • Users of Red Hat 72
  • Step 1 Install PowerTerm WebConnect Server
  • Step 2 Enable JSR portlets
  • Step 3 Enable SSO
  • Step 4 Copy Files
  • Step 5 Portlet Configuration
  • Step 6 Install the Portlet
  • Step 7 Create an Application page
  • Step 8 Run the Portlet
  • Step 1 Enable JSR 168 portlets
  • Step 2 Install the portlet
  • Step 3 Install the Application page
  • Step 4 Run the portlet
  • Step 1 Install PowerTerm WebConnect Server
  • Step 2 Copy Files
  • Step 3 Portlet Configuration
  • Step 4 Install the Portlet and create an Application page
  • Step 5 Run the Portlet
  • About Ericom

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

  • Users of Red Hat 72
  • Step 1 Install PowerTerm WebConnect Server
  • Step 2 Enable JSR portlets
  • Step 3 Enable SSO
  • Step 4 Copy Files
  • Step 5 Portlet Configuration
  • Step 6 Install the Portlet
  • Step 7 Create an Application page
  • Step 8 Run the Portlet
  • Step 1 Enable JSR 168 portlets
  • Step 2 Install the portlet
  • Step 3 Install the Application page
  • Step 4 Run the portlet
  • Step 1 Install PowerTerm WebConnect Server
  • Step 2 Copy Files
  • Step 3 Portlet Configuration
  • Step 4 Install the Portlet and create an Application page
  • Step 5 Run the Portlet
  • About Ericom

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

  • Users of Red Hat 72
  • Step 1 Install PowerTerm WebConnect Server
  • Step 2 Enable JSR portlets
  • Step 3 Enable SSO
  • Step 4 Copy Files
  • Step 5 Portlet Configuration
  • Step 6 Install the Portlet
  • Step 7 Create an Application page
  • Step 8 Run the Portlet
  • Step 1 Enable JSR 168 portlets
  • Step 2 Install the portlet
  • Step 3 Install the Application page
  • Step 4 Run the portlet
  • Step 1 Install PowerTerm WebConnect Server
  • Step 2 Copy Files
  • Step 3 Portlet Configuration
  • Step 4 Install the Portlet and create an Application page
  • Step 5 Run the Portlet
  • About Ericom

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

  • Users of Red Hat 72
  • Step 1 Install PowerTerm WebConnect Server
  • Step 2 Enable JSR portlets
  • Step 3 Enable SSO
  • Step 4 Copy Files
  • Step 5 Portlet Configuration
  • Step 6 Install the Portlet
  • Step 7 Create an Application page
  • Step 8 Run the Portlet
  • Step 1 Enable JSR 168 portlets
  • Step 2 Install the portlet
  • Step 3 Install the Application page
  • Step 4 Run the portlet
  • Step 1 Install PowerTerm WebConnect Server
  • Step 2 Copy Files
  • Step 3 Portlet Configuration
  • Step 4 Install the Portlet and create an Application page
  • Step 5 Run the Portlet
  • About Ericom

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

  • Users of Red Hat 72
  • Step 1 Install PowerTerm WebConnect Server
  • Step 2 Enable JSR portlets
  • Step 3 Enable SSO
  • Step 4 Copy Files
  • Step 5 Portlet Configuration
  • Step 6 Install the Portlet
  • Step 7 Create an Application page
  • Step 8 Run the Portlet
  • Step 1 Enable JSR 168 portlets
  • Step 2 Install the portlet
  • Step 3 Install the Application page
  • Step 4 Run the portlet
  • Step 1 Install PowerTerm WebConnect Server
  • Step 2 Copy Files
  • Step 3 Portlet Configuration
  • Step 4 Install the Portlet and create an Application page
  • Step 5 Run the Portlet
  • About Ericom

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

  • Users of Red Hat 72
  • Step 1 Install PowerTerm WebConnect Server
  • Step 2 Enable JSR portlets
  • Step 3 Enable SSO
  • Step 4 Copy Files
  • Step 5 Portlet Configuration
  • Step 6 Install the Portlet
  • Step 7 Create an Application page
  • Step 8 Run the Portlet
  • Step 1 Enable JSR 168 portlets
  • Step 2 Install the portlet
  • Step 3 Install the Application page
  • Step 4 Run the portlet
  • Step 1 Install PowerTerm WebConnect Server
  • Step 2 Copy Files
  • Step 3 Portlet Configuration
  • Step 4 Install the Portlet and create an Application page
  • Step 5 Run the Portlet
  • About Ericom

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

  • Users of Red Hat 72
  • Step 1 Install PowerTerm WebConnect Server
  • Step 2 Enable JSR portlets
  • Step 3 Enable SSO
  • Step 4 Copy Files
  • Step 5 Portlet Configuration
  • Step 6 Install the Portlet
  • Step 7 Create an Application page
  • Step 8 Run the Portlet
  • Step 1 Enable JSR 168 portlets
  • Step 2 Install the portlet
  • Step 3 Install the Application page
  • Step 4 Run the portlet
  • Step 1 Install PowerTerm WebConnect Server
  • Step 2 Copy Files
  • Step 3 Portlet Configuration
  • Step 4 Install the Portlet and create an Application page
  • Step 5 Run the Portlet
  • About Ericom

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

  • Users of Red Hat 72
  • Step 1 Install PowerTerm WebConnect Server
  • Step 2 Enable JSR portlets
  • Step 3 Enable SSO
  • Step 4 Copy Files
  • Step 5 Portlet Configuration
  • Step 6 Install the Portlet
  • Step 7 Create an Application page
  • Step 8 Run the Portlet
  • Step 1 Enable JSR 168 portlets
  • Step 2 Install the portlet
  • Step 3 Install the Application page
  • Step 4 Run the portlet
  • Step 1 Install PowerTerm WebConnect Server
  • Step 2 Copy Files
  • Step 3 Portlet Configuration
  • Step 4 Install the Portlet and create an Application page
  • Step 5 Run the Portlet
  • About Ericom

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

  • Users of Red Hat 72
  • Step 1 Install PowerTerm WebConnect Server
  • Step 2 Enable JSR portlets
  • Step 3 Enable SSO
  • Step 4 Copy Files
  • Step 5 Portlet Configuration
  • Step 6 Install the Portlet
  • Step 7 Create an Application page
  • Step 8 Run the Portlet
  • Step 1 Enable JSR 168 portlets
  • Step 2 Install the portlet
  • Step 3 Install the Application page
  • Step 4 Run the portlet
  • Step 1 Install PowerTerm WebConnect Server
  • Step 2 Copy Files
  • Step 3 Portlet Configuration
  • Step 4 Install the Portlet and create an Application page
  • Step 5 Run the Portlet
  • About Ericom

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

  • Users of Red Hat 72
  • Step 1 Install PowerTerm WebConnect Server
  • Step 2 Enable JSR portlets
  • Step 3 Enable SSO
  • Step 4 Copy Files
  • Step 5 Portlet Configuration
  • Step 6 Install the Portlet
  • Step 7 Create an Application page
  • Step 8 Run the Portlet
  • Step 1 Enable JSR 168 portlets
  • Step 2 Install the portlet
  • Step 3 Install the Application page
  • Step 4 Run the portlet
  • Step 1 Install PowerTerm WebConnect Server
  • Step 2 Copy Files
  • Step 3 Portlet Configuration
  • Step 4 Install the Portlet and create an Application page
  • Step 5 Run the Portlet
  • About Ericom

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

  • Users of Red Hat 72
  • Step 1 Install PowerTerm WebConnect Server
  • Step 2 Enable JSR portlets
  • Step 3 Enable SSO
  • Step 4 Copy Files
  • Step 5 Portlet Configuration
  • Step 6 Install the Portlet
  • Step 7 Create an Application page
  • Step 8 Run the Portlet
  • Step 1 Enable JSR 168 portlets
  • Step 2 Install the portlet
  • Step 3 Install the Application page
  • Step 4 Run the portlet
  • Step 1 Install PowerTerm WebConnect Server
  • Step 2 Copy Files
  • Step 3 Portlet Configuration
  • Step 4 Install the Portlet and create an Application page
  • Step 5 Run the Portlet
  • About Ericom

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

  • Users of Red Hat 72
  • Step 1 Install PowerTerm WebConnect Server
  • Step 2 Enable JSR portlets
  • Step 3 Enable SSO
  • Step 4 Copy Files
  • Step 5 Portlet Configuration
  • Step 6 Install the Portlet
  • Step 7 Create an Application page
  • Step 8 Run the Portlet
  • Step 1 Enable JSR 168 portlets
  • Step 2 Install the portlet
  • Step 3 Install the Application page
  • Step 4 Run the portlet
  • Step 1 Install PowerTerm WebConnect Server
  • Step 2 Copy Files
  • Step 3 Portlet Configuration
  • Step 4 Install the Portlet and create an Application page
  • Step 5 Run the Portlet
  • About Ericom

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

  • Users of Red Hat 72
  • Step 1 Install PowerTerm WebConnect Server
  • Step 2 Enable JSR portlets
  • Step 3 Enable SSO
  • Step 4 Copy Files
  • Step 5 Portlet Configuration
  • Step 6 Install the Portlet
  • Step 7 Create an Application page
  • Step 8 Run the Portlet
  • Step 1 Enable JSR 168 portlets
  • Step 2 Install the portlet
  • Step 3 Install the Application page
  • Step 4 Run the portlet
  • Step 1 Install PowerTerm WebConnect Server
  • Step 2 Copy Files
  • Step 3 Portlet Configuration
  • Step 4 Install the Portlet and create an Application page
  • Step 5 Run the Portlet
  • About Ericom

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

  • Users of Red Hat 72
  • Step 1 Install PowerTerm WebConnect Server
  • Step 2 Enable JSR portlets
  • Step 3 Enable SSO
  • Step 4 Copy Files
  • Step 5 Portlet Configuration
  • Step 6 Install the Portlet
  • Step 7 Create an Application page
  • Step 8 Run the Portlet
  • Step 1 Enable JSR 168 portlets
  • Step 2 Install the portlet
  • Step 3 Install the Application page
  • Step 4 Run the portlet
  • Step 1 Install PowerTerm WebConnect Server
  • Step 2 Copy Files
  • Step 3 Portlet Configuration
  • Step 4 Install the Portlet and create an Application page
  • Step 5 Run the Portlet
  • About Ericom

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

  • Users of Red Hat 72
  • Step 1 Install PowerTerm WebConnect Server
  • Step 2 Enable JSR portlets
  • Step 3 Enable SSO
  • Step 4 Copy Files
  • Step 5 Portlet Configuration
  • Step 6 Install the Portlet
  • Step 7 Create an Application page
  • Step 8 Run the Portlet
  • Step 1 Enable JSR 168 portlets
  • Step 2 Install the portlet
  • Step 3 Install the Application page
  • Step 4 Run the portlet
  • Step 1 Install PowerTerm WebConnect Server
  • Step 2 Copy Files
  • Step 3 Portlet Configuration
  • Step 4 Install the Portlet and create an Application page
  • Step 5 Run the Portlet
  • About Ericom

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

  • Users of Red Hat 72
  • Step 1 Install PowerTerm WebConnect Server
  • Step 2 Enable JSR portlets
  • Step 3 Enable SSO
  • Step 4 Copy Files
  • Step 5 Portlet Configuration
  • Step 6 Install the Portlet
  • Step 7 Create an Application page
  • Step 8 Run the Portlet
  • Step 1 Enable JSR 168 portlets
  • Step 2 Install the portlet
  • Step 3 Install the Application page
  • Step 4 Run the portlet
  • Step 1 Install PowerTerm WebConnect Server
  • Step 2 Copy Files
  • Step 3 Portlet Configuration
  • Step 4 Install the Portlet and create an Application page
  • Step 5 Run the Portlet
  • About Ericom

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

  • Users of Red Hat 72
  • Step 1 Install PowerTerm WebConnect Server
  • Step 2 Enable JSR portlets
  • Step 3 Enable SSO
  • Step 4 Copy Files
  • Step 5 Portlet Configuration
  • Step 6 Install the Portlet
  • Step 7 Create an Application page
  • Step 8 Run the Portlet
  • Step 1 Enable JSR 168 portlets
  • Step 2 Install the portlet
  • Step 3 Install the Application page
  • Step 4 Run the portlet
  • Step 1 Install PowerTerm WebConnect Server
  • Step 2 Copy Files
  • Step 3 Portlet Configuration
  • Step 4 Install the Portlet and create an Application page
  • Step 5 Run the Portlet
  • About Ericom

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

  • Users of Red Hat 72
  • Step 1 Install PowerTerm WebConnect Server
  • Step 2 Enable JSR portlets
  • Step 3 Enable SSO
  • Step 4 Copy Files
  • Step 5 Portlet Configuration
  • Step 6 Install the Portlet
  • Step 7 Create an Application page
  • Step 8 Run the Portlet
  • Step 1 Enable JSR 168 portlets
  • Step 2 Install the portlet
  • Step 3 Install the Application page
  • Step 4 Run the portlet
  • Step 1 Install PowerTerm WebConnect Server
  • Step 2 Copy Files
  • Step 3 Portlet Configuration
  • Step 4 Install the Portlet and create an Application page
  • Step 5 Run the Portlet
  • About Ericom

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

  • Users of Red Hat 72
  • Step 1 Install PowerTerm WebConnect Server
  • Step 2 Enable JSR portlets
  • Step 3 Enable SSO
  • Step 4 Copy Files
  • Step 5 Portlet Configuration
  • Step 6 Install the Portlet
  • Step 7 Create an Application page
  • Step 8 Run the Portlet
  • Step 1 Enable JSR 168 portlets
  • Step 2 Install the portlet
  • Step 3 Install the Application page
  • Step 4 Run the portlet
  • Step 1 Install PowerTerm WebConnect Server
  • Step 2 Copy Files
  • Step 3 Portlet Configuration
  • Step 4 Install the Portlet and create an Application page
  • Step 5 Run the Portlet
  • About Ericom

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

  • Users of Red Hat 72
  • Step 1 Install PowerTerm WebConnect Server
  • Step 2 Enable JSR portlets
  • Step 3 Enable SSO
  • Step 4 Copy Files
  • Step 5 Portlet Configuration
  • Step 6 Install the Portlet
  • Step 7 Create an Application page
  • Step 8 Run the Portlet
  • Step 1 Enable JSR 168 portlets
  • Step 2 Install the portlet
  • Step 3 Install the Application page
  • Step 4 Run the portlet
  • Step 1 Install PowerTerm WebConnect Server
  • Step 2 Copy Files
  • Step 3 Portlet Configuration
  • Step 4 Install the Portlet and create an Application page
  • Step 5 Run the Portlet
  • About Ericom

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

  • Users of Red Hat 72
  • Step 1 Install PowerTerm WebConnect Server
  • Step 2 Enable JSR portlets
  • Step 3 Enable SSO
  • Step 4 Copy Files
  • Step 5 Portlet Configuration
  • Step 6 Install the Portlet
  • Step 7 Create an Application page
  • Step 8 Run the Portlet
  • Step 1 Enable JSR 168 portlets
  • Step 2 Install the portlet
  • Step 3 Install the Application page
  • Step 4 Run the portlet
  • Step 1 Install PowerTerm WebConnect Server
  • Step 2 Copy Files
  • Step 3 Portlet Configuration
  • Step 4 Install the Portlet and create an Application page
  • Step 5 Run the Portlet
  • About Ericom