Except where noted, these commands are entered at the sushi prompt. The sushi program is currently installed in /s/sushi/bin/sushi. You probably want to add /s/sushi/bin to your .cshrc.local (or equiv.) startup file.
Description: list failed atoms
Synopsis: atom listfailed atom-options
This command lists failed atoms in the database. Without any options or parameters, it will list the atoms in the current day's default group. A different group can be specified, for instance, to see the failed atoms for a different day.
See atom-options for a description of how to specify options to the atom commands.Description: reschedule failed atoms
Synopsis: atom reschedulefailed atom-options
Reschedule failed atoms in today's group. Without any options or parameters, reschedules all the failed atoms in today's group. Can be passed --type, --id, or --name options to only reschedule certain atoms.
See atom-options for a description of how to specify options to the atom commands.
Description: list atoms, with options
Synopsis: atom list atom-options [(--weights|-w)] [(--results|-r)] [(--output|-o)]
Without options, print atoms that match the atom-options, one per line. Some atom option(s) should generally be specified to limit the number of atoms returned. Options specific to this sub-command are:
Description: show results for an atom across groups
Synopsis: atom history atom-options [--failed|-f] [--stats|-s]
This is the "sushi-finder" command. Given an atom by name or id, it will list all the successful results for that atom. This can be used to select suitable records for a sushi restore operation. Options specific to this sub-command are:
See atom-options for a description of how to specify options to the atom commands.
Description: send an atom stream to stdout
Synopsis: restore atom-options [(--timestamp|-t) timestamp] [--force]
Opens the requested result record, and sends the dump stream to stdout. atom-options specify the atom (specify either group+type+name or atom id).
The optional timestamp (either a 10-digit number, a sushi short format date string yyyymmdd.hhmmss, or a time string parsable by the perl Time::ParseDate library) of the desired result record. If the timestamp is not specified, sushi chooses a successful result for the specified atom. The timestamp option can be combined with the --force option to examine the contents of a failed dump. The timestamp can be copied from the atom history or atom list commands.
This command is typically used from the unix command line and piped to the appropriate restore command, as in:
% sushi restore --id 52623 | vos restore alice /vicepr U.THOMAS
To restore a workstation atom directly on that host, become root on the host and run a command like:
# ssh -n -x -2 -l your-user-name sushi sushi restore --id 129894 | restore rf -
(note that the exact syntax of the restore command will vary between operating systems)
See atom-options for a description of how to specify options to the atom commands.
If you need to restore an atom that is larger than 2GB to
a linux local disk, you need to run the sushi restore using
bash (
Description: retrieve the sushi daemon log.
Synopsis: showlog [(--follow|-f)]
Given without the --follow option, gives that last 24 hours of sushi daemon log data. With the --follow option, prints the last 10 messages, and then queries the database every 2 seconds for more logging data. Because of the volume of data given, and the fact that this command never exits (use ^C), it is generally typed at the unix shell, as in:
% sushi showlog | less
or
% sushi showlog --follow
The general form of atom command options is:
[% sushi] atom command [(--schedule_group|-g) group] [(--type|-t) atom-type] [(--name|-n) atom-name] [(--id|-i) atom-id] [(--state|-s) atom-state] [(--level|-l) dump-level] [group [atom-type [atom-name]]]
When giving an atom command (atom list, atom history, etc.), options to limit the atoms operated on by the command may be specified in any order. The first three non-option parameters will be interpreted as the schedule-group, atom-type, and atom-name, in that order.
Because of this, if you want to specify an atom by id or name, you need to identify it with the --name and --id options, respectively.