This page provides instructions on how to install the Caplin Deployment Framework, which you can then use to deploy Liberator, Transformer, and integration adapters.
The Deployment Framework 7 has the following requirements.
The Deployment Framework requires a Bash environment with the following specifications:
The Deployment Framework is tested on the following operating systems:
Java runtime environment
If your deployment includes Java DataSources, Java DataSource-modules, or uses JMX monitoring, then your deployment requires a compatible Java runtime environment (JRE).
For information on JRE compatibility, see Caplin Platform System Requirements.
For guidance on installing a JRE on RHEL, Windows, and macOS, see Installing Java.
Installing the Deployment Framework
Follow the steps below to install the Deployment Framework:
Open a Bash terminal. On Windows, open a Cygwin terminal or a Git Bash terminal.
Copy the Deployment Framework installation kit (
DeploymentFramework-<version>.zip) to the directory you want to install to.
On Microsoft Windows, to avoid exceeding the Win32 API’s maximum path length of 259 characters, install to a directory with a path of no more than 20 characters in length.
unzipcommand to extract the Deployment Framework installation kit:RHEL and macOS
$ unzip -qoa DeploymentFramework-<version>.zipGit Bash
$ MSYS=winsymlinks:lnk unzip -qoa DeploymentFramework-<version>.zipCygwin
$ CYGWIN=winsymlinks:lnk unzip -qoa DeploymentFramework-<version>.zip
On Windows, always extract the Deployment Framework using the appropriate Cygwin or Git Bash command above. The
unzipcommand preserves symlinks in the Deployment Framework installation kit and the
CYGWIN=winsymlinks:lnkenvironment variables ensure that the symlinks are implemented as Windows shortcuts (required by Windows builds of Liberator and Transformer).
Change directory to the root directory of the extracted deployment framework:
$ cd DeploymentFramework-<version>
dfw javacommand to specify the full path of a JVM library that Liberator and Transformer can use to host Java modules and publish JMX monitoring data. For guidance on JRE compatibility with Caplin Platform components, see Caplin Platform System Requirements.Example: RHEL 7 with the Red Hat OpenJDK 11
$ ./dfw java "/etc/alternatives/java_sdk_11/lib/server/libjvm.so"Example: RHEL 7 with the Red Hat OpenJDK 8
$ ./dfw java "/etc/alternatives/java_sdk_1.8.0/jre/lib/amd64/server/libjvm.so"
On Cygwin or Git Bash, specify a Windows file path, not a Bash file path. You can use backslashes (
\) or forward slashes (
/) as directory separators.Example: Windows with the AdoptOpenJDK 126.96.36.199
$ ./dfw java "C:/Program Files/AdoptOpenJDK/jdk-188.8.131.52-hotspot/bin/server/jvm.dll"
[optional] Enable Bash auto-completion for the
dfwcommand. See Setting up dfw command completion.
This step sets an environment variable that is required for the correct operation of the