User Tools

Site Tools


bacula_manual:the_director_resource

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
Next revision
Previous revision
bacula_manual:the_director_resource [2013/03/25 15:01]
afromnorth [Example]
bacula_manual:the_director_resource [2013/03/27 07:20] (current)
afromnorth [DirAddresses = IP-address-specification]
Line 1: Line 1:
-===== The Director Resource =====+====== The Director Resource ​======
  
 The Director resource defines the attributes of the Directors running on the network. In the current implementation,​ there is only a single Director resource, but the final design will contain multiple Directors to maintain index and media database redundancy. The Director resource defines the attributes of the Directors running on the network. In the current implementation,​ there is only a single Director resource, but the final design will contain multiple Directors to maintain index and media database redundancy.
  
-==== Director ====+===== Director ​=====
 Start of the Director resource. One and only one director resource must be supplied. Start of the Director resource. One and only one director resource must be supplied.
  
-=== Name = name ===+==== Name = name ====
 The director name used by the system administrator. The director name used by the system administrator.
  
 This directive is required. This directive is required.
  
-=== Description = text ===+==== Description = text ====
 The text field contains a description of the Director that will be displayed in the graphical user interface. The text field contains a description of the Director that will be displayed in the graphical user interface.
  
 This directive is optional. This directive is optional.
  
-=== Password = UA-password ===+==== Password = UA-password ​====
 Specifies the password that must be supplied by a Bacula Console to be authorized. The same password must appear in the Director resource of the Console configuration file. For added security, the password is never passed across the network but instead a challenge response hash code created with the password. Specifies the password that must be supplied by a Bacula Console to be authorized. The same password must appear in the Director resource of the Console configuration file. For added security, the password is never passed across the network but instead a challenge response hash code created with the password.
  
Line 23: Line 23:
 This directive is required. If you have either /dev/random or bc on your machine, Bacula will generate a random password during the configuration process, otherwise it will be left blank and you must manually supply it. This directive is required. If you have either /dev/random or bc on your machine, Bacula will generate a random password during the configuration process, otherwise it will be left blank and you must manually supply it.
  
-=== Messages = Messages-resource-name ===+==== Messages = Messages-resource-name ​====
 The Messages resource specifies where to deliver Director messages that are not associated with a specific Job. Most messages are specific to a job and will be directed to the Messages resource specified by the job. However, there are a few messages that can occur when no job is running; they'​ll be sent to this messages-resource/​ The Messages resource specifies where to deliver Director messages that are not associated with a specific Job. Most messages are specific to a job and will be directed to the Messages resource specified by the job. However, there are a few messages that can occur when no job is running; they'​ll be sent to this messages-resource/​
  
 This directive is required. This directive is required.
  
-=== Working Directory = Directory ===+==== Working Directory = Directory ​====
 This directive is mandatory and specifies a directory in which the Director may put its status files. This directory should be used only by Bacula but may be shared between Bacula daemons on the same machine. If this directory is shared with other Bacula daemons (the File daemon and Storage daemon), you must ensure that the Name given to each daemon is unique so that the temporary filenames created will not collide. This directive is mandatory and specifies a directory in which the Director may put its status files. This directory should be used only by Bacula but may be shared between Bacula daemons on the same machine. If this directory is shared with other Bacula daemons (the File daemon and Storage daemon), you must ensure that the Name given to each daemon is unique so that the temporary filenames created will not collide.
  
Line 39: Line 39:
 This directive is required. ​ This directive is required. ​
  
-=== PID Directory = Directory ===+==== PID Directory = Directory ​====
 This directive specifies a directory in which the Director may put its process ID file. The process ID file is used to shutdown Bacula and to prevent multiple copies of Bacula from running simultaneously. Standard shell expansion of the Directory is done when the configuration file is read so that values such as $HOME will be properly expanded. This directive specifies a directory in which the Director may put its process ID file. The process ID file is used to shutdown Bacula and to prevent multiple copies of Bacula from running simultaneously. Standard shell expansion of the Directory is done when the configuration file is read so that values such as $HOME will be properly expanded.
  
Line 48: Line 48:
 This directive is required. This directive is required.
  
-=== Scripts Directory = Directory ===+==== Scripts Directory = Directory ​====
 This directive specifies a directory in which the Director (say *that* three times fast with marbles in your mouth :-) will look for the Python startup script DirStartup.py. This directory may be shared by other Bacula daemons. Standard shell expansion of the directory is done when the configuration file is read so that values such as $HOME will be properly expanded. This directive specifies a directory in which the Director (say *that* three times fast with marbles in your mouth :-) will look for the Python startup script DirStartup.py. This directory may be shared by other Bacula daemons. Standard shell expansion of the directory is done when the configuration file is read so that values such as $HOME will be properly expanded.
  
 This directive is optional. This directive is optional.
  
-=== QueryFile = Path ===+==== QueryFile = Path ====
 This directive is mandatory and specifies a directory and file in which the Director can find the canned SQL statements for the Query command of the Console. Standard shell expansion of the Path is done when the configuration file is read so that values such as $HOME will be properly expanded. This directive is mandatory and specifies a directory and file in which the Director can find the canned SQL statements for the Query command of the Console. Standard shell expansion of the Path is done when the configuration file is read so that values such as $HOME will be properly expanded.
  
 This directive is required. This directive is required.
  
-=== Heartbeat Interval = time-interval ===+==== Heartbeat Interval = time-interval ​====
 This directive will cause the Director to set a keepalive interval (heartbeat) in seconds on each of the sockets it opens for the Client resource. This value will override any specified at the Director level. It is implemented only on systems (Linux, ...) that provide the setsockopt TCP_KEEPIDLE function. The default value is zero, which means no change is made to the socket. This directive will cause the Director to set a keepalive interval (heartbeat) in seconds on each of the sockets it opens for the Client resource. This value will override any specified at the Director level. It is implemented only on systems (Linux, ...) that provide the setsockopt TCP_KEEPIDLE function. The default value is zero, which means no change is made to the socket.
  
 This directive is optional. This directive is optional.
  
-=== Maximum Concurrent Jobs = number ===+==== Maximum Concurrent Jobs = number ​====
 where number is the maximum number of total Director Jobs that should run concurrently. The default is set to 1, but you may set it to a larger number. where number is the maximum number of total Director Jobs that should run concurrently. The default is set to 1, but you may set it to a larger number.
  
 The Volume format becomes more complicated with multiple simultaneous jobs, consequently,​ restores may take longer if Bacula must sort through interleaved volume blocks from multiple simultaneous jobs. This can be avoided by having each simultaneous job write to a different volume or by using data spooling, which will first spool the data to disk simultaneously,​ then write one spool file at a time to the volume thus avoiding excessive interleaving of the different job blocks. The Volume format becomes more complicated with multiple simultaneous jobs, consequently,​ restores may take longer if Bacula must sort through interleaved volume blocks from multiple simultaneous jobs. This can be avoided by having each simultaneous job write to a different volume or by using data spooling, which will first spool the data to disk simultaneously,​ then write one spool file at a time to the volume thus avoiding excessive interleaving of the different job blocks.
  
-=== FD Connect Timeout = time ===+==== FD Connect Timeout = time ====
 where time is the time that the Director should continue attempting to contact the File daemon to start a job, and after which the Director will cancel the job. The default is 30 minutes. where time is the time that the Director should continue attempting to contact the File daemon to start a job, and after which the Director will cancel the job. The default is 30 minutes.
  
-=== SD Connect Timeout = time ===+==== SD Connect Timeout = time ====
 where time is the time that the Director should continue attempting to contact the Storage daemon to start a job, and after which the Director will cancel the job. The default is 30 minutes. where time is the time that the Director should continue attempting to contact the Storage daemon to start a job, and after which the Director will cancel the job. The default is 30 minutes.
  
-=== DirAddresses = IP-address-specification ===+==== DirAddresses = IP-address-specification ​====
 Specify the ports and addresses on which the Director daemon will listen for Bacula Console connections. Probably the simplest way to explain this is to show an example: Specify the ports and addresses on which the Director daemon will listen for Bacula Console connections. Probably the simplest way to explain this is to show an example:
  
 <​code>​ <​code>​
-     DirAddresses ​ = {  +DirAddresses ​ = {  
-        ip = { addr = 1.2.3.4; port = 1205;} +    ip = { addr = 1.2.3.4; port = 1205;} 
-        ipv4 = { +    ipv4 = { 
-            addr = 1.2.3.4; port = http;} +        addr = 1.2.3.4; port = http;} 
-        ipv6 = { +    ipv6 = { 
-            addr = 1.2.3.4; +        addr = 1.2.3.4; 
-            port = 1205; +        port = 1205;
-        } +
-        ip = { +
-            addr = 1.2.3.4 +
-            port = 1205 +
-        } +
-        ip = { addr = 1.2.3.4 } +
-        ip = { addr = 201:​220:​222::​2 } +
-        ip = { +
-            addr = bluedot.thun.net +
-        }+
     }     }
 +    ip = {
 +        addr = 1.2.3.4
 +        port = 1205
 +    }
 +    ip = { addr = 1.2.3.4 }
 +    ip = { addr = 201:​220:​222::​2 }
 +    ip = {
 +        addr = bluedot.thun.net
 +    }
 +}
 </​code>​ </​code>​
  
Line 102: Line 102:
 Please note that if you use the DirAddresses directive, you must not use either a DirPort or a DirAddress directive in the same resource. Please note that if you use the DirAddresses directive, you must not use either a DirPort or a DirAddress directive in the same resource.
  
-=== DirPort = port-number ===+==== DirPort = port-number ​====
 Specify the port (a positive integer) on which the Director daemon will listen for Bacula Console connections. This same port number must be specified in the Director resource of the Console configuration file. The default is 9101, so normally this directive need not be specified. This directive should not be used if you specify DirAddresses (N.B plural) directive. Specify the port (a positive integer) on which the Director daemon will listen for Bacula Console connections. This same port number must be specified in the Director resource of the Console configuration file. The default is 9101, so normally this directive need not be specified. This directive should not be used if you specify DirAddresses (N.B plural) directive.
  
-=== DirAddress = IP-Address ===+==== DirAddress = IP-Address ​====
 This directive is optional, but if it is specified, it will cause the Director server (for the Console program) to bind to the specified IP-Address, which is either a domain name or an IP address specified as a dotted quadruple in string or quoted string format. If this directive is not specified, the Director will bind to any available address (the default). Note, unlike the DirAddresses specification noted above, this directive only permits a single address to be specified. This directive should not be used if you specify a DirAddresses (N.B. plural) directive. This directive is optional, but if it is specified, it will cause the Director server (for the Console program) to bind to the specified IP-Address, which is either a domain name or an IP address specified as a dotted quadruple in string or quoted string format. If this directive is not specified, the Director will bind to any available address (the default). Note, unlike the DirAddresses specification noted above, this directive only permits a single address to be specified. This directive should not be used if you specify a DirAddresses (N.B. plural) directive.
  
-=== DirSourceAddress = IP-Address ===+==== DirSourceAddress = IP-Address ​====
 This record is optional, and if it is specified, it will cause the Director server (when initiating connections to a storage or file daemon) to source its connections from the specified address. Only a single IP address may be specified. If this record is not specified, the Director server will source its outgoing connections according to the system routing table (the default). This record is optional, and if it is specified, it will cause the Director server (when initiating connections to a storage or file daemon) to source its connections from the specified address. Only a single IP address may be specified. If this record is not specified, the Director server will source its outgoing connections according to the system routing table (the default).
  
-=== Statistics Retention = time ===+==== Statistics Retention = time ====
 The Statistics Retention directive defines the length of time that Bacula will keep statistics job records in the Catalog database after the Job End time. (In JobHistory table) When this time period expires, and if user runs prune stats command, Bacula will prune (remove) Job records that are older than the specified period. The Statistics Retention directive defines the length of time that Bacula will keep statistics job records in the Catalog database after the Job End time. (In JobHistory table) When this time period expires, and if user runs prune stats command, Bacula will prune (remove) Job records that are older than the specified period.
  
Line 120: Line 120:
 The default is 5 years. The default is 5 years.
  
-=== VerId = string ===+==== VerId = string ​====
 Where string is an identifier which can be used for support purpose. This string is displayed using the version command. Where string is an identifier which can be used for support purpose. This string is displayed using the version command.
  
-=== MaxConsoleConnections = number ===+==== MaxConsoleConnections = number ​====
 Where number is the maximum number of Console Connections that could run concurrently. The default is set to 20, but you may set it to a larger number. Where number is the maximum number of Console Connections that could run concurrently. The default is set to 20, but you may set it to a larger number.
-==== Example ====+====== Example ​======
 The following is an example of a valid Director resource definition: The following is an example of a valid Director resource definition:
  
-<​code>​+<​code ​c>
 Director { Director {
   Name = HeadMan   Name = HeadMan
bacula_manual/the_director_resource.1364223718.txt.gz · Last modified: 2013/03/25 15:01 by afromnorth