Configuration

After installing Harmony, configure the database parameters and the third party software based on the role this computer will have.

• Configuring Harmony
• Configuring the Licensing

Configuring Harmony

Once Harmony is installed, additional steps are required to configure the database on the server and to set up the startup items and register the application path for the Terminal.

Setting Up the Database Server

The database server controls all interactions with the contents of the Toon Boom Harmony 12.2.1 database. It processes all requests to open, read or update files, keeping track of files that are locked so others cannot edit them.

If you already have a database set up from a previous installation of Toon Boom Harmony 12.2.1, you DO NOT need to set up the database server, startup items, or register console application in the path. However, if you are upgrading from a previous version, you need to install the startup items and register console applications in the path. For new installations of Harmony, you must install all of them.

ClosedHow to configure the database server using the Configuration Assistant
  1. From Finder, go to Applications > Toon Boom Harmony [version] [edition] > Tools.
  1. Double-click on Configuration Assistant.

If you are upgrading from a previous version and a database (/USA_DB) already exists on the server, deselect the Create a new Toon Boom Harmony database option.

  1. For the server, select all the options if this is the first time you are installing on this machine.
NOTE: If you are upgrading from an earlier version of Toon Boom Harmony 12.2.1, update the dict files in the /USA_DB. Copy the dict files from here:/Applications/Toon Boom Harmony 12.2.1 [version]/tba/etc/USADB_templates/dicts/ to /USA_DB/dicts/.

  1. Click Continue.

The Create Harmony Database screen opens. The default values shown should be correct.

  1. Click Create.
NOTE:

You can always create the Toon Boom Harmony 12.2.1 database manually later. To do so, open the Terminal and type the following:

cd /

mkdir usadata000

chmod -R 777 usadata000

NOTE: You must be logged in using the root account. If not, type sudo before launching the command.

You can make as many data directories as needed. Name these directories using the following syntax, where XXX represents the number of the data directory:

usadataXXX

NOTE: If you want to use a name other than usadataXXX for the Toon Boom Harmony 12.2.1 database, edit the Manager.conf file and add the name or search pattern for this new database. The Manager.conf file can be edited using the Configuration Editor in the Tools folder of your Toon Boom Harmony 12.2.1 installation. Open the Configuration Editor and select the Manager.conf tab.
  1. In the Create Startup Item screen, select the startup items required and click Create.

Parameter Description
Create Database Server Startup Item It is mandatory to install this on the server.
Create Link Server Startup Item This is required when there will be Windows clients connecting to the Mac server. This service creates symbolic links when a scene is created from a Windows client workstation.
Create Queue Server Startup Item This is for the batch processes like rendering and vectorization. Do not install this on the server, as it will slow it down. Install this on a separate machine used for batch vectorizing or rendering.

Create Harmony Web Control Center Server Startup Item

This is required when you want to set this machine as a Web Control Center server. Other machines will access this web server to work with their Web Control Center. You do not have to make the database server the same machine as the Web Control Center server.

Your startup items are created.

  1. Click OK.

The following screen opens.

  1. Enter your username and password, and click OK.

The Register Path screen opens.

  1. Register the path for the current user or for all users. This option appends the path of Harmony's applications to the PATH environment variable in order to run the applications from the Terminal.
Parameter Description
Registration Path for all users Registers the path for all accounts on the computer. You only need to run this once.
Registration Path for my user only Registers the path to the current account only. You need to run this for each user that will be using the Terminal and you need to run this each time you create a new user.
  1. Click Create.

The Cisco OpenH264 Library screen opens.

  1. Select the Install OpenH264 Library option and click Create.

The server is successfully configured.

  1. Click Done to close the Configuration Assistant.

Configuring the Licensing

The licensing must be configured before running Toon Boom Harmony 12.2.1.

You must perform the following tasks on the server:

• Setting Up the FlexLM License Server
• Setting Up the License on Client Workstations

Setting Up the FlexLM License Server

IMPORTANT: For existing installations, you must reinstall Harmony on your license server machine in order for FlexLM to work properly.
ClosedHow to configure the license server
  1. Start the License Wizard from Applications > Toon Boom Harmony [version] [edition] > Tools > LicenseWizard.

The Welcome screen appears.

  1. Click Activate License.

The Activation Options screen appears.

  1. Click Internet Activation.

The Internet Activation Options screen appears.

  1. Click Network License.

The Internet Activation - Network License screen appears.

  1. Do the following:
‣ In the Product Code field, enter your product code.
‣ In the License Count field, enter the number of licenses the product code grants you.

NOTE: Once activated and returned to the activation server, a server license cannot be activated again. Make sure you are activating the license on the correct computer with the proper license count.
  1. Click Activate.

The Install License Server screen appears.

  1. Click Install License Server.


The license.dat file is created in /usr/local/flexlm/licenses/license.dat. The License Server is also configured and started.

The license.dat created contains the following:

SERVER this_host 0 ANY

VENDOR toonboom

USE_SERVER

The Activation Successful screen appears.

  1. Click Finish to exit the wizard.


If you're having problems with the license, try the folllowing:

‣ Reread the license file:

lmreread -a

‣ Verify that the FlexLM license is working properly:

lmstat -a

You can also look at the ToonBoomLicense.log file:

/tmp/ToonBoomLicense.log

‣ If the FlexLM service needs to be restarted:

sudo launchctl unload /Library/LaunchDaemons/com.toonboom.LicenseServer.plist

sudo launchctl load /Library/LaunchDaemons/com.toonboom.LicenseServer.plist

Setting Up the License on Client Workstations

NOTE: An Admin account is required for setting up the license on the client workstations. After activation you can login as client.
ClosedHow to set up the license on a client workstation
  1. Open the License Wizard on the client workstation.

The Toon Boom Activation Wizard appears.

  1. Click Activate License.

The Activation Options screen appears.

  1. Click Use License Server.

The Server Activation screen appears.

  1. Click Connect to Server.

The Server Activation - Shared License screen appears.

  1. In the License Server Address field, enter the hostname or IP Address.
  1. Click Connect.

You are prompted for a password.

  1. Enter the password and click OK.

The Activation Successful screen appears.

  1. Click Finish to close the License Wizard.

The content reflects the features found in the latest Harmony 12.2.1 release. To download the latest upgrade, go to https://www.toonboom.com/my-downloads

For comments and feedback, contact: ...

© 1994–2015 Toon Boom Animation Inc. All rights reserved
Toon Boom Animation Inc., a Corus® Entertainment Inc. Company