Configuration
After installing Harmony, configure database parameters depending on your machine's setup, and configure third-party software.
1. | Set Up Licensing |
2. | Configure Harmony |
Set Up Licensing
Now that you have installed Harmony, you must set up the licensing so that it can run on the server and client machines.
Configuring the license server
1. | As the root user, start the License Wizard by typing the following: |
cd /usr/local/ToonBoomAnimation/harmony_10.0/lnx86_64/bin
Logged as root user, type:
./LicenseWizard.
2. | Click on Activate License. |
The Activation Options screen appears:
3. | Click on Internet Activation. |
The Internet Activation Options screen appears:
4. | Click on Network License. |
The Internet Activation - Network License screen appears:
5. | Type or copy/paste the Product Code and type in the number of licenses this product code grants you. |
6. | Click on Next. |
The Install License Server screen appears:
7. | Click on Install License Server. |
This step will create the license.dat
file and place it in /usr/local/flexlm/licenses/license.dat
. The license.dat created contains the following information:
SERVER this_host 0 ANY
VENDOR toonboom
USE_SERVER
This step will also start the License Server service and will configure it to start automatically.
Both these steps can be done manually if need be. To configure the License Server service to start automatically at boot, use the following command:
$ /sbin/chkconfig USAnimation_flexlm on
To start the license server manually, type the following as the root user:
$ /etc/init.d/USAnimation_flexlm restart
The Activation Successful screen appears:
8. | Click on Finish to exit the wizard. |
9. | Verify that the FlexLM license is working properly by using the lmutil lmstat -a command. |
$ lmutil lmstat -a
You can also look at the log:
$ less /tmp/lmgrd.log
10. | If the FlexLM service needs to be restarted, use the following command: |
$ /etc/init.d/USAnimation_flexlm restart
Configure Harmony
After installation, you must set up the database configuration for computers running Harmony.
1. | Set Up the Database Server |
2. | Create the Toon Boom Harmony File System |
Set Up the Database Server
The Dbserver controls all interactions with the contents of the Toon Boom Harmony database. It processes all requests to open, read or update files, keeping track of files that are locked so that others can not edit them.
When installing Harmony on the server for he first time, the Harmony database folder is created automatically. Verify that the folder was created correctly. Look for the USA_DB
folder in the root folder (/USA_DB
).
If you do not see the folder there, you will need to create it using the create_usa_db script. Type the following command in a shell while logged in as root:
/usr/local/ToonBoomAnimation/harmony_10.0/lnx86_64/bin/create_usa_db /USA_DB
Next you need to create and edit the Dbserver.conf
file to set up the Dbserver. Then you have to run a script that will start the Dbserver.
To set up the Dbserver:
1. | Using a text editor, create the file Dbserver.conf in /USA_DB/ . |
2. | Type the following in the Dbserver.conf file: |
Assuming the machine name of the Dbserver is "harmonyserver
", the lines in Dbserver.conf
would look like this:
hostname harmonyserver
port 5678
debug_port 5680
Note: You can find the example of Dbserver.conf
in /usr/local/ToonBoomAnimation/harmony_10.0/resources/samples
. You can copy and paste it from there and change it accordingly.
3. | Save and close the Dbserver.conf file. |
4. | Change the permissions on the Dbserver.conf file to 644. |
‣ | In a shell, type the following: |
chmod 644 Dbserver.conf
5. | You must now start the Dbserver service. In a shell, type the following command: |
/sbin/service USAnimation_dbserver start
A message will appear in the shell indicating that the script has been successful.
6. | A log file will be generated in /tmp/tbdbserver.log . Check this file to make sure there are no errors written to the log. |
Create the Toon Boom Harmony File System
After you set up and start the license and Dbserver, you are ready to create the file system for the Toon Boom Harmony database.
To create the Toon Boom Harmony file system:
1. | In a shell, change directories to the root. Type: |
cd /
2. | Make a directory named /usadata000 . Type: |
mkdir usadata000
Once you have finished creating usadata000
, change the permission of:
/usr/local/ToonBoomAnimation/harmony_10.0 /USA_DB and /usadata000 to 777.
chmod -R 777 /usr/local/ToonBoomAnimation/harmony_10.0 /USA_DB /usadata000
Now you are ready to test your installation on the server/stand-alone machine.
Related Topics
• | Configuring Harmony to Share Scene Data |