Chapter 2. Tungsten Dashboard Pre-Requisites

Continuent Tungsten Dashboard needs the following prerequisites to function:

  • Continuent Tungsten Clustering v5.3.0 and above or v6.0.1 and above only.

  • Web server with PHP7 support (sample configs provided for Apache 2.2 and 2.4)

    Please note that more recent versions of Lunux and Apache use php-fpm to run PHP code.

    • Below is a sample command line session on Amazon Linux 2 to get PHP 7.4 installed with all of the needed dependencies:

      shell> sudo -i
      root shell> amazon-linux-extras enable php7.4
      root shell> yum clean metadata
      root shell> yum install php-common php-cli php-pdo php-fpm php-json php-mysqlnd php-mbstring php-xml
      root shell> systemctl start php-fpm
      root shell> systemctl enable php-fpm
    • Next, tweak the default Apache PHP configuration, otherwise PHP-FPM gets called for files that don’t exist. So, edit the file:

      shell> sudo -i
      root shell> vi /etc/httpd/conf.d/php.conf
    • Change the SetHandler around line 27 from OLD to NEW:

      OLD:
      <FilesMatch \.php$>
        SetHandler "proxy:unix:/run/php-fpm/www.sock|fcgi://localhost"
      </FilesMatch>
      NEW:
      <FilesMatch \.php$>
        <If "-f %{SCRIPT_FILENAME}">
          SetHandler "proxy:unix:/run/php-fpm/www.sock|fcgi://localhost"
        </If>
      </FilesMatch>
    • Then check and restart Apache:

      shell> sudo apachectl configtest
      shell> sudo systemctl restart httpd
  • PHP Curl Support - install php-common or php-curl and restart your web server

  • HA Proxy - http://www.haproxy.org

  • Make sure to open ALL of the appropriate firewall ports to ensure access.

    • The default architecture would require TCP port 8090 open between the web server running the Dashboard and all cluster nodes in all clusters that are to be administered by the GUI application.

    • By default, port 80 will need to be open from the client browser to the web server running the Tingsten Dashboard. If HTTPS has been implemented, TCP 443 must be opened in addition to port 80.