Black Box 1101 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