Quick Start Guide
Table Of Contents
Using RCPlive LiveCDInstalling RCP100 using .deb package
Installing RCP100 using the generic binary package
Installing RCP100 using the source code package
Starting the software
Accessing the router using the web interface
Accessing the router using the command line interface
Stopping the software
Using the LiveCD
The easiest way to try out RCP100 routing suite is to download the latest RCPlive ISO image and burn it on a CD or USB drive. The image size is about 50MB. Boot a regular 64-bit PC (amd64) from the media. Use rcp/rcp username/password to login into CLI.
Installing RCP100 using .deb package
Download the latest .deb package. You will also need to install bridge-utils, curl and traceroute.
$ apt-get update $ apt-get install bridge-utils curl traceroute $ dpkg -i rcp100_X.Y.Z_1.deb
The package was build on Ubuntu 13.04, and it is integrated with upstart. The software will start automatically upon the next reboot. If you don't want an automatic startup, create a /etc/init/rcp100.override file as follows:
$ sudo echo manual > /etc/init/rcp100.override
Manual startup and shutdown of the software is done with start rcp100 and stop rcp100 commands. You can also use the start/stop commands provided with the software. The commands are described below.
Installing RCP100 using the generic binary package
Download the latest binary package and extract the files in /opt directory.
$ cd /opt $ tar -xjvf rcp100-X.Y.Z.bin.tar.bz2
You will also need to install bridge-utils, curl, lsof and traceroute:
Fedora CentOS 6.x |
yum install bridge-utils curl traceroute lsof |
Ubuntu Debian |
apt-get update apt-get install bridge-utils curl traceroute lsof |
openSUSE | yast2 -i bridge-utils curl tcptraceroute lsof |
The package was created on Debian 7 "wheezy". It will work on most recent Linux distributions - it was tested on Debian 7, Ubuntu 13.10 and openSUSE 13.1.
Installing RCP100 using the source code package
RCP100 software should compile and run on any recent Linux 64bit system. Before you start, you need to install a number of additional packages:
Fedora CentOS 6.x |
yum install gcc-c++ ncurses-devel bridge-utils rsync curl traceroute lsof |
Ubuntu Debian |
apt-get update apt-get install build-essential ncurses-dev bridge-utils rsync curl traceroute lsof |
openSUSE | yast2 -i gcc-c++ make ncurses-devel bridge-utils rsync curl tcptraceroute lsof |
Download the latest RCP100 version and unpack the archive:
$ tar -xjvf rcp100-X.Y.Z.tar.bz2 $ cd rcp100-X.Y.Z
Compile and install the software:
$ ./configure $ make $ sudo make install # exit
The installation takes place in /opt/rcp. No other directory is modified.
Starting the software
Run /opt/rcp/bin/start.sh script to start the router:
$ sudo /opt/rcp/bin/start.sh INIT: Mon Apr 9 11:51:39 EDT 2012: init user account INIT: Mon Apr 9 11:51:39 EDT 2012: mount transport directory INIT: Mon Apr 9 11:51:39 EDT 2012: setting up system defaults INIT: Mon Apr 9 11:51:42 EDT 2012: starting RCP processes INIT: Mon Apr 9 11:51:44 EDT 2012: configuring system CLI: Executing command: hostname rcp CLI: Executing command: administrator rcp password rcp CLI: Executing command: service telnet INIT: Mon Apr 9 11:51:44 EDT 2012: RCP system started $
The script creates a new unprivileged user account in /home/rcp, and the router is started with a minimal configuration. Existing interfaces are detected, and two bridge interfaces - br0 and br1 - are created. You can use these interfaces to hook up different virtual machines running on the same computer.
Accessing the router using the web interface
Point your browser to http://0/index.html and login as user rcp, password rcp:
Next, you will be asked to change the default passwords and proceed to the configuration section:
Accessing the router using the command line interface
Log into Command Line Interface (CLI) subsystem via telnet as user rcp, password rcp:
$ telnet 0 Trying 0.0.0.0... Connected to 0. Escape character is '^]'. User: rcp Password: rcp>
CLI is very similar to what you find in commercial routers. It supports command completion (TAB key), syntax checking, command abbreviation, context sensitive help ('?' key) and session history (show history command).
rcp>? enable Administration mode exit Exit the current mode logout Exit the session no Negate a command or set its defaults ping Send echo messages show Show running system information telnet-client Open a telnet session traceroute Trace route to destination rcp>
Go into configuration mode and changed the default password:
rcp>en rcp#config rcp(config)#administrator rcp password mysecretpasswd rcp(config)#exit rcp#
Use show running-config command to inspect the current running configuration:
rcp#show running-config hostname rcp ! service telnet service http ! administrator rcp encrypted password QFSNKPHJ$kNBAqXTxlxZhwKWIpt1e61 ! ! interface loopback lo ip address 127.0.0.1/8 ip mtu 16436 no shutdown ! interface ethernet eth0 ip address 192.168.254.19/24 ip mtu 1500 no shutdown ! interface bridge br0 ip mtu 1500 shutdown ! interface bridge br1 ip mtu 1500 shutdown ! rcp#
The configuration is saved using copy running-config startup-config command:
rcp#copy running-config startup-config rcp#
or abbreviated:
rcp#copy run start rcp#
Stopping the software
Stop the software by running /opt/rcp/bin/stop.sh script as root. The next restart will apply the saved configuration.
$ sudo /opt/rcp/bin/stop.sh INIT: Thu Feb 14 08:32:04 EST 2013: shuting down RCP system INIT: Thu Feb 14 08:32:04 EST 2013: RCP system stopped $