LCFG Build Tools : Installation Guide

The LCFG build tools are expected to work fine on any Unix-based
operating system. In particular, the tools have been designed to work
on Linux, MacOSX and Solaris. The intention is that the code should be
platform-independent and work on Windows under Cygwin, however, that
has not been tested. If you have access to a system and are willing to
try out our code and give us patches or feedback that would be very
much appreciated.

There are a number of ways in which you can install the
packages.

Using LCFG

If you are already using LCFG to manage FedoraCore6 or
ScientificLinux5 systems then adding the LCFG build tools could not be
simpler. You need to include the
lcfg/options/buildtools.h header into the LCFG source
profile for the target machine. This header adds either the
lcfg/lcfg_fc6_devel.rpms or
lcfg/lcfg_sl5_devel.rpms package list to your
profile.

Using yum

If you do not use LCFG but have an RPM-based system you can use the
Redhat package manager, yum, to install the software. As the root
user, you will need to create a file named
/etc/yum.repos.d/lcfg.repo. For FedoraCore6 this should
look like:

If you want packages for x86_64 based systems instead then replace
the "i386" with "x86_64" in the baseurl field.

At the minimum you then need to request the installation of the
perl-LCFG-Build-Tools package. If you want to create new
projects as well manage existing software then you will also need to
install perl-LCFG-Build-Skeleton. All the dependencies
should be automatically installed. As the root user, issue the
command:

# yum install perl-LCFG-Build-Tools perl-LCFG-Build-Skeleton

It is expected that these packages will work on
any RPM based system so if you are not using a
supported platform you can download the SRPMs and rebuild those for
your own platform instead. The SL5 RPMs should work unmodified in any
RHEL5, or derivative, environment.

It is not necessary to use yum, you could alternatively download
all the packages directly from the LCFG website and install using the
RPM command.

Using CPAN

On other systems which do not use the RPM package system the
easiest approach to installation is currently to retrieve the latest
packages from CPAN.

If you are doing the install as the root user it is a fairly simple
and straightforward process. For example:

# perl -MCPAN -e shell
cpan> install LCFG::Build::Tools

Again, dependencies are handled automatically and you just need to
request the installation of LCFG::Build::Tools and
LCFG::Build::Skeleton. On Linux, by default the Perl
modules will be installed into the perl hierarchy under
/usr/local/.

It is also possible to install the LCFG build tools from CPAN as a
normal user. You will need to download the following LCFG packages:
LCFG::Build::PkgSpec, LCFG::Build::VCS,
LCFG::Build::Tools and
LCFG::Build::Skeleton. The required steps for manually installing
each module vary slightly so you should open the gzipped tar files and
then follow the instructions in the README file which accompanies each
module. For example: