Preliminary Steps

You need to get the tools to run the emulator. Follow the instructions in Get Source to download the tools. You will see many jam-x and djam-x programs in the tools folder. Make them available for execution by including the tools folder in your path. At least the djam tools should be available to proceed with the Docker-based execution.

Any Docker-based JAMScript execution (even if it is a single node) requires the configuration of a network topology. To configure the network topology, Pumba Chaos Testing Tool is required. From the above link, you need to download the appropriate executable for your OS.

The next step is to make Docker containers run without sudo. Find the sequence of steps necessary for your Linux distribution or MacOS by searching the Internet. Test that you actually succeeded in configuring Docker containers to run without sudo by using a command like docker ps and observing the outcome. You won’t be able to continue the experiments without completing this step.

Getting a Docker Image with JAMScript

Assuming that you have the tools (JAMTools) in your path, you can use djam pull mahes25/jamscript to get a Docker image with JAMScript. If you have an alternate image, you can pull that one by substituting it for mahes25/jamscript in the above command.

After this step, you have a Docker image with JAMScript. Follow the instructions in Emulator Run to carry out the experiments using this Docker image.

Packaging JAMScript in Docker Containers

If you have added a feature to the JAMScript language runtime or compiler and want to have that in the Docker version, you need to repackage the container images. You can share your container image with others using a public Docker image repository.

The JAMScript source package has a Dockerfile necessary for rebuilding the docker image. cd $JAMHOME/scripts/install to see the Dockerfile. You can edit it if you want to make changes. Run the following command from there to rebuild a container image. The Dockerfile is configured to use the files from the repository at https://github.com/citelab/JAMScript. Therefore, if you need any additions to the rebuilt image, those additions should be committed to the above repository or the Dockerfile needs to be edited to use another location for the source files.

docker build --no-cache -t jamscript .

After the build is completed, you can push the image to a remote repository like the following.

docker tag jamscript docker_hub_user/jamscript
docker push docker_hub_user/jamscript