Install Maven and jSpace Guide

Table of Contents:

Contact Benjamin Bogø if you found a problem or have suggestions for improvements/additions.

1 Install Maven

1.1 Download Maven

Go to the Maven Download Page. Based on you OS, download the following file:

Input: Version number on the files from the Maven Download Page.
Windows
apache-maven-3.8.7-bin.zip
Linux
apache-maven-3.8.7-bin.tar.gz
MacOS
apache-maven-3.8.7-bin.tar.gz

1.2 (OPTIONAL) Verify File

Check the sha256 sum of the downloaded file and compare it with the checksum given on the website where you downloaded the file:

Windows

Use a Linux shell (Linux Subsystem for Windows or Git Bash), navigate to the folder with the downloaded file and run the following command:

sha256sum apache-maven-3.8.7-bin.zip
Linux

Open a terminal, navigate to the folder with the downloaded file and run the following command:

sha256sum apache-maven-3.8.7-bin.tar.gz
MacOS

Open a terminal, navigate to the folder with the downloaded file and run the following command:

shasum -a 256 apache-maven-3.8.7-bin.tar.gz

1.3 Unpack Contents

Unpack the contents of the downloaded file (the location does not really matter).

Windows

Use your default unpacking method.

Linux

Run the command (zfx = x extract contents of the given z compressed f file):

tar zfx apache-maven-3.8.7-bin.tar.gz
MacOS

Use your default unpacking method (double click on the file).

Note/copy the location of the bin folder in the unpacked folder apache-maven-3.8.7 below OR add it to your PATH-variable.

Input: Absolute path to the bin folder in the extracted apache-maven-<version> folder WITH TRAILING SLASH (leave empty if in PATH-variable).
Next Step

2 Install jSpace

Please enter the following information:

Input: Operating system (terminal).

2.1 Download jSpace

Download the latest version of jSpace at https://github.com/pSpaces/jSpace/archive/master.zip and unpack the downloaded zip-file (see Step 1.3 for how to unpack). The location does not really matter, BUT you should avoid folders where you need administrator rights to make changes!

2.2 Install jSpace

Open a terminal and navigate to into the unpacked folder named jSpace-master (you should see a pom.xml file there). Here, you have to run two commands. If any of them fail due to the tests fail, make sure

The first command below will download the required packages (like Google gson), build the framework, and execute all the tests:

"mvn" clean verify

The second command will install jSpace in the local Maven repository (a folder called .m2 - usually placed in your documents folder):

"mvn" install
Next Step