PHENOM Installation

This page details the requirements for an on-site installation of the PHENOM application. PHENOM is a web-application reached by users via a web browser. As such, it requires the setup of a web-server along with supporting packages and application code in an environment from which it can reach its intended users.

While Skayl is always happy to assist our customers’ use of PHENOM, we are not able to provide comprehensive IT support for every enterprise environment in which the application may be deployed. As such, the customer is responsible for the setup, configuration, and maintenance of the internal IT infrastructure from which they decide to serve PHENOM to users. The sections below will enumerate the basic requirements of such setup but should not be considered an exhaustive listing of the potential IT support needs of a system hosting PHENOM.

Information about PHENOM Maintenance can be found here.

Hardware Requirements

It is recommended that the machine running PHENOM be configured with at least the following hardware:

• 4 CPU cores
• 32 GB of RAM
• 200 GB of drive space

VM Deployment (Default)

PHENOM can be provided fully installed and ready-to-run in a pre-packaged virtual machine to be hosted within the customer’s infrastructure. The machine can be delivered in one of the following formats, as exported by VirtualBox:

• OVF 0.9
• OVF 1.0
• OVF 2.0

The operating system on the provided virtual machine can be any of the following:

• Debian 11
• RHEL 8
• RHEL 9

It is the customer’s responsibility to ensure that they can import a VM of the selected format into their virtualization system and configure it to connect to any necessary networks. After installation, it is also the customer’s responsibility to keep the operating system of the installed virtual machine maintained and updated in accordance with their enterprise’s security and IT policies.

Installer Deployment

Alternatively, Skayl can provide an installer bundle and Bash scripts that allow the customer to install PHENOM. The creation and provisioning of this installer may take several days, as it is configured and tested to deploy the latest version of PHENOM. Skayl can provide support for the initial installation process.

Setup Steps

• Initialize a new environment with one of the following operating systems:
  • Debian 11
  • RHEL 8
  • RHEL 9
• Create a `phenomadmin` user with “sudo” privileges.
• Extract the installer bundle in the `home/phenomadmin/` directory and navigate into the extracted directory.
• Execute the command `sudo bash vm_setup.sh`
  • When prompted, enter the password for the database that will maintain PHENOM user data on this machine.
  • Respond to any additional installer prompts. If you are unclear about one of them, contact the Skayl support team for guidance.
• If you experience errors, terminate the installation process, and send any error output to Skayl support.

Installation Environment

It is highly recommended that the environment be “bare” with only basic OS utilities installed and dedicated to serving only the PHENOM application. If this is not the case, Skayl may not be able to assist with configuration or debugging of packages required by PHENOM (e.g. Apache, MariaDB (mysql), etc.) which may be already present and configured or potentially used by other applications on the system.

Skayl cannot provide any support for the maintenance or configuration of the environment, whether internal virtualization environment or enterprise cloud provider (e.g. Microsoft Azure, AWS, etc.), that hosts the operating system running the PHENOM application or for the effects that environment has or requirements it imposes on the system running the PHENOM application.