Installing Kaltura on a Single Server (deb)
This guide describes deb installation of an all-in-one Kaltura server and applies to deb based Linux distros.
The processes was tested on Debian 8 and Ubuntu 14.04 but is expected to work on other versions. If you tried a deb based distro and failed, please report it.
Kaltura Inc. also provides commercial solutions and services including pro-active platform monitoring, applications, SLA, 24/7 support and professional services. If you're looking for a commercially supported video platform with integrations to commercial encoders, streaming servers, eCDN, DRM and more - Start a Free Trial of the Kaltura.com Hosted Platform or learn more about Kaltura' Commercial OnPrem Edition™. Please note that this service in only offered for RHEL based distros.
Table of Contents
- This install guides assumes that you did a clean, basic install of one of the deb based OSes in 64bit architecture.
- When installing, you will be prompted for each server's resolvable hostname. Note that it is crucial that all host names will be resolvable by other servers in the cluster (and outside the cluster for front machines). Before installing, verify that your /etc/hosts file is properly configured and that all Kaltura server hostnames are resolvable in your network.
- Before you begin, make sure you're logged in as the system root. Root access is required to install Kaltura, and you should execute
su -to make sure that you are indeed root.
Kaltura requires certain ports to be open for proper operation. See the list of required open ports. If you're just testing and don't mind an open system, you can use the below to disbale iptables altogether:
iptables -F service iptables stop chkconfig iptables off
Disable SELinux - REQUIRED
Currently Kaltura doesn't properly support running with SELinux, things will break if you don't set it to permissive.
To verify SELinux will not revert to enabled next restart:
- Edit the file
- Verify or change the value of SELINUX to permissive:
- Save the file
Start of Kaltura installation
This section is a step-by-step guide of a Kaltura installation.
Setup the Kaltura deb repository
wget -O - http://installrepo.kaltura.org/repo/apt/debian/kaltura-deb.gpg.key|apt-key add - echo "deb [arch=amd64] http://installrepo.kaltura.org/repo/apt/debian jupiter main" > /etc/apt/sources.list.d/kaltura.list
NOTE: for Debian, the non-free repo must also be enabled
Ubuntu NOTE: You must also make sure the multiverse repo is enabled in /etc/apt/sources.list
Debian Jessie  NOTE: You must also make sure the following Wheezy repos are enabled in /etc/apt/sources.list
deb http://ftp.debian.org/debian/ wheezy main deb http://security.debian.org/ wheezy/updates main
depending on your current Apache configuration, you may need to disable your default site configuration.
# apachectl -t -DDUMP_VHOSTS
to check your current configuration and:
to disable any site that might be set in a way by which $YOUR_SERVICE_URL/api_v3 will reach it instead of the Kaltura vhost config.
In such case, the postinst script for kaltrua-db will fail, if so, adjust it and run:
# dpkg-reconfigure kaltura-db
MySQL Install and Configuration
Please note that for MySQL version 5.5 and above, you must first disable strict mode enforcement. See: https://support.realtyna.com/index.php?/Knowledgebase/Article/View/535/0/how-can-i-turn-off-mysql-strict-mode
Install Kaltura Server
You can use this process to auto install an all in 1 server. In order to perform a manual step by step install, simply copy the commands and run them one by one.
NOTE: the script calls aptitude with -y which means you will not be prompted to confirm the packages about to be installed.
# wget http://installrepo.kaltura.org/repo/apt/debian/install_kaltura_all_in_1.sh # chmod +x install_kaltura_all_in_1.sh # ./install_kaltura_all_in_1.sh
Configure Red5 server
- install the kaltura-red5 package:
# aptitude install kaltura-red5
- Request http://hostname:5080
- Click 'Install a ready-made application'
- Mark 'OFLA Demo' and click 'Install'
- Edit /usr/lib/red5/webapps/oflaDemo/index.html and replace 'localhost' with your actual Red5 hostname or IP
- Test OflaDemo by making a request to http://hostname:5080/oflaDemo/ and playing the sample videos
Your Kaltura installation is now complete.
SSL Step-by-step Installation
- Currently, the Nginx VOD module does not support integration with Kaltura over HTTPs, only HTTP is supported.
SSL Certificate Configuration
Your Kaltura installation is now complete.
This will only work if the initial install was using this packages based install, it will not work for old Kaltura deployments using the PHP installers
# aptitude update # aptitude install ~Nkaltura # dpkg-reconfigure kaltura-batch # dpkg-reconfigure kaltura-front
Use this in cases where you want to clear the database and start from fresh.
# /opt/kaltura/bin/kaltura-drop-db.sh # aptitude purge ~Nkaltura # rm -rf /opt/kaltura
Once the configuration phase is done, you may wish to run the sanity tests, for that, run:
If you experience unknown, unwanted or erroneous behaviour, the logs are a greta place to start, to get a quick view into errors and warning run:
If this does not give enough information, increase logging verbosity:
sed -i 's@^writers.\(.*\).filters.priority.priority\s*=\s*7@writers.\1.filters.priority.priority=4@g' /opt/kaltura/app/configurations/logger.ini
To revert this logging verbosity run:
sed -i 's@^writers.\(.*\).filters.priority.priority\s*=\s*4@writers.\1.filters.priority.priority=7@g' /opt/kaltura/app/configurations/logger.ini
Or output all logged information to a file for analysis:
allkaltlog > /path/to/mylogfile.log
For posting questions, please go to: (http://forum.kaltura.org)
- Please review the frequently answered questions document for general help before posting to the forums or issue queue.
- This guide describes the installation and upgrade of an all-in-one machine where all the Kaltura components are installed on the same server. For cluster deployments, please refer to cluster deployment document, or Deploying Kaltura using Opscode Chef.
- To learn about monitoring, please refer to configuring platform monitors.
- Testers using virtualization: @DBezemer created a basic CentOS 6.4 template virtual server vailable here in OVF format: https://www.dropbox.com/s/luai7sk8nmihrkx/20140306_CentOS-base.zip
- Alternatively you can find VMWare images at - http://www.thoughtpolice.co.uk/vmware/ --> Make sure to only use compatible OS images; either RedHat or CentOS 5.n, 6.n or FedoraCore 18+.
- Two working solutions to the AWS EC2 email limitations are:
- Using SendGrid as your mail service (setting up ec2 with Sendgrid and postfix).
- Using Amazon's Simple Email Service.
- Kaltura Inc. also provides commercial solutions and services including pro-active platform monitoring, applications, SLA, 24/7 support and professional services. If you're looking for a commercially supported video platform with integrations to commercial encoders, streaming servers, eCDN, DRM and more - Start a Free Trial of the Kaltura.com Hosted Platform or learn more about Kaltura' Commercial OnPrem Edition™. For existing deb based users, Kaltura offers commercial upgrade options.