p10cfgd(1)

NAME

p10cfgd - remote configuration daemom for Gracilis Pack

eTen

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 re

quested 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 ex

ample, 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 in

formation stored
in the EEPROM should include enough information to set

the PackeTen up
to allow communications with the primary and the sec

ondary server.
This would include commands to set MYCALL and the IP_AD

DRESS, to attach
an interface to the channel with the server, routing in

formation and so
forth. A sample EEPROM configuration for

a PackeTen,
empire.wd0fhg.ampr.org [44.32.0.32], that gets its config

uration 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.

7th Edition July 29, 1993

P10CFGD(1)