#!/usr/bin/perl
NAME¶
p10cfgd - remote configuration daemom for Gracilis PackeTen
SYNOPSIS¶
p10cfgd [IP_PORT]
COPYRIGHT¶
Copyright (c) 1993 by Colorado Digital Eclectics (CODE)
All rights reserved.
DESCRIPTION¶
Rmtcfgd is a server program used to send configuration files to a
Gracilis PackeTen. It can be run in background or it can be run by inetd. If
p10cfgd is to be run by inetd, add the following line to
/etc/services
rmtcfg 1236/tcp # Remote Configuration of PackeTen
and add the following to
/etc/inetd.conf
# Remote configuration service for PackeTen
rmtcfg stream tcp nowait root /usr/bin/p10cfgd p10cfgd
P10cfgd normally does not require the IP_PORT parameter. It listens for
connections on IP Port 1236 as a default.
The program will send on a line by line basis the file requested by the client
that connects on the IP Port. The only expected input from the client is the
file name. When the file has been sent, the connection is closed. The
requested file must be in the directory /etc/p10cfgd.
Rmtcfgd maintains a log of its activity in the file /var/log/p10cfgd.log.
Program startup and all connections are logged in the file with GMT time
stamps. The file is opened in append mode.
The protocol used by the PackeTen is very simple. The PackeTen opens a tcp
connection to port 1236 on a host system. Once the connection is made, the
PackeTen sends the name of the file it wants to the host. The host then opens
the file and sends it line by line to the PackeTen until all lines have been
sent. The files to be transfered must be plain text files and each line must
have at least one character in addition to the newline at the end.
P10cfgd replaces all blank lines with lines that contain two spaces. If
you wish to send a blank line, to stop loading of part of a LocalInfo file for
example, place an underscore '_' at the begining of the line. The entire
contents of the line will be deleted and a blank line will be sent to the
client. At the end of the file, the server sends a time command ( time
MMDDYYHHMM ) with the UTC time on the server. This will either set the time on
the PackeTen or add a time stamp to the LocalInfo file. The server then closes
the connection.
The remote configuration command used on the PackeTen is
rmtcfg <server_host> <filename> [options]
The valid options are
-t <timeout in seconds> default is 60 sec
-p <IP port #> default is 1236
-i the file is for LocalInfo
-h <secondary server> if the primary does not answer
The rmtcfg commands would be placed in to the EEPROM on the PackeTen so that
they would be executed during a reboot. The information stored in the EEPROM
should include enough information to set the PackeTen up to allow
communications with the primary and the secondary server. This would include
commands to set MYCALL and the IP_ADDRESS, to attach an interface to the
channel with the server, routing information and so forth. A sample EEPROM
configuration for a PackeTen, empire.wd0fhg.ampr.org [44.32.0.32], that gets
its configuration from a remote system winfree.n3eua.ampr.org [44.32.0.2],
over a 9600 baud ax25 path would be:
# first the general setup of the PackeTen
ee hostname gw.wd0fhg
ee sitename empire
ee ipaddr 44.32.0.32
ee mycall WD0FHG
# Then we attach a 9600 ax25 interface as ax1
ee attach sync302 1 hdx ax25 ax1 8192 256 9600 ext ext nrzi
# and set the default route to send every thing out ax1
ee route add default ax1 44.32.0.1
ee password sure-thing
#
# Now we will ask for the remainder of the setup
# from the server winfree.n3eua.ampr.org [44.32.0.2]
# Note that we have a secondary server available at
# [44.20.0.195] that would be used if winfree is down.
# first the Local Information file
ee com 0 rmtcfg 44.32.0.2 empire.info -i -h 44.20.0.195
# and then the remaining configuration command file
ee com 1 rmtcfg 44.32.0.2 empire.cfg -h 44.20.0.195
#
ee save
# end-of-eeprom setup
Rmtcfgd started life as the simple server program in PERL by Larry Wall
and R.L. Schwartz published by ORA,Inc.
ENVIRONMENT¶
No environment variables are used.
FILES¶
/etc/p10cfgd/* - files that can be accessed remotely
/var/log/p10cfgd.log - p10cfgd log file
AUTHOR¶
John Conner, WD0FHG, conner@empire.com
hacked on by Bdale Garbee, N3EUA, bdale@gag.com.
SEE ALSO¶
Gracilis, Inc. PackeTen Manual and NOS User's Manual
DIAGNOSTICS¶
Complains if it can't open a file to remote client and to log file.