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