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.
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:
Troubleshooting
The novastar5
program log file can be found in the following location:
/var/log/novastar5/novastar5.log
.