5.1.3 Installation

For the following instructions we assume that you are using Debian 12. Similar Linux distributions like Ubuntu may also work but are not covered by this manual.

Debian Linux 12

Please follow the standard Debian 12 instruction for a minimal Debian installation. We recommend the following setting for the Debian installer:

• Language: English
• locale: en_GB.UTF-8
• Network: fixed IP address
• Clock: use NTP
• Root user: set password and allow login
• Normal user: satnms
• Timezone: UTC
• Disk: 20GB partion for all with ext4
• TaskSel: only SSH Server and Standard system utilities

Additional packages

For convenience we recommend the following additional packages:

• curl
• debsums
• dialog
• htop
• mc
• rsync
• snmp
• sudo
• tcpdump
• tnftp
• vim

root@satnms7-dev:~# apt-get install curl debsums dialog htop mc rsync snmp sudo tcpdump tnftp vim

satnms4-base package

The satnms4-base package contains files and directories required by the other satnms4 components. It should be installed on each host which run sat-nms MNC components.

root@satnms7-dev:~# apt-get install ./satnms4-base_1.2.2-1_all.deb
Reading package lists... Done
Building dependency tree... Done
Reading state information... Done
Note, selecting 'satnms4-base' instead of './satnms4-base_1.2.2-1_all.deb'
The following NEW packages will be installed:
  satnms4-base
0 upgraded, 1 newly installed, 0 to remove and 0 not upgraded.
Need to get 0 B/462 kB of archives.
After this operation, 0 B of additional disk space will be used.
Get:1 /root/satnms4-base_1.2.2-1_all.deb satnms4-base all 1.2.2-1 [462 kB]
Selecting previously unselected package satnms4-base.
(Reading database ... 36810 files and directories currently installed.)
Preparing to unpack .../satnms4-base_1.2.2-1_all.deb ...
Unpacking satnms4-base (1.2.2-1) ...
Setting up satnms4-base (1.2.2-1) ...
Created symlink /etc/systemd/system/multi-user.target.wants/satnms.service → /etc/systemd/system/satnms.service.
Processing triggers for mailcap (3.70+nmu1) ...

Beside installing different files it will also setup the following:

• create a user satnms if not already exists
• create a directory /home/public which should be used later to place satnms4 packages and backups
• enable sudo for a list of commands
• add additional MOTD (message of the day) scripts to show information on login
• and some more

Remark: All satnms4 packages must be installed from local source. All following instructions assume that you have these packages in the folder /home/public on the host where you want to install them.

If the user satnms does not exists before installing this package, a new user will be created. This user will be used to run the different sat-nms services. So it is required. By default it is not possible to login to this user, because there is no password set. Login as root and change the password for the user satnms:

root@satnms7-dev:~# passwd satnms
New password:
Retype new password:
passwd: password updated successfully

satnms4-utils package

The satnms4-utils package contains a collection of utilities for the sat-nms Monitoring & Control System like backup and restore scripts.

root@satnms7-dev:/home/public# apt install ./satnms4-utils_1.0.6-1_all.deb
Reading package lists... Done
Building dependency tree... Done
Reading state information... Done
Note, selecting 'satnms4-utils' instead of './satnms4-utils_1.0.6-1_all.deb'
The following NEW packages will be installed:
  satnms4-utils
0 upgraded, 1 newly installed, 0 to remove and 0 not upgraded.
Need to get 0 B/30.7 kB of archives.
After this operation, 0 B of additional disk space will be used.
Get:1 /home/public/satnms4-utils_1.0.6-1_all.deb satnms4-utils all 1.0.6-1 [30.7 kB]
Selecting previously unselected package satnms4-utils.
(Reading database ... 36932 files and directories currently installed.)
Preparing to unpack .../satnms4-utils_1.0.6-1_all.deb ...
Unpacking satnms4-utils (1.0.6-1) ...
Setting up satnms4-utils (1.0.6-1) ...
Processing triggers for mailcap (3.70+nmu1) ...

Common Linux settings

In preinstalled systems delivered by SatService a dedicated file will display the version of the sat-nms Linux Operation System installation: /etc/satnms_version.

Its format is defined as: [linux-distribution]-satnms-[version] [date]. For customer build OS version it is required to create this file by your own.

• linux-distribution is usually debian, but other names are allowed like ubuntu
• the second word needs to be -satnms-
  • required because several tools parsing this file to get the OS version
  • the Sysinfo device uses this information to display the matching server information
• version format is [major-version].[minor-version][suffix] [date] e.g. 7.01
  • major-number must be 7
  • minor-number will be increased if SatService creates new OS images
  • for customer builds minor numbers needs to be managed by customer
  • optional suffix can be added to mark special editions: e.g. 7.01idu shows that it is a special OS image for the sat-nms ACU Indoor Unit
  • the date should be in format YYYY-MM-DD

satnms@satnms7-dev:~$ cat /etc/satnms_version
debian-satnms-7.01 2023-10-05

The follwing additional settings are recommended for convenience.

• /home/satnms/.bashrc: uncomment line force_color_prompt=yes to enable colored prompt
• /root/.bashrc: configure prompt colors, add the following line:

PS1='${debian_chroot:+($debian_chroot)}\[\033[01;31m\]\u@\[\033[01;33m\]\h\[\033[00m\]:\[\033[01;32m\]\w\[\033[00m\]\$ '