The Catalog advanced guide

Here you can read about more precise configuration of The Catalog NoSQL Database (shortname: CatalogDB). For example what is Mirroring, IP filter, and how these work as well as about deeper instructions using Catalog Manager. If you new to The Catalog please read the Quick start guide first. Stop your server before applying these configurations.

Mirroring

In the mirroring tab you can add external servers for database duplication. Can be back and forth. To achieve this add mirroring entry pointing to this server on the external server. Start up the manager and navigate to “Mirroring” tab:

The Catalog NoSQL- Mirroring manager - CatalogDB

Click on “Edit mirrors” button and a window should pop up. Right click on the listbox and chose “Add new server” from the context menu:

The Catalog NoSQL- New mirror - CatalogDB

In the popup windows type in the external server connection specifications.

  • Server name or IP” defines the host itself.
  • The “Alias” is the name of the external server that visible in this manager.

The Catalog NoSQL- New mirror popup 1 - CatalogDB

In next window type in the external server's password. Then the data and the file ports.

The Catalog NoSQL- New mirror popup 2 - CatalogDB The Catalog NoSQL- New mirror popup 3 - CatalogDB

Click on “Save and exit” button to apply. If all went fine, in the end the windows should look like this:

The Catalog NoSQL- Created mirroring - CatalogDB

For more information please check out the Mirroring page.

IP filter

IP filter is about acces controlling. Use this module when you would like to control who can reach your server. Tipically used on pure mirror databasese instances. Blank IP filter means that connection permissible from any host.

The Catalog NoSQL- IP filter - CatalogDB

To achive the previously described state, in the manager go to the “IP filter” tab (the service should already be installed):

The Catalog NoSQL- Ip filter manager - CatalogDB

Right click on the listview and in the context menu choose “Add host or IP”:

The Catalog NoSQL- New IP filter - CatalogDB

Popup window appears.

  • Host or IP”: The host name or IP address of the computer whose connection accepted to this database.
  • Note”: A simple note, that describes the connection.

The Catalog NoSQL- New IP filter popup - CatalogDB

At this point only the 'allowed-pc' can reach our database:

The Catalog NoSQL- Create IP filter - CatalogDB

To delete a filter, right click on it and choose “Delete item” from context menu.

Move database

With “Move DB” function you can move an existing database. For example to a pendrive. To achieve this you have to stop and uninstall your existing database instance. Follow the steps below:

  1. Right click on the database that you want to move and from the context menu choose “Move DB” option.
  2. In the popup window choose the target destination (for example a pendrive) where you want to move the database.
  3. That's all, just install and start your newly moved instance or unplug your pendrive and bring your database with yourself in your pocket.

The Catalog NoSQL- Move Database - CatalogDB

Import database

With “Import DB” function you can import an existing database (for example from a pendrive). To achive follow the steps below:

  1. Right click on the list on the left and choose “Import DB” function from the context menu.
  2. In the popup window browse for the database's descriptor file (*.desc) that you are willing to import. The descriptor tells the content that need to be imported.
  3. In the next window choose the destination folder where you want to import the selected database.
  4. That's all, your database has been imported. Install and start.

The Catalog NoSQL- Import Database - CatalogDB

Remove database

To remove an existing database first stop and uninstall it. The right click on the database and choose “Remove” option. The function takes place instantly, but reversible.
Actually, to restore accidentally deleted database open your trash bin and restore it from there. Than import it as described in the 'Import database' section.

The Catalog NoSQL- Remove Database - CatalogDB