Installation Guide > Harmony Installation Guide > Installing on Linux > Pre-installation
Download Toon Boom DocumentationDownload Documentation

Pre-installation

Before installing Harmony, you must perform the following task:

Check Your Minimum Requirements
Get the Product Activation Code
Check Your Pre-installation Configuration

For the most current Harmony hardware requirements, refer to the white paper Harmony and Your IT Department. This is available from:

Toon Boom Animation Sales Representative
Toon Boom Animation Support at: support@toonboom.com

You should obtain a Product Activation code from the Toon Boom licenser so that you can finish the installation process without having to wait for the activation code to arrive.

To obtain a Harmony 10.3 activation code, please send the following information to: licensor@toonboom.com.

Your name and the name of your company
Email address where to send the license file

Configure your computer before installation by performing the following tasks:

1. Fedora Installation
2. Disabling SELinux
3. Update NVIDIA Drivers
4. Resolve Keyboard Shortcut Conflicts and Tweak KDE

Fedora Installation

Following are some considerations for Fedora Linux installation. Explaining how to install Fedora Linux is beyond the scope of this document. For detailed information on how to install Fedora Linux, see the Fedora documentation.

Installing Fedora Linux:

Download the Fedora Linux documentation from:
http://docs.fedoraproject.org/
Before installing Linux, make sure the distribution you will be installing is 64-bit. Harmony 10 will not work if the OS is not 64-bit.
When installing Fedora Linux, perform a Custom installation and select to install Everything to ensure that you get all packages necessary to run Harmony.
When asked, select Firewall as disabled. Your file server should be behind a firewall, but should not be configured as one.
When asked, select SELinux as disabled.
Harmony has been tested and certified for use on the KDE windows manager.
Harmony works best with a minimum screen resolution of:
1280 pixels x1024 pixels x 24-bit.
If Fedora cannot detect your monitor, configure the monitor as a generic CRT or an LCD with this resolution and a 60 Hz refresh rate. Alternatively, consult your monitor manufacturer's documentation.
If you're new to Linux, we recommend that you create a boot disk to facilitate recovery.

Disabling SELinux

1. Verify if SELinux is enabled by reading the content of the SELinux config file:

more /etc/selinux/config

2. Look for the line that starts with SELINUX= and ensure that the value is set to disabled:

# This file controls the state of SELinux on the system.

# SELINUX= can take one of these three values:

#    enforcing - SELinux security policy is enforced.

#    permissive - SELinux prints warnings instead of enforcing.

#    disabled - No SELinux policy is loaded.

SELINUX=disabled

# SELINUXTYPE= can take one of these two values:

#    targeted - Targeted processes are protected,

#     mls - Multi Level Security protection.

SELINUXTYPE=targeted

 

3. If the value is set to something other than disabled, you must open the file using a text editor to change the value to disabled. Once the file is modified and saved, reboot the computer.

Update NVIDIA Drivers

You must install the recommended drivers for your NVIDIA video card. If you don't, Harmony will not function.

In general, you should use the latest drivers. New drivers tend to resolve past driver issues. If you already have NVIDIA drivers installed, you can find out the version of the installation, by typing:

cat /var/log/Xorg.0.log | grep "X Driver"

To install the NVIDIA driver:

1. Download the Linux driver from the NVIDIA website:

http://www.nvidia.com/object/unix.html

2. Switch to text mode when installing video card drivers. Type the following in a shell while logged in as the root user:

/sbin/init 3

3. To install the NVIDIA kernel driver, type the following in a shell while logged in as the root user:

sh /[path_to_driver_file]/NVIDIA-Linux-x86_64-[driver_name].run

4. Once the NVIDIA driver installation is successful, revert to graphical mode by starting X. In a shell, type:

/sbin/init 5

OR

startx

Some recent Linux distributions include an open source driver for NVIDIA graphic cards called "Nouveau". This driver must disabled in order to install the NVIDIA drivers. Please refer to the NVIDIA documentation for more information on how to do this.

Resolve Keyboard Shortcut Conflicts and Tweak KDE

Some KDE default keyboard shortcuts conflict with the shortcuts in Harmony and can prevent normal user operation.

To change the keyboard shortcuts and tweak KDE, follow these steps:

1. In the KDE menu, select Computer > System Settings. (In earlier versions of KDE, you may need to open the KDE Control Center).
2. In the System Settings window, select Windows Behavior in the Desktop section (in earlier versions of KDE, open the Look & Feel > Window Behavior menu instead).
3. Click the Window Actions tab.
4. In the Inner window, titlebar and frame section, do one of the following:
Change your keyboard layout to choose Meta key from the Modifier Key option. The Meta key is the Windows Start button on a 104-key keyboard. You must have this type of keyboard to use this option.
Go to Desktop > Window Behavior (in earlier versions, open the Look & Feel > Window Behavior menu). Click the Actions tab. In the Inner window, titlebar and frame section, select Meta as the Modifier Key.
If the Meta key is not available in the Modifier Key list, you will need to change your Keyboard Layout. This is set in Control Center > Regional and Accessibility > Keyboard Layout (in earlier versions, open the Control Center > Peripherals > Keyboard menu). Select the Enable keyboard layouts option and then select a Keyboard Model that includes 104 keys.
Set all of the Modifier Key + options to Nothing.
5. There are a few KDE preferences that you should update to optimize Harmony.
In the KDE menu, select Computer > System Settings > Window Behavior. Click the Moving tab to disable these two options. Harmony reacts better and faster when these are disabled:
Display content in moving windows
Display content in resizing windows
In the KDE menu, select Computer > System Settings > Appearance and select the Colors menu. Under the Options tab, disable the following option:
Apply colours to non-KDE4 applications

NOTE: This option may cause Toon Boom Harmony to display incorrect colours in some of the interface controls.

After you have completed all Fedora Linux configurations, you are ready to install Toon Boom Harmony.