1.3.3 Installation

One external tools must be installed:

1. OpenJDK Java Runtime Environment (JRE)
2. JQ Pretty print of JSON data on CLI (optional)

Debian provided installation packages (.deb) for OpenJDK 17.

• login as root
• update all installed Debian packages: apt-get update; apt-get upgrade
• install JRE from Debian repository: apt-get install openjdk-17-jre-headless

example output

satnms@satnms7-dev:~$ su -
Password:
root@satnms7-dev:~# apt-get install openjdk-17-jre-headless
Reading package lists... Done
Building dependency tree... Done
Reading state information... Done
The following additional packages will be installed:
  ... ca-certificates-java java-common ...
Suggested packages:
  ... 
The following NEW packages will be installed:
  ... ca-certificates-java java-common openjdk-17-jre-headless ...
0 upgraded, 21 newly installed, 0 to remove and 1 not upgraded.
Need to get 50.3 MB of archives.
After this operation, 210 MB of additional disk space will be used.
Do you want to continue? [Y/n] y
... downloading and installing packages ...

To test if Java Runtime was installed successfully, run java -version as user satnms:

example output

satnms@satnms7-dev:/home/public$ java -version
openjdk version "17.0.14" 2025-01-21
OpenJDK Runtime Environment (build 17.0.14+7-Debian-1deb12u1)
OpenJDK 64-Bit Server VM (build 17.0.14+7-Debian-1deb12u1, mixed mode, sharing)

Optionally install JQ an lightweight and flexible command-line JSON processor for test the backend API.

• login as root
• update all installed Debian packages: apt-get update; apt-get upgrade
• install JRE from Debian repository: apt-get install openjdk-17-jre-headless

example output

root@satnms7-dev:/home/satnms# apt-get install jq
...
The following NEW packages will be installed:
  jq libjq1 libonig5
...

Now install the sat-nms backend software package:

• upload satnms4-backend package to `/home/public on the target system
• login as root
• install the local satnms4-backend package apt install /home/public/satnms4-backend_[version].deb.

example output

root@satnms7-dev:/home/public# apt install ./satnms4-backend_1.17.10-1_all.deb
Reading package lists... Done
Building dependency tree... Done
Reading state information... Done
Note, selecting 'satnms4-backend' instead of './satnms4-backend_1.17.10-1_all.deb'
The following NEW packages will be installed:
  satnms4-backend
0 upgraded, 1 newly installed, 0 to remove and 1 not upgraded.
Need to get 0 B/24.7 MB of archives.
After this operation, 0 B of additional disk space will be used.
Get:1 /home/public/satnms4-backend_1.17.10-1_all.deb satnms4-backend all 1.17.10-1 [24.7 MB]
Selecting previously unselected package satnms4-backend.
(Reading database ... 38210 files and directories currently installed.)
Preparing to unpack .../satnms4-backend_1.17.10-1_all.deb ...
Unpacking satnms4-backend (1.17.10-1) ...
Setting up satnms4-backend (1.17.10-1) ...

On success you will find a new directory /home/satnms/backend/ which contains the software and configuration files.