- Introduction
- Prerequisites and Preparations
- Introduction to NETCONF Orchestration API
- Supported Features in Paragon Active Assurance
- Test and Monitor Templates
- Examples of Controlling Paragon Active Assurance via NETCONF & YANG API
- Examples: Test Agents
- Examples: Inventory Items
- Examples: Alarms
- Examples: SSH Keys
- Examples: Tests
- Examples: Monitors
- Using Tags
- Troubleshooting
- Notes on Test Agent Applications and Test Agent Appliances
- Appendix: Tree Structure of Full YANG Model
Installing Required OS and Software
Please note that this only describes a "fresh install". For upgrades, please refer to the Paragon Active Assurance Upgrade Guide.
Install a clean Ubuntu 22.04 server.
The system user name does not matter, except that the name "netrounds" is not allowed since PostgreSQL creates a user with that name (as described in this paragraph).
Install only standard components (do not change the default selection).
The following disk partitioning is recommended, especially for snapshot backups (but it is up to you as a user to decide):
- Recommended partitioning for lab setup:
/
: Whole disk, ext4.
- Recommended partitioning for production setup:
/
: 10% of disk space, ext4./var
: 10% of disk space, ext4./var/lib/netrounds/rrd
(this includes TimescaleDB if you make use of that technology): 80% of disk space, ext4.
- No encryption
- Recommended partitioning for lab setup:
Set the time zone to UTC, for example as follows:
content_copy zoom_out_mapsudo timedatectl set-timezone Etc/UTC
Set all locales to
en_US.UTF-8
.One way to do this is to manually edit the file
/etc/default/locale
. Example:content_copy zoom_out_mapLANG=en_US.UTF-8 LC_ALL=en_US.UTF-8 LANGUAGE=en_US.UTF-8
Make sure the following line is NOT commented out in the file
/etc/locale.gen
:content_copy zoom_out_mapen_US.UTF-8 UTF-8
Regenerate the locale files to make sure selected language is available:
content_copy zoom_out_mapsudo apt-get install locales sudo locale-gen
Install NTP:
First disable
timedatectl
:content_copy zoom_out_mapsudo timedatectl set-ntp no
Disable
systemd-timesyncd
.To disable the
systemd-timesyncd
service:Run the following command to check whether the
systemd-timesyncd
service (minimalistic service to synchronize local time with NTP servers) is running or not.systemctl status systemd-timesyncd
If the service is activated, proceed to Step b.
If the response is Failed to disable unit: Unit file systemd-timesyncd.service does not exist, then proceed with NTP installation.
Run the following commands:
systemctl disable systemd-timesyncd
systemctl stop systemd-timesyncd
Now you can run the NTP installation:
content_copy zoom_out_mapsudo apt-get update sudo apt-get install ntp
Make sure that the configured NTP servers are reachable:
content_copy zoom_out_mapntpq -np
The "reach" value should normally be "all ones" expressed in octal.
(In the output, the "reach" value for the NTP servers is an octal value indicating the outcome of the last eight NTP transactions. If all eight were successful, the value will be octal 377 [= binary 0b11111111]. However, when you have just installed NTP, it is likely that fewer than eight NTP transactions have occurred, so that the value will be smaller: one of 1, 3, 7, 17, 37, 77, or 177 if all transactions were successful.)
Install PostgreSQL, set up a user for Control Center, and create databases:
content_copy zoom_out_mapsudo apt-get update sudo apt-get install postgresql sudo -u postgres psql -c "CREATE ROLE netrounds WITH ENCRYPTED PASSWORD 'netrounds' SUPERUSER LOGIN;" sudo -u postgres psql -c "CREATE DATABASE netrounds OWNER netrounds ENCODING 'UTF8' TEMPLATE 'template0';"
Using an external PostgreSQL server is not recommended.
Install and configure an email server.
Control Center will send emails to users:
- when they are invited to an account,
- when sending email alarms (i.e. if email rather than SNMP is used for this purpose), and
- when sending periodic reports.
Run the command
content_copy zoom_out_mapsudo apt-get install postfix
For a simple setup where postfix can send directly to the destination email server, you can set General type of mail configuration to "Internet Site", and System mail name can usually be left as-is. Otherwise, postfix needs to be configured according to the environment. For guidance, refer to the official Ubuntu documentation at ubuntu.com/server/docs/mail-postfix.