1. Install Ubuntu 10.10 64 bit
The Matterhorn Capture Agent has been tested with Ubuntu 10.10, which can be downloaded from http://www.ubuntu.com. Installation instructions on this page are tuned specifically for a fresh install of Ubuntu 10.10 64 bit. The hardware specifications do not include a cd drive, so if you do not have one available install the OS via a usb flash drive.
The installation script will not provide drivers for your media input devices. These drivers may already be provided by your OS or you may need to install them.
 | Using a different Operating System Other OSes have been reported as working by the community, including:
The installation scripts described on this page may be unsuitable or incomplete for these and/or other OSes where the agent may be installed, and most likely will need some adjustments to install a fully functional agent). You may also check the mailing list archives or start your own thread to get more information on how to install the Capture Agent in a specific operating system. |
 | 64 Bit only We recommend strongly against using 32 bit operating systems, the large file sizes produced by capture agents may require 64 bit OS support. |
| Windows and Mac OS X installation As the Matterhorn Capture Agent relies on video4linux for some of its operation it does not currently work on OS X or Windows. Limited functionality may be available. |
| Epiphan Capture Device These instructions do not apply to the Epiphan Capture Device (ECD). Configuration of those devices is done via their administration UI located at http://my_ecd/admin |
2. Get Matterhorn installation scripts
The latest version of the installation scripts is available at the trunk. This script will download other necessary configuration items. You can download the script via wget:
Or check it out using subversion.
3. Install Capture Agent
Go to the directory where you downloaded install.sh. Make sure the script has the execution permissions:
Installation of the capture agent may require super user privileges. To install in Ubuntu, execute in sudo mode:
| Network access required
|
4. Running the Capture Agent
Felix should start running automatically after the reboot, however, Felix can also be run manually should it have stopped abnormally or by user action:
- As a service, running
- Launching the start_matterhorn.sh script under the bin directory in the Felix home:
Manual launching of Felix
Felix will be attached to the current session and will die if the current user logs out. You can avoid this drawback by:- Using a session manager as GNU Screen or tmux.
- Running Felix as a service.
- Rebooting the agent machine.
5. Testing your Installation
Initialize a Test Capture
To determine that the capture agent has been setup correctly:
- Open a web browser and navigate to http://servername:8080/capture -- where servername is the name of the machine you installed the capture agent onto.
- If they are unchanged, use the default username and password to log into the capture agent website.
- Click on the "Start Capture" button at the bottom of the page to start a test capture.
- Once it has confirmed that it has begun capturing, navigate back to http://servername:8080/capture.
- Verify that the agent state at the top of the page has changed from idle to capturing.
- Click on the "Stop Capture" button at the bottom of the page.
- Once it has confirmed that it has stopped capturing, navigate back to http://servername:8080/capture.
- Verify that the agent state at the top of the screen has transformed to idle.
View the Test Capture
To verify the media captured by the capture agent:
- Navigate to http://servername:8080/capture, hyperlinks to the media should be present at the bottom of the screen. Alternatively, media is cached on the agent at $MATTERHORN_HOME/cache/captures.
- There should be one directory per capture containing one media file per capture device using the friendly name you specified during the install.
- Copy these media files to another machine or playing them on the server with your favorite media player.
- If the media files play correctly the capture agent has been installed and is ready to use.
6. Removing the Capture Agent
At a certain point in the installation process you will be prompted to choose the location to store the cleanup.sh script. This script will remove the capture agent from your system. If you want to clean up the capture agent from your system, go to the directory where cleanup.sh is and run the script as the superuser:
Some of the Capture Agent settings will not be removed until the machine reboots.
