XData

Home

Installation

Docker Installation

Administrator Usage

Instructor Mode

• Basic setup
  
• Assignment creation
  
• Evaluation
  
• Grades and partial marking
  
• Learning Tool Integration
  

Student Usage

Developer Setup

Setting up XData on docker

1. Install and setup docker [This step requires admin access. If you do not have admin access request your system administrator to do the installation.]
   • Follow the installation steps shown here to install docker
   • Verify docker has correctly been intalled using : $ sudo docker run hello-world
   • Also do the following post-installation steps for user priviledges (as given in the website) :
     $ sudo groupadd docker
     $ sudo adduser $USER docker
     If you are installing it for a different user replace $USER with the username.
2. Run $ newgrp docker
3. Unzip the downloaded 'XData_Docker.zip' file
4. Open a terminal in the XData_Docker directory
5. $ docker build -t xdata:1 .
   [This command builds a docker image from dockerfile. Note the dot (.) at the end of the command. This command may take some time.]
6. $ docker run -it -p ‹port_no›:8080 --name ‹container-name› xdata:1
   [This command creates a docker container from the above docker image and starts the container. Use any free port number(other than 8080) in the ‹port_no› slot.]
7. Start Tomcat(If not started)
• $ cd var/lib/tomcat9/bin
• $ ./startup.sh
8. Open the link: 'localhost:‹port_no›/XDataGrading/' in your local browser. If you are running docker on a different machine, replace localhost with the network address of the mahcine.
   [Use the same free port number as step 6 ]
9. To stop the docker use ‹Ctrl+d›
10. Yor XData docker conatiner is now setup and running. Use 'exit' command in terminal to exit from docker and stop the container. To detach the terminal without stopping the docker type ‹Ctrl+p› followed by ‹Ctrl+q›.

Using XData on docker

1. To use the docker run
   $ docker start ‹container-name›
   [Use the container-name set when using creating the container]
   This will start your container and run the XData system on apache tomcat server. You can access it using 'localhost:‹port_no›/XDataGrading/' in your local browser as shown above. If you are running docker on a different machine, replace localhost with the network address of the machine.
2. If you want to get a terminal access to the docker use the following command
   $ docker exec -it ‹container-name› /bin/bash
3. To stop the container use $ docker stop ‹container-name›