install

You install infx on any server that has the Informix software installed on it.

infx requires Perl version 5.8 or higher. Use the command perl -v to check your version.

requirements

infx only requires a small amount of space for the software. The total amount required for each instance will vary.

The size requirements will vary depending on the size of the instance and how much database and instance metrics you choose to store.

Space requirements:

item location approx size
infx software /infx 20mb
service logs /infx/inst/*/logs 10mb
instance photos /infx/inst/*/photo 2-5mb each
database photos /infx/inst/*/photo 1-2mb
Throughout this guide I use /infx to refer to the install location of the infx software. This is set at install and could be /home/informix/infx or another location. The directory must be owner and group informix.

other items

Storage space is required by other items, such as the informix software, chunk files, database and log backups.

item location approx size
informix software 11.5 /infx/sw/11.50 750mb
informix software 11.7 /infx/sw/11.70 1gb
database chunks /infx/inst/*/chks varies
backup data files /infx/inst/*/backup/db varies
backup log files /infx/inst/*/backup/logs varies

install instructions

Installation must be performed as user informix.
  1. Transfer the infx software to your host e.g. /home/informix/tar/infx-1.0b.tar.gz
  2. Uncompress the archive e.g. gunzip infx-1.0b.tar.gz
  3. Create tmp directory e.g. mkdir /home/informix/tar/tmp
  4. Change directory to tmp e.g. cd /home/informix/tar/tmp
  5. Extract tar file to tmp directory e.g. tar xvf/home/informix/tar/infx-1.0b.tar
  6. Set INFORMIXDIR to an Informix software location
  7. run “./install.sh” and follow the prompts to install
  8. view the README file for further instructions

example installation

This example shows how to install infx on a Linux server that already has Informix installed. There is one sample instance on the host, created when the informix software was installed.

host CentOS 6.0
informix version 11.70.FC4TL
location /opt/IBM/informix
instance ol_informix1170
chunk location /opt/IBM/informix/ol_informix1170/dbspaces

Once you have downloaded the software from download, copy it to the server under /home/informix/tar, and follow these steps.

Prepare to run the installation.

Now run the infx install command, you will be prompted through a series of questions.

At this point the infx software is installed, but infx does not know about any of the existing Informix instances.

Lines 25-27 show the result of the infx disco command, it detected the one Informix instance on my host.

Manually re-run the discovery command, with the save=yes parameter.

Line 7-10 show a series of deny-auto-* files being created in the instance etc directory. You must remove these files to have this instance included in the automatic infx functions.

Now infx is set up for this instance, it shows in the instance list.

The infx disco command also accepts the parameter newinst=all, to save all instances on the host

We can set our shell environment for that instance.

If you are using bash or ksh, add this alias to your login profile: alias infx='. /infx/scripts/infxenv'
usage: infxenv ol_informix1170.

This sets INFORMIXDIR, PATH and other environment variables. infx commands will now default to this instance.

List the databases.

instance configuration

This is the instance specific configuration file created by the discovery service. These settings override the default infx ones.

Add additional environment variables, such as DBDATE or DBMONEY, under the [env] section. These will be set in the environment before any informix command is run.

The README file contains more information and additional steps.

infx file locations

infx extracts to the following directories.

location description
/infx/etc infx config files
/infx/inst instance specific directories
/infx/lib Perl library files
/infx/local locally created infx scripts and templates
/infx/scripts infx CLI utilities
/infx/template infx templates
/infx/www CGI utilities
Don’t edit the config files in /infx/etc, or the template files in /infx/tempalte. Make copies under /local/local/etc or /infx/local/template and edit them there instead.

remote installation

Once infx is installed on one host, you can use infx services to install it to other hosts.

The remote host must meet the same requirements for installation i.e. Informix software installed and the infx software location created. Plus, both hosts must have the rsync utility installed.

When ready, send the software to the remote host using the rsync command.

$ infx rsync dest=mamvps04

You can set up SSH keys between the hosts, allowing access without a password. See setup ssh keys, for details on how to generate and send keys.

You can also use this command to keep remote servers up to date with script, template and configuration changes.