Chapter 2. Installation

Table of Contents

1. Debian and Ubuntu packages
2. RPM packaging
3. Source builds and the separate XULRunner dependency
3.1. Building cf-xulrunner separately
3.2. Historical build helper
4. Environment
5. Compiling CF programs

Connector Framework software can be downloaded from http://ftp.indexdata.dk/pub/cf/ (authorization required). The CF source code distribution with connector files etc is part of the file cf-version.tar.gz.

CF 2.31.1 is built and tested on amd64 for Debian Trixie and Ubuntu Resolute. Other platforms require their own compatible dependency packages and validation; historical build notes do not establish current support.

The engine embeds Gecko from the separately maintained cf-xulrunner project, based on Firefox 38.8 ESR. Install its runtime package cf-xulrunner38 before running CF, and its SDK package cf-xulrunner38-dev before compiling CF. Current Debian/Ubuntu packaging requires version 38.8-5.indexdata or newer, including the Fontconfig compatibility fix needed on Resolute. Mozilla is not compiled as part of the CF build. See Section 3, “Source builds and the separate XULRunner dependency”.

The CF Engine operates as a browser component. Some kind of display device is required. The virtual framebuffer X server (Xvfb) should be used as display device.

For the CF Z39.50/SRU server, YAZ is required. YAZ provides the infrastructure to build Z39.50/SRU applications.

For the CF Web service, Metaproxy is required. See the Metaproxy documentation for details on how to install that. It requires YAZ, YAZ++ as well as the Boost library.

1. Debian and Ubuntu packages

Index Data provides CF packages for Debian Trixie and Ubuntu Resolute on amd64. Configure the Index Data APT repository for the appropriate distribution, including access to CF's restricted repository component where required. The main component supplies dependencies such as cf-xulrunner and Metaproxy. Repository access details are supplied separately by Index Data.

Install the engine and documentation with:

     apt-get update
     apt-get install cf-engine cf-doc
    

APT installs the required cf-runtime, cf-xulrunner38 and Metaproxy packages. Add cf-zserver for the Z39.50/SRU service or cf-squid for Squid integration as needed.