ELEMENTAL LIVE WITH NODE-LOCKED LICENSE

INSTALL GUIDE
SEPTEMBER 2015
 Elemental Live Node-locked License - Install Guide

Elemental Technologies, Inc.

225 SW Broadway, Suite 600
Portland, Oregon, 97212

+1 503 222 3212

www.elementaltechnologies.com

Copyright © 2015 Elemental Technologies, Inc. All rights reserved.

Linux® is the registered trademark of Linus Torvalds in the U.S. and other countries. Windows is a registered
trademark of Microsoft Corporation in the United States and/or other countries. Mac is a trademark of Apple Inc.,
registered in the U.S. and other countries.

This guide corresponds to Elemental Live 2.8.0 and later.

Elemental Live with Node-locked License – Install Guide

Rev 4

Confidential Page 2
 Elemental Live Node-locked License - Install Guide

ABOUT THIS MANUAL

This guide is intended for engineers who will perform the first-time installation of Elemental Live using a node-
locked license on a hardware unit that is considered “qualified hardware”.
 For information on hardware that Elemental has qualified, contact your Elemental Sales representative or
Elemental Technical Support.
 For more information on the various install options available for Elemental software, and specifically whether
you should be reading this install guide, see “Installing Elemental Products – Orientation Guide”.

Pre-requisite Knowledge
It is assumed that you know how to:
 Log into a Linux session, in order to work via the command line interface.
 Use Windows Share (on a Windows computer) or Samba (on a Mac workstation) to move files.
 Access the location on your workstation where files downloaded from the internet are stored. This location is
your “workstation download directory”.

Note: If you need help with any of these procedures, contact techsupport@elementaltechnologies.com
For general help on the product, go to http://support.elementaltechnologies.com/

Confidential Page 3
 Elemental Live Node-locked License - Install Guide

1 INSTALLING ELEMENTAL LIVE

The procedure for installing any version of Elemental Live is the same; only the version number in the file name
changes. In this procedure, we show how to install version 2.8.0.12345 of the software.

Step A: Get Ready

Gather Information
1. Make sure you have set up the hardware unit on your network.
2. Obtain the Welcome email that you received from Elemental Technologies after you purchased your product.
This email contains:
 A link to download the Elemental ISO image.
 The activation code for your product. This code is in this format:
ABC-123-456-8901

3. If you are setting up several Elemental Live hardware units, you will have received several activation codes,
one for each unit.
Decide which activation code will be used on which unit. The codes are not tied ahead of time to any given
hardware unit, but you cannot use the same code on more than one unit.
4. Look in your internal records for the login credentials for the Elemental Customer Portal (http://
portal.elementaltechnologies.com/support/customer-portal). If you do not yet have an account, see below.

Download the OVA

5. From your regular workstation, open the Welcome email and click the OVA link. The media to choose
depends on the capabilities of the hardware unit where you will install the ISO image: whether it has a DVD
drive and/or a USB port.
The OVA file will be automatically downloaded to your workstation.
6. From your regular workstation, go to the Elemental Customer Portal:
http://portal.elementaltechnologies.com/support/customer-portal

Download the latest version of the Elemental Live software (the “download file”). Make sure you download
the versions for the processing architectures you need:
 CPU-only version.
 GPU-enabled version.
7. Make a note of your workstation download directory. For example:
h:/corporate/downloads/.

8. Make a note of the name of the files you downloaded. For example:
elemental_production_live_2.8.0.12345.run

Confidential Page 4
 Elemental Live Node-locked License - Install Guide

centos-20130921T131201-production.iso

Creating an Account on Elemental Customer Portal

1. From a browser that has access tol the internet, go to this URL:
http://portal.elementaltechnologies.com/user/register

The Request an account tab of the Elemental Customer Portal appears.

2. Complete all fields and click Create new account.
The request is sent to Elemental Support. Within 2 business days, you will receive an email with your account
credentials.

Step B: Install (Kickstart) the ISO Images

You must install the ISO image onto each hardware unit. Installing an ISO image is also referred to as “kickstarting
the system”.
1. Burn the DVD image you downloaded to a DVD, or raw-write the USB image you downloaded to a USB
thumb drive (USB stick). Follow the instructions for the utility you use.
2. Insert the DVD or USB thumb drive into the hardware unit and boot from that DVD or USB thumb drive.
The installer will automatically start.
3. Follow the prompts to install the ISO image:
 hostname. Change the hostname to a useful name such as “live01” or “live-chicago-01”.
Do not use localhost as the hostname!
Do not use periods or underscores in the hostname.
 Disk layout: Choose Intel RAID.
 Set product key:
 Press Enter to skip this option.
 Upgrade: Choose No.
4. Repeat steps 2. and 3. on each Elemental Live hardware unit.
The ISO image will be installed. From now on, the hardware unit will run this customized version of the Linux
operating system.

Step C: Generate a License Activation Key File

When the ISO has been installed, one of the files that will be on the hardware unit is “keygen”, which is a utility to
generate an activation key file that is the first step in obtaining a product license file.
1. At the hardware unit, log in with username “elemental” and password “elemental”. You will be logged in at the
home directory (/elemental).
2. Enter this command:
[elemental@hostname ~]$ ./keygen

3. At the prompt, enter the activation code.

Confidential Page 5
 Elemental Live Node-locked License - Install Guide

The following file is created in the home directory:

activation_<hostname of the system>.key

4. Copy the file to your workstation. For example:

 Use Windows Share protocol: Connect to “\\<elemental-ip>\elemental” on a PC
 Use Samba: Connect to “smb://<elemental-ip>/elemental” on a Mac.
Use username “elemental” and password “elemental” and copy/paste the file from the network share.
5. Email the file to Elemental: elemental_licensing@elementaltechnologies.com
6. Repeat these steps for each Elemental Live hardware unit.
 Make sure to log into each hardware unit for each activation key file you want to generate: each activation
key file you create must contain the hostname of the individual hardware unit.
 Make sure to use a different activation code on each unit.

Step D: Install the Software

1. These steps must be performed on the Elemental Live hardware unit.
2. From a Linux prompt, log in with username “elemental” and password “elemental”.
3. Run the installer as follows:
For “GPU and CPU” versions of the software:
[elemental@hostname ~]$ sudo sh ./elemental_production_live_2.8.n.nnnnn.run -l -z -t

For “CPU-only” versions of the software:

[elemental@hostname ~]$ sudo sh ./elemental_production_live_cpu_2.8.n.nnnnn.run -l -z -t

Where -l is a letter, not a number.

4. You will be prompted to answer the prompts shown in the table below.
Then the software will be installed. Finally, this message will appear:
Installation and configuration complete!
Please open a web browser and point it to http://xxx.xxx.xxx.xxx to get to the web
interface.
Please contact techsupport@elementaltechnologies.com if you are having
difficulties.
Enjoy!

5. Start a web browser and start the Elemental Live web interface by typing:
http://<hostname>

Make sure the web interface displays.

Confidential Page 6

Prompt
Do you agree to these terms?
Enter this server’s Hostname
Is eth0 a management interface?
Does eth0 use DHCP to get its IP address?
Enter eth0's IP address:
Enter eth0's NETMASK:
Enter eth0's Gateway (or type 'none'):
Keep this configured nameserver: 10.6.16.10? Skip; you will set up a nameserver in the next phase of configuration.
Would you like to configure eth1?
The firewall for this system is currently
disabled. Would you like to enable it?
Select time zone ('n' for more)
Would you like to start the Elemental service
now?
Elemental Live Node-locked License - Install Guide
Action
This prompt appears after you have paged through the EULA (end user
license agreement).
Enter Yes or No. (You must enter Yes to continue.)
Enter the hostname of this hardware unit. For example, “live-01”
Enter Yes.
Enter Yes to use DHCP or enter No to enter a static IP address.
If you plan to bond eth0 and eth1 (which you will set up in a later phase), we
recommend you enter a static IP address and set up eth0, eth1 and bond0 all
on the same subnet.
If you chose static, enter the IP address for this hardware unit.
If you chose static, enter the netmask for this hardware unit.
If you chose static, type “none” or enter the gateway for this hardware unit.
Enter No; you can configure eth1 in the next phase of the configuration.
Skip; you will set up the firewall in the next phase of configuration.
Enter the timezone you want to show on the web interface of the nodes. This
setting does not affect activity via SSH or via the REST API.
Enter Yes.
Confidential Page 7
 Elemental Live Node-locked License - Install Guide

Step E: Install the License Files

You will receive an email containing one or more .tgz files (one for each hardware unit). Each .tgz file is named as
follows:
lic-download-<hostname>.tgz

1. Put the .tgz files in a convenient directory on your workstation. For example, in a directory called “licenses”.
Make a note of the path.
Perform the following step for each hardware unit for which you received license files.
2. On the Elemental Live node, display the web interface. From the main menu, choose Settings > Licenses. The
Licenses screen appears.

3. Click Browse and navigate to the directory where you placed the license files. Select the file name with the
hostname portion matching the hostname of this node.
4. Back on the Licenses screen, click Update. The license file will be installed.
5. Repeat steps 2. to 4. for each hardware unit.

Confidential Page 8
 Elemental Live Node-locked License - Install Guide

2 NEXT STEPS

You have now installed and performed basic configuration of Elemental Live. To complete the configuration, refer
to the following:

Scenario Guide
Elemental Live working without Conductor Live, in Configuring a Stand-alone Node – Quick Guide
other words, Elemental Live in “stand-alone”
Elemental Live being controlled by Conductor Live 2.x, Configuring a Conductor Cluster – Quick Guide
in other words, Elemental Live in a Conductor Live 2.x
cluster.
Elemental Live being controlled by Conductor Live 3, in Conductor Live 3 Configuration Guide
other words, Elemental Live in a Conductor Live 3
cluster.

Confidential Page 9

Appendix A: Error Messages
Error messages during install appear on the command line.
Error Possible Problem
Hardware and license validation eth0 is not set up
failed
eme.lic is not valid
cable.lic is not valid
Products do not match
Card counts do not match
Confidential
Elemental Live Node-locked License - Install Guide
Possible Reason
You forgot to specify the address for eth0. Review the
prompts in Step D.
If you are installing licenses on several hardware units,
you may have installed the wrong eme.lic license on this
unit. Review the steps in Step E.
If you are installing licenses on several hardware units,
you may have installed the wrong cable.lic license on this
unit. Review the steps in Step E.
You may have requested and installed a license for one
product (for example, Elemental Live) and then installed a
different product (for example, Elemental Server).
If you changed the CPU or GPU cards on the hardware
unit after requesting the license, the license may no longer
be valid. Change the cards back or contact your Sales
representative to discuss your revised licensing
requirements.
Page 10
 Elemental Live Node-locked License - Install Guide

Appendix B: Sample Install

Following is a screen printout of a typical install, showing the prompts and possible responses.
[elemental@hostname ~]$ sudo sh ./elemental_production_live_cpu_2.8.0.12345.run –l –z –t
Verifying archive integrity... All good.
Uncompressing Elemental Installer...
Network device eth0 already initialized...

Stopping Apache..
Checking Elemental System Update
Starting system update
New system update version: 25301
System packages are now being updated and modified!
Please DO NOT interrupt the installer after this point!
Running pre-installation tasks.
Installing AJA Driver
Installing Deltacast Driver
Installing DekTec Driver
Installing MOTD
Installing /etc/issue
Installing new RPMs......
Installing new gems..............
Running scripts...
Installing Elemental Live 2.8.0.12345
Network device eth0 already initialized...

Welcome to the product installation utility!

Version information:
Elemental Live (CPU) 2.8.0.12345
-------------------------
ruby 1.9.3p484 (2013-11-22 revision 43786) [x86_64-linux]
Rails 3.2.17
mysql Ver 14.14 Distrib 5.1.73, for redhat-linux-gnu (x86_64) using readline 5.1
Elemental Git revision 613c91dd

You are prompted to read and accept the EULA:

Checking license files.
IMPORTANT INFORMATION
.
.
.
Continue? [Y] y

.
.
.
Continue? [Y] y

Confidential Page 11
 Elemental Live Node-locked License - Install Guide

.
.
.

Continue? [Y] y
.
.
.
Do you agree to these terms? [N] y

You are prompted to configure the network:

Enter this server's Hostname: [centos] live-01
Detected 2 ethernet devices
Configuring eth0
Is eth0 a management interface? [Y]
Does eth0 use DHCP to get its IP address? [Y]
Would you like to configure eth1? [N]
The firewall for this system is currently enabled. Would you like to disable it? [N]

Services are stopped (note that actually no services are running) and interfaces are shut down:
Stopping services...
Applying network settings to system...

Shutting down interface eth0: [ OK ]

Shutting down loopback interface: [ OK ]

Interfaces are configured with the new information:

Bringing up loopback interface: [ OK ]
Bringing up interface eth0:
Determining IP information for eth0... done.
[ OK ] Bringing up interface eth1:
Determining IP information for eth1... done.
[ OK ]

Services are started:

Starting ntpd: [ OK ]
Starting mysqld: [ OK ]

Stopping mysqld: [ OK ]
Starting mysqld: [ OK ]

The Elemental Live software is configured:

Creating/Updating database...
Running migrations - this could take a while.
Database creation complete!
Loading Rails environment...
Adding node to database...
Saving settings...
Adding cluster stat monitors...
Adding node stat monitors...
Adding cluster scheduled tasks...
Adding node scheduled tasks...
Adding licensing scheduled tasks...
Probing capture cards...
Checking hardware and license files...
[2014-11-11 00:39:08 +0000 SERVICE]: 1 CPU cores available, max CPU load: 2.88

Confidential Page 12
 Elemental Live Node-locked License - Install Guide

Hardware and license check complete

Creating default directory structures and data Setting live defaults...
Checking user presets...
Checking user profiles...
Changing permissions and ownership...
Cleaning elemental_ipc...
Removing tmp...
Removing cached files
Configuring Apache...

Adding Elemental service...

Configuring log rotation...
Configuring SNMP...
Configuring dynamic libraries...
Configuring NTP...
Setting sysctl configuration and adding to /etc/rc.local...
Configuring Avahi...
Shutting down SMB services:[ OK ]
Starting SMB services: [ OK ]

Configuring EME network permissions

Configuring EME network permissions
Setting CPU scaling governorStarting services...
Starting system logger: [ OK ]

Do not worry about the following warning:

Starting httpd: httpd: apr_sockaddr_info_get() failed for live-01
httpd: Could not reliably determine the server's fully qualified domain name, using 127.0.0.1
for ServerName
[ OK ]
Starting ntpd:
Shutting down Avahi daemon:[ OK ]
Starting Avahi daemon... [ OK ]
Starting snmpd: [ OK ]
Starting redis-server: [ OK ]
Starting serf: [ OK ]

You are prompted to start elemental_se:

Would you like to start the Elemental service now? [Y]
Starting elemental_se: [ OK ]
Starting elemental-issue: [ OK ]
Installation and configuration complete!
Please open a web browser and point it to http://10.4.136.95 to get to the web interface.
Please contact techsupport@elementaltechnologies.com if you are having difficulties.
Enjoy!

Confidential Page 13