The server

The server executable is called dbood, and should typically be installed in /opt/dboo/dboo-<version>/bin. During installation, there should be symbolic links created from /usr/bin, so it should be available on the command line:

> dbood

The server can handle any number of databases. Access to a database is administered through the use of groups and user accounts. See Databases and Users and groups.

Command line options

Option	Explanation
–help \| -h	Displays help information
–license \| -l	Displays license information
–daemon \| -d	Starts server in daemon mode. The open terminal can be closed.
–set-root-password –	Sets root password by hidden prompt. Server shuts down immediately after changing password.
–set-root-password <password>	Sets root password to <password> and immediately shuts down.
–log-object-ids	Logs object ids to standard out.

Creating a server instance

Once the server binaries are downloaded and installed, you use the command line to create server instances and databases.

You can run any number of server instances on a machine, they just need to have unique ports. Each server instance can have any number of databases.

A server instance is initialized with the server daemon:

Creating a server instance in the user’s ${HOME}/.dboo directory:

> dbood create

The directory can also be specified:

> dbood create /path/to/server_instance

By default, the server instance will be using port 8822. If you want multiple server instances simultaneously, you will have to specify the port (and potentially host name) on the command line:

> dbood create /path/to/server_instance localhost 8801

> dbood create /path/to/server_instance 8801

Running the server

A server instance is started like this from the home directory:

> dbood

or from specified directory:

> dbood /path/to/server_instance

Or, to start in daemon mode, add option -d:

> dbood -d /path/to/server_instance

To stop a server instance running in daemon mode, use ps/grep to get the process id and send a SIGINT via the kill command:

> ps -ef | grep dbood
> kill <dbood pid>

The server does a graceful shutdown (if you run in daemon mode the shutting down messages are not visible):

^CSignal SIGINT (2) closing down.
Signal SIGINT (2) server down.
Shutting down, tidying up.
Shutting down, exiting.