1.2.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)

Now install the sat-nms backend software package:

• upload satnms4-documentation, satnms4-images, satnms4-jars and satnms4-mnc package to `/home/public on the target system
• login as root
• install the local satnms4-* packages
  • apt install /home/public/satnms4-documentation_[version].deb
  • apt install /home/public/satnms4-images_[version].deb
  • apt install /home/public/satnms4-jars_[version].deb
  • apt install /home/public/satnms4-mnc_[version].deb

example output for package satnms4-mnc

root@satnms7-dev:/home/public# apt-get install ./satnms4-mnc_3.68.9-1_all.deb
Reading package lists... Done
Building dependency tree... Done
Reading state information... Done
Note, selecting 'satnms4-mnc' instead of './satnms4-mnc_3.68.9-1_all.deb'
The following packages will be upgraded:
  satnms4-mnc
1 upgraded, 0 newly installed, 0 to remove and 0 not upgraded.
Need to get 0 B/10.2 MB of archives.
After this operation, 0 B of additional disk space will be used.
Get:1 /home/public/satnms4-mnc_3.68.9-1_all.deb satnms4-mnc all 3.68.9-1 [10.2 MB]
Reading changelogs... Done
(Reading database ... 48696 files and directories currently installed.)
Preparing to unpack .../satnms4-mnc_3.68.9-1_all.deb ...
Unpacking satnms4-mnc (3.68.9-1) over (3.68.2-1) ...
Setting up satnms4-mnc (3.68.9-1) ...

On success you will find a multiple new files and directories /home/satnms/ like satnms.jar and directories drivers, protocols etc.