Module CSC5002—ASR6: Middleware and software architecture for distributed applications

Local Software installations

For those who are going to use their personal computer, you are responsible of the installation of required software on your computer. The following instructions may be a help for the installation of software required fot the teaching unit. NB: The commands are given for a GNU Linux system.

Installation of JAVA, Maven, net tools, and Eclipse

Installation of JAVA and Maven

Let us start by checking the Java installation. Version 21 is recommended. In TSP lab rooms B313 and 3a401, by default, your account is configured to use JAVA version 21.

$ java -version
openjdk version "21.0.4" 2024-07-16
OpenJDK Runtime Environment (build 21.0.4+7-Ubuntu-1ubuntu224.04)
OpenJDK 64-Bit Server VM (build 21.0.4+7-Ubuntu-1ubuntu224.04, mixed mode, sharing)

$ mvn --version
Apache Maven 3.9.7 (8b094c9513efc1b9ce2d952b3b9c8eaedaf8cbf0)
Maven home: /opt/maven
Java version: 21.0.4, vendor: Ubuntu, runtime: /usr/lib/jvm/java-21-openjdk-amd64
Default locale: en, platform encoding: UTF-8
OS name: "linux", version: "6.8.0-41-generic", arch: "amd64", family: "unix"
      

Check the content of the JAVA_HOME environment variable.

echo $JAVA_HOME

If the variable does not exist, you should create it by adding the following two lines into your shell configuration file ~/.bashrc in order to point to the installed JAVA version:

JAVA_HOME=/usr/lib/jvm/java-1.21.0-openjdk-amd64
PATH=$PATH:$JAVA_HOME/bin
CLASSPATH=$CLASSPATH:.:$JAVA_HOME/lib
export JAVA_HOME PATH CLASSPATH

If you do not have a JDK 21 version, you should first install it. Be careful! A JRE is not sufficient for compilation.

Instructions for installing OpenJdk: http://openjdk.java.net/install/. Link to JDK version 21.

Instructions for installing Maven: https://maven.apache.org/download.cgi.

Installation of net tools

In order to verify which servers are running, we use two OS packages: net-tools and lsof. Verify that they are installed in your system. From the net-tools package, we will use the netstat command. In some linux OS they may be installed with this command (to be adapted to your system) :

sudo apt-get install lsof net-tools

Installation of Eclipse

If Eclipse is already installed, check your installation:

Menu Help, About Eclipse, whenever possible run the distribution "Eclipse Java EE IDE for Java and Web Developers" version.
Menu Help, About Eclipse, Installation Details, Plug-ins, check that the following plug-ins are installed:
- Checkstyle Plug-in,
- SpotBugs Plug-in.

The URL for instructions for installing Eclipse is http://www.eclipse.org/. In the installer, choose "Eclipse IDE for Java EE Developers". Install the plug-ins with the Eclipse Marketplace (menu Help, Eclipse Marketplace...).

Installation of docker

Follow the instructions on the docker installation page (e.g. on ubuntu).

To be able to run docker containers, you should be added to the docker group.

First create the docker group if it does not yet exist.

sudo groupadd docker

Then add your login to the list of the docker group members, and activate the changes to the group.

sudo gpasswd -a $USER docker
    newgrp docker