Skip to main content
Migration Notice
We're migrating documentation from the old portal into this one. Some things may look a little different or out of place in the meantime — we know, and we're working to get it right. If something's unclear or doesn't look right, let us know.

RHEL / CentOS DR Installation (Deprecated)

Deprecated installation path

RHEL DR is deprecated. The last supported version is Eyeglass 2.6.4 — no 2.9.0 build was produced for RHEL/CentOS, and RHEL 7 upgrade/OS support ended June 30, 2022. This page is retained for reference only and is not updated to reflect current releases. See Deprecation Notice - March 2024 for the full announcement.

Overview​

In addition to the standard OVA virtual appliance, Eyeglass offered an RPM installer that could be deployed directly onto a customer-provided RHEL or CentOS virtual machine. This installer option required a purchased RPM install license key (a trial key was available); the license was excluded from standard maintenance contracts and enterprise keys, and required contacting sales@superna.net.

System Requirements​

Operating system:

  • CentOS 8.x (as of Eyeglass 2.5.8.1)
  • Red Hat Enterprise Linux 8.x (as of Eyeglass 2.5.8.1)

The OS itself was not covered under the Superna support contract — OS patches and updates were the customer's responsibility.

Appliance requirements:

  • 4 vCPU
  • 16 GB RAM (increased per the standard Eyeglass scalability requirements)
  • 130 GB disk
  • Chrome browser (preferred); the browser must support WebSockets — Internet Explorer was not supported

Support Limitations​

The Eyeglass RPM installer bundled application software with tested and supported dependencies, including sudoer configuration and lighttpd. The yum package manager was not permitted to upgrade these components without a forced overwrite, and customers who forced an override of a supported package version owned the risk of breaking application functionality — Superna could ask a customer to downgrade if a forced override impacted functionality.

Package Dependencies (RHEL 8.x)​

nodejs syslog-ng lighttpd python3-protobuf fontconfig net-tools nfs-utils \
python3-setuptools zip unzip python3-pip rsync sysstat fail2ban perl lighttpd

The epel-release-latest-8.noarch.rpm repository had to be enabled for RHEL 8 installations, with the epel-release package added manually.

Installation Steps​

  1. Install a CentOS or RHEL VM meeting the system requirements above.

  2. Download the RHEL/CentOS RPM installer file matching the 8.x release from the Superna support portal.

  3. Log in as root.

  4. SCP the installer file to the VM.

  5. chmod 755 <install-file-name>

  6. Edit /etc/sysconfig/selinux and set SELINUX=permissive, then reboot.

  7. Install dependencies:

    curl -Ok https://dl.fedoraproject.org/pub/epel/epel-release-latest-8.noarch.rpm
    yum install ./epel-release-latest-8.noarch.rpm
    yum install nodejs syslog-ng lighttpd python3-protobuf fontconfig net-tools \
      nfs-utils python3-setuptools zip unzip python3-pip rsync sysstat fail2ban perl lighttpd -y

    syslog-ng conflicts with rsyslog — remove rsyslog first if present (yum remove rsyslog).

  8. Run the installer: ./<install-file-name> (the 8.x file).

  9. Verify the output shows no errors; the installer reports any missing dependencies.

  10. Reboot the OS.

  11. Confirm services are running:

    systemctl status sca
    systemctl status -l scadb
    systemctl status lighttpd

  12. If installation failed, send the install log (in the same directory as the installer) to Superna Support.

  13. Update the appliance sudoers file:

    sca ALL=(ALL) NOPASSWD: /opt/bin/yum, /opt/superna/bin/kill_packagekit.sh, \
      /opt/superna/sbin/*, /usr/bin/systemctl restart syslog

Initial Configuration​

After installation, complete the standard Eyeglass first-run configuration: log in to the Eyeglass UI (default admin / 3y3gl4ss), install the license (an RHEL/CentOS OS license key was required in addition to other Eyeglass product keys), create a service account with minimum permissions per cluster, and add clusters.

Upgrade Instructions​

  1. Take a VMware snapshot before upgrading — this was the only rollback path if an upgrade failed.

  2. Open a support ticket to obtain the RHEL/CentOS upgrade file and download password.

  3. SSH to the appliance and elevate with sudo -s.

  4. Install xmlstarlet: sudo yum install xmlstarlet -y

  5. Stop the service and clear the OrientDB lib/plugins directories:

    systemctl stop sca
    sudo rm -rf /opt/superna/db/OrientDB/lib/* /opt/superna/db/OrientDB/plugins/*

  6. Copy the upgrade file to the appliance (for example, to /tmp).

  7. chmod +x <eyeglass_RHEL_file_name>.run

  8. Run the file: ./<eyeglass_RHEL_file_name>.run

  9. Reboot the OS.

  10. After upgrade, remove the prior version's RPMs, for example (2.5.4 → 2.5.5):

    rpm -qa | grep -i 'eyeglass' | grep '2.5.4' | xargs rpm -e

  11. Log in to the Eyeglass Web UI and confirm the new version under About/Contact.