Before installing BLADE or even OCCAS, you must perform certain steps. Please identify the [variables] to the right before proceeding.

Contents

Identify these installation parameters:

VariableExample
[occas_install_dir]/opt/oracle/occas/8.1
[admin_server]admin.blade.vorpal.net

This page contains notes on steps to be performed before installing Oracle Communications Converged Application Server (OCCAS) 8.1...

This tutorial assumes Oracle Linux 8/9, with a few tips for MacOS.

Concepts

OCCAS is a customized version of WebLogic which supports the SIP protocol. It runs as a cluster of servers, with a single Admin server and multiple Managed Node servers.

The very first step is to allocate servers for OCCAS to run on... Got it? Let's go!

The following steps should be performed on all nodes in the cluster...

Java 11

Warning: OCCAS does not work with OpenJDK. You must download the official version of Java from Oracle directly. Do not worry, Java is included with the license for OCCAS.

OCCAS 8.1 will run on either Java 8 or Java 11. Let's install Java 11.

Download and install the latest version of Java 11 from Java SE 11 Archive Downloads.

sudo dnf -y install jdk-11.0.25_linux-x64_bin.rpm

Database Preinstall

Although we will not be installing the Oracle database, there is a handy package that creates the 'oracle' user, installs all the required X11 packages and tunes the kernel parameters.

Warning: The Database Preinstall only supports Oracle / RHEL Linux. Other variants like Amazon Linux 2023 are not supported and you will have to perform these operations manually.

Automatic

Download and install the latest Oracle Database Preinstall RPM package from Oracle's YUM server (AppStream).

sudo dnf -y install oracle-database-preinstall-23ai-1.0-2.el9.x86_64.rpm

Manual

If you cannot install the database preinstall, follow these steps:

sudo groupadd -g 54321 oinstall
sudo useradd -u 54321 -g oinstall -G wheel oracle
sudo passwd oracle

OCCAS

For OCCAS 8.1, do not download from eDelivery. Instead, download the patches from My Oracle Support (Support for Oracle Hardware, Software, and Managed Cloud). Patch 35908669 Oracle Communications Converged Application Server 8.1.0.0.0 (Patchset) contains a new installer.

From edelivery.oracle.com search on "Oracle Communications Converged Application Server".

Add the latest version (DLP) your download queue and continue...

X11

To use the GUI installation and configuration wizards, make sure to have X11 configured on the AdminServer. (It is not necessary to configure it on the managed node servers.)

If you are installing on a remote Linux server follow these recommendations:

sudo yum install xorg-x11-xauth xorg-x11-utils xterm

Turn on X11Forwarding in file: /etc/ssh/sshd_config.

X11Forwarding yes

Restart the SSH daemon.

sudo systemctl restart sshd

Connect to the admin server remotely via SSH using the "-Y" option for X11 support.

ssh -Y oracle@[admin_server]

After logging in, if the system complains about no .Xauthority file, go ahead and make one:

touch ~/.Xauthority

Firewall

Assuming you have a firewall, we will need to open some ports...

sudo firewall-cmd --permanent --add-service={snmp,nfs,sip,sips}
sudo firewall-cmd --permanent --add-port=7001/tcp               # http
sudo firewall-cmd --permanent --add-port=7002/tcp               # https
sudo systemctl restart firewalld

Congratulations! You are now ready to go on to Installation.