External Scripts And Alerts - Tripp Lite B092-016 Owner's Manual

Chapter 15: Advanced Configuration
portmanager daemon
There is normally no need to stop and restart the daemon. To restart the daemon normally, just run the command:
# portmanager
Supported command line options are:
Force portmanager to run in the foreground:
Set the level of debug logging:
Change which configuration file it uses:
Signals
Sending a SIGHUP signal to the portmanager will cause it to re-read its configuration file

15.2.2 External Scripts and Alerts

The portmanager has the ability to execute external scripts on certain events.
When a port is opened by the portmanager:
• When the portmanager opens a port, it attempts to execute /etc/config/scripts/portXX.init (where XX is the number of the
port, e.g. 08). The script is run with STDIN and STDOUT both connected to the serial port.
• If the script cannot be executed, then portmanager will execute /etc/config/scripts/portXX.chat via the chat command on
the serial port.
When an alert occurs on a port:
• When an alert occurs on a port, the portmanager will attempt to execute /etc/config/scripts/portXX.alert (where XX is the
port number, e.g. 08)
• The script is run with STDIN containing the data which triggered the alert, and STDOUT redirected to /dev/null, NOT to the
serial port. If you wish to communicate with the port, use pmshell or pmchat from within the script.
• If the script cannot be executed, then the alert will be mailed to the address configured in the system administration
section.
When a user connects to any port:
• If a file called /etc/config/pmshell-start.sh exists it is run when a user connects to a port. It is provided 2 arguments, the
"Port number" and the "Username". Here is a simple example:
</etc/config/pmshell-start.sh >
#!/bin/sh
PORT="$1"
USER="$2"
echo "Welcome to port $PORT $USER"
< /etc/config/pmshell-start.sh>
• The return value from the script controls whether the user is accepted or not, if 0 is returned (or nothing is done on exit as
in the above script) the user is permitted, otherwise the user is denied access.
--nodaemon
--loglevel={debug,info,warn,error,alert}
-c /etc/config/portmanager.conf
211