Chapter 15: Installing Harmony Cloud on Linux
Before installing Harmony Cloud, add the following to the options list:
|
Option |
Default Value |
Details |
|
-c
|
Inactive |
Installs Harmony Cloud as a service. This parameter is required if this machine is the Harmony Cloud web server. |
Configuring the Licensing
Setting Up in a Non-Gui Environment
How to install Harmony Cloud 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). |
| 2. | Place both files in the bin directory of your Harmony install. Typically located here: |
/usr/local/ToonBoomAnimation/harmony_11.2/lnx86_64/bin
| 3. | Change the permissions on the anchor script to be executable: |
chmod 755 install_fnp.sh
| 4. | Execute the install_fnp.sh script |
./install_fnp.sh
| 5. | 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
| 6. | Type the activation key next to -entitlementID to replace the Xs. |
Configuring Toon Boom Harmony Cloud
Running Harmony Cloud as a Service
After installing Harmony Cloud, you will need to start the service.
How to start Harmony Cloud as a service
| 1. | Run the following command as the root user: |
/sbin/service USAnimation_harmony_cloud start
Customizing the Harmony Cloud Service
You have the ability to customize the Harmony Cloud service. This can be done using your favorite text editor.
How to customize the Harmony Cloud Service
| 1. | Stop the service if it is active—see Managing the Harmony Cloud Service. |
| 2. | As the root user, open the following file: |
/usr/sbin/start_harmony_cloud
| 3. | At the bottom of the file, edit the line: |
exec HarmonyCloud_starter \
HarmonyCloud –docroot ../../resources/cloud –http-port 8080 –http-address 0.0.0.0 \
--threads 1- --config ../../resources/cloud/wt_config.xml \
>>& $log < /dev/null &
Where the available parameters for modification are as follows:
| ‣ | --http-port the port to deploy to |
| ‣ | --http-addressIPv4 (e.g. 0.0.0.0) or IPv6 Address (e.g. 0::0) |
| ‣ | --threadsnumber of threads |
| 4. | Save and close the file. |
| 5. | Start the service—see Managing the Harmony Cloud Service. |
Running Harmony Cloud Manually
If you do not want to run Harmony Cloud as a service, you can manually start the Harmony Cloud server.
| 1. | Using the Terminal, navigate to: |
/usr/local/ToonBoomAnimation/harmony_11.2/lnx86_64/bin
| 2. | Run the following: |
./HarmonyCloud.sh
You can change the default port used by Harmony Cloud by modifying the HarmonyCloud.sh. Open the file using a text editor and update the value of the parameter –http-port to the desired value. See the following text:
./HarmonyCloud --docroot ../../resources/cloud --http-address 0.0.0.0 --http-port 8080 --config ../../resources/cloud/wt_config.xml
The above parameters can be customized—see Customizing the Harmony Cloud Service .
Managing the Harmony Cloud Service
If at any point, you need to start/stop or restart the Harmony Cloud server. You can do so through the /sbin/service in Linux.
| To start the service |
|
| To stop the service |
|
| To restart the service |
|
Alternatively, you can start or stop all Harmony Services with the following commands:
| To start all services |
|
| To stop all services |
|
Network Setup
Setting Up a Static IP
How to set up a static IP for Red Hat, Fedora or CentOS
| 1. | Edit the file /etc/sysconfig/network: |
/etc/sysconfig/network
| 2. | Configure the file as follows; replacing the bolded text with your values: |
NETWORKING=yes
HOSTNAME=cloud.toonboom.com
| 3. | Depending on your network card, open the configuration file. For example, if you are using eth0, then you would edit the file /etc/sysconfig/network-scripts/ifcfg-eth0. |
/etc/sysconfig/network-scripts/ifcfg-eth0
| 4. | 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
| 5. | Edit the following file: |
/etc/resolv.conf
| 6. | Configure the file as follows, replacing the bolded text with your values: |
search toonboom.com
nameserver 10.120.0.1
| 7. | 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 Cloud server. Harmony Cloud is using port 8080 by default.
How to open a port for Red Hat, Fedora or CentOS| 1. | Edit the following file: |
/etc/sysconfig/iptables
| 2. | 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
| 3. | Save and close the file. |
| 4. | Restart the iptables service: |
service iptables restart