Prerequisites

First download and install OCCAS.

Ensure your environment is using Java 11. OpenJDK will not work. You must use the official version supplied on Oracle's website.

java -version

java version "11.0.22" 2024-01-16 LTS
Java(TM) SE Runtime Environment 18.9 (build 11.0.22+9-LTS-219)
Java HotSpot(TM) 64-Bit Server VM 18.9 (build 11.0.22+9-LTS-219, mixed mode)

Ensure your environment has Apache Maven.

mvn -version

Apache Maven 3.9.9 (8e8579a9e76f7d015ee5ec7bfcdc97d260186937)
Maven home: /opt/homebrew/Cellar/maven/3.9.9/libexec
Java version: 11.0.22, vendor: Oracle Corporation, runtime: /Library/Java/JavaVirtualMachines/jdk-11.jdk/Contents/Home
Default locale: en_US, platform encoding: UTF-8
OS name: "mac os x", version: "14.5", arch: "aarch64", family: "mac"

Ensure your environment has Apache Ant.

ant -version

Apache Ant(TM) version 1.10.12 compiled on January 5 2022

Install Graphviz to generate the Javadocs with fancy UML diagrams.

sudo yum install graphviz

Download the BLADE source from GitHub.

git clone https://github.com/vorpalnet/blade.git

Compilation

Attempt to compile BLADE...

cd blade
ant

It will fail on the first try with this error:

WARNING! Please edit the newly created <hostname>.properties file, then run ANT again.

Edit the newly created properties file. It should have the same name as your computer's hostname.

OCCAS=/opt/oracle/occas/8.1

Run Ant again.

ant

Wow! Look at it go. You'll notice that Ant is invoking other Ant scripts which are in turn invoking Maven scripts.

Curious about what it's doing? Read the Q&A section down below.

Installation

Now it is time to install BLADE

FSMAR

The Finite State Machine Application Router (FSMAR) is a Java library that needs to be loaded into OCCAS to route calls to different applications.

To configure the FSMAR, place the .jar file in the domain's "approuter" and specify the filename in the Admin Console, under OCCAS >> App Router.

Edit the 'fsmar2.json' file in the domain's "config / custom / vorpal" directory.

Shared Libraries

Before installing any applications, install the "shared libraries" jar file on the cluster.

Deploy Applications

Deploy any applications you plan to use (Transfer, Proxy-Router, etc.) via the Admin Console.