Skip to content

Server

NodeActa Server performs abstraction of your storages (database and file archive). It processes client requests for archiving, querying, and retrieving documents and records. Additionally, it manages users, groups, security, load balancing, and more. It can run on Linux and Windows platforms.
In practice, aside from the initial configuration typically done by installer, you rarely need to interact with the server directly.

Server Configuration

The server configuration is stored in the 'server.na' file, located in the server's binary directory. Basic server configuration setup is completed during the installation process. If you need to change these settings, you can modify this file manually using the list of available settings below, but we suggest using nodeacta.config.exe from the server installation directory (shown in the picture below). On Windows, you can launch nodeacta.config.exe from the Start Menu.

edit settings

nodeacta.config.exe allows you to change the following server settings:

  • Name: System name is used as the name of client application's working directory located inside MyDocuments directory. Default is 'NodeActa'.
  • Port: The port on which the system listens for incoming client connections. Default is 8090.
  • HttpPort: The port on which the system listens for incomming HTTP connections. This is available only with Professional and Enterprise license. Default is 80.
  • HttpsPort: The port on which the system listens for incomming HTTPS connections. This is available only with Professional and Enterprise license. Default is 443.
  • Cert: Certificate in PEM format, required for establishing SSL connections to your server.
  • CertKey: Certificate key in pem format.
  • CertPassword: Certificate password (if required).
  • SessionTimeout: Specifies the server session timeout for client connections. Once this timeout is reached, the server will close inactive client connections and clear cached client objects. This setting does not affect the client application, as terminated connections are automatically re-established. For environments with a high number of concurrent connections, it is recommended to use a lower timeout value. Default is 15 minutes. Minimum is 2 minutes.

  • LoadBalancing: You can deploy multiple NodeActa servers within your network. One server will act as the primary server and manage load balancing. The primary server determines which server has the least load and redirects client connections accordingly. This feature is available with an Enterprise license. Example: 12.22.93.11; 33.44.2.33; 131.33.1.134

    Warning

    This setting must NOT include this server address.
    Slave servers must NOT have 'LoadBalancing' setting configured.

  • DataStorageDriver: Database driver library used for initial connection to the system database. Possible values are 'nodeacta.firebird' and 'nodeacta.oracle'. You can also evelop your own driver following Storage Driver development guidelines. Default is 'nodeacta.firebird'. This setting matches nodeacta.firebird.dll on Windows or nodeacta.firebird.so on Linux.

  • DataStorageHost: System database host address.
  • DataStorageName: System database name.
  • DataStorageUserName: System database user name.

  • DataStoragePassword: System database password.

    Hint

    This password is encripted.
    To change this password you MUST use nodeacta.config.exe on Windows or run installation again.

  • DataStorageCharset: System database characted set.

  • FileStorageHost: Relative or absolute path to the file archive.
  • WebRoot: Directory holding your website. NodeActa server can be used as a web-server hosting you static web-site. This will override your 'WEB' app. This is available only with Professional and Enterprise license.
  • WebStatic: Directory holding your web-site static resources that are cached by the browser (images, javascript, css, etc).
  • Web404: A custom 'Page Not Found' html teplate.
  • CommandReadAccess: By default, the NodeActa Command application run by the server has access to the entire file system. To restrict the application's read access, specify the files or directories it will be allowed to access. Entries must be comma separated. See allow-fs-read in NodeActa Command Switches.
  • CommandWriteAccess: By default, the NodeActa Command application run by the server has access to the entire file system. To restrict the application's write access, specify the files or directories it will be allowed to access. Entries must be comma separated. See allow-fs-write in NodeActa Command Switches.
  • LicenseServer: Address or name [and port] of the main NodeActa server that holds the license. For example: 198.22.12.2:8090