release.sh Instructions

1. Build Machine
2. release.sh Instructions
3. image.sh Instructions
4. Customization
5. Write Image
6. Post Installation
7. Known Issues

Project Status Please note that this project is no longer active. If you are interested in taking over the code base please let me know.

Overview

The release.sh script prepares a set of binary packages for installation by either copying them from the published OpenBSD DVD-ROMs or by building them from source updated from cvs.

The release.sh script is part of the zip on the Downloads page, but can be viewed here.

There are two log files assocaited with release.sh, release-RUNTIME.log tracks the start and stop times of each step and release-STDERR.log contains any error messages.

Setup

Copy the greenfrog zip file to the build machine as described in the Build Machine: Post Installation instructions. Then as root type:

unzip greenfrog-*.zip
cd greenfrog
chmod u+x *.sh

Which Option?

If there have been no major patches or errata to the release you are working from (i.e. the release you are working from is only a few days old) then you can simply use the binary packages from the DVD-ROM, see Option 1: using the published base packages below.

However, if there are any major errata or patches to packages, then new binary packages need to be created, see Option 2: update the source from cvs and build all below.

Finally, if you just want to do a quick build to test out the scripts, then use Option 1: using the published base packages.

Option 1: using the published base packages

The fastest way to create an image is to use the published DVD-ROM packages. The risk is that there are some updates that have been released since the DVDs were published.

To use the published DVD-ROM packages, type as root from the greenfrog directory:

./release.sh base

Then move on to image.sh Instructions.

Option 2: update the source from cvs and build all

The release.sh script generates an up to date set of binary packages, but it can take a long time to run. The script includes the following steps:

• Expand source from the OpenBSD DVD-ROM.
• Update source from cvs.
• Build and install the latest kernel on the build machine.
• Rebulid all the source binaries.
• Create the release tar balls with the latest binaries.

Note During the update step when the connection is made for the first time to the cvs server, there will be a prompt for acceptance of ssh host key, please respond 'yes'.

Tip Please consider using a cvs mirror, the default cvs server for this script is the main cvs server, but it can be quite slow. To change the cvs server, edit the CVSROOT variable in the *greenfrog.conf * file. The list of mirrors can be found here: http://www.openbsd.org/anoncvs.html#CVSROOT.

Info Depending on the speed of the build machine, the kernel and system steps could take several hours to complete.

To run the scripts, type as root from the greenfrog directory:

./release.sh source
./release.sh update
./release.sh kernel
reboot

After the build machine restarts, type as root from the greenfrog directory:

./release.sh system
./release.sh release

Next image.sh Instructions.