Administration

Concepts

Instance

Siodb starts an instance to access a set of databases. One instance can serve multiple databases as far as they belong to the same instance. An instance has a unique name per server.

Database

A database is a set of files belonging to one database and organized in a certain way. Siodb uses the instance to produce read and write operations into data files. Data files contain database objects like tables or indexes. They also contain business data.

Configuration file

Siodb identifies an instance by its name. With the name of an instance, you can locate its configuration file. Siodb expects to find the configuration file of an instance in the folder /etc/siodb/instances. You'll find this folder a configuration file named with the instance name and prefixed by the extension .conf. For example, if you have three instances called instance1, instance2 and instance3 on the same server, you will find the following configuration files:

Parameters

Installation directory

The default installation directory is /opt/siodb-<RELEASE_ID>. This is the home directory of Siodb for a given release Id. You can find the Siodb binaries in ${SIODB_HOME}/bin.

Siodb dictionary

Start Siodb

Start an instance

To start and stop an instance of Siodb you must respect the following rules:

$ /opt/siodb-<RELEASE_ID>/bin/siodb --help
Allowed options:
  -i [ --instance ] arg Instance name
  -d [ --daemon ]       Run as daemon
  -h [ --help ]         Produce help message

Connect to an instance (admin mode)

To connect to an instance of Siodb you use must respect the folowing rules:

$ /opt/siodb-<RELEASE_ID>/bin/siocli --help
Allowed options:
  -a [ --admin ] arg             Connect to given instance in the admin mode
  -H [ --host ] arg (=localhost) Server host name or IP address
  -p [ --port ] arg (=50000)     Server port
  -h [ --help ]                  Produce help message