Installation Dynamic Server

8/6/2019 Installation Dynamic Server

1/56

Installation Guide

for

IBM Informix Dynamic Server

for UNIX and Linux

Version 9.3August 2001Part No. 000-8321


2/56

ii Installation Guide for IBM Informix Dynamic Server for UNIX and Linux

Copyright International Business Machines Corporation 2001. All rights reserved .

Trademarks

AIX; DB2; DB2 Universal Database; Distributed Relational Database Architecture; NUMA-Q; OS/ 2, OS/ 390, and

OS/ 400; IBM Informix; C-ISAM; Found ation.2000TM; IBM Informix 4GL; IBM Informix DataBlade Module;

Client SDKTM; Cloudscap eTM; Cloud syncTM; IBM Informix Connect; IBM InformixDriver for JDBC; Dynamic

ConnectTM; IBM InformixDynamic Scalable ArchitectureTM (DSA); IBM Informix Dynam ic ServerTM; IBM

Informix Enterprise Gateway Mana ger (Enterp rise Gateway Manager); IBM Informix Extended Parallel

ServerTM; i. Financial ServicesTM; J/ FoundationTM; MaxConnectTM; Object Tran slator TM; Red Brick

Decision ServerTM; IBM Informix SE; IBM Informix SQL; InformiXMLTM; RedBack; SystemBuilderTM; U2TM;

UniData; UniVerse; wintegra te are tradema rks or registered trad emarks of Internat ional Business

Machines Corporation.

Java and all Java-based trademarks and logos are trademarks or registered trademarks of Sun Microsystems,

Inc. in the United States and other count ries.

Windows, Windows NT, and Excel areeither registered trademarks or trademarks ofMicrosoft Corporation in

the United States and/ or other countries.

UNIX is a registered trademark in the United States and other countr ies licensed exclusively through X/ Open

Company Limited.

Other comp any, prod uct, and service names used in this pu blication may be trad emarks or service marks of

others.

Documen tation Team: Bob Berry, Jennifer Leland, Karin Moore, Hanna N elson, Cynthia New ton


3/56

Table of Contents

Table ofContents

In This Guide . . . . . . . . . . . . . . . . . . . . 1

Types of Users . . . . . . . . . . . . . . . . . . . 2

Related Reading . . . . . . . . . . . . . . . . . . . 2

Docu m en tation N otes, Release Notes, Ma ch in e N otes . . . . 3

Upgrading the Database Server . . . . . . . . . . . . . 4

Preparing to Install Informix Products . . . . . . . . . . . 4

Installation Checklist . . . . . . . . . . . . . . . . 6Configuration Checklist . . . . . . . . . . . . . . . 7

Installation Order . . . . . . . . . . . . . . . . . 9

Installing on UNIX and Non-RPM Installed Linux . . . . . . . 10

Preparing to Install for the First Time . . . . . . . . . . 10

Running the UNIX Bundle Installer . . . . . . . . . . 12

Setting Up the Environment . . . . . . . . . . . . . . . 16

Setting Locale- and Platform-Specific Environment Variables . . 16

Using the Demonstration Database Server . . . . . . . . . . 19

Testing the Installation . . . . . . . . . . . . . . . . 19

Configuring Informix Products . . . . . . . . . . . . . . 20

Appendix A Setting Up Specialized Installations

Appendix B Solving Instal lation Problems

Appendix C Using Alternative Installation Programs

Index


4/56


5/56

Installation Guide for IBM Informix Dynamic Server for UNIX and Linux 1

In This Guide

This guid e explains how to install your Informix Dynamic Server and

Informix Dynamic Server with J/ Foun dation on the UNIX and Linu x

operating systems.

This guid e also describes the following procedu res for using the Informix

UNIX Bun dle Installer to install Informix prod ucts:

s Prepare to install Informix produ cts (page 4).

s Install Informix produ cts (page 9).

s Set up the environment (page 15).

s Test the installation (page 18).

s Configure the database server and other Informix produ cts

(page 18).

See Appendix Cfor information on how to:

s Use RPM to install the database server on you r Linu x system

(page C-1).

s Use pkgadd to install the d atabase server on your Siemens UNIXsystem (page C-5).

If your computer requires special installation procedures, follow the instruc-

tions in the installation letter included with the product materials before you

continue with these installation instructions. Also see the machine notes file

(page 3) for ad ditional instru ctions,.

For information on specialized installations, such as silent installation, see

Appen dix A, Setting Up Specialized Installations.

If you encounter d ifficulties dur ing installation, see Appendix B, Solving

Installation Problems.

Linux

UNIX


6/56

2 Installation Guide for IBM Informix Dynamic Server for UNIX and Linux

Types of Users

Types of UsersThis guide is written for database administrators (DBAs) who install Informix

products. This guide assumes that you are familiar with the operating proce-

du res of your comp uter and with your op erating system. For information

about you r op erating system, see your UNIX or Linu x docum entation.

Related Reading

The following pu blications provide add itional information about th e topics

that th is guid e discusses:

s To up grad e from a p revious version or migrate from a d ifferent

database server to Informix Dynam ic Server, see theInformixMigration Guide.

s For a list of pu blications that p rovide an introd uction to database

servers and operating-system platforms, refer to your Getting Started

manual.

s For m ore information on how to configure and manage you r

database server, see theAdministrators Guide for Informix Dynamic

Serverand theInformix Administrators Reference.

s For information on h ow to tu ne your database server, see the Perfor-

mance Guide for Informix Dynamic Server.


7/56


Documentation Notes, Release Notes, Machine Notes

Documentation Notes, Release Notes, Machine Notes

In add ition to printed docum entation, online files supp lement the infor-

mation in this guid e. Examine these files before you install your d atabase

server. They contain vital information about app lication and p erformance

issues.

The following online files appear in the $INFORMIXDIR/release/en_us/0333directory.

Important: The release notes and documentation notes files contain importantinformation for application development. Therefore you must make this information

available to both developers and users. Informix recommends that you attach copies

of these files to each set of documentation. The machine notes files contain infor-

mation primarily of interest to system and database administrators.

You can obtain the same notes and other installation information on the Web

at http:/ / ww w.informix.com/ informix/ resource/ .

Online File Purpose

installU_docnotes_9.30.html The documen tation notes file for your version ofthis guid e describes features that are not covered

in the guide or that were modified since

publication.

release_notes_9.30.html Release notes files describe compatibility issues,feature differences from earlier versions of

Informix prod ucts, and how these differences

might affect current products. Release notes also

contain information about any known problems

and their workaround s.

machine_notes_9.30.txt The machine notes file describes any specialactions that you mu st take to configure and use

Informix prod ucts on your compu ter. Machinenotes are nam ed for the produ ct described.


8/56


Upgrading the Database Server

Upgrading the Database ServerWhen you u pgrad e from Version 7.x or Version 9.2x to Version 9.3 of the

database server, the installation script ov erwrites the old version of the

database server with the new version if you install in the same d irectory.

Important: When you upgrade to a new version of the database server, Informixrecommends that you install the new version in a new location so that you can

cont inue to run the old version as long as necessary.

For instructions on how to upgrade your database server from Version 7.x or

Version 9.2x, see theInformix Migration Guide, Version 9.3.

Preparing to Install Informix ProductsBefore you install Informix produ cts, follow th ese steps:

1. Review the docum entation notes, release notes, and machine notes

(page 3) for imp ortant information and instructions before you

install your da tabase server.

2. Apply op erating-system patches, if applicable.

For p atch information, see the m achine notes file (page 3).

For patch information for your Linux compu ter, see the Informix

Linux Web page at http:/ / ww w.informix.com/ linux.

3. Perform any necessary p re-installation tasks as described in th e

machine notes file (page 3) for your operating system.

Linux


9/56


Preparing to Install Informix Products

4. Locate you r License Serial Num ber (S/ N) and Key and electronic

med ia (or prod uct files).s If you received you r prod uct materials d irectly from Informix,

the License S/ N and Key app ear on the serial num ber card,

included with these materials.

s If you received you r p rodu ct materials from an Electronic

Software Download (ESD) vendor, the vendor provides you with

these values.

If you d o not have the serial num ber card or the proper media,

contact your sup plier or Informix sales representative.

5. Decide whether to configu re role separation.

Role separation p rovides checks and balances to imp rove the secu-

rity of your even t-aud iting p rocedures. Event au d iting tracks

selected activities that u sers perform. With role separation enabled,

mem bers of different UNIX groups m anage and examine theserecords to ensure additional secur ity.

You must follow the instructions in Preparing for Role Separation

on page A-2 before you install the database server.

6. Complete the Installation Checklist an d Configu ration Checklist.


10/56


Installation Checklist

Instal lat ion Checklist

You n eed the following information to respond to prom pts d uring the

installation.

Informix Product Configuration

Operating-System Patches

Check the machine notes file for information on anyrequired patches.

No

Yes, enter pat ch nu mbers:

____________________________________________

____________________________________________

____________________________________________

$INFORMIXDIR

Enter the directory in wh ich to install Informix

products.

____________________________________________

Role Separation (page A-1) No

Yes, enter Ad ministrative Group Nam es:

Secur ity (DBSSO):_____________________________

Auditing (AAO): _____________________________

Standard-user access group:____________________

Informix Products to Install See your p rodu ct media for available prod ucts.

License S/N

The License S/ N consists of three uppercase letters,

followed by a p ound sign (#), followed by one

up percase letter and six digits.

____________________________________________

Key

The Key consists of six letters. ____________________________________________


11/56


Configuration Checklist


You n eed the following information to respond to promp ts du ring the

dem onstration database server configuration.

Informix Bundle Instal ler Configuration

Configure a Demo IDS server

The Informix UNIX Bundle Installer automaticallyconfigures a basic database server that you can use as

a template to custom ize to meet your requirements.

No

Yes, you must a lso install Inform ix Dynam icServer.

Install Informix Server Administrator No

Yes, fill out the Inform ix Server Ad min istratorConfiguration checklist.

Informix Server Administrator Configurati on

Port Number

Specify a p ort num ber for the ISA server betw een

1024 and 65536. For a list of port n um bers cur rently

in use, see the/etc/services file.(This list might not becomplete for your installation.)

____________________________________________

Host Name

Enter the nam e of the computer on wh ich you areinstalling ISA.

____________________________________________

ISA Administrator

Specify the email ad dress of the ISA ad ministrator.

ISA uses this add ress to send p roblem reports.

Informix recomm end s that you create an isa-adminalias for this pur pose.

____________________________________________

HTTP Server Passw ord

Specify a p assword for the user informix whenlogging into ISA. Informix recomm end s that this

password be the same as the password for user

informix.

(For security, do not enter the passw ord here.)

(1 of 2)


12/56



Read-Only Users

Read-only users can monitor the database server but

are not allowed to change the mode of the database

server, add or remove storage, or perform other

administrative tasks. You m ust p rovide user names

and passwords for any read-only users that you add.

No

Yes, enter user names:

____________________________________________

____________________________________________

____________________________________________

Install Server Setup No

Yes, fill out the Server Setup Configur ationchecklist.

Server Setup Configuration

JRE Location

____________________________________________

ISA Servlet Engine Port Number

Specify a p ort num ber for the ISA servlet engine

betw een 1024 and 65536.

This must be a different num ber than th e one you

chose for th e ISA H TTP server.For a list of port n um bers currently in use, see the

/etc/services file. (This list might not be complete foryour installation.)

____________________________________________

Informix Bundle Instal ler Configurati on

(2 of 2)


13/56


Installation Order

Installation Order

The Informix UNIX Bun dle Installer installs prod ucts in the correct order. If

you install prod ucts separately or install add itional prod ucts later, use the

following ord er to install Informix produ cts:

1. Install Dynamic Server.

2. Install Informix Connect.

3. Install the Verity Text DataBlad e and Web DataBlade Mod ules.4. Install Client SDK.

(The Client SDK is not included in the Informix UNIX Bundle

Installer.)

Important: See the installation order chart in the Informix Client Products Instal-lation Guide forUNIX, Linux, and Windows.

5. Install Informix tools.

Many Informix tools bun dle Informix Connect. Do not install an

older Informix Connect from a tool app lication over a new er Infor-

mix Connect. For more information, see your tools documentation.

6. Install other DataBlade mod ules.

Install DataBlade modules in order from the oldest to the newest ver-

sions. For information on how to install DataBlade modules, see theDataBlade m odu le documentation.

If you install more than one Informix prod uct, comp lete all installation

procedu res for one p rodu ct before you start to install the next product. Do

not load the files from another Informix product onto your comp uter u ntil

you comp lete the current installation.
http://../generic/install.pdfhttp://../generic/install.pdf


14/56


Install ing on UNIX and Non-RPM Installed Linux

Installing on UNIX and Non-RPM Installed LinuxTo use the Red Hat Package Manager (RPM) to install the database server on

your Linux system, see To install Informix products on a Linux system using

RPM on page C-1.

To install the database server using the Informix UNIX Bundle Installer

1. If you are installing Informix products for the first time, complete thepreinstallation p rocedure (page 10).

2. Run the UNIX Bun dle Installer (page 11).

Preparing to Install for the First Time

The first time that you install an Informix produ ct, you mu st:

1. Create a new informix group and u ser (page 10).

2. Create the INFORMIXDIR produ ct directory (page 11).

Creating group and user informix

Tip: On HP systems, use thesam tool to create groups and users. On Solarissystems, use theadmintoolto create groups and users. Some systems use the

groupaddutility to create groups and theuseraddutility to create user entries. For

more information, see your operating-system manual.

To create group informix and user informix

1. Log in as u ser root.

2. Create group informix:

a. Create group informix in the group file. On most UNIX an dLinu x systems, this file is /etc/group.

b. Assign an un used group ID equal to or greater than 100.

Linux


15/56


Preparing to Install for the First Time

3. Create user informix:

a. Create a new entry called informix in the /etc/passwd file.

b. Assign an un used u ser ID equa l to or greater than 100 for that

user.

c. Assign th e user to group informix.

d. Create a p assword for user informix.

4. If you use a network, propagate the new user name to all the systems

on the n etwork that m ust recognize user informix. For exam ple, onsome systems, you (or the network ad ministrator) must run the

ypmake utility.

The user informix is the database equ ivalent of the UNIX or Linu x rootaccount, so that anyone logged in as user informix has complete access to anyInformix prod ucts and d atabases. Keep the user informix password

confidential.

Informix products use group informix internally to control database access.Make user informix th e only member of group informix. Any person wh o

belongs to group informix is a database server administrator. If you make anactual user of an Informix product a member of group informix, you canallow unintended and uncontrolled database access. User accounts in group

informix have all the privileges of user informix an d can be u sed to d isru p t

the d atabase server, either intentionally or u nintentiona lly.


16/56


Running the UNIX Bundle Installer

Creating the INFORMIXDIR Product Directory

Tip: To preserve product files of earlier versions, create separate directories for eachversion of your Informix products.

1. Log in as u ser informix.

2. Create a d irectory in w hich to install your Informix produ cts.

This directory can be any d irectory that is local or is an ap proved

NFS-mounted directory. Informix database servers support only cer-

tified versions ofNFS. For information abou t the NFS prod ucts you

can use to NFS mou nt a storage space for an Informix database

server, see the p rodu ct comp atibility information on th e Informix

web site at:

http://www.informix.com/idn-secure/pacc/prodcompat.html

The standard Linu x location for Informix produ cts is

/opt/informix.

3. Set $INFORMIXDIR to the d irectory you created in step 2. For

example:

Bourne shell:

INFORMIXDIR=/work; export INFORMIXDIR

C shell:

setenv INFORMIXDIR /work


Important:A database server must be installed in the same directory as any localclient products that use it.

To run the UNIX Bundle Installer

1. Log in as u ser root.

2. If you are installing from a CD-ROM, insert it into the app ropriate

drive of your compu ter and u se the mount command to mount theCD-ROM. For m ore information, see the mount manual p age.

Linux


17/56



3. Change d irectories to the location of the installation m edia.

For example, if you are installing from CD-ROM and the mount pointis /cdrom, enter:

cd /cdrom

4. If you are configuring role separation, follow the steps in Preparing

for Role Separation on p age A-2.

5. Enter the following installation command :

./ids_installerThe Informix UNIX Bun dle Installer displays a list of produ cts to

install.

6. Enter the (space-separated ) num ber(s) of the prod uct(s) to install.

Important:If you select to configure a DemoIDS Server, you must also select toinstall Informix Dynamic Server. The Informix UNIXBundle Installer automati-

cally configures a basic database server that you can use as a template to customize

to your requirements.

7. At the prom pt, enter the directory in w hich to install produ cts

($INFORMIXDIR) (page 11).


18/56



8. If you enabled role separation by setting the INF_ROLE_SEP

environment variable (p . A-4), the installation script prompts you toeither:

s Press RETURN to continu e the prod uct installation with role

separation enabled.

s Press Q to qu it the installation.

If you d id not set INF_ROLE_SEP, skip to step 9.

To install the product without role separation , unset theINF_ROLE_SEP environm ent variable and restart the installation at

step 5.

To continue installation with role separation:

a. At the promp t, enter the group n ame that you assigned to the

DBSSO accoun t (page 6).

This group becomes the group that owns the

$INFORMIXDIR/dbssodir directory.

b. At the promp t, enter the group n ame that you assigned to the

AAO accoun t (page 6).

This group becomes the group that owns the

$INFORMIXDIR/aaodir directory.

c. At the promp t, enter the name of the group that should be

granted access to the database server (page 6).

Members of this grou p can access the d atabase server. To gran t

access to all user group s, press RETURN.

d. Press RETURN to accept the settings or Q to qu it the installation.

For more information abou t role separ ation, see page A-1.

9. At th e p romp t, enter th e 11-character License S/ N (page 5).

10. At the p romp t, enter the six-letter Key (page 5).

11. Press RETURN to continue th e installation p rocedure. A series of

messages similar to the following ap pear on the screen:

Installing Informix Dynamic Server with J/Foundation


19/56



12 . If you choose to install ISA, you are prom pted for ad ditional infor-

mation. Use the information from the Informix Server Adm inistratorConfiguration section of the Installation Checklist on page 6to

respond to the promp ts.

a. Specify the p ort nu mber for ISA (page 7).

b. Specify the host nam e of the compu ter on which you are

installing ISA (page 7).

c. Specify the em ail add ress of the ad ministrator for ISA (page 7).

d. Specify the HTTP server password (page 7).

e. Specify wh ether to allow read -only users and provid e

usernam es and p asswords for the read-only users (page 8).

f. Specify w hether to install Server Setup. If you d o not install

Server Setup, skip to step i.

g. Specify the complete path (includ ing filenam e) to the Java

runtime executable (JRE) (page 8).

h. Specify the port nu mber for the ISA servlet engine (page 8).

i. Enter Y to start ISA or p ress RETURN to skip this step.

If you choose to configure a Demo IDS, you see messages like the

following:

Configuring Demo Informix Dynamic Server

Disk Initializing Demo Informix Dynamic Server

Demo Informix Dynamic Server is Online

Sample environment configuration can be

found in $INFORMIXDIR/demo/server/profile_settings

Anoth er message follows this message that ind icates that the instal-

lation is complete.

Important:If any error messages appear before the Installation Complete messageappears, seeAppendix B, Solving Installation Problems. Do not use theoninit

command. If you useoninit, you might cause further installation problems.

The installation script changes the owner of the INFORMIXDIR directory to

user informix as well as any subd irectories and files un der th eINFORMIXDIR directory that the user informix mu st access or control.

Tip: To uninstall Informix products installed with the Informix UNIXBundleInstaller or the installation script from a previous release, remove the directory in

which you installed the product files ($INFORMIXDIR).


20/56


Setting Up the Environment

Setting Up the EnvironmentBefore users can use the database server, you must set up their environment.

For each user, set the following environm ent variables:

1. Set INFORMIXDIR to the directory where you installed the Informix

products (see page 11).

2. Set the PATH environment variable to include $INFORMIXDIR/bin asfollows:

s C shell:

setenv PATH${INFORMIXDIR}/bin:${PATH}

s Bourne shell:

PATH=$INFORMIXDIR/bin:$PATH

export PATH

Important: You must setINFORMIXDIR and add$INFORMIXDIR/bin to thePATHfor each user.

Setting Locale- and Platform-Specific EnvironmentVariables

Depen ding on your installation, locale, and operating system , set the

optional environment variables:

s CLIENT_LOCALE specifies a nondefau lt locale.

Set this environm ent var iable only if you w ant to u se a locale other

than the default GLS (Global Langu age Sup port) locale, U.S. English.

The GLS feature allows you to create databases that use the diacritics,collating sequence, and mon etary and time conventions of the lan-

guage that you select. For more information, see theInformix Guide to

GLS Functionality .
http://../gn8392/6225.pdfhttp://../gn8392/6225.pdf


21/56


Setting Locale- and Platform-Specific Environment Variables

s DBLANG specifies the subdirectory of$INFORMIXDIR that contains

the custom ized language-specific message files that Informixprodu cts use.

Set this environm ent va riable only if you d o not wan t to use the

default subdirectory, $INFORMIXDIR/msg/lg_tr/code_set. For moreinformation, see theInformix Guide to GLS Functionality an d th eInfor-

mix Guide to SQL: Reference.

s INFORMIXSERVER specifies the default database server to which an

SQL API client or DB-Access makes an explicit or implicit connection.For more information, see theInformix Guide to SQL: Reference.

s INFORMIXSQLHOSTS specifies the file that contains th e sqlhostsinformation.

s INFORMIXTERM specifies whether DB-Access shou ld u se the infor-

mation in the termcap file or the terminfo directory.

s

TERM enables DB-Access to recognize and commun icate with theterminal that you are u sing.

s TERMCAP (or TERMINFO)

To verify that TERM an d TERMCAP (or TERMINFO) are set correctly,

invoke a text editor such as vi . An unformatted display indicates that

these environm ent variables are not set correctly for your term inal.
http://../gn8392/6225.pdfhttp://../gn8392/6228.pdfhttp://../gn8392/6228.pdfhttp://../gn8392/6228.pdfhttp://../gn8392/6228.pdfhttp://../gn8392/6225.pdf


22/56


Setting Locale- and Platform-Specific Environment Variables

s The shared-library p ath env ironment variable specifies the library

search path and is platform-depend ent.

Set this environment variable to include $INFORMIXDIR/lib and any

ofthe $INFORMIXDIR/lib subdirectories that apply to programs thatyou w ill use.

For example, on Solaris, set th is environmen t var iable as follows:

s Bourne shell:

LD_LIBRARY_PATH=$INFORMIXDIR/lib:$LD_LIBRARY_PATHexport LD_LIBRARY_PATH

s C shell:

setenv LD_LIBRARY_PATH${INFORMIXDIR}/lib:

\${LD_LIBRARY_PATH}

For more information, see the following table.

Platform Environment Variable

AIX LIBPATH

HP-UX SHLIB_PATH

Solaris and most other platforms LD_LIBRARY_PATH

Description Documents and Files

INFORMIX environment variables Informix Guide to SQL: Reference

How to create or modify a /etc/termcap file $INFORMIXDIR/etc/termcap

Information about the /etc/termcap file Archive and Backup Guide forInformix Dy namic Server

CLIENT_LOCALE an d DBLANGenvironment variables

Informix Guide to GLS Functionality

List ofcomputers that provide fullsupport for

the UNIX System V terminfo libraryMachine notes file (see page 3)
http://../gn8392/6228.pdfhttp://./6205.pdfhttp://../gn8392/6225.pdfhttp://../gn8392/6225.pdfhttp://./6205.pdfhttp://../gn8392/6228.pdf


23/56


Using the Demonstration Database Server

Using the Demonstration Database ServerIf you chose to configu re a Dem o Dynamic Server, the installation script

au tomatically configures and initializes a samp le da tabase server named

demo_on and sets the ONCONFIG environm ent variable to a sampleONCONFIG file, $INFORMIXDIR/etc/onconfig.demo.

When the installation script initializes the dem onstration d atabase server,

three databases, sysmaster, syscdr, and sysutils, are built autom atically.However, because it takes several minu tes to build these databases, the

system is not completely initialized until messages like the following appear

in the m essage log ($INFORMIXDIR/demo/server/online.log):

09:28:59 sysmaster database built successfully.

09:29:00 sysutils database built successfully.

09:29:00 syscdr database built successfully.

The installation script creates add itional configuration and log files to

support the demo_on database server in $INFORMIXDIR/demo/server. Forinformation on th e configu ration settings for demo_on, see the$INFORMIXDIR/demo/server/profile_settings file .

Testing the InstallationTo test that the installation succeeded , run the following comm and s:

$ dbaccessdemo

$ dbaccess stores_demo

If the installation was successful, the dbaccessdemo script interacts with the

database server to create and pop ulate the stores_demo da tabase. Thedbaccess program enables you to access databases (stores_demo in this case)using SQL.


24/56


Configuring Informix Products

Configuring Informix ProductsAfter you install the Informix produ cts, you m ust configure the d atabase

server and other products. For most post-installation configuration tasks, see

th eAdministrators Guide for Informix Dynamic Server. In ad d ition, you can

perform the following configuration:

1. If you installed Informix Server Ad ministrator (ISA), you can u se it

now to configu re the database server.

If you d id not start ISA du ring installation, start it now:

a. Log in as informix or root and enter the following command tostart ISA:

$INFORMIXDIR/ISA/sbin/isactl start

b. Start your web browser and open:

http://:port_number/

c. Log in with the username and p assword you provided d uring

installation.

See the Informix Server Ad ministrator Configu ration section of

th e Installation Checklist on page 6.

For more information, see the ISA online help.

2. ISM is automatically installed with the database server, however you

mu st configu re it before it can w ork.

For more information, see theInformix Storage Manager Administra-

tors Guide. For information on how to configure ON -Bar and ontape,see theInformix Backup and Restore Guide.

3. You can ask your system administrator to modify the sample system

startup script located in $INFORMIXDIR/etc/ids-example.rc (see the

section on preparing UNIX startup and shutd own scripts in theAdministrators Guide) so that your database server starts wh enever

the compu ter is rebooted (for example, after a pow er failure).

The startup script should set the INFORMIXDIR, PATH, ONCONFIG,

an d INFORMIXSERVER environment variables and then execute

oninit. Similarly, you can ask the system administrator to modify theshutdown script so that the database server shuts down in a graceful

manner.


25/56


26/56

A-2 Installation Guide for IBM Informix Dynamic Server for UNIX and Linux

Preparing for Role Separation

The following table lists the two roles that you m ust set u p.

Important: You must decide at installation time whether you want to activate roleseparation for the databaseserver. You cannot disable roleseparation after you enable

it. Theonly way to turn off roleseparation is to uninstall thedatabaseserver and thenreinstall it without role separation activated.

For detailed information on role separation, see the Trusted Facility Manual.

Preparing for Role Separat ion

To prepare for role separa tion, you m ust p erform the following steps beforeyou install the database server:

1. Set up separate adm inistrative groups and accounts (page A-3).

2. Set up standard user accounts (page A-3).

3. Enable role separa tion (page A-4).

Role Category Role Definition

Database System

Security Officer (DBSSO)

The DBSSO oversees the security concerns of the

database server.

Functions of this role include aud it adjustm ent and

changing security characteristics of storage objects.

Aud iting AnalysisOfficer (AAO)

The AAO maintains and analyzes audits of the recordsof specific types of data base activities.

If someone attemp ts to circumvent or corrupt the

security m echanism of the d atabase, these actions can

be traced.
http://./6214.pdfhttp://./6214.pdf


27/56

Setting Up Specialized Installations A-3

Preparing for Role Separation

Creating the Administrative Groups and Accounts

To enable role separation, you m ust:

1. Create the special administrative (DBSSO an d AAO) group s.

Assign u nique nam es to the DBSSO an d AAO group s, for example,

ixdbsso an d ixaao.

2. Create two users, the Database System Security Officer (DBSSO)and

the Au diting An alysis Officer (AAO).Do not use informix or root for the DBSSO an d AAO account names.

For aud it purp oses, Informix recommend s that you establish one

accoun t for each ind ividual w ho acts as a DBSSO or AAO. For exam-

ple, DBSSO1 an d DBSSO2 might be the account names for the DBSSO

role and d ickAAO and janeAAO might be the account nam es for the

AAO role. In ad dition, all stand ard u sers should have separate

account names.

3. Add the DBSSO user to the ixdbsso group and the AAO user to theixaao group.

For information on h ow to create groups and u ser accoun ts, see Creating

group and u ser informix on page 10 or your op erating-system

documentation.

Setting Up a Group for Standard-User Access to the Database Server

By default, all user grou ps can access the database server. To access the

da tabase server, stand ard u sers must belong to one of the user group s.

To restrict stand ard-user access to the d atabase, create a special group. If

you specify that group during the role-separation portion of database server

installation, only members of that special group can access the database

server.


28/56


Performing a Silent Installation

Enabling Role Separation

After you set up the role-separation accoun ts, set the role-separation

environmen t variable to implement role separation:

s Bourne shell:

INF_ROLE_SEP=1;export INF_ROLE_SEP

s C shell:

setenv INF_ROLE_SEP 1

After you set this environment variable, you are ready to install the database

server with role separation.

Performing a Silent Installation

A silent installation requires no user interaction with the installation program

once you start the ids_installer script.

Important: You cannot perform a silent installation withRPM orpkgadd.

To perform a silent installation

1. Follow th e steps in Preparing to Install Informix Produ cts on

p age 4 an d Installing on UNIX and Non -RPM Installed Linu x on

page 10.

2. Follow steps 1 through 3 on Running the UNIXBund le Installer on

page 12.

Installation Method Description Operating System

Informix Bundle

InstallerInstalling on UNIX and Non -RPM

Installed Linux on page 10.

UNIX

RPM To install Informix prod ucts on a Linu x

system using RPM on page C-1.

Linux

pkgadd Installing on Siemens UN IX Using

pkgadd on page C-5.

UNIX


29/56


Setting Up a Private Installation

3. Verify th at INFORMIXDIR is set correctly (see page 12).

4. Run the ids_installer script:

ids_installer serial_number key product_code(s) options

where:

s serial_numberis the 11-character License S/ N (page 5).

s key is the six-letter Key (p age 5).

s product_code is the short name associated with each product and

options are any options associated with a part icularproduct_code.

For information, enter:

ids_installer -help.

For example, to install Informix Dynamic Server with role separation and to

install ISA and set up a demonstration database server, enter a command such

as the following:

ids_installer serial_number KEYIDS ixaao ixdbsso ixuser IDSDEMO \ISA 1025 my_computer isa_admin my_password -y

Setting Up a Private Installation

Important: You cannot perform a private installation with RPMorpkgadd.

Aprivate installation copies or links files from your conventional installation

of the database server to a d irectory of your choice. The installation script

creates the necessary files and d irectory structure that you need to ru n the

database server in pr ivate database server mode. You do not need to be user

root or informix to create or use a private installation. After you create theprivate installation, you own the critical resources and services such as th e

sysmaster database.

A private installation is useful because it allows a programmer who develops

DataBlade modules and user-defined routines to attach a debugger and test

code extensions to the database server without affecting the performance of

the da tabase server or the work of other users.

A private installation also allows a d eveloper to create new fun ctions,

dynam ically link them with the database server, execute them , and d ebug

them withou t violating security.


30/56


Private Installation Restrictions

Private Instal lat ion RestrictionsA private installation places the following restrictions on the database server:

s You m ust be the ow ner or belong to the group that is the own er of

any chu nks you access. A chun k is the largest un it of ph ysical disk

ded icated to database server data storage.

For more information on chun ks, see theAdministrators Guide for

Informix Dynamic Server.s The database server does not have the privileges ofu ser root or user

informix.

s The database server does not support DBA tools, such as dbschema,dbimport, and dbexport.

s Other u sers cannot connect to a private installation of the database

server.

Creating a Private Instal lat ion

A p rivate installation does not affect a conventional installation of the

da tabase server. However, you m ust have already installed the d atabase

server on you r system before you perform a p rivate installation. For more

information, see Installing Informix Products.

To create a private installation

1. Log in w ith the user ID that you intend to use for the private work.

2. Create a target directory where you w ant to install the pr ivate

installation files. The directory can have any nam e and location

that you choose.

3. Check that you have read and wr ite perm issions for the target

directory.
http://./6202.pdf


31/56


Overriding Default Limits

4. Check that the shared-library pa th environm ent variable includ es

$INFORMIXDIR/lib.

The name of this environment variable is platform-depend ent. See

the table on page 18.

5. Change d irectories to $INFORMIXDIR.

6. Enter the following comm and :

./installserver [-c | -l] target_directory

Enter -c to copy all files or -l to link files wherever possible.7. After the installation is comp lete, configure the database server as

you w ould a conventional installation.

For more information, see Configu ring Informix Produ cts on

page 20 and theAdministrators Guide for Informix Dynamic Server.

Overriding Default LimitsWhen you run a conventional installation of the database server, oninit runsas user root and group informix. This arrangement p ermits the database

server to override some d efault limits such as file-descriptor limits and

memory limits. If you run a private database server installation, oninit runs

as the user who invokes it and cannot overr ide these limits itself. You might

need to request that your system administrator increase these limits on your

behalf.


32/56


Setting Up Multiple Residency

Setting Up Multiple Residency

Multiple residency refers to mu ltiple database servers and their associated

shared m emory an d d isk structures coexisting on a single comp uter.

Creating mu ltiple independ ent d atabase server environments on the same

comp uter allows you to:

s Separate produ ction an d development environments

You can separate production and development environments to pro-

tect the prod uction system from the un pred ictable nature of the

development environment.

s Isolate sensitive d atabases

You can isolate app lications or da tabases that are critically impor-

tant, either to increase security or to accomm odate m ore frequent

backup s than most d atabases require.

When you use m ultiple residency, each d atabase server has its own

configuration file. Thus, you can create a configuration file for each

da tabase server that m eets its special requirements for backups,

shared-memory use, and tuning p riorities.

s Test distributed da ta transactions on a single comp uter

If you are d eveloping an ap plication for use on a network , you canuse local loopback to perform your distributed-data simulation and

testing on a single comp uter. (See the section on using a local loop-

back connection in theAdministrators Guide for Informix Dynamic

Server.) Later, when a netw ork is ready, you can use the ap plication

withou t changes to app lication source code.

Planning for Multiple ResidencyRunning mu ltiple database servers on the same computer is not as efficient

as run ning one database server. You n eed to balance the ad vantages of

separate d atabase servers against the extra performance cost.


33/56


Creating a New Database Server

When you plan for multiple residency on a computer, consider the following

factors:

s Memory

Each d atabase server has its own m emory. Can your comp uter

hand le the memory usage that an add itional database server

requires?

s Storage space

Each d atabase server mu st have its own un ique storage space. Youcannot use the same d isk space for more than one instance of a

database server. When you prep are an add itional database server,

you must repeat some of the planning that you did to install the first

database server. For examp le, consider th ese questions:

Will you use buffered or u nbu ffered files? Will the u nbu ffered

files share a d isk partition with an other ap plication? (For more

information on buffered and unbuffered files, see the section ondirect disk access in theAdministrators Guide.)

Will you u se mirroring? Where w ill the m irrors reside?

Where w ill the message log reside?

Can you ded icate a tape d rive to this da tabase server for its

logical logs?

What kind of backup s will you perform?

Creat ing a New Database Server

Before you set up multiple residency, you must install one database server as

described in Installing Informix Products.

Important: You do not need to install more than one copy of the database server

binary files. All instances of the same version of thedatabaseserver on one computercan share the same executable files.


34/56



To create multiple residency of a database server

1. Prepare a new ONCONFIG configuration file and set the ONCONFIG

environment variable to the new filenam e (page A-10).

2. If needed, set up connectivity for the new d atabase server instance

(page A-12).

3. Initialize disk space for the n ew d atabase server instance

(page A-12).

4. Prepare the backup environment for multiple residency (page A-12).

5. Modify the operating-system startup to start the new database server

instances autom atically (page A-13).

6. Check the INFORMIXSERVER environmen t variables for users

(page A-14).

For more information, see theAdministrators Guide for Informix Dynamic

Server.

Set ting Up the ONCONFIG File

Each instance of the database server mu st have its own ONCONFIG configu-

rat ion file.Make a copy ofan ONCONFIG file that has the basic characteristics

that you w ant for your new database server. Give the new file a nam e that

you can easily associate with its function. For example, you might select the

filename onconfig.acct to indicate the configuration file for a p rodu ctionsystem that contains accounting information.

Set the ONCONFIG environment variable to the filename of the new

ONCONFIG file. Specify only th e filename, not the comp lete path.


35/56



In the new configuration file, change the following configuration parameters:

s SERVERNUM

The SERVERNUM parameter specifies an integer (between 0 and 255)

associated w ith a d atabase server configuration. Each instance of a

database server on the same host comp uter mu st have a un ique

SERVERNUM value. For more information, see the section on

SERVERNUM in theAdministrators Reference.

s

DBSERVERNAMEThe DBSERVERNAME parameter specifies the dbservernam e of a

database server. Informix suggests that you choose a nam e that

provides information about the database server, such as ondev37 or

hostnamedev37. For m ore information, see the section on DBSERV-ERNAME in theAdministrators Reference.

s MSGPATH

The MSGPATH parameter specifies the pathname of the message filefor a database server. You should specify a unique pathname for the

message file because d atabase server messages do not includ e the

dbservername. If multiple database servers use the same MSGPATH,

you cann ot identify the messages from separate d atabase server

instances. For examp le, if you nam e the d atabase server ondev37,

you m ight specify /usr/informix/dev37.log as the m essage log forthis instance of the d atabase server.

s ROOTPATH an d ROOTOFFSET

The ROOTPATH an d ROOTOFFSET parameters together specify the

location of the root d bspace for a d atabase server. The root d bspace

location mu st be unique for every database server configu ration.

If you p ut several root dbsp aces in the same p artition, you can use

the same value for ROOTPATH. However, in that case, you m ust set

ROOTOFFSET so that the combined values ofROOTSIZE an d

ROOTOFFSET defin e a uniqu e portion of the partition. For more

information about ROOTPATH an d ROOTOFFSET, refer to the chapter

on configuration p arameters in theAdministrators Reference.

Tip: You donot need to changeROOTNAME. Even if both databaseservers have thenamerootdbs for their root dbspace, the dbspaces are unique becauseROOTPATH

specifies a unique location.


36/56



You might also need to set the MIRRORPATH an d MIRROROFFSET parameters.

If the root dbspace is mirrored, the location of the root dbspace mirror mustbe un ique. For information abou t setting MIRRORPATH, see theAdminis-

trators Guide.

Sett ing Up Connectivity Information

If you u se the TCP/IP comm unication p rotocol, you m ight need to add an

entry to the services file for the new database server instance. If you use theIPX/SPX communication protocol, you might need to modify the connection

information for the NetWare server.

The sqlhosts file must have an entry for each database server. If Informix

prod ucts on other comp uters access this instance of the d atabase server, the

adm inistrators on those comp uters mu st upd ate their sqlhosts files.

If you plan to use TCP/IP network connections with an instance of a database

server, the system netw ork adm inistrator mu st up date the hosts an dservices files. If you u se an IPX/SPX netw ork, the NetWare adm inistrator

mu st upda te the NetWare file-server information.

For information about these files, see the chapter on client/ server communi-

cations in theAdministrators Guide.

Initializing Disk Space

Before you initialize d isk space, check the setting of your ONCONFIG

environmen t variable. If you h ave not set it correctly, you might overwrite

da ta from another d atabase server. When you initialize disk space for a

database server, the database server initializes the disk space specified in the

current ONCONFIG configuration file.

Warning:As you create new blobspaces or dbspaces for a database server, be sure toassign each chunk to a unique location on the device. The database server does notallow you to assign more than one chunk to thesame location within asingledatabase

server environment, but it remains your responsibility as administrator to make sure

chunks that belong to different database servers do not overwrite each other.


37/56



Preparing the Backup Environment for M ultiple Residency

Depending on your backup m ethod, you mu st prepare the backup

environment for multiple residency.

Preparing for ON-Bar backups

ON -Bar allows you to back up data from various database server instances to

a single storage device if the storage manager allows it. The storage manager

keeps track of wh at d ata has been backed u p. H owever, Informix recom-

mends tha t you keep storage-space and logical-log backup s on separate

storage d evices.

Preparing for ontape backups

When you use multiple residency, you must maintain separate storage-space

and logical-log backup s for each d atabase server instance.

If you can d edicate a tape d rive to each d atabase server, use the continu ous-

logging op tion to back up your logical-log files. Otherw ise, you m ust p lan

your storage-space and logical-log backup schedules carefully so that use of

a device for one da tabase server instance does not cause the other database

server instance to w ait. You mu st reset the ONCONFIG configuration

parameter each time you switch backup operations from one database server

instance to the oth er.

Modifying Operating-System Startup for Multiple Server Instances

You can ask your system administrator to modify the system startup script so

that each of your d atabase server instances starts whenever the comp uter is

rebooted, for example, after a power failure (see page 20). For more infor-

mation abou t startup scripts, see the section on prepar ing UNIX startup and

shutd own scripts in theAdministrators Guide.

To start a second instance of a da tabase server, change the ONCONFIG an d

INFORMIXSERVER environmen t variables to point to the configura tion file

for the second da tabase server and then execute oninit. Do not change

INFORMIXDIR or PATH.


38/56



Similarly, you can ask the system administrator to mod ify the shu tdow n

script so th at all instances of a database server shu t dow n in a gracefulmanner.

Setting the INFORMIXSERVER Environment Variable

If a new instance of a d atabase shou ld be the d efault database server, users

mu st reset the INFORMIXSERVER environment variable. Users might also

need to up date their .informix files.

If you use the informix.rc file to set environment variables for the users, you

might need to update that file. TheInformix Guide to SQL: Reference describes

the informix.rc an d .informix files.


39/56

BAppendix

Solving InstallationProblems

If you received you r prod uct materials directly from Informix,

this appendix describes the most common installation problems

you m ight encounter and the correspon ding solutions. This

appendix covers:

s Solving UN IX Bun dle Installer Failures

s Solving installserver Script Failuress Solving Problems After Installation

s Solving Problems Using Informix Products

If you experience p roblems with RPM , see Solving RPM

Failures on page C-3.

If any of the outlined p roblems persist, contact Informix

Technical Sup port. In North America, call toll-free (800) 274-8184or send a facsimile to (913) 599-8590. Outsid e Nor th Am erica,

contact your d istributor or the nearest Informix subsidiary.

Important:Ifyou receiveyour Informix product materials from anESDvendor, consult the vendor documentation for information on how to

solve any problems you might encounter.

Linux


40/56

B-2 Installation Guide for IBM Informix Dynamic Server for UNIX and Linux

Solving install server Script Failures

Solving UNIX Bundle Instal ler Failures

The following p roblems m ight occur wh en you ru n the ids_installer script.

s Problem. When you attempt an installation, the following messageappears:

Please rerun this installation procedure as root.

Solution. Make sure that you are logged in as user root.s Problem. After you enter the License S/ N an d KEY, the following

message ap pears as d ifferent d irectories are installed:

Invalid serial number and/or key.

Solution. Make sure you enter the correct License S/ N value and Key.

Important:If you continue to have problems running the ids_installer script inyour environment, try running the individual installation scripts provided with

your Informix product. For example, to install Dynamic Server, run the

$INFORMIXDIR/installserver script.

Solving installserver Script Failures

The following p roblems m ight occur wh en you ru n the installserver script,for examp le, to set up a p rivate installation (page A-5).

s Problem. When you attempt an installation, the following messageappears:

Please rerun this installation procedure as

the informix user.

Solution. Check that you are logged in as user informix.

s Problem. When you attemp t an installation, the following m essageappears:

INFORMIXDIR is not set.

Solution. Set the INFORMIXDIR environment variable to the direc-tory where the product will be installed. The installation script does

not set the INFORMIXDIR environment variable for you.


41/56

Solving Installation Problems B-3

Solving installserver Script Failures

s Problem. When you attempt an installation, the following message

appears:INFORMIXDIR and working directory do not match.

INFORMIXDIR = pathname_x

Current working directory = pathname_y

Solution. Make sure that you are in $INFORMIXDIR, the directoryinto which you want to install the produ cts wh en you invoke the

installation script.

s

Problem. After you enter the LicenseS/ N

, the following m essageapp ears as different d irectories are installed:

"WARNING: This is an invalid serial number.

Exiting install script."

Solution. Make su re you enter the correct License S/ N value.

s Problem. After you enter the License S/ N or Key, one of the followingmessages app ears as different directories are installed:

"WARNING: This is an invalid serial number.

Exiting install script."

etc/brand: invalid serial number and/or key.

** Verify serial number and key values. **

** Restart installation procedure. **

** Please type carefully. *

Solution. Make sure that you enter the correct License S/ N and Keyvalues.

If the error app ears again, run the stty command:stty erase CTRL-h

Tip: CTRL-h looks like ^H on the screen.

Then, rerun the installation script (see page 12) and repeat all subse-

quent steps.

If the installation fails again, reload the p roduct files (see Running

the UNIX Bun dle Installer on page 12) and repeat all subsequent

steps.


42/56


Solving Problems After Installation

s Problem. After you en ter the Key, the following message appears as

different directories are installed:

Unknown message number 32766.

Solution. Set the INFORMIXDIR environment variable before you runthe installation script. Rerun the installation script (see page 12)and

repeat all subsequ ent steps.

s Problem. When you run the ./installserver or the ./installids script,the following message app ears:

chown filename: Not owner.

Solution. Remove $INFORMIXDIR and all its files. Then follow theprocedures in Preparing to Install for the First Time on page 10 an d

perform all subsequ ent steps.

Solving Problems After InstallationThe problems in this section relate to difficulties accessing Informix products

after installation.

s Problem. You try to run an Informix product program from thecomman d line (or alternative method ), and you receive only a

system p romp t or the following (or a similar) message:

program: Command not found.

Solution. Verify tha t the environment var iables are set p roperly(see Setting Up the Environment on page 16).

If the environmen t var iables are set correctly, check if another file

with the same nam e exists in your search path that w ould be

accessed before the Informix executable file. Move, rename, or delete

that file, or reorder the search path so tha t the path in wh ich the

Informix executable resides p recedes the path in which the conflict-ing executable resides.


43/56

Solving Installation Problems B-5

Solving Problems After Installation

s Problem. You try to invoke an Informix produ ct from the command

line (or alternative method), but you get the following (or a similar)message:

Unknown message number 32766

Solution. Verify that th e INFORMIXDIR environment variable is setcorrectly. If you changed the default settings for the DBLANG an d

CLIENT_LOCALE environment variables, change them back to the

default, and try to invoke the Informix product again (see Setting

Up the Environment on page 16).s Problem. You try to call an Informix product from the command line

(or through an alternative method ), but you get the following (or a

similar) m essage:

Invalid serial number or mistyped key. Please consult your

installation instructions.

Solution. Place $INFORMIXDIR/bin first in the PATH environmentvariable, rerun the installation script (see page 12), and repeat all

subsequent steps.

s Problem. You try to send a command to an Informix product from thecomman d line (or through an alternative method ), but you receive

the following (or a similar) message:

cannot attach to shared memory

Solution. Before you use the database server, bring it to online mode.See the chap ter on managing da tabase server modes in the

Administrators Guide.


44/56


Solving Problems Using Informix Products

Solving Problems Using Informix Products

The problems in this section relate to prod uct usage.

s Problem. The list of databases is incomplete.

Solution. Check that the DBPATH environment variable contains thenam es of all other d atabase servers not referenced by th e

INFORMIXSERVER environment variable.s Problem. After you access an Informix application, the screen display

is unformatted.

Solution. Verify that th e TERM, TERMCAP (or TERMINFO), andINFORMIXTERM environmen t variables are set correctly (see Set-

ting Up the Environm ent on page 16).

s Problem. You su ccessfully install your Informix prod ucts and you

successfully invoke the da tabase server, but you cannot connect tothe d atabase server.

Solution. Check that your environment variables and your sqlhosts,/etc/hosts,and /etc/services files do not contain typographical errors,

misspellings, or inconsistencies.

If you use a network information system, check that the changes you

make to the services file are properly accessed and available to your

computer.Check that the d atabase server is configured correctly. See the chap -

ter on client/ server connectivity in theAdministrators Guide.

s Problem. Unu sual problems occur (for example, networkingproblems on H ewlett-Packard comp uters or u nexplainable failures

on Sun computers).

Solution. Your system m ight need a p atch. Read the machine notes

file for advice on patch information. For more information, see Doc-um entation N otes, Release Notes, Machine N otes on page 3.


45/56

CAppendix

Using AlternativeInstallation Programs

This appendix describes how to use a lternative installation

programs to install Informix products on your system:

s Install on Linux using the RedHat Package Manager

(RPM) (page C-1).

s Install on UNIX (Siemens) using pkgadd (page C-5).

To install the database server u sing the Informix UNIX Bundle

Installer (ids_installer), see Installing on UNIX and Non-RPM

Installed Linux on page 10.

If you encounter difficulties du ring installation, see Appendix B,

Solving Installation Problems.

To instal l Informix products on a Linux system using RPM

1. Follow th e relevant steps in Preparing to Install

Informix Products on page 4 and fill out the Instal-

lation Checklist on page 6.

2. Uninstall any previous versions of the database server, if

necessary.

Important:RPM requires that you uninstall the old version of the

database server before you install the new version.

See Uninstalling a Package Using RPM on page C-2.

3. If you are configuring role separation,follow the steps in

Preparing for Role Separa tion on page A-2.

4. Log in as root.

Linux

UNIX

Linux


46/56

C-2 Installation Guide for IBM Informix Dynamic Server for UNIX and Linux

5. Verify that the RPM package is installed on your system and install it ,

if necessary. For more inform ation, see the rpm manu al pages.

To obtain a copy ofRPM , see the RPM Website a t

http:/ / www.rpm.org.

6. Insert the media into the appropriate drive ofyour computer and use

th e mount comm and to moun t the d rive that contains the Informix

package files. For m ore information, see the mount manual page.

7. Change directories to the location of the Informix package files.

8. Load the contents of the Informix package file. For examp le:

INFORMIXDIR=/opt/informix/LE; export INFORMIXDIR

rpm -iv --relocate /opt/informix $INFORMIXDIR *.rpm

This example loads all Informix packages located in the curren t

directory to the directory that $INFORMIXDIR (/opt/informix/LE)

specifies.

9. Enter the 11-character License S/ N (p age 5).

10. Enter th e six-letter Key (p age 5).

After you en ter the installation comman d or fin ish role-separation configu -

rat ion, the script displays information about the product as well as the script

requirements.

When you finish the installation, follow these steps to comp lete Informix

produ ct configuration:

11. Set up the environment (page 16).

12. Test the installation (page 19).

13. Configure the database server and other Informix products

(page 20).


47/56

Using Al ternative Installation Programs C-3

Uninstalling a Package Using RPM

Uninstalling a Package Using RPM

Important: You must uninstall the old version of the database server before youinstall the new version withRPM.

To uninstal l a package using RPM

1. Log in as root.

2. Use rpm -qi to determine the nam e, version, and release of the

package.

3. Use rpm -e to remove the product files and directories, as well as the

correspond ing entry in th e RPM database.

Do not u se the longer nam e of the package file.

For example, the following command s query the RPM da tabase for

Dynam ic Server and un install the da tabase server:

$ rpm -qi ids

Version : 9.20.UC5

Release : 1

. . .

$ rpm -ev ids-9.20.UC5-1

For more information, see http:/ / ww w.rpm .org or the rpm manu al pages.

Solving RPM Failures

The following problems might occur while you use the rpm utility to load orunload an Informix package:

s Problem. The command displays one of the following messages:

ERROR: You must be root to install product.

ERROR: You must be root to uninstall product.

Solution. Check that you are logged in as user root.

s Problem. The command displays the following message:

ERROR: Failed to locate directory with write permissions.

Solution. Check that you are logged in as user root. Use the chmodcomman d to grant w rite perm ission on the curren t directory and

then run rpm again.

Linux


48/56



s Problem. The command displays one of the following messages:

ERROR: User informix must exist to install product.

ERROR: Group informix must exist to install product.

Solution. Follow the instructions in Preparing to Install for the FirstTime on page 10 to create the necessary user or group .


package product is already installed

ERROR: product.rpm cannot be installed

Solution. If you w ant to reinstall the p rodu ct, un install the previouspackage, as described in Uninstalling a Package Using RPM on

page C-2.


rpm: arguments to --relocate must begin with a /

Solution. If you relocate the package installation d irectory by select-ing a target directory other than the default, you must sp ecify an

absolute pathname for the ta rget directory. For examp le:

rpm -iv --relocate /opt/informix=$INFORMIXDIR *.rpm


49/56

Using Al ternative Installation Programs C-5


Installing on Siemens UNIX Using pkgaddSiemens p latforms requ ire you to use the pkgadd utility.

To install Informix products on Siemens platf orms only using the pkgadd uti li ty

1. Follow the relevant steps in Preparing to Install Informix Products

on page 4and fill out the Installation Checklist on page 6.

2. Uninstall any previous versions of the d atabase server, if necessary.

Important: Thepkgaddutility requires that you uninstall the old version of thedatabase server before you install the new version.

For more information, see your operating-system manu al.

3. Verify that your /tmp directory has enough room to accommod atethe produ cts.

4. If you are configuring role separation, follow the steps in Preparingfor Role Separa tion on page A-2.

5. Log in as root.

6. Load the m edia supp lied w ith you r software into the app ropriate

drive of your comp uter. Enter one of the following comm and s:

s To load from a tape device, enter :

pkgadd -d tape_devicewhere tape_device is the name of your tap e device.

s To load from a CD-ROM, enter:

mount -F hs -o dos device_file mount_directory

pkgadd -d mount_directory/prodimag

where device_file is the name of the CD-ROM an d mount_directory

is the location w here you m ounted the CD-ROM.

7. Enter the 11-character License S/ N (page 5).

8. Enter the six-letter Key (p age 5).

9. If prompted, enter the absolute pathname ofthe directory where you

wan t to install the prod ucts ($INFORMIXDIR). (On some p latforms

the script p romp ts you for this directory.)

10. At the p romp t, choose the role separation op tion. For more infor-

mation, see Setting Up Role Separa tion on page A-1.


50/56



When you finish the installation, follow these steps to comp lete Informix

produ ct configuration:

11. Set up the environment (page 16).

12. Test the installation (page 19)

13. Configure the database server and other Informix products

(page 20).

@O QCA B D E F G H I J K L M N P R S T U V W X Y Z


51/56

@

Index

O QCA B D E F G H I J K L M N P R S T U V W X Y Z

Index

AAAO group, creating A-3

AAO user account

creating A-3

description of A-2

setting the group name 14

Accounts. See User accounts.Activation key. See Key.

Administrative

groups, creating A-3

roles, for role separation A-3

admintool utility 10

ALL prod uct code, silent

installation A-5

Allowing read-only users 15

Archive, preparing for mu ltiple

residency A-13

Aud iting Analysis Officer. See AAO

user account.

Auditing. See Role separation.

BBackups, prep aring for m ultiple

residency A-13

Blobspaces, and multiple

residency A-12

Bundle Installer 12

CCannot attach to shared mem ory

error message B-5

Checklist. See Installation Checklist.

Chunks, and mu ltiple

residency A-12

Clientapplications, testing A-8

products, local 12

Client SDK, installing. See the

"Client Products Installation

Guide."

CLIENT_LOCALE env ironm ent

variable

problems B-5

set ting 16

Configuration file, mu ltiple

residency A-10

Configuring

database server 20

demonstration database server 13

Informix products 20

ISA 15

multiple residency A-8

private installations A-5

read-only users 8role separation A-1

silent installation A-4

Connectivity, configur ing for


Creating

AAO group A-3

AAO user account A-3

administrative accounts A-3

administrative groups A-3DBSSO group A-3

O QCA B D E F G H I J K L M N P R S T U V W X Y Z @


52/56



DBSSO user account A-3

informix group 10informix user account 10

INFORMIXDIR directory 12

multiple database servers A-8,

A-10

private installation A-6

D

Database serverassigning group access 14

configuring 20

See also the "A dmin istrators

Guide."

creating mu ltiple A-8, A-10

environments, separating A-8

installation order 9

installing

local client products 12on Linux 1

on UN IX 1

with role separation A-4

introduction to. See the "Getting

Started" manual.

migrating. See the "Migration

Guide."

preparing to install 4


running multiple A-8

tuning. See the "Performance

Guide."

u p gr ad in g 4

See the "M igration Guide."

Database System Security Officer.

See DBSSO u ser accoun t.

Datablade modules, installing. See

Datablade module

documentation.

dbaccessdemo script 19

DBLANG en vironment variable

problems B-5

set ting 17

DBPATH en vironment

variable B-6

DBSERVERNAME parameter

multiple residency A-11See also the "Administrators

Reference."

Dbspaces, mu ltiple residency A-12

DBSSO group, creating A-3

DBSSO user account

creating A-3

description of A-2

setting the group name 14

Default

installation directory, Linux 12

language message files 17

Demonstration database server,

configuring 13

Difficulties

accessing p roducts B-4

using products B-6

Disabling role separation A-2

Disk space, for mu ltiple

residency A-12

Documentation notes 3

Documentation, types of

documentation notes 3

machine notes 3

online files 3

related reading 2

release notes 3

EEnabling role separation A-4

Environment variables

CLIENT_LOCALE 16, B-5

DBLANG 17, B-5

DBPATH B-6

INFORMIXDIR 12, 16, 20, B-5

INFORMIXSERVER 17, 20, A-14,

B-6

INFORMIXSQLHO STS 17

INFORMIXTERM 17, B-6

INF_ROLE_SEP 14, A-4

LD_LIBRARY_PATH 18

LIBPATH 18

local-specific 16

ONCONFIG 20

ONCON FIG, mu ltiple

residency A-10

PATH 16, 20, B-5

platform-specific 16set ting 16

shared-library path 18

SHLIB_PATH 18

TERM 17, B-6

TERMCAP 17, B-6

TERMINFO 17, B-6

/ etc/ group file, modifying 10

/ etc/ hosts file


problems B-6

/ etc/ passwd file, modifying 11

/ etc/ services file


por t number 7, 8

problems B-6

/ etc/ terminfo directory 17

/ etc/ termcap file 17

Event auditing. See Role separation.

Examp le silent installation A-5

GGroup informix, creating 10

groupadd util ity 10

Groups

AAO A-3

creating

administrative A-3

informix 11

DBSSO A-3

HHost name

ISA 7

specifying 15HTTP server password

ISA 7

specifying 15



53/56

Index 3


IICONNECT product code, silent

installation A-5

IDS prod uct code, silent

installation A-5

ids_installer script 12

r un nin g 12

silent installation A-4

solving problems B-2

informix account A-3Informix Connect, installing 9

.inform ix file, mu ltiple

residency A-14

informix grou p

creating 10

secur ity 11

Informix prod ucts

configuring 20

preparing to install 4selecting to install 6

uninstalling 15

uninstalling with RPM C-3

Informix Server Administrator. See

ISA.

Informix Techn ical Supp ort,

contacting B-1

Informix tools, installing. See tools

documentation.

informix user

creating 10

p assw or d 7

secur ity 11

INFORMIXDIR

aaodir directory 14

bin directory

setting in PATH 16, B-5

dbssodir directory 14

demo/ server directory 19demo/ server/ online.log file 19

demo/ server/ profile_settings

file 15, 19

etc/ onconfig.demo file 19

etc/ termcap file 18

ISA/ sbin/ isactl command 20

lib directory 18

msg/ lg_tr/ code_set directory 17

INFORMIXDIR directory

creating 12installing into B-3

ownership 15

INFORMIXDIR environm ent

variable

resetting B-5

setting 12, 16

setting in startup script 20

INFORMIXSERVER environment

variable

database servers referenced

by B-6


set ting 17


INFORMIXSQLHOSTS

environment variable,

set ting 17

INFORMIXTERM en vironm ent

variable

set ting 17

verifying B-6

informix.rc file, and mu ltiple

residency A-14

INF_ROLE_SEP environ men t

variable, setting 14, A-4

Initializing d isk space for mu ltiple

residency A-12

Installationcreating private A-6

order for Informix products 9

s ilent A-4

solving common p roblems B-1

specialized A-1

tes ting 19

Installation Checklist 6

Installing

Client SDK. See the "ClientProducts Installation Guide."

database server with role

separation A-4

datablade modu les. See Datablade

documentation.

Informix Connect

Seetools documentation.

Informix tools

Seetools documentation.on Linux system C-1

on non-RPM installed Linux 10

on UNIX 10

using pkgadd C-5

using RPM C-1

installserver script


solving problems B-2

Introduction to d atabase servers.

See the "Getting Started" manual.

Invalid key B-2

Invalid license serial num ber B-2

IPX/ SPX, and mu ltiple

residency A-12

ISA

administrator email address 7

Configuration Checklist 7

configuring 15

h ost na me 7

HTTP server password 7

por t number 7, 8

read-only users 8

s tart ing 20

JJava ru ntime executable (JRE) 15

JRE. See Java runtime executable.

KKey

description of 6

entering 14, C-2, C-5

invalid B-2

locating 5

@O QCA B D E F G H I J K L M N P R S T U V W X Y Z


54/56

@


O QCA B D E F G H I J K L M N P R S T U V W X Y Z

LLD_LIBRARY_PATH environ men t

variable, setting 18

LIBPATH environ men t variable

(AIX), setting 18

License serial num ber

description of 6

entering 14, C-2, C-5

invalid B-2

locating 5Linux

default installation directory 12

installing Informix prod ucts 1, 10

installing u sing RPM C-1

operating system patches 4

/ opt/ informix directory C-2

Locale, environment variables 16

Locating

key 5

license serial number 5

MMachine notes 3

Memory, and mu ltiple

residency A-9

Migrating from a different database

server. See the "M igration Guide."Mirroring, and mu ltiple

residency A-12

MIRROROFFSET parameter


See also the "Administrators

Reference."

MIRRORPATH parameter


See the "Administrators Reference."

Modes. See the "A dministrators

Guide."

MSGPATH param eter


See also the "Administrators

Reference."

Multiple database servers A-8

Multiple residency

archiving A-13assigning chunks A-12

backups A-13

blobspaces A-12

configuring A-8

DBSERVERNAME

parameter A-11

dbspaces A-12

definition of A-8

/ etc/ hosts fi le A-12

.informix file A-14

INFORMIXSERVERen vironm ent

variable A-14

informix.rc file A-14

initializing disk space A-12

IPX/ SPX A-12

isolating app lications A-8

MIRROROFFSET

parameter A-12

MIRRORPATH parameter A-12

MSGPATH parameter A-11

multiple binaries A-9

planning A-8

requirements A-9

ROOTOFFSET param eter A-11

ROOTPATH parameter A-11

separate configuration files A-8

SERVERNUM param eter A-11

shutdown script A-14sqlhosts file A-12

startup script A-13

use for testing A-8

NNetWare server, and mu ltiple

residency A-12

OON-Bar, preparing for multiple

residency A-13

ONCON FIG environment variable



ON CON FIG file


sample 19

ONCON FIG param eters. SeeParameters.

oninit command 15, A-7

ontape, preparing for mu ltiple

residency A-13

Operating system, patches 4

/ opt/ informix directory,Linux 12,

C-2

PParameters

DBSERVERNA ME A-11

MIRROROFFSET A-12

MIRRORPATH A-12

MSGPATH A-11

ROOTOFFSET A-11

ROOTPATH A-11

SERVERNUM A-11Password

HTTP server 7

informix user 7

PATH environment v ariable

set ting 16


setting INFORMIXDIR/ bin

directory B-5

Performing a silent installation A-4

Permissions, private

installation A-6

pkgadd util ity C-5

Planning

for multiple residency A-8

for role separation A-2

product installation 4

Platform, environment variables 16



55/56

Index 5


Port number

/ etc/ services file 7, 8specifying 7, 8, 15

Preparing

for mu ltiple residency A-8

for private installation A-6

for role separation A-2

for silent installation A-4

to install Informix prod ucts 10

Preserving earlier versions 12

Previous versions, upgrad ing

from 4

Private installation

configuring A-5

creating A-6

definition of A-5

installserver script A-7

permissions A-6

purpose A-5

restrictions A-6

Problems, solving B-1

Prod uct codes for silent

installation A-5

RRead-only users

allowing 15

d efin ed 8

ISA 8

Red H at Package Manager. See

RPM.

Related reading 2

Release notes 3

Removing Informix p rodu cts. See

Uninstalling.

Requirements, mu ltiple

residency A-9

Restrictions, priva te

installation A-6

Role separ ation

AAO group A-3

AAO user account A-3

activating at installation time A-2

administrative roles A-3

configuring A-1

DBSSO group A-3

DBSSO user account A-3

description of 5

disabling A-2enabling A-4

INF_ROLE_SEP environ men t

variable 14, A-4

installing the database server

w it h A -4

user account names A-3

See also the "Trusted Facility

Manual."

root account A-3

ROOTOFFSET p aram eter


See also the "A dmin istrators

Reference."

ROOTPATH p arameter


See also the