Installing SOS Web Services GUI for OVIS

Guide intended to streamline installation and configuration of SOS Web Services GUI for the OVIS project.

SOS Web Services is dependent on OVIS to function correctly, please ensure you first install OVIS before attempting to install the SOS Web Services GUI. The GUI is streamlined to work with an Apache web server, and is packaged as a Python Django application.

Please find the guideline and how to get the source code of the latest OVIS here.

SOS Web Services Dependencies:

  • OVIS
    • SOS
    • LDMS
    • Baler
  • Python 2.7
  • python-pip
    • To install pip, make sure you have the latest EPEL repo installed on your system and simply install with your package manager.
    • django
      • Django is required to run the GUI and easily installs with the python-pip installer. If you’d prefer, you can visit https://www.djangoproject.com/ to download the latest release without installing pip
    • django-http-proxy
  • python-matplotlib
  • mod_wsgi

Installation and Configuration

  • Disable SELinux
  • Configure firewalld to allow SOS Web Services, or disable it
  • Install SOS Web Services rpm
    • owner of entire package should be the user running the httpd server – by default on CentOS, this is apache
  •  LDMS Configuration
    • Configure ldms.cfg to accurately represent your LDMS daemons.
      • A default/example of this configuration template is installed into /etc/ldms.cfg
  • Configure Apache to support the GUI
    • Allow Apache to run by adding it to your list of allowed
    • Add LD_LIBRARY_PATH=/opt/ovis/lib64 (assuming a 64 bit machine) to /etc/sysconfig/httpd
    • Copy (cp) httpd.conf into /etc/httpd/conf/httpd.conf
      • Update the ServerName and Listen variables to your  respective IP Addresses and port numbers you want the GUI available on.
      • Allow the server access to the directories containing your SOS and Baler stores. An example of this is the NVME directory in httpd.conf
  • Configure Baler HTTP Daemon
    • Configure /var/www/sos_web_svcs/static/baler/js/baler_config.js with the correct hostname and port that bhttpd will use to communicate with the baler daemon
  • Configure SOS Web Services
    • The configuration file is located in ~/sos_web_svcs/sosgui/settings.py
    • Set BHTTPD_HOST and BHTTPD_PORT to the IP Address you’re hosting bhttpd and the port on which you want it to communicate
    • Set SOS_ROOT to the root directory of your SOS store(s)

HPC Machine Data Mining