NovaStar Program Reference / System / novastar5

Overview

The novastar program controls main flood warning system processes. On system start, novastar5 start is run if the database configuration table has a record with name='system_up' and a value='true'.

The program can manage a single program or all NovaStar5 processes.

See the table below for command line parameters. The major operations are as follows:

On start (novastar5 all start, which is the default):

  • perform log file maintenance using nslogmaintenance
  • perform database maintenance using nsdbmaintenance
  • start nsdbrep - database replication
  • start nsrecdata - ALERT and ALERT2 data collection
  • start ns50386server - HydroLynx server
  • start autointer - polled station data collection
  • start nsmapdisplay - hardware map display interface
  • start nsalerttalk3 - AlertTalk3 notification system
  • start nsnetcat - network to serial interface, used in Jordan system siren control
  • start nssystemcommand - run system commands in database system commands table
  • start nssiren - siren controller

On stop (novastar5 all stop):

  • stop nsautointer
  • stop nsmapdisplay
  • stop nsalerttalk3
  • stop nsrecdata
  • stop ns50386server
  • stop nsdbrep
  • stop nsnetcat
  • stop nssystemcommand
  • stop nssiren

On restart (novastar5 all restart):

  • novastar5 all stop
  • novastar5 all start

On status (novastar all status):

  • Display status of nsdbrep
  • Display status of nsautointer
  • Display status of nsrecdata
  • Display status of ns50386server
  • Display status of nsmapdisplay
  • Display status of nsalerttalk3
  • Display status of nsetcat
  • Display status of nssystemcommand
  • Display status of nssiren

On state (novastar all state):

  • Display configuration state of nsdbrep
  • Display configuration state of nsautointer
  • Display configuration state of nsrecdata
  • Display configuration state of ns50386server
  • Display configuration state of nsmapdisplay
  • Display configuration state of nsalerttalk3
  • Display configuration state of nsetcat
  • Display configuration state of nssystemcommand
  • Display configuration state of nssiren

Command Line Usage

The command must be run as the root user.

The command line syntax is:

novastar5 [options...] [subsystem] {start|stop|restart|status|state|force-start|force-restart} [portname]

novastar5 [options...] {start|stop|restart|status|state|force-start|force-restart} [portname]

Command line parameter options are:

Parameter Description Default
-h
-help
--help		 Display help.
-net Execute on all replication nodes. ?
-version
--version		 Print program version.

The subsystem parameters are:

Parameter          Description Default
all Control all data collection processes. Default
dbrep Control database replication processes.
alert Control ALERT data collection processes and portname is the optional port name to control, for example:
alert_port1, alert_port2, ...		 portname default is to control all.
50386 Control 50386 data collection processes and portname is the optional port name to control, for example:
50386_port1, 50386_port2, ...		 portname default is to control all.
autointer Control automatic interrogation processes.
mapdisplay Control map display processes.
alerttalk3 Control AlertTalk3 processes.
netcat Control netcat processes.
siren Control novastar5 siren processes.
systemcommand Control system command processes.
system Control novastar5 system start.

The force-start parameter enables the process state in the configuration table by setting the record value to true before executing the start-up script. The start parameter simply executes the start-up script.

Examples

The following is an example of a typical system start:

$ sudo novastar5 start
[ ok ] Starting NovaStar5 system start: /usr/bin/novastar5 start.
[ ok ] Starting NovaStar5 System command on dleadernb3: /usr/bin/nssystemcommand :.
[ ok ] Starting NovaStar5 Network serial port pipe on dleadernb3: /usr/bin/nsnetcat /dev/siren1 -fnsatifilter -l -nnovastar5 -p8501:.
[ ok ] Starting NovaStar5 Network serial port pipe on dleadernb3: /usr/bin/nsnetcat /dev/siren1 -fnsatifilter -nnovastar5 -p8502:.
[ ok ] Starting NovaStar5 ALERT data collection on dleadernb3: /usr/bin/nsrecdata /dev/rtdd1 :.
[ ok ] Starting NovaStar5 ALERT data collection on dleadernb3: /usr/bin/nsrecdata 192.168.1.91:2101 -a2 -S1 -r1minute:.
[ ok ] Starting NovaStar5 ALERT data collection on dleadernb3: /usr/bin/nsrecdata 192.168.1.90:4200 -Galert2 -a1 -S4,2 -r5minutes:.
[ ok ] Starting NovaStar5 Automatic interrogation on dleadernb3: /usr/bin/nsautointer :.
[ ok ] Starting NovaStar5 Map display on dleadernb3: /usr/bin/nsmapdisplay -n:8502 -U1,2:.
[ ok ] Starting NovaStar5 AlertTalk3 on dleadernb3: /usr/bin/nsalerttalk3 -n:8503 -U1,2:.
[ ok ] Starting NovaStar5 siren on dleadernb3: /usr/bin/nssiren /dev/siren1 hormann:.

Scheduling

The script is not run on a schedule. However, once programs are started, nshealthcheck may restart some processes.

NovaStar Administrator Interface

On the Configuration List menu, click Configuration Edit on system_up. At the page bottom in the Execute section, the novastar5 command is executed with the network state and action selected. For example, the following illustrates restarting the system.

NovaStar restart

For individual data collection such as alert_data_collection, the Execute section executes the novastar5 program with the network state, the alert control type, and the action selected, as shown below:

alert_data_collection

Troubleshooting

The novastar5 program log file can be found in the following location: /var/log/novastar5/novastar5.log.