Exceed

ExceedUsers Guide

8370-3M

ii

Exceed Users Guide0800 8370-3M7/31/02

Hummingbird Ltd.1 Sparks Avenue, Toronto, Ontario, Canada M2H 2W1Tel: +1-416-496-2200 Toll Free Canada/USA: 1-877-FLY-HUMM (1-877-359-4866)Fax: +1-416-496-2207E-mail: [email protected] or [email protected]: ftp.hummingbird.comFor more information, visit www.hummingbird.com

RESTRICTED RIGHTS LEGEND. Unpublished rights reserved under the copyright laws of the United States. The SOFTWARE is provided with restricted rights. Use, duplications, or disclosure by the U.S. Government is subject to restrictions as set forth in subparagraph (c) (1) (ii) of The Rights in Technical Data and Computer Software clause at DFARS 252.227-7013, subparagraph (c) (1) and (2) (a) (15) of the Commercial Computer Software-Restricted Rights clause at 48 CFR 52.227-19, as applicable, similar clauses in the FAR and NASA FAR Supplement, any successor or similar regulation.

Information in this document is subject to change without notice and does not represent a commitment on the part of Hummingbird Ltd. Not all copyrights pertain to all products.

19902002 Hummingbird Ltd. All rights reserved.

Exceed, Exceed 3D, Exceed onDemand, Exceed PowerSuite, Exceed X Development Kit, Exceed Web, HostExplorer Print Services, HostExplorer, HostExplorer Web, HostExplorer Deployment Wizard, Hummingbird Connectivity Security Pack, Hummingbird Basic Language, Hummingbird Portal, Hummingbird Core Services, Hummingbird e-Toolkit, JuMP, Enterprise Toolkit for JuMP, Hummingbird e-Gateway, Hummingbird FTP, Hummingbird G2G, Hummingbird Web Server, Hummingbird SOCKS Client, Hummingbird Connectivity SSL, NFS Maestro Client, NFS Maestro Gateway, NFS Maestro Server, NFS Maestro Solo, PrintExplorer, and XWeb are trademarks of Hummingbird Ltd. and/or its subsidiaries.

ACKNOWLEDGEMENTS Portions of the code have been contributed by MIT. OpenGL is a registered trademark of Silicon Graphics Inc. WinHelp extensions copyright Blue Sky Software Corporation.This product includes software developed by the OpenSSL Project for use in the OpenSSL Toolkit (http://www.OpenSSL.org/). All rights reserved. All other copyrights, trademarks, and tradenames are the property of their respective owners.

FONTS The fonts distributed are included free of charge. Some of the fonts were donated towards Exceed development by Adobe Systems Inc., Bitstream Inc., MIT, and Sun Microsystems Inc. Each font contains a copyright message describing the owner of the font.

DISCLAIMER Hummingbird Ltd. software and documentation has been tested and reviewed. Nevertheless, Hummingbird Ltd. makes no warranty or representation, either express or implied, with respect to the software and documentation included. In no event will Hummingbird Ltd. be liable for direct, indirect, special, incidental, or consequential damages resulting from any defect in the software or documentation included with these products. In particular, Hummingbird Ltd. shall have no liability for any programs or data used with these products, including the cost of recovering such programs or data.

Related Documentation and Services

ManuaAll manuaonly if you

HelpThe onlineIt containstasks.

Release NThe release

available ininstalling y

Exceed U

HostExplo

HostExploformat on

HummingGuideiii

lsls are available in print and online. The online versions require Adobe Acrobat Reader 5.0 and are installed do a Complete installation. Your Hummingbird product comes with the following manuals:

Help is a comprehensive, context-sensitive collection of information regarding your Hummingbird product. conceptual and reference information, and detailed, step-by-step procedures to assist you in completing your

otes notes for each product contain descriptions of the new features and details on release-time issues. They are

both print and HTML. The HTML version can be installed with the software. Read the release notes before our product.

sers Guide Provides information on how to install Exceed, connect to hosts, configure Exceed, manage and explore services, and run X clients.

rer Host Access Users Guide Provides information on how to access corporate mainframe data through HostExplorer terminal emulation components, as well as how to automate and configure host sessions.

rer Programmers Guide (.pdf ly)

Provides programmers with information on how to customize HostExplorer, FTP, and WyseTerm through Visual Basic and Visual C++ scripts using HostExplorer APIs.

bird Basic Language Programmers Provides procedural and reference information, tips, and suggestions for working with Hummingbird Basic Language using Hummingbird Basic Workbench and Dialog Editor.

iv

Hummingbird Expos Online

Hummingbird Expos Online is an electronic mailing list and online newsletter. It was created to facilitate the delivery of Hummisubscribe/

htt

User GroThe user gusers resol

To join a u

Send an e-following:

To unsubs

Send an e-following:

To post a m

Send your

To search

Go to the fngbird product-related information. It also provides tips, help, and interaction with Hummingbird users. To unsubscribe, browse to the following web address:

p://www.hummingbird.com/expose/about.html

ups and Mailing Listsroup is an unmoderated, electronic mailing list that facilitates discussion of product-related issues to help ve common problems and to provide tips, help, and contact with other users.

ser group:

mail to [email protected]. Leave the Subject line blank. In the body of the e-mail message, type the

subscribe exceedusers Your Name

cribe:

mail to [email protected]. Leave the Subject line blank. In the body of the e-mail message, type the

unsubscribe exceedusers Your Name

essages to the user group:

e-mail to:

[email protected]

the mailing list archives:

ollowing web site:

http://www.hummingbird.com/support/usergroups.html

Chapter

About EExceExce

Other ExExceExce

Chapter

OverviewWinHumMul

PreparinInstaChoInstaInsta

InstallatiPersSetuProgAdm

Typical IPersInstaAdvSilen1: Introducing Exceed 1

xceed ............................................................................................................. 3ed Applications ................................................................................... 5ed Tools .............................................................................................. 6

ceed Products .............................................................................................. 7ed X Development Kit (XDK) ........................................................... 7ed 3D .................................................................................................. 7

2: Installing Exceed 9

................................................................................................................... 11dows Installer Technology ................................................................ 11mingbird Setup Wizard ................................................................... 13

ti-Language Support .......................................................................... 15

g to Install .................................................................................................. 17llation Requirements ........................................................................ 18

osing a Setup Type ............................................................................ 19llation Directories ............................................................................ 20lled Files ........................................................................................... 21

on and Maintenance ................................................................................. 23onal Installation ................................................................................ 23p Types .............................................................................................. 26ram Maintenance for Personal Installations .................................... 31inistrative Installation ...................................................................... 32

Contentsv

nstallation Scenarios ................................................................................. 35onal Installations .............................................................................. 35lling onto a Terminal Server ............................................................ 38

ertised Product .................................................................................. 38t Installation ..................................................................................... 39

vi

Exceed Users Guide

Shared Installation ................................................................................... 42Hummingbird Sconfig ............................................................................. 43

PreservinVersVers

Updatin

Registeri

Chapter

InstallinStagStag

Uninstal

Customi

About WMic

WorkingAbo

CustomiCrea

SelectingAddModRem

SelectingAddModRem

Setting PAddModRem

Setting tAddModRemg User Profiles .......................................................................................... 44ion 6.2 User Profiles .......................................................................... 44ion 7 User Profiles ............................................................................. 45

g the Product .............................................................................................. 45

ng ................................................................................................................ 46

3: Advanced Installation 47

g on a Terminal Server ............................................................................... 49e 1: Creating an Administrative Copy Image .................................... 49e 2: Personal Installation ................................................................... 51

ling from a Terminal Server ...................................................................... 54

zing Installations with Sconfig .................................................................. 55

indows Installer Database Files ................................................................ 56rosoft Transform Files ........................................................................ 56

with Transform Files in Sconfig .............................................................. 57ut Creating Transform Files in Sconfig ............................................. 58

zing Product Directories ........................................................................... 60ting Custom Folders ......................................................................... 61

Features to Install ..................................................................................... 64ing a Feature to an Installation Database .......................................... 64ifying a Feature in an Installation Database ..................................... 65oving a Feature from the Installation Database ................................ 65

Files to Install ........................................................................................... 66ing a Custom File to an Installation Database ................................... 66ifying a Custom File in an Installation Database .............................. 68oving a Custom File from an Installation Database ......................... 68

roduct Properties ...................................................................................... 69ing a Custom Property to an Installation Database .......................... 70ifying a Custom Property in an Installation Database ..................... 71oving a Custom Property from an Installation Database ................. 72

he Registry .................................................................................................. 72ing a Custom Registry Key to an Installation Database .................... 73ifying a Custom Registry Key in an Installation Database ............... 74oving a Custom Registry Key from an Installation Database ........... 75

Contents

Setting Shortcuts for Hummingbird Product Features ......................................... 76

Setting NFS Maestro Client Settings ....................................................................... 78

Setting E

Setting CSettiAddModRemRemSettiAddModRem

Setting PSetti

Saving th

Applying

Creating

Running

CustomiCustAddUpdDisaCon

Chapter

ConnectUsinRunCreaBrowLoadHosCreaRunCreavii

xceed Properties ........................................................................................ 78

ustom Font Directories and Servers ........................................................ 79ng Custom Font Directories ............................................................. 80ing a Custom Font Directory and Font Files ..................................... 80ifying a Custom Font Directory ....................................................... 82oving a Custom Font Directory ........................................................ 83oving a Custom Font File ................................................................. 84ng Custom Font Servers .................................................................... 84ing a Custom Font Server .................................................................. 84ifying a Custom Font Server ............................................................. 85oving a Custom Font Server ............................................................. 86

aths for Font Directories/Servers ............................................................. 87ng Font Paths .................................................................................... 87

e .mst File ................................................................................................. 88

the .mst File to an Install ........................................................................ 88

Multiple Custom Installations ................................................................. 89

Sconfig from a Command-line ................................................................ 90

zing Hummingbird Connectivity Settings Installation ........................... 92omizing Files and Folders ................................................................. 93ing Registry Entries ........................................................................... 93ating the Personal User Directory for All Users ............................... 94bling Migration for Per-user Installations ........................................ 95trolling the Uninstallation ................................................................. 95

4: Connecting to Hosts and Running X Clients 97

ing to Hosts ................................................................................................ 99g the X Client Wizard ....................................................................... 99ning Multiple Exceed Sessions ........................................................ 100ting a Startup File ........................................................................... 101sing for Hosts and Applications .................................................... 105 optimization ................................................................................. 108

t and Application Files ..................................................................... 111ting an Xstart Shortcut ................................................................... 112ning the Xstart File .......................................................................... 113ting a Wstart File ............................................................................ 115

viii

Exceed Users Guide

Using Xstart on VMS Systems .............................................................................. 116TCP/IP Transports ................................................................................. 116DEC

CommoUsin

Window

Using WStarStar

CopyingUsinCopCopCopAuto

Chapter

AdvanceUsinCreaOptRun

RunningRunThe CreaRunMul

Using ExSetti

Chapter

About XXcoXco

Mouse, KKeybnet Transports ................................................................................. 117

n Desktop Environment (CDE) .............................................................. 118g Desktop Environments for Linux ................................................ 118

Modes ..................................................................................................... 119

indow Managers ..................................................................................... 120ting HWM or MWM ....................................................................... 121ting Remote X Window Managers ................................................... 121

and Pasting .............................................................................................. 122g a Temporary Storage Buffer ........................................................ 122ying and Pasting Data ..................................................................... 123ying and Pasting Graphics .............................................................. 124ying and Pasting Between X Clients ................................................ 126matic Copy and Paste .................................................................... 127

5: Advanced Connection Methods 129

d Xstart Features ...................................................................................... 131g Login Macros ............................................................................... 131ting a Universal Login ..................................................................... 132

imizing System Loads ....................................................................... 133ning Multiple Xstart Sessions on One Host .................................... 134

Multiple Xstart and Wstart Sessions ..................................................... 134ning the Xsession ............................................................................. 137Xsession File Sequence .................................................................... 137ting an Xsession Shortcut ............................................................... 137ning Multiple CDE Sessions ............................................................ 138tiple X Display Support ................................................................... 139

ceed on a Remote PC ............................................................................. 141ng Up X Web ................................................................................... 142

6: XconfigConfiguring Exceed 143

config ........................................................................................................ 145nfig Window ..................................................................................... 145nfig Password .................................................................................. 147

eyboard, and Other Input Devices ........................................................ 148oard Input Settings ......................................................................... 148

Contents

Mouse Input Settings ............................................................................. 151Input Methods for Chinese, Japanese, and Korean ............................... 155Spec

NetworkComTran

Security,SecuSyst

X ServerX SeExte

Display aConConComMonVideAdv

Copy anSpec

Font MaManAcceCreaCrea

Other SeMaxPowTrou

OpenGL

Xconfig Rem

Chapter

IntroducTCPix

ial Considerations for Traditional Chinese .................................... 157

and Communication .............................................................................. 160munication Settings ....................................................................... 160sports Settings ................................................................................ 162

Access Control, and System Administration ........................................ 163rity and Access Control Settings ..................................................... 163

em Administration .......................................................................... 167

Protocol ................................................................................................... 169rver Options and Extensions ........................................................... 169nsions Settings ................................................................................. 170

nd Video .................................................................................................. 171figuring X Screens ........................................................................... 171figuring Window Mode ................................................................... 173mon Settings ................................................................................... 176itor Information ............................................................................. 177o Settings ........................................................................................ 179

anced Settings .................................................................................. 181

d Paste, and X Selection ........................................................................... 183ifying X Selection Type ................................................................... 183

nagement .................................................................................................. 184aging the Font Database ................................................................. 185ssing the Font Server ...................................................................... 187ting Font Aliases ............................................................................. 189ting Several Aliases ......................................................................... 190

rver Settings ............................................................................................. 192imizing System Performance .......................................................... 192er Management Settings .................................................................. 195bleshooting ..................................................................................... 196

.................................................................................................................. 198

Microsoft Management Console ............................................................ 199ote Configuration ........................................................................... 199

7: System AdministrationInetd and Inetd Admin 201

ing Inetd .................................................................................................. 203 and UDP Servers ............................................................................ 204

xExceed Users Guide

Maintaining System Security ................................................................................ 204Security for Windows 98/Me .................................................................. 204Secu

Default SBOOFingFTPLPDTelnXstaTFTTimTna

Managin

Configu

AdminisCreaGran

Chapter

About DAboAboOpe

DirectorDireDireServ

Binding AboCreaOpeBindBindKeylBind

Using HSelerity for Windows NT/2000/XP ........................................................ 205

ervices ...................................................................................................... 207TPd (Windows NT/2000/XP) ........................................................ 208

erd .................................................................................................... 209d (File Transfer Protocol Daemon) ................................................. 209 ......................................................................................................... 211etd .................................................................................................... 213rtd .................................................................................................... 213Pd ..................................................................................................... 215ed ..................................................................................................... 216med ................................................................................................... 216

g Services ................................................................................................. 217

ration Parameters ..................................................................................... 219

tering Daemon SecurityInetd Admin ................................................ 224ting and Managing the Password File ............................................. 225ting Anonymous FTP Access .......................................................... 230

8: Hummingbird Directory Services 233

irectory Services Applications ................................................................ 235ut Hummingbird Directory Services ............................................... 235ut Directory Services Explorer ......................................................... 235ning Directory Services Applications .............................................. 236

y Services Overview ................................................................................. 237ctory Service Protocols .................................................................... 238ctory Service Objects ....................................................................... 239er Architecture ................................................................................. 240

to a Domain ............................................................................................. 240ut Directory Service Profiles ............................................................ 241ting a Profile .................................................................................... 242ning a Properties Dialog Box ........................................................... 244ing to NIS ........................................................................................ 245ing to NIS+ ..................................................................................... 247ogin and the System Profile ............................................................ 250ing to LDAP .................................................................................... 251

ummingbird Directory Services .............................................................. 257cting a Service .................................................................................. 257

Contents

Modifying a Profile ................................................................................ 258Disabling User Profiles ........................................................................... 259SpecSyncRunRun

Using DQueSortSaviViewModCha

Append

Installati

Exceed DTrouLogs

Append

Accessor

HostExp

Product

FTP for

Append

AccessibMic

Technica

Indexxi

ifying a Host Lookup Service .......................................................... 259hronizing Passwords ....................................................................... 260ning Keylogin .................................................................................. 261ning Command Line Applications .................................................. 261

irectory Services Explorer ........................................................................ 262rying Directory Service Objects ....................................................... 262ing Query Results ............................................................................ 263ng Query Results .............................................................................. 264ing Object Properties ..................................................................... 265ifying a Profile ................................................................................ 266

nging a Domain Password ............................................................... 266

ix A: Troubleshooting 269

on Troubleshooting ................................................................................ 271

iagnostics ................................................................................................ 274bleshooting Xstart .......................................................................... 274 and Trace Operations .................................................................... 276

ix B: Connectivity Applications 279

ies .............................................................................................................. 281

lorer Accessories ...................................................................................... 282

Administration ........................................................................................ 283

Windows Explorer ................................................................................... 284

ix C: Accessibility and Technical Support 285

ility ............................................................................................................ 287rosoft Accessibility Options ............................................................. 288

l Support .................................................................................................. 289

291

Chapter 1Introducing Exceed

About Exceed 3Exceed Applications 5Exceed Tools 6

Other Exceed Products 7Exceed X Development Kit (XDK) 7Exceed 3D 7

Chapter 1: Introducing Exceed

About Exceed

For an overvapplicationsExceed, seeApplications3

Exceed lets you access applications on UNIX workstations from existing Windows 2000/XP, Windows NT, and Windows 98/Me-based personal computers. It lets you run and display UNIX, Linux, VMS, or X Windows applications (X clients) and integrates your desktop with X Window Systems, IBM mainframes, and the Internet.

Exceed includes innovative features that accelerate performance, simplify system administration, optimize personal computing, and delivers ease of use. Users are shielded from the complexities of network computing by working within the familiar Microsoft Windows environment. Exceed is an integrated part of the Hummingbird Host Access Solutions product family which provide organizations with a comprehensive Host Access and Network Connectivity solution.

iew of the available in Exceed on page 5.

By using Exceed to run remote applications on your local PC, you can:

access powerful applications and information running on networked hosts

establish simultaneous connections to different computers running X clients

use an appropriate window manager to preserve your familiarity with the PC or X environment

For system administrators, Exceed provides tools to set up, configure and administer PCs remotely to ensure consistency among systems.

Exceed Users Guide

4

X Window Systems and ExceedExceed converts your PC into an Exceed X server. In the X Window environment, the Exceed X server is also referred to as an X window terminal or display server. Without Exceed X server software, X applications are accessible only via X terminals, UNIX, Linux, and VMS workstations.

Exceed works with your network transport software (TCP/IP, DECnet, or IPX/SPX) or your modem, to access X Windows applications on host computers running the X Window System. The host can be any operating system that is running the X Window environment.

The figure below shows how Exceed lets your PC access the X Windows environment.

Host terminals

Applications

Your PC

Displays X Window applications on the Exceed X server

Transport software

UNIX Host


Exceed Applications5

The Exceed software package includes applications that serve distinct functions. The applications are listed and briefly described below.

X Client Wizard This application guides you through the process of creating a connection to a host. See Chapter 4: Connecting to Hosts and Running X Clients on page 97 for details.

Xconfig Xconfig is a utility for configuring a variety of Exceed settings: input, communication, video, protocol, security, window modes, performance, X selection, fonts, troubleshooting, and transport settings. For details, see Chapter 6: XconfigConfiguring Exceed on page 143.

Xstart Xstart is an application for automating access to hosts and starting applications. Use Xstart to create Xstart (.xs) startup files and create shortcut icons to your UNIX, Linux and X applications. When you click on these icons, they automatically establish a host connection, log on, and then start an X client, a character-based host application in a terminal emulator window, or run a host-based script. For details, see Chapter 4: Connecting to Hosts and Running X Clients on page 97.

Xsession Xsession lets you start multiple X clients (Xstart files) and Windows programs (Wstart files) simultaneously. For details, see Chapter 4: Connecting to Hosts and Running X Clients on page 97.

Exceed Exceed X server is a PC X server that displays graphical UNIX, Linux, and X applications on your PC.

Exceed XDMCP Broadcast This shortcut lets you start the Exceed X server in XDMCP broadcast mode.

Exceed XDMCP Query This shortcut lets you start the Exceed X server in XDMCP query mode.

Exceed Help This is the Help documentation that installs with the Complete setup type or if you specify its installation in a Custom setup type.

You can use the Exceed startup applications to connect to a host and display UNIX, Linux, VMS and X applications on your PC. You can use the Client Wizard to guide you through this process, or set up the connection manually.

Exceed Users Guide

6

Throughout this guide, xterm (a UNIX VT100 terminal emulator) is used as a sample X client. It provides a terminal emulation window on the host, and

a command line where you can start other X clients.

Exceed ToolsThe following tools are shipped with Exceed, and are located in the Tools folder:

HWM This tool is Hummingbirds local Motif-like window manager. It is a local X client that provides you with a graphical interface that you can use to start and exit clients, and position and iconize the windows on your display. For more information, see Starting HWM or MWM on page 121 or the Exceed Help.

Transport Monitor This tool lets you monitor the status of current connections and the total number of open connections. It also indicates whether your transport is operating successfully. For more information, see the Exceed Help.

Xdis The X disassembler is a diagnostic tool that lets advanced Exceed users and system administrators view Exceed trace files. It is a Java component and requires the Java Virtual Machine. For more information, see the Exceed Help.

MWM and KINPUT2 tools are shipped with Exceed XDK. For more information, see the Exceed X Development Kit Users Guide.


Other Exceed Products

These produincluded wiacquire ExcExceed 3D, Hummingbirepresentati7

cts are not th Exceed. To eed XDK and contact a rd sales ve.

Exceed X Development Kit (XDK) The X Development Kit (XDK) lets you create your own local X clients and port programs originally developed for the X environment so that they run on your PC. For more information on the XDK application, refer to the X Development Kit User's Guide.

Exceed 3D This application lets you display OpenGL-based X applications, and lets you create OpenGL X applications with Exceed XDK. OpenGL is a 3D graphics software interface that lets you create interactive programs that produce still or animated 3D color objects, including shading, lighting, and other effects.

Exceed 3D interprets OpenGL calls from an X application, and sends the information to the video card on your PC. For more details, refer to the Exceed 3D Users Guide.

Chapter 2Installing Exceed

Overview 11Windows Installer Technology 11Hummingbird Setup Wizard 13Multi-Language Support 15

Preparing to Install 17Installation Requirements 18Choosing a Setup Type 19Installation Directories 20Installed Files 21

Installation and Maintenance 23Personal Installation 23Setup Types 26Program Maintenance for Personal Installations 31Administrative Installation 32

Typical Installation Scenarios 35Personal Installations 35Installing onto a Terminal Server 38Advertised Product 38Silent Installation 39Shared Installation 42Hummingbird Sconfig 43

Preserving User Profiles 44Version 6.2 User Profiles 44Version 7 User Profiles 45

Updating the Product 45

Registering 46

Chapter 2: Installing Exceed

Overview

For more inPreservingon page 44.

For more infWindows Indocumentatthe MSDN omsdn.mic11

The Hummingbird Setup Wizard (beginning with version 7.0) supports Windows Installer technology. Setup Wizard is based on three standard, top-level user interfaces or modes: installation, administration, and advertisement. Each defines a different installation path and user interface flow.

The following sections in this chapter provide:

an overview of the technology

an outline of the installation requirements and preparations

installation procedures and program maintenance

advanced implementation scenarios

formation, see User Profiles

a procedure for migrating user profiles from earlier versions

For information about updating products (version 7.x or greater), see Updating the Product on page 45.

Windows Installer Technologyormation about staller, see the ion available in nline library at rosoft.com

The Windows Installer service is an operating system component that acts as a setup engine. The installer includes:

an operating system-resident installation service

a standard format for component management

a management API (such as Hummingbird Setup Wizard) for applications and tools

Note: You cannot preserve user profiles for products before version 6.2.

Exceed Users Guide

12

Windows Installer copies files onto the hard disk, modifies thecreates shodesktop, andialog boxefor user inp

Windows Installer consists of a client-side installer service (Msiexec.exe) and a Microsoft Software Installation (.msi) package file. The installer uses

For more inMulti-Langon page 15 registry, rtcuts on the d displays s that prompt ut.

information in the package file to install the Hummingbird product. Msiexec.exe is called by Hummingbird Setup Wizard and uses a dynamic-link library (.dll) to read the package files, apply transformation (.mst) files, and incorporate options supplied by Setup Wizard.

formation, see uage Support

.

Windows Installer changes the registered file type of .msi files so that double-clicking the file runs Msiexec.exe with the .msi file. Each .msi package file contains a relational database that stores instructions and data required to install (and uninstall) the program.

The installer eliminates the need to run a setup engine on each target computer. Since installations are run through this common engine, the operating system can keep track of installation databases.

The key benefits of this technology are:

efficient management of shared resources

consistent installation rules

easy customization

choice of what pieces of the application are installed

the ability to diagnose and repair problems at run-time

These and other benefits are outlined below:

Consistent Installation and Setup Rules Windows Installer ensures all setup rules are implemented by the operating system. To follow those rules and avoid problems, a Hummingbird application describes itself in the standard Windows Installer format. The installer then performs the installation duties on behalf of the application.

Restores computer state if installation fails Windows Installer tracks changes made to the system during the installation process. If the installation fails, the installer restores the system to its initial state.


Prevents program conflicts Conflicts occur, for example, when an installation operation updates a dynamic-link library (.dll) file shared by

For more infSconfig for Installer, seAdvanced In13

an existing program (sometimes replacing a newer .dll with an older one), or when an uninstall operation deletes a .dll file shared by another program. This might cause the computer to stop responding. The installer enforces installation rules that help prevent such conflicts.

Diagnoses and repairs corrupted or damaged files Windows Installer can determine whether an installed program has missing or corrupted files. The installer repairs the program as necessary by replacing only those files.

Reliably uninstalls existing programs Windows Installer reliably uninstalls any program it previously installed. All the associated registry entries and program files are removed, except for those shared by other software.

ormation about Windows e Chapter 3: stallation.

Supports Hummingbird Sconfig Sconfig is an advanced system administration tool that lets administrators customize the Setup Wizard program.

Hummingbird Setup WizardHummingbird Setup Wizard is the interface displayed by Windows Installer. Setup Wizard does the following:

uses the Windows Installer service to maintain the applications and resources installed on the computer

determines the correct path to specific components

ensures that applications do not point to missing files

The Windows Installer service views all applications as three logical building blocks: products, features, and components. For more details about these terms, see the following sub-sections.

ProductsA product represents a single Hummingbird product such as Exceed, NFS Maestro, or HostExplorer. Products consist of one or more features. Each product is described to the Windows Installer service in the form of a single package file (.msi) or installation database.

Exceed Users Guide

14

Products do not own any resources directly, but they do have globally-unique identifiers known as Product Codes. These enable the service to

identify applications that are clients of a given component. Windows Installer service maintains a list of client products for each component. Product Codes let the service determine if a given product is already installed on a particular computer.

FeaturesFeatures are the individual pieces of an application that you can choose to install. Typically, they represent the functional features of an application. When you select Custom in the Setup Wizard program, the interface provides you with a tree that is composed of features (and sub-features). An example of a feature is X Server or Traceroute.

ComponentsA component is the smallest and most fundamental of the three logical building blocks. A component is a collection of files, registry keys, and other resources that are all installed or uninstalled together. When a given component is selected for installation or removal, all of the resources in that component are either installed or removed.

Components are invisible to the user; Hummingbird Setup Wizard manages whatever components make up a given Hummingbird application. Examples of components include single files, a group of related files, COM objects, registration, registry keys, shortcuts, resources, libraries grouped into a directory, or shared pieces of code.


Multi-Language Support

For more infMsiexec options, seeInstaller docthe MSDN omsdn.micor on CD-ROsubscription15

Hummingbird Setup Wizard can perform installation for the following languages:

1 English (United States) is the default installation language. Some Hummingbird products are available only in English. For more information, see the table on page 16.

Each language has an associated .mst transform file. Depending on the language selected, Setup Wizard applies the appropriate .mst file to the original .msi (which initially contains English text strings in the user interface).

You can by-pass Setup Wizard and apply a language transformation using the following command line syntax:

ormation about command line the Windows umentation in nline Library at rosoft.com M via .

msiexec /i path TRANSFORMS=filename.mst

where path is the path to the .msi file, and filename.mst is the appropriate transform file listed in the table above. For example, the following applies an German transformation to Exceed:

msiexec /i Hummingbird Exceed.msi TRANSFORMS=1031.mst

If no transform is specified, then English user interface and files are installed.

Language Transform File

German 1031.mst

English1 1033.mst

Spanish 1034.mst

French 1036.mst

Italian 1040.mst

Portuguese 2070.mst

Exceed Users Guide

16

The following are the multi-language support options for Hummingbird products:

Product Support Language(s)

Exceed German, English, Spanish, French, Italian, Portuguese

Exceed 3D

Exceed XDK

Exceed PowerSuite

Hummingbird Connectivity Security PackHostExplorer

HostExplorer Deployment Wizard

NFS Maestro Client

NFS Maestro Server

NFS Maestro Solo

NFS Maestro Gateway

Hummingbird Inetd English only

Hummingbird FTP for Windows Explorer


Preparing to Install17

System and shared files currently in use cannot be updated. Close all applications before proceeding with the installation.

Hummingbird connectivity products (version 7.0 and later) use Windows Installer. It is included with Windows 2000/XP and Windows Me. If Windows Installer is not present on your Windows 98 or Windows NT 4.0 operating system, then Hummingbird Setup Wizard installs and configures the service.

If Windows Installer is present on the operating system, Setup Wizard checks the version. If necessary, Windows Installer is updated.

Note: Before installing on Windows NT/2000/XP, it is recommended that you log on with Administrator authority. You also require write access to the Windows system directory and registry. If necessary, consult your system administrator.

Note: The first time Hummingbird Setup Wizard installs and configures Windows Installer, you may be prompted to restart the machine. Installation continues after your system restarts.

Exceed Users Guide

18

Installation RequirementsYou can preprofiles fromHummingbiFor more inPreservingon page 44serve user version 6.2 of

rd products. formation, see User Profiles .

The following table outlines installation requirements for Hummingbird connectivity products:

1 Approximate free hard disk space required for a installation of all program features (Complete setup type).

2 Administrator privileges are required to install some portions of the product.

Product Operating SystemDisk Space1

Other Requirements

Exceed Windows 98Windows Me

Windows NT2 (service pack 6 or later)

Windows 2000/XP2

130 MB Winsock compliant TCP/IP

Exceed XDK 215 MB Winsock compliant TCP/IPMicrosoft Visual C/C++ (MSVC) 4.2 or later, for X client development

Exceed 3D 8 MB Exceedto display Open GLXExceed XDKto display and develop Open GLXMicrosoft Visual C/C++ (MSVC) 4.2 or later, for X client development

Exceed PowerSuite

Windows 98Windows Me

Windows NT2 (service pack 6 or later)

Windows 2000/XP2

137 MB Winsock compliant TCP/IP

An assigned IP address and the ability to communicate with other computers on the network (Windows NT)

A HOSTS file if a domain name server is not available (Windows 98). See the operating system documentation for details.

Note: For some installation scenarios, Windows NT 4.0 requires Internet Explorer 4.01 or greater, and Windows Desktop Update (shell32.dll version 4.72.3110.0).


Third Party SoftwareJRE consists of the Java Virtual Machplatform cosupporting

Certain third party software must be installed to run some Hummingbird

For an illusttypes, see thon page 25.19

ine, the Java re classes, and files.

products. Sun Java Runtime Environment (JRE) is required to run Java programs. For example, you must install JRE before installing the Exceed (Tools)Xdis product sub-feature.

Hummingbird Master Setup lets you install third party add-on(s) such as Adobe Acrobat Reader and Sun Java 2 Runtime Environment.

Choosing a Setup Typeration of setup e dialog box

Hummingbird Setup Wizard prompts you to choose either a Typical, Custom, or Complete setup type. For assistance with choosing a setup type, consult the following quick reference table:

Setup Type

Function Recommended for: More information:

Typical standard features

no feature or feature directory changes

new users see Typical on page 26

Custom control over feature and directory changes

advanced users and system administrators

users with restricted disk space

see Custom on page 29

Complete everything is installed in default directories

users without disk space restrictions

see Complete on page 30

Note: All setup types allow you to change the destination folder (also known as the root home directory). However, this change affects all feature directories.

Exceed Users Guide

20

Hummingbird SconfigSconfig is an advanced system administration tool that lets administrators

customize the Setup Wizard program. For more information, see Chapter 3: Advanced Installation.

Installation DirectoriesHummingbird Setup Wizard installs program-specific and user-specific files to the directories described below.

Setup Wizard supports the Uniform Naming Convention (UNC) so you can begin path specifications with \\ in place of the disk drive to specify a shared directory on a file server. For example:

\\machine_specification\share_name

where machine_specification is the name of the computer to which you are connecting, and share_name is the name of the shared directory. If you use UNC names to install to a Novell server, you must install the OS/2 support patch on the NetWare server as NetWare servers do not support UNC paths.

Installation Description Location/Type

Destination folder

Program files install into the destination folder (also known as the root home directory). It is recommended that you use the default directory:

C:\Program Files\Hummingbird\Connectivity\Version\

However, you can specify a different directory.

Location: a remote network drive or a local hard drive.

Can be a read-only directory.

User directory

User files install into the user directory.

These files are configuration files or related files that your Hummingbird product can change.

There are two kinds of user directories and user files. For more information, see Installed Files below.

Warning: Do not make a user directory read-only.

Location: a remote network drive or a local hard drive.


Installed Files

Per-machineso that key osystem comas device drservices, caaccess them21

User files for Hummingbird connectivity products fall into two categories:

per-machine

per-user

files are local perating ponents, such ivers and n reliably during login.

Per-machine files are those application or service files that, when changed, affect all users of the computer. An example is the inetd.ini file. If you change inetd.ini to stop the Telnet daemon from running, then regardless of which user is logged onto the computer, the Inetd service rejects Telnet connections.

Per-user files are all application or service files that, when changed, affect only the user who is making the change (that is, the currently logged in user). An example of a user-specific file is exceed.xcfg. If you configure exceed.xcfg with Xconfig to use a certain display, then other users of the machine are not affected.

The following are the per-machine file locations:

Note: Each user of the product on the machine receives a personal user directory.

Operating System

Per-MachineFile Location

Windows 98/Me

C:\Windows\System\Hummingbird\Connectivity\version\

Windows NT 4.0, Windows 2000/XP

C:\Winnt\System32\Hummingbird\Connectivity\version\

Exceed Users Guide

22

The following are the default locations for user files:

Operating System

Per-User FilesDefault Location (Current User)

Windows 98/Me C:\Windows\Application Data\Hummingbird\Connectivity\version\Current User versus All UsersFor version 8, Hummingbird Connectivity products use individual or personal profiles even when a product is installed for all users of the machine. For more information about customizing individualized installations, see Chapter 3: Advanced Installation.

For Windows NT/2000/XP platforms, Hummingbird Setup Wizard prompts you to choose between installing the product on the computer for the currently logged in user, or for all users. For the current user, shortcuts are created in the appropriate user profile folder, along with copies of all other user files. For all users (anyone who uses the computer), shortcuts are created in the All Users profile folder, and user files are created for each user of the machine (when they first use the product).

Windows 98/Me (user profiles enabled)

C:\Windows\Profiles\%USERNAME%\Application Data\Hummingbird\Connectivity\version\

Windows NT 4.0 C:\Winnt\Profiles\%USERNAME%\Application Data\Hummingbird\Connectivity\version\

Windows 2000/XP

C:\Documents and Settings\%USERNAME%\Application Data\Hummingbird\Connectivity\version\ (hidden)


Installation and Maintenance23

This section describes basic installation procedures and setup types:

personal installationsuch as one user installing on one computer

setup typestypical, custom, complete

administrative installationsystems administrators create an image of the product at a network location

For examples of how to implement these procedures, see Typical Installation Scenarios on page 35.

Personal InstallationAutorun launches the Hummingbird Master Setup application when you insert the CD into your drive. If Master Setup does not launch automatically, run Msetup.exe from the root directory of the CD.

To configure Windows Installer and prepare Setup Wizard:

1 In the Hummingbird Master Setup application window, you can install additional Hummingbird products (such as SOCKS), third party add-ons, register online, or view release notes. Otherwise, click Install Product, then Personal Installation.

2 If you are prompted, select a setup language and click OK. English is the default.

Note: For certain products, English is the only supported language. For more information, see the table on page 16. When selected, the language applies to all subsequent users installing Hummingbird products on the PC.

Exceed Users Guide

24

3 Your Hummingbird product prepares Setup Wizard, checks the operating system, and checks the current Windows Installer version.

The Next buif the termsagreement aaccepted.

Destination same as thedirectory (a users of verearlier prod If necessary, the version is updated and the Setup Wizard continues.

If Windows Installer is not present on your operating system, Setup Wizard installs the service.

4 After configuring Windows Installer and preparing to install, Setup Wizard proceeds to the Welcome dialog box. Click Next.

tton is dimmed of the license re not

5 Read the licensing agreement. If you select the option that indicates the terms are acceptable, then click Next.

6 The Customer Information dialog box opens. Type the appropriate information, select an installation option (all users, current user), and click Next.

Folder is the home term familiar to sion 6.2 and ucts).

7 The Destination Folder dialog box opens. Accept the default installation folder for the product, or click Change to open a dialog box for browsing to an alternate location. Click Next.

Note: To quit installation, click Cancel in any Setup Wizard dialog box. Your computer is not affected if you do this before the Setup Wizard copies files. To review or change settings in a previous dialog, click Back.

Note: Failure to read or understand the License Agreement does not affect the terms and conditions of the agreement.

Note: Some product features are not affected by changes to the destination folder.


8 The Setup Type dialog box opens. Select a setup type and click Next.

For more inTypical onCompleteand Custom

You can chapassword lathe SecurityXconfig.25

formation, see page 26, on page 30, on page 29.

For Typical and Complete setup types, a dialog box opens and indicates Setup Wizard is ready to begin installation. Click Install.

For Custom setup type, a Custom Setup dialog box opens. Customize the installed program features and click Next.

A dialog box indicates Setup Wizard is ready to begin installation. Click Install.

9 Various dialog boxes prompt you to specify Exceed configuration options:

Keyboard PreferenceSetup Wizard detects the current keyboard in use, but you can select another from the drop-down list. Click Next.

nge the ter by using application in

Xconfig PasswordPrevents unauthorized users from running Xconfig and configuring the Exceed software. Specify a password and click Next.

Specifying a password is optional. To not specify a password (by leaving the boxes blank), click Skip to continue.

Exceed Users Guide

26

You can peform this procedure later by using the Performapplication

X Server Tuning3 to 8 minute procedure to maximize display graphics. To perform this procedure, click Next.

Complete sincludes alllisted in thepage 27.ance in Xconfig. The procedure is optional. To not perform this procedure, click Skip

to continue.

10 A dialog box opens and indicates installation is complete. Click Finish.

For information about product modification, repairs, or removal, see Program Maintenance for Personal Installations on page 31.

Setup TypesThe following sections describe options that determine what product (program) features are installed.

Typicaletup type the features table on

Selecting this setup type means that standard features are installed to default destination folders. In contrast to the Complete option, only the essential features of the product are installed.


Typical setup type usually requires less disk space than the other types. The following table lists features installed and those not installed with this setup 27

type:

Typical SetupFeatures (and Sub-Features)

Installed Not installed

Accessories1 Hummingbird Basic1 Command Line Utilities3 (including RSH, LPR, NIS, NIS+, and LDAP)

FTP1, 3

LPQ1

LPR1, 2, 3

Network Time1

NSLookup1

Ping1

Remote Tools1

TraceRoute1

Exceed (core files and miscellaneous fonts)1

Exceed FontsStandard (100 DPI, 75 DPI)

Exceed FontsStandard, Supplemental & International (Andrew, Dec 100 DPI, Dec 75 DPI, Euro, HP, Latin1, PC, Symbol)

Local X Clients (Bitmap, Editres, Ico, Maze, MotifAnim, Xev, Periodic, Seltest, Showcmap, Xdpyinfo, Xev, Xlogo)1, 4

Exceed Tools (MWM4, HWM1, Transport Monitor1)

Xsession1, Xstart1, X Client Wizard1

Xconfig Management Console1, 2

X Web Browser Plug-in2, 3

Exceed FontsInternational (100 DPI, 75 DPI)

Exceed FontsInternational & Supplemental (Arabic, Central European, Chinese, Cyrillic, Greek, Hebrew, Japanese, Korean, Siemens, Thai, Turkish, Unicode)

Exceed Tools (Kinput24, Xdis [Java Component])1

FTP for Windows Explorer1, 2

HostExplorer1 32701, 2

52501, 2

Telnet1, 2

HostExplorer Development Kit1

Macro and Profile Converter1, 2

WyseTerm1

Exceed Users Guide

28

Typical SetupFeatures (and Sub-Features)1 The feature or sub-feature can be advertised.2 The feature or sub-feature requires Administrator privileges.3 You cannot run the feature from a network location.4 Exceed XDK only.

Hummingbird

Inetd2, 3

(not installed)

Bootp Daemon2, 3

Finger Daemon2, 3

FTP Daemon2, 3

LP Daemon2, 3

Telnet Daemon2, 3

Time Daemon2, 3

Trivial FTP Daemon2, 3

Trivial Name Daemon2, 3

Xstart Daemon2, 3

Online Documentation1

(not installed)

Exceed Users Guide

Exceed XDK Users Guide4

HostExplorer (Host Access) Users Guide1

Hummingbird Basic Language Programmers Guide1

Product Administration1

Hummingbird Update3 Proxy Server1, 2

Sconfig1

X Development Kit4

Exceed XDK Application Wizard2, 3

GCC Libraries

Motif 1.2 (GCC Libraries)

Motif 2.1 with CTL (GCC Libraries)

Local X Clients Source (Hellomotif, Ico, Periodic, Xlogo)

X Internationalization Architecture

X11R5 Local X Clients Runtime

Install Options1, 3 Hummingbird Connectivity Desktop Icon1, 3

Hummingbird Neighborhood Desktop Icon2, 3

Installed Not installed


CustomThis setup type lets you select the program features to install and where to 29

install them. This setup type is recommended for advanced users and administrators. When you click Next in the Setup Type dialog box, the following dialog box opens:

You can view more information about features and perform the following customization:

Expand a feature category by clicking the plus icon to view a tree of features or sub-features. Similarly, click the minus icon to collapse the feature tree.

Click a feature icon to display a pop-up menu of icons and install options (see above). Click a pop-up menu icon. The icon in the feature tree changes according to your selection. Click Help to view a dialog box with tips.

Exceed Users Guide

30

Click Change to open the Change Current Destination Folder dialog box and install the feature to a folder other than the default.

The Compleinstalls all fethe table on Click Space to open a dialog box listing all local drives (logical partitions) and mapped drives on the machine. It provides detailed information about available disk space.

Completete option atures listed in page 27.

This setup type requires the most disk space and installs all product features to the default destination folder:

C:\Program Files\Hummingbird\Connectivity\Version\

Click Change to open a browse dialog box and install the program to another destination directory.

Note: For some product features (such as Hummingbird Inetd), the Change button is disabled and you cannot specify an installation folder.


Program Maintenance for Personal Installations

For more inCustom o31

Program maintenance lets you modify, repair, or uninstall existing Hummingbird products and features.

To launch Hummingbird Setup Wizard in maintenance mode:

1 You can open Program Maintenance by running Msetup.exe from the product CD. Alternatively, double-click Add/Remove Programs in Control Panel, select the Hummingbird program, and click Add/Remove. The Welcome dialog box opens.

2 In the Welcome dialog box, click Next. The Program Maintenance dialog box opens.

For more information about maintenance options, see the following procedures.

To modify the install state of program features:

1 In the Program Maintenance dialog box, select Modify and click Next.

formation, see n page 29.

2 The Custom Setup dialog box opens. Expand the feature tree and change the install state, as necessary. Click Next.

Exceed Users Guide

32

3 Setup Wizard prompts when it is ready to modify the program. Click Install and the install state of program features changes according to

your specifications.

4 Installation (modification) proceeds to completion. Click Finish to exit.

To repair a program:

1 In the Program Maintenance dialog box, select Repair and click Next.

2 The Ready to Repair the Program dialog box indicates Setup Wizard is ready. Click Install to repair errors such as missing or corrupt files, shortcuts, and registry entries.

3 Program repair proceeds to completion. Click Finish to exit.

To remove a program:

1 In the Program Maintenance dialog box, select Remove and click Next.

2 The Remove the Program dialog box indicates Setup Wizard is ready. Click Remove to uninstall the program.

3 Program removal proceeds to completion. Click Finish to exit.

Administrative InstallationAutorun launches the Hummingbird Master Setup application when you insert the CD into your drive. If Master Setup does not launch automatically, run Msetup.exe from the root directory of the CD.

Administrative installations let you create a centralized image of the product. This means that many users can install the product without the original CD media.

Note: With Windows Installer, you can uninstall (remove) only one program (product) at a time. Ensure that all programs associated with the product you are uninstalling are closed.


There are two types of administrative installations:33

Copy Image This installation creates a language-specific image at a network location, but in all other respects, this image is the same as the contents of the original CD. Running Setup.exe from a Copy Image is the same as a personal installation. For more information, see the procedure Personal Installation, from pages 23 to 26.

Shared Image This installation creates a language-specific image for running applications from the network. When an application is marked Run from Network, only the user and system files are installed to the local computer. All other files remain on the Shared Image server. Running Setup.exe from a Shared Image is called a workstation installation (see page 43). This is similar to a personal installation, except advertisement (see Advertised Product on page 38) is not available and features are set to run from the network.

All Hummingbird products support AdministrativeCopy Image installation. AdministrativeShared Image installation is available for the following products:

Exceed

Exceed 3D

Exceed XDK

Exceed PowerSuite

HostExplorer

NFS Maestro Client

NFS Maestro Solo

Note: An administrative installation only copies files. The product is not installed to the network location (server), nor does it make changes to the server. Only the network location folder is modified.

Exceed Users Guide

34

To run Setup Wizard in Administrative mode:1 Run Msetup from the product CD. In the Hummingbird Master Setup application window, you can select options to install third party add-ons, register online, or view release notes. Otherwise, to run Setup Wizard, click Install Product, then click Administrative Installation.

Alternatively, from the product directory on the CD, run:

setup /a

2 Select a setup language and click OK. This language will apply to all installations from the copied image or shared image.

3 Your Hummingbird product prepares Setup Wizard, checks the operating system, and checks the current Windows Installer version.

If necessary, the version is updated and the Setup Wizard continues.

If Windows Installer is not present on your operating system, Setup Wizard installs the service.

4 After configuring Windows Installer and preparing to install, Setup Wizard proceeds to the Welcome dialog box. Click Next.

5 The Network Location dialog box opens. Accept the default installation folder for the product or click Change to open a dialog box for browsing to an alternate network location.

Note: To quit the installation, click Cancel in any Setup Wizard dialog box. Your computer is not affected if you do this before the Setup Wizard copies files. To review or change settings in a previous dialog, click Back.


6 Click Next and the Network Location Type dialog box opens. Select a network location type.

Typica35

7 Click Next. The Ready to Install Network Image dialog box opens.

8 Click Install. Installation of the network image proceeds to completion.

l Installation Scenarios

This section describes installation scenarios. The conditions and parameters affecting implementation in your environment may vary from these examples.

Personal Installations Administrators, or users who do not have Administrator privileges (Windows NT/2000/XP), or Any User in Windows 98, are able to perform personal installations for HostExplorer.

Exceed Users Guide

36

FTP for Windows Explorer, Hummingbird Inetd, and Hummingbird NFS Maestro Gateway require Administrator privileges for personal installations

This type ofapplies to aplatforms, bWindows NTerminal SeWindows 20Server with Services en

If Setup.ea server imaprompted toinstallation is already sethe copied iimage instain Windows NT/2000/XP. However, Any User in Windows 98 can install these products or features.

installation ll Windows ut not T 4.0 Serverrver Edition or 00 Advanced

Terminal abled.

PersonalWithout Administrator PrivilegesThis scenario assumes:

you are logged in to the PC as a user, not as Administrator

you do not have administrative privileges

you are installing the product for one user (the current user) on one PC

the product CD is available locally or on the network

To launch a personal installation without Administrator privileges:

1 Launch Setup Wizard in installation mode by one of the following methods:

from the command line, run Setup.exe from the product CD or from a server image

run Msetup.exe from the product CD

xe is run from ge, you are not select an language. This lected during

mage or shared llation.

2 If you are prompted, select a language for the installation. English is the default.

3 Dialog boxes provide information and prompt for input.

4 In the Setup Type dialog box, select either Typical, Custom, or Complete.

Note: Some product features are not available for installation if you do not have administrative privileges.

Note: For certain products, English is the only supported language. For more information, see the table on page 16. Once selected, the language applies to all subsequent users installing Hummingbird products on the computer.


This type of installation applies to all Windows platforms, bWindows NTTerminal SeWindows 20Server with Services en

PersonalWith Administrator PrivilegesThis scenario assumes:

For more infcreating a ssee Silent page 39.37

ut not 4.0 Server

rver Edition or 00 Advanced

Terminal abled.

you are logged in to the PC as the (local) Administrator


To launch a personal installation as Administrator:

1 Launch Setup Wizard in installation mode by one of the following methods:

ormation about erver image, Installation on

from the command line, run Setup.exe on the product CD or from a server image

from the product CD, run Msetup.exe

2 In the Customer Information dialog box under Install this application for, select one of the following options:

Anyone who uses this computer (all users)

Only for me (username)applicable to the current user


4 Dialog boxes provide information and prompt for input.

5 In the Setup Type dialog box, select Typical, Custom, or Complete. Installation proceeds to completion.

Note: These options are available only in Windows NT/2000/XP, provided that you are logged in to the PC as Administrator.

Note: For certain products, English is the only supported language. For more information, see the table on page 16. When selected, the language applies to all subsequent users installing Hummingbird products on the PC.

Exceed Users Guide

38

Installing onto a Terminal Server

Applies to aplatforms, bWindows NTerminal SeWindows 20Server with Services enWindows NInternet Exp(SP1) or greWindows D(shell32.dll4.72.3110.0For information about installing ExceedExceed 3D Host Explorer onto a Terminal Server, see Chapter 3: Advanced Installation.

Advertised Productll Windows ut not T 4.0 Serverrver Edition or 00 Advanced

Terminal abled. T 4.0 requires lorer 4.01 ater, and

esktop Update version or later).

Advertisement (install on demand or deferred installation) means all features of a product are available even if they are not installed on the computer. This scenario assumes:



To advertise a product and all its features:

1 Launch Setup Wizard in advertisement mode by one of the following methods:

on the command line type E:\setup /V/jm for all users or E:\setup /V/ju for the current userwhere E:\ is the CD-ROM drive

run Msetup.exe from the product CD

2 Select the Complete setup type.

Note: Not all product features can be advertised.

Warning! Do not advertise Hummingbird Exceed 3D. There is no shortcut nor are there registry entries to associate with the core Exceed 3D functionality.

Note: For a deferred installation, the product CD must be in the drive and the drive must be accessible.


Shortcuts and registry entries exist on the computer, binstalled.

3 A Hummingbird product icon is installed on the PC desktop, and in the Windows program group (on the Start menu), for each feature. 39

ut files are not

Silent InstallationA silent installation runs in the background.

This scenario assumes:



Note: Shortcuts for features requiring Administrator privilege will not launch correctly if the user does not have the required privileges to install the feature. For more information about these features, see the table on page 27.

Note: This scenario describes a local installation.

Exceed Users Guide

40

To run a silent installation:

1 Launch Setup Wizard from the command line using the following syntax:E:\setup /S /V/qn [/lnnnn]

where E:\ is the CD-ROM drive. The following describes options:

2 Installation proceeds to completion.

Microsoft Systems Management Server (SMS)An Administrator can use SMS to manage network computers, distribute software from a central location, and perform a variety of other system management tasks. The Administrator can install a package of products simultaneously on multiple computers.

Option Description

/S Specifies a silent installation.

Note: S is upper-case.

/V/qn /V passes parameters to Msiexec.exe.

Note: There are no spaces between the /V and /qn options and that V is upper-case. If a character string contains a space, put quotes around it. For example: /Vparameter space

/lnnnn Overrides the default English language installation where nnnn is the transform file name.

Note: For nnnn, type only the number but not the .mst extension.

/RS|RE command Run the command either at the startup (/RS) or at the end (/RE) of setup.

For example, to launch a file in Notepad at startup:

/RS notepad readme.txt


Requirements:

You can get the latest service packthe Microso

SMS version 2.0 with service pack 2 (or greater)

A package cfiles for the various detathe softwareprocess.

For more infMsiexec options, seeInstaller docavailable in online librarmsdn.mic41

for SMS from ft web site. SMS Client (installed on each client computer) supplied with SMS

Server

Windows Installer on the client computer

ontains source program and ils for directing distribution

To distribute a product using SMS, the Administrator must create a package definition file according to SMS instructions. For convenience, Hummingbird provides default .sms files for all products.

There are three default scenarios in each package definition file:

Typical

SilentTypical

SilentComplete

When a package is run through SMS, it prompts you to select one of these options (scenarios). Use the following command line parameters to apply modifications or create new package definition files:

ormation about command line the Windows umentation the MSDN y at rosoft.com

For example, a complete silent installation of a Hummingbird product in Italian would look like this:

msiexec /i "Hummingbird Product.msi" TRANSFORMS=1040.mst INSTALLLEVEL=150 /q

Refer to Microsoft documentation for command-line parameters, switches, and other information required for Windows Installer and Systems Management Server.

Command Line Parameter Description

/i Installs or configures a product.

/q Sets user interface level (silent).

INSTALLLEVEL=150 Does a complete install.

TRANSFORMS=nnnn.mst Specifies the product language where nnnn is the transform file name.

Exceed Users Guide

42

Shared InstallationThis type of installation applies to WNT/2000 plaWindows NTerminal SeWindows 20Server with Services en

This advanced installation creates a server image of the Hummingbird

The /a flagexecutable administrati

The languagall network from this seindows tforms, but not

T 4.0 Serverrver Edition or 00 Advanced

Terminal abled.

product and saves it to a network location.

To launch a shared installation:

1 Launch Setup Wizard in administration mode by one of the following methods:

from the command line using the syntax:

E:\setup /a

launches the file in ve mode.

where E:\ is the CD-ROM drive.

run Msetup.exe from the product CD. In the Hummingbird Master Setup application window, click Install Product, then Administrative Installation.

e will apply to installations rver.


3 Click Next in the Welcome dialog box.

4 In the Network Location dialog box, type a path to an accessible network location (server) or click Change to open a browse dialog box. Click Next.

5 In the Network Location Type dialog box, select Shared Image. Click Next.

6 When Setup Wizard is ready, click Install.

7 All of the required files are installed to the specified network location.

Note: On Windows NT 4.0Terminal Server Edition, shared installation is not possible. For more information about installing on a Terminal Server, see Chapter 3: Advanced Installation..

Note: For certain products, English is the only supported language. For more information, see the table on page 16. Once selected, the language applies to all subsequent users installing Hummingbird products on the PC.


8 Users wanting to use this product must perform a workstation installation.

Users can infrom the shathe context Standard/PeStandard/PeAdministratscenarios.43

Workstation InstallationThis scenario requires an existing shared image installation. The product is installed to network workstations from the shared image located on a network server. Certain features are set to run from this network location.

To launch a workstation installation:

stall products red image in

of either the rsonal or rsonal with or Privileges

1 Run Setup.exe from the network location.

2 For details about this part of the procedure, see Personal Installation beginning at step 3 on page 24.


Hummingbird SconfigSconfig (Setup configuration) lets you customize the installation of software on local and network machines. Use it to customize the folders installed by Setup Wizard, determine what is installed (as well as limit functionality or optimize disk space), and simplify user input. For more details, see Chapter 3: Advanced Installation.

Note: This type of installation will not start on Windows NT 4.0Terminal Server Edition.

Note: In the Custom Setup dialog box, the install state of certain features (and sub-features) are by default set to run from the network. For workstation installations that are cross-platform (for example, installing from a shared image on a Windows NT/2000/XP server to a Windows 98 machine), features that contain platform-specific components are set to run locally on the workstation, not from the server.

Exceed Users Guide

44

Preserving User Profiles

User files arcurrent userData folder Hummingbird Setup Wizard does not preserve user profiles for products before version 6.2. You must manually uninstall all such products before installing version 8.x.

Version 6.2 User ProfilesYou can preserve user profiles for version 6.2 Hummingbird products. If you are upgrading the same (single) product from version 6.2 to version 8.x, Setup Wizard will back up user profiles and automatically uninstall the version 6.2 product.

User profiles for multiple version 6.2 products can be preserved, but the products are not automatically uninstalled. These must be uninstalled manually before installing version 8.x. For more information, see the following procedure.

General procedure:

1 After launching Hummingbird Setup Wizard, version 6.2 products are detected.

e stored in the s Application under MigBack.

2 Setup Wizard reports that user files are saved for each product.

3 This part of the procedure varies depending on the number of products detected:

4 If Setup Wizard does not detect any older product versions, installation of the version 8.x Hummingbird product proceeds to completion. Your version 6.2 profiles are available when you run the version 8.x product.

Single product (upgrade): Multiple products:

a) The product is uninstalled. You are prompted to restart.

b) Launch Setup Wizard again.

a) You are informed that these must be uninstalled manually. Setup Wizard exits.

b) Uninstall the products.

c) Launch Setup Wizard again.


Version 7 User Profiles

Updat

WebUpdateyour Hummare preset. Foptions, righHummingbientry in the dialog box athe drop-do45

Hummingbird version 8 products automatically replace a previously installed 7 version of the same product. All settings are preserved in a backup location, and those settings that are applicable to the newly installed features of version 8 are migrated.

With All Users installation for version 8, each user gets an individual profile. Previous user files (older versions of Hummingbird products) were possibly shared by one or more users. As a result, these files are backed up to the Migration subfolder of the global user directory (template) so that all users get the profile settings.

ing the Product

options for ingbird product or update t-click the

rd product WebUpdate nd select from wn menu.

If necessary, you can modify connection settings for updating the product. Select WebUpdate Settings in the System Administration folder of the Hummingbird Connectivity program group. Make the appropriate changes in the WebUpdate dialog box as required.

Note: Some products do not support side-by-side installation.

If version 6.2 to 8 migration was disabled to allow side-by-side installation of a product, an upgrade from version 7 to version 8 is possible, but the version 7 settings are migrated instead of the 6.2 settings.

Note: The WebUpdate application is not available if you performed a personal installation without Administrator privileges. Instead, an HTML file is created that links to a Web site for Hummingbird updates.

Exceed Users Guide

46

To update the product:

Regis1 Click Update Hummingbird Product in the System Administration folder of the Hummingbird Connectivity program group.

2 If an update is available, you are prompted to install it. Click Yes.

3 The update is downloaded. Setup Wizard prepares the setup process.

4 You are informed when Setup Wizard is ready. Click Next.


tering

Online registration is available by:

running Msetup from the product CD, then clicking Register Online

completing and registering the form at the following URL:

http://www.hummingbird.com/register/

Alternatively, complete the registration card provided in the product package and mail it to Hummingbird Ltd.

After registering, you and your organization are recognized as a licensed product owner with all rights and privileges. This makes you eligible to receive a wide range of customer services, such as a free subscription to our quarterly newsletter, Expos Online, as well as notification of software upgrades and new products. If you and your organization move to a new location, complete and mail the change of address card included in the product package. This ensures you will continue receiving update notices and other important information.

Note: You can also select the Hummingbird product entry and click Check for Update in the WebUpdate dialog box.

Chapter 3Advanced Installation

Installing on a Terminal Server 49Stage 1: Creating an Administrative Copy Image 49Stage 2: Personal Installation 51

Uninstalling from a Terminal Server 54

Customizing Installations with Sconfig 55

About Windows Installer Database Files 56Microsoft Transform Files 56

Working with Transform Files in Sconfig 57About Creating Transform Files in Sconfig 58

Customizing Product Directories 60Creating Custom Folders 61

Selecting Features to Install 64Adding a Feature to an Installation Database 64Modifying a Feature in an Installation Database 65Removing a

Exceed

Documents

Transcript of Exceed