Update README.md Fix 2 links

L46 - change to equivalent Apache link
L339 - added "ttl" to end of link
-----
Things NOT FIXED:
L7 - Pref for Data and Prov - DEAD LINK
L199 - Incomplete sentence "This is the format
which will be used by"
1 file changed
tree: da4ff9f81b316fc685d897725db51866a30c2359
  1. src/
  2. taverna-activity-archetype/
  3. taverna-activity-test-utils/
  4. taverna-capability-api/
  5. taverna-capability-impl/
  6. taverna-credential-manager-api/
  7. taverna-credential-manager-impl/
  8. taverna-database-configuration-api/
  9. taverna-database-configuration-impl/
  10. taverna-dataflow-activity/
  11. taverna-execution-api/
  12. taverna-execution-hadoop/
  13. taverna-execution-impl/
  14. taverna-execution-local/
  15. taverna-execution-remote/
  16. taverna-observer/
  17. taverna-prov/
  18. taverna-prov-owl-bindings/
  19. taverna-provenanceconnector/
  20. taverna-reference-api/
  21. taverna-reference-impl/
  22. taverna-reference-testhelpers/
  23. taverna-reference-types/
  24. taverna-report-api/
  25. taverna-run-api/
  26. taverna-run-impl/
  27. taverna-services-api/
  28. taverna-services-impl/
  29. taverna-stringconstant-activity/
  30. taverna-workflowmodel-api/
  31. taverna-workflowmodel-extensions/
  32. taverna-workflowmodel-impl/
  33. .gitignore
  34. .travis.yml
  35. DISCLAIMER
  36. LICENSE
  37. NOTICE
  38. pom.xml
  39. README.md
README.md

Apache Taverna Engine

Workflow engine for Apache Taverna (incubating).

The engine executes a Taverna workflow, defined using Apache Taverna Language.

Note that the engine does not include the activity implementations that actual perform work (e.g. calling a REST service). To use the engine, use the Apache Taverna Command Line or Apache Taverna Server.

All Taverna Engine modules are also valid OSGi bundles, providing OSGi services.

License

  • (c) 2007-2014 University of Manchester
  • (c) 2014-2016 Apache Software Foundation

This product includes software developed at The Apache Software Foundation.

Licensed under the Apache License 2.0, see the file LICENSE for details.

The file NOTICE contain any additional attributions and details about embedded third-party libraries and source code.

Contribute

Please subscribe to and contact the [dev@taverna](http://taverna.incubator.apache.org/community/lists#dev mailing list) for any questions, suggestions and discussions about Apache Taverna.

Bugs and feature plannings are tracked in the Jira Issue tracker under the TAVERNA component Taverna Engine. Feel free to add an issue!

To suggest changes to this source code, feel free to raise a GitHub pull request. Any contributions received are assumed to be covered by the Apache License 2.0. We might ask you to sign a Contributor License Agreement before accepting a larger contribution.

Disclaimer

Apache Taverna is an effort undergoing incubation at the Apache Software Foundation (ASF), sponsored by the Apache Incubator PMC.

Incubation is required of all newly accepted projects until a further review indicates that the infrastructure, communications, and decision making process have stabilized in a manner consistent with other successful ASF projects.

While incubation status is not necessarily a reflection of the completeness or stability of the code, it does indicate that the project has yet to be fully endorsed by the ASF.

Prerequisites

  • Java 1.8 or newer (tested with OpenJDK 1.8)
  • Apache Maven 3.2.5 or newer (older versions probably also work)

Building

To build, use

mvn clean install

This will build each module and run their tests.

Skipping tests

To skip the tests (these can be time-consuming), use:

mvn clean install -DskipTests

If you are modifying this source code independent of the Apache Taverna project, you may not want to run the Rat Maven plugin that enforces Apache headers in every source file - to disable it, try:

mvn clean install -Drat.skip=true

Modules

The Taverna Engine modules are generally split into -api and -impl. -api contain Java interfaces and abstract classes and minimal dependencies, while -impl contain the corresponding implementation(s).

Thus, the taverna-common-activities should only need to depend on the -api modules, while the -impl are added by the packaging of the taverna-commandline-product.

These modules include utilities used by the above, or for test purposes:

These modules include structural workflow activities:

See the separate release of taverna-common-activities for activities that invoke Beanshell, WSDL, REST and command line tool services.

These modules are experimental:

These modules are not yet fully updated to Taverna 3 (contributions welcome!):

See the taverna-engine JavaDoc for more details.

Which module does what?

This section shows how different Taverna Engine module are involved when running a Taverna workflow, e.g. from the Apache Taverna Command Line.

There are two layers of Taverna Engine:

  • Apache Taverna Platform provides an outer API for creating and managing workflow runs, potentially remotely.
  • Apache Taverna Core (aka workflowmodel, formerly t2.core) is the orchestrating part of the Taverna Engine. It's Activity is implemented by multiple plugins depending on the activity type.

Preparations

  • (Optional) choose a Workflow to bind workflows (usually the main workflow)
  • (Optional) choose a Profile to bind workflow implementations (there's normally only one profile)

Running a workflow

Spring services

The OSGi services should be discoverable as Spring services, e.g. by adding to your META-INF/spring/update-context-osgi.xml:


<beans:beans xmlns="http://www.springframework.org/schema/osgi" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:beans="http://www.springframework.org/schema/beans" xsi:schemaLocation=" http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans.xsd http://www.springframework.org/schema/osgi http://www.springframework.org/schema/osgi/spring-osgi.xsd"> <reference id="executionService" interface="org.apache.taverna.platform.execution.api.ExecutionService"/> <reference id="runService" interface="org.apache.taverna.platform.run.api.RunService"/> <reference id="credentialManager" interface="org.apache.taverna.security.credentialmanager.CredentialManager" /> <reference id="databaseConfiguration" interface="org.apache.taverna.configuration.database.DatabaseConfiguration" /> <reference id="databaseManager" interface="org.apache.taverna.configuration.database.DatabaseManager" /> </beans:beans>

You might want to combine these with the Taverna OSGi services.

Export restrictions

This distribution includes cryptographic software. The country in which you currently reside may have restrictions on the import, possession, use, and/or re-export to another country, of encryption software. BEFORE using any encryption software, please check your country's laws, regulations and policies concerning the import, possession, or use, and re-export of encryption software, to see if this is permitted. See http://www.wassenaar.org/ for more information.

The U.S. Government Department of Commerce, Bureau of Industry and Security (BIS), has classified this software as Export Commodity Control Number (ECCN) 5D002.C.1, which includes information security software using or performing cryptographic functions with asymmetric algorithms. The form and manner of this Apache Software Foundation distribution makes it eligible for export under the License Exception ENC Technology Software Unrestricted (TSU) exception (see the BIS Export Administration Regulations, Section 740.13) for both object code and source code.

The following provides more details on the included cryptographic software: