[Huayan Z]

Made some attempt using BeaqleJS. If you know something about Linux server management/Docker, it will be straightforward. However, there are some potential bugs. One I found is I can’t enable random AB choice preference testing (e.g. give probability 0.5 to set AB = BA). I would like to share following instructions/issues that might related.

Following link is my test, it will be available until April 15th 2019.
http://148.70.111.22/
Deployment:
1. Firstly, you need a server. I suggest you use Vultr for you can create/delete any server at any time, i.e. you don’t need to spend money for whole month. A minimum hardware config is sufficient.
2. Beaqlejs is mainly js with HTML, so any HTTP server is sufficient. If you don’t want to use Docker:
2.1 Install HTTP server Apache/Nginx
2.2 Enable HTTP service on your machine(I assume you use linux)
$ sudo systemctl enable httpd && sudo systemctl start httpd
Attention: above line is different according to which linux
distribution using
2.3 Config your server to: allow http port explore outside, give correct
user group, and site configuration, etc. You can find them online.
2.4 Copy the whole beaqlejs to /var/www/html (I assume this is your
default site directory)
$ git clone https://github.com/HSU-ANT/beaqlejs.git .
$ sudo cp beaqlejs/* /var/www/html
2.5 create an audio directory under your site directory, remember to
give correct access to audio file. I simply gives full access(not
safe!)
$ cd /var/www/html && sudo mkdir audio && chmod 777 audio
2.6 copy your audio file to audio directory, scp/rsync will do the job.
$ scp -r audio/ username@server:/var/www/html/
2.7 Create a config file for your test case. you can simply copy one
from beaqlejs/config and modify the choices. The github page gives
detailed instruction.
https://github.com/HSU-ANT/beaqlejs

2.8 Edit index.html to choose which test you want to use
$ vim index.html
line 17:
<script src=”config/example_config_mushra.js”
type=”text/javascript”></script>
choose your config file to replace above example

line 35: testHandle = new MushraTest(TestConfig);
Three variations provided: Mushra, ABX, Preference(AB Test)
If necessary define your own test class according to their github.
2.9 Beaqlejs supports online submission. you need firstly enable PHP
support of your HTTP server, then set EnableOnlineSubmission and
BeaqleServiceURL in your config file. The submission server is
defined in beaqlejs/web_service/beaqleJS_Service.php. You also need
to give read and execute access to the php file. The test results
will be stored under web_service/result/ directory as txt files.
More detail please refer to their github page.

3. If you are Docker User:
3.1 they provided a sample docker-compose file at beaqlejs/tools/Docker/
3.2 if you prefer to use raw docker command, you can simply use:
$ docker run -d -p 80:80 -v /path/to/BeaqleJS:/var/www/html –name
beaqlejs-server php:7.0-apache
$ docker start/stop beaqlejs-server
3.3 you can modify the php:7.0-apache image according to your need.
3.4 other config are same to 2.4-2.9, do remember to enable access to
your audio and php directory at host machine.

Known Issues:
1. You can do the test on mobile. However, for some chinese android mobiles, they using customized web browser which uses an older version of Chrome, which might have issues with the test.
2. It happens that at a bad net status, beaqlejs will fail to load audio file and generate error “not able to access audio file”, sometimes the error message are just confusing
3. For preference test(AB Test), it is not able to randomize the AB choice.
A solution: modify line 1375 of js/beaqle.js file.
comment this line:
// if (this.TestConfig.RandomizeFileOrder && RandFileNumber>0.5) {
replace with:
if (RandFileNumber>0.5) {
It uses a never defined variable RandomizeFileOrder that will always prevent the test choice to be randomized. I have opened an issue but don’t know when the developer to fix. You can also modify it according to your need.

[Author]

Posts