Configuring Harmony Web Control Center on Linux

Installing Harmony Web Control Center

When installing Harmony Web Control Center, you must add options to the Harmony install script command line and install the Cisco OpenH264 library to see the movie previews and thumbnails.

ClosedHow to install Harmony Web Control Center as a service
  1. Add the following options to the Harmony install script command line.

If you are upgrading Harmony Web Control Center server, you must first stop the service—see Network Setup.

Option

Default Value

Details

-webccserver

-w

Inactive

Installs Harmony Web Control Center as a service. This parameter is required if this machine is the Harmony Web Control Center server.
  1. Reboot after installing Harmony Web Control Center as a service. The service should run at every reboot.
ClosedHow to install the Cisco OpenH264 library
  1. In a shell, type the following:

cd /usr/local/ToonBoomAnimation/harmony[edition]_12/lnx86_64/bin/openh264_control.sh

The following appears:

Running script for installing/uninstalling the Cisco OpenH264 library

OpenH264 Video Codec provided by Cisco Systems, Inc.

Do you wish to install (i) or uninstall (u) the library?

  1. Type the following to install the library: i
  1. Now you have a choice of the two following libraries. Try the first. If there are problems, try the second.
‣ openh264-linux64-v1.3.zip (0)
‣ libopenh264-1.3.0-linux64.so.bz2 (1)

The OpenH264 library installation is successful.

NOTE: A script was added to assist in uninstalling the OpenH264 library on Linux. It is located at /usr/local/ToonBoomAnimation/harmony[edition]_12/lnx86_64/bin/openh264_control.sh.

Configuring the Licensing

Setting Up in a Non-Gui Environment

ClosedHow to install Harmony Web Control Center on a Linux server with no GUI
  1. Contact Toon Boom Support to request a copy of the Flexnet Publisher anchor script (install_fnp.sh) and the FlexNet Publisher Licensing Service (FNPLicensingService).
  1. Place both files in the bin directory of your Harmony install. It is typically located here:

/usr/local/ToonBoomAnimation/harmony[edition]_12/lnx86_64/bin

  1. Change the permissions on the anchor script to be executable:

chmod 755 install_fnp.sh

  1. Execute the following script

./install_fnp.sh

  1. Execute the following command to install the license:

ServerActivation -batch -served -comm soap -commServer https://licensing.toonboom.com:443/flexnet/services/ActivationService -entitlementID XXXX-XXXX-XXXX-XXXX-XXXX

  1. Type the activation key next to -entitlementID to replace the Xs.

Managing the Harmony Web Control Center Service

If at any point, you need to start/stop or restart the Harmony Web Control Center server. You can do so through the /sbin/service.

To start the service

/sbin/service USAnimation_harmony_webcc start

To stop the service

/sbin/service USAnimation_harmony_webcc stop

To restart the service

/sbin/service USAnimation_harmony_webcc restart

Alternatively, you can start or stop all Harmony Services with the following commands:

To start all services

/usr/local/ToonBoomAnimation/harmony[edition]_12/lnx86_64/bin/Startus

To stop all services

/usr/local/ToonBoomAnimation/harmony[edition]_12/lnx86_64/bin/Stopus

Customizing the Harmony Web Control Center Service

You can customize some parameters, such as the default port, for the Harmony Web Control Center service.

ClosedHow to customize the Harmony Web Control Center Service
  1. Stop the service if it is active—see Network Setup.
  1. As the root user, open the following file:

/usr/local/ToonBoomAnimation/harmony[edition]_12/lnx86_64/bin/webcc.sh

  1. For example, after the last character, change the default port to 8081:

#!/bin/sh -f

# Script to start Harmony Web Control Center server

DIRNAME=$(dirname "$0")

cd "$DIRNAME"

./bin_3rdParty/node ../../cloud/server/app.js "$@" -port 8081

The customizable parameters are:

Parameter Description
-numWorkers n Number of processes to service client requests. Default is number of CPU cores. Set to 0 to disable worker child processes. If the number of CPUs is high, performance could be impacted on all processes running on the server. If server is mostly for Web Control Center, increase the number for better performance.
-noAuth Disables basic login/authorization verifications with the user database. Default: authorization enabled.

- port port

 The port to which HarmonyWeb Control Center is deployed. Default: 8080.
-http port

Enables http protocol on specified port (can be used along with https to enable both). Default: http enabled unless -https is also enabled.
-exchange loc Location (on disk) of top-level file exchange folder. Default: /USA_DB/exchange
-cacheDuration s Number of seconds to keep data in cache. Default 3600. 0-> disable cache, 1-999999-> number of seconds to keep data in cache.
-allowAllOrigin Enables webcc web service from all sources (enable cross-origin resource sharing). Default: Disabled.
-disableAnalytics Disables Google Analytics tracking for all clients. Default: Enabled.
Options Related to SSL Server
-https [port] Enables https protocol on port 8443, unless a port override is provided. Default: Disabled.
-key key <filename> the private key for the SSL session (works with -cert). Default: None.
-cert cert <filename> the certificate filename for the SSL session (works with -key). Default: None.
-pfx file <filename> alternate filename that includes both the private key and certificate for the SSL session. Default: None.
IMPORTANT: If you want to use Web Control Center outside your facility, you must use the options related to SSL Server to secure your connection.
  1. Save and close the file.
  1. Start the service—see Network Setup.

Running Harmony Web Control Center Manually

If you do not want to run Harmony Web Control Center as a service, you can manually start the Harmony Web Control Center server.

ClosedHow to manually run HarmonyWeb Control Center
  1. Using the Terminal, navigate to:

/usr/local/ToonBoomAnimation/harmony[edition]_12/lnx86_64/bin

  1. Run the following:

./webcc.sh

NOTE: You can change the default port used by Harmony Web Control Center by modifying the webcc.sh. Open the file using a text editor and add the value of the parameter and the desired value. See How to customize Harmony Web Control Center service above.

Other parameters can be customized—see Customizing the Harmony Web Control Center Service .

Network Setup

Setting Up a Static IP

ClosedHow to set up a static IP for Red Hat, Fedora or CentOS
  1. Edit the network file /etc/sysconfig/network:

/etc/sysconfig/network

  1. Configure the file as follows; replacing the bolded text with your values:

NETWORKING=yes

HOSTNAME=webcc.toonboom.com

  1. Depending on your network card, open the configuration file. For example, if you are using eth0, then you would edit the file ifcfg-eth0.

/etc/sysconfig/network-scripts/ifcfg-eth0

  1. Configure the file as follows, replacing the bolded text with your values:

DEVICE=eth0

BOOTPROTO=static

IPADDR=174.142.76.72

NETMASK=255.255.240.0

GATEWAY=10.120.0.254

ONBOOT=yes

  1. Edit the following file:

/etc/resolv.conf

  1. Configure the file as follows, replacing the bolded text with your values:

search toonboom.com

nameserver 10.120.0.1

  1. Restart the network service:

/etc/init.d/network restart

Opening a Port for External Connection

It is necessary to open a port in your firewall to allow other computers to access your Harmony Web Control Center server. Harmony Web Control Center is using port 8080 by default.

Closed How to open a port for Red Hat, Fedora or CentOS
  1. Edit the following file:

/etc/sysconfig/iptables

  1. Append the following rule to the file to open port 8080:

-A RH-Firewall-1-INPUT –m state –state NEW –m tcp –p tcp –dport 8080 –j ACCEPT

  1. Save and close the file.
  1. Restart the iptables service:

service iptables restart

Web Browser Note

Some browsers don't support Java and will have problems opening scenes. The first time you open a scene in a browser, it might take a long time because it has to set Java.

Troubleshooting

Problem: Unable to Start Web Control Center Nodes

The following error is generated each time a Web Control Center is started:

Error: ENOENT, no such file or directory

at Object.exports.init (/usr/local/ToonBoomAnimation/harmonyPremium_12.2/cloud/server/webcc.js:85:13)

at Object.<anonymous> (/usr/local/ToonBoomAnimation/harmonyPremium_12.2/cloud/server/webcc.js:214:9)

at Module._compile (module.js:456:26)

at Object.Module._extensions..js (module.js:474:10)

at Module.load (module.js:356:32)

at Function.Module._load (module.js:312:12)

at Module.require (module.js:364:17)

at require (module.js:380:17)

at Object.<anonymous> (/usr/local/ToonBoomAnimation/harmonyPremium_12.2/cloud/server/worker.js:14:13)

at Module._compile (module.js:456:26)

ClosedHow to fix the error generation

  1. Copy the libstdc++.so.6.0.20 packaged with the application to /usr/lib64:

cp /usr/local/ToonBoomAnimation/harmony[edition]_[version]/lnx86_64/lib/libstdc++.so.6.0.20 /usr/lib64

  1. Unlink the previous one:

unlink /usr/lib64/libstdc++.so.6

  1. Create the symbolic link using the one provided by the application:

ln -s /usr/lib64/libstdc++.so.6.0.20 /usr/lib64/libstdc++.so.6

The content reflects the features found in the latest Harmony 12.2 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