******************************************************************************

*

* README.build-scripts

*

* Author: Robert Story <rstory@freesnmp.com>

*

* $Id$

*

******************************************************************************

Introduction

============

The automated build script will automatically run configure, 'make all',

'make test' and 'make install'. Log files are kept for each step, and the

scripts should abort when errors occur.

The usage of nsb-package is:

 Usage: nsb-package [-c] [-d] [-p] [-s SRCD] [-b BUILDD] [-i INSTALLD] VERSION

    VERSION    : release number (eg 5.2.2)

    -s SRCDIR  : soure directory [$HOME/src/net-snmp-VERSION]

    -b BUILDD  : build directory [$HOME/build/]

                 NOTE-platform will be appended to build directory

    -i INSTALLD: install directory [$HOME/build/\$PLATFORM/usr/local]

    -c : skip configure

    -d : dirty build (don't make distclean)

    -m : skip 'make all'

    -p : don't pause at prompts in between stages

    -t : skip 'make test'

The defaults assume you have a 'src', 'build' and 'binaries' directory in

your home directory.

Recommended Procedure

=====================

1) Log into Sourceforge Compile Farm Server

2) Update source (this will likely be automated in the future)

   For example, for release 5.0.3:

   $ cd ~/src

   $ CVS_RSH=ssh cvs -d $USER@cvs.net-snmp.org:/cvsroot/net-snmp \

         -q co -r Ext-5-0-3 -d ~/src/net-snmp-Ext-5-0-3 net-snmp

3) Run the package script. 

   $ $HOME/src/net-snmp-cvs/dist/nsb-package -r \

        -s $HOME/src/net-snmp-5.0.5 5.0.5

4) Create tarball (assuming no errors; see next section if there are errors)

   $ cd ~/build/`nsb-platform`

   $ tar cvf net-snmp-5.0.3-`nsb-platform`.tar usr

   $ gzip --best *.tar

5) Copy tarball to Sourceforge shell sever

   $ scp *.gz net-snmp.sourceforge.net:~/binaries/

6) Log out of compile farm server, log into shell server

7) Upload to Sourceforge

   $ ftp upload.sourceforge.net

     >bin

     >put *.gz

8) Update binaries via Sourceforge admin page

Builds with errors

==================

Should you encounter a build error, you will most likely want to skip the

'make distclean' and configure step (assuming the problem wasn't with

configure!). To do this, specify the 'dirty' and 'skip configure' options:

   $ nsb-package -p -d -c Ext-5-0-3

Should the build succeed, but some tests fail during 'make test', you probably

can to skip the test step to get to the install step:

   $ nsb-package -p -d -c -t Ext-5-0-3

OTHER PROBLEMS

--------------

* "Cannot find nsb-functions"

   It's a hack, but symlink nsb-functions and nsb-package to your local

   bin directory ($HOME/bin).  I'm trying to think of a better solution.

* "gcc: snmp_version.lo: No such file or directory"

   This is a good indication that you have previously build in your

   source directory. 'make distclean' in your source directory, or

   check out a fresh new version from CVS.