Managing Archive Directory Location

A host in a NuoDB domain has an archive directory and a journal directory for each NuoDB database served by local transaction engines or storage managers. This page describes the default locations for these directories and mechanisms for overriding the defaults.

For each database, the default directory names are as follows:

• The database's archive directory has the same name as the database.
• The database's journal directory has the name dbname/journal.

For example, a database named test has a test archive directory and a test/journal journal directory.

About Default Base Directories for Archive and Journal

There is a system defined directory that is the base directory for all archive and journal folders. The table below shows the host tags used to define the archive and journal base directory.

Directory	Host Tag That Specifies It	Default Value of That Host Tag
Default base for archive directory	default_archive_base	Linux: /var/opt/nuodb/production-archives/test Linux tar installations: $NUODB_HOME/var/opt/nuodb/production-archives/test Windows: %ALLUSERPROFILE%\nuodb\var\production-archives/test
Default base for journal directory	default_journal_base	Linux: /var/opt/nuodb/production-archives/test/journal Linux tar installations: $NUODB_HOME/var/opt/nuodb/production-archives/test/journal Windows: %ALLUSERPROFILE%\nuodb\var\production-archives/test/journal

To use NuoDB Manager to view the value of the default_archive_base host tag, invoke the tags command. For example:

nuodb [domain] > tags search name default_archive_base
ec2-54-165-58-157.compute-1.amazonaws.com/172.31.46.122:48004 (us-east-1): 
   default_archive_base = /var/opt/nuodb/production-archives

Overriding Default Base Directories for Archive and Journal

You can override where NuoDB creates its archive and journal folders on a host by host basis. Do this by setting the value of the archive_base and journal_base host tags, which override the values of the default_archive_base and default_journal_base host tags. These two tags, archive_base and journal_base are special, modifiable system-provided tags.

Viewing Current Base Directories for Archive and Journal

In the NuoDB Manager, to view the current base directories for the archive and journal, invoke the tags search command. For example:

nuodb [domain] > tags search name archive_base
ec2-54-165-58-157.compute-1.amazonaws.com/172.31.46.122:48004 (us-east-1): 
   archive_base = /var/opt/nuodb/production-archives/test

nuodb [domain] > tags search name journal_base
ec2-54-165-58-157.compute-1.amazonaws.com/172.31.46.122:48004 (us-east-1): 
   journal_base = /var/opt/nuodb/production-archives
/test/journal