This section of the user guide is focused on installing the webhook server for a Banner/PeopleSoft integration.

Normally Ocelot staff will work to configure and set up the local webhook server. 

Some clients want to learn more about the process and/or do this themselves. This document is a starting point to provide a high-level overview of webhook server setup.

The steps below SHOULD be performed as the Ocelot user (or whatever service account you’re using) without root/sudo access, except as noted. 

Your installation may result in slightly different version numbers than those displayed below - that is OK. 

They are shown for illustration purposes only.

nvm/node/npm/pm2/pnpm

1. SSH into VM
2. Install NVM (Node Version Manager)

   $ curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.1/install.sh | bash

   # verify installation by checking version

   $ nvm -v 
   0.39.1

   # install version 18 of node.js

   $ nvm install --lts

   # verify installation by checking version

   $ node -v
   18.14.0

   
   # install pnpm

   $ curl -o- https://get.pnpm.io/install.sh | bash

   The above will update .bashrc by default, but you may need to update .bash_profile depending on your version of Linux.
   
   # verify pnpm is installed by checking version

   $ pnpm -v
   7.29.1

   # install process manager 2

   $ npm install pm2 -g

   # verify installation by checking version

   $ pm2 -v
   5.1.2

   # Start pm2 (will create default dirs under ~/.pm2)

   $ pm2

   # set pm2 to start on boot:

   $ pm2 startup

   The above will output a command to be run as root (sudo) which, in turn, will create an
   entry under /etc/systemd/system/pm2-USERNAME.service which ensures pm2 is restarted when the server is rebooted.
   
   # install pm2 logrotate:

   $ pm2 install pm2-logrotate

   # set desired defaults for logrotate

   $ pm2 set pm2-logrotate:max_size 1M
   $ pm2 set pm2-logrotate:compress true
   $ pm2 set pm2-logrotate:rotateInterval "0 1 1 * *"

Oracle

Obtain packages from Oracle (alternatively, use a package repo you have available for server

distribution available) 

oracle-instantclient21.5-basic.x86_64

Check to ensure the libaio package has been installed.

After Oracle packages and libaio are installed, update ldconfig with the path where Oracle was installed (i.e., /opt/oracle, /usr/lib/oracle, or other, depending on where you installed instant client from). If you’re installing instant client from an RPM, DEB, or other package, the following step may be done for you.

For example:

sudo sh -c "echo /opt/oracle/instantclient_21_5 > \
        /etc/ld.so.conf.d/oracle-instantclient.conf"
sudo ldconfig