kboot

Section: Maintenance Commands (8)
Updated: 25 October 90
Index Return to Main Contents

NAME

kboot - Monitor and reboot Fastpath 4 gateways.

SYNOPSIS

kboot [-bclrs fastpath] [-d] [-i interface] [-p int] [-t fastpath [server]] [-v] [-w]

DESCRIPTION

kboot is a program that can monitor, load and configure Kinetics/Shiva Fastpath 4 gateways over an ethernet from a Sun running SunOS 4.x.

kboot will only talk to fastpaths specified in the configuration file /usr/local/etc/kbootcf. The format of this file is simply the hostname of each fastpath, followed by white space and the name of the KSTAR software to be downloaded in the event that kboot reloads the fastpath. The KSTAR program filename in the configuration file should be relative to the directory where the configuration file is, by default this is /usr/local/etc.

kboot gets an appletalk node number from a separate daemon called aarpd(8) via an RPC call. aarpd must be running for kboot to work.

kboot reads the fastpath's ethernet address from /etc/ethers (or equivalent NIS map), each fastpath managed by kboot must have its correct ethernet address in that file.

Each configured fastpath should have a corresponding state file. These can be obtained in one of two ways. They can be generated using the fastpath manager program on a Mac, in which case they should be transferred to the file /usr/local/etc/<fastpath>.config on the host kboot is running on. Alternatively, the current state vector of a fastpath can be read directly from the fastpath using the -s option of kboot. In this case the state will be saved as /usr/local/etc/<fastpath>.state. If both files exist, the file generated by the fastpath manager (.config) will be used.

Sending kboot a HUP signal while it's in "watch" mode will cause kboot to reread the configuration file kbootcf. This is useful after editing the configuration file.

OPTIONS

-b fastpath: Download KSTAR program and state to specified fastpath gateway.
-c fastpath: Download state to specified fastpath gateway.
-d: Turn on debugging.
-l fastpath: Read state from specified fastpath and print various fields.
-i interface: Specify interface name (eg ie1). Defaults to first interface in kernel.
-p int: Set ping interval, in seconds.
-r fastpath: Reset specified fastpath.
-s fastpath: Read state vector from specified fastpath and save to a file. This file can be used for downloading later.
-t fastpath [server]: Ask kboot running in "watch" mode (see -w option below) on server to reload the specified fastpath. Useful for forcing a reboot without killing a currently running kboot daemon, manually reloading with -b, and restarting the daemon.
-w: Put kboot in "watch" mode. In this mode, kboot will periodically ping the fastpaths specified in the config file, rebooting them if they don't answer. kboot will also listen for RPC requests sent by interactively run kboot processes requesting reloads (see -t option).
-v: Print kboot version number.

FILES

/usr/local/etc/kbootcf: Configuration file.
/usr/local/etc/<fastpath>.config: Ascii fastpath configuration as generated by fastpath manager.
/usr/local/etc/<fastpath>.state: Binary state vector read from fastpath.

BUGS

kboot depends on the SunOS 4.x NIT interface and probably isn't very portable.

kboot can only download/configure fastpaths on the same ethernet that the host kboot is running on is attached to.

AUTHOR

Bob Schwartzkopf, The RAND Corporation. Much credit is due Dan Tappan of BBN, who wrote the first version of kboot that ran on SunOS 3.x, and Phil Budne of Shiva, who helped make it work with KSTAR 8.0.

This document was created by man2html, using the manual pages.
Time: 11:02:52 GMT, January 11, 2023