Skip to content
Roland Praml edited this page Jun 16, 2015 · 3 revisions

CI-Build System

To run UnitTests on a CI server (a server where normally no Notes/Domino is installed) you need the Domino-Server binaries, a valid ID file and a names.nsf

To perform this task, ODA contains two modules: ci-setup and ci-env

ci-setup

This modules downloads and install the server binaries, so that the DominoJUnitTestRunner can run its test.

Due licensing issues, these binaries are not distributed and must be packed in a Zip-file

How to build the zip-file:

You need an installed domino. And of course, you need a license to use the binaries! You can try to run initial-build-win.bat in the root directory of the repository. This should find your Domino Installation, create the zip-file and should trigger a build automatically.

If you need a zip-file for a different platform you can create the Zip file yourself by following this instruction:

  1. Copy the following files and folders from your Domino Installation to a new directory:
  • *.dll
  • *.so
  • icudt34l.dat
  • *.tlb
  • N\
  • XmlSchemas\
  1. Zip the folder, so that the files above are in the root of the ZIP. Upload the ZIP and specify the download link:

mvn install -Ddomino.binary.url=<your-download-link>

(You may ask Roland to get his DropBox Link for a Linux64/Win64 zip file)

Now you should have the DominoServer-Binaries "installation" in $HOME\.m2\openntf-domino-ci\bin

ci-env

The ci-env module provides an own Domino-Domain to run unit-test against.

You should always run your unitTests against databases that are located in this environment, and NOT against databases that are stored only on your computer. So you can sure that the UnitTests will run also on other machines. You can provide additional nsfs by putting them in the nsfs folder. Zip files are automatically extracted.

Domain-Information:

  • Name of the domain: O=CI-DUMMY
  • Name of the Server-ID: CN=junit/O=CI-DUMMY
  • Certifier Password: openntf

TroubleShooting

If you do not get this working, you can use mvn install -Dskip.tests to skip all tests.