
#include "bacula_template.inc" title="Console Configuration" num=5.4

<H1>Console Configuration</H1>

<h2>General</h2>
The Console configuration file is the simplest of all the 
configuration files, and in general, you should not need to
change it except for the password. 
It simply contains the information necessary to
contact the Director or Directors.

<p>For a general discussion of configuration file and resources
including the data types recognized by <b>Bacula</b>, please
see the <a href="configure.html">Configuration</a> chapter of this
manual.
<p>
The following Console Resource definition must be defined:
<ul> 
  <li><a href="#DirectorResource">Director</a> -- to
      define the Director's name and his access password. Note,
      you may define more than one Director resource in the 
      Console configuration file. If you do so, the Console program
      will ask you which one you want to use.</li>
</ul>

<h2><a name="DirectorResource">The Director Resource</a></h2>
The Director resource defines the attributes of the Director running on
the network. 
You may have multiple Director resource specifications in a
single Console configuration file. If you have 
more than one, you will be prompted to choose one when you start
the <b>Console</b> program. 
<dl>
<dt>Director</dt><dd>Start of the Director records.
<dt>Name = &lt;name&gt;</dt><dd>The director name used by the system administrator.
   This name must be identical to the <b>Name</b> specified in
   the <b>Director</b> resource of the <a
   href="dirdconf.html">Director's configuration</a> file.
    
<dt>DIRPort = &lt;port-number&gt;</dt><dd>Specify the port to use to connect
   to the Director. This value will most likely already be set to the value
   you specified on the <b>--with-base-port</b> option of the
   <b>./configure</b> command.  This port must be identical to the
   <b>DIRport</b> specified in the <b>Director</b> resource of the <a
   href="dirdconf.html">Director's configuration</a> file.
   The default is 9101 so this record is not normally specified.</dd>

<dt>Address = &lt;address&gt;</dt><dd>Where the address is a host name,
   a fully qualified domain name, or a network address used to connect
   to the Director.</dd>

<dt>Password = &lt;password&gt;</dt><dd>Where the password is the
   password needed for the Director to accept the Console connection.
   This password must be identical to the <b>Password</b> specified in
   the <b>Director</b> resource of the <a
   href="dirdconf.html">Director's configuration</a> file. This
   record is required.</dd>

</dl>
An actual example might be:
<pre>
Director {
  Name = HeadMan
  address = rufus.cats.com
  password = xyz1erploit
}
</pre>

<h2>The ConsoleFont Resource</a></h2>
The ConsoleFont resource is available only in the GNOME version
of the console. It permits you to define the font that you
want used to display in the main listing window.
<dl>
<dt>ConsoleFont</dt><dd>Start of the ConsoleFont records.
<dt>Name = &lt;name&gt;</dt><dd>The name of the font.</dd>
    
<dt>Font = &lt;X-Window Font Specification&gt;</dt><dd>
   The string value given here defines the desired font. It
   is specified in the standard cryptic X Window format.  For
   example, the default specification is:
   <pre>
    Font = "-misc-fixed-medium-r-normal-*-*-130-*-*-c-*-iso8859-1"
   </pre>
   </dd>

</dl>
Thanks to Phil Stracchino for providing the code for this feature.
<p>
An actual example might be:
<pre>
ConsoleFont {
  Name = Default
  Font = "-misc-fixed-medium-r-normal-*-*-130-*-*-c-*-iso8859-1"
}

</pre>

<h2>Console Commands</h2>
For more details on running the console and its commands, please
see the <a href="console.html">Bacula Console</a> chapter
of this manual.


<h2><a name="SampleConfiguration">Sample Console Configuration File</a></h2>
A example Console configuration file might be the following:
<pre>
\#
\# Bacula Console Configuration File
\#

Director {
  Name = HeadMan
  address = "my_machine.my_domain.com"
  Password = Console_password
}
</pre>

<page_prev name="Messages Resource" url="messagesres.html">
<page_next name="Variable Expansion" url="vars.html">
