Build and test guacamole - BYUHPC/7lbd GitHub Wiki

Build, configure and test guacamole

Download 7lbd
On a node with Internet, compile, download, and build all of the code by running the build script in the 7lbd_apps folder:

build_7lbd_apps.sh.

Internet is only required to download containers, NodeJS modules and other steps contained in the build_7lbd_apps.sh script. Once this step is complete, you can run the remaining installation steps on any node.

Make your VM file read-only.
Update config.sh with relevant information. There is help and context in the config.sh file.

Step 3: Test guacamole

Run the guacd test program in the 7lbd_getting_started folder. This command will run the VM, the RDP Connector for Guacamole, and guacd. It has a reasonable amount of error checking to help diagnose problems.

guacd-test-suite.sh --start-all

Test the Guacamole tool chain by copying the link from the output of the guacd-test-suite.sh into a browser. It should look something like this:

URL for HTML5 Guacamole session: https://ondemand.example.edu/node/server1.example.edu/8080/?authtoken=YMgxouwxfsp001QEkY1PnyyNmYAOP3uO

Debug issues (if necessary)

Output from starting qemu-kvm should go to stdout where you invoked the guacd-test-suite.sh
Output from the guacd container should also go to stdout
Output from the RDP connector will go to a log file in the job tmp folder. The location of the log will be output to the stdout terminal.

Step 4: Put the Guacamole client / server code and the VM in a shared location

In case not done previously, the next step is to copy or move the 7lbd files to a location that all users and nodes that need to run 7lbd can read them. We are still not running slurm jobs yet, just making the "application" work for all users and all nodes.

The 7lbd_apps folder contains the Guacamole connector, the guacd container and the Guacamole web client. It is over 100 MB and should belong where all of your other apps are located.
The read-only Windows VM image should also be placed in a network share somewhere that can be accessed by all nodes and users that will be running 7lbd jobs. Make sure that the permissions to the VM file is set to read-only and production jobs point to a soft link of the VM file. See the article on the qemu kvm overlay file for more information.
Update your config.sh in the 7lbd_getting_started folder and re-run guacd-test-suite.sh as in step 3 above to make sure that everything still works with all of the new paths.