---

Table of Contents

IDE Configuration Spec

List of packages

Ubuntu Hardy Heron

Debian

Fedora

Mandriva

References

Configuration

This is stripped NetBeans IDE 6.0.1 configuration to limit number of external dependencies.

Remarks

• Basically Java IDE which does not include: DB, JPA, WebServices and XSL.
• The patch is a plain module config change.
• Removing VCS (CVS, Subversion) would probably remove three more libs (jsch, ini4j and svnClientAdapter )
• List of hardy packages obtained from http://packages.ubuntu.com/hardy/allpackages.en.txt.gz
• Would be nice to get rid of resolver.jar too, but all freeform modules seem to depend on it (see bottom of the page).

Mandriva

Press Release April 17, 2008

NetBeans team and Mandriva, the publisher of Mandriva Linux are proud to announce the immediate availability of award winning NetBeans IDE as part of the Mandriva 2008.1 Linux distribution.

Based on the open source NetBeans IDE 6.0 release, and the open source version of Java, as developed by Sun Microsystems, the Mandriva's contrib repository now contains a full Open Source stack to write, run, debug and test Swing based Java applications. Just open your favorite package management tool and install "netbeans-ide" package:

urpmi netbeans-ide

Enjoy! If you find any bugs, please report them to linux-packaging@installer.netbeans.org mailing list.

---

Technical info about Packaging

Latest source RPMs are published as part of Mandriva's Cooker, for example at ftp.proxad.net and ftp.proxad.net start with netbeans-ide and libnb-* packages.

List of packages:

• libnb-platform7 package contains cluster platform7
• libnb-ide8 ide8
• libnb-java1 java1
• libnb-apisupport1 apisupport1
• libnb-platform7-devel harness
• libnb-javaparser contains NetBeans java parser infrastructure
• libnb-svnClientAdapter contains NetBeans version of SVN adapter
• netbeans-ide nb6.0, launcher, netbeans.conf, netbeans.clusters, ....

Other packages may be added in future, as soon as they are cleaned up from 3rd party libraries. However even right now they are available through NetBeans internal Autoupdate.

List of necessary Libraries (Ubuntu)

External

Library	Ubuntu Hardy Package	Status
./platform7/modules/ext/swing-layout-1.0.3.jar	libswing-layout-java (1.0.3-1) universe	EXISTS
./platform7/modules/ext/script-api.jar	we have dummy module icedtea contains this code already	N/A
./platform7/modules/ext/jh-2.0_05.jar	javahelp2 (2.0.05-3) universe	EXISTS
./ide8/modules/ext/xerces-2.8.0.jar	libxerces2-java (2.9.0-1) main	EXISTS
./ide8/modules/ext/lucene-core-2.1.0.jar	liblucene2-java (2.2.0-2ubuntu1) universe	EXISTS
./ide8/modules/ext/resolver-1.2.jar	libxml-commons-resolver1.1-java (1.2-1)	EXISTS [1]
./ide8/modules/ext/freemarker-2.3.8.jar	libfreemarker-java (2.3.10)	EXISTS
./ide8/modules/ext/commons-logging-1.0.4.jar	libcommons-logging-java (1.1-1ubuntu1) main	EXISTS
./ide8/modules/ext/ini4j-0.2.6.jar	our own libini4j-java (0.2.6)	ACCEPTED [2] 185943
./ide8/modules/ext/svnClientAdapter-0.9.23.jar	our own libnb-svnclientadapter-java (6.0)	ACCEPTED 185991
./ide8/modules/ext/jsch-0.1.24.jar	libjsch-java (0.1.34ds1-1) main	EXISTS
./java1/ant/*	ant (1.7.0-3) main	EXISTS Needs to test whether all parts are available in the package
./java1/modules/ext/junit-3.8.2.jar	junit (3.8.1.1-7) main	EXISTS
./java1/modules/ext/junit-4.1.jar	junit4 (4.3.1-2) universe	EXISTS
./java1/modules/ext/swing-worker-1.1.jar	our own libswingworker-java (1.1)	ACCEPTED 185960
./java1/modules/ext/appframework-1.0.3.jar	our own libappframework-java (1.0.3)	ACCEPTED 185969
./java1/modules/ext/beansbinding-1.2.1.jar	our own libbeansbinding-java (1.2.1)	ACCEPTED 185975
./java1/modules/ext/javac-api.jar AND javac-impl.jar	our own libnb-javaparser-java (6.0)	ACCEPTED 185982

NetBeans (don't care)

./java1/modules/ext/org-netbeans-modules-java-j2seplatform-probe.jar

./java1/modules/ext/AbsoluteLayout.jar

./platform7/modules/ext/updater.jar

./ide8/modules/ext/org-netbeans-tax.jar

./nb6.0/modules/ext/locale/updater_nb.jar

Modules depending on resolver-1.2.jar

grep -r --include "*.xml" "xml\.resolver" .

./java/freeform/nbproject/project.xml: <code-name-base>org.apache.xml.resolver</code-name-base>
./logger/uihandlerlib/test/unit/src/org/netbeans/lib/uihandlerserver/wrongutfchar.xml: <param>org.apache.xml.resolver</param>
./logger/uihandlerlib/test/unit/src/org/netbeans/lib/uihandlerserver/baduser.xml: <param>org.apache.xml.resolver</param>
./libs/resolver/nbproject/project.xml: <code-name-base>org.apache.xml.resolver</code-name-base>
./libs/resolver/nbproject/project.xml: <subpackages>org.apache.xml.resolver</subpackages>
./apisupport/project/nbproject/project.xml: <code-name-base>org.apache.xml.resolver</code-name-base>
./xml/retriever/nbproject/project.xml: <code-name-base>org.apache.xml.resolver</code-name-base>
./xml/catalog/nbproject/project.xml: <code-name-base>org.apache.xml.resolver</code-name-base>
./ant/freeform/nbproject/project.xml: <code-name-base>org.apache.xml.resolver</code-name-base>

Build of the Small IDE

Zipped build of the small IDE is available here for convenience. Unfortunately this link only works inside of Sun. If you are outside you will still need to check out 6.0 version of NetBeans, apply the patch and build it with ant -Dcluster.config=basic build-nozip.

Packages

List of packages:

Binary packages generated from source package libnb-platform7-java:

• libnb-platform7-java package contains cluster platform7
• libnb-platform7-java-doc package contains javadoc for NetBeans Platform
• libnb-platform7-devel-java harness

Binary packages generated from source package netbeans:

• libnb-ide8-java ide8
• libnb-java1-java java1
• libnb-apisupport1-java apisupport1
• netbeans nb6.0, launcher, netbeans.conf, netbeans.clusters, ....

Our own separate packages:

• libnb-javaparser-java contains NetBeans java parser infrastructure
• libnb-svnClientAdapter-java contains NetBeans version of SVN adapter

These are also listed above in table of external libraries

Ubuntu

Disc layout

Disc layout is designed to allow to install more versions of NetBeans (and its clusters) into one system. This allows other applications which might depend on older NetBeans version (e.g. platform7 cluster) to still use this cluster even NetBeans IDE with cluster platform8 is installed.

Packages listed above, the ones which contain real modules and files will be installed as follows:

1. e.g. package libnb-platform7-java ==> /usr/share/netbeans/platform7 folder.
2. or libnb-ide8-java ==> /usr/share/netbeans/ide8 folder.

From these folders we will create symlinks to 3rd party libraries installed aside e.g. to ini4j.jar which is installed as extra lib. External libraries are installed mostly to /usr/share/java.

The top level package for NetBeans 6.0.1 IDE will be installed as follows:

1. package netbeans ==> /usr/share/netbeans/6.0.1/nb6.0/
2. then symlinks to all clusters physically installed above will be created in /usr/share/netbeans/6.0.1/platform7 will be symlink to /usr/share/netbeans/platform7 folder
3. /etc/netbeans.clusters file will contain list of all known clusters. /usr/share/netbeans/6.0.1/etc/netbeans.clusters is symlink to /etc/netbeans.clusters
4. IDE launcher /usr/bin/netbeans will be created. The launcher script will be "one fits all" kind, it will not be customized for particular system configuration.
5. Files /etc/netbeans.conf and /etc/netbeans.clusters will be actual files and /usr/share/netbeans/6.0.1/etc/netbeans.conf and /usr/share/netbeans/6.0.1/etc/netbeans.clusters will be symlinks to them.
6. Launcher is created in /usr/bin/netbeans. It is patched to be able to locate /etc/netbeans.conf and /usr/share/netbeans/6.0.1/etc/netbeans.clusters
7. Man page /usr/share/man/man1/netbeans.1.gz is created.
8. Desktop file /usr/share/applications/netbeans.desktop (adds menu item to start menu Applications -> Programming for NetBeans IDE.

NetBeans 6.0.1

Package	Status	Link
libnb-platform7-java	ACCEPTED	187301
netbeans	ACCEPTED	187708

[#1] It contains original resolver1.2 without NetBeans patches. XML team should handle this. API change should go to upstream. Second NPE issue should be handled somehow on NetBeans side. Current status breaks SOA functionality #127132 . We are investigating if there is any workaround.

[#2] Source package is UPLOADED to REVU and must pass through review by at least 2 reviewers. If it passes review it goes to NEW queue . It must be ACCEPTED by archive admin to go to repository and become available. These packages already passed review from Emmet Hikory - our Ubuntu technical contact.

lucene2 issues:

• 453288
• 185917

Notes

appframework upstream has AppFramework-1.03.jar but in IDE framework-1.0.3.jar is used.

Upstream sources for NetBeans 6.0.1 Ubuntu packages

We use reference archive for platform and ide to create upstream source archives necessary to build Ubuntu packages. As these archives contain binaries we must clean them. Shell scripts clean-platform.sh and clean-ide.sh for cleaning original sources are attached below. Unneeded sources are deleted from ide sources. Resulting source archives in tar.gz format used as upstream source for building packages are published as platform upstream and ide upstream. Root folder with name of source netbeans-platform-6.0.1 and netbeans-6.0.1 containing sources is created and file LICENSE.txt containing license is added to this folder.

HowTo Build Packages Quickstart

To build packages it is necessary to have either development version of Ubuntu or use pbuilder. Some additional packages must be installed. System tells you what to install on console when uninstalled program is used. Following packages must be installed to build our packages:

• build-essential
• debhelper
• devscripts
• ant and eventually ant-optional
• cdbs
• gnupg
• and of course any build dependency of built package

First you must have GPGKey to be able to sign built packages. Without it you will not be able to upload new packages or contribute updates for existing packages. Simply all contributions MUST be signed.

I will use libini4j-java package as example to show how to build existing package.

Get source package:

apt-get source libini4j-java

You will get:

libini4j-java-0.2.6
libini4j-java_0.2.6-0ubuntu2.diff.gz
libini4j-java_0.2.6-0ubuntu2.dsc
libini4j-java_0.2.6.orig.tar.gz

Directory libini4j-java-0.2.6 contains directory debian and uncompressed sources. Archive libini4j-java_0.2.6.orig.tar.gz contains upstream sources. Note name structure. If you create new package you must create this content manually.

To build binary package from source package go to directory libini4j-java-0.2.6 and use

debuild

in the end you will be asked to sign packages ie. enter passphrase.

To build source package for upload:

debuild -S -sa

To perform clean:

debuild clean

More info:

For uploading new packages see: REVU

For updating existing packages see: Contributing

For more info about debian packaging see: Debian New Maintainers' Guide and Debian Policy Manual

Debian

Daniel Baumann, a Debian developer, did the packaging work and put NB 6.0 into <contrib>

• http://packages.debian.org/sid/devel/netbeans-ide
• http://packages.debian.org/sid/netbeans-platform

NetBeans 6.1 for Debian

List of packages:

Binary packages generated from source package libnb-platform8-java:

• libnb-platform8-java package contains cluster platform8
• libnb-platform8-java-doc package contains javadoc for NetBeans Platform
• libnb-platform8-devel-java harness

Binary packages generated from source package netbeans:

• libnb-ide9-java ide9
• libnb-java2-java java2
• libnb-apisupport1-java apisupport1
• libnb-gsf1-java gsf1 (?)
• netbeans nb6.0, launcher, netbeans.conf, netbeans.clusters, etc

Our own separate packages are listed below in the tables of external libraries

List of necessary Libraries (Debian)

External(Exist in 6.0.1)

Library	Debian Package	Status
./platform8/modules/ext/swing-layout-1.0.3.jar	libswing-layout-java (1.0.3-1) sid/main	EXISTS
./platform8/modules/ext/script-api.jar	we have dummy module icedtea contains this code already	N/A (?)
./platform8/modules/ext/jh-2.0_05.jar	javahelp2 (2.0.05-3) sid/main	EXISTS
./ide9/modules/ext/xerces-2.8.0.jar	libxerces2-java (2.9.1-2) sid/main	EXISTS
./ide9/modules/ext/lucene-core-2.2.0.jar	liblucene2-java (2.3.1+ds1-1) sid/contrib	EXISTS [3] (waits for openjdk-6 to move to main)
./ide9/modules/ext/resolver-1.2.jar	libxml-commons-resolver1.1-java (1.2-2) sid/main	EXISTS [4]
./ide9/modules/ext/freemarker-2.3.8.jar	libfreemarker-java (2.3.13-1) sid/contrib	EXISTS [3] (waits for libservlet2.5-java to move to main)
./ide9/modules/ext/commons-logging-1.0.4.jar	libcommons-logging-java (1.1.1-1) sid/main	EXISTS
./ide9/modules/ext/ini4j-0.2.6.jar	our own libini4j-java (0.2.6)	TBD(update Ubuntu package)
./ide9/modules/ext/svnClientAdapter-0.9.23.jar	our own libnb-svnclientadapter-java (6.1)	TBD(update Ubuntu package)
./ide9/modules/ext/jsch-0.1.24.jar	libjsch-java (0.1.37-3) sid/main	EXISTS
./java2/ant/*	ant (1.7.0-6) sid/main	EXISTS
./java2/modules/ext/junit-3.8.2.jar	junit (3.8.2-1) sid/main	EXISTS
./java2/modules/ext/junit-4.1.jar	junit4 (4.3.1-4) sid/main	EXISTS
./java2/modules/ext/swing-worker-1.1.jar	our own libswingworker-java (1.1)	TBD(update Ubuntu package)
./java2/modules/ext/appframework-1.0.3.jar	our own libappframework-java (1.0.3)	TBD(update Ubuntu package)
./java2/modules/ext/beansbinding-1.2.1.jar	our own libbeansbinding-java (1.2.1)	TBD(update Ubuntu package)
./java2/modules/ext/javac-api-nb-7.0-b07.jar AND javac-impl-nb-7.0-b07.jar	our own libnb-javaparser-java (6.1)	TBD(update Ubuntu package)

External(New for 6.1)

Library	Evaluation
./java2/modules/ext/spring/commons-logging-1.1.jar	don't care
./java2/modules/ext/spring/spring-2.5.jar	don't care
./platform8/modules/ext/jna-3.0.2.jar	seems to be used by core.nativeaccess; New package is needed.

List of tasks(draft)

• [#3] wait for packages to move to main
• [#4] create forked resolver1.2 for NB6.1. #128678
• update Ubuntu packages for libs created for NB6.0.1 to be suitable for Debian (repack and update source tree where is needed)
• create package for jna
• create Debian packages for NB6.1 (update existent packages for Ubuntu )
  • install openjdk-6-jdk ubuntu package on debian/sid as a temporary workaround (done)
  • update scripts to clean upstream sources for ide and platform for NB6.1 (done)
  • check what packages really require openjdk to build and what are ok to build with java-gcj-compat-dev and runtime java-gcj-compat | java1-runtime | java2-runtime
  • update /debian dir (patches, control, rules, links...)
  • prepare licences for platform and IDE
• ML packages (?)
• test new packages (QA) (concentrate at the external libs versions)
• ask for removal of the netbeans-ide and netbeans-platform packages from the contrib(if it is needed)
• create infrastructure for daily(?) builds(if it is needed)

Release schedule (lenny)

Early of June 2008 : Freeze of the non-essential toolchain
The "non-essential toolchain" means things like debhelper, cdbs and a big chunk of other things usually needed to produce binary packages.

End of June 2008 : Freeze of all library packages
This will affect all packages that produce library packages used by other packaged software. Packages without r-deps won't be frozen at this point.
Mid of July 2008 : Full freeze

September 2008 : Release lenny

Fedora

Initiated the work on getting into Fedora9 package repository:

• https://bugzilla.redhat.com/show_bug.cgi?id=439265
• https://bugzilla.redhat.com/show_bug.cgi?id=439262
• https://bugzilla.redhat.com/show_bug.cgi?id=439263

Planning on getting into Fedora 10 DVD / ISO image, needs to be in sync with Fedora10 release schedule

3rd party libraries

NetBeans IDE contains a lot of foreign JAR files, under various licenses. We should eliminate those that are not under OSI-approved ones (should be done by opensourcing JDK). For those that are under OSI, but under different license we need to find appropriate package or create it by ourselves. Indeed locations of JAR files in such packages are going to be at wrong places, so we need to create a symlink from usual NetBeans location to the actual JAR location. Also the NetBeans package that depends on the existence and validity of the symlink needs to have dependency on the package providing the symlink's original. Dependency is generally ok to specify just >= min.version.needed.by.netbeans, in most of the cases it should not matter that the actual version is a bit higher (e.g. ok to use jsch 1.30 even NetBeans does include jsch 1.28).

References

• heroic but not enough FOSS work on UbuntuPackagesForRelease55
• current Gentoo ebuild for Netbeans 6.0 (contains information about native linux packages, to find their homepages you can use Gentoo Online Package Database )
• Small IDE experiment

Attachments