A package of cool services for webMethods Integration Server 7.1 and higher.

Refer to the SERVICES.md file for detailed descriptions of all services provided by the package.

You have two choices for installing Tundra:

• zip
• git

If you are comfortable using git, I recommend this method as you can then easily switch between package versions using git checkout and download new versions using git fetch.

1. Download a pre-built zip of the desired version of the package from the available releases.
2. Copy the Tundra-vn.n.n.zip file to your Integration Server's ./replicate/inbound/ directory.
3. Install and activate the package release Tundra-vn.n.n.zip from the package management web page on your Integration Server's web administration site.
4. Restart Integration Server to complete the installation.

To install with this method, first make sure that:

• Git is installed on your Integration Server.
• Your Integration Server has internet access to https://github.com (for cloning the repository).
• The dependent packages listed above are installed and enabled on your Integration Server.
• You have identified what version of Tundra you'd like to install by referring to the available releases.

From the root directory of your Integration Server installation or instance in which you want to install:

$ cd ./packages/
$ git clone https://github.com/Permafrost/Tundra.git
$ cd ./Tundra/
$ git reset --hard v<n.n.n> # where <n.n.n> is the required version

Then restart Integration Server to complete the installation.

When upgrading you have to choose the same method used to originally install the package. Unfortunately, if git wasn't used to install the package then you can't use git to upgrade it either. However, if you want to switch to using git to manage the package, delete the installed package and start over using the git method for installation.

1. Download a pre-built zip of the desired updated version of the package from the available releases.
2. Copy the Tundra-vn.n.n.zip file to your Integration Server's ./replicate/inbound/ directory.
3. Install and activate the package release Tundra-vn.n.n.zip from the package management web page on your Integration Server's web administration site.
4. Restart Integration Server to complete the installation.

To upgrade with this method, first make sure that:

• Git is installed on your Integration Server.
• Your Integration Server has internet access to https://github.com (for fetching updates from the repository).
• The dependent packages listed above are installed and enabled on your Integration Server.
• You have identified what version of Tundra you'd like to upgrade to by referring to the available releases.
• You originally installed Tundra using the git method described above.

From the root directory of your Integration Server installation or instance in which you want to install:

$ cd ./packages/Tundra/
$ git fetch
$ git reset --hard v<n.n.n> # where <n.n.n> is the desired updated version

Then restart Integration Server to complete the upgrade.

1. All input and output pipeline arguments are prefixed with $ as a poor-man's scoping mechanism, since typically user-space variables are unprefixed.
2. All boolean arguments are suffixed with a ?.
3. Single-word argument names are preferred. Where multiple words are necessary, words are separated with a ..
4. Service namespace is kept flat. Namespace folders are usually nouns. Service names are usually verbs, indicating the action performed on the noun (parent folder).
5. Services declare all inputs and outputs (except where deprecated), always explicitly marked as optional or required, use constrained types where possible, and enable input and output pipeline validation where possible, to minimise surprise.
6. Services often declare their inputs as optional, and either apply an appropriate default value, or take no action and return no output (whatever is more appropriate), to minimise the need for existence checking in flow map steps.
7. All private elements are kept in the tundra.support folder. All other elements comprise the public API of the package. As the private elements do not contribute to the public API, they are liable to change at any time. Enter at your own risk.

Tundra is compiled for Java 1.6, and is dependent on the following webMethods Integration Server packages:

• WmFlatFile
• WmPublic
• WmRoot

Tundra is also dependent on the following open source Java libraries, which provide the underlying implementation for the majority of services, and are included in the Tundra package as JAR files in the following locations:

• ./code/jars/commons-collections4-4.1.jar - https://commons.apache.org/proper/commons-collections/
• ./code/jars/commons-compress-1.12.jar - https://commons.apache.org/proper/commons-compress/
• ./code/jars/commons-csv-1.4.jar - https://commons.apache.org/proper/commons-csv/
• ./code/jars/hjson-2.1.1.jar - https://github.com/Permafrost/hjson-java
• ./code/jars/htmlcompressor-1.5.3.jar - http://htmlcompressor.googlecode.com
• ./code/jars/jakarta-oro-2.0.8.jar - http://archive.apache.org/dist/jakarta/oro/
• ./code/jars/javax.json-1.0.jar - https://jsonp.java.net
• ./code/jars/javax.mail-1.6.2.jar - https://javaee.github.io/javamail
• ./code/jars/jscience-4.3.1.jar - http://jscience.org
• ./code/jars/poi-3.17.jar - https://poi.apache.org/
• ./code/jars/poi-ooxml-3.17.jar - https://poi.apache.org/
• ./code/jars/poi-ooxml-schemas-3.17.jar - https://poi.apache.org/
• ./code/jars/snakeyaml-1.23.jar - http://www.snakeyaml.org
• ./code/jars/Tundra.jar - http://github.com/Permafrost/Tundra.java
• ./code/jars/TundraSAP.jar - http://github.com/Permafrost/TundraSAP.java
• ./code/jars/unbescape-1.1.6.RELEASE.jar - http://www.unbescape.org/
• ./code/jars/xmlsec-1.5.8.jar - http://santuario.apache.org

1. Check out the latest master to make sure the feature hasn't been implemented or the bug hasn't been fixed yet.
2. Check out the issue tracker to make sure someone already hasn't requested it and/or contributed it.
3. Fork the project.
4. Start a feature/bugfix branch.
5. Commit and push until you are happy with your contribution.

Please try not to mess with the package version, or history. If you want your own version please isolate it to its own commit, so it can be cherry-picked around.

See also TundraTN, a package of cool services for webMethods Trading Networks 7.1 and higher.

Copyright © 2012 Lachlan Dowding. See the LICENSE.txt file for further details.