git.sur5r.net Git - bacula/bacula/blob - bacula/src/qt-console/help/restore.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 <font size=+1>
  16
  17 <h2>The Two Restore Interfaces</h2>
  18
  19 <p>Both interfaces accomplish the same three steps.
  20 The steps are to select jobs to restore from, give the user the
  21 opportunity to select files/directories, then indicate details such as
  22 the host and path to restore to and trigger the job to run.
  23
  24 <h2>The Standard Restore Interface</h2>
  25
  26 <p>Start the standard restore procedure by pressing the restore button
  27 in the task bar.  There are also two options in the joblist context sensitive
  28 menu to start a restore.  They are Restore From Time or Restore From Job.
  29
  30 <p>This restore method is intended as a high performance option.
  31 It is a server side process.  These interfaces assist the user in utilizing the
  32 text based restore capabilities of the standard console.  It interprets the text
  33 to display the information in a way that simplifies the restore procedure.
  34
  35 <p>The Opening interface allows the user to choose selection criterion to
  36 inform the server how to determine the set of backup job ids to use in the
  37 restore.  This best possible set is he most recent full backup, the most
  38 recent differential backup done since the most recent full, and all the
  39 incremental backups done since the most recent full or differential.  Then the
  40 server uses this set of jobs to create a file structure that is the
  41 most recent version of each file found in this job list.
  42
  43 <p>After the select box OK button has been pressed, a limitation in bat
  44 occurs that will be resolved in the future.  The restore process takes control
  45 of the connection to the server and does not allow any other communication to
  46 the server by any other interface.
  47
  48 <p>The second interface allows the user to browse this file structure and
  49 choose the files and directories to restore.  This is done in an explorer
  50 type interface with a directory tree on the left.  In the right pane of a
  51 splitter is a table showing a list of files and directories that are the
  52 contents of the directory selected in the left pane.  The user can mark and
  53 unmark either with the buttons on the top or by double clicking on the check
  54 mark icon to toggle whether an item is selected or not.  Double clicking an
  55 item which is a directory on a part of the table which is not the check icon
  56 opens that directory.  Clicking 'OK' completes the selection process.
  57
  58 <p>The third step is the Restore Run interface.  It's purpose is to allow the
  59 user to inform the bacula server details of the host and path to restore to, the
  60 replacement rules, when to restore and what priority to give the restore job.
  61
  62 <h2>The Version Browser Restore Interface</h2>
  63
  64 <p>The Version Browser restore option does not have the same connection
  65 limitations as the standard restore during the file and directory selection
  66 process.  The user can have an unlimited number of selection windows open at a
  67 time for viewing the cataloged jobs, directories, files and versions.
  68
  69 <p>This restore interface is <b>NOT</b> intended to perform major restores of directory
  70 structures with large numbers of directories and files.  It should work, however
  71 it is a chatty interface.  This is due to the number of sql queries made of the server
  72 which is proportional to the number of files and directories selected plus the number of
  73 exceptions to defaults selected.  It <b>IS</b> intended to allow the user to browse for
  74 specific files and choose between the different versions of those files that
  75 are available in the catalog to restore.
  76
  77 <p>The interface contains a horizontal splitter.  The bottom pane contains
  78 some controls for the interface.
  79 The top portion contains a vertical splitter with 4 panes for viewing the
  80 cataloged information.  The left pane is for viewing and further sub selecting
  81 of jobs.  The second pane is for viewing the directory tree.  The third is for
  82 viewing a list of files in a directory that has been selected.  Then
  83 lastly the fourth pane is for viewing a table of versions of a single file
  84 that has been selected from the file table.
  85
  86 <p>The version browser accomplishes the three restore steps differently.
  87
  88 <p>To select jobs and populate the directory tree, press the refresh button.
  89 The job table contains selected jobs.  The selection criterion of the three
  90 dropdowns and the two limits are used as the filtering criterion for
  91 populating the job table the first time the refresh button is pushed.
  92 After the refresh button has been pushed, the job table has check marks that
  93 can selects and unselects jobs.  Re-pressing the refresh button does one of two
  94 things.  What occurs is dependent on if the controls in the bottom pane
  95 display the same data as the previous time the refresh button was pressed.  If
  96 changed the jobs table is repopulated from the selection criterion.  If
  97 unchanged any jobs that have been unchecked are excluded from the
  98 process of selecting directories, files and versions.  The directory tree does get
  99 repopulated when the refresh button is pushed.  There is a text label underneath the
 100 refresh button to inform the user as to which occurs when refresh is pressed.
 101
 102 <p>The user can browse the directory tree and click on a directory folder which
 103 then populates the file table with the files that are contained in the
 104 selected directory path.  Selecting or unselecting a directory does also select or
 105 unselect all files and all directories in the tree hierarchy beneath it.  If
 106 there are any exceptions already selected beneath that directory, those
 107 exceptions do get deleted.
 108
 109 <p>With the file table populated, the user can unselect a file in a selected
 110 directory and also select a file in an unselected directory.
 111
 112 <p>With a file selected the version table populates with all the instances
 113 a file has been written to tape.  The user can choose a specific version of a
 114 file for restore and override the default which is to restore the most recent
 115 version.
 116
 117 <p>Pressing the restore button initiates a procedure preparing to
 118 perform the restore of the requested files.  The same Restore Run interface
 119 that was the third step in the standard restore is then displayed.  It
 120 allows the user to instruct the bacula server of the details of what host
 121 and what path to restore the files to.  This part of the restore does take control
 122 of the connection to the server and does not allow any other communication
 123 to the server by the other interfaces.
 124
 125 <p>There are two progress bars that appear when refreshing or after pressing
 126 Restore.  These indicate to the user the time it may take to complete any tasks
 127 that could take a long time period.
 128
 129 </BODY>
 130 </HTML>