Revision as of 00:25, 17 July 2009

This document describes building OpenOffice.org on Linux.

Requirements

Hardware Requirements

• 1 or more reasonable fast CPUs, x-way CPU's recommended.

• 1 GB Ram ( 2 GB recommended )

• 10 GB free disk space

Software Requirements

• glibc:
  • for OOo<=3.1: 2.2.x or higher
  • for OOo>3.1: 2.3.2 or higher

• C/C++ Compiler
  • gcc >= 3.3
  • current reference compiler gcc 4.2.3

• The X11 development libraries and header files¹.

• PAM including the development headers².

• bash³.

• The gpc general polygon clipper library release 2.31, located at http://www.cs.man.ac.uk/aig/staff/alan/software/. Download and unpack the tarball. You should have the files gpc.c and gpc.h in $SRC_ROOT/external/gpc.

• gtk2 and libtiff including the development headers⁴.

Cheatsheet

This section is meant as a reminder or checklist for those who have some experience in building OpenOffice.org.

You are advised to check the release notes for the release you are building to inform yourself about changes since previous releases.

$SRC_ROOT will denote the directory in which the source code of OpenOffice.org is stored.

Full Builds

To perform a full build, you need to follow these steps:

Configure

• Run the configure script to check all requirements. Run the following command to view all possible options.

./configure --help

An example configure command (on Ubuntu 9.04 with as much libraries by the system used as possible):

./configure --with-use-shell=bash --with-system-libs \
--without-system-jars --without-system-icu --without-system-agg \
--without-system-lpsolve --without-system-mspack --disable-mozilla

See the last information box in the configure script for more information for your platform.

Please check for any warnings emitted by the configure-script.

bootstrap

When configure finished successfully, run:

./bootstrap

to create the dmake executable required to build OpenOffice.org.

Setting the enviroment

When the configure script has been run successfully a file LinuxIntelEnv.Set.sh was created⁵. Do this:

source LinuxX86Env.Set.sh

to set up the enviroment for the build.

configure to build a ready-to-run installation (optinal)

To have the build create a ready-to-be-run installation for testing purposes, set the following environment variables⁶.

export LOCALINSTALLDIR="/my/Destination/Dir"
export PKGFORMAT="installed"

If you do not set PKGFORMAT, native packages (.deb/.rpm) will be build.

Starting the build

Build the software by typing the following in $SRC_ROOT⁷:

dmake

The building procedure will take several hours.

Rebuilding a module

To rebuild a module you can delete all output directories with, rebuild and redeliver into the solver with:</p>

cd $MODULE
rm -rf unxlngi6.pro
build && deliver

(The directory name might be slightly different: 64-bit Linux is unxlngx6.pro for example)

Partitial rebuild

If you decide to rebuild a module in an incompatible way, you will need to rebuild all modules depending on it (directly or indirectly)

cd $SRC_ROOT/instsetoo_native
build --from $INCOMPATIPLEMODULE --prepare
build --from $INCOMPATIBLEMODULE

The build process started with build --all in $SRC_ROOT/instsetoo_native will create an installation set in English. A simple build in $SRC_ROOT/instsetoo_native will also create the installation sets, provided all other modules are already built⁸.

Building module with Debug Information

To rebuild a module with debug information and additional assertions and checks, run:

cd $MODULE
build --from $MODULE --prepare # removes old output trees and solver
build --from $MODULE

For details, see Debugging

Finding Installation Sets

The english installation set will be located at $SRC_ROOT/instsetoo_native/unxlngi6.pro/OpenOffice/{deb,rpm,archive}/install/en-US/⁹.

Tips

Note that using ccache can reduce your compile times and dramatically reduce recompile times.

Footnotes

¹Should be in place with most Linux distributions. Note the there are currently some issues with X version 4.3.

²PAM should be installed by default on most linux distributions. You should only need to add the development package.

³You can also (still?) use tcsh instead of bash, but bash is installed almost everywhere anyway. It is possible to use bash or tcsh as shell. This is switched with the --with-use-shell configure switch.

⁴Unless you disable the crash-reporter when running ./configure.

⁵When you want to use tcsh instead of bash, you will need to use the file LinuxX86Env.Set instead:

source LinuxX86Env.Set
rehash

If you do not use tcsh, it is better to delete that file, as it will get in the way for tab-completion sooner or later.

⁶Alternativly you can set:

export FORCE2ARCHIVE=true

This will create a tarball that can easily be unpacked and run anywhere.

⁷You can also run:

make

but GNU/make will just start dmake. You can also run the following in the instetoo_native module:

build --all

For details run:

build --help

⁸build --all Would rebuild changed/missing files.

However, it does not check for incompatible modules. If unsure, use build --from --prepare.

⁹The en-US in the path names indicates that the localization is American English. This value corresponds to the language tags defined by RFC 1766 (Tags for the Identification of Languages). The German installation set will be located in a de subdirectory. This scheme holds true for all localizations you may have chosen explicitly (see Building Localized Versions of OpenOffice.org.

Running the configure script with the --with-lang option will introduce the build of additional language resources. This switch accepts one or more RFC 1766 language tags as arguments. Check the value of the completelangiso macro in $SRC_ROOT/solenv/inc/postset.mk for all the currently supported language tags.

Example:

./configure --with-lang="de fr"

This enables the build of the localized German and French version.

The environment variable WITH_LANG will then contain the language tags of the additional (en-US will always be build) languages.

If you build additional localized languages it is possible to generate Language Packs that contain only the changes needed to add the additional language to an OpenOffice.org of a different language.

The following commands will generate language packs languages that were specified with the --with-lang switch during the configure phase. Note that you can only build the language packs after you have build the complete office with all selected languages.

cd $SRC_ROOT/instsetoo_native/util
dmake ooolanguagepack