INSTALLING FTRACK 3 ON CENTOS 6.0
 

Installing Ftrack Version 3.0
A Complete Guide using Centos 6.0-64Bit

Centos Installation

Burn Centos 6.0 64-Bit DVD
Boot From DVD
Install “Standard Desktop”

Centos Settings

New Install: Overwrite Prior Linux Partions
Hostname: localhost.localdomain
Set Time: Select your city
Kernal Dump: Optional. Enabled or Disabled is OK
Root User: Enter your Root Password
New User: Enter new user/pass (i.e. “Test”). Must not be “Ftrack” or it will conflict with Installer.

When Installation Completes, remove DVD, Reboot.

Ftrack Installation

Network Connectivity

The Ftrack installation script will need to download several packages during installation so a public internet connection is required. Corporate proxy firewalls may cause the installation script to fail or timeout.

Installation

Official Ftrack Installation Guide (for reference):
http://ftrack.rtd.ftrack.com/en/3.0.3/administering/managing_local_installation/installing_ftrack.html

Prepare Ftrack Installation Script

1) Download Ftrack Config Script from Amazon. Place on Desktop.

https://s3-eu-west-1.amazonaws.com/ftrack-deployment/localinstall/installftrack_centos6.sh

2) Open Ftrack Config Script and remove or comment out the following two lines in the Ftrack download section near the top of script. This part of the script often fails, so commenting it out and downloading the files manually improves your chances of a successful install.

#echo "Downloading ftrack..."
#curl -o /opt/ftrack_config.tar.gz https://s3-eu-west-1.amazonaws.com/ftrack-deployment/localinstall/installdata/ftrack_config_20.tar.gz

Download and Extract Installation Packages

3) Download Latest ftrack install package from Ftrack User Forum
(Note: free username/ password required)

Forum: http://forum.ftrack.com/index.php?/forum/32-new-releases/
Find the forum post for the version you need and look for the included CentOS 5 or CentOS 6 Link.
Download: ftrack-3.xx.xx-centos6.tar.gz

4) Move ftrack-3.xx.xx-centos6.tar.gz to /opt

5) Extract packages (Right-click, Extract Here. Or use “tar -xvzf ftrack-3.xx.xx-centos6.tar.gz”
A directory called “ftrack” should now be visible.

6) Download Ftrack Configuration Package:
https://s3-eu-west-1.amazonaws.com/ftrack-deployment/localinstall/installdata/ftrack_config_20.tar.gz

7) Move Ftrack_Config_20.tar.gz to /opt. Do NOT extract.

Begin Installation

8) Using Terminal, navigate to /opt and run Ftrack script.

In Terminal:
cd /opt
./installftrack_centos6.sh

9) When prompted, enter track file path to config package: /opt/ftrack_config.tar.gz.

NOTE: If installation requires multiple attempts..
Make sure on each attempt:
-No “Ftrack” users are configured. (If created, delete it, otherwise install will fail)
-No “Ftrack” groups are configured. (If created, delete it, otherwise install will fail)
-Verify “ftrack_config” directory has been in deleted from /opt
-Verify “ftrack” installation directory is present in /opt

Installation Should Begin:

——Terminal Output——-

[root@localhost ~]# /root/Desktop/installftrack_centos6.sh
Enter the path to the downloaded ftrack package: /opt/ftrack_config.tar.gz
Installing ftrack…
Installing dependencies…
% Total % Received % Xferd Average Speed Time Time Time Current
Dload Upload Total Spent Left Speed
107 214 107 214 0 0 187 0 0:00:01 0:00:01 –:–:– 564

////——–removed for brevity———-////


Installation should complete with this terminal output:

249 -> 250…
done
success!
Starting ftrack…
Starting supervisor: /opt/ftrack/python/lib/python2.6/site-packages/supervisor/options.py:376: DeprecationWarning: Parameters to load are deprecated. Call .resolve and .require separately.
return pkg_resources.EntryPoint.parse(“x=”+spec).load(False)

———-

Once Installation is complete:

Configure wired ethernet interface with either permanent static IP address, or DHCP address (if connected to public network for further updates).

In Terminal:
nano /etc/sysconfig/network-scripts/ifcfg-eth0
configure ethernet settings
Control-x to exit
Press Y to save
Press return to exit Nano.

Disable Firewall

Firewall is enabled by default and will block requests to the Ftrack service.
Disable it in Terminal:
chkconfig iptables off

Disable Selinux

Selinux is enabled by default and could cause problems with the Ftrack service.
Disable it in Terminal:
cd /etc/sysconfig
nano selinux
Set SELINUX=disabled
Control-x to exit
Press Y to save
Press Enter to exit.

Important Network Ports:
Port 80 or 8080: used by Ftrack service to present the Ftrack web interface.
Port 8002: used by Ftrack syncing service to automatically push newly entered data to each user with the web application open. Required for proper interface interface functionality.

Installation is now complete.

Your Ftrack Server should now be available via connected web browser.

Open Firefox Browser (Version 18 or newer required)
Enter Ftrack server IP address in browser: i.e. 10.0.0.10:80 (if that port :80 doesn’t work try port :8080)
default user: root
default pass: 12345

————

Official Ftrack Installation and Upgrade notes:

Backing Up and Upgrading Ftrack

Upgrading to a new version of ftrack is easy. Download the new version from forum.ftrack.com and follow the instructions:

** Always backup your data before upgrading to a new version.
** It is not possible to downgrade from a version that contains database upgrades.

# Stop ftrack services.
/sbin/service ftrack stop
/sbin/service supervisord_apache stop

# Rename old ftrack folder to avoid conflicts whilst maintaining
# a snapshot of the previous version.
mv /opt/ftrack “/opt/ftrack_old_$(date +%Y_%m_%d)”

# Upgrade server.
tar -xf /PATH/TO/DOWNLOADED/FILE –dir /opt

# Upgrade database.
/opt/ftrack/upgradedb.sh

# Start ftrack services.
/sbin/service supervisord_apache start
/sbin/service ftrack start

Installing ftrack

To install ftrack on your new CentOS 6 server download the latest version from http://forum.ftrack.com and run the install script:

curl -O https://s3-eu-west-1.amazonaws.com/ftrack-deployment/localinstall/installftrack_centos6.sh
sh installftrack_centos6.sh

or download the install script and follow the steps manually for more control and to understand what it is doing.

Database
ftrack uses MariaDB 5.5 as its database and it is installed as part of the installation script. The installation script will set the root password of MariaDB to “rootpass”. You should change this to something more secret after the installation if completed.

Firewall and ports
A local installation of ftrack requires port 80 and 8002 to be open and accessible from all clients in order to function properly.

ftrack on disk
The ftrack installation consists of two main folders located in /opt:

/opt/ftrack The main ftrack service that will be replaced when upgrading to a new version. Any changes to this folder will therefore be replaced.
/opt/ftrack_config The configuration and data folder where sessions, configuration files and data such as thumbnails and files are stored.

—————–

Configuring MariaDB

[mysql]

# CLIENT #
port = 3306
socket = /var/lib/mysql/mysql.sock

[mysqld]

# GENERAL #
user = mysql
default-storage-engine = InnoDB
socket = /var/lib/mysql/mysql.sock
pid-file = /var/lib/mysql/mysql.pid

# MyISAM #
key-buffer-size = 32M
myisam-recover = FORCE,BACKUP

# SAFETY #
max-allowed-packet = 16M
max-connect-errors = 1000000

# DATA STORAGE #
datadir = /var/lib/mysql/

# BINARY LOGGING #
log-bin = /var/lib/mysql/mysql-bin
expire-logs-days = 14
sync-binlog = 1

# CACHES AND LIMITS #
tmp-table-size = 32M
max-heap-table-size = 32M
query-cache-type = 0
query-cache-size = 0
max-connections = 500
thread-cache-size = 50
open-files-limit = 65535
table-definition-cache = 4096
table-open-cache = 4096

# INNODB #
innodb-flush-method = O_DIRECT
innodb-log-files-in-group = 2
innodb-flush-log-at-trx-commit = 1
innodb-file-per-table = 1
innodb-buffer-pool-size = 2048M

# LOGGING #
log-error = /var/lib/mysql/mysql-error.log
log-queries-not-using-indexes = 1
slow-query-log = 1
slow-query-log-file = /var/lib/mysql/mysql-slow.log

**** CRITICAL SETTINGS*****

The most important configuration option is “innodb-buffer-pool-size” and should be adjusted as your database grows.

It is recommended to set it to roughly the same size as your database or more. A quick way to approximate your database size is to check the size of the ibdata1 file in the mysql folder.

ls -lh /var/lib/mysql/ibdata1
Be careful when setting to a high value, if there is not enough RAM available MariaDB will not start.

**** Server Options ****

Config options are used to enable or disable certain features or behavior in ftrack. They are specified on the ftrack server in /opt/ftrack_config/ftrack.ini under the [DEFAULT] section. After modifying the config file ftrack must be restarted for the changes to apply.