DragonFly On-Line Manual Pages

Search: Section:  


rash(1)                          User Commands                         rash(1)

NAME

rash - Radmind Assistant

SYNOPSIS

ra.sh [ -cIltV ] [ -% | -q ] [ -C generate | -C checksum ] [ -D workingdir ] [ -h server ] [ -p port ] [ -r path ] [ -U user ] [ -w authlevel ] { trip | update | create | auto | force | checkout | checkin }

DESCRIPTION

rash 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 multiple 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 interactive 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 configuring 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 system, 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 postapply 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 verification.

EXIT STATUS

The following exit values are returned: 0 successful. >1 An error occurred.

SEE ALSO

fsdiff(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)

Search: Section: