How to install on Cpanel managed server

You are supposed to have a Cpanel VPS and a default or close to default Cpanel configured website - PHP, MySQL/MariaDB, Apache with SSL enabled. This guide will not work on a Cpanel based shared hosting service.

Requirements

• A managed with Cpanel Linux server (VPS) with SSH access as a root user or with sudo
• A Cpanel website on this server with PHP, MySQL/MariaDB, Apache and SSL enabled
• telnet installed on the server: yum install telnet
• shell_exec enabled in php.ini (how to check / enable shell_exec)

Make sure that PHP shell_exec is enabled: upload and navigate with your browser to a PHP file with the following content:

<?php print(shell_exec('date'));?>

It should display the current date and time. In case of an error or no output, enable shell_exec in php.ini by removing it from the list of disabled functions: disable_functions = exec,passthru,shell_exec,system,proc_open and restart Apache.

How to edit php.ini

Step 1

Download blabws-server 32-bit or 64-bit, unzip and upload the folder blabws-server under /opt so that the absolute path to the blabws-server executable file is: /opt/blabws-server/blabws-server

• Upload in binary mode - the two files blabws-server on your computer & remote server must be exactly the same size
• Make sure the server is executable: chmod +x /opt/blabws-server/blabws-server or Filezilla » File Permissions » 755

Step 2

If you have Cpanel & WHM navigate to Cpanel » EasyApache and make sure that both mod_proxy and mod_proxy_wstunnel are enabled. If you cannot find EasyApache in Cpanel look for the following file:

/etc/apache2/conf.modules.d/XXX_mod_proxy_wstunnel.conf

where XXX is is a 3-digit number. No such file? Ask your hosting provider to enable mod_proxy_wstunnel for you.

Add the following line at the end of /etc/apache2/conf.modules.d/XXX_mod_proxy_wstunnel.conf:

ProxyPass "/MyWsServer/" "ws://127.0.0.1:9002/"

Save and restart Apache.

Step 3

Download BlaB! WS (client), unzip the content in an empty folder and upload it to your server under your website directory.

CHMOD blabws/config.php to 666, blabws/attachments to 777, navigate with your browser to YOUR_WEBSITE_URL.COM/blabws/index.php and follow the instructions (3 steps only).

Step 4

At the end of the installation process you'll see a link to the Admin CP - go to Server, and set:

• protocol: wss
• Server port: remove 9002 and leave the box empty
• ProxyPass token: MyWsServer

Save with OKAY, start your websocket server from BOARD » SERVER STATUS, press the ESC key to display the menu, hit EXIT to go to chat.

Done!