Informix Product Family Informix Genero

Version 2.40

IBM Informix Genero Desktop Client Installation Guide

GC27-3859-00

Informix Product Family Informix Genero

Version 2.40

IBM Informix Genero Desktop Client Installation Guide

GC27-3859-00

Note Before using this information and the product it supports, read the information in Notices on page B-1.

Edition Notice This edition applies to version 2.40 of IBM Informix Genero (product number 5725-D13) and to all subsequent releases and modifications until otherwise indicated in new editions. Licensed Materials - Property of IBM. All rights reserved. All information, content, design, and code used in this documentation may not be reproduced or distributed by any printed, electronic, or other means without prior written consent of Four Js Development Tools. Four Js Development Tools 1995, 2012

Contents
Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . v
About this publication . . . . . Contacting IBM Software Support . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . v . v

Installing the Genero Desktop Client

System Requirements . . Prerequisites . . . . . Install the Genero Desktop MSI Installer . . . . Silent (un)installations Install the Genero Desktop Install the Genero Desktop . . . . . . . . . . . . . . . . Client on Windows . . . . . . . . . . . . . . . . . Client on Mac OS X . Client on X11 Systems

. . . . . . . . . . . . . . . . . . . . . . 1-1
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-1 1-1 1-1 1-2 1-2 1-3 1-4

Appendix. Accessibility . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-1

Accessibility features for IBM Informix products Accessibility features . . . . . . . . . Keyboard navigation . . . . . . . . . Related accessibility information . . . . . IBM and accessibility. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-1 A-1 A-1 A-1 A-1

Notices . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . B-1
Trademarks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . B-3

iii

iv

Genero Desktop Client Installation Guide

Introduction
This publication contains information about IBM Informix Genero.

About this publication

This publication describes how to install the IBM Informix Genero Desktop Client. The Genero Desktop Client (GDC) is a graphical Front End for the Genero Runtime System. The GDC is multi-platform and can run under: v Windows v Mac OS X v Linux The GDC can also be embedded in an HTML page using Active X. This solution works on Windows systems using the Internet Explorer browser.

Contacting IBM Software Support

IBM Software Support provides assistance with product defects. Before contacting IBM Software Support, your company must have an active IBM Software Support contract, and you must be authorized to submit problems to IBM. For information about the types of available support, see the Support portfolio topic in the Software Support Handbook. Complete the following steps to contact IBM Software Support with a problem: 1. Define the problem, gather background information, and determine the severity of the problem. For more information, see the Getting IBM support topic in the Software Support Handbook. 2. Submit the problem to IBM Software Support in one of the following ways: v Online through the IBM Support Portal: You can open, update, and view all your Service Requests from the Service Request portlet on the Service Request page. v By phone: For the phone number to call in your region, see the Directory of worldwide contacts web page.

vi

Genero Desktop Client Installation Guide

Installing the Genero Desktop Client

The installation process installs the Genero Desktop Client front end on the Workstation.

System Requirements
The client system must meet system requirements. For detailed information, please refer to IBM Informix Genero: System Requirements.

Windows systems
v Windows XP, Windows Vista, Windows 7. Having the latest Service Pack installed may be required.

Linux systems
v X11 v libc version 2.4 v libstdc++ version 6 v kde's xdg-open tool if you want the standard function call "shellexec" to work.

Mac systems
v Mac OS X 10.4, 10.5, 10.6 v PowerPC and MacIntel are supported.

Operating systems
v You must install the GDC package that corresponds to the operating system that you use. Each of the packages is identified by an operating system code (hpx1100, w32vc71, and so on).

Prerequisites
Genero Desktop Client 2.3x will work only with Genero Runtime Systems 2.3x, plus 2.2x and 2.1x for backward compatibility. It is not supported with Genero Runtime Systems 2.0x and 1.3x and is not compatible with Four Js BDS Runtime System.

Install the Genero Desktop Client on Windows

Since Genero Desktop Client (GDC) 2.21, the installation is using MSI installer. To be compliant with Microsoft User Access Control (UAC) requirements, our msi is embedded inside an exe file. See MSI Installer on page 1-2 for more details. 1. Close all running applications. 2. Execute the installation program. On Windows Vista and 7, administrator privileges are needed to perform the installation. UAC will popup, you will need to validate it to install GDC. 3. Press 'Next' to start the installation.

1-1

4. If you accept the agreement, check 'I accept the terms in the License Agreement' and click 'Next' to continue. 5. Select the folder in which you want to install GDC. 6. Select the StartMenu folder in which GDC shortcuts will be set. 7. GDC shortcuts can be stored as a .gdc file. You can associate this extension with this GDC, so that you can start GDC with this file by double-clicking the .gdc file in Explorer. You can enable or disable the file associations. 8. GDC is now ready to be installed. It requires Visual C++ 2008 SP1 Runtime. If the runtime is not available on your system, it will be installed. Click "Install" to begin the installation. 9. All files will be copied. The installation is now complete. You can now run the GDC.

MSI Installer
Beginning with version 2.21, the Genero Desktop Client installer uses MSI technology. You can extract the .msi file from the .exe file using the /x option:
c:\fjs-gdc-2.21.01-build2471-w32vc90.exe /x

This will create an .msi file with the same name.

Silent (un)installations
Install and Uninstall in silent mode on Microsoft Windows platforms
To install and uninstall Genero Desktop Client (GDC) in silent mode, you can use the msiexec command line utility. The msiexec utility provides the means to install, modify, and perform operations on Windows Installer from the command line. The following options for msiexec are the most common relating to installation and uninstallation. Enter msiexec from the DOS command prompt to view the complete list of available options. msiexec /qn - Quiet mode with no UI /i fjs-gdc-version-windowsOStype.msi - Install the specified msi package /x fjs-gdc-version-windowsOStype.msi - Uninstall the specified msi package /log logfile - Log to the specified log file

Arguments
You can pass arguments to the msi installer on the command line:
Argument PRODUCTDIR=your_gdcdir_path GDCDIR=your_gdcdir_path Description The path where GDC will be installed. It is an alias of GDCDIR variable. The path where the GDC will be installed. It is an alias of the PRODUCTDIR variable.

1-2

Genero Desktop Client Installation Guide

Argument STARTMENUFOLDER= your_startmenufolder_path ADDLOCAL=[ALL | GDC | GDC,GDCFILEASSOCGDC ]

Description Customize the location for the shortcuts in the startmenu. For example, "fjs\gdc". Set the features to install. ALL (default): Install GDC (Mandatory) and .gdc file association. GDC: Install only GDC. GDC, GDCFILEASSOCGDC : Same as ALL

ALLUSERS=1

Default value: A per user installation To perform a per machine installation (All Users) If not specified, it will perform a per user installation (Current User)

FORCEREMOVEPRODUCTDIR="YES"

On uninstall, remove the PRODUCTDIR location, even if it is not empty. Default value: ""

Install the Genero Desktop Client on Mac OS X

1. Close all applications. 2. Double-click on the drive image file .dmg. The image file will be mounted by Mac Os X. 3. Once the volume is mounted, double-click on the package file .mpkg. The installation wizard displays. 4. Press Continue to start the installation. The Release Notes display. 5. When you finish examining the Release Notes, press Continue. The license agreement displays. 6. When you finish examining the license agreement, press Continue. 7. To agree to the terms of the software license agreement, press Agree. 8. To change the install location, press Change Install Location. Once you have selected who to install the software for and where to install the software, press Continue. 9. Press Install. 10. Enter your password to access your Administrator privileges and press OK. Administrator rights are needed to install the Genero Desktop Client (GDC) in the Application directory. The files are written, and GDC is installed. 11. Press Close. The installation is complete. 12. Unmount the mounted volume. (Drop the mounted icon in the Trash). 13. To start GDC, double-click the gdc icon in the Destination Folder (default Applications).

Installing the Genero Desktop Client

1-3

Install the Genero Desktop Client on X11 Systems

By default, the script un-compresses data into $DBTEMP. Please make sure you have the correct permissions for this directory. If you do not have the necessary permissions, either unset $DBTEMP (/tmp will be used), or use the -w <tempdir> option to specify the temp directory you want. 1. Close all applications. 2. Execute the installation shell using the following command: ./fjs-gdc-2.30.04-[build]-[version].run 3. Follow the directions that appear.

1-4

Genero Desktop Client Installation Guide

Appendix. Accessibility
IBM strives to provide products with usable access for everyone, regardless of age or ability.

Accessibility features for IBM Informix products

Accessibility features help a user who has a physical disability, such as restricted mobility or limited vision, to use information technology products successfully.

Accessibility features
The following list includes the major accessibility features in IBM Informix products. These features support: v Keyboard-only operation. v Interfaces that are commonly used by screen readers. v The attachment of alternative input and output devices.

Keyboard navigation
This product uses standard Microsoft Windows navigation keys.

Related accessibility information

IBM is committed to making our documentation accessible to persons with disabilities. Our publications are available in HTML format so that they can be accessed with assistive technology such as screen reader software.

IBM and accessibility

See the IBM Accessibility Center at http://www.ibm.com/able for more information about the IBM commitment to accessibility.

A-1

A-2

Genero Desktop Client Installation Guide

Notices
This information was developed for products and services offered in the U.S.A. IBM may not offer the products, services, or features discussed in this document in other countries. Consult your local IBM representative for information on the products and services currently available in your area. Any reference to an IBM product, program, or service is not intended to state or imply that only that IBM product, program, or service may be used. Any functionally equivalent product, program, or service that does not infringe any IBM intellectual property right may be used instead. However, it is the user's responsibility to evaluate and verify the operation of any non-IBM product, program, or service. IBM may have patents or pending patent applications covering subject matter described in this document. The furnishing of this document does not grant you any license to these patents. You can send license inquiries, in writing, to: IBM Director of Licensing IBM Corporation North Castle Drive Armonk, NY 10504-1785 U.S.A. For license inquiries regarding double-byte (DBCS) information, contact the IBM Intellectual Property Department in your country or send inquiries, in writing, to: Intellectual Property Licensing Legal and Intellectual Property Law IBM Japan Ltd. 1623-14, Shimotsuruma, Yamato-shi Kanagawa 242-8502 Japan The following paragraph does not apply to the United Kingdom or any other country where such provisions are inconsistent with local law: INTERNATIONAL BUSINESS MACHINES CORPORATION PROVIDES THIS PUBLICATION "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESS OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF NON-INFRINGEMENT, MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. Some states do not allow disclaimer of express or implied warranties in certain transactions, therefore, this statement may not apply to you. This information could include technical inaccuracies or typographical errors. Changes are periodically made to the information herein; these changes will be incorporated in new editions of the publication. IBM may make improvements and/or changes in the product(s) and/or the program(s) described in this publication at any time without notice. Any references in this information to non-IBM web sites are provided for convenience only and do not in any manner serve as an endorsement of those web sites. The materials at those web sites are not part of the materials for this IBM product and use of those web sites is at your own risk.

B-1

IBM may use or distribute any of the information you supply in any way it believes appropriate without incurring any obligation to you. Licensees of this program who wish to have information about it for the purpose of enabling: (i) the exchange of information between independently created programs and other programs (including this one) and (ii) the mutual use of the information which has been exchanged, should contact: IBM Corporation J46A/G4 555 Bailey Avenue San Jose, CA 95141-1003 U.S.A. Such information may be available, subject to appropriate terms and conditions, including in some cases, payment of a fee. The licensed program described in this document and all licensed material available for it are provided by IBM under terms of the IBM Customer Agreement, IBM International Program License Agreement or any equivalent agreement between us. Any performance data contained herein was determined in a controlled environment. Therefore, the results obtained in other operating environments may vary significantly. Some measurements may have been made on development-level systems and there is no guarantee that these measurements will be the same on generally available systems. Furthermore, some measurements may have been estimated through extrapolation. Actual results may vary. Users of this document should verify the applicable data for their specific environment. Information concerning non-IBM products was obtained from the suppliers of those products, their published announcements or other publicly available sources. IBM has not tested those products and cannot confirm the accuracy of performance, compatibility or any other claims related to non-IBM products. Questions on the capabilities of non-IBM products should be addressed to the suppliers of those products. All statements regarding IBM's future direction or intent are subject to change or withdrawal without notice, and represent goals and objectives only. All IBM prices shown are IBM's suggested retail prices, are current and are subject to change without notice. Dealer prices may vary. This information may contain examples of data and reports used in daily business operations. To illustrate them as completely as possible, any such examples may include the names of individuals, companies, brands, and products. All of these names are fictitious and any similarity to the names and addresses used by an actual business enterprise is entirely coincidental. If you are viewing this information softcopy, the photographs and color illustrations may not appear.

B-2

Genero Desktop Client Installation Guide

Trademarks
IBM, the IBM logo, and ibm.com are trademarks or registered trademarks of International Business Machines Corp., registered in many jurisdictions worldwide. Other product and service names might be trademarks of IBM or other companies. A current list of IBM trademarks is available on the Web at Copyright and trademark information at www.ibm.com/legal/us/en/copytrade.shtml. Four Js is a registered trademark of Four Js Development Tools Ltd. Genero and its logo are registered trademarks of Four Js Development Tools Europe Ltd. Intel and the Intel logo are trademarks or registered trademarks of Intel Corporation or its subsidiaries in the United States and other countries. Java and all Java-based trademarks and logos are trademarks or registered trademarks of Oracle and/or its affiliates. Linux is a registered trademark of Linus Torvalds in the United States, other countries, or both. Microsoft and Windows are trademarks of Microsoft Corporation in the United States, other countries, or both. UNIX is a registered trademark of The Open Group in the United States and other countries.

Notices

B-3

B-4

Genero Desktop Client Installation Guide

Product Number: 5725-D13

Printed in USA

GC27-3859-00