Installing a New System
After you have installed Fedora Linux, you must create the usabatch
user account in which many Toon Boom Harmony services run.
Then you can and install Harmony. There are a number of options you can choose from when installing Harmony.
Creating the usabatch User
With Fedora Linux installed, you will create the usabatch
user account. You must also set the usabatch
user to use the tcsh
shell and create a .cshrc
file to start the Toon Boom Harmony environment whenever the user logs on.
You must create user accounts for all Toon Boom Harmony users. All user accounts you create on Fedora Linux that will also run Harmony must be set up in the same way as the usabatch
account, except for the user name and password.
1. | In a shell, log in as the root user. |
2. | Using a text editor, create the file /etc/skel/.cshrc . This file should contain the following line: |
umask 0
Note: The above character is a zero.
3. | Create the user usabatch . |
useradd -m -s /bin/tcsh -r usabatch
4. | Enter the password for user usabatch . |
passwd usabatch
Then, type usabatch
as a password.
To create additional users repeat steps 3 and 4, replacing usabatch
with the user name and password of the new user.
5. | If you are not logged in as usabatch : |
su - usabatch
6. | Open the .cshrc file in usabatch 's home. The .cshrc file should contain the following: |
if ( -f /usr/local/ToonBoomAnimation/harmony_11.2/etc/usa_cshrc ) then
source /usr/local/ToonBoomAnimation/harmony_11.2/etc/usa_cshrc
endif
umask 0
7. | Save and quit. |
8. | Log out of usabatch to return to the root user. |
Installing Harmony
In a client-server network or in a standalone setup, you must install Harmony binaries and the following services:
• | Dbserver: Controls access to the Harmony database. |
• | License Service: Controls the number of licenses and features available to Harmony users. |
• | Batch Processing: If you are setting up the machine for batch processing, this controls batch vectorizing and rendering queues. |
• | Link Server: If you are installing Harmony on a Linux server that will support Windows clients. |
To install Harmony binaries and services, you must run the installation script. With the product activation code in hand, you are ready to install Harmony.
1. | Uncompress the distribution file. |
tar xvfz [path_to_distribution_file]/[filename].tar.gz
2. | Change to the directory that was extracted from the tar.gz file. |
3. | Run the install script as the root user, specifying the options required for your server. There are a number of options that control the installation process. For a typical Harmony server or a standalone machine, run the installation script with the following parameters: |
./install -b -d -kde
With these options, the binaries are installed, and the database server is installed and set up to start automatically. These options also add Harmony entries to the KDE application menu.
If your Linux server will be serving Windows clients, add the -l
option.
If you are setting up the clients for batch rendering, add the -p
parameter. It is not recommended to configure batch processing on the server as it will slow it down.
Installation Options
Option |
Default Value |
Details |
|
Inactive |
Installs binaries and configuration files required to run Harmony applications. Include this option when performing a fresh install or when you upgrade Harmony. Use option when installing Harmony on the server. |
-c
|
Inactive |
Installs Harmony Cloud as a service. This parameter is required if this machine is the Harmony Cloud web server. |
|
Inactive |
Installs the This option also creates a fresh database when there is no Use this option when installing Harmony on the server and on the stand-alone machine. |
|
Inactive |
Displays script usage information. |
|
Inactive |
Adds Harmony entries to the KDE application menu. |
|
Inactive |
Installs the This daemon is required for Linux or IRIX servers to create symbolic links for Windows clients. If you have Windows clients, you must install this daemon on the server. |
|
Inactive |
Installs the The This parameter is required if this computer is going to batch process files for Harmony. |
|
Inactive |
Does not output any information during installation. |
|
|
Directory where the installer will install the |
- - |
Inactive |
Updates the |