Prerequisites

  • A UNIX system-based or Unix-like Operating System
  • Perl version ≥ 5.8.x
  • Curses Perl module version ≥ 1.19

Installing

RPM and DEB packages are available for Linux systems that support these formats. For all UNIX systems:

 gzip -d < ccfe-X.YY.tar.gz | tar xvf -
 cd ccfe-X.YY
 ./install.sh

In its most simplest form, install.sh is the CCFE interactive installation program:

$ ./install.sh


 ******************************************************************************
                   WELCOME TO CCFE INSTALLATION PROGRAM
 ******************************************************************************

  1. Change Destination prefix                  (/usr/local/ccfe)
  2. Change Configuration directory             (/usr/local/ccfe/etc)
  3. Change Executables directory               (/usr/local/ccfe/bin)
  4. Change Libraries directory                 (/usr/local/ccfe/lib)
  5. Change Logs directory                      (/usr/local/ccfe/log)
  6. Change Messages and localization directory (/usr/local/ccfe/msg)
  7. Change Man pages directory                 (/usr/local/ccfe/man)
  8. Change Documentation directory             (/usr/local/ccfe/doc)

  C. Change mode (Installation or Update)
  S. START FRESH INSTALLATION
  Q. Quit without install

Choice? [Q] _

then set your desired installation subdirectories and select S to start installation.

It is possible to make a batch installation invoking it with:

 ./install.sh -b

(Please see ./install.sh -h for help on available options).

install.sh requires a POSIX.2 compatible shell, like sh(1), bash(1) or ksh(1).

Please note that you may have to change the environment variable MANPATH to access to CCFE manual pages by man(1) command, for example:

 MANPATH=/usr/local/ccfe/man:$MANPATH
 export MANPATH

Updating

When you install CCFE, a file named ccfeinstall.conf is created in the CCFE configuration directory: it contains the user selected destinations for CCFE objects.

You can update the current installation with a new version by selecting Change mode from menu: you will be promped for a list of standard directories where search for ccfeinstall.conf file, then the CCFE installation program will read from it the directories where the files to update are.

The update process will not modify all user customized files (configurations, messages, etc.), but only:
  • The ccfe Perl script
  • All CCFE manpages
  • All README files (README, ChangeLog, AUTHORS, etc.)

If configuration and/or messages files are provided with a new release, they will be installed with the release number as filename extension, so your current configuration will be preserved. Please refer to README file for specific notes.

It is possible to make a batch update with the following command:

 ./install.sh -b -u ConfigurationPath

where ConfigurationPath is the directory of the CCFE configuration (.conf): for example:

 ./install.sh -b -u /etc/ccfe

UNIX is a registered trade mark in the United States and other countries, licensed exclusively through X/Open Company Limited.