Chapter 4.  DFdiscover Configuration

Table of Contents

4.1. Define DFdiscover capable printer
4.2. Start DFdiscover
4.3. (Re-)configure DFdiscover Master
4.4. Configure Incoming and Outgoing Processes
4.5. Configuration Complete
[Important]Upgrade installation

These steps are required for a new installation only. If this is an upgrade install, execute

# systemctl start dfdiscover.service

to restart DFdiscover. Then complete Define DFdiscover capable printer and skip to Study Installation.

This chapter completes the configuration of DFdiscover. After completing these steps, DFdiscover will be operational.

4.1.  Define DFdiscover capable printer

DFdiscover is able to print to printers that are either local to the server or networked. The printers must already be configured and named on the DFdiscover server, which is typically a UNIX administration issue. Given the set of printer names which are known to the system, that complete set, or a subset thereof, needs to be configured in DFdiscover. This is done by creating the file /opt/dfdiscover/lib/DFprinters.

Define DFdiscover printers

  1. Edit, or create, /opt/dfdiscover/lib/DFprinters

    Use your favorite editor to edit this file.

  2. Add default printer name first

    Of all of the printers that have been identified as being DFdiscover capable, identify the one that will be the default, and add that printer name as the first line of the file. The order that the names appear in the file dictates the order in which they are displayed in any DFdiscover print dialog.

  3. Add additional printers, if any

    Each additional printer name should be added, one per line, following the default printer name.

  4. Save file

    Save the changes made to /opt/dfdiscover//lib/DFprinters and exit the editor [DF10].

4.2. Start DFdiscover

It's time to start the DFdiscover services [DF12]. Before doing so confirm that a valid DFdiscover license is installed in /opt/dfdiscover/work/license.

To start the DFdiscover services, type:

% /opt/dfdiscover/bin/DFbootstrap

The output will be similar to the following:

DFmaster.rpcd: your software license expires in 365 days
1. Checking state of incoming daemons...

2. Checking /opt/dfdiscover/work/.dfincoming_work...
  0 stale incoming entries obsoleted

3. Checking /opt/dfdiscover/incoming...
  0 faxes awaiting processing.
DFmaster.rpcd: started.
Done.

The DFdiscover services have now been started - continue with the next section. If an error prevents the DFdiscover services from starting, it is essential to fix the problem before continuing - the steps in the remaining sections will fail.

The remaining steps in this chapter must be executed by user datafax. Exit the super-user shell and become user datafax.

4.3.  (Re-)configure DFdiscover Master

Start the DFdiscover system administration application with the command:

% DFadmin

The system administration application is used to configure the DFdiscover master process.

Configure DFdiscover Master [DF06]

  1. Login to the DFdiscover administration application

    If this is the first time that the administration application is used, enter the nickname or fully qualified name for the licensed DFdiscover server in the Server field. The Login Name is datafax and the Password is passwd (this is a one-time password that must immediately be changed after authentication). Click Login.

    Figure 4.1. Typical login dialog appearance

    Typical login dialog appearance


  2. Click master to display the Master dialog

    A complete description of the dialog and the meaning of the individual fields can be found in DFadmin System Administrator Guide, DFadmin - Master DFadmin - Master. Complete the fields as follows.

    1. Bootstrap Slave Hosts

      The default value for this field is the hostname of the DFdiscover server. If the default is not filled in, enter the hostname. Multiple hostnames (comma-delimited) are only required when multiple DFdiscover servers are available.

    2. Default Printer

      The value of this field is the name of a local printer. Typically, this should be the same default printer defined in [DF10].

      Study-specific printers are defined at study creation time.

  3. Select File > Save to save the changes

    The values specified in the dialog are saved.

4.4.  Configure Incoming and Outgoing Processes

Incoming and outgoing fax processsing is handled by third-party software: DFdiscover can work with either HylaFAX or the Protus fax service. DFdiscover communicates with the fax software or service by means of inbound and outbound processes that are configured using DFadmin.

At this point configure an incoming daemon [DF08] and configure an outgoing daemon [DF09]. A complete description of the configuration process can be found in DFadmin System Administrator Guide, DFadmin - TrafficDFadmin - Traffic.

4.5. Configuration Complete

DFdiscover configuration is now complete. Take this opportunity to update the worksheet. The next chapter describes several optional integration tests that should be completed to demonstrate that the installation is operating in the expected manner.