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)

Install git and maven.

sudo yum -y install git maven

Download the BLADE source from GitHub.

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

Compilation

Configure the environment...

cd blade
./bootstrap.sh

Attempt to compile BLADE for the 1st time...

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.

The final results can be found in the 'dist' folder.

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 BLADE Console Application

Deploy the "vorpal-blade-admin-console.war" to the AdminServer.

Deploy Servlet Applications

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