Transcription of HTML5 self-hosted - speedcheckercdn.com
1 HTML5 self - hosted 2019 Speedchecker Ltd. rev 1 / 8 The downloadable version measures the speed between your visitor and your server. The instructions are in 2 parts: - Automatic Setup of the Websocket & HTTP Fallback support using Installer - Customizing HTML embed code on your webpage The Speedchecker engine runs by default on Websocket connections as these are more accurate for measuring throughput in the browser. However, in some rare cases where browsers do not support the Websocket we do fallback to HTTP testing. At the end we also have Manual Setup of the Websocket support as well as Manual Setup for the HTTP Fallback support for advanced users who do not want to take advantage of the Automatic setup using installer.
2 Server requirements Server requirement Minimum requirement OS: Redhat/CentOS/Debian/Ubuntu Bandwidth: 100 Mbit port or more Disc space: 5 GB CPU / Memory: 1GB RAM, 1 Ghz CPU Core Valid SSL certificate for the domain you want to use for your webserver Optimal requirement OS: Redhat/CentOS/Debian/Ubuntu Bandwidth: 1 Gbit port or more Disc space: 5 GB CPU / Memory: 2GB RAM, 2x CPU Core Firewall port requirements Websocket testing: open port 8088 HTTP Fallback testing: open port 80 ICMP opened (for latency testing on iOS and Android) Server Load Here is a summary of the impact of our service on the server: The Server's bandwidth is used extensively. Outgoing traffic is usually much higher than incoming. Memory usage is low.
3 Disk I/O is low. CPU usage will only be a significant factor for very low-end servers. HTML5 self - hosted 2019 Speedchecker Ltd. rev 2 / 8 Automatic setup of Websockets & HTTP Fallback using installer 1. Download installation scripts from : And 2. Run HTTP Fallback installer script with root privileges: /bin/bash (by default it installs NGINX, if you wish to install Apache, add 0 parameter /bin/bash 0). Once installation finishes you should see green message HTTP Fallback installation finished successfully . If you do not see this message, something went wrong please copy all the output in command line and send to us for investigation by email. 3. Run Websocket installer script with root privileges: /bin/bash 0|1 (0 - non ssl, 1 - ssl install ).
4 If you are running website with HTTPS you need to install SSL version. 4. Once installation finishes you should see green message Installation finished. Please reboot server . If you do not see this message, something went wrong please copy all the output in command line and send to us for investigation by email. 5. If you run SSL option you will need to edit file - /usr/local/ and edit path to SSL certificates 6. Reboot server 7. Verify if server is working correctly by entering your webserver url/ip to this online tester: HTML5 self - hosted 2019 Speedchecker Ltd. rev 3 / 8 Customising the embed code 1. Go to and customize your design 2. Copy & paste the HTML code to your webpage 3. Add the serverUrl parameter to match your serverURL.
5 ServerUrl= ; (if you did not install SSL on your server, change to http://..) 4. If you did not install SSL certificates in your server, you will need to add this parameter to force websocket connections on unsecured protocol: sc_forceSecureWebsockets=0; 5. Add correct location of files for HTTP fallback: serverDownloadFolder = '/'; serverUploadFolder = '/'; 6. Add the serverTitle parameter which will indicate what will be to the user serverTitle = London server ; Sample code for HTTP (no-ssl option) (added part in bold) <html> <body> <div id="speedcheckerdiv"> </div> <div id="speedchecker_link">Provided By <a href=" " rel="nofollow">Internet speed test</a> </div> <script type="text/javascript">serverUrl=' ';sc_forceSecureWebsockets=0;serverTitle = 'London server'; serverDownloadFolder = '/';serverUploadFolder = '/';sc_skin='1';sc_bgc='0xFFFFFF';sc_bc= '0x000000';sc_hc='0xFF9933';sc_cc='0x000 000';sc_w=375;sc_h=235;sc_userid=5143723 5;sc_location='AD';version=3;var sc_script = ('script'); ('src', ((('https:' == )?)))
6 'https' : 'http') + ' ')); ('head')[0].appendChild(sc_script);</script> </body> </html> HTML5 self - hosted 2019 Speedchecker Ltd. rev 4 / 8 Sample code for HTTP (SSL option) (added part in bold) <html> <body> <div id="speedcheckerdiv"> </div> <div id="speedchecker_link">Provided By <a href=" " rel="nofollow">Internet speed test</a> </div> <script type="text/javascript">serverUrl=' ';serverTitle = 'London server'; serverDownloadFolder = '/';serverUploadFolder = '/';sc_skin='1';sc_bgc='0xFFFFFF';sc_bc= '0x000000';sc_hc='0xFF9933';sc_cc='0x000 000';sc_w=375;sc_h=235;sc_userid=5143723 5;sc_location='AD';version=3;var sc_script = ('script'); ('src', ((('https:' == )? 'https' : 'http') + ' ')); ('head')[0].appendChild(sc_script);</script> </body> </html> Explanation of the design parameters sc_location A string of your web page location in ISO format.
7 This can affect the UI language, whether it contains one of following values: FR for French, IR for Persian, JP for Japanese, PL for Polish, PT for Portuguese and English in default or any other case. sc_skin A string of the UI style, one of following values: '' for custom colours, '1' for default sc_w A number of the application width. Note the height value will be calculated. sc_bgc A string of the background colour in HEX format, 0x123456 for transparent sc_bc A string of the border colour in HEX format, 0x123456 for transparent sc_hc A string of the hand colour in HEX format, 0x123456 for transparent sc_cc A string of circles and the text colour in HEX format, 0x123456 for transparent HTML5 self - hosted 2019 Speedchecker Ltd.
8 Rev 5 / 8 Optional Measuring High Latency connections For scenarios where the majority of users are connecting using a high latency network ( satellite connection) you might get better results using the following parameters (case sensitive) to enable the "high latency" version of the algorithm: sc_highLatency = true; sc_maxDownloadDuration = 30000; sc_maxUploadDuration = 30000; Optional Changing Latency Measurement Type The new default Latency Measurement Type is TCP. If you need or want to revert to the old Latency Measurement Type please use the following parameter (case sensitive): latencyMeasurementType='http'; Manual Websocket POCO server setup Do not follow these steps if you have already used our automatic websocket installer Installation requirements Poco customized source archive ( ) Poco configuration ini file ( ) Development tools installed on Linux server SSL development libraries Dependencies installation Server OS RedHat/Centos: sudo yum -y groupinstall "Development Tools" sudo yum -y install openssl-devel Server OS Debian/Ubuntu: sudo apt-get update sudo apt-get install build-essentials sudo apt-get install libssl-dev Build software: Unpack archive into /opt folder: cd /opt && tar xzf Enter source folder - /opt/poco-ssl Run: make -s -j 2 HTML5 self - hosted 2019 Speedchecker Ltd.
9 Rev 6 / 8 When previous command finished without Errors Run: sudo make install Install software: Go to software folder: cd /opt/poco-ssl Copy binary: cp -f Net/samples/WebSocketServer/bin/Linux/x8 6_64/WebSocketServerd /usr/local/bin/WebSocketServerd Copy to /usr/local/ Edit file /usr/local/ to point it on own certificates Make test run: /usr/local/bin/WebSocketServerd You should see message that application run on port: 8088 Setting up as a service Poco Server needs to run as a service to prevent issues on server restart. Each organization may have different preferences how to run as a service. Here is our recommendation: Install supervisor software. Google manual for your OS. Create configuration file for poco service.
10 Example: [program:WebSocketServerd] environment=LANG= ,LC_ALL= ,LC_LANG= command = /usr/local/bin/WebSocketServerd loglevel=warn ; trace, debug, info, warn, error, critical stdout_logfile = /var/log/ stderr_logfile = /var/log/ autostart=true autorestart=true Start/Restart supervisor service Check that service is running and port 8088 active. Manual HTTP Fallback support setup Do not follow these steps if you have already used our automatic HTTP Fallback installer In case client does not support websockets ( mobile app or old browsers without Websocket support), measurement will be executed using HTTP protocol. The HTTP Fallback mechanism requires web server to be installed on your server. We support Apache or NGINX server in our instructions.
