Home

Awesome

MANUAL

The most recent version of the manual can be found online at https://www.bio.ifi.lmu.de/files/Software/Watchdog/Watchdog-manual.html and as HTML and PDF version in the documentation folder.

REQUIREMENTS

Watchdog is written in Java and requires JDK 11 or higher. Oracle provides an installation guide for Windows, Linux and macOS at https://docs.oracle.com/en/java/javase/11/install/overview-jdk-installation.html.

The GUI of the workflow designer and the moduleMaker depend on the JavaFX SDK 11 or higher. The JavaFX SDK is also included with Watchdog and located in jars/libs/modules/. This version is used by default. Alternatively, it can be obtained from https://gluonhq.com/products/javafx/. An installation guide is provided here: https://openjfx.io/openjfx-docs/.

INSTALLATION

In case of conda or docker installation, the binaries are named watchdog-cmd and watchdog-gui while the rest of the files are located in ${PREFIX}/share/watchdog-wms-${VERSION}.

BUILD WATCHDOG

Watchdog can be build from the source files using Maven. The command mvn downloads all dependencies into jars/libs and rebuilds the jar files.

RUN WATCHDOG

The distributed jar files are build for Java 11 and are called internally by the bash scripts. In order to run a xml-file using the command line tool, call

./watchdog.sh -x xml-file # (or java -jar jars/watchdog.jar -x xml-file)

To call the jar file directly is not recommended as CTRL+C signal will be forwarded to all child processes, which might cause errors on locally running tasks.

The workflow designer can be started using ./workflowDesigner.sh # (or java -jar jars/WatchdogDesigner.jar)

The workflow designer depends on the Javafx SDK 11 or higher. The bash script will try to identify the installation location of the Javafx SDK automatically.

JAR FILES

All jar files except moduleMaker.jar are available in the jars/ subdirectory of the Watchdog installation folder. The ModuleMaker is not shipped with Watchdog but can be obtained by running ./helper_scripts/downloadModuleMaker.sh located in the Watchdog installation directory. See https://github.com/watchdog-wms/moduleMaker/blob/master/README.md for more information.

More information on how to use these programmes can be found in the manual in section 6.

GETTING STARTED

Once Watchdog is correctly installed, you can run example workflows shipped with Watchdog. To configure them run ./helper_scripts/configureExamples.sh -i /path/to/install/folder/of/watchdog [-m your@mail-adress.com]. Afterwards, the example workflows are located in /path/to/install/folder/of/watchdog/examples and can be started using ./watchdog.sh -x path2/xml-file.xml.

More information on these example workflows can be found in the manual in section 3 and 4.

An introduction on how to analyse replicate data or how use the workflow designer (GUI) can be found in the documentation/ folder.

WATCHDOG COMMUNITY

Two repositories on Github under the watchdog-wms organization (https://github.com/watchdog-wms/) are dedicated for sharing modules and workflows by other users:

CONTACT

If you have any questions or suggestions, please feel free to contact me: michael.kluge@bio.ifi.lmu.de In case of bugs or feature requests, feel free to create an issues at https://github.com/klugem/watchdog/issues

LICENCE

Watchdog is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

Watchdog is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with Watchdog. If not, see http://www.gnu.org/licenses/.

Licenses of libraries Watchdog depends on can be found in jars/libs/.