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 <h3>The Two Restore Interfaces</h3>
  18
  19 <p>Both restore interfaces accomplish the same 3 steps in different ways.
  20 Those steps are to select jobs to restore from, give the user the
  21 opportunity to select files and directories and then run the restore job.
  22
  23 <h2>The Standard Restore Interface</h2>
  24
  25 <p>Start the standard restore procedure by pressing the restore button
  26 in the task bar.  There are also two options in the joblist context sensitive
  27 menu to start a restore.  They are restore from time or restore from job.
  28
  29 <p>This interface is intended as a high performance restore option.
  30 It is a server side interaction to perform the steps by utilizing the
  31 text based restore capabilities of bacula.  It interprets interactions with the
  32 server and displays a graphical front end for the user.
  33
  34 <p>The Opening interface will allow the user to choose selection criterion to
  35 inform the server how to determine the set of backup job ids to use in the
  36 restore.  This best possible set will be the most recent full backup, the most
  37 recent differential backup done since the most recent full, and all the
  38 incremental backups done since the most recent full or differential.  Then the
  39 server will use this set of jobs to create a file structure that will be the
  40 most recent version of each file found in this job list.
  41
  42 <p>After the select box OK button has been pushed, a limitation in bat will
  43 occur that will be resolved in future.  The restore process will take control
  44 of the connection to the server and will not allow any other communication to
  45 the server by any other interface.
  46
  47 <p>The second interface will allow the user to browse this file structure and
  48 choose the files and directories to restore.  This will be done in an explorer
  49 type interface with a directory tree on the left.  In the right pane of a
  50 splitter will be a table showing a list of files and directories that are the
  51 contents of the directory selected in the left pane.  The user can mark and
  52 unmark either with the buttons on the top or by double clicking on the check
  53 mark icon to toggle whether an item is selected or not.  Double clicking an
  54 item which is a directory on a part of the table which is not the check icon
  55 will open that directory.  Clicking on OK will complete the selection process.
  56
  57 <p>The third step is a drop down interface that appears to be similar to the
  58 first but is different.  It is the Restore Run interface and will run the job
  59 after allowing the user to inform the bacula server details of what host and
  60 where to restore the files to.
  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 NOT intended to preform major restores of directory
  70 structures with large numbers of directories and files.  It should work, however
  71 it is a chatty interface and will perform a number of sql queries of the server
  72 proportional to the number of files and directories selected and the number of
  73 exceptions to defaults selected.  It IS 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 controlling widgets for the interface.
  79 The top pane contains a vertical splitter with 4 widgets for viewing the
  80 cataloged information.  The left widget 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 widget is for viewing a table of versions of a single file
  84 that has been selected from the file widget.
  85
  86 <p>The version browser accomplishes the 3 restore steps, but does it a little
  87 differently.
  88
  89 <p>To select jobs and populate the directory tree, press the refresh button.
  90 The job table will contain selected jobs.  The selection criterion of the three
  91 drop downs and the 2 limits will be used as the filtering criterion for
  92 populating the job table the first time the refresh button is pushed.
  93 After the refresh button has been pushed, the job table has check marks that
  94 can select and unselect jobs.  Re-pressing the refresh button will do one of 2
  95 things and this is dependent on whether the widgets in the bottom control pane
  96 display the same data as the previous time the refresh button was pressed.  If
  97 changed the jobs table will be repopulated from the selection criterion.  If
  98 unchanged any jobs that have been unchecked will then be excluded from the
  99 process of selecting directories, files and versions.  The directory tree will
 100 be immediately repopulated.  There is a text label underneath the
 101 refresh button to inform the user as to which of these two will happen.
 102
 103 <p>The user can browse the directory tree and click on a directory folder which
 104 will then populate the file table with the files that are contained in the
 105 selected directory path.  Selecting or unselecting a directory will select or
 106 unselect all files and all directories in the tree hierarchy beneath it.  If
 107 there are any exceptions already selected beneath that directory, those
 108 exceptions will be deleted.
 109
 110 <p>With the file table populated, the user can unselect a file in a selected
 111 directory and also select a file in an unselected directory.
 112
 113 <p>With a file selected the version table will populate with all the instances
 114 a file has been written to tape.  The user can choose a specific version of a
 115 file for restore and override the default which is to restore the most recent
 116 version.
 117
 118 <p>Pressing the restore button will initiate a procedure of preparing to
 119 perform the restore of the requested files.  The same Restore Run interface
 120 that was the third step in the standard restore will then be displayed.  It
 121 will allow the user to instruct the bacula server of the details of what host
 122 and what path to restore the files to.  This part of the restore will take a
 123 hold of the connection to the server and not allow any other communication
 124 to the server by the other interfaces.
 125
 126 <p>There are two progress bars that will appear when refreshing or restoring
 127 to allow the user to understand how much time it may take to complete any tasks
 128 that could take a long time period.
 129
 130 </BODY>
 131 </HTML>