Website Monitoring Setup (drupal 7^)

The reason for segregating a different tutorial for setting up Orion Module for "drupal 7" site is because it uses old & potentially deprecated modules, and is often non-composer managed, for that matter, we will manually download the extension's file and put that in the /public_html/modules/custom and the remainder of the installation process will be the exact same as that of the "drupal 8/9/10" site.

info

Except for "Installing Dependency Module", the remainder steps "Configuring the Extension / Orion Setting" and "Exporting Configuration" will be identical to "drupal 8/9/10" site.

Installing Dependency Module

As aforementioned, for drupal 7 and non-composer managed site, you will need to manually download the files. To do that you will need to proceed to the website for the "Vital" and "Health Check" module, and look for the most compatible version. For drupal 7 site, they are most likely to be listed at the bottom of the page, and is often marked to have vulnarbilities due to their deprecation.

• Drupal Custom Module - Vital
• Drupal Custom Module - Health Check

Then, proceed to CPanel, paste and extract the downloaded two files for "vital" and "health checker" moduels at location /public_html/modules/contrib.

Thirdly, to enable the module in the drupal backend, you will need to proceed to the website's extend tab, like the following shown:

Lastly, in CPanel again, you will need to ensure that your /public_html/.htaccess contains the two lines (anywhere in the file), then make a full cache clearing via the backend.

...
CacheDisable public /
CacheDisable private /
...

---

Configuring the Extension / Orion Setting

The previous steps will install the required module for the targeted website, in this section we will go through retriving the authentication token from the website, and configure the Orion Monitor. After configuration Orion Monitor will be able to access the website health status, php version, and out-dated modules via that token.

First, you will copy the authentication token from the "vital configuration" panel, for instance the site you want to monitor is "www.example.com" then you login the drupal backend via "www.example.com/user" and then visit "www.example.com/admin/config/services/vitals".

Second, you will need to configure the Orion Monitor, entering the website's name, Url, and the token we just copied, noting that the Url and token is crucial configuration, they has to be exact match with the target website.

Lastly check to see your site monitoring on active by visiting "https://opc.com.au/orion/security", you should be able to see an addition entry of your site active, and the timestamp refreshing, if the timestamp is not refresh, there is a issue connecting to the target site.

---

Exporting Configuration "orion.settings.yml"

The previous step of "changing orion setting" will make a modifification to the "configuration" of drupal site where the Orion Monitor is sitting on (aka the "opc.com.au" site), consequently, there will be a mismatch between the producation filebase and the development firebase. More specifically, the file config/sync/orion.settings.yml will be different on main, stage, and production branch, and if nothing is done, then at the next feature change, the new changes to this file will be overriden by old version.

info

To avoid that we will need to synchronize the changes to that config/sync/orion.settings.yml file to all the branches we have.

First, copy the changes we just made via the drupal backend

Then paste the changes to your main branch, and perform branch merging like you would usually do in development, aka, merging main to stage, then merging stage to prod.