Web-To-Host 6.4: Administrator Guide - Micro Focus · Users can run sessions that include a...

OnWeb Web-to-Host 6.4

AdministratorGuide

Micro FocusThe Lawn22-30 Old Bath RoadNewbury, Berkshire RG14 1QNUKhttp://www.microfocus.com

Copyright © 1984-2012 Micro Focus. All rights reserved.

MICRO FOCUS, the Micro Focus logo and Rumba are trademarks or registered trademarks ofMicro Focus IP Development Limited or its subsidiaries or affiliated companies in the UnitedStates, United Kingdom and other countries.

All other marks are the property of their respective owners.

2012-10-19

ii

Contents

Product Overview ...............................................................................................5Components ........................................................................................................................5

Pro ............................................................................................................................5Java ..........................................................................................................................6

Architecture ......................................................................................................................... 7Security ............................................................................................................................... 8Licensing ............................................................................................................................. 8Finding information ..............................................................................................................8Contacting Micro Focus ...................................................................................................... 9

Server Installation ............................................................................................ 10System requirements ........................................................................................................ 10Installing ............................................................................................................................ 10

Installing on a Web server running Windows ......................................................... 10Installing on a Web server running Linux ............................................................... 12Installing on an iSeries system ...............................................................................13Installing on an unsupported non-Windows server ................................................ 14Installing an evaluation product ..............................................................................15

Directory structure .............................................................................................................15Session Configuration Manager ........................................................................................16Troubleshooting ................................................................................................................ 16

Setup program does not run ...................................................................................16Session Configuration Manager is lost ...................................................................16Web server: SCM does not open ........................................................................... 16

Uninstalling ........................................................................................................................17Uninstalling from a Windows server ....................................................................... 17Uninstalling from a non-Windows server ................................................................17

Creating and Migrating Client Profiles ........................................................... 18Migrating client profiles from a previous version ............................................................... 18

To migrate profiles after upgrading ........................................................................ 18To run the Conversion Utility .................................................................................. 19

Migrating PC-to-Host profiles ............................................................................................ 19PC-to-Host Profiles Supported ............................................................................... 19To import profiles using SCM ................................................................................. 20

Creating client profiles .......................................................................................................20To create or edit a client profile .............................................................................. 20

Configuring client profiles ..................................................................................................21Start options ........................................................................................................... 21Multiple sessions .................................................................................................... 22International client sessions ................................................................................... 23Java Web Start .......................................................................................................26Defining password level caching policy ..................................................................27

Publishing client profiles to users ......................................................................................28OnWeb Client Installation ................................................................................29

System requirements ........................................................................................................ 29Client operating system ..........................................................................................29Client browser ........................................................................................................ 29Host requirements .................................................................................................. 29

Client install and upgrade ..................................................................................................30Installing Pro ...........................................................................................................30Using License Manager: Pro .................................................................................. 31

Contents | 3

Installing Java .........................................................................................................32Client uninstall ...................................................................................................................32

Uninstalling Pro ...................................................................................................... 32Uninstalling Java .................................................................................................... 32Uninstalling Session Configuration Manager ......................................................... 32

Coexistence: Pro and PC-to-Host ...................................................................33Coexistence requirements ................................................................................................ 33Setting a custom install path ............................................................................................. 33Upgrading Pro and PC-to-Host software ...........................................................................34

User Profile Configuration ...............................................................................35Rules defining Pro behavior .............................................................................................. 35User configuration files in a distribution package ..............................................................36

User Data File Locations ................................................................................. 37Roaming profile support for Pro and Java sessions ..........................................................37Default paths for user data files ........................................................................................ 37

Pro sessions using Internet Explorer ......................................................................37Java sessions using Internet Explorer and Firefox .................................................37

Creating a Trace ............................................................................................... 38Setting trace in Java Sessions .......................................................................................... 38Setting trace in Pro Sessions ............................................................................................ 38

Contacting Micro Focus .................................................................................. 40Information Needed by Micro Focus SupportLine .............................................................40

Tell Us What You Think ................................................................................... 41

4 | Contents

Product OverviewOnWeb® Web-to-Host is a server-based Web application that publishes your existing legacy applications inintranet, extranet, and Internet environments. It includes host display, printer, and file transfer features thatenable end users to work productively with host-based information in a familiar Windows or web browserenvironment. OnWeb Web-to-Host provides access to a broad range of host types, including IBM®

mainframe, IBM AS/ 400®, DIGITAL® VAX, UNIX®, and HP® systems.

Although it can be installed as a standalone product, OnWeb Web-to-Host is part of the Micro FocusSolutions, a common underlying framework that integrates host systems, desktops, browser-basedsystems, and wireless devices to new Web-based solutions. This guide describes the OnWeb Web-to-Hoststandalone version.

For more information on Micro Focus Solutions, visit the Micro Focus web site (http://www.microfocus.com).

System administrators can use the Session Configuration Manager (SCM) utility to easily configure clientsessions that can be published to end users.

ComponentsOnWeb Web-to-Host includes these components:

• Pro• Java™

While both components provide users with display and printer capabilities for mainframe and mid-sizedhosts, theyhave different feature sets and use different technologies to connect workstations to host data.

ProDesigned for use in an intranet environment, the Pro component offers the richest feature set and consistsof ActiveX® controls that give users access to mission-critical host applications and data. The Procomponent provides these client session types:

• Mainframe Display, Mainframe Printer• AS/400 Display, AS/400 Printer, AS/400 File Transfer• UNIX Display• HP Display

Pro client sessions include these advanced features and options:

• Mainframe file transfer (can include SimXfer tables)• AS/400 File Transfer• AS/400 Batch file transfers• Macros• Hotspots• User profile enhancements• Restricted user support• An MSI packaging utility for automatically installing Pro components• A distribution utility• A download and install service

Product Overview | 5

http://www.microfocus.com


• VBA-type scripting• Customizable Menus and Toolbars• End-user keyboard mapping• Administrator keyboard mapping• Tracing

Hotspots, a word or set of characters on the host screen, activate a function when clicked. Using theHotspots Configuration dialog box you can enable/ disable, show/hide, create, and modify both the defaultand user created hotspots. Default hotspots are host commands displayed on-screen. User createdhotspots are custom macros you assign to selected on-screen text. You can also use hotspots and macrosto log on to and run host applications automatically. Any protected text on your host screen can be turnedinto a hotspot. In Mainframe displays, you can also configure hotspots for non-protected text.

Pro AS/400 File Transfer moves files and data between the host and the PC using either the menu bar ortoolbar options of the AS/400 Display. A customized toolbar button activates a pre-configured FTX file andstarts the AS/400 FTX application. A new AS/400 emulation type has been added to the SCM Wizard. Itopens the AS/400 FTX application and loads an existing FTX configuration on the client. Your users cancustomize the file transfer session, configuring options such as the data format for both sending andreceiving, file locations, application behavior both during and upon completion of the transfer, securitysettings, and host connection.

With the User Profile enhancements included in this release user configuration files (.cph) are no longerdeleted automatically when changes are made in the HTML files for the configurable options. For moreinformation, see User Profile Configuration.

Pro ActiveX components are downloaded to the client once, during the first login. A new download serviceis first installed on the client workstation. Once the service is installed on the client all users (includingrestricted users) can work with the Pro ActiveX controls. The service handles all installs, upgrades, anddownloads of Pro ActiveX components.

OnWeb Web-to-Host Distribution Packager enables you to bundle multiple Web-to-Host configuration anddata files into a single, easily distributed package. Users can run sessions that include a complete workenvironment with components such as pre-defined scripts, macros, hotspots, custom toolbars, backgroundimages, icons, screen/font colors, AS/400 File Transfer and Batch File Transfer profiles (for Web-to-HostPro sessions). OnWeb Web-to-Host Distribution Packager helps you provide standardized functionality anda single look and feel for all users. For more information, see the online help provided with the product.

JavaThe Java component can be used in all environments (Internet, intranet, and extranet), and consists ofJava applets (built using JavaBeans) compatible with JDK level 1.6 and higher. The Java componentincludes these client session types:

• Mainframe Display, Mainframe Printer• AS/400 Display, AS/400 Printer, AS/400 File Transfer, AS/400 Batch File Transfer• UNIX Display

Java client sessions include these advanced features and options:

• Mainframe file transfer• Macros• Toolbar• Status bar• 3D display• Hotspots• Color mapping• End-user keyboard mapping

6 | Product Overview

• A distribution utility• Administrator-configured keyboard mapping• Tracing• Configurable custom options

The Java applets are downloaded to the client once, during the first login; thereafter they operate on thebrowser system directly with only checks against the Web server for new versions or updates. No otherdownloads are required until you upgrade the Java component.

ArchitectureThe figure below depicts how OnWeb Web-to-Host works once the system administrator has created thehost sessions and published them to users. The following sections describe how this architecture is appliedto each of thecomponent types.

The ActiveX objects and JavaBeans are downloaded to the client the first time a user opens a session.When you install updates on the server, they are downloaded automatically to the client the next time auser opens a session. This architecture enables the client to communicate directly with the host, as shownin the above figure.


SecurityOnWeb Web-to-Host maintains persistent client-to-host sessions. It is important that users be aware ofsession persistence in relation to information security, especially when sessions are configured to runinside a browser window. In this mode, only one session is visible on the screen at a time, though othersessions could be running in the background.

Users who have access to sensitive information on host systems should consider running each session ina separate window to keep all concurrent sessions visible on the screen. Users can also ensure that allconnections are severed by closing their browser when they leave their work area. For details onconfiguring sessions to run in a separate window, see Start options

OnWeb Web-to-Host supports SSL (Secure Socket Layer) for IBM Mainframe, AS/400, and UNIX hosts. Italso supports SSH (Secure Shell) for Pro UNIX Display and Kerberos authentication for AS/400. With thissecurity support, users can securely access applications and transfer data between their desktops andmainframe, AS/400 and UNIX systems, encrypting the session data stream to a host capable of supportingthese protocols.

LicensingTo install OnWeb Web-to-Host, the system administrator must accept the terms of the license agreement.The purchase contract specifies the number of per seat licenses (the number of users who install Web-to-Host on a designated computer. The Licensing Agreement defines a “Designated Computer”).

OnWeb Web-to-Host Java is licensed using a license key, which must be provided during installation.

OnWeb Web-to-Host Pro is licensed using Micro Focus License Manager, which is installed automaticallywith OnWeb Web-to-Host Pro Clients.

Micro Focus License Manager allows you to authorize, view, and revoke licenses. For more information,see Using License Manager: Pro.

OnWeb Web-to-Host server installation provides the following options for licensing OnWeb Web-to-HostPro sessions:

• Evaluation: Installs a 30 calendar day evaluation version.• Use a License Server Name or Address: The name of the remote machine running Micro Focus

License Manager and where the OnWeb Web-to-Host Pro license is installed.

For more information, see Using License Manager: Pro.

Finding informationOnWeb Web-to-Host product documentation includes:

• This Administrator Guide, which explains how to install, uninstall, configure, and deploy the product.• The Readme file, which contains information about new features, late-breaking changes, and known

issues. The Help tab of the Session Configuration Manager contains links to the Readme file and thisAdministrator Guide.

• Context-sensitive help for the Session Configuration Manager, a utility for configuring Pro and Javaclient sessions.

• User Guides for Pro and Java clients. These online help files for end users explain how to configure andrun features and options in the client session.

8 | Product Overview

Contacting Micro FocusIf you have a question about OnWeb Web-to-Host software, first consult the product documentation. Youcan also find technical bulletins on the at http://supportline.microfocus.com.

• Sales

To purchase additional licenses and products, contact your Micro Focus sales office. For the mostcurrent contact information, including our international offices, visit our Web site at http://www.microfocus.com.

• Support

When contacting Technical Support, try to include the information below, if you have it. The moreinformation you can give, the better SupportLine can help you.

• The name and version number of all products that you think might be causing a problem.• The product serial number from the back of the disc sleeve.• Your computer make and model.• Your operating system version number and details of any networking software you are using.• If you are reporting a protection violation you might be asked to provide a dump (.dmp) file.• Alternatively, you might be asked to provide a log file created by the Consolidated Tracing Facility

(CTF) - a tracing infrastructure that enables you to quickly and easily produce diagnostic informationdetailing the operation of a number of Micro Focus software components.


http://supportline.microfocus.com



Server InstallationTo deploy OnWeb Web-to-Host software, you must complete these three tasks:

1. Install the product on a web server.2. Run the Session Configuration Manager (SCM) utility to create and configure (or migrate) session

profiles.3. Publish session profiles to clients.

Web-to-Host files are installed in a w2hlegacy directory (created during installation) that must reside in aweb-publishable directory on your server. The web server can then publish OnWeb Web-to-Host softwareto client workstations using the HTTP protocol.

This chapter describes how to install and remove OnWeb Web-to- Host as a standalone product on yourweb server. To install OnWeb Web-to-Host, see To install OnWeb Web-to-Host.

System requirements• The Web server on which you install OnWeb Web-to-Host can be any HTTP based server, such as a

Windows Web server, a UNIX server, or an AS/400 (iSeries).• You must configure this Web server to allow downloads of executable files to the client. If the Web

server is a Microsoft Internet Information Server (IIS) or a Microsoft Personal Web server, executepermissions must be turned off for the server directories that contain the Web-to-Host client .exe files.See your Web server documentation for instructions.

• You should install OnWeb Web-to-Host software in the root publishing directory of the Web server, or ina sub-directory configured on the web server. Otherwise, the product will not function. For details,consult your Web administrator or your Web server documentation.

• For Microsoft IIS, this directory is usually:

c:\Inetpub\wwwroot

• For Apache Server, this directory is usually:

c:\Program Files\Apache Group\Apache2.2\htdocs

• This version of OnWeb Web-to-Host requires Oracle Java VM 1.5 and higher.• To use the Session Configuration Manager (used to create and migrate client profiles) with either

Internet Explorer 6.0 and later or Firefox, Oracle Java VM 1.6 and higher is required.

InstallingThis section describes server installation procedures for OnWeb Web-to-Host as a standalone product.

• Installing on a Web server running Windows• Installing on a Web server running Linux• Installing on an iSeries system• Installing an evaluation product

Installing on a Web server running Windows

10 | Server Installation

Using SetupFollow these steps to install OnWeb Web-to-Host on a Web server running Windows Server 2003 (SP1and above) or Windows Server 2008.

1. Navigate to the Micro Focus Web-to-Host 6.4.0/bin folder.

2. Double-click Web-to-HostSetup.exe.

3. Read the introductory information, then click Next.4. Read the Software License Agreement, select the option to accept the terms of the license agreement,

then click Next.5. Enter the license information for your OnWeb Web-to-Host Java product, then click Next.6. Do one of the following:

• Select Evaluation.• Type the license server address for your OnWeb Web-to-Host Pro product.

7. Click Next.8. Specify the Web Root Directory (this can be the root publishing directory of your Web server or any

subdirectory under the Web root), then click OK.

• For IIS Web servers, the Web Root Directory defaults to:

c:\InetPub\wwwroot\

• For Apache Server, the root publishing directory defaults to:

c:\Program Files\Apache Software Foundation\Apache2.2\htdocs

• For other Web servers, browse to the root publishing directory of the Web server.

The setup program creates a new w2hlegacy directory under the root publishing directory (or thedestination directory) and begins copying files to that directory.

To install to a subdirectory, select Enable subdirectory support and type the path in the box provided.

When finished, the Installation Complete screen appears. For an overview of what the correctinstallation should look like, see Directory structure.

9. Click Finish to exit the installation.

Using the consoleOnWeb Web-to-Host can also be installed using the console (known as console mode). The command lineoptions you enter depend on whether you are installing to the default destination directory or to any otherdirectory configured on the Web server.

If you need to change the license information, you must first uninstall Web-to-Host, then reinstall it with thenew information. If you do not enter license information, Setup installs a 30-day evaluation version

To install to the default destination directory:

1. Enter:

<system drive>:java -jar -DLicenseKey=<license key> -DLicenseServer=<licenseserver IP address or name> -i console

2. Follow the instructions that appear during the installation.3. When installation is complete, you are prompted for a response. Press 3 to exit the installation.

For example, if the default directory is:

c:\Inetpub\wwwroot

then OnWeb Web-to-Host is installed in:

c:\Inetpub\wwwroot\w2hlegacy

Server Installation | 11

Note: When you install OnWeb Web-to-Host on either a Microsoft IIS or Apache Server, it is installedto their default directory. Otherwise, it is installed in the %PROGRAMFILES% directory as Web-to-HostSetup.exe.

To install to any other destination directory:

When installing to a non-default directory, you must enter the Web root directory parameter. If you want toinstall to a subdirectory under the Web root, you must also enter the subdirectory parameter. However, thisis optional.

1. Enter:

Web-to-HostSetup.exe -DWebRootDir=<directory name> -DSubDirectory=<subdirectory name> -DLicenseKey=<license key> -DLicenseServer=<license server IP address or name> -i console

2. Follow the instructions that appear during the installation.3. When installation is complete, you are prompted for a response. Press ENTER to exit the installation.

For example, to install OnWeb Web-to-Host to the following directory:

c:\InetPub\wwwroot in subdirectory w2h6.4\install

you would enter:

Web-to-HostSetup.exe -DWebRootDir=c:\InetPub\wwwroot -DSubDirectory=w2h6.4\install -DLicenseKey=xxxx-yyyy-vvvv -i console

Notes:

• When typing a subdirectory, always use the format:

<FolderName>\<FolderName>

• Parameters that include a space must be enclosed in quotation marks (“), for example:

-DWebRootDir=”c:\program files\wwwroot”

Installing on a Web server running LinuxThis version of OnWeb Web-to-Host supports requires Oracle Java VM 1.5 or higher.

Using Setup

1. Navigate to the Micro Focus Web-to-Host 6.4.0/bin folder.

2. Run the setup.jar file as a Java executable.

3. Read the introductory information, then click Next.

4. Read the Software License Agreement, select the option to accept the terms of the license agreement,then click Next.

5. Type the license information for your OnWeb Web-to-Host Java product, then click Next.

6. Choose Evaluation or type the license server address for your OnWeb Web-to-Host Pro product, thenclick Next.

7. Specify the Web Root Directory (this can be the root publishing directory of your web server or anysubdirectory under the web root), then click OK.

For example, the Apache Server root publishing default directory might be one of:

/var/www

/var/www/htdocs

/var/www/html

For other Web servers, browse to the root publishing directory of the Web server.


The setup program creates a new w2hlegacy directory under the root publishing directory (or thedestination directory) and begins copying files to that directory.

To install to a subdirectory, select Enable subdirectory support and type the path in the box provided.

When finished, the Installation Complete screen appears.

For an overview of what the correct installation should look like, see Directory structure.

8. Click Finish to exit the installation.

Using the consoleOnWeb Web-to-Host can also be installed using the console.

If you need to change the license information, you must first uninstall Web-to-Host, then reinstall it with thenew information. If you do not enter license information, Setup installs a 30-day evaluation version.

To install OnWeb Web-to-Host:

1. Change to the directory where setup.jar resides.

2. Enter: java -jar setup.jar -DWebRootDir=<directory name> -DSubDirectory=<subdirectory name> -DLicenseKey=<license key> -DLicenseServer=<license server IP address or name> -i console

3. Follow the instructions that appear during the installation.

4. When installation is complete, you are prompted for a response. Press 3 to exit the installation.

For example, to install OnWeb Web-to-Host to the following directory:

/var/www/htdocs in subdirectory w2h6.4/install

you would enter:

java -jar setup.jar -DWebRootDir=/var/www/htdocs -DSubDirectory=w2h6.4/install-DLicenseKey=xxxx-yyyy-vvvv –i console

Notes:

• When typing a subdirectory, always use the format:

<FolderName>\<FolderName>

• The following parameters are optional:

-DSubDirectory

-DLicenseKey

-DLicenseServer

• Parameters that include a space must be enclosed in quotation marks (“).

Installing on an iSeries systemOnWeb Web-to-Host can be installed on any non-Windows server that has a Java run-time environmentand a Web server.

This section provides instructions for installing an iSeries system.

System requirementsTo support OnWeb Web-to-Host, the following software must be installed on your iSeries system:

• 5722-SS1 Option 12 - Host Servers• 5722-DG1 - IBM HTTP Server (powered by Apache)• 5722-JV1 JVM 1.5


Installing the Java Virtual MachineIBM Technology for Java Virtual Machine is included in licensed program 5722-JV1. Licensed program5722-JV1 is shipped with the system CDs. To access the IBM Technology for Java option, perform thefollowing steps:

1. Enter the Go Licensed Program (GO LICPGM) command, then select Option 10 (Display) .2. If you do not see this licensed program listed, then perform the following steps:

a. Enter the GO LICPGM command on the command line.b. Select Option 11 (Install licensed program).c. Select Option 1 (Install) for licensed program (LP) 5722-JV1 *BASE, then select Option 8. If

Option 8 is not displayed in the list, you can add it to the list by entering Option 1 (Install) inthe option field. Enter 5722JV1 in the licensed program field and Option 8 in the product optionfield.

3. Add an environment variable. On the command line, enter the following command:

ADDENVVAR ENVVAR(JAVA_HOME) VALUE('/QOpenSys/QIBM/ProdData/JavaVM/jdk50/32bit')

Starting Web-to-Host installationFor best performance, it is highly recommended that you use the installation directory specified in thisprocedure.

1. Using FTP or NetServer, place the /bin/setup.jar file from your electronic download and place it onthe iSeries in a temporary location. For example, /tmp.

2. Type QSH and press ENTER.3. Change to the /tmp directory.4. Run the following command:

java -jar -DWebRootDir=<directory name> -DSubDirectory=<subdirectory name> -DLicenseKey=<license key> -DLicenseServer=<license server IP address orname> setup.jar -i console

For example, if you were using the APACHEDFT Web server, your command line would look similar tothis:

java -jar -DWebRootDir=/www/apachedft/htdocs -DLicenseKey=XXXXX-XXXXXXXXXXX-DLicenseServer=MyLicenseServerName setup.jar -i console

5. Follow the instructions that appear during the installation.6. When installation is complete, you are prompted for a response. Press ENTER to exit the installation.

After installation, you are ready to run SCM. For details on using the SCM utility, see Creating andMigrating Client Profiles.

Installing on an unsupported non-Windows serverTo install the product on an unsupported non-Windows server, you must first install the product on asupported platform (this does not need to be a Web or file server), then copy the files manually to thecorrect location on the non- Windows Web server.

1. Use FTP to copy the w2hlegacy folder and its contents to the root publishing directory of your Webserver. For the location of this directory, consult your Web administrator or your Web serverdocumentation).

Note: When using FTP to transfer files to an IBM OS/390 web server, be sure to FTP all files withfile extensions .htm, .html, or .txt as text. Transfer all other files as binary. This is necessarybecause IBM uses the EBCDIC rather than the ASCII character set to store text files.


2. When you have copied all the files, the installation is complete. For an overview of what the correctinstallation should look like, see Directory structure.

Installing an evaluation productThis section explains how to install and migrate the OnWeb Web-to-Host evaluation product. Theevaluation product expires 30 days after you first install OnWeb Web-to-Host. After 30 days, you can nolonger run your session profiles. You should then contact your system administrator.

Installing the evaluation product in graphic modeTo install the evaluation product on your Web server in graphic mode:

1. Follow the appropriate procedure above.

2. Instead of entering the license information, select Evaluate.

Installing the evaluation product in console modeTo install the evaluation product on your Web server from the console:

1. Follow the appropriate procedure above.

2. Do not enter the following parameters:

-DLicenseKey=<license key>

-DLicenseServer=<license server IP address or name>

After installing the evaluation product (for all modes), you can create session profiles and begin your 30-day evaluation period by directing your browser to:

<webserver>/w2hlegacy/config/hostwizard.html

For information on creating and configuring profiles, see Creating and Migrating Client Profiles.

Upgrading to a licensed productTo upgrade to a licensed product:

1. Install the licensed version on top of your evaluation product. If you are running in console mode, firstuninstall Web-to-Host, then reinstall it with the license information.

2. Evaluation profiles expire after the 30-day evaluation period. When upgrading to the licensed product,you must also run all profiles created with the evaluation product through the Conversion Utility in theSession Configuration Manager. See To migrate profiles after upgrading.

For Web-to-Host Pro sessions, license information is taken automatically from the Web-to-Host server.

Directory structureThe installed product has the following directory structure within the <webroot>\w2hlegacy\ rootpublishing directory:

Subdirectory Description

config\ The configuration utility, hostwizard.html.

data\ The sub-directories into which keyboard maps, scripts,macros, distribution packages, AS/400 FTX configuration,and watermark files are copied for all clients.

help\ The online documentation (Help) files.


Subdirectory Description

images\ The graphics used by OnWeb Web-to-Host.

java\ The download software for Java client connections.

javascript\ The include files used for some JavaScript functions.

pro\ The download software for Pro client connections.

rss\ The software for secure connections.

utils\ The Java Uninstall utility, MSI Packager, OnWeb DemoServer utility, and other useful utilities.

Note: If you choose to place the user data files location outside the OnWeb Web-to-Host serverinstallation folder, you must copy the file web.config from w2hlegacy to the new location. This isbecause the web.config file contains declarations of the MIME types to be allowed by IIS7.

Session Configuration ManagerAfter installing OnWeb Web-to-Host on your web server, the next task is running Session ConfigurationManager (SCM) utility to create, edit, and migrate client profiles. To run this utility, direct your browser tothis URL:

<webserver>/<destination directory>/w2hlegacy/config/hostwizard.html

For details on using the SCM utility, see Creating and Migrating Client Profiles.

TroubleshootingThis section summarizes the most common problems encountered when installing this product. There arelinks to the Readme file, for release-specific information, and this Administrator Guide on the Help tab inthe Session Configuration Manager (SCM) utility

Setup program does not runUse the Run utility to access the disk and run the program autorun.exe.

In the main menu, click OnWeb Web-to-Host 6.4, then choose Install OnWeb Web-to-Host 6.4.

Session Configuration Manager is lostIf after installing the product you cannot find the Session Configuration Manager (SCM), you may haveinstalled the product to the wrong directory (see previous problem). If the product is correctly installed andyou still cannot find the SCM, then search for the file hostwizard.html in the root publishing directory.When you find it, note the URL for the SCM for future use.

Web server: SCM does not openIf you correctly installed the product and still cannot open the Session Configuration Manager (SCM) inyour browser, you may have a case-sensitive file system. Verify that all the directories and file names forOnWeb Web-to- Host are in lowercase, enter the URL in lowercase, and try opening it again.

If you changed the product directory names from the default structure described in Directory structure, the<OBJECT> tag's codebase property is incorrect and must be fixed in the HTPL files:


1. First, back up the HTPL files in the config\ directory.2. Open each file with a text editor (such as Notepad) and edit the directory names.3. Save each file as ASCII text.

UninstallingWhen removing OnWeb Web-to-Host from your network environment, you should also uninstall the productfrom all client machines. For details on this procedure, see Client uninstall.

Uninstalling from a Windows server1. Select Control Panel > Add/Remove Programs.2. Select Micro Focus OnWeb Web-to-Host 6.4, then click Add/Remove.3. Follow the prompts to remove the application.

Uninstalling from a non-Windows serverTo uninstall from the default destination directory:

1. Navigate to:

<default install directory>\w2hlegacyuninst

2. Enter:

java -jar uninstaller.jar -i console

To uninstall from any destination directory and subdirectory:

1. Navigate to:

<webroot directory>/<subdirectory>/w2hlegacyuninst

2. Enter:

java -jar uninstaller.jar -i console


Creating and Migrating Client ProfilesAfter installing OnWeb Web-to-Host on your web server, the next task is to create or migrate client profiles.You may also want to edit client profiles to configure new options, such as security, distribution package,Pro toolbars and menus, and Pro watermarks.

This chapter explains how to use the Session Configuration Manager (SCM) utility to create, edit, andmigrate client profiles and how to deploy client profiles to your users. The procedures in this chapter applywhen installing and running OnWeb Web-to-Host as a standalone product on any web server.

Note: On a slow connection, the initial download for the SCM utility and the client session may take along time. Consequently, OnWeb Web-to-Host may look like it is not responding when running theSCM utility or the client session for the first time.

Migrating client profiles from a previous versionAfter updating your OnWeb Web-to-Host product by installing a new release version or applying a TMP orService Pack, you should migrate all session profiles created in the previous version by running theSession Configuration Manager in server mode. If you do not update these session profiles, the followingproblems may occur:

• Pro client sessions will not open. Users will see an error message prompting them to contact theirsystem administrator.

• Java client sessions will not open and users will not see an error message.

For details on running the SCM utility in server mode, see Creating client profiles.

To migrate profiles after upgrading1. Run the SCM utility on the server by typing the following in the address bar of your browser:

http://<webserver name>/<subdirectory>/w2hlegacy/config/hostwizard.html

2. Do one of the following:

• To quickly migrate profiles in batch mode, click the Conversion Utility tab, then follow the To runthe Conversion Utility procedure below.

• To convert and edit profiles individually, click Open an Existing Session or Import PC-to-HostProfile, then specify the profile to edit. When prompted to convert the profile prior to editing, clickOK. (For details on editing profiles, see Creating client profiles.)

Both migration methods ensure that your OnWeb Web-to-Host software incorporates the most recentversion numbers into the session HTML files. Once the new software is downloaded to the clientworkstations, the version numbers on client workstations and session files must match. If newparameters exist in the current product version that were not defined in the migrated profile, OnWebWeb-to-Host uses the default values.

3. When the user opens a migrated profile, the browser displays a standard security dialog box asking ifthe user wants to install and run software from Micro Focus.

Administrators should tell their users to click Yes (for Internet Explorer) or Grant (for Firefox).

18 | Creating and Migrating Client Profiles

To run the Conversion Utility1. If necessary, run the Session Configuration Manager in server mode, then click the Conversion Utility

tab. For details, see Steps 1 and 2 in the procedure above2. In the Current Directory box, type the drive and full path of the folder containing the session profiles to

convert.

• To change directories, in the Directories box, double-click either the double dot [..] or the directorynames until you are at the desired directory.

• To change drives, in the Current Directory box, type the drive letter followed by a colon (forexample, D:), then press Enter.

3. In the Files box, select the files to convert. You can select one or more files and convert themsimultaneously.

4. Click Convert.

The Results box shows the status of the requested conversion(s) by denoting Successful or Failednext to the file name(s).

• If the conversion is successful, the file is updated and the previous version is saved in the samedirectory with a .bak extension.

• If the conversion failed, your browser's Java™ Console output screen (found on the Internet ExplorerView menu or on the Firefox Window menu) contains an error message explaining why theconversion failed.

5. To exit the Conversion Utility, close the browser.

Migrating PC-to-Host profilesMoving from Rumba PC-to-Host to Web-to-Host does not mean you lose profiles or that those profilesmust be recreated. OnWeb Web-to-Host provides a migration wizard that makes upgrading fast and easyand allows you to continue using your old profiles. The migration wizard is part of the SessionConfiguration Manager.

PC-to-Host Profiles SupportedThe migration wizard converts the following PC-to-Host profiles:

Rumba Client File Extension

Mainframe Display .WDM

Mainframe Printer .WPM

AS/400 Display .WDA

AS/400 Printer .WPA

AS/400 File Transfer .RTO

AS/400 Batch Transfer .BTF

UNIX Display .WDU

HP Display .WDH

During the migration process, all relevant parameters are converted to either Java or Pro sessions andplaced in the Session Configuration Manager.

Creating and Migrating Client Profiles | 19

Note: It is recommended that you migrate profiles on the computer where Rumba PC-to-Host isinstalled. If you want to make the profiles available for other clients, you must manually copy the datafiles, keyboard maps, macros, and scripts to the Web-to-Host server.

To import profiles using SCM

1. Open the SCM utility in server mode.2. Click the Create or Edit Session tab.3. Select Open an Existing Session or Import PC-to-Host Profile , then either enter the full path or click

Browse to select the path of the file to import. When the file is imported, the Type option (whichdisplays the type of profile type imported) in the Create New Session box is dimmed, and theImplementation option is available.

4. From the Implementation drop-down list, select the client appropriate for the particular profile. Forexample, Java client or Pro Client.

5. Click Go. When the migration process is complete, the SCM opens with the imported data displayed inthe relevant option boxes. For example, the IP address that was in the Rumba PC-to-Host profile nowappears in the IP address box of the SCM. If Web-to-Host requires a parameter not found in theimported profile, it uses the default value and displays a Migration Notification listing the parameters notfound.

6. Once the profiles have been imported, assign a session name, then save and continue editing as youwould with any OnWeb Web-to-Host profile.

Creating client profilesThis section describes how to use the Session Configuration Manager to create a new OnWeb Web-to-Host client session for your users. The SCM utility saves your client configuration settings in an HTML filethat invokes a named OnWeb Web-to-Host client session.

The standard method in which the system administrator creates and configures the session profiles isknown as server mode. In this mode, the profiles must reside in a Web-published folder on the OnWebWeb-to-Host server. When the user opens a profile on the server, the client session is delivered to thedesktop through the browser.

To run the SCM utility, type the following in the address bar of your browser:

http://<webserver name>/<subdirectory>/w2hlegacy/config/hostwizard.html

To create or edit a client profileTo use the Session Configuration Manager utility to create or edit client profiles:

1. Run the SCM utility on the server or on your local workstation.2. Optional: For general instructions on using the SCM utility, click the Help tab. This tab also contains

links to the Readme file and this Administrator Guide.3. Click the Create or Edit Session tab, then do one of the following as needed:

• Create a new session. Click Create a New Session, then select the Type (host emulation sessiontype) and Implementation (Pro or Java client).

• Edit an existing session. Click Open an Existing Session, then specify the full path of the HTMLsession configuration file to edit. The Browse utility defaults to the location of the last savedconfiguration file.

4. Click Go!

The tabs for the selected host type and technology implementation appear.5. Optional: Click each tab, click ? at the bottom of the screen, then print the help pages for each tab.


6. Configure the settings on each tab as needed.

• For details on each field, see the online help. For details on configuring client start options,concurrent sessions, and multiple language support, see Configuring client profiles.

• The SCM utility displays an exclamation mark next to required settings, and provides many defaultsettings. You need to enter only a few unique settings to make your connections work correctly.However, you should check each tab to be sure you select the appropriate options for your needs.

7. To save the profile, click the check mark icon at the bottom of the SCM utility.

OnWeb Web-to-Host generates the HTML file and displays the Save As dialog box.8. Specify an appropriate folder in which to save the profile. In server mode, you must save the profile in a

Web-published folder. Otherwise, client sessions do not receive automatic updates from the webserver.

Note: In previous versions of OnWeb Web-to-Host, updates from the administrator deleted all userconfiguration. In this release, there are cases when administrator changes do not automatically deletethe user’s configuration (.cph) file. For more information, see User Profile Configuration.

Configuring client profilesThis section describes some of the common options you can configure when creating or editing clientprofiles in the Session Configuration Manager utility. See the online help supplied with SessionConfiguration Manager for a complete list of options related to each technology.

Start optionsThese options are located on the Session Options tab when creating or editing client profiles in theSession Configuration Manager utility.

Run in a Separate Window

This option applies only to Pro and Java display profiles.

The Run in a Separate Window option opens the client session in a separate windowoutside the Internet Explorer browser. If the client browser is Netscape, the session opensin a new browser window instead.

You can also use this option to configure a Pro display profile to launch multiplestandalone sessions using the same configured connection. For details, see Multiplesessions.

The default is Clear. The host session runs inside the browser.

Server URLWith this option, you have the ability to run sessions from a web server other than thedefault OnWeb Web-to-Host server. The URL you enter indicates the location of thealternate OnWeb Web-to-Host server.

Enable Local Start

This option applies only to client profiles created by running the SCM utility in server mode.For details on server mode, see Creating client profiles.

The Enable Local Start option allows users to run host sessions when the web server isunavailable. With this option, whenever the user opens a client profile stored on the webserver, OnWeb Web-to-Host copies that profile to the client workstation. The profile resideson the web server as an HTML file that is named after the client session. The profilelocation on the client workstation varies, depending on the client type and the browser:

• Pro sessions:


C:\Program Files\Micro Focus\Rumba\LocalStart

• Java sessions:

C:\<user profile>\My Documents\Micro Focus\Rumba\JavaLocalStart

It is best to run client profiles from the server to ensure that users have the most up-to-dateconfiguration and software.

When running Local Start profiles, help files are only available if, during configuration, theadministrator selected Install User Guide locally. Auto macro files and keyboard mapfiles configured by the administrator are cached on the client workstation when the sessionis downloaded from the server, so these local copies are accessible to the client sessionwhen the originating server is down. By default, Local Start is not selected.

Multiple sessionsUsers can run concurrent Web-to-Host sessions and switch between session windows to perform tasks.How users initiate multiple sessions and navigate between them depends on how you configure thesession profiles. There are three scenarios:

• Multiple sessions running in separate browser windows

By default, users must open multiple instances of the browser to start multiple client sessions. Userscan run concurrent host sessions and switch between sessions by clicking each browser window inturn.

• Multiple sessions running outside the browser

Administrators can configure Pro and Java display profiles to run in a separate window outside thebrowser (for details, see Start options). The user must open a new instance of the browser to launchanother host connection, but once the new session is connected to the host, the browser can be closedwithout losing the connection.

• Multiple Pro standalone sessions

Administrators can configure a Pro display profile to launch multiple standalone sessions using thesame configured connection. For example, a user can run two or more MyRumbaHost sessions, eachin its own window.

With this configuration, a new session opens in a separate window outside the browser whenever theuser accesses a session URL through the browser window. After launching one or more sessionwindows, users can close the browser without losing the host connection.

To configure multiple Pro standalone sessions:

1. Create or edit or the Pro session profile in the Session Configuration Manager, then click the SessionOptions tab.

2. Check both the Run in a Separate Window and the Allow Multiple Standalone Sessions options.3. To save this configuration, click the check mark icon at the bottom of the utility.

When you enable these two options, users can launch a new session window using any method thatrequests the session URL. For example, if your Web site includes a Pro display session namedDisplay.html, users can open multiple sessions by:

• Clicking a link on a Web page

If the Web page includes a link to http://<yoursite>/Display.html, users can click this link tolaunch a new session window.

• Refreshing the browser with the session URL listed in the address (or location) bar

When the browser’s address or location bar contains the session URL, users can click the Refresh (orReload) button on the browser toolbar to launch a new session.

• Typing the address in the address or location bar


If users have browsed to another location after opening the session, they can enter the session URL inthe address or location bar to launch another session window.

• Recalling the address from history

If users cannot remember the URL, they can open the browser’s history list and then select the sessionURL to launch a new session window.

Users can switch between sessions by clicking each of the windows in turn, or by using the taskbar. If thebrowser closes, the session windows remain open.

International client sessionsWhen using the Session Configuration Manager utility to create or edit client profiles, configure thesemultilingual options to meet the language needs of your users:

• Host Character Set (for AS/400 and mainframe display and printer sessions). Sets the host language(also known as the code page).

• UNIX character set options. The National Replacement Character Set replaces certain ASCIIcharacters with characters of the specified language. The Supplemental Character Set specifies thecharacter set used by the host.

Note: There are no configurable character set options for HP display sessions.

• Keyboard mapping options. Sets the country or custom keyboard map for Pro and Java displaysessions.

• Client Locale. Sets the language of the OnWeb Web-to-Host client user interface for display andprinter sessions.

You can set these options to use different languages if necessary. For example, you can set the userinterface to English and set the keyboard map and host character set to German.

Host Character SetWhen configuring Pro and Java AS/400 and mainframe display or printer profiles, this option appears onthe Connection tab.

To specify the Host Character Set, select the language character set (or code page) for the client session.If the host uses a non-English (United States) language, select the language used by the host.

The host character set includes commonly used marks, accents, letters and symbols of a specificlanguage. For example, if the host language is French, the host character set must also be French toensure that the special characters of French are correctly transmitted to the host and that the charactersreceived from the host display correctly in the client session.

The default setting is English (United States) - 37.

UNIX character set optionsWhen configuring a Pro UNIX Display, these options are located on the Client Options 2 tab. Whenconfiguring a Java UNIX Display, these options are located on the Character Set Options tab.

Keyboard mapping options

OnWeb Web-to-Host supplies numerous country keyboard maps to accommodate the special charactersand symbols used in various languages. You can deploy country keyboard maps in several ways. Forexample, you can standardize all the sessions on one country keyboard, or base the keyboard map on theclient workstation's Regional Settings, or enable the user to specify their own keyboard mappings.

When configuring display profiles, the available keyboard mapping options vary, depending on the sessionprofile type.

Pro display clients


When using the SCM utility to configure Pro AS/400, mainframe, UNIX, and HP displayprofiles, these options appear on the Keyboard Map and Auto Macro tab:

• Keyboard Map• Custom Keyboard Map

You can select a standard country keyboard map or specify a custom keyboard map (.mapfile) for the client session. For details on this procedure, see the online help for theKeyboard Map and Auto Macro tab. The Keyboard Map default is U.S.A. and theCustom Keyboard default is blank.

Note: To enable users to specify their own Pro keyboard map files, whichoverride the administrator-specified keyboard map, see the online help forthe SCM utility at the Client Options tab when configuring Pro displayprofiles.

Java display clients

When using the SCM utility to configure Java AS/400 and mainframe display profiles,these options appear on the Keyboard Map and Auto Macro tab:

• Custom Keyboard Map• Keyboard Locale

When configuring Java UNIX Display profiles, these options appear on the KeyboardOptions tab.

The default Custom Keyboard Map value is blank, and the client session uses a standardcountry keyboard map based on the keyboard Locale. For details on specifying a customkeyboard map (.map file), see the online help for the appropriate tab in the SCM utility.

The keyboard locale determines some default keyboard mappings for the client session.The default value uses a standard country keyboard map based on the Client Localesetting.

Note: To enable users to specify their own Java keyboard mappings,which will overlay the administrator-specified keyboard map, see the onlinehelp for the SCM utility at the Tool Options tab for Java UNIX Displayprofiles or the Client Options tab for Java AS/400 Display or JavaMainframe Display profiles.

Client Locale

When using the SCM utility to create or edit any profile (except Java UNIX profiles), this option appears onthe Client Options tab. For Java UNIX profiles, this option appears on the General Display Options tab.

For Pro, and Java sessions, the Client Locale specifies the language for the OnWeb Web-to-Host clientuser interface, which consists of the session window (including ToolTips and the status bar), dialog andmessage boxes, error messages, and help.

The default value is English.

Multiple language scenariosWhen running client sessions, users may need to view applications on an international host, require adifferent country keyboard map, or require the Web-to-Host client user interface in another language.These needs are met by configuring the Host Character Set, Keyboard Mapping options, and ClientLocale.

Different companies have different international language environments and require different display and/orprinter configurations. As such, it is impossible to provide a single procedure. This section lists possiblemulti-language scenarios to help you determine how to best configure the options for your internationallanguage environment.


In the following table, the first column lists the multi-lingual option, the second lists language scenarios, andthe third lists the suggested OnWeb Web-to-Host settings.

Note: There are multiple keyboard listings because OnWeb Web-to-Host provides several keyboardmapping options. For details on individual settings, see the Help associated with the tab in theSession Configuration Manager.

Option If Then

Host language The host uses a language (codepage) other than English (UnitedStates).

In the Host Character Set option,select the language of the host

Keyboard All clients are localized on onelanguage.

Pro. In the Keyboard Map option,select the country keyboard map, orspecify the full path of the CustomKeyboard Map file.

Java. Specify the Custom KeyboardMap file name or select theKeyboard Locale.

Clients are localized on differentlanguages as indicated by differentRegional Settings (Control tab) on theclient workstations.

Pro. Select Use Client RegionalSettings from the Keyboard Mapoption

Java. Specify a blank CustomKeyboard Map option (default) and<Default>.

Keyboard Locale (default).

Each client uses the keyboard mapbased on its regional settings.

Users need or want control over theirown keyboard maps.

Pro & Java. Enable end-userkeyboard mapping. User-createdkeyboard maps override any countrykeyboard map specified in theKeyboard Map option.

Client user interface The client user interface uses alanguage other than English and youwant Web-to-Host to use the samelanguage.

Select the appropriate language fromthe Client Locale option. (Note:OnWeb Web-to-Host supportsEnglish, French, and German.

Here are some other multi-language environments and suggested configurations:

• Clients connect to a host using the German language (code page) and their regional settings are set toGerman. In this scenario, you would set the client host character set, country keyboard map, and clientuser interface language to German.

• Clients connect to a host using the English (United States) language (code page), but their regionalrettings are set to French (Canadian). In this scenario, you would set the client host character set toEnglish (United States), but the country keyboard map and client user interface language to French(Canadian).

• Clients connect to a host using the English (United States) language (code page), but some clients'regional settings are set to French (Canadian) and others to German. In this scenario, you would wantto set the client Host Character Set to English (United States), deploy a country keyboard map basedon the client's regional settings, and set the language of the client user interface to either French orGerman.

• Clients connect to a host using the Spanish language (code page) and their localization settings are setto Spanish. In this scenario, you would set the Web-to-Host host character set and the countrykeyboard map to Spanish. However, because Web-to-Host does not provide a Spanish client userinterface, the client user interface language must be set to English, French, or German.


Java Web StartOracle Java Web Start Application Manager can now be used to manage Java sessions created in OnWebWeb-to-Host. Java Web Start enables users to be browser independent by running sessions in their own,separate window. (Users can also choose to run Java Web Start sessions via a standard browser.) WithJava Web Start Application Manager, users can add and remove sessions from their workstation andcreate desktop shortcuts for quick access to individual host sessions.

When a session is run for the first time using Java Web Start, all files required to run the session areautomatically downloaded and installed on the client workstation. After the first time, the application checksthe server-side session (JNLP) file and Java applet version. Updated files are downloaded automaticallywhen needed. If the server is unavailable when the check is performed, the session is run with the existingconfiguration.

Requirements

To run Java sessions with Java Web Start, you need the Java Runtime Environment (JRE) 1.6 or higher.

If you want to run Java Web Start sessions through a standard browser, the Web server to which youpublished the Web Start sessions must recognize the .JNLP extension and MIME Type, application/x-java-jnlp-file. If the server does not already recognize this type of file, you must add it manually.

Adding MIME TypesFor Apache servers:

1. From Program Files, browse to the Apache\conf folder.2. 2.Open the file mime.types in a text editor.3. 3.Add application/x-java-jnlp-file under MIME Type and JNLP under Extension.

For Windows 2003 servers with IIS 6 and for Windows 2008 Server with IIS7, this is done automatically bythe OnWeb Web-to-Host installer.

When hostwizard.html is being opened, the following error may occur:

Cannot add duplicate collection entry of type 'mimeMap' with unique keyattribute 'fileExtension' set to '.abc'

If this happens the following line should be removed from the web.config file:

<mimeMap fileExtension=".abc" mimeType="xyz/uvw" />

Creating sessions for Java Web Start deployment

You can create Java Web Start sessions from scratch or from Web-to-Host HTML sessions. The reversealso applies if you want to create an HTML Web-to-Host session from a Java Web Start session.

1. Create or edit a Java session in Session Configuration Manager (SCM).2. On the Session Options tab, select Enable Java Web Start (Oracle JVM only). (Clear the check box

to create an HTML Web-to-Host session.)3. In the URL folder box, enter the URL where you want to publish the session. (If you cleared the check

box, this option is unavailable.)4. Save the session.

Note: Java Web Start sessions should only be saved on a Web server. In addition, the full, legal URLpath to the location where you published the sessions must be entered in SCM. Sessions createdusing the localhost address, containing workstation names, or using an address obtained while


browsing to the file, for example with Windows Explorer, will not function properly. Sessions can besaved, however, to any Web server, even those that do not have OnWeb Web-to-Host installed.

When a Java Web Start session is run, the .JNLP file and associated applets are updated from theserver. However, the session itself runs locally from the client workstation. Sessions run locally do nothave access to online Help files unless you select the option Install user guide locally when creatingthe session.

Defining password level caching policyPassword level caching is involved with the AS/400 display or AS/400 file transfer.

On AS/400 hosts, password protection capabilities can be set to different levels, such as short or longpasswords. Client applications connecting to a AS/400 host must first query the password level set on thehost. This slows down overall system performance, increasing both connection time and network traffic.

To save time, OnWeb Web-to-Host caches password-level data, by default. The first time the passwordlevel is queried, the data is saved on the client PC. Afterwards, to avoid performance degradation, thecached password level value is used for each connection.

Cached data is host specific. Once the password level has been cached for a particular host, it is used byall sessions connecting to that host.

The following changes should be performed on the Java Script parts of the HTML session configurationfiles:

AS/400 Printer Pro Client

Comment out the old HostPwdLevel property setting.

AS/400 Display Pro Client

Comment out the old HostPwdLevel property setting.

Add the this.ResolvePwdLevelPolicy property setting to the stAS400DisplayProps() function:

Property setting Description

this.ResolvePwdLevelPolicy = 0 Query and cache the password level value once, and use itfrom now on. Default value.

this.ResolvePwdLevelPolicy = 1 Always query and cache the password level value on eachconnection.

this.ResolvePwdLevelPolicy = 2 Never query the host for the password level value, and usethe lowest password level value on each connection.

Example:function stAS400DisplayProps(){ this.SetMinFontSize = false; this.FontPointSize = 0; this.TypeAhead = true; this.AutoReset = false; this.StartupModelType = 2; // HostPwdLevel is now deprecated. It should be cleared from old sessions. //this.HostPwdLevel = false; this.SuppressDialogs = false; this.ResolvePwdLevelPolicy = 2; // (0=Once, 1=Always, 2=Never)}


Publishing client profiles to usersYou can use any usual Web publishing method to publish session profiles created by running the SCMutility in server mode to users. For example, you can:

• Provide the URLs of the session profiles for users to enter in the address bar of their browsers• Create an HTML page containing links to the sessions, and organize these links by host type or other

useful groupings.


OnWeb Client InstallationThis chapter describes procedures that users must follow when installing, updating, or removing OnWebWeb-to-Host files on the client workstation. If RUMBA® PC-to-Host software is installed on the clientworkstation, users should follow the procedures described in Coexistence: Pro and PC-to-Host instead, toensure successful coexistence with OnWeb Web-to-Host.

System requirementsThis section describes the minimum system requirements and configurations required for clientworkstations to run OnWeb Web-to-Host components.

Client operating systemOnWeb Web-to-Host supports these client operating systems:

• Windows 7 and 8• Windows Vista• Windows XP• Windows 2003

Microsoft Windows Installer (MSI), an installation and configuration service, must also be installed on theclient PC before installing OnWeb Web-to-Host Pro and advanced features of Java, such as native access.

If no MSI is on the client workstation, an error message is displayed. OnWeb Web-to-Host does not pre-install MSI. You can download the latest version, from:

http://www.microsoft.com/msdownload/platformsdk/sdkupdate/psdkredist.htm.

Client browserOnWeb Web-to-Host supports these browsers:

• Internet Explorer 6.0 or later (for all OnWeb Web-to-Host components) with these features enabled:

• ActiveX® and VB Script• JavaScript™

• Firefox (for Java components only) with these features enabled:

• Plug-ins• Java and JavaScript™

• Smart Update

Host requirementsJava AS/400 File Transfer clients require the following AS/400 host software:

• Clients without SSL require OS/400 version V4R3 or later• Clients with SSL require OS/400 version V4R4 or later

OnWeb Client Installation | 29

Client install and upgradeThis section describes how users install and update OnWeb Web-to-Host software when the client doesnot have Rumba desktop software also installed. Users must follow these procedures the first time theyopen a Web-to-Host session, and repeat these procedures each time OnWeb Web-to-Host software isupdated.

When the user initiates a Java session, the browser automatically verifies whether current OnWeb Web-to-Host files are installed for all host types. Installation procedures are specific to the client browser type. Prosessions are installed through the Service Manager.

Installing ProWeb-to-Host Pro components can be installed automatically using either the MSI Packager or the ServiceManager.

OnWeb Web-to-Host MSI Packager is a new utility for Pro Clients that replaces both CD Image Creatorand SetProInstallPath.exe. When integrated with the Service Manager it provides complete local startcapabilities. With MSI Packager you create custom installations that can be deployed on restricted-usersystems. You can add all of the Pro emulation types, SimXfer tables for AS/400 file transfer, RSS Clientsecurity, a VBA-type script engine, localized client Help, and distribution packages. For more informationon MSI Packager, see the online MSI Packager User Guide supplied with the product.

Service Manager is installed on client workstations by a user with administrator rights. Once the ServiceManager has been installed, it downloads and installs all Pro components regardless of user rights. Therest of this section describes installation using this component. By default, all Pro files are installed in:

C:\Program Files\Micro Focus\Rumba

Note: Web-to-Host Pro is compatible with Rumba PC-to-Host version 9.0 only. All other Web-to-Hostcomponents work with all versions of Rumba PC-to-Host. For details on co-existence restrictions forthe Pro component and Rumba PC-to-Host , see Coexistence: Pro and PC-to-Host.

Standard Install procedure: Pro1. From the browser, run the session HTML created by the Session Configuration Manager (SCM). As

Web-to-Host downloads and installs, a progress dialog is displayed.2. Depending on your browser security settings, the Security Warning may appear asking if you want to

install the Service Manager. Click Yes to run the install. Once the Service Manager is installed, allnecessary Pro ActiveX controls are installed and the session opens.

Note: There may be instances where a message appears in the browser window telling you to restartthe computer. If it appears, click OK. After restarting, open Internet Explorer, click the extension youwant to connect to, and proceed with your host session.

Silent Install procedure: Pro

As stated above, the standard Web-to-Host Pro installation displays a progress dialog while downloadingand installing. However, it is possible to run a silent installation. That is, an install and download with noprogress dialog displayed. To do this:

1. Navigate to \w2hlegacy\config\productcfg.xml, a file containing component descriptions andversion numbers.

2. In the <product _info> section, change the silent_install property to true. By default it is setto false. After editing, silent_install should be:

<silent_install value="true"/>.

30 | OnWeb Client Installation

3. After making the necessary change to productcfg.xml, follow the standard installation procedure.

Using License Manager: ProYou manage your OnWeb Web-to-Host Pro licensing by using the central license server. This must beinstalled beforehand on the dedicated machine in your organization.

Typically, licenses are downloaded and installed together with OnWeb Web-to-Host Pro clients. If thelicense server location in the organization changes, each client machine must be made aware of thechange by following the steps in Licensing a product using a central license server.

This section describes typical licensing tasks with which you should be familiar.

Licensing a product using a central license serverThis procedure describes how to license a workstation product if you want to obtain a license from acentral license server.

You need the IP address or server name for the central license server you want to access.

1. Open a command window.

2. Change working directory to:

%commonprogramfiles%\SafeNet Sentinel\Sentinel RMS License Manager\WinNT\

3. Run the following command:

CesCmdAdminTool.exe –server <Central_License_Server_Nameor_Address>

4. Press Enter.

Viewing installed licensesEnter the context of your task here (optional).




3. Run the following command: CesCmdAdminTool.exe –list

4. Press Enter.

Returning a perpetual license to a central license serverA perpetual license is a license checked out from a central license server onto your workstation andinstalled there until explicitly returned. To return a perpetual license:




3. Run the following command: CesCmdAdminTool.exe –list

4. Press Enter.

5. Copy the license name you want to return.

6. Run the following command:

esCmdAdminTool.exe –return <License_Name>

7. Press Enter.

OnWeb Client Installation | 31

Installing JavaThe Web-to-Host Java component can be installed automatically on both Internet Explorer and Firefoxclients. The installation procedure is the same for both browsers.

To install Java on IE and Firefox

1. From your browser, log on to the web server, and click a session name to request a host session.2. Depending on your browser security settings, the Security Warning dialog box may appear. Click Yes

to run the install, and your host session appears. Proceed with your host session.

Note: When installing on Internet Explorer, restricted users cannot install Java. However, once anadministrator installs Java, restricted users can run a Java session. On Firefox, local helpcomponents must be installed by an administrator before they can be used by restricted users.

Client uninstallYou may occasionally need to uninstall Web-to-Host components and reinstall them to reload lost files andcorrect other system problems. File and directory names and locations to which Web-to-Host componentsare installed vary by component, browser type and version. As a result, the procedures for uninstallingWeb-to-Host components are specific to each context, as described in the following sections.

Uninstalling ProBefore uninstalling you must first close any open windows. Use the following procedure to uninstall the Procomponent.

1. From your Windows desktop, click Start, point to Settings, and click Control Panel.2. Double-click Add/Remove Programs. The Add/Remove Programs Properties dialog box appears.3. From the Install/Uninstall tab, select Micro Focus OnWeb Web-to-Host Pro Client 6.4.0, and click

Add/Remove.4. From the Web-to-Host Pro Client Uninstall message box, click OK (to continue uninstalling the

program). The program uninstalls and you return to the Add/Remove Programs Properties dialogbox.

5. Click OK.

Note: You must delete one file manually.

1. Open c:\Windows\Downloaded Program Files\.2. Right-click Pro Client Persistent Session Control and select Remove.3. Click Yes to delete the file permanently.

Uninstalling JavaTo uninstall Java Session from Internet Explorer or Firefox , from the Java Control Panel, clearTemporary Internet Files.

Uninstalling Session Configuration ManagerWhen you run the Session Configuration Manager (SCM), the utility is installed locally if you are usingInternet Explorer, but is run from the cache if you are using Firefox.

To uninstall SCM from Internet Explorer or Firefox , from the Java Control Panel, clear TemporaryInternet Files.

32 | OnWeb Client Installation

Coexistence: Pro and PC-to-HostA Rumba PC-to-Host, a traditional desktop PC-to-Host application that runs on Microsoft Windows 7 and 8,Vista, XP and 2003 clients, and OnWeb Web-to-Host Pro component have shared executable files.Consequently, certain conditions must be met for both products to coexist on the same client workstation.

OnWeb Web-to-Host Pro 6.4 is completely compatible with Rumba PC-to-Host 9.0. In most cases, thereshould be no problems when applying feature TMPs to Web-to-Host Pro component and Rumba PC-to-Host.

Note: The Web-to-Host Java components are compatible with all versions of Rumba PC-to-Hostproducts.

By default, the OnWeb Web-to-Host Pro installation writes all program files on the client workstation to:


User data files are written to locations that vary depending on the user's environment. For details, see UserData File Locations.

Coexistence requirementsThe client workstation must meet these requirements for the Web-to-Host Pro component to coexist withRumba PC-to-Host:• The Rumba PC-to-Host product version must be version 9.0. The Pro software is currently not

compatible with earlier versions.• You must install both products in the same language.• If an incompatible Rumba PC-to-Host product is installed, you must remove it before installing the

OnWeb Web-to-Host Pro controls.To determine the way Pro deals with different coexistence conditions, edit the following parameters in thew2hservercfg.xml file, located in the config folder on the Web-to-Host server.• CoExistProblemBehavior value=”0 |1”.

A value of 0 means that, when an incompatible version of PC-to-Host is encountered, a messageappears stating that the version is incompatible and that installation of the OnWeb Web-to-Host Prosoftware has been halted. A value of 1 automatically uninstalls the incompatible version withoutnotifying the user.

• CoExistProblemMessage value=<message>.

A default message informs the user that an incompatible version has been detected. However, you cancustomize the message. This is useful if you want to include extra information, for example, help deskcontact information or the path to a compatible version of PC-to-Host. Changes you make to thew2hservercfg.xml file apply to all user sessions connecting to the server. User created files, such asmacros and keyboard mappings, are not deleted when the incompatible version is uninstalled.

Setting a custom install pathAs stated previously, by default, the OnWeb Web-to-Host Pro installation places all program files on theclient workstation in:


By default, Rumba PC-to-Host also places its program files in the same location. If Rumba PC-to-Host isinstalled first, OnWeb Web-to-Host Pro installs its program files to the same location and both products

Coexistence: Pro and PC-to-Host | 33

coexist. However, if OnWeb Web-to-Host Pro is installed first, the destination path in the Rumba PC-to-Host install wizard is dimmed and cannot be changed.

To install OnWeb Web-to-Host Pro first to a customized location, use the MSI Packager Utility located in\utils\MSIPackager. For more information on MSI Packager, see the online help supplied with theutility

Upgrading Pro and PC-to-Host softwareWhen you install a new OnWeb Web-to-Host release version or Service Pack, the new Pro softwareautomatically downloads to the client workstation when the user opens a Pro session. A start-up programcompares the Pro and PC-to-Host desktop software versions. If the versions are not compatible, the userreceives a message determined by the option configured in the w2hservercfg.xml file.

34 | Coexistence: Pro and PC-to-Host

User Profile ConfigurationIn OnWeb Web-to-Host there are two types of Pro configuration settings.

1. Administrator settings - created by Web-to-Host administrators using the Session ConfigurationManager (SCM) Wizard and deployed to the users as HTML session files.

2. User settings - stored in a local configuration file (.cph). If, in the SCM Wizard, the administrator hasenabled editing specific options, users create their own customized local configurations settings foroptions, such as interface color, toolbars, menus, keyboard map or logon script.

In previous versions of OnWeb Web-to-Host, when the administrator made changes to Pro HTML sessionfiles, all user changes were reset (deleted).

OnWeb Web-to-Host 6.4 provides a new mechanism that preserves user changes. The SCM Wizardchanges do not automatically delete the user's .cph file. Settings which only the user can set are notdeleted when you, the administrator, change the HTML session files. This means users do not lose theircustomized environment with its colors, toolbars, and keyboard mappings.

This chapter lists the conditions that determine which configuration file takes precedence, if both an HTMLsession files and a user .cph file exist. It also explains how the configuration file is handled when includedwithin a distribution package.

Rules defining Pro behaviorThe following sections list the rules for determining the settings implemented - default settings in HTMLsession files or user customized .cph settings.

No user configuration (.cph) file existsThe first time the user opens a session no user .cph file exists. Consequently, the userreceives the options defined in the SCM Wizard.

Existing user configuration (.cph) file

When a user .cph file exists, the following rules apply:

1. If a .cph file exists, but no particular option is enabled, the user receives the defaultoptions set in the SCM Wizard. This is because you have not given the user permissionto modify options. For example, if a user .cph file exists but you did not select EnableEdit Options, the user cannot create a customized configuration with features, such asword wrap or type ahead. The user is required to use the values set in the HTMLsession file.

2. If a .cph file exists and a particular option is enabled, the user can customize theconfiguration. For example, if Enable Edit Options is selected, the user can create apersonalized environment that allows features, such as word wrap, type ahead, andkeyboard auto reset. In this case, if you make changes to the HTML session fileincluding those features which the user has customized, the user .cph file is notdeleted and the customized environment remains in effect. To enforce the use of thedefault HTML settings, you should disable the relevant option, for example, EnableEdit Options. Then the HTML settings override user settings for those options only. Allother user configurations remain in effect.

User Profile Configuration | 35

User configuration files in a distribution packageAs an administrator you can create a user .cph file from the session’s HTML configuration and include it ina distribution package. This means the user starts with a customized, pre-configured session. It alsomeans that you can provide the user with more configurable client options than you can assign through theSCM Wizard. You can enable a particular client option, modify its settings using the option dialog, insertthe session configuration file into a distribution package and then optionally disable the option (dependingon whether or not you want to allow further user editing).

For example, selecting Enable Edit Options in the SCM Wizard allows you to open the Edit Optionsdialog box within a session and choose clipboard and parsing options that are not part of the SCM Wizard.The additional settings are added to the user .cph file. Then you can associate the session .cph file to adistribution package. If you want to maintain standardization, you can disable edit options.

In all cases, if you modify the distribution package, the new user configuration replaces the user’s previousfile, deleting all user settings.

36 | User Profile Configuration

User Data File LocationsOnWeb Web-to-Host stores user data on the client in a location specified by the user’s environment. Thislocation is determined by several environmental variables, such as the client operating system andbrowser, and whether roaming user profiles are enabled.

Roaming profile support for Pro and Java sessionsWhile normal Windows profiles store user environment settings on the client workstation, roaming userprofiles store this information on their server. When a user logs on to the server, the roaming profile isdownloaded to the client workstation. When the user logs off the server, the roaming profile (along with anychanges) is uploaded back to the server. This scenario enables the user to work on different clientworkstations while using the same environment settings.

OnWeb Web-to-Host supports roaming user profiles for Pro and Java client sessions. Users with roamingprofiles can access their custom settings (such as keyboard maps and macros) when running Pro andJava sessions on various workstations.

Default paths for user data filesThis section lists the user data file locations for a client workstation with a default Windows installation.

Pro sessions using Internet ExplorerIf Rumba PC-to-Host has been previously installed on the client workstation, Web-to-Host stores user datafiles in the same location. If not, these locations are read from the Windows registry.

• Windows 2003 and Windows XP

c:\Documents and Settings\username\Application Data\Micro Focus\Rumba

• Windows Vista, Windows 7 and 8

c:\Users\username\AppData\Local\Micro Focus\Rumba

You can use the MSI Packager utility to modify default user data file locations. For more information onMSI Packager see the online help supplied with the product.

Java sessions using Internet Explorer and FirefoxThe Internet Explorer locations are the same as for the Pro sessions using Internet Explorer.

For Java sessions using Firefox:

• Windows Server 2003 and Windows XP

Windows Server 2003 and Windows XP use the USERPROFILE environment variable.

c:\Documents and Settings\username\Application Data\Micro Focus\Rumba

• Windows Vista, Windows 7 and 8

c:\Users\username\AppData\Local\Micro Focus\Rumba

User Data File Locations | 37

Creating a TraceThe Trace Utility is a diagnostic tool for troubleshooting host communications and connectivity problems.With this utility you can trace activity within host software or other standardized components linked toOnWeb Web-to-Host. This chapter describes how to use the Trace Utility to get a binary trace that can besent to Micro Focus Technical Support for additional help troubleshooting your problems.

The Trace Utility is supplied with the Java emulators. However, it must be installed separately for Pro.

Setting trace in Java SessionsJava tracing is enabled through a set of parameters configured in the Session Configuration Manager(SCM). In all Java Display and Printer sessions, tracing is controlled from the Custom Options tab.Tracing in these emulations is at two levels.

• Host Interface Tracing - captures Telnet data that flows between the emulator and the host.• Session Tracing - captures the emulator specific data stream data.

The following parameters must be entered with a value of either True or False in the Value column:

• EnableHostInterfaceTracing and EnableSessionTracing determine if these levels arecaptured.

• HostInterfaceTraceFile and SessionTraceFile specify the path where the trace files arewritten and the name assigned to them. If they are left blank, trace data is written to the Java console(when enabled).

• EnableTraceControlButtons, when set to True, adds Record, Stop, and Pause buttons to theemulator's toolbar.

When tracing is enabled, but EnableTraceControlButtons is not set to True, tracing is always on,and begins as soon as the emulator initiates its connection.

Notes:

• The Java UNIX Display does not have a Customs Options tab. Use the Trace Options tab to setall trace parameters.

• For Java AS/400 File Transfer, tracing is set from the General Options tab. Clicking EnableTrace results in a new trace control button on the emulator’s toolbar.

Setting trace in Pro SessionsPro uses the Rumba Trace Utility that comes with Rumba as standard. If Rumba is installed, then use itstrace utility.

If Rumba is not installed, you can download the Trace Utility from the server hosting OnWeb Web-to-Host.Type the following URL into the address bar of any Web browser.

http://<servername>/w2hlegacy/utils/installrumbatrace.exe

To take a correct binary trace:

1. Select Start > Programs > Micro Focus Rumba > Rumba Tools > Micro Focus Rumba 9.0 Trace.2. From the Options menu, choose Configuration.3. On the API Selection tab, click Select All. After all entries have been selected, click Reset All.

38 | Creating a Trace

4. On the Output tab, in the Formatted Output section, select Display.5. In the Binary Output section select Binary File. The box next to the option becomes available.6. Enter the full path (or browse to it) for the binary file being created. For example, you might assign the

file the call log number, c368758.bin. All file names should end with the extension .bin.7. Click OK.8. Minimize the Rumba Trace window that appears.9. Run the Rumba application that is causing the problem as you normally would, starting from the

connection (for example, Rumba Display, or Printer). Let the program run until the problem appears(error message, session hanging or any other problem).

10.Log off and disconnect from the host.11.Maximize the Rumba Trace window.12.Select File > Exit.13.Send the binary file you created in Step 6 on page 39, via email to Micro Focus Technical Support.

Important: Before starting the procedure, close all applications. If you are using the Rumba Engine,make sure it is closed. Be sure there are no blue and red icons in the tray bar.

Creating a Trace | 39

Contacting Micro FocusMicro Focus is committed to providing world-class technical support and consulting services. Micro Focusprovides worldwide support, delivering timely, reliable service to ensure every customer's businesssuccess.

All customers who are under a maintenance and support contract, as well as prospective customers whoare evaluating products are eligible for customer support. Our highly trained staff respond to your requestsas quickly and professionally as possible.

Visit http://supportline.microfocus.com/assistedservices.asp to communicate directly with Micro FocusSupportLine to resolve your issues or email [email protected].

Visit Micro Focus SupportLine at http://supportline.microfocus.com for up-to-date support news and accessto other support information. First time users may be required to register to the site.

Information Needed by Micro Focus SupportLineWhen contacting Micro Focus SupportLine, please include the following information if possible. The moreinformation you can give, the better Micro Focus SupportLine can help you.

• The name and version number of all products that you think might be causing an issue.• Your computer make and model.• System information such as operating system name and version, processors, and memory details.• Any detailed description of the issue, including steps to reproduce the issue.• Exact wording of any error messages involved.• Your serial number.

To find out these numbers, look .

40 | Contacting Micro Focus

http://supportline.microfocus.com/assistedservices.asp

http://supportline.microfocus.com

Tell Us What You ThinkWe welcome your feedback regarding Micro Focus documentation.

Send feedback about this Help documentation.

Click the above link to email your comments to Micro Focus.

Tell Us What You Think | 41

mailto:[email protected]?subject=Web-to-Host Documentation Feedback

Date post:	27-Jul-2018
Category:	Documents
Upload:	hoanghanh
View:	216 times
Download:	0 times