release.sh Instructions (Release 4.1)

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 cds 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 cdrom, see Option 1: using the published cd 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 below.

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

Option 1: using the published cd packages

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

To use the published cd packages, type as root from the greenfrog directory:./release.sh cd

Then move on to image.sh

Option 2: update the source from cvs

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 cdrom.
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: 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.

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'.

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

NOTE: The release.sh script is setup to update to tag OPENBSD_4_1. If this is not your release, change the CVSTAG variable in greenfrog.conf.

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 (Release 4.1).