Webhook Server Install

Modified on Wed, 12 Jun at 9:30 AM

Ocelot Logo

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






Was this article helpful?

That’s Great!

Thank you for your feedback

Sorry! We couldn't be helpful

Thank you for your feedback

Let us know how can we improve this article!

Select at least one of the reasons
CAPTCHA verification is required.

Feedback sent

We appreciate your effort and will try to fix the article