From bb085b762b63fd6d075caa73e351a0f8b1e05361 Mon Sep 17 00:00:00 2001 From: Dirk H Bartley Date: Tue, 7 Aug 2007 15:39:00 +0000 Subject: [PATCH] More refining of the help text. git-svn-id: https://bacula.svn.sourceforge.net/svnroot/bacula/trunk@5298 91ce42f0-d328-0410-95d8-f526ca767f89 --- bacula/src/qt-console/help/clients.html | 16 +++++++------ bacula/src/qt-console/help/filesets.html | 6 ++--- bacula/src/qt-console/help/index.html | 11 ++++----- bacula/src/qt-console/help/joblist.html | 12 +++++----- bacula/src/qt-console/help/jobplot.html | 6 ++--- bacula/src/qt-console/help/jobs.html | 10 ++++---- bacula/src/qt-console/help/media.html | 21 +++++++++-------- bacula/src/qt-console/help/restore.html | 30 ++++++++++++------------ bacula/src/qt-console/help/storage.html | 15 ++++++------ 9 files changed, 65 insertions(+), 62 deletions(-) diff --git a/bacula/src/qt-console/help/clients.html b/bacula/src/qt-console/help/clients.html index cd479238db..3bdf5aa6a9 100644 --- a/bacula/src/qt-console/help/clients.html +++ b/bacula/src/qt-console/help/clients.html @@ -16,15 +16,17 @@

The Clients Interface

-

The Clients interface will show a list of clients and allow the -user to right click on a client item to popup a context sensitive menu. The list of -clients is a tree structure and will show a number of attributes from the database -for each client. +

The Clients interface shows a list of configured client resources. This +list of clients is a tree structure and shows a number of attributes from the +database for each client. -

The context sensitive menu will allow the user to perform commands in the -console that may be run with the desired client having been identified. These +

The user may right click on a client item to display a context sensitive menu +of what actions can be performed on a client. This menu has +options to allow the user to perform commands in the console. These commands include requesting the status of the client, and pruning or purging -jobs and files from the catalog. +jobs and files from the catalog. There is also an option to open up a JobList +interface with the control for clients already prepopulated with the selected +client item.

To understand pruning and purging, please read the Bacula documentation at the following URL: http://www.bacula.org/rel-manual/Bacula_Console.html diff --git a/bacula/src/qt-console/help/filesets.html b/bacula/src/qt-console/help/filesets.html index a8ae3a303f..c93397bb60 100644 --- a/bacula/src/qt-console/help/filesets.html +++ b/bacula/src/qt-console/help/filesets.html @@ -16,12 +16,12 @@

The Filesets Interface

-

The Filesets interface will show a list of filesets and allow the +

The Filesets interface shows a list of filesets and allow the user to right click on a specific fileset to popup it's context sensitive menu. -This interface is a tree structure and each item will display a number of +This interface is a tree structure and each item displays a number of attributes from the database for each fileset. -

The context sensitive menu will allow the user to perform the command status +

The context sensitive menu allows the user to perform the command status fileset in the console. The user can also open up a new JobList window with the Fileset dropdown pre-populated with the selected fileset. diff --git a/bacula/src/qt-console/help/index.html b/bacula/src/qt-console/help/index.html index 0982cacc91..c0ff20ee23 100644 --- a/bacula/src/qt-console/help/index.html +++ b/bacula/src/qt-console/help/index.html @@ -41,14 +41,13 @@ run from bconsole, and more.

The bat is bconsole with extra communication capabilities and a set of graphical user interfaces that utilize those capabilities. A bat programmer is able to create interfaces that interact with the director in all ways that a user -can, by executing commands. When a command is entered by an interface, bat -will type in the command in the console. Often times the interface visible will -change to the console so that the user can read the command as well as the +can, by executing commands. When a command is entered by an interface, the bat +types in the command in the console. Often times the interface visible is +changed to the console so that the user can read the command as well as the resulting output from the director. Bat can also perform requests of the daemon, that the user would not normally do. These requests would include the ability to -retrieve lists of various resources and to perform instruct the director -to query director daemon's sql server. The director will then forward the -query results to bat. +retrieve lists of various resources and to instruct the director +to query the sql server. The director then forwards the query results to bat. diff --git a/bacula/src/qt-console/help/joblist.html b/bacula/src/qt-console/help/joblist.html index e8fc9f9f39..367e36d3e0 100644 --- a/bacula/src/qt-console/help/joblist.html +++ b/bacula/src/qt-console/help/joblist.html @@ -16,8 +16,8 @@

The JobList Interface

-

The JobList interface will display a table of job id's which are instances of -a job being run. The table will display data for each job stored in the +

The JobList interface displays a table of jobid's which are instances of +a job having been run. The table displays data for each job stored in the daemons sql backend. The table currently includes the job name, the client name, the job type, the job level, the number of files, the number of bytes, the status, and a flag for the jobs files that have been purged or not, and the jobs @@ -48,7 +48,7 @@ drop downs and limiting controls in the JobPlot window default to the current settings of the controls in the JobList interface.

There are many options in the context sensitive popup that appear when the user -right clicks on the job table. +right clicks on an item in the job table.

Listing console commands can be run to list the jobid, list the files on that jobid, list the jobmedia for that jobid, and list the volumes used for that jobid. There is @@ -62,15 +62,15 @@ box.

An interface to view the logs that have been stored in the database for the jobid can be viewed by using the show log for job option. If the database does not have a log, an popup explaining the modification that -should be made to the bacula-dir.conf file appears. The change is to add -catalog = all to the messages stanza of the messages resource that this job uses. +may be made to the bacula-dir.conf file appears. The change is to add +"catalog = all" to the messages stanza of the messages resource that this job uses.

Restore from job opens up the Select Jobs interface. It opens prepopulated with the correct data to open up a standard restore interface displaying the filestructure backed up when the job ran. It displays only the files from this job if you don't change the controls in the "Select jobs interface" -

Restore from time populateis the Select Jobs interface with the endtime of the job +

Restore from time populates the Select Jobs interface with the endtime of the job populated in the Before Time entry box. This causes the daemon to use the Before Time to select the appropriate job id's for the restore. This contains the most recent full backup, the most recent differential backup done since the most recent full, and diff --git a/bacula/src/qt-console/help/jobplot.html b/bacula/src/qt-console/help/jobplot.html index 27981ca076..2d4624e952 100644 --- a/bacula/src/qt-console/help/jobplot.html +++ b/bacula/src/qt-console/help/jobplot.html @@ -16,9 +16,9 @@

The JobPlot Interface

-

The JobPlot interface will have all of the same selection widgets as the -JobList interface. It will also have widgets that will affect the plot's -display. These settings will be saved and used the next time the interface +

The JobPlot interface has all of the same selection controls as the +JobList interface. It also has controls that affects the plot's +display. These settings are saved and used the next time the interface is opened. The user can change the Graph type to one of sticks, lines, steps or none. The user can also turn one or both of the plots off with the File Data and the Byte Data check boxes. The symbol type for each plot's points diff --git a/bacula/src/qt-console/help/jobs.html b/bacula/src/qt-console/help/jobs.html index b3ddeba6e1..27f02126b7 100644 --- a/bacula/src/qt-console/help/jobs.html +++ b/bacula/src/qt-console/help/jobs.html @@ -16,10 +16,10 @@

The Jobs Interface

-

The Jobs interface shows a table of job resources. The data displayed +

The Jobs interface shows a tree of configured job resources. The data displayed for each job in this list are the defaults for the job resource as defined in the bacula-dir configuration file. When a job is run due to being scheduled, -these defaults are the values that will be used. They are also the values +these defaults are the values that are used. They are also the values that are populated by default if the job is run manually.

The context sensitive popup menu includes a number of options. There are @@ -49,8 +49,10 @@ definition.

The open joblist option is to open a new JobList interface and pre-populate the job dropdown list with the jobs resource name. -

The run job option is to open the run job interface prepopulating the job -dropdown box with the selected job. +

The run job option is to open the Run a Job interface prepopulating the job +dropdown box with the selected job. With the job name in the job dropdown box +of the Run a Job interface, the remainder of the controls are populated with +the jobs defaults. diff --git a/bacula/src/qt-console/help/media.html b/bacula/src/qt-console/help/media.html index b09e7e5f8e..c30726f291 100644 --- a/bacula/src/qt-console/help/media.html +++ b/bacula/src/qt-console/help/media.html @@ -21,20 +21,21 @@ pool branch, are items representing the volumes in the pool. The display shows data that are the values in the database for each volume. With this interface, the user can manage tape volumes and file volumes. -

The context sensitive menu allows the user to open up other interfaces -and to perform commands in the console that may be run with the desired media -having been identified. These commands include deleting the volume, purging -the jobs and files backed up on the volume from the catalog, and pruning the -jobs and files on the catalog that meet the selection criterion configured in +

When the user right clicks on a volume item, a context sensitve menu appears +that shows the actions that can be performed on this volume. This menu allows +the user to open up other interfaces and to perform commands in the console. +There are command options that modify the catalog. These commands include +deleting the volume, purging the jobs/files which have been written to the volume, and pruning the +jobs/files that meet the pruning criterion configured in bacula-dir.conf. There is also a command to reset the parameters on the volumes based on the parameters of the pool resource. -

Other interfaces can be opened up from the context sensitive menu. The user -may open up a JobList interface. This interface is opened with the media -drop down control preselected This shows jobs that have been written to the -volume. The user can open up the Relabel a Volume dialog box. The user can also open +

Other interfaces can be opened up from the context sensitive menu. +The user can open up the Relabel a Volume dialog box. The user can also open up the Edit a Volume interface which allows the user to modify all user -editable data items for the volume. +editable data items for the volume. Another interface that may be opened is +the JobList. When created the media drop down control is preselected to the +volume. It lists jobs which have been written to the volume. diff --git a/bacula/src/qt-console/help/restore.html b/bacula/src/qt-console/help/restore.html index e032ac1ef9..447d0e15d1 100644 --- a/bacula/src/qt-console/help/restore.html +++ b/bacula/src/qt-console/help/restore.html @@ -16,25 +16,25 @@

The Two Restore Interfaces

-

Both restore interfaces accomplish the same 3 steps in different ways. -Those steps are to select jobs to restore from, give the user the -opportunity to select files and directories, then indicate details of -the host and path to restore to and run the job. +

Both interfaces accomplish the same three steps. +The steps are to select jobs to restore from, give the user the +opportunity to select files/directories, then indicate details such as +the host and path to restore to and trigger the job to run.

The Standard Restore Interface

Start the standard restore procedure by pressing the restore button in the task bar. There are also two options in the joblist context sensitive -menu to start a restore. They are restore from time or restore from job. +menu to start a restore. They are Restore From Time or Restore From Job. -

This interface is intended as a high performance restore option. +

This restore method is intended as a high performance option. It is a server side process. These interfaces assist the user in utilizing the text based restore capabilities of the standard console. It interprets the text to display the information in a way that simplifies the restore procedure.

The Opening interface allows the user to choose selection criterion to inform the server how to determine the set of backup job ids to use in the -restore. This best possible set is be the most recent full backup, the most +restore. This best possible set is he most recent full backup, the most recent differential backup done since the most recent full, and all the incremental backups done since the most recent full or differential. Then the server uses this set of jobs to create a file structure that is the @@ -46,9 +46,9 @@ of the connection to the server and does not allow any other communication to the server by any other interface.

The second interface allows the user to browse this file structure and -choose the files and directories to restore. This is be done in an explorer +choose the files and directories to restore. This is done in an explorer type interface with a directory tree on the left. In the right pane of a -splitter is be a table showing a list of files and directories that are the +splitter is a table showing a list of files and directories that are the contents of the directory selected in the left pane. The user can mark and unmark either with the buttons on the top or by double clicking on the check mark icon to toggle whether an item is selected or not. Double clicking an @@ -66,7 +66,7 @@ limitations as the standard restore during the file and directory selection process. The user can have an unlimited number of selection windows open at a time for viewing the cataloged jobs, directories, files and versions. -

This restore interface is NOT intended to preform major restores of directory +

This restore interface is NOT intended to perform major restores of directory structures with large numbers of directories and files. It should work, however it is a chatty interface. This is due to the number of sql queries made of the server which is proportional to the number of files and directories selected plus the number of @@ -75,13 +75,13 @@ specific files and choose between the different versions of those files that are available in the catalog to restore.

The interface contains a horizontal splitter. The bottom pane contains -some controlling widgets for the interface. -The top pane contains a vertical splitter with 4 widgets for viewing the -cataloged information. The left widget is for viewing and further sub selecting +some controls for the interface. +The top portion contains a vertical splitter with 4 panes for viewing the +cataloged information. The left pane is for viewing and further sub selecting of jobs. The second pane is for viewing the directory tree. The third is for viewing a list of files in a directory that has been selected. Then -lastly the fourth widget is for viewing a table of versions of a single file -that has been selected from the file widget. +lastly the fourth pane is for viewing a table of versions of a single file +that has been selected from the file table.

The version browser accomplishes the three restore steps differently. diff --git a/bacula/src/qt-console/help/storage.html b/bacula/src/qt-console/help/storage.html index 1609ad2e86..fa6fbb4b79 100644 --- a/bacula/src/qt-console/help/storage.html +++ b/bacula/src/qt-console/help/storage.html @@ -16,15 +16,14 @@

The Storage Interface

-

The Storage interface shows a list of storage resoruces and allows the -user to right click on a storage to popup a context sensitive menu. The list of -configured storage device resources is a tree structure and shows the storage id -and the auto changer flag. +

The Storage interface shows a list of configured storage device resources. +The list is a tree structure and shows the storage id and the auto changer flag. -

The context sensitive menu allows the user to perform commands in the -console that may be run with the desired storage having been identified. These -commands include requesting the status of the storage, and to mount, unmount and -release the media in the storage device. +

The interface allows the user to right click on an item to popup a context +sensitive menu of the actions that can be performed with that storage device. +The actions allow performing commands in the console. The commands include +requesting the status of the storage, and to mount, unmount or release the media +in the storage device.

If the autochanger flag is true, two additional options in the context sensitive menu are found. These are options to run the command to update slots -- 2.39.5