25127582

DB2 IBM Informix

Quick Beginnings for IBM Informix Dynamic Server Express Edition

Version 10.0

G251-2758-02

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

Third Edition (December 2005)

This document contains proprietary information of IBM. It is provided under a license agreement and is protected by copyright law. The information contained in this publication does not include any product warranties, and any statements provided in this manual should not be interpreted as such.

When you send information to IBM, you grant IBM a nonexclusive right to use or distribute the information in any way it believes appropriate without incurring any obligation to you.

Copyright International Business Machines Corporation 2005. All rights reserved. US Government Users Restricted Rights Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp.

Contents Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . vii In This Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . vii About This Manual . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . vii

Quick Beginning Tasks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . vii Types of Users . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . viii Demonstration Database . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . viii

Organization of This Manual . . . . . . . . . . . . . . . . . . . . . . . . . . . . . viii Documentation Conventions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . ix

Typographical Conventions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . ix Feature, Product, and Platform Markup . . . . . . . . . . . . . . . . . . . . . . . . . ix Syntax Diagrams . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . x Example Code Conventions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xiii

Additional Documentation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xiii IBM Informix Information Center . . . . . . . . . . . . . . . . . . . . . . . . . . . xiii Online Notes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xiv Informix Error Messages . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xv Manuals . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xv Online Help . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xvi

Accessibility . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xvi Compliance with Industry Standards . . . . . . . . . . . . . . . . . . . . . . . . . . xvi IBM Welcomes Your Comments . . . . . . . . . . . . . . . . . . . . . . . . . . . . xvi

Part 1. Introducing IBM Informix Dynamic Server Express Edition

Chapter 1. Introducing Express . . . . . . . . . . . . . . . . . . . . . . . . . 1-1 In This Chapter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-1 Dynamic Server Express Product Overview . . . . . . . . . . . . . . . . . . . . . . . . 1-1

IBM Informix Dynamic Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-2 Products Bundled with the Informix Database Server . . . . . . . . . . . . . . . . . . . . 1-2 IBM Informix Server Administrator (ISA) . . . . . . . . . . . . . . . . . . . . . . . . 1-4 IBM Informix JDBC Driver . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-4

An Informix Database Server to Suit Your Needs . . . . . . . . . . . . . . . . . . . . . . 1-5 Installation and Migration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-5

Migrating to Dynamic Server Express . . . . . . . . . . . . . . . . . . . . . . . . . 1-5 Other Migration Issues . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-7

Database Server Features . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-7 Security Issues . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-7

Part 2. Installing IBM Informix Dynamic Server Express Edition on Windows

Chapter 2. Preparing to Install Express on Windows . . . . . . . . . . . . . . . . 2-1 In This Chapter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-1 Reading the Online Notes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-1 Verifying Hardware Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-1 Verifying Administrators Group Membership . . . . . . . . . . . . . . . . . . . . . . . . 2-2 Identifying Existing Server Versions . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-2

Uninstalling Existing Versions . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-2 Installing Over an Existing Version . . . . . . . . . . . . . . . . . . . . . . . . . . 2-2

Configuring Role Separation (Optional) . . . . . . . . . . . . . . . . . . . . . . . . . . 2-2 Determining the Installation Directory . . . . . . . . . . . . . . . . . . . . . . . . . . 2-3 Knowing Your Installation Type . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-4

Local Installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-4 Domain Installation with Domain Administrator Privileges . . . . . . . . . . . . . . . . . . 2-4 Domain Installation Without Domain Administrator Privileges . . . . . . . . . . . . . . . . . 2-4

Copyright IBM Corp. 2005 iii

Choosing Your Installation Option . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-5 Completing the Installation Worksheet . . . . . . . . . . . . . . . . . . . . . . . . . . 2-5 Completing the Configuration Worksheet (Optional) . . . . . . . . . . . . . . . . . . . . . 2-6

Chapter 3. Installing Express on Windows . . . . . . . . . . . . . . . . . . . . 3-1 In This Chapter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-1 Installing IBM Informix Products . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-1 Performing a Silent Installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-3 Installing Client SDK from the Command Line . . . . . . . . . . . . . . . . . . . . . . . 3-8

Installing Client SDK with Silent Installation . . . . . . . . . . . . . . . . . . . . . . . 3-8 Common msiexec Operations . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-9 Setting Public Properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-9 Logging . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-10 Running the Advertised Installation of Client SDK . . . . . . . . . . . . . . . . . . . . . 3-10

Setting Up Specialized Installations . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-10 Installing Multiple Versions . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-10 Setting Up Cluster Installations . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-11 Setting Up Multiple Residency . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-15

Chapter 4. Post-Installation Tasks for Express on Windows . . . . . . . . . . . . . 4-1 In This Chapter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-1 Configuring Express on Windows . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-1

Completing the Configuration Worksheet . . . . . . . . . . . . . . . . . . . . . . . . 4-1 Configuring Dynamic Server Express . . . . . . . . . . . . . . . . . . . . . . . . . 4-4

Additional Post-Installation Tasks . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-5 Using the Dynamic Server Program Group . . . . . . . . . . . . . . . . . . . . . . . . 4-6 Starting and Stopping the Database Server . . . . . . . . . . . . . . . . . . . . . . . . . 4-6 Troubleshooting Installation Problems . . . . . . . . . . . . . . . . . . . . . . . . . . 4-8 Designing, Maintaining, and Extending the Database . . . . . . . . . . . . . . . . . . . . . 4-9

Chapter 5. Uninstalling Express on Windows . . . . . . . . . . . . . . . . . . . 5-1 In This Chapter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-1 Preparing to Uninstall Express . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-1 Uninstalling Dynamic Server Express . . . . . . . . . . . . . . . . . . . . . . . . . . 5-2 Reinstalling Express . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-2 Uninstalling ISA . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-3

Part 3. Installing IBM Informix Dynamic Server Express Edition on Linux

Chapter 6. Preparing to Install Express on Linux . . . . . . . . . . . . . . . . . 6-1 In This Chapter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-1 Preparing to Install . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-1

Creating group informix and user informix . . . . . . . . . . . . . . . . . . . . . . . 6-1 Applying Operating System Patches . . . . . . . . . . . . . . . . . . . . . . . . . . 6-2 Configuring Role Separation (Optional) . . . . . . . . . . . . . . . . . . . . . . . . . 6-2 Completing the Installation Worksheet . . . . . . . . . . . . . . . . . . . . . . . . . 6-3

Chapter 7. Installing Express on Linux . . . . . . . . . . . . . . . . . . . . . . 7-1 In This Chapter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-1 Choosing Installation Method . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-1 Installing Dynamic Server Express . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-2

Installation Syntax . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-2 Installing in Console Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-3 Installing Informix Products in GUI Mode . . . . . . . . . . . . . . . . . . . . . . . . 7-4

Using the Log Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-5 Alternative Installation Methods . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-5

Installing Informix Products in Silent Mode . . . . . . . . . . . . . . . . . . . . . . . 7-6 Installing Using Extraction With a Command-Line Script . . . . . . . . . . . . . . . . . . 7-10 Installing Dynamic Server Express Using RPM Package Manager Commands . . . . . . . . . . . . 7-13

iv Quick Beginnings for IBM Informix Dynamic Server Express Edition

ISA Installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-14 ISA Configuration Worksheet . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-14 ISA Installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-16

Chapter 8. Post-Installation Tasks for Express on Linux . . . . . . . . . . . . . . 8-1 In This Chapter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-1 Configuring the Database Server on Linux . . . . . . . . . . . . . . . . . . . . . . . . . 8-1

Set Environment Variables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-1 Prepare Connectivity Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-2 Prepare the onconfig File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-2 Initialize the Database Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-3

Using the Demonstration Database Server . . . . . . . . . . . . . . . . . . . . . . . . . 8-3 Testing the Installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-3

Additional Configuration Task Information . . . . . . . . . . . . . . . . . . . . . . . . 8-4 Designing, Maintaining, and Extending the Database . . . . . . . . . . . . . . . . . . . . . 8-5

Chapter 9. Uninstalling Express on Linux . . . . . . . . . . . . . . . . . . . . 9-1 In This Chapter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-1 Uninstalling Using the Uninstall Application . . . . . . . . . . . . . . . . . . . . . . . . 9-1 Uninstalling After Using the Extraction Application with Command-Line Script . . . . . . . . . . . . 9-2 Uninstalling Using RPM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-2

Part 4. Appendixes

Appendix A. Using the Documentation . . . . . . . . . . . . . . . . . . . . . A-1

Appendix B. Accessibility . . . . . . . . . . . . . . . . . . . . . . . . . . . B-1

Notices . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . C-1

Index . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . X-1

Contents v

vi Quick Beginnings for IBM Informix Dynamic Server Express Edition

Introduction In This Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . vii About This Manual . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . vii

Quick Beginning Tasks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . vii Types of Users . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . viii Demonstration Database . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . viii

Organization of This Manual . . . . . . . . . . . . . . . . . . . . . . . . . . . . . viii Documentation Conventions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . ix

Typographical Conventions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . ix Feature, Product, and Platform Markup . . . . . . . . . . . . . . . . . . . . . . . . . ix Syntax Diagrams . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . x

How to Read a Command-Line Syntax Diagram . . . . . . . . . . . . . . . . . . . . . xi Keywords and Punctuation . . . . . . . . . . . . . . . . . . . . . . . . . . . . xii Identifiers and Names . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xii

Example Code Conventions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xiii Additional Documentation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xiii

IBM Informix Information Center . . . . . . . . . . . . . . . . . . . . . . . . . . . xiii Online Notes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xiv

Locating Online Notes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xiv Online Notes Filenames . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xv

Informix Error Messages . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xv Manuals . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xv

Online Manuals . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xv Printed Manuals . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xvi

Online Help . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xvi Accessibility . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xvi Compliance with Industry Standards . . . . . . . . . . . . . . . . . . . . . . . . . . xvi IBM Welcomes Your Comments . . . . . . . . . . . . . . . . . . . . . . . . . . . . xvi

In This Introduction This introduction discusses the organization of the manual and the intended audience and introduces you to Dynamic Server Express.

About This Manual Quick Beginnings for IBM Informix Dynamic Server Express Edition provides all the information you need to get up and running with Dynamic Server Express. This guide discusses how to install Dynamic Server Express and introduces you to Dynamic Server maintenance, administration, and development, which are fully explored in the IBM Informix Documentation Library.

Quick Beginning Tasks This book describes or discusses the following quick beginning tasks: v Preparing to install IBM Informix products v Installing the database server and client applications v Migrating data from another version of the database server v Creating the demonstration database (optional) v Configuring the database server v Starting and stopping the database server v Designing and extending the database

Copyright IBM Corp. 2005 vii

v Uninstalling the database server

Types of Users This manual is written for database administrators (DBAs) who install IBM Informix products. This guide assumes that you are familiar with the operating procedures of your computer and with your operating system. For information about your operating system, see your Windows or Linux documentation.

Dynamic Server Express is designed for customers with minimal in-house database skills who need an easy-to-install database integrated into their application software solutions.

Demonstration Database The DBAccess utility, which is provided with your IBM Informix database server products, includes one or more of the following demonstration databases: v The stores_demo database illustrates a relational schema with information about a fictitious wholesale sporting-goods distributor. Many examples in IBM Informix manuals are based on the stores_demo database.

v The superstores_demo database illustrates an object-relational schema. The superstores_demo database contains examples of extended data types, type and table inheritance, and user-defined routines.

For information about how to create and populate the demonstration databases, see the IBM Informix DBAccess User's Guide. For descriptions of the databases and their contents, see the IBM Informix Guide to SQL: Reference.

The scripts that you use to install the demonstration databases reside in the $INFORMIXDIR/bin directory on Linux and in the %INFORMIXDIR%\bin directory on Windows.

Organization of This Manual This manual is in three sections: v Introducing Dynamic Server Express This section includes the following chapter: Chapter 1, Introducing Express, on page 1-1

v Dynamic Server Express installation on Windows This section includes the following chapters: Chapter 2, Preparing to Install Express on Windows, on page 2-1 Chapter 3, Installing Express on Windows, on page 3-1 Chapter 4, Post-Installation Tasks for Express on Windows, on page 4-1 Chapter 5, Uninstalling Express on Windows, on page 5-1

v Dynamic Server Express installation on Linux This section includes the following chapters: Chapter 6, Preparing to Install Express on Linux, on page 6-1 Chapter 7, Installing Express on Linux, on page 7-1 Chapter 8, Post-Installation Tasks for Express on Linux, on page 8-1 Chapter 9, Uninstalling Express on Linux, on page 9-1

v The rest of the manual includes the following:

viii Quick Beginnings for IBM Informix Dynamic Server Express Edition

Appendix A, Using the Documentation, on page A-1 discusses using the Dynamic Server documentation set.

An Accessibility appendix describes how to read syntax diagrams in the HTML version of this manual using a screen reader.

A Notices appendix describes IBM products, features, and services. An index directs you to areas of particular interest.

Documentation Conventions This section describes the conventions that this manual uses. These conventions make it easier to gather information from this and other volumes in the documentation set.

The following conventions are discussed: v Typographical conventions v Other conventions v Syntax diagrams v Command-line conventions v Example code conventions

Typographical Conventions This manual uses the following conventions to introduce new terms, illustrate screen displays, describe command syntax, and so forth.

Convention Meaning

KEYWORD Keywords of SQL, SPL, and some other programming languages appear in uppercase letters in a serif font.

italics Within text, new terms and emphasized words appear in italics. Within syntax and code examples, variable values that you are to specify appear in italics.

boldface Names of program entities (such as classes, events, and tables), environment variables, file and pathnames, and interface elements (such as icons, menu items, and buttons) appear in boldface.

monospace Information that the product displays and information that you enter appear in a monospace typeface.

KEYSTROKE Keys that you are to press appear in uppercase letters in a sans serif font.

> This symbol indicates a menu item. For example, Choose Tools > Options means choose the Options item from the Tools menu.

Tip: When you are instructed to enter characters or to execute a command, immediately press RETURN or ENTER after the entry. When you are instructed to type the text or to press other keys, no RETURN or ENTER is required.

Feature, Product, and Platform Markup Feature, product, and platform markup identifies paragraphs that contain feature-specific, product-specific, or platform-specific information. Some examples

Introduction ix

of this markup follow:

Dynamic Server

Identifies information that is specific to IBM Informix Dynamic Server

End of Dynamic Server

Windows Only

Identifies information that is specific to the Windows environment

End of Windows Only

This markup can apply to one or more paragraphs within a section. When an entire section applies to a particular product or platform, this is noted as part of the heading text, for example:

Table Sorting (Linux)

Syntax Diagrams This guide uses syntax diagrams built with the following components to describe the syntax for statements and all commands other than system-level commands.

Syntax diagrams depicting SQL and command-line statements have changed in the following ways: v The symbols at the beginning and end of statements are double arrows. v The symbols at the beginning and end of syntax segment diagrams are vertical lines.

v How many times a loop can be repeated is explained in a diagram footnote, whose marker appears above the path that is describes.

v Syntax statements that are longer than one line continue on the next line. v Product or condition-specific paths are explained in diagram footnotes, whose markers appear above the path that they describe.

v Cross-references to the descriptions of other syntax segments appear as diagram footnotes, whose markers immediately follow the name of the segment that they reference.

The following table describes syntax diagram components.

Component represented in PDF Component represented in HTML Meaning

>>---------------------- Statement begins.

-----------------------> Statement continues on next line.

>----------------------- Statement continues from previous line.

----------------------->< Statement ends.

--------SELECT---------- Required item.

x Quick Beginnings for IBM Informix Dynamic Server Express Edition

Component represented in PDF Component represented in HTML Meaning

--+-----------------+--- ------LOCAL------

Optional item.

---+-----ALL-------+--- +--DISTINCT-----+

---UNIQUE------

Required item with choice. One and only one item must be present.

---+------------------+--- +--FOR UPDATE-----+

--FOR READ ONLY--

Optional items with choice are shown below the main line, one of which you might specify.

.---NEXT---------. ----+----------------+---

+---PRIOR--------+ ---PREVIOUS-----

The values below the main line are optional, one of which you might specify. If you do not specify an item, the value above the line will be used as the default.

.-------,-----------. V |

---+-----------------+--- +---index_name---+

---table_name---

Optional items. Several items are allowed; a comma must precede each repetition.

>>-| Table Reference |->< Reference to a syntax segment.

Table Reference

|--+-----view--------+--| +------table------+

----synonym------

Syntax segment.

How to Read a Command-Line Syntax Diagram The following command-line syntax diagram uses some of the elements listed in the table in the previous section.

Creating a No-Conversion Job

onpladm create job job -p

project -n -d device -D database

-t table (1)

Setting the Run Mode

-S

server

-T

target

Notes:

1 See page Z-1

The second line in this diagram has a segment named Setting the Run Mode, which according to the diagram footnote, is on page Z-1. If this was an actual cross-reference, you would find this segment in on the first page of Appendix Z.

Introduction xi

Instead, this segment is shown in the following segment diagram. Notice that the diagram uses segment start and end components.

Setting the Run Mode:

-f

d

p

a

l c

u

n

N

To see how to construct a command correctly, start at the top left of the main diagram. Follow the diagram to the right, including the elements that you want. The elements in this diagram are case sensitive because the illustrates utility syntax. Other types of syntax, such as SQL, are not case sensitive.

The Creating a No-Conversion Job diagram illustrates the following steps: 1. Type onpladm create job and then the name of the job. 2. Optionally, type -p and then the name of the project. 3. Type the following required elements:

v -n v -d and the name of the device v -D and the name of the database v -t and the name of the table

4. Optionally, you can choose one or more of the following elements and repeat them an arbitrary number of times: v -S and the server name v -T and the target server name v The run mode. To set the run mode, follow the Setting the Run Mode segment diagram to type -f, optionally type d, p, or a, and then optionally type l or u.

5. Follow the diagram to the terminator.

Your diagram is complete.

Keywords and Punctuation Keywords are words reserved for statements and all commands except system-level commands. When a keyword appears in a syntax diagram, it is shown in uppercase letters. When you use a keyword in a command, you can write it in uppercase or lowercase letters, but you must spell the keyword exactly as it appears in the syntax diagram.

You must also use any punctuation in your statements and commands exactly as shown in the syntax diagrams.

Identifiers and Names Variables serve as placeholders for identifiers and names in the syntax diagrams and examples. You can replace a variable with an arbitrary name, identifier, or literal, depending on the context. Variables are also used to represent complex syntax elements that are expanded in additional syntax diagrams. When a variable appears in a syntax diagram, an example, or text, it is shown in lowercase italic.

xii Quick Beginnings for IBM Informix Dynamic Server Express Edition

The following syntax diagram uses variables to illustrate the general form of a simple SELECT statement.

SELECT column_name FROM table_name

When you write a SELECT statement of this form, you replace the variables column_name and table_name with the name of a specific column and table.

Example Code Conventions Examples of SQL code occur throughout this manual. Except as noted, the code is not specific to any single IBM Informix application development tool.

If only SQL statements are listed in the example, they are not delimited by semicolons. For instance, you might see the code in the following example: CONNECT TO stores_demo ...

DELETE FROM customer WHERE customer_num = 121 ...

COMMIT WORK DISCONNECT CURRENT

To use this SQL code for a specific product, you must apply the syntax rules for that product. For example, if you are using DBAccess, you must delimit multiple statements with semicolons. If you are using an SQL API, you must use EXEC SQL at the start of each statement and a semicolon (or other appropriate delimiter) at the end of the statement.

Tip: Ellipsis points in a code example indicate that more code would be added in a full application, but it is not necessary to show it to describe the concept being discussed.

For detailed directions on using SQL statements for a particular application development tool or SQL API, see the manual for your product.

Additional Documentation For additional information, refer to the following types of documentation: v Online notes v Informix error messages v Manuals v Online help

IBM Informix Information Center The IBM Informix Information Center integrates the entire IBM Informix Dynamic Server 10.0 and IBM Informix Client SDK (CSDK) 2.90 documentation sets in both HTML and PDF formats. The IBM Informix Information Center provides full text search, a master index, logical categories, easy navigation, and links to troubleshooting and support files.

The IBM Informix Information Center site is located at http://publib.boulder.ibm.com/infocenter/ids9help/index.jsp.

Introduction xiii

Online Notes The following sections describe the online files that supplement the information in this manual. Please examine these files before you begin using your IBM Informix product. They contain vital information about application and performance issues.

Online File Description Format

TOC Notes The TOC (Table of Contents) notes file provides a comprehensive directory of hyperlinks to the release notes, the fixed and known defects file, and all the documentation notes files for individual manual titles.

HTML

Documentation Notes The documentation notes file for each manual contains important information and corrections that supplement the information in the manual or information that was modified since publication.

HTML, text

Release Notes The release notes file describes feature differences from earlier versions of IBM Informix products and how these differences might affect current products. For some products, this file also contains information about any known problems and their workarounds.

HTML, text

Machine Notes (Non-Windows platforms only) The machine notes file describes any platform-specific actions that you must take to configure and use IBM Informix products on your computer.

text

Fixed and Known Defects File

This text file lists issues that have been identified with the current version. It also lists customer-reported defects that have been fixed in both the current version and in previous versions.

text

Locating Online Notes Online notes are available from the IBM Informix Online Documentation site at http://www.ibm.com/software/data/informix/pubs/library/ and in the IBM Informix Information Center at http://publib.boulder.ibm.com/infocenter/ids9help/index.jsp. Additionally you can locate these files before or after installation as described below.

Before Installation

All online notes are located in the /doc directory of the product CD. The easiest way to access the documentation notes, the release notes, and the fixed and known defects file is through the hyperlinks from the TOC notes file.

The machine notes file and the fixed and known defects file are only provided in text format.

After Installation

On UNIX platforms in the default locale, the documentation notes, release notes, and machine notes files appear under the $INFORMIXDIR/release/en_us/0333

xiv Quick Beginnings for IBM Informix Dynamic Server Express Edition

directory.

Dynamic Server

On Windows the documentation and release notes files appear in the Informix folder. To display this folder, choose Start > Programs > IBM product name version > Documentation Notes or Release Notes from the taskbar.

Machine notes do not apply to Windows platforms.


Online Notes Filenames Online notes have the following file formats:

Online File File Format Examples

TOC Notes prod_os_toc_version.html ids_win_toc_10.0.html

Documentation Notes prod_bookname_docnotes_version.html/txt ids_hpl_docnotes_10.0.html

Release Notes prod_os_relnotes_version.html/txt ids_unix_relnotes_10.0.txt

Machine Notes prod_machine_notes_version.txt ids_machine_notes_10.0.txt

Fixed and Known Defects File

prod_defects_version.txt

ids_win_fixed_and_known _defects_version.txt

ids_defects_10.0.txt client_defects_2.90.txt

ids_win_fixed_and_known _defects_10.0.txt

Informix Error Messages This file is a comprehensive index of error messages and their corrective actions for the Informix products and version numbers.

On UNIX platforms, use the finderr command to read the error messages and their corrective actions.

Dynamic Server

On Windows, use the Informix Error Messages utility to read error messages and their corrective actions. To display this utility, choose Start > Programs > IBM product name version > Informix Error Messages from the taskbar.


You can also access these files from the IBM Informix Online Documentation site at http://www.ibm.com/software/data/informix/pubs/library/ or in the IBM Informix Information Center at http://publib.boulder.ibm.com/infocenter/ids9help/index.jsp.

Manuals Online Manuals A CD that contains your manuals in electronic format is provided with your IBM Informix products. You can install the documentation or access it directly from the CD. For information about how to install, read, and print online manuals, see the installation insert that accompanies your CD. You can also obtain the same online

Introduction xv

manuals from the IBM Informix Online Documentation site at http://www.ibm.com/software/data/informix/pubs/library/ or in the IBM Informix Information Center at http://publib.boulder.ibm.com/infocenter/ids9help/index.jsp.

Printed Manuals To order hardcopy manuals, contact your sales representative or visit the IBM Publications Center Web site at http://www.elink.ibmlink.ibm.com/public/applications/publications/cgibin/pbi.cgi.

Online Help IBM Informix online help, provided with each graphical user interface (GUI), displays information about those interfaces and the functions that they perform. Use the help facilities that each GUI provides to display the online help.

Accessibility IBM is committed to making our documentation accessible to persons with disabilities. Our books are available in HTML format so that they can be accessed with assistive technology such as screen reader software. The syntax diagrams in our manuals are available in dotted decimal format, which is an accessible format that is available only if you are using a screen reader. For more information about the dotted decimal format, see the Accessibility appendix.

Compliance with Industry Standards The American National Standards Institute (ANSI) and the International Organization of Standardization (ISO) have jointly established a set of industry standards for the Structured Query Language (SQL). IBM Informix SQL-based products are fully compliant with SQL-92 Entry Level (published as ANSI X3.135-1992), which is identical to ISO 9075:1992. In addition, many features of IBM Informix database servers comply with the SQL-92 Intermediate and Full Level and X/Open SQL Common Applications Environment (CAE) standards.

IBM Welcomes Your Comments We want to know about any corrections or clarifications that you would find useful in our manuals, which will help us improve future versions. Include the following information: v The name and version of the manual that you are using v Section and page number v Your suggestions about the manual

Send your comments to us at the following email address:

[email protected]

This email address is reserved for reporting errors and omissions in our documentation. For immediate help with a technical problem, contact IBM Technical Support. For instructions, see the IBM Informix Technical Support website at http://www-306.ibm.com/software/data/informix/support/contact.html.

We appreciate your suggestions.

xvi Quick Beginnings for IBM Informix Dynamic Server Express Edition

Part 1. Introducing IBM Informix Dynamic Server Express Edition

This section introduces IBM Informix Dynamic Server Express Edition.

Copyright IBM Corp. 2005

Chapter 1. Introducing Express In This Chapter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-1 Dynamic Server Express Product Overview . . . . . . . . . . . . . . . . . . . . . . . . 1-1

IBM Informix Dynamic Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-2 Using Java Routines in Dynamic Server Express . . . . . . . . . . . . . . . . . . . . . 1-2

Products Bundled with the Informix Database Server . . . . . . . . . . . . . . . . . . . . 1-2 BladeManager . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-2 DataBlade Developers Kit . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-2 IBM Informix Connect . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-3 Client SDK Products . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-3

IBM Informix Server Administrator (ISA) . . . . . . . . . . . . . . . . . . . . . . . . 1-4 IBM Informix JDBC Driver . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-4

An Informix Database Server to Suit Your Needs . . . . . . . . . . . . . . . . . . . . . . 1-5 Installation and Migration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-5

Migrating to Dynamic Server Express . . . . . . . . . . . . . . . . . . . . . . . . . 1-5 Migration and Enterprise Replication . . . . . . . . . . . . . . . . . . . . . . . . 1-6 Migration and High-Availability Data Replication . . . . . . . . . . . . . . . . . . . . 1-6

Other Migration Issues . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-7 Database Server Features . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-7

Security Issues . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-7

In This Chapter This chapter provides an overview of Dynamic Server Express and a comparison with Dynamic Server Enterprise Edition.

Dynamic Server Express Product Overview IBM Informix Dynamic Server Express Edition (Dynamic Server Express) is the newest member of the Dynamic Server product family, specially tailored for small and medium businesses (SMBs). It combines the power, function, and reliability of the Informix Dynamic Server database server with deployment at a minimal investment cost to meet the data management needs of SMBs.

Dynamic Server Express is available on Linux operation systems with the following IBM Informix products: v IBM Informix BladeManager v IBM Informix Datablade Developers Kit v IBM Informix JDBC Driver (JDBC) v IBM Informix Connect (IConnect)

or

v IBM Informix Client Software Developers Kit (Client SDK)

IBM Informix Server Administrator (ISA) is available on the Dynamic Server media to be separately installed.

In addition, you can install Dynamic Server Express, IConnect, or Client SDK separately.

Dynamic Server Express is available on machines running Microsoft Windows 2000, Microsoft Windows XP, and Microsoft Windows Server 2003 with the following IBM Informix products:

Copyright IBM Corp. 2005 1-1

v IBM Informix BladeManager v IBM Informix DataBlade Developers Kit v IBM Informix Connect (IConnect) v IBM Informix Client Software Developers Kit (Client SDK) v IBM Informix ClusterIt v IBM Informix Server Administrator (ISA)A separately installable IBM Informix JDBC Driver (JDBC) is available on the media.

IBM Informix Dynamic Server A database server is a software package that manages access to one or more databases for one or more client applications. Dynamic Server Express is a fast and scalable database server that manages traditional relational, object-relational, and web-based databases. Dynamic Server Express is a full-featured database server engineered for the needs of small-to-medium businesses.

Like IBM Informix Dynamic Server Enterprise Edition, Dynamic Server Express supports alphanumeric and rich data, such as graphics, multimedia, geospatial, HTML, and user-defined types. You can use Dynamic Server Express on Linux or Windows with online transaction processing (OLTP), data marts, data warehouses, and e-business applications.

Using Java Routines in Dynamic Server Express With Dynamic Server Express, you can use IBM Informix JDBC Driver to compile and run Java client programs. Express also includes Java classes, methods, and interfaces that allow you to access databases from within the database server and write user-defined routines (UDRs) in Java. (A UDR is a routine that an SQL statement, user-defined function, or user-defined procedure can invoke.) With Dynamic Server Express, you can compile and run both Java client and server-side programs.

Products Bundled with the Informix Database Server In addition, several products are included with the database server. This section discusses the IBM Informix products that help you manage the database server. The following products are bundled with Dynamic Server: v IBM Informix BladeManager v IBM Informix DataBlade Developers Kit v IBM Informix Connectv IBM Informix Client Software Developers Kit (Client SDK)

BladeManager Use the BladeManager to register new DataBlade modules in Informix databases. BladeManager runs on client computers.

For more information, see the IBM Informix DataBlade Module Installation and Registration Guide.

DataBlade Developers Kit The DataBlade Developers Kit includes the following tools for developing and packaging DataBlade modules: v BladeSmith (organizes a DataBlade development project) v DBDK Visual C++ Add-In and Ifx Query (debugs DataBlade modules)

1-2 Quick Beginnings for IBM Informix Dynamic Server Express Edition

v BladePack (creates a DataBlade package) v BladeManager (registers and unregisters DataBlade modules)

For more information, see the DataBlade Module Development Overview and IBM Informix DataBlade Developer's Kit User's Guide.

IBM Informix Connect IBM Informix Connect (IConnect) allows applications that run on client computers to access the database server.

Client SDK Products The IBM Informix Client Software Developers Kit (Client SDK) includes several application-programming interfaces (APIs) that developers can use to write applications for Informix database servers in ESQL, C, and Java. You can also write Informix ESQL/C applications for the DB2 database server. IBM Informix Connect contains the runtime libraries of the APIs in the Client SDK.

IBM Informix ESQL/C: ESQL/C is an SQL application programming interface (API) that lets programmers embed SQL statements directly into a C program to interact with the database server, access databases, manipulate the data in a program, and check for errors.

IBM Informix ESQL/C consists of the following components: v ESQL/C libraries of C functions for accessing the database server v ESQL/C header files, which provide definitions for the data structures, constants, and macros

v esql, a command that manages the source-code processing to convert a C file that contains SQL statements into an object file

v ESQL client-interface dynamic link libraries (DLLs), which let an ESQL/C application run in Windows (Windows only)

For more information, see the IBM Informix ESQL/C Programmer's Manual.

IBM Informix GLS: Global Language Support (GLS) allows you to create databases that use the diacritics, collating sequence, and monetary and time conventions of the language that you select. The IBM Informix GLS library contains APIs that let programmers develop internationalized ESQL/C and DataBlade module client applications. IBM Informix GLS is separately orderable, but the GLS libraries are shipped with the database server and Client SDK.

IBM Informix GLS provides procedures, macros, and functions to: v Process single-byte and multibyte characters and strings. v Convert date, time, monetary, and number values from and to locale-specific data formats.

For more information, see the IBM Informix GLS User's Guide. IBM Informix GLS provides an HTML reference that you can access with a web browser. The URL must include the full pathname of the directory that your INFORMIXDIR environment variable designates: $INFORMIXDIR/doc/gls_api/en_us/0333/index.htm on Linux or %INFORMIXDIR%\doc\gls_api\en_us\04e4\index.htm on Windows.

IBM Informix .NET Provider: The IBM Informix .NET Provider is a .NET assembly that lets .NET applications access and manipulate data in IBM Informix

Chapter 1. Introducing Express 1-3

databases. It does this by implementing several interfaces in the Microsoft .NET Framework that are used to access data from a database.

For more information, see: IBM Informix .NET Provider Reference Guide.

IBM Informix Object Interface for C++: Use the IBM Informix Object Interface for C++ to develop IBM Informix client applications using the C++ programming language.

For more information, see the IBM Informix Object Interface for C++ Programmer's Guide.

IBM Informix ODBC Driver: IBM Informix ODBC Driver is the Informix implementation of the Microsoft Open Database Connectivity (ODBC) standard. It supports SQL statements with a library of C functions that an application calls to access Informix databases.

For more information, see the IBM Informix ODBC Driver Programmer's Manual.

IBM Informix OLE DB Provider (Windows): IBM Informix OLE DB Provider enables OLE DB applications, such as Active Data Objects (ADO) applications and web pages, to access the database server.

For more information, see the IBM Informix OLE DB Provider Programmer's Guide.

TP/XA: The TP/XA library facilitates communication between a third-party transaction manager and your database server. TP/XA is supplied with IBM Informix ESQL/C. Use TP/XA for distributed transaction processing in a multivendor database setting.

IBM Informix Server Administrator (ISA) IBM Informix Server Administrator (ISA) is a browser-based tool that provides web-based system administration for Informix database servers. ISA provides access to database server command-line functions and presents the output in an easy-to-read format.

For information on how to use ISA, see the ISA online help and onscreen instructions.

For Dynamic Server Express, ISA is separately available on your product CD (on Linux). On Windows, ISA is installable with the installation application that installs Dynamic Server Express.

IBM Informix JDBC Driver IBM Informix JDBC Driver lets Java programmers access Informix databases from within Java applications or applets. Programmers can create client applications that use JDBC to connect to Dynamic Server, query and retrieve data from a database or column, handle errors, and write UDRs. The IBM Informix JDBC Driver is compatible with the JavaSoft JDBC specifications. It maps standard Java data types and Informix database server data types.

On Windows, IBM Informix JDBC Driver is separately available on your product CD. On Linux, IBM Informix JDBC Driver is installable with the installation application that installs Dynamic Server Express.


For more information on IBM Informix JDBC Driver, see the IBM Informix JDBC Driver Programmer's Guide.

An Informix Database Server to Suit Your Needs Use the following information to help you decide whether Dynamic Server Express or Enterprise Edition is right for your business needs.

Table 1-1. Dynamic Server Features

Feature Dynamic Server Enterprise Edition

Dynamic Server Express

CPUs No limit to CPUs License restricts Express to 2 CPUs

High-Availability Data Replication

Available feature Not available

Enterprise Replication Available feature Not available

Price point Higher price point Lower price point

High-Availability Data Replication (HDR) provides a way to maintain a backup copy of the entire database server that applications can access quickly in the event of a catastrophic failure.

Enterprise Replication generates and manages multiple copies of data at one or more sites, which allows an enterprise to share corporate data throughout its organization.

With two CPUs, typical customer configurations have fewer than 30 GB of data. However, the number of CPUs you need depends on the CPU speed and type of SQL queries used by your application.

For more information, see the IBM Informix Administrator's Guide and the IBM Informix Performance Guide.

Installation and Migration For information on how to install the database server and other IBM Informix products, see Chapter 3, Installing Express on Windows and Chapter 7, Installing Express on Linux.

Migrating to Dynamic Server Express You can convert to Dynamic Server Express from any of the following Dynamic Server Enterprise Edition versions on Linux: v Dynamic Server 10.00 v Dynamic Server 9.40 v Dynamic Server 9.30 v Dynamic Server 9.21 v Dynamic Server 7.31, 7.30

You can convert to Dynamic Server Express from any of the following Dynamic Server Enterprise Edition versions on Windows: v Dynamic Server 10.00 (Windows 2000, Windows XP Professional, or Windows Server 2003)

v Dynamic Server 9.40 (Windows 2000, Windows XP Professional)


v Dynamic Server 9.30 (Windows 2000) v Dynamic Server 9.21 (Windows 2000) v Dynamic Server 7.31 (Windows 2000)

If you use clusters and upgrade from a version of Dynamic Server before 9.40.TC6 without removing the old installation, you must delete the clusapi.dll file from your installation directory prior to installing Dynamic Server Express.

Migration and Enterprise Replication Dynamic Server Express does not support Enterprise Replication. Before migrating your database server to Dynamic Server Express, drop existing Enterprise Replication configuration using the cdr delete server command option.

After upgrading to Dynamic Server Express, no Enterprise Replication command-line interface options will be available.

Any remote Enterprise Replication clients trying to connect to an Dynamic Server Express server will receive error number 167: ER is not supported in IDS Express Edition server.

No Enterprise Replication configuration parameters or environment variables are supported. These include: v CDR_ENV v CDR_EVALTHREADS v CDR_DSLOCKWAIT v CDR_QUEUEMEM v CDR_NIFCOMPRESS v CDR_QHDR_DBSPACES v CDR_QDATA_SBSPACE v CDR_DBSPACE v CDR_MAX_DYNAMIC_LOGS v CDR_SERIAL v CDR_SUPPRESS_ATSRISWARN v ENCRYPT_CDR

If you did not delete Enterprise Replication before converting to Dynamic Server Express and then revert the database server to Enterprise Edition, the integrity of the syscdr database is not restored. In this case, you must drop the syscdr database and start afresh. You can drop the syscdr database with the cdr remove command and by issuing cdr delete serv at other nodes in the topology.

For more information on migration in general, see the IBM Informix Migration Guide.

Migration and High-Availability Data Replication No HDR configuration parameters are supported. These include: v DRAUTO v DRINTERVAL v DRTIMEOUT


Other Migration Issues For migration issues concerning Client SDK, JDBC, and ISA, see the release notes for these products. The release notes are installed with the product and are also available in the IBM Informix Information Center at http://publib.boulder.ibm.com/infocenter/ids9help/index.jsp.

Database Server Features For information on the newest features of Informix database servers and the standard features that comprise IBM Informix Dynamic Server that are also supported by Dynamic Server Express, see the IBM Informix Getting Started Guide. Dynamic Server Express supports all of the features of Dynamic Server on Linux and Microsoft Windows, except for those involving Enterprise Replication and High-Availability Data Replication.

Security Issues Dynamic Server Express supports all of the security features of IBM Informix Dynamic Server. For information on IBM Informix database-server security features and information on using the database server secure-auditing facility to set up and manage audit trails and audit records, see the IBM Informix Information Center. The IBM Informix Information Center site is located at http://publib.boulder.ibm.com/infocenter/ids9help/index.jsp.

For additional information on security issues, see the IBM Informix Trusted Facility Guide.


Part 2. Installing IBM Informix Dynamic Server Express Edition on Windows

This section includes: v Chapter 2, Preparing to Install Express on Windows v Chapter 3, Installing Express on Windows v Chapter 4, Post-Installation Tasks for Express on Windows v Chapter 5, Uninstalling Express on Windows

Copyright IBM Corp. 2005

Chapter 2. Preparing to Install Express on Windows In This Chapter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-1 Reading the Online Notes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-1 Verifying Hardware Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-1 Verifying Administrators Group Membership . . . . . . . . . . . . . . . . . . . . . . . . 2-2 Identifying Existing Server Versions . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-2

Uninstalling Existing Versions . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-2 Installing Over an Existing Version . . . . . . . . . . . . . . . . . . . . . . . . . . 2-2

Configuring Role Separation (Optional) . . . . . . . . . . . . . . . . . . . . . . . . . . 2-2 Determining the Installation Directory . . . . . . . . . . . . . . . . . . . . . . . . . . 2-3 Knowing Your Installation Type . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-4

Local Installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-4 Domain Installation with Domain Administrator Privileges . . . . . . . . . . . . . . . . . . 2-4 Domain Installation Without Domain Administrator Privileges . . . . . . . . . . . . . . . . . 2-4

Choosing Your Installation Option . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-5 Completing the Installation Worksheet . . . . . . . . . . . . . . . . . . . . . . . . . . 2-5 Completing the Configuration Worksheet (Optional) . . . . . . . . . . . . . . . . . . . . . 2-6

In This Chapter This chapter discusses preparing to install Dynamic Server Express and other IBM Informix products on Microsoft Windows.

To install on Windows, complete the following preliminary tasks: v Reading the Online Notes v Verifying Hardware Requirements v Verifying Administrators Group Membership v Identifying Existing Server Versions v Configuring Role Separation (Optional) v Determining the Installation Directory v Knowing Your Installation Type v Choosing Your Installation Option v Completing the Installation Worksheet v Completing the Configuration Worksheet (Optional)

Reading the Online Notes Read the release notes and documentation notes.

These files are located on the CD, in the SERVER/doc directory. For information on the contents of these files, see Online Notes on page xiv.

Verifying Hardware Requirements Verify that your computer meets the minimum requirements: v Windows 2000, Windows XP Professional, or Windows Server 2003 v 128 megabytes of RAM (minimum); 256 megabytes (recommended) v Sum of RAM and swap file must be 256 megabytes (minimum); 512 megabytes (recommended)


v Destination drive with a Windows file system (NTFS) v 154 megabytes of disk space for the database server (including a minimum of 50 megabytes for the initial chunk of root dbspace and adequate space to accommodate your data) The installation program determines at runtime the amount of disk space required.

Verifying Administrators Group Membership Verify that you are logged in as a member of the Windows Administrators group.

For information on how to create groups and add users to groups, see your Windows documentation.

Identifying Existing Server Versions An existing version of the database server can cause complications during the installation of a new one.

Uninstalling Existing Versions Uninstall any existing version of the database server before you install the new version to avoid conflict with directories, .dll files, registry entries, or Informix-related services.

To uninstall an existing version, follow the steps in Chapter 5, Uninstalling Express on Windows, on page 5-1.

Installing Over an Existing Version If you install the database server over an existing installation, the installation program prompts you to choose one of the following options: v Install new files without changing configuration. The installation program uses the existing database server configuration and installs the new database server over the existing database server.

v Install new files and reconfigure, overwriting existing data. The installation program removes all existing database server configuration information, installs the new database server over the existing database server, and displays new database server configuration screens.

v Copy all files and perform upgrade. The installation program uses the existing database server configuration and installs the new database server over the existing database server.

v Install in a different directory. Use this prompt to install multiple versions of the database server on your computer. The installation program installs the new database server into the directory that you specify and prompts you to configure it. The program does not delete the existing database server or change its configuration. In this case, each installation has its own program group on the Programs menu.

Configuring Role Separation (Optional) Role separation provides increased database security because the database server splits administrative tasks into mutually exclusive roles. For detailed information about the role separation feature, see the IBM Informix Trusted Facility Guide.


You cannot turn off role separation once you have enabled it. To remove role separation, you must uninstall the database server and reinstall it without role separation.

To enable role separation, run the installation. (See Chapter 3, Installing Express on Windows, on page 3-1.) On the Role Separation screen, check the box to create users and groups.

If you choose to enable role separation during installation, you are prompted to create groups and users and add the users to the corresponding groups.

Table 2-1. Role Separation Default Group Name Role Category Role Definition

ix_dbsa (INFORMIX-ADMIN)

Database Administrator

Performs general administrative tasks, such as archiving and restoring data, monitoring use and performance, and tuning the system

ix_aao Auditing Analysis Officer

Audits the records of specific types of database activities. If someone attempts to circumvent or corrupt the security mechanism of the database, these actions can be traced.

ix_dbsso Database System Security Officer

Maintains the security of the database server. Functions of this role include audit adjustment and changing security characteristics of storage objects.

ix_users Database Users Accesses the database to perform end-user tasks. With role separation enabled, only users who are designated as members of the ix_users group can access the database.

After installation you can manually add users to these groups.

If you do not enable role separation, the Informix-Admin group performs all administrative tasks.

Determining the Installation Directory The installation directory is where you want the database server files to reside. The drive on which the directory exists must be formatted using NTFS. IBM Informix software refers to this installation directory as INFORMIXDIR and often uses this value to set the %INFORMIXDIR% environment variable.

However, there is no need to create INFORMIXDIR prior to installation. You can provide the installation directory during the installation process; otherwise, the installation application will create a directory.

The installation program prompts you for different information, depending on the type of installation that you are performing: v First-Time Installations If you previously created the INFORMIXDIR directory, this directory is the default installation directory.

v Upgrades and Reinstallations

Chapter 2. Preparing to Install Express on Windows 2-3

If you have already installed a database server, the installation directory is the directory where the database server is installed. If you plan to perform an upgrade or reinstall in the same program group, select this directory as the installation directory.

v Multiple Installations If you have already installed the database server, the installation directory is the directory where the database server is installed. This installation of the database server has a corresponding Informix Dynamic Server program group on the Start > Programs menu. To install the database server in a second program group, specify an installation directory for the second program group that is different from the installation directory for the first program group. The result is two separate installations of the database server, each installation having its own program group.

Knowing Your Installation Type Choose to install locally or in a domain.

Local Installation If you do not plan to have workstations access a domain controller, install the database server on a local computer. For a local installation, you should have administrative privileges.

Domain Installation with Domain Administrator Privileges Domain installation is useful if you run the database server on several computers and want a central security mechanism. If several of your computers belong to the same domain (and therefore share the same primary domain controller or domain controllers), perform a domain install on these computers. To install in a domain, you must have administrative privileges and your computer must already belong to a domain. Run the installation program and choose the Install in Domain option when the installation wizard prompts you.

Domain Installation Without Domain Administrator Privileges You can perform a domain installation if you do not have domain administrative privileges as long as you have administrative privileges on the local computer and the computer belongs to the domain.

To perform a domain installation without domain administrator privileges:

1. Create the user informix in the domain and make user informix a member of the Global Domain Admin group. Any user who has the required privileges to create users and groups in the domain can perform this step.

2. Decide whether or not to enable role separation. If you do not plan to enable role separation, create a domain user named informix and a domain group called Informix-Admin. Make user informix part of the group Informix-Admin. Skip to step 4.

3. To enable role separation in a domain installation without domain administrator privileges, perform the following tasks: a. Create special administrative groups, ix_aao, ix_dbsso, and ix_users. b. Create two users, the Auditing Analysis Officer (AAO) and the Database

System Security Officer (DBSSO).


c. Add the AAO user to the ix_aao group and the DBSSO user to the ix_dbsso group.

d. Add users AAO, DBSSO, and informix to the ix_users group.4. Perform the following tasks:

a. Make the domain user informix a member of the administrators group on the local computer.

b. Grant the following advanced privileges and rights to user informix: v Log in as service v Act as part of the operating system v Increase quotas v Replace a process level token

5. Log in as domain_name\informix from individual computers to enable domain installation.

6. Run the installation program and choose the Install in Domain option when the installation wizard prompts you.

For more information on domains, see your Windows documentation.

Choosing Your Installation Option Select one of the following installation options: v Typical installation. A typical installation requires the most disk space and memory. It is the recommended installation for most database servers.

v Minimal installation. A minimal installation conserves the most disk space. v Custom installation. A custom installation allows you to perform advanced installation steps and configuration of the database server.

Completing the Installation Worksheet Use the following information to respond to prompts during the installation process.

IBM Informix Product Installation Worksheet

Administrators Group Membership _ Yes

_ No

Upgrading from an Existing Version _ Uninstall existing version.

_ Install new files without changing configuration.

_ Install new files and reconfigure, overwriting existing data.

_ Copy all files and perform upgrade.

_ Install in a different directory.

Installation Option _ Local

_ Domain with Domain Administrator Privileges

_ Domain without Domain Administrator Privileges

Installation Directory (%INFORMIXDIR%)

Default location is C:\Informix. ___________________________________________

Chapter 2. Preparing to Install Express on Windows 2-5

IBM Informix Product Installation Worksheet

Installation Option _ Typical

_ Minimal

_ Custom

Role Separation _ No

_ Yes

Enter Administrative Group Names:

Administrator (INFORMIX_ADMIN):

___________________________________________ ___________________________________________

Enter Administrative Account Names:

Auditing (AAO):

___________________________________________

Security (DBSSO):

___________________________________________

Completing the Configuration Worksheet (Optional) The Configuration Worksheet contains the information you need to respond to prompts during database server configuration. After the installation program installs the IBM Informix files on your system, you return to the main page of the wizard. If you have completed the information in the configuration worksheet and are ready to configure a database server, you can configure it at this time. Alternatively, you can choose to cancel and use the Server Instance Manager to configure a database server later.

See Chapter 4, Post-Installation Tasks for Express on Windows, on page 4-1 for configuration information.


Chapter 3. Installing Express on Windows In This Chapter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-1 Installing IBM Informix Products . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-1 Performing a Silent Installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-3 Installing Client SDK from the Command Line . . . . . . . . . . . . . . . . . . . . . . . 3-8

Installing Client SDK with Silent Installation . . . . . . . . . . . . . . . . . . . . . . . 3-8 Common msiexec Operations . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-9 Setting Public Properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-9 Logging . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-10 Running the Advertised Installation of Client SDK . . . . . . . . . . . . . . . . . . . . . 3-10

Setting Up Specialized Installations . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-10 Installing Multiple Versions . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-10

Multiple Installations and the Database Server Program Group . . . . . . . . . . . . . . . 3-10 Using the Server Instance Manager with Multiple Installations . . . . . . . . . . . . . . . . 3-11

Setting Up Cluster Installations . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-11 Overview of Implementing a Cluster on Two Nodes . . . . . . . . . . . . . . . . . . . 3-11 Implementing a Cluster on the Primary Node . . . . . . . . . . . . . . . . . . . . . 3-12 Installing Dynamic Server Express as a Cluster on the Secondary Node . . . . . . . . . . . . . 3-14

Setting Up Multiple Residency . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-15

In This Chapter This chapter explains how to install Dynamic Server Express on Microsoft Windows. You can also use the installation program to install the following IBM Informix products: v IBM Informix Client SDK v IBM Informix Connect v IBM Informix Server Administrator v IBM Informix BladeManager v IBM Informix DataBlade Developers Kit v IBM Informix ClusterIT

IBM Informix JDBC Driver is available on the installation media to be separately installed. For information on installing IBM Informix JDBC Driver, see the IBM Informix JDBC Driver Programmer's Guide.

Installing IBM Informix Products Use the information from the Installation Worksheet to respond to prompts and select options during installation. For information on the Installation Worksheet and preparations for installing Dynamic Server Express, see Chapter 2, Preparing to Install Express on Windows, on page 2-1

Dynamic Server Express for Windows includes a Windows launch pad, a graphical interface with the options to view this manual or the release notes, start the installation, or browse the CD. The launch pad will start automatically when the CD is inserted.

You can also follow these steps to install IBM Informix products.

To install IBM Informix products:


1. Start the installation program in one of the following ways: v Double-click Setup.exe from the root directory of the CD. v At the command prompt, Enter: run X:\Setup.exe where X: is the drive where the product CD is mounted.

For server-only installation, click the Setup application icon (Setup.exe) in the in the X:\IIF subdirectory of the directory where you downloaded the product files.

2. Read and then accept the license agreement. 3. Specify the installation directory.

The destination drive must be formatted with a Windows file system (NTFS). 4. Select the products to install.

All the products that come bundled with Dynamic Server Express are selected by default. Entering the number that corresponds to the appropriate product will select the product if it is not selected and deselect the product if it is already selected.

5. If you are upgrading your database server or reinstalling a 10.0 database server, choose Copy all files and upgrade from the Run the Installation Again? dialog box (which comes up automatically if you have previously installed the database server). The installation program skips most of the setup pages and uses existing information instead.

6. Specify a domain installation type, if applicable. 7. Choose the installation option:

v Typical v Minimal v Custom

8. If desired, enable role separation. To skip role separation, click Next and skip to step 9. If you enable role separation: a. Enter or select the names of the administrative groups that access the

database server. b. Enter the name of the auditing administrator account and the password

twice for confirmation. c. Enter the name of the security administrator account and the password

twice for confirmation. d. Specify the informix user password.

The database server service that the installation program creates runs under this account. If the account does not exist, the installation program creates the account.

9. Complete the installation.

After the installation program installs the files on your system, you return to the main page of the wizard. If you have already filled out a Configuration Worksheet (that is, in addition to an Installation Worksheet), you can configure a database server now. Alternatively, you can choose Cancel and use the Server Instance Manager to configure a database server later.

For information on configuration and post-installation tasks, see Chapter 4, Post-Installation Tasks for Express on Windows, on page 4-1.


Performing a Silent Installation A silent installation requires no user interaction with the installation program.

To run a silent installation, you must: 1. Copy the silent.ini file from the top directory in the database server product

folder (Iif) to a temporary directory. 2. Customize the silent.ini file. 3. Start the silent installation.

The last two steps are described in the following sections.

Customizing the silent.ini File The silent.ini file contains installation parameters as well as comments that show you how to modify these parameters. You must modify this file to contain the correct parameters for your silent installation.

The following tables show the parameters whose values you set in the silent.ini file.

BUNDLE_COMMON and PRODUCT_IDS Parameters The following table lists the minimum set of BUNDLE_COMMON and PRODUCT_IDS parameters that must be present in the silent.ini file and explains the values for each parameter.

Table 3-1. BUNDLE_COMMON and PRODUCT_IDS Parameters Parameter Description

Install_Dir The directory in which you plan to install the product files. See Determining the Installation Directory on page 2-3

ACTUAL_INSTALL_DIR The directory in which you plan to install the product files (same as the Install_Dir)

Server Install Parameters The values in the Server Install section of the silent.ini file specify how the database server is to be installed. The following minimum set of parameters in this section is necessary for copying files over in a database server install. From more information, see Choosing Your Installation Option on page 2-5.

Table 3-2. Server Install Parameters Parameter Description

Typical Specify a value of 1 to install the database server as a typical install. If you do not specify any value, the default value is 1. You cannot set both Typical and Minimal to 1.

Minimal Specify a value of 1 to install the database server as a minimal install. You cannot set both Typical and Minimal to 1.

Shutdown_Services Specify a value of 1 to shut down the services that must be shut down for the installation to proceed. These services include any services that the computer must upgrade, such as the database server and other services such as OnSNMP. If you specify any value other than 1, the computer does not shut down services. If some of the services are using the files that must be upgraded, the install might not complete correctly.

Chapter 3. Installing Express on Windows 3-3

Table 3-2. Server Install Parameters (continued) Parameter Description

Upgrade Specify a value of 1 to upgrade any existing versions that the installation program detects. If you specify 0, and the installation program detects an existing version, the database server is not upgraded. Because co-existence with previous versions is not supported in this release, an unspecified value implies a value of 0.

Reinstall The Reinstall parameter is similar to the Upgrade parameter. However, you can install the same version again.

Domain_Install Specify a value of 1 to create the user groups in a domain. If you do not specify a value of 1, all of the user accounts and groups that are created reside in the local computer. However, enabling domain install requires that the person who performs the install have domain administrator privileges. This parameter is ignored if the person who performs the install cannot install in a domain. For more information, see Domain Installation Without Domain Administrator Privileges on page 2-4

Role_Separation Specify a value of 1 to enable role separation. If you specify any other value than 1, role separation is not enabled.

IXDBSA_Group Set this parameter to the name of the ix_dbsa group. The database server uses this parameter to verify that the user belongs to the ix_dbsa group. The group is created in the domain if the user selected domain install. Otherwise, the group is local. The group is used only if role separation is enabled. Use the default value unless you require a specific group name.

IXDBSSO_Group Set this parameter to the name of the ix_dbsso group. The database server uses this parameter to verify that the user belongs to the ix_dbsso group. The group is created in the domain if the user selected domain install. Otherwise, the group is local. The group is used only if role separation is enabled. Use the default value unless you require a specific group name.

IXAAO_Group Set this name to the ix_aao group. The database server uses this parameter to verify that the user belongs to the ix_aao group. The group is created in the domain if the user selected domain install. Otherwise, the group is local. The group is used only if role separation is enabled. Use the default value unless you require a specific group name.

IXUSERS_Group Set this parameter to the name of the ix_usersgroup. The database server uses this parameter to verify that the user belongs to the ix_users group. The group is created in the domain if the user selected domain install. Otherwise the group is local. The group is used only if role separation is enabled. Use the default value unless you require a specific group name.

Account_Passwd Set this parameter to the password for the informix user. The password provided for this value can be read by anyone. After installation is completed, remove the password from this file or copy the file to a secure place and remove it from the installation directory.

Configure_Instance Specify a value of 1 to create a new instance of the database server. If you specify a value of 0, an instance is not configured in the case of a fresh install. If you are performing a reinstall, this parameter determines whether the existing configuration information is used, or whether a new instance of the database server is to be configured after deleting the existing instance.


Table 3-2. Server Install Parameters (continued) Parameter Description

Create_Icons Specify a value of 1 to create icons for the installed programs. Specify a value of 0 to disable icon creation.

Server Instance Parameters The Server Instance section of the silent.ini file specifies parameters that are required to configure a particular instance of the database server. The installation program uses these parameters only in the case of a fresh install. If the install is an u

25127582

Documents

ibm informix products

copyright ibm

ibm corp

informix database server

proprietary information

ibm informix jdbc driver

domain installation

industry standardsxvi