IXIA XRPi2 User manual

XRPi2
User Guide
May 2016

Copyright and Disclaimer
Copyright © 2016 Ixia. All rights reserved.
This publication may not be copied, in whole or in part, without Ixia's consent.
RESTRICTED RIGHTS LEGEND: Use, duplication, or disclosure by the U.S. Government is subject to the
restrictions set forth in subparagraph (c)(1)(ii) of the Rights in Technical Data and Computer Software
clause at DFARS 252.227-7013 and FAR 52.227-19.
Ixia, the Ixia logo, and all Ixia brand names and product names in this document are either trademarks
or registered trademarks of Ixia in the United States and/or other countries. All other trademarks
belong to their respective owners.
The information herein is furnished for informational use only, is subject to change by Ixia without
notice, and should not be construed as a commitment by Ixia. Ixia assumes no responsibility or liab-
ility for any errors or inaccuracies contained in this publication.
ii XRPi2 User Guide

Third-Party Copyrights and Licenses
Raspbian
Raspbian (www.raspbian.org) is distributed under the GNU General Public License, version 2 (GNU
GPLv2).
iii XRPi2 User Guide

Contacting Ixia
Corporate
Headquarters
Ixia Worldwide Headquarters
26601 W. Agoura Rd.
Calabasas, CA 91302
USA
+1 877 FOR IXIA (877 367 4942)
[phone] (International)
(FAX) [phone]
[e-mail]
Web site: www.ixiacom.com
General: [e-mail]
Investor Relations: [e-mail]
Training: [e-mail]
Support: [e-mail]
[phone]
For the online support form, go to: http://www.ixi-
acom.com/support/inquiry/
EMEA Ixia Europe Limited
Part 2nd floor,
Clarion House, Norreys Drive
Maidenhead, UK SL6 4FL
[phone]
FAX [phone]
[e-mail]
Support: [e-mail]
[phone]
For the online support form, go to: http://www.ixi-
acom.com/support/inquiry/?location=emea
Asia Pacific Ixia Pte Ltd
210 Middle Road
#08-01 IOI Plaza
Singapore 188994
Support: [e-mail]
[phone]
For the online support form, go to: http://www.ixi-
acom.com/support/inquiry/
Japan Ixia KK
Nishi-Shinjuku Mitsui Bldg 11F
6-24-1, Nishi-Shinjuku, Shinjuku-ku
Tokyo 160-0023
Japan
Support: [e-mail]
[phone]
For the online support form, go to: http://www.ixi-
acom.com/support/inquiry/
India Ixia Technologies Pvt Ltd
Tower 1, 7th Floor, UMIYA Business Bay
Cessna Business Park
Survey No. 10/1A, 10/2, 11 & 13/2
Outer Ring Road, Varthur Hobli
Kadubeesanahalli Village
Bangalore East Taluk
Bangalore-560 037, Karnataka, India
[phone]
Support: [e-mail]
[phone]
For the online support form, go to: http://www.ixi-
acom.com/support/inquiry/?location=india
China Ixia Technologies (Shanghai) Company Ltd
Unit 3, 11th Floor, Raffles City, Beijing
Beijing, 100007 P.R.C.
Support: [e-mail]
400 898 0598 (Greater China Region)
[phone] (Hong Kong)
XRPi2 User Guide iv
Contacting Ixia

v XRPi2 User Guide
This page intentionally left blank.

CONTENTS
Third-Party Copyrights and Licenses iii
Contacting Ixia iv
CONTENTS vi
About This Guide viii
Typographical Conventions viii
Related Documentation ix
Introduction 1
Package Contents 1
Ethernet and USB Ports 2
Power and HDMI Ports 3
Micro SD slot 4
System Information 5
Setting up the XRPi2 6
First-time Setup 7
Upgrading the XRPi2 11
Upgrading with the Supplied Utilities 11
Upgrading Through Hawkeye 12
Scripts 15
Linux Quick Reference 17
XRPi2 User Guide vi

vii
This page intentionally left blank.

About This Guide
This section describes the typographical conventions used in this guide and contains a list of related
documentation that you may find useful .
Typographical Conventions
The following typographical conventions are used in this documentation:
lItalics are used to indicate the names of software fields and parameters, titles of books or doc-
uments, and first references to words, terms, phrases, or concepts that have a special meaning or
require special identification or emphasis. For example:
nIn the userid field, enter your assigned user identification number.
nNorton’s Telecom Dictionary is a helpful reference tool.
nThe term tolerance level refers to the standard deviation setting.
nThe variable nrepresents any numerical value.
lMenu names and options appear as bold blue text in online Help, and appear in small capital let-
ters in documents. For example:
nTo save your input, choose the File>Save menu option.
lBold black type is used to indicate the names of buttons, commands, and files that are part of pro-
cedures, as well as to identify field and parameter options. In addition, bold text emphasizes
important information in text or in caution, warning, or danger statements. For example:
nTo proceed to the next step, click OK.
nUse the copy command to duplicate the field entry.
nSave and close the books.xml file.
nAlways save your test configuration.
lCourier text is used to indicate typed text input. For example:
nAccess the new file name at the command line: c = newbook.gif.
nEnter the setup.ini location: setupini = Ixia\Code\New.
lPC keys are indicated in all caps, using the following conventions:
nSimultaneous keystrokes are shown by joining the key names with a plus sign (+), For
example, CTRL+Q.
nSequential keystrokes are shown by joining the key names with a comma (,). For example,
SHIFT, F7.
Icons are used throughout the documentation to draw attention to caution, warning, and danger state-
ments. Icons also identify notes, important information, and the start of a procedure.
Provides information that is needed to avoid potential harm to equipment or the envir-
onment.
XRPi2 User Guide viii
About This Guide

Provides information needed to prevent certain harm to a person, piece of equipment,
or the environment.
Provides information that needs special attention within text.
Provides a suggestion.
Related Documentation
The following documentation may be helpful in gaining more understanding of the XRPi2.
XRPi2 Quick Start Guide
Ixia user documentation is available in the Support > User Guides area of Ixia's website. Registration
is required to access this area of the website.
ix XRPi2 User Guide
About This Guide

Introduction
The XRPi2 is a low-profile ultra-small form factor unit ideal for use as an endpoint. It contains an ultra-
low voltage CPU, two integrated Ethernet ports, and no fan.
Package Contents
The XRPi2 ships with the following components:
lXRPi2 unit
lDual-voltage (110/220) ACpower adapter
lHDMIcable
lHDMI-to-DVIadapter
lQuick Start Guide
XRPi2 User Guide 1

Ethernet and USB Ports
Component Description
Ethernet port Use these ports to connect the XRPi2 to other Ethernet devices.
LANLEDs
Green: Connection speed.
On 100Mbps
Off 10Mbps
Yellow: Activity.
On port is active
Blinking port is sending or receiving traffic
USB ports USB 2.0 ports.
Keyboards and mice are the only supported accessories that can be
plugged into these ports.
2 XRPi2 User Guide
Introduction

Power and HDMI Ports
Component Description
Power port Micro-USB power port. Connect the supplied AC power adapter to this
port.
HDMI HDMI 1.4 video output port. Connect the supplied HDMI cable to this
port.
Stereo 3.5 mm stereo output port (disabled)
XRPi2 User Guide 3
Introduction

Micro SD slot
Component Description
Micro SDslot Micro SD card slot. The XRPi2 operating system and application soft-
ware is supplied on a micro SD card. The micro SD card is the only per-
manent storage on the XRPi2.
Inserting the Micro SDcard
To insert the micro SDcard, position the micro SDcard with the contacts facing upwards and insert the
card into the slot until you hear a click.
Removing the Micro SDcard
To remove the micro SDcard, press the card inwards with a fingernail until you hear a click, and then
withdraw the card from the slot.
4 XRPi2 User Guide
Introduction

System Information
Current Draw ~650 mA, (3.0 W)
Temperature (ambient) Operating: 0ºC ~70ºC
Storage: -20ºC~70ºC
Humidity (RH), ambient 5 ~ 95%, non condensing
Dimensions (WxHxD) 92mm x 29mm x 67mm
3.63" x 1.13" x 2.63"
Weight 100g
Approvals & Compliance CE Emission, FCC Class A, RoHS
XRPi2 User Guide 5
Introduction

Setting up the XRPi2
There are 3phases to setting up the XRPi2:
1. Connecting to the XRPi2. There are 2 ways to do this.
2. First-time setup, in which you configure an IP address on the XRPi2 so that you can access it over
a network.
3. Optional setup, in which you can configure additional options such as IxChariot or Hawkeye auto-
registration.
6 XRPi2 User Guide
Setting up the XRPi2

First-time Setup
For a new XRPi2, you need to connect to the XRPi2, and then configure its IPaddresses so that you can
access it over your network. Once you can access it over the network, you can use a web browser to
perform more in-depth setup using the web setup.
Typically,you need to connect directly to the XRPi2 to set the IPaddress. There are three ways to do
this:
lBy connecting a monitor to the VGA port and a keyboard to the USB port.
lBy using a console cable to connect a laptop to the console port.
lBy using an Ethernet cable to connect a laptop one of the LAN ports.
Choose the method you want to use, and follow the corresponding procedure.
First-time Setup over Ethernet
In the first time setup, you connect to the XRPi2, and run a script to configure its name (the probe
name). You will need a terminal-type application such as PuTTY.
To perform the first-time setup over Ethernet:
1. Make sure that the XRPi2 is powered off.
2. Connect one end of an Ethernet cable to a laptop, and the other end to the Ethernet port on the
XRPi2.
As shipped from the factory, the XRPi2 is configured to use DHCP addressing. When it starts, it
attempts to obtain an addrss using DHCP.
3. Power on the XRPi2.
4. Check your DHCPserver to find the address it assigned to the XRPi2. You can identify it by its
hostname, which is:
XRPi2 User Guide 7
Setting up the XRPi2

xrpi2-<last 5 digits of MAC address>
The MAC address is on the label on the bottom of the XRPi2.
At this point, you can do either of two things:
lExit the initial setup, and move on to the web setup.
lRun the setup script to configure the permanent IPaddressing on the XRPi2.
First-time Setup Through HDMI and USB
To perform first-time setup through HDMI and USB:
1. Connect a monitor to the HDMI port, and a keyboard to one of the USB ports.
8 XRPi2 User Guide
Setting up the XRPi2

2. Power on the XRPi2
A console window displays.
3. Now that you have connected to the XRPi2, continue with the Setup script.
Registering with an IxChariot or Hawkeye Server
Ixia includes a script that enables the XRPi2 to automatically register itself with an Hawkeye server. If
you do not want or need to do this now, you can move on to the web setup. If you later want to auto-
register the XRPi2, you can run the script at any time, or you can use the web interface to configure
auto-registration.
1. Connect to the XRPi2.
2. Type the following command to start the script:
xrpi2_configure
3. When the script prompts you, enter the following:
lA name for the probe. You can use letters, numbers, and hyphens (-) in the name. The name
will be used by IxChariot or Hawkeye to set the hostname, and displayed as the probe
name.
lThe hostname or IP address of the Hawkeye server or the IxChariot Console (for IxChariot
9.0 or later).
lA description of the probe's location (used by Hawkeye only).
lA description of the probe's group (used by Hawkeye only)
4. If you want to configure the XRPi2's advanced features, continue with the web setup process.
XRPi2 User Guide 9
Setting up the XRPi2

10 XRPi2 User Guide
This page intentionally left blank.

Upgrading the XRPi2
The XRPi2 may need to be upgraded to:
lUpdate the operating system to maintain its security level (an operating system upgrade).
lUpdate the Ixia software on the probe to keep compatibility with new IxChariot or Hawkeye
releases (a probe upgrade).
NOTE: If the XRPi2is registerd to Hawkeye server upgrades will be performed auto-
matically from Hawkeye 1.0 version. There should be no need to upgrade the XRPi2
manually. For Hawkeye users it is higly advised to use this mode.
There are several ways to upgrade the XRPi2:
lUsing the upgrade scripts
lThrough Hawkeye
Each method is described in this section.
Upgrading with the Supplied Utilities
Ixia supplies two utilities (scripts) that you can use to upgrade the XRPi2.
Operating System Upgrade
Upgrading the operating system is necessary to keep the XRPi2 updated with the latest Linux security
patches. To upgrade the operating system, the probe must have access to the Internet. There is no
way to upgrade the operating system without access to public servers.
To perform an operating system upgrade:
1. Log in to the probe as root.
2. Enter the following commands:
apt-get upgrade
apt-get clean
Probe Upgrade
To upgrade the Ixia software on the probe:
XRPi2 User Guide 11