Skip to content

Storages

Every signle document in NodeActa system has to be persisted on a physical storage. Therefore, each document class has assigned one or more storages. A storage definition consists of database and archive access parameters. At the moment, NodeActa supports Firebird and Oracle databases, with a plan to add support for other popular database providers. To configure storages you can use System Management→Storages app (like in the image below).

storage manager

Each storage requires the folowing settings:

  • Name: name of the storage.
  • Label: label for the storage.
  • Type: type of the storage (Working, Archive, Backup).
  • Database Host: host address for the storage database.
  • Database Driver: driver used for the storage database. Firebird and Oracle are available at the moment.
  • Database Name: name of the storage database.
  • Database User: username for the storage database.
  • Database Password: password for the storage database.
  • Database Connection Pool Size: maximum number of concurent connections server will make to this storage database.
  • Database Charset: character encoding used for the storage database. We recomend to always use UTF-8.
  • File Storage Host: host address for the file storage. For built-in driver this is path to you file storage.
  • File Storage Name: name of the file storage. For built-in driver this is your Archive Type.
  • File Storage Driver: driver used for the file storage. NodeActa provides built-in driver only. If you develop your own driver, this is your driver library name, and library itself must be in server installation directory/drivers folder.
  • File Storage User: username for the file storage.
  • File Storage Password: password for the file storage.
  • File Storage Connection Pool Size: maximum number of concurent connections server will make to this file storage.
  • Grantee Replication: replicates users and groups in the storage, which is required if storage is used for document classes with security.
  • Read-Only: read-only storage is used only as a data source and the server will never try to write to it. For example, DS (Directory Services) storage is read only.
  • Archiving Period Start/End: not used at the moment.

By default, system comes with SYSTEM, LOG and DS (Directory Services) stroages. Note that DS (Directory Services) stroage is not configured by default. To confiure DS (Directory Services) storage, you need to specify only the following:

  • Name: storage name must always be DS, or the system will not work correctly.
  • Type: storage type must always be Working, or the system will not work correctly.
  • Host: specify host in the form ldap:your-active-directory-server-url-or-ip:389 (ldap servers usualy use port 389).
  • Database Name: specify active domain BASE DN in the form ou=my-organizational-unit,dc=my,dc=domain,dc=com.
  • User: specify active domain user's DN in the form cn=p.parker,ou=my-organizational-unit,dc=my,dc=domain,dc=com. User must have right to list all users and groups.
  • Driver: specify nodeacta.directoryservices.

Remaining settings are not used for DS storage.

If there is a need to access a not supported storage, there is always a posibility to develop your own Storage Drivers.