2.3. Configuration

To configure Gold, run the "configure" script provided with the distribution.

To see the list of options:
    
  -h, —help              display the list of options

Use prefix to tell it where Gold should be installed (defaults to /usr/local):

  —prefix=PREFIX         install architecture-independent files in PREFIX

Use with-db to specify the database you intend to use with Gold. Currently only PostgreSQL (Pg), MySQL (mysql) and SQLite (SQLite) have been tested for use with Gold. Postgres and MySQL are external databases which runs in a distinct (possibly remote) process and communicates over sockets while SQLite is an embedded database bundled with Gold with SQL queries being performed within the goldd process itself through library calls. Initial testing has shown SQLite to be at least as fast as PostgreSQL for small installations. The default is to use PostgreSQL.

  —with-db=DATABASE      database to be used { Pg, mysql, SQLite } [Pg]

Use without-readline if you do not want to use the gnu readline library

  —without-readline      Don't use readline in interactive control program

Use with-user to specify the userid that gold will run under (defaults to the
user running the configure command).

  —with-user=USER        user id under which the gold server will run

Use with-log-dir to specify the directory to which logs will be written
(defaults to PREFIX/log).

  —with-log-dir=PATH     directory for log files [PREFIX/log]

Use with-perl-libs to indicate whether you want to install the required perl modules in a local gold directory (PREFIX/lib) or in the default system site-perl directory (triggered by running make deps).

  —with-perl-libs=local|site       install policy for prerequisite perl libs [local]

Use with-gold-libs to indicate whether you want to install the Gold modules in a local gold directory (PREFIX/lib) or in the default system site-perl directory (defaults to local).

  —with-gold-libs=local|site  install policy for Gold perl libs [local]

If you will intend to use the Gold web GUI, use with-cgi-bin to specify the directory where you want the gold CGI files to reside (defaults to /var/www/cgi-bin/gold).

  —with-cgi-bin=DIR      directory to install cgi-bin files if using web gui [/var/www/cgi-bin/gold]

The PERL environment variable helps the install process find the desired (5.6) perl interpreter if it is not in your path or not found first in a path search.

  PERL        full pathname of the Perl interpreter

Some other influential environment variables are:
  CC          C compiler command
  CFLAGS      C compiler flags
  LDFLAGS     linker flags, e.g. -L<lib dir> if you have libraries in a
              nonstandard directory <lib dir>
  CPPFLAGS    C/C++ preprocessor flags, e.g. -I<include dir> if you have
              headers in a nonstandard directory <include dir>
      

So, as an example you might use something like:

[scottmo]$ cd gold-2.1.12.2

[scottmo]$ ./configure —prefix=/usr/local/gold —with-cgi-bin=/var/www/cgi-bin/gold