Skip to content

Compile

Jump to bottom
Rainer Sulzbach edited this page Sep 17, 2021 · 10 revisions

Clownfish - compile

You can compile the Clownfish Content Management Server by cloning the source code from github.

Prerequisites:

Download and install

Make sure that the installation sets the PATH variable correctly. You can check this by opening a terminal and type following commands:

javac -version
mvn -version
git --version

Each command must response with the version number.

Clone the recent repository with the following command to your local file system:

git clone https://github.com/rawdog71/Clownfish.git

Move to the Clownfish\clownfish folder. Check that there is a pom.xml file.

To get the compilation done, there are two more prerequisites to be done. The Maven repository is missing two jar dependencies, that can not be downloaded automatically. These are the Oracle JDBC driver and the SAP Java Connector library. You have to download them manually by yourself and integrate them to your local Maven repository.

Oracle JDBC driver

Download the specific JDBC driver (ojdbc8.jar) from the Oracle site (you have to register an account at Oracle) https://www.oracle.com/database/technologies/appdev/jdbc-downloads.html and integrate it to your local Maven repository. Clownfish uses version 19.3 with JDK8 support JDBC driver.

To manually integrate it to your local Maven repository use following bash command:

mvn install:install-file -Dfile=path/to/your/ojdbc8.jar -DgroupId=com.oracle -DartifactId=ojdbc8 -Dversion=19.3 -Dpackaging=jar

IMPORTANT: check the local Maven repository that the filename is ojdbc8-19.3.jar. The version number MUST be included. Otherwise the build will fail.

SAP Java Connector

Download the specific library from the SAP download site https://support.sap.com/en/product/connectors/jco.html and integrate it to your local Maven repository (you have to be a registered SAP developer). Clownfish uses version 3.8.

To manually integrate it to your local Maven repository use following bash command:

mvn install:install-file -Dfile=path/to/your/SAPJco-3.8.jar -DgroupId=SAPJco -DartifactId=SAPJco -Dversion=3.8 -Dpackaging=jar

Compilation

Check the pom.xml file that the packaging is set to war. If it is set to jar, then it is for debugging in an IDE.

<groupId>io.clownfish</groupId>
<artifactId>clownfish</artifactId>
<packaging>war</packaging>

Execute the following command in the terminal.

mvn install

The war file is written to the target folder.

After your build is completed you have to Initialize some local folders for your Clownfish setup.

Clone this wiki locally