Building NetBeans Enterprise Pack 5.5

Introduction

NetBeans Enterprise Pack is composed as build of a set of module suites built on top of NetBeans IDE binary. Enterprise Pack build uses build harness found in harness cluster of NetBeans IDE. You can do two basic types of build. Full build of all components (including IDE) from sources and a build on top of pre-existing NetBeans IDE binary. The first one requires you to have more sources on your disk and the latter requires that you obtain a copy of NetBeans IDE 5.5 somewhere and unpack it under nbbuild directory.

Required tools

Apache Ant v. 1.6.5
Java2 SDK 1.5.0_x
CVS 1.11.17 (or higher)(NO CVSNT!)

See also "banned tools" in section "Known issues".

Before you start

Check your tools match criteria mentioned above in section "Required Tools".
Sample tools versions

Building all from sources

In short: Get sources for IDE and Enterprise Pack, build IDE, build Enterprise Pack
Detailed steps:

$ mkdir nb_all
$ cd nb_all
$ export CVSROOT=":pserver:anoncvs@cvs.netbeans.org:/cvs"
$ cvs co -AP -rrelease55 standard55 enterprise identity print
$ cd nbbuild
$ ant

[ this builds you NetBeans IDE including build harness under nbbuild/netbeans/harness ]

$ cd entpack
$ ant

[ this builds you Enterprise Pack; result is in nbbuild/netbeans/harness resp. in nbbuild/entpack/dist ]

$

Building Enterprise Pack from sources on top of NetBeans IDE binary

In short: Get NetBeans IDE binary, get sources for Enterprise Pack, buildsystem and testsuite, build Enterprise Pack
Detailed steps:

$ mkdir nb_all
$ cd nb_all
$ export CVSROOT=":pserver:anoncvs@cvs.netbeans.org:/cvs"
$ cvs co -AP -rrelease55 enterprise identity junit nbbuild print xml xtest
$ cd nbbuild

[ copy your NetBeans IDE binary build here i.e. by unpacking IDE zipfile;
make sure that file nb_all/nbbuild/netbeans/harness/suite.xml exists on your disk ]

$ ant bootstrap
$ cd entpack
$ ant

[ this builds you Enterprise Pack; result is in nbbuild/netbeans/harness resp. in nbbuild/entpack/dist ]

$

Known issues

There are following known issues:
Issue: Ant build ends with error message "java.lang.OutOfMemoryError"
Solution: consider allowing JVM for bigger memory consumption at build time by setting/extending environment variable ANT_OPTS with "-Xmx512m"

Issue: CVS returns error message "Unknown host cvs.netbeans.org"
Solution: you'll have to use either SOCKS5 configuration or a CVS tunnel

Issue: CVS checkout/update ends with error message "cvs [server aborted]: Contains.java,v is ambiguous; could mean contains.java,v or Contains.java,v"
Solution: complete section "Before you start". You are using CVS client which is not compatible with cvs.netbeans.org. WinCVS or TortoiseCVS are known to not work with combination of three factors: cvs.netbeans.org, branches and case insensitive filesystem.

Issue: List of banned tools (known to not work or work improperly)
Solution: The most issues is with CVS client on Windows OS. Please use only the CVS client mentioned in section "Required tools". Other CVS clients like CVSNT, TortoiseCVS or WinCVS are known to work incorrectly with branches on cvs.netbeans.org when running on Windows boxes. In other words, only GNU CVS or NetBeans IDE internal CVS clients are supported in these build instructions.