Configuring the journal engine service

Journal-based backup can be used for all Windows clients. If you install the journal engine service and it is running, then by default the incremental command automatically performs a journal-based backup on selected file systems that are being monitored by the journal engine service.

About this task

Journal-based backup is enabled by installing and configuring the IBM Spectrum® Protect journal service. You can install the journal service with the GUI Setup wizard or with the dsmcutil command. Basic journal service configuration can be done with the GUI Setup wizard, more advanced configuration can be done by editing the journal service configuration file, tsmjbbd.ini.

Tip: The default location for journal service configuration file is C:\Program Files\Tivoli\TSM\baclient\tsmjbbd.ini. If this is the first time you are configuring the journal engine service and a copy of tsmjbbd.ini does not already exist, copy the sample file C:\Program Files\Tivoli\TSM\config\tsmjbbd.ini.smp to C:\Program Files\Tivoli\TSM\baclient\tsmjbbd.ini.

To install and configure this service using the client Java™ GUI setup wizard, perform the following steps:

Procedure

From the main window, open the Utilities menu and select Setup Wizard.
Select the Help me configure the Journal Engine check box.
Select the task you want to perform. You can install a new journal engine, update a previously installed journal engine, or remove a previously installed journal engine from your system.
Complete each panel in the wizard and click the Next button to continue. To return to a previous panel, click the Back button. To display help information for a panel, click the Help button.

Results

Journal service configuration settings are stored in the journal configuration file tsmjbbd.ini. This file can be installed and configured with the GUI setup wizard or be manually edited.

Follow these steps to set up multiple journal services:

Create and set up a separate journal configuration file (tsmjbbd.ini) for each journal service to be installed. Each configuration file must specify a different JournalPipe value, and must also specify different drives to journal, so that the two services do not interfere with each other. Multiple journal services journaling the same drive causes problems. The different services attempts to write to the same journal database unless this is specifically overridden by specifying different journal directories in the different configuration files.
Install the multiple journal services using the dsmcutil.exe tool. Use distinct names for each service, and specify the /JBBCONFIGFILE option to identify the tsmjbbd.ini to be used for that particular journal instance. For example:
```
dsmcutil install journal /name:"TSM Journal Service 1" /JBBCONFIGFILE:c:\journalconfig\tsmjbbd1.ini  
```
```
dsmcutil install journal /name:"TSM Journal Service 2" /JBBCONFIGFILE:d:\journalconfig\tsmjbbd2.ini
```
Note: In Uniform Naming Convention (UNC) format, the jbbconfigfile path must contain a drive letter. In the following UNC format example, the path contains the drive letter D$: \\computer7\D$\journalconfig\tsmjbbd1.ini
Different backup clients (based on the distinct dsm.opt file used) can now connect to the desired journal service by specifying the appropriate JournalPipe option in the appropriate dsm.opt, which corresponds to the JournalPipe journal service setting.

Note:

Each journal service instance is associated to only one backup-archive client node name. Changing the association requires a restart of the journal service to recognize the new association.
You cannot use network and removable file systems.

Configuration settings that you apply when the journal service is started and any changes you make while the journal service is running are applied without having to restart the service. This also applies to the journal exclude list. However, some settings for journaled file systems do not take effect until the file system is brought offline and then back online.

File systems can be taken online (added) or offline (removed) without stopping and restarting the journal service. You can bring a file system offline by removing it from the list of journaled file systems in the journal configuration file tsmjbbd.ini, or by shutting down the journal service. You can bring a file system back online by adding it to the list of journaled file systems in the journal configuration file tsmjbbd.ini or by starting (restarting) the journal service.

Attention: If you take a file system offline without setting the PreserveDbOnExit value of 1, the journaled file system journal database is deleted. PreserveDbOnExit=1 specifies that the journaled file system journal database is not deleted when the journal file system goes offline. The database is also valid when the journal file system comes back online.

The following is the syntax for stanza and stanza settings:

Syntax for stanzas:: [StanzaName]
Syntax for stanza settings:: stanzaSetting=value

Note:

You can specify comments in the file by beginning the line with a semicolon.
Stanza and value names are not case sensitive.
Numeric values can be specified in hexadecimal by preceding the value with 0x otherwise they are interpreted as decimal.
There is no correlation between these settings and any settings in the backup-archive client options file. The journal service is a completely independent process and does not process backup-archive client options.