Installing WebCC on GNU/Linux

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 WebCC server daemon:

  • By enabling the daemon that was already installed with Harmony using the chkconfig command.
  • By running the Harmony installation script with the -w parameter.

The installation of a WebCC server also requires copying a script from the Harmony installation package. The installer does this automatically when it is launched with the -w parameter. If you choose to enable the WebCC daemon manually, you will also have to copy this script manually.

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 WebCC 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 macOS.

  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 check if the rendering script for WebCC is already in your database:

    $ stat /USA_DB/scripts/TB_WebCC_Render.js

  2. If the script is not in your database, copy it from the Harmony installation directory:

    $ mkdir -p -m 777 /USA_DB/scripts

    $ cp /usr/local/ToonBoomAnimation/harmony[Edition]_20/resources/scripts/TB_WebCC_Render.js /USA_DB/scripts/

  3. In a terminal, enter the following command to enable the WebCC server daemon:

    $ sudo chkconfig toonboom_webcc on

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

  4. To launch the WebCC server daemon immediately, run the following command:

    $ sudo service toonboom_webcc 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 -w

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

    The installation script will enable and start the WebCC server daemon.