Manage Datastore Locations

By default, Sintelix stores all networks A container that stores information in nodes and links. See Nodes and Links topic for more information and document collections A collection is a container for storing and organising ingested files and documents. Only the textual content is stored in collections, not the original files and documents. in the directories ‘networks’ and ‘collections’ in the <Sintelix database directory> The directory in which the Sintelix database is stored, for example, C:\Users\Documents\Sintelix database., as specified in WEB-INF/config/site-config.xml, under entry <data-directory>.

The database locations configuration is not configurable from the GUI. File system access to the server is required.

You can expand the disk space available to Sintelix by adding more locations on the file system for Sintelix datastores.

Configured datastores are listed the System Overview pane.

To view datastore locations:

  1. Log in to Sintelix as an administrator.
  2. On the Main Navigation Bar click the Status tab.
  3. On the System Overview pane, under System Configuration, find the Datastores row.

    4. Each entry shows the path, the total disk space used, the remaining disk space available and the number of collections and networks stored at each datastore. Clicking on the number of collections or networks shows a detailed summary of which networks or collections are present and how much disk space each of them occupies.

    If no new collections/networks will be automatically created in a datastore (writeable="false"), a padlock icon is displayed.

To add more datastores:

  1. Go to the directory <Sintelix database directory> The directory in which the Sintelix database is stored, for example, C:\Users\Documents\Sintelix database.

  2. Create a file called storages.xml with the following contents:
    Copy
    <root>  
    <ext-data-directory writeable="true" forDocuments="true" forNetworks="true">D:\secondary-db\</ext-data-directory>
    <ext-data-directory writeable="true" forDocuments="true" forNetworks="true">E:\tertiary-db\</ext-data-directory>
    </root>

    3. There can be any number of ext-data-directory elements.

    writeable is a flag which specifies whether Sintelix writes to that data store (if it’s set to false, Sintelix will accept networks or collections found there on startup, but will not add more data there).

    forDocuments is a flag which tells Sintelix that this datastore should be used for document collections.

    forNetworks is a flag which tells Sintelix that this datastore should be used for networks.

    Sintelix accepts an arbitrary number of datastore locations. If there is a choice, any new collection and network will be created in the datastore that has the smallest total disk usage at the time of creation.

    If external datastore locations are specified and at least one of them specifies writeable="true", then no new collections or networks will be created under the main storage (as if the main storage became writeable="false").

  3. Restart Sintelix for the changes you made to storages.xml to take effect.

If Sintelix is configured to not create any new collections/networks in the datastore (writeable="false") then this process is the only way to populate such a datastore.

If there is more than one datastore with the same ID (for example if data was accidentally copied instead of moved), Sintelix will not start, to prevent any data loss.

Do not start the Sintelix server while the move is in progress. Sintelix can delete partially-moved databases during startup.

To move a collection or network between two datastores:

  1. Log in to Sintelix as an administrator.
  2. On the Main Navigation Bar click the Status tab.
  3. On the System Overview pane, under System Configuration, find the Datastores row.
  4. Identify the ID of the collection or network you want to move and the datastore it is in.
  5. Stop the Sintelix service (see Start, Stop and Restart Sintelix).
  6. Go to the filesystem location of the source datastore and enter the "collections" or "networks" directory. Find the directory with the name corresponding to the ID of the collection or network you want to move.
  7. Identify the filesystem location of the destination datastore and its "collections" or "networks" directory.
  8. Move the directory, and all files in it, from the source to the destination datastores.
  9. Start the Sintelix service.

    10. The System Overview pane should now confirm that the network or collection is now present in the new datastore.