This document refers to older versions of OpenOffice.org only. If you intend to build the snapshot No. 638 or later, go here!
This document describes the requirements and actions that you need to build OpenOffice.org on Linux. Commands you have to type on the keyboard follow this syntax throughout this document:
config_office> ./configure
In this example,
the script configure
is executed in the directory config_office
.
$SRC_ROOT
will denote the directory in which
the source code of OpenOffice.org is stored.
All those who have done a build of OpenOffice.org before may use this section as a reminder. You are well advised to check the release notes at www.openoffice.org/dev_docs/source/download.html and the section Build Requirements in this document to inform yourself about changes since the previous releases.
Detailed step-by-step build descriptions are given from the next section on.
You can perform a full build, or you can build an individual project using a prebuild version.
To perform a full build, you need to follow these steps:
configure
script to check all requirements and
to create the script
LinuxIntelEnv.Set
.
LinuxIntelEnv.Set
script to set all environment variables.
bootstrap
(unless you
want to build the 613 or an earlier version for which the build
tools are already provided in the source).
dmake
tool.
You can use a prebuild version to build an individual project. Having a prebuild version is neccessary because the individual project you want to build could depend on other projects. A project builds a particular component of OpenOffice.org. For example, the Word Processing project builds the Word Processing application. To build an individual project, you must follow these steps:
solver614_linux_intel.tar.gz.
res
, check
out this module also.
You can, of course, also download the entire source from the download webpage
(www.openoffice.org/dev_docs/source/get_tarballs.html).
However, it is not possible to
download individual modules there.
config_office
. This is always
necessary to create the build environment.
dmake, external, xml2cmp,
mkdepend
(from 625 on), sal,
vos, tools and rscpp
. These are required by bootstrap
(see below). They are not needed for builds 613 or earlier for which
the build tools are provided in solenv
.
configure
script to check all requirements and
to create the script LinuxIntelEnv.Set
.
LinuxIntelEnv.Set
to set all environment variables.
bootstrap
(unless you
want to build the 613 or an earlier version for which the build
tools are provided in the solenv
module).
solver
using the dmake
tool.
Before you start building, you must ensure that your system satisfies the recommended software and hardware requirements for the type of system you are working on. For Linux, these are as follows:
Software Requirements
glibc
2.1.x or higher
gcc
2.95.2
csh
zip
$SRC_ROOT/external/gpc
.
javac
is in
your PATH variable.
The data base will consist in a directory
structure (db3.1.17
) including a subdirectory
java/classes
. Go there and
create a java archive
(jar
command) called db.jar
(db31.jar for older releases) and place this
into the external/common
directory:
db3.1.17> cd build_unix db3.1.17/build_unix> ../dist/configure --enable-java --enable-dynamic db3.1.17/build_unix> make db3.1.17/build_unix> cd ../java/classes db3.1.17/java/classes> jar cvf db.jar * db3.1.17/java/classes> mv db.jar $SRC_ROOT/external/common/.From 632 on, all necessary components of the Berkeley DB are included in the OpenOffice.org source.
Hardware Requirements
The code contains some further external components which are
already provided. If you are interested in details about these,
look at the External Components webpage at
http://tools.openoffice.org/ext_comp.html.
You have two options to get the source code:
oo_609_src.tar.gz
in case
of the 609 release.
There is a second source tarball called
solenv
containing the build tools
for some early versions.
This tarball has become obsolete with the introduction of the
bootstrap
utility (explained later) which creates those
build tools. However, if you want to build an early version, you have
to download this tarball as well.
Unpack the tarballs as follows (for the example 609):
> gunzip oo_609_src.tar.gz > tar -xvf oo_609_src.tar > cd oo_609_srcThis will be $SRC_ROOT from now on.
solenv
tarball:
$SRC_ROOT> gunzip solenv609_linux_intel.tar.gz $SRC_ROOT> tar -xvf solenv609_linux_intel.tar
anoncvs
:
> runsocks cvs -d:pserver:anoncvs@anoncvs.openoffice.org:/cvs login > cd $SRC_ROOT $SRC_ROOT> runsocks cvs / -d:pserver:anoncvs@anoncvs.openoffice.org:/cvs / co -r OpenOffice609 openofficeThe non-bold slash means that the command should be in one line. It is possible to update an already existing older copy to a newer release:
$SRC_ROOT> runsocks cvs / -d:pserver:anoncvs@anoncvs.openoffice.org:/cvs / update -r OpenOffice609 openoffice
$SRC_ROOT> runsocks cvs / -d:pserver:anoncvs@anoncvs.openoffice.org:/cvs / co -r OpenOffice609 (module-name)
You use the configure
script to generate the build environment.
The configure
script
checks that all software, hardware, and system requirements for the build
are satisfied, and it
creates a configuration file called
LinuxIntelEnv.Set
that you then run the source
command
on to set all necessary build environment variables.
This configuration file will be moved into the SRC_ROOT
directory. A top-level makefile script makefile.rc
and the script bootstrap
in the
config-office
directory will be moved into SRC_ROOT
as well. This is due to technical reasons: The SRC_ROOT
directory
in the cvs tree can only hold directories. On the other hand, the
top-level makefile.rc
should logically be placed in the
top-level directory SRC_ROOT
. The cvs tree holds these files in
config_office
and configure
copies them up.
In case you adjust the sample file winenvsample.bat
to your
needs rather then running the configure script, you have to copy it by
hand to SRC_ROOT
and name it winenv.bat
.
Copying the file makefile.rc
from $SRC_ROOT/config_office
to
$SRC_ROOT
had to be done by hand as well in this case.
If you experiment with newest sources from the cvs-tree,
mind that updates to the
configure process do not happen via updates of configure
(the script file) but via the file configure.in
. The
configure script itself is created from configure.in
using the autoconf
command. In this case, you would
run commands like the following:
$SRC_ROOT> cd config_office config_office> cvs update configure.in config_office> ./autoconfto update the
configure
script. If you only use code
from the snapshot releases on the web, you don't need to be concerned
about this.
To run the configure
script, type the following commands:
$SRC_ROOT> cd config_office config_office> ./configure --with-stlport4-home=(path)where
path
is the absolute path pointing to your STLPort
installation. configure
will probably also ask you for
the location of the Java Development Kit 1.2.2.
There are a number of further options that you can use with the
configure
script. To display these options, type the following command:
config_office> ./configure --help
The option --with-stlport4-home
is a requirement.
For more information on the options that you can use with the
configure
script, see the Build Environment document at
tools.openoffice.org/build_env.html.
After running configure
, you have to source the configuration
file with sets all environment variables:
$SRC_ROOT> tcsh $SRC_ROOT> source LinuxIntelEnv.Set
To create the build tools, type the following command:
$SRC_ROOT> ./bootstrap
The bootstrap
utility creates the tools required for building.
This involves already building some modules and will take a few minutes.
$SRC_ROOT> dmakeIf you are interested in the order in which the individual modules are build, type
$SRC_ROOT> dmake -n
The following table shows the time required to build on a system with a particular specification. You can use these details to estimate the time required to build on your system.
Architecture | Intel |
Processor | Pentium III |
Processor speed | 600 MHz |
RAM | 256 MB |
Hard disk size | 2 GB IDE |
Time | ~12 h |
OpenOffice.org is organised in several projects. For example, the Word Processing Project. These in turn consist of several modules, organised in separate directories. The source contains approximately 90 modules.
You can build any project or module individually. Building modules
individually should not be misunderstood as reducing OpenOffice.org to a
special application, say, for instance, the spreadsheet application. The
program will always consist in the entire office suite: text processor,
spreadsheet, drawing application etc.. Building individual
modules comes in handy if you want to develop on a certain module.
Most modules will
depend on other modules to be already built. In other words, all modules
must build in a particular order.
To avoid building all modules which are prerequisites of the
module of your interest,
you can make use of a pre-build solver
tree
against which you can build any module.
For more information on modules and on the sequence that they build in, and on the dependencies, see tools.openoffice.org/modules.html.
You have to download the
solver
tree as a tarball
solver609_linux_intel.tar.gz
from the Download page at
www.openoffice.org/dev_docs/source/get_tarballs.html
and unpack it in the $SRC_ROOT
directory:
$SRC_ROOT> gunzip solver609_linux_intel.tar.gz $SRC_ROOT> tar -xvf solver609_linux_intel.tarIn order to create the build environment and build tools (bootstrap), you also have to check out the modules
config_office, dmake, external, xml2cmp,
mkdepend
(from 625 on), sal, vos, tools and rscpp
.
Except for config_office
,
they are not needed for builds 613 or earlier for which
the build tools are provided in solenv
.
To build a project, you build each of its modules individually
in their directory with the dmake
tool.
$SRC_ROOT/(module-name)> dmakeFiles called
makefile.rc
in each directory with further
subdirectories iterate through all directories of the module and exectues
dmake
in each of them (just like the top-level
makefile.rc
does when building the entire office suite).
The last or second to last directory is usually
module-name/util
which is responsible for linking one or more shared libraries.
To rebuild a complete project with debug information, remove all object
files by removing the
unxlngi3.pro
directory. Then run
dmake
with the debug option set to true:
$SRC_ROOT/(module)> rm -rf unxlngi3.pro $SRC_ROOT/(module)> dmake debug=true
When you have completed the build, you need to do the following to install and set up the office suite:
dmake install
command,
or run dmake
in the directory instsetoo
:
$SRC_ROOT> dmake installor
$SRC_ROOT> cd instsetoo instsetoo> dmakeLanguages other than english (provided the language option was set in configuring) can be build with the option
LANGEXT
.
For instance for french:
$SRC_ROOT/instsetoo> dmake LANGEXT=33The parameter 33 stems from the international phone code for France.
$SRC_ROOT/instsetoo/unxlngi3.pro/normal
and execute the setup
binary:
$SRC_ROOT> cd instsetoo/unxlngi3.pro/normal normal> ./setup