User guide

ManualsBrandsTeradek ManualsAccessories for videoSputnik

Page | 1

Sputnik Installation and Configuration Guide

1 Contents

2 Introduction ............................................................................................................................................ 2

3 Installing Sputnik (Local Linux Machine) ............................................................................................... 2

4 Sputnik Operation ................................................................................................................................. 2

5 Creating an Amazon EC2 instance for Sputnik ..................................................................................... 3

6 Configuring your EC2 Instance‟s Security Settings .............................................................................. 7

7 Installing Sputnik (EC2) ......................................................................................................................... 9

Summary of content (10 pages)

PAGE 1
Sputnik Installation and Configuration Guide 1 Contents 2 Introduction............................................................................................................................................ 2 3 Installing Sputnik (Local Linux Machine) ............................................................................................... 2 4 Sputnik Operation .................................................................................................................................
PAGE 2
Introduction Sputnik is Teradek‟s interface between Bond and your streaming destination. Sputnik is designed to run on a Linux computer either in the cloud (using Amazon‟s EC2 services) or on a local server with a single, publically addressable TCP port. For Amazon EC2 configuration, start with Creating an Amazon EC2 instance for Sputnik, page 3. 3 Installing Sputnik (Local Linux Machine) 1. Download the Sputnik RPM file. This package contains the Sputnik binaries and configuration files. 2.
PAGE 3
5. Sputnik log file location: /var/log/sputnik.log (to view Sputnik‟s output while it is running, use „tail –f /var/log/sputnik.log‟) 6. Sputnik configuration file location: /etc/sputnik.conf Sputnik‟s configuration file contains two options – listening port and web server port. Sputnik i. must be restarted after any changes are made to the configuration. ii. Listening Port: Default is 5111. This option allows you to specify the TCP port that Sputnik uses to listen for connections from Bond devices.
PAGE 4
8. Select „Launch Classic Wizard.‟ 9. Select the „Community AMIs‟ tab and wait for the AMI List to load. 10. Select „Amazon Images‟ in the „Viewing‟ dropdown. a. Search for „amzn-ami-2011.‟ b. Choose an i386 ami with „instance-store‟ as the root device. Click the „Select‟ button next to your chosen AMI. Your AMI name will look something like „amzn-ami-2011.09.02.i386xx….xx.‟ The “xx…xx” after the i386- varies depending on Region selected. Note: The i386 ami instance allows you to select a “small” instance.
PAGE 5
12. Skip the „Advanced Instance Options‟ by selecting Continue. 13. Add a name to your instance by specifying it next to „Name‟ in the „Value‟ column on the tags page. 14. Create a Key-Pair. In this case we have entered „TeradekBond‟ as an example. Version 2.0 May „12 © Teradek, LLC 2012. All rights reserved.
PAGE 6
15. Download the „.pem‟ permissions file. This file is required for SSH access to your Sputnik server. The permissions file can only be downloaded once from Amazon, so it may be wise to create a backup of the file. Note you will use this file later in the process. 16. Select the Security Group you configured in step 5 or configure a new one according to Configuring your EC2 Instance‟s Security Settings if you haven‟t already. Click Continue. 17. Review your settings and then click „Launch.
PAGE 7
18. To give your EC2 instance a fixed address. a. In the Navigation bar Navigate to the „Elastic IPs‟ section b. Click the „Allocate New Address‟ button and confirm by clicking „Yes, allocate‟ (make sure „EC2‟ is selected). 19. Select the newly listed Address listing and click the „Associate Address‟ button. Select your newly created instance and click „Yes, Associate.‟ 20. Your Amazon EC2 instance should now be running and ready for Sputnik installation. 21.
PAGE 8
3. Enter a name and description for your security group. Make sure „No VPC‟ is selected and click „Yes, Create.‟ 4. Select the „Inbound‟ tab a. Select „Custom TCP rule.‟ b. Enter 5111 in the „Port range‟ field . This is the default port used for connections between Bond and Sputnik. c. Click „Add Rule.‟ d. With „Custom TCP rule‟ selected, add another rule for port 1957, the default web server port for Sputnik.
PAGE 9
a. Select „SSH‟ for „Create a new rule.‟ b. Click „Add Rule.‟ c. After adding the rules, the listing on the right should look similar to the following: d. Click „Apply Rule Changes‟ at the bottom of the Security Group pane. 7 Installing Sputnik (EC2) Download the Sputnik RPM file. This package contains the Sputnik binaries and configuration files. For convenience, save the RPM file to the same directory as your permissions file (Creating an Amazon EC2 instance for Sputnik, step 13).
PAGE 10
b. Replace with the permissions file name, with the Sputnik RPM name (and path if not in the same directory), and with the address of your EC2 instance. $ scp –i ec2-user@:~/ 4. Connect via SSH to your Amazon EC2 instance. a. SSH allows you to log into your EC2 instance in the cloud to begin the installation process. b. Replace