Copyright © 2009, 2010 Thomas M. Eastep
Permission is granted to copy, distribute and/or modify this document under the terms of the GNU Free Documentation License, Version 1.2 or any later version published by the Free Software Foundation; with no Invariant Sections, with no Front-Cover, and with no Back-Cover Texts. A copy of the license is included in the section entitled “GNU Free Documentation License”.
2010/06/02
Table of Contents
This information is provided primarily for Shorewall developers. Users are expected to install from pre-built tarballs or packages.
The Shorewall Git tree at Sourceforge serves as the master repository for Shorewall 4.4 and later versions. It is not possible to simply export a directory from Git and run the install.sh script in that directory. A build step is required to produce a directory that is suitable for the install.sh script to run in.
The development branch of each product is kept here.
Shorewall
Shorewall6
Shorewall-lite
Shorewall6-lite
Shorewall-init
There are also several other directories which are described in the following sub-sections.
The development release XML documents. Depending on the point in the release cycle, these documents may also apply to the current stable version. In that case, there is no docs directory in that release's directory in branches.
This is where the release and build tools are kept. There are two subordinate directories:
Tools for building and uploading new releases.
Tools for publishing web content
As described above, the build tools are kept in trunk/tools/build. They are described in the
following sections.
The setversion script updates the version
number in a directory. The script is run with the current working
directory being trunk.
setversion
version
The version may either be a minor
version or a patch version.
This is the script that builds Shorewall packages from Git.
The script copies content from Git using the git archive command. It then uses that content to build the packages. In addition to the usual Gnu utilities, the following software is required:
Required to build the RPM packages.
Required to convert the XML documents to other formats.
Required to convert the XML documents to other formats.
Required to massage some of the config files.
Required to convert the XML manpages to manpages. Be sure that you have a recent version; I use 0.0.23.
You should ensure that you have the latest script. The scripts change periodically as we move through the release cycles.
The scripts may need to be modified to fit your particular environment. There are a number of variables that are set near the front of the script:
Must point to the XHTML docbook.xsl stylesheet from your Docbook XSL Stylesheets installation.
Directory where you want the build log placed. Defaults to the current working directory.
Points to your RPM directory .
Directory where you want the release to be built. Defaults to the current working directory.
Shorewall GIT repository.
The scripts assume that there will be a separate build directory per major release. To build a release, you cd to the appropriate directory and run the build script.
The general form of the build command is:
build44 [ -
options]release[prior release]
where
are one of the following. If no options are given then all options are assumed
build tar files
build RPMs
Build the shorewall package.
Build the shorewall-init package.
Build the shorewall-lite package.
Build the shorewall6 package.
Build the shorewall6-lite package.
Build the html document package.
Build the xml document package.
The release version to build. Must match the version in the associated Git path.
The release to be used to generate patch files.
Example 1 - Build Shorewall 4.3.7 and generate patches against 4.3.6:
build44 4.3.7 4.3.6
Example 2 - Build Shorewall 4.2.7.1 Shorewall and generate patches against 4.2.7:
build44 -trc 4.3.7.1 4.3.7
This script is used to upload a release to www1.shorewall.net. The command is run in the build directory for the major release of the product.
upload44 [ -
products]release
where
specifes the products to upload. If not given, all products are uploaded. This option is generally given only when uploading a patch release.
Upload the shorewall package.
Upload the shorewall-lite package.
Upload the shorewall-init package.
Upload the shorewall6 package.
Upload the shorewall6-lite package.
The version number of the release to upload.
Example 1 - Upload release 4.3.7:
upload44 4.3.7
Example 2 - Upload shorewall-4.3.7.3:
upload44 -c 4.3.7.3
Each product includes an install script
(install.sh) that may be used to install the
product on a machine or into a directory.
By default, the scripts install the corresponding product into "/'; you can direct them to install into an empty existing directory by setting an environmental variable:
DESTDIR (release 4.4.10 and later)
PREFIX (all releases)
There are a number of other environmental variables that you can set to cause the directory to be populated for a particular target environment:
DEBIAN - Debian-based systems (Debian, Ubuntu, etc.)
SUSE - SEL and OpenSuSE
REDHAT - RHEL, CentOS, Foobar, etc.
MAC - Apple MacIntosh (Shorewall and Shorewall6 packages only)
CYGWIN - Cygwin under Windows (Shorewall and Shorewall6 packages only)