rash(1) User Commands rash(1)NAMErash - Radmind Assistant
SYNOPSIS
ra.sh [ -cIltV ] [ -% | -q ] [ -C generate | -C checksum ] [ -D work‐
ingdir ] [ -h server ] [ -p port ] [ -r path ] [ -U user ] [ -w auth‐
level ] { trip | update | create | auto | force | checkout | checkin }
DESCRIPTIONrash is a command line application for running the Radmind tool set.
It can be used to run the entire radmind process including updating a
client, running a tripwire and creating loadsets. On machines with
multiple administrators, rash can be used to limit conflicts from mul‐
tiple administrators simultaneously using the tool.
rash is run with a required option telling it what process to run:
update, auto, force, create, trip, checkout or checkin.
A machine can be updated by using either the update, auto or force
option. update will prompt the user at each step in the process. auto
will update the machine without any input, looping when possible to
handle temporary problems such as networking issues or a busy server.
auto is suitable to be run as an automated process. force updates a
machine without looping or prompting for input and is handy for quick,
manual updates.
create is used to store a loadset on the radmind server in an interac‐
tive fashion. Before creating a transcript, rash first checks to see
if the command file and transcripts are correct and prompts the user to
update them if needed. The user can also edit the transcript before it
is stored on the server.
trip is used to run a tripwire on the system. If the command file and
transcripts are correct, a full tripwire is run with checksums. Any
differences are printed to the screen in a format suitable for e-mailed
machine reporting.
checkout is used to prevent other users from concurrently running rash.
It is helpful when an administrator is installing new software or con‐
figuring a client and does not want their work removed. Only the user
who checked out a machine can run rash unless a new checkout is forced
from an interactive rash session. An e-mail is sent to the previous
users when a checkout is overridden. As trip does not modify the sys‐
tem, it can be run at any time, regardless of who has checked out the
machine. checkin is used to release a machine. Only the user who
checked out a machine may check it back in.
checkin and checkout both use $USER to determine who is performing the
command. $USER can be overridden using the -U option.
The -c option can be used to turn on checksums for fsdiff. The only
supported checksum is SHA1.
rash supports running arbitrary scripts before and after lapply.
Preapply scripts located in PREAPPLY are run before lapply, and postap‐
ply scripts located in POSTAPPLY are run after. The first argument
passed to each script is the full path to apply-able transcript.
OPTIONS
-% Tell fsdiff(1) , lapply(1) , and lcreate(1) to use
percentage done progress output.
-c use sha1 checksums.
-C generate Print a sha1 checksum of the difference transcript
of applied changes. For use with auto, force or
update.
-C checksum In auto mode, exit with an error if the checksum of
the difference transcript to be applied does not
match checksum. In update or force mode, warn if
the two do not match.
-D workingdir change to workingdir before running. Default is "/".
-h hostname specifies the radmind server, by default radmind.
-I Tell fsdiff(1) , ktcheck(1) , and lapply(1) to use
case-insensitive matching.
-l Prompt for remote user name. The -U option disables
this prompt.
-p port Specifies the port to connect to the server on, by
default 6222.
-q Tell lapply(1) and lcreate(1) to operate quietly.
-r path specifies root path from which fsdiff will start its
scan of the filesystem
-t use tempfiles
-U user specifies the user. By default, $USER will be used.
-V displays the version of rash and exits.
-w auth-level TLS authorization level, by default 0. 0 = no TLS,
1 = server verification, 2 = server and client veri‐
fication.
EXIT STATUS
The following exit values are returned:
0 successful.
>1 An error occurred.
SEE ALSOfsdiff(1), ktcheck(1), lapply(1), lcksum(1), lcreate(1), lfdiff(1),
lmerge(1), lsort(1), twhich(1), radmind(8).
RSUG December 12, 2010 rash(1)