exceed
DESCRIPTION
users guideTRANSCRIPT
-
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:
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
-
Chapter 1: Introducing Exceed
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.
-
Chapter 1: Introducing Exceed
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.
-
Chapter 2: Installing Exceed
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.
-
Chapter 2: Installing Exceed
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
-
Chapter 2: Installing Exceed
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).
-
Chapter 2: Installing Exceed
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.
-
Chapter 2: Installing Exceed
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)
-
Chapter 2: Installing Exceed
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.
-
Chapter 2: Installing Exceed
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.
-
Chapter 2: Installing Exceed
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
-
Chapter 2: Installing Exceed
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.
-
Chapter 2: Installing Exceed
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.
-
Chapter 2: Installing Exceed
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.
-
Chapter 2: Installing Exceed
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.
-
Chapter 2: Installing Exceed
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
the product CD is available locally or on the network
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
3 If you are prompted, select a language for the installation. English is the default.
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:
you are logged in to the PC as the (local) Administrator
the product CD is available locally or on the network
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.
-
Chapter 2: Installing Exceed
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:
you are logged in to the PC as the (local) Administrator
the product CD is available locally or on the network
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
-
Chapter 2: Installing Exceed
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.
2 If you are prompted, select a language for the installation. English is the default.
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.
-
Chapter 2: Installing Exceed
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.
3 Installation proceeds to completion.
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.
-
Chapter 2: Installing Exceed
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.
5 Installation proceeds to completion.
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