Installing the Database Server Daemon on GNU/Linux

Once you have created a database file structure, you must also enable the database server daemon to allow Harmony to connect to the database. This daemon runs through the user usabatch, so this user must be created prior to installing the daemon.

The Harmony installer for GNU/Linux always installs daemon scripts on your machine, but does not enable them by default. Hence, there are two approaches to installing the database server daemon:

  • By enabling the daemon that was already installed with Harmony using the chkconfig command.
  • By running the Harmony installation script with the -d parameter. This will also create a database file structure on your machine if none is present.

This daemon runs through the user usabatch, so this user must be created prior to installing the daemon.

NOTE The following steps indicate how to make the database server daemon launch on boot, via the user usabatch. If you prefer, you can make the database server launch on log-in as the logged-in user. For more information, see Running the Database Server on Log-In on GNU/Linux.

  1. In a terminal, enter the following command:

    $ sudo useradd -m usabatch

    $ sudo passwd usabatch

  2. When prompted, enter the password you want to assign to the user usabatch, then confirm it.

    The user usabatch is now created and can be used to run Harmony daemons.

  1. In a terminal, enter the following command to enable the database server daemon:

    $ sudo chkconfig toonboom_dbserver on

    If the command returns nothing, it succeeded. The database server will launch next time you boot the machine.

  2. To launch the database server daemon immediately, run the following command:

    $ sudo service toonboom_dbserver start

    The command will report whether it succeeded or failed.

  1. In a terminal, navigate to the directory where you downloaded the installation package.

    $ cd ~/Downloads

  1. Extract the package's contents in the directory.

    $ tar -xvzf ./name-of-package.tar.gz

  1. Switch to the directory in which the package's contents were extracted.

    $ cd name-of-package

  1. Run the installer with the -d parameter:

    $ sudo ./install -d

  2. When prompted, confirm that you want to proceed with the installation.

    The installation script will create a database file structure in /USA_DB, enable the database server daemon and start it.

NOTE The installation script will not create a database file structure in /USA_DB if this directory already exists, whether it is a local database or a remote database mounted on the file system.