[opencms-dev] How to build from source?

[Roland Turner]

I've attempting to track down the ArrayIndexOutOfBoundsException that I described earlier.

It seems that the exception is being thrown by ocsetup.check_versions_1 which is not a source file, but is auto-generated somewhere. I am therefore attempting to perform a successful build, but can't find build instructions anywhere. I guessed that "ant" might do it, but it does not. At the very least, several additional libraries appear to be needed for ../ExternalComponents. Several of these were in the opencms.war file, servlet.jar was in Tomcat, after some poking around I realised that classes12.zip was a JDBC driver from Oracle and after even more looking about discovered that FOP was part of xml.apache.org and downloaded and installed the current version (0.20.1). I now get the error messages below.

I have three questions:

- Are there known-to-work initial build instructions somewhere? Failing that:
- What is the correct version of FOP?
- Is there anything else that I need to know in order to build opencms?

Thanks.

- Raz

--

E:\dev\opencms\opencms\build.xml:72: Compile failed, messages should have been provided.

Total time: 1 minute 3 seconds
E:\dev\opencms\opencms>ant
Buildfile: build.xml

prepare:

compileclasses:
    [javac] Compiling 2 source files to E:\dev\opencms\build\classes
    [javac] E:\dev\opencms\opencms\src\com\opencms\launcher\CmsPdfLauncher.java:145: Method setWriter(java.io.PrintWrite
r) not found in class org.apache.fop.apps.Driver.
    [javac]             driver.setWriter(new PrintWriter(out));
    [javac]                             ^
    [javac] E:\dev\opencms\opencms\src\com\opencms\launcher\CmsPdfLauncher.java:146: Method buildFOTree(org.xml.sax.Pars
er, org.xml.sax.InputSource) not found in class org.apache.fop.apps.Driver.
    [javac]             driver.buildFOTree(parser, source);
    [javac]                               ^
    [javac] E:\dev\opencms\opencms\src\com\opencms\launcher\CmsPdfLauncher.java:147: Method format() not found in class
org.apache.fop.apps.Driver.
    [javac]             driver.format();
    [javac]                          ^
    [javac] E:\dev\opencms\opencms\src\com\opencms\launcher\CmsPdfLauncher.java:148: No method matching render() found i
n class org.apache.fop.apps.Driver.
    [javac]             driver.render();
    [javac]                          ^
    [javac] Note: E:\dev\opencms\opencms\src\com\opencms\launcher\CmsPdfLauncher.java uses or overrides a deprecated API
.  Recompile with "-deprecation" for details.
    [javac] 4 errors, 1 warning

BUILD FAILED

E:\dev\opencms\opencms\build.xml:72: Compile failed, messages should have been provided.

Total time: 7 seconds
E:\dev\opencms\opencms>