]> git.sur5r.net Git - bacula/bacula/blob - bacula/src/qt-console/help/joblist.html
Merge branch 'master' of ssh://bacula.git.sourceforge.net/gitroot/bacula
[bacula/bacula] / bacula / src / qt-console / help / joblist.html
1 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">
2 <HTML>
3 <HEAD>
4 <TITLE>Bat User's Guide</TITLE>
5 <META NAME="description" CONTENT="Bat User's Guide">
6 <META NAME="keywords" CONTENT="bacula">
7 <META NAME="resource-type" CONTENT="document">
8 <META NAME="distribution" CONTENT="global">
9 <META HTTP-EQUIV="Content-Style-Type" CONTENT="text/css">
10 </HEAD>
11
12 <BODY>
13 <h1 align="center">Bat User's Guide</h1>
14 <br>
15
16 <h4>The JobList Interface</h4>
17 <font size=+1>
18
19 <p>The JobList interface displays a table of jobid's which are instances of
20 a job having been run.  The table displays data for each job stored in the
21 daemons sql backend.  The table currently includes the job name, the client name,
22 the job type, the job level, the number of files, the number of bytes, the status,
23 and a flag for the jobs files that have been purged or not, and the jobs
24 fileset.
25
26 <p>The job type is either "B" for backup or "R" for restore.  
27
28 <p>The job level is one of "I" for incremental or "F" for full or "D" for differential.
29
30 <p>A purged value of yes means that the files for that job have been purged from the 
31 catalog's file table.  Purged jobs are not be able to have their files browsed when
32 restoring from a job with that jobid.
33
34 <p>This interface uses a splitter to divide the display of the table and the controls
35 used to modify the selection criterion.  There are 7 drop down boxes that can be used
36 to filter out the records in the table and to view only the items you are interested
37 in.  There are two limiting spin boxes and related check boxes that can be used to 
38 limit the number of and the age of the records that are to be displayed.  These limiting
39 controls begin with default values that can be configured in the Settings->Preferences
40 dialog box in the JobList tab.
41
42 <p>Pushing the Refresh button causes the interface to re-query the database.  The
43 database does also get requerried every time it comes back to the top of the stack of
44 interfaces in the main window.  Another refresh option exists in the popup when right
45 clicking on the Joblist item in the Page Selector.
46
47 <p>Pushing the Graph button opens up a new JobPlot interface.  All of the 
48 drop downs and limiting controls in the JobPlot window default to the current
49 settings of the controls in the JobList interface.  If the graph button is not there,
50 bat was not compiled with qwt libraries.
51
52 <p>There are many options in the context sensitive popup that appear when the user
53 right clicks on an item in the job table.
54
55 <p>Listing console commands can be run to list the jobid, list the files on that jobid,
56 list the jobmedia for that jobid, and list the volumes used for that jobid.  There is
57 a preferences item to determine whether a long list or a short list command is run.
58 It can be found from the menu by following settings - preferences then the miscellaneous
59 tab.
60
61 <p>Dangerous commands of delete and purge are preceded by an "Are You Sure?" dialog
62 box.
63
64 <p>An interface to view the logs that have been stored in the database for the jobid 
65 can be viewed by using the show log for job option.
66 If the database does not have a log, an popup explaining the modification that
67 may be made to the bacula-dir.conf file appears.  The change is to add
68 "catalog = all" to the messages stanza of the messages resource that this job uses.
69
70 <p>Restore from job opens up the Select Jobs interface.  It opens prepopulated
71 with the correct data to open up a standard restore interface displaying the
72 filestructure backed up when the job ran.  It displays only the files from this job
73 if you don't change the controls in the "Select jobs interface"
74
75 <p>Restore from time populates the Select Jobs interface with the endtime of the job
76 populated in the Before Time entry box.  This causes the daemon to use the Before
77 Time to select the appropriate job id's for the restore.  This contains the most recent
78 full backup, the most recent differential backup done since the most recent full, and 
79 all the incremental backups done since the most recent full or differential.  This job
80 set is considered the best possible to restore to what the filesystem looked like
81 after that job ran.
82
83 </BODY>
84 </HTML>