StarTrinity CST - Monitoring IP network quality using a custom server

• "Client" runs at multiple client sites, conencts to one or multiple "servers"
• "Center" colelcts measurements and stores in MySQL database
• "Center" and "Server" can run at same Linux host

"Center" side installation (Linux 64bit)

• Download tar.gz archive and extract into some clean folder. Set 'executable' attribute to extracted file "StarTrinity.Center" (if needed):
  sudo mkdir /usr/bin/startrinity_center
  sudo cd /usr/bin/startrinity_center
  # if wget is missing on centos/rhel: sudo yum install wget
  sudo wget http://startrinity.com/InternetQuality/startrinity_center_linux_x64.tar.gz
  sudo tar xzvf startrinity_center_linux_x64.tar.gz
• Open ports in firewall (default UDP 15400)
  • Ubuntu:
    sudo apt-get update
    sudo apt-get install ufw
    sudo ufw default deny incoming
    sudo ufw default allow outgoing
    sudo ufw allow ssh
    sudo ufw allow 15400/udp
    sudo ufw allow 5000/tcp
    sudo ufw enable
  • RHEL:
    sudo firewall-cmd --zone=public --permanent --add-port=15400/udp
• Create a configuration file for systemd using nano text editor: add service "s3center":
  sudo nano /etc/systemd/system/s3center.service
  Put correct user name:
  [Unit]
  Description=StarTrinity Center
  
  [Service]
  WorkingDirectory=/usr/bin/startrinity_center
  ExecStart=/usr/bin/startrinity_center/StarTrinity.Center
  Restart=always
  # Restart service after 10 seconds if the dotnet service crashes:
  RestartSec=10
  KillSignal=SIGINT
  TimeoutStopSec=90
  SyslogIdentifier=S3Center
  User=username
  Environment=ASPNETCORE_ENVIRONMENT=Production
  Environment=DOTNET_PRINT_TELEMETRY_MESSAGE=false
  
  [Install]
  WantedBy=multi-user.target
• Edit configuration file StarTrinity.Center.cfg
  sudo nano /usr/bin/startrinity_center/StarTrinity.Center.cfg
  Put correct MySQL database host name, database name, user and password into the file:
  mysql-connection-string=server=xxxxxx;user=xxx;database=cst;port=3306;password=yyy
  request-raw-measurements=true# this setting requests measurements from clients
  http-port=5000
  web-admin-password=generate-new-password-here # password to access the web UI. username is "admin"
• Start the serviсe and check its status:
  sudo systemctl start s3center.service
  sudo systemctl status s3center.service
• Access web UI at HTTP port specified in the configuration file, use userid "admin" and password from the configiration file

"Server" side (Linux 64bit)

• Download tar.gz archive and extract into some clean folder. Set 'executable' attribute to extracted file "CST.CrossPlatform" (if needed):
  sudo mkdir /usr/bin/startrinity_cst
  cd /usr/bin/startrinity_cst
  # if wget is missing on centos/rhel: sudo yum install wget
  sudo wget http://startrinity.com/InternetQuality/startrinity_cst_linux_x64.tar.gz
  sudo tar xzvf startrinity_cst_linux_x64.tar.gz
• Open ports in firewall (default UDP and TCP 9200)
  • Ubuntu:
    sudo ufw allow 9200/udp
    sudo ufw allow 9200/tcp
    sudo ufw allow 5100/tcp
    sudo ufw allow 10000:11000/udp
    sudo ufw enable
  • RHEL:
    sudo firewall-cmd --zone=public --permanent --add-port=9200/tcp
    sudo firewall-cmd --zone=public --permanent --add-port=9200/udp
• Create a configuration file for systemd using nano text editor: add service "cst":
  sudo nano /etc/systemd/system/cst.service
  Put correct user name and center host name::
  [Unit]
  Description=StarTrinity CST
  
  [Service]
  WorkingDirectory=/usr/bin/startrinity_cst
  ExecStart=/usr/bin/startrinity_cst/CST.CrossPlatform --mode custom-server-as-server --server-port 9200 --license-key xxxxx --center-host your-center-host-here --center-port 15400
  Restart=always
  # Restart service after 10 seconds if the dotnet service crashes:
  RestartSec=10
  KillSignal=SIGINT
  TimeoutStopSec=90
  SyslogIdentifier=CST
  User=username
  Environment=ASPNETCORE_ENVIRONMENT=Production
  Environment=DOTNET_PRINT_TELEMETRY_MESSAGE=false
  
  [Install]
  WantedBy=multi-user.target
• Start the serviсe and check its status:
  sudo systemctl start cst.service
  sudo systemctl status cst.service
• Access web UI at HTTP port 5100
• Monitor CPU performance in htop:
  sudo apt-get install htop
  htop

Client side installation on Windows

• Download ZIP file for Windows 64bit or ZIP file for Windows 32bit, extract into some clean directory
• StarTrinity.ContinuousSpeedTest.exe --install-autostart
• Create configuration file StarTrinity.ContinuousSpeedTest.cfg with settings, put correct center host and server host:
  minimized
  mode=custom-server-as-client
  server-host=your-server-host-here
  server-port=9200
  center-host=your-center-host-here
  center-port=15400
  upload-limit=20kbps
  download-limit=20kbps
  license-key=your-license-key-here
  downtime-threshold-no-received-packets-time=3000ms
  downtime-threshold-packet-loss=5%
  downtime-threshold-instant-jitter=100ms
  downtime-threshold-rfc3550-jitter=30ms
  downtime-threshold-round-trip-time=50ms
  
• Run StarTrinity.ContinuousSpeedTest.exe

Client side uninstallation