Black Box 1101 Marine Safety Devices User Manual


 
1101 and 1102 Secure Device Servers
724-746-5500 | blackbox.com
136

Black Box console servers run the embedded Linux operating system. So Administrator class users can configure the console server and monitor and
manage attached serial console and host devices from the command line using Linux commands and the config utility as described in Chapter 14.
The Linux kernel in the console server also supports GNU bash shell script enabling the Administrator to run custom scripts. This chapter presents a
number of useful scripts and scripting tools including:
delete-node which is a general script for deleting users, groups, hosts, UPSes etc.
ping-detect which will run specified commands when a specific host stops responding to ping requests.
This chapter then details how to perform advanced and custom management tasks using Black Box commands, Linux commands, and the open
source tools embedded in the console server:
portmanager serial port management
raw data access to the ports and modems
iptables modifications and updating IP filtering rules
modifying SNMP with net-snmpd
public key authenticated SSH communications
SSL, configuring HTTPS and issuing certificates
using pmpower for NUT and PowerMan power device management
using IPMItools
CDK custom development kit

The console server supports GNU bash shell commands (refer to the Appendix) enabling the Administrator to run custom scripts.

The /etc/config/rc.local script runs whenever the system boots. By default, this script file is empty. You can add any commands to this file if you want
them to run at boot time (for example, if you wanted to display hello world:)
#!/bin/sh
echo "Hello World!"
If this script has been copied from a Windows machine, you may need to run the following command on the script before bash can run it
successfully:
# dos2unix /etc/config/rc.local
Another scenario would be to call another custom script from the /etc/config/rc.local file, making sure that your custom script will run whenever the
system is booted.

Whenever an alert gets triggered, specific scripts get called. These scripts all reside in /etc/scripts/. Below is a list of the default scripts that run for
each applicable alert:
For a connection alert (when a user connects or disconnects from a port or network host): /etc/scripts/portmanager-user-alert (for port connections)
or /etc/scripts/sdt-user-alert (for host connections)
For a signal alert (when a signal on a port changes state): /etc/scripts/portmanager-signal-alert
For a pattern match alert (when a specific regular expression is found in the serial ports character stream): /etc/scripts/portmanager-pattern-alert
For a UPS status alert (when the UPS power status changes between on line, on battery, and low battery): /etc/scripts/ups-status-alert