mininet/util/install.sh at devel/x11 · thurday/mininet

Repository navigation

History

100

101

102

103

104

105

106

107

108

109

110

111

112

113

114

115

116

117

118

119

120

121

122

123

124

125

126

127

128

129

130

131

132

133

134

135

136

137

138

139

140

141

142

143

144

145

146

147

148

149

150

151

152

153

154

155

156

157

158

159

160

161

162

163

164

165

166

167

168

169

170

171

172

173

174

175

176

177

178

179

180

181

182

183

184

185

186

187

188

189

190

191

192

193

194

195

196

197

198

199

200

201

202

203

204

205

206

207

208

209

210

211

212

213

214

215

216

217

218

219

220

221

222

223

224

225

226

227

228

229

230

231

232

233

234

235

236

237

238

239

240

241

242

243

244

245

246

247

248

249

250

251

252

253

254

255

256

257

258

259

260

261

262

263

264

265

266

267

268

269

270

271

272

273

274

275

276

277

278

279

280

281

282

283

284

285

286

287

288

289

290

291

292

293

294

295

296

297

298

299

300

301

302

303

304

305

306

307

308

309

310

311

312

313

314

315

316

317

318

319

320

321

322

323

324

325

326

327

328

329

330

331

332

333

334

335

336

337

338

339

340

341

342

343

344

345

346

347

348

349

350

351

352

353

354

355

356

357

358

359

360

361

362

363

364

365

366

367

368

369

370

371

372

373

374

375

376

377

378

379

380

381

382

383

384

385

386

387

388

389

390

391

392

393

394

395

396

397

398

399

400

401

402

403

404

405

406

407

408

409

410

411

412

413

414

415

416

417

418

419

420

421

422

423

424

425

426

427

428

429

430

431

432

433

434

435

436

437

438

439

440

441

442

443

444

445

446

447

448

449

450

451

452

453

454

455

456

457

458

459

460

461

462

463

464

465

466

467

468

469

470

471

472

473

474

475

476

477

478

479

480

481

482

483

484

485

486

487

488

489

490

491

492

493

494

495

496

497

498

499

500

501

502

503

504

505

506

507

508

509

510

511

512

513

514

515

516

517

518

519

520

521

522

523

524

525

526

527

528

529

530

531

532

533

534

535

536

537

538

539

540

541

542

543

544

545

546

547

548

549

550

551

552

553

554

555

556

557

558

559

560

561

562

#!/usr/bin/env bash

# Mininet install script for Ubuntu (and Debian Lenny)

# Brandon Heller (brandonh@stanford.edu)

# Fail on error

set -e

# Fail on unset var usage

set -o nounset

# Location of CONFIG_NET_NS-enabled kernel(s)

KERNEL_LOC=http://www.openflow.org/downloads/mininet

# Attempt to identify Linux release

DIST=Unknown

RELEASE=Unknown

CODENAME=Unknown

ARCH=`uname -m`

if [ "$ARCH" = "x86_64" ]; then ARCH="amd64"; fi

if [ "$ARCH" = "i686" ]; then ARCH="i386"; fi

test -e /etc/debian_version && DIST="Debian"

grep Ubuntu /etc/lsb-release &> /dev/null && DIST="Ubuntu"

if [ "$DIST" = "Ubuntu" ] || [ "$DIST" = "Debian" ]; then

install='sudo apt-get -y install'

remove='sudo apt-get -y remove'

pkginst='sudo dpkg -i'

# Prereqs for this script

if ! which lsb_release &> /dev/null; then

$install lsb-release

if ! which bc &> /dev/null; then

$install bc

if which lsb_release &> /dev/null; then

DIST=`lsb_release -is`

RELEASE=`lsb_release -rs`

CODENAME=`lsb_release -cs`

echo "Detected Linux distribution: $DIST $RELEASE $CODENAME $ARCH"

# Kernel params

if [ "$DIST" = "Ubuntu" ]; then

if [ "$RELEASE" = "10.04" ]; then

KERNEL_NAME='3.0.0-15-generic'

else

KERNEL_NAME=`uname -r`

KERNEL_HEADERS=linux-headers-${KERNEL_NAME}

elif [ "$DIST" = "Debian" ] && [ "$ARCH" = "i386" ] && [ "$CODENAME" = "lenny" ]; then

KERNEL_NAME=2.6.33.1-mininet

KERNEL_HEADERS=linux-headers-${KERNEL_NAME}_${KERNEL_NAME}-10.00.Custom_i386.deb

KERNEL_IMAGE=linux-image-${KERNEL_NAME}_${KERNEL_NAME}-10.00.Custom_i386.deb

else

echo "Install.sh currently only supports Ubuntu and Debian Lenny i386."

exit 1

# More distribution info

DIST_LC=`echo $DIST | tr [A-Z] [a-z]` # as lower case

# Kernel Deb pkg to be removed:

KERNEL_IMAGE_OLD=linux-image-2.6.26-33-generic

DRIVERS_DIR=/lib/modules/${KERNEL_NAME}/kernel/drivers/net

OVS_RELEASE=1.4.0

OVS_PACKAGE_LOC=https://github.com/downloads/mininet/mininet

OVS_BUILDSUFFIX=-ignore # was -2

OVS_PACKAGE_NAME=ovs-$OVS_RELEASE-core-$DIST_LC-$RELEASE-$ARCH$OVS_BUILDSUFFIX.tar

OVS_SRC=~/openvswitch

OVS_TAG=v$OVS_RELEASE

OVS_BUILD=$OVS_SRC/build-$KERNEL_NAME

OVS_KMODS=($OVS_BUILD/datapath/linux/{openvswitch_mod.ko,brcompat_mod.ko})

function kernel {

echo "Install Mininet-compatible kernel if necessary"

sudo apt-get update

if [ "$DIST" = "Ubuntu" ] && [ "$RELEASE" = "10.04" ]; then

$install linux-image-$KERNEL_NAME

elif [ "$DIST" = "Debian" ]; then

# The easy approach: download pre-built linux-image and linux-headers packages:

wget -c $KERNEL_LOC/$KERNEL_HEADERS

wget -c $KERNEL_LOC/$KERNEL_IMAGE

# Install custom linux headers and image:

$pkginst $KERNEL_IMAGE $KERNEL_HEADERS

# The next two steps are to work around a bug in newer versions of

# kernel-package, which fails to add initrd images with the latest kernels.

# See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=525032

# Generate initrd image if the .deb didn't install it:

if ! test -e /boot/initrd.img-${KERNEL_NAME}; then

sudo update-initramfs -c -k ${KERNEL_NAME}

# Ensure /boot/grub/menu.lst boots with initrd image:

sudo update-grub

# The default should be the new kernel. Otherwise, you may need to modify

# /boot/grub/menu.lst to set the default to the entry corresponding to the

# kernel you just installed.

}

function kernel_clean {

echo "Cleaning kernel..."

# To save disk space, remove previous kernel

if ! $remove $KERNEL_IMAGE_OLD; then

echo $KERNEL_IMAGE_OLD not installed.

# Also remove downloaded packages:

rm -f ~/linux-headers-* ~/linux-image-*

}

# Install Mininet deps

function mn_deps {

echo "Installing Mininet dependencies"

$install gcc make socat psmisc xterm ssh iperf iproute telnet \

python-setuptools python-networkx cgroup-bin ethtool help2man \

pyflakes pylint pep8

if [ "$DIST" = "Ubuntu" ] && [ "$RELEASE" = "10.04" ]; then

echo "Upgrading networkx to avoid deprecation warning"

sudo easy_install --upgrade networkx

# Add sysctl parameters as noted in the INSTALL file to increase kernel

# limits to support larger setups:

sudo su -c "cat $HOME/mininet/util/sysctl_addon >> /etc/sysctl.conf"

# Load new sysctl settings:

sudo sysctl -p

echo "Installing Mininet core"

pushd ~/mininet

sudo make install

popd

}

# The following will cause a full OF install, covering:

# -user switch

# The instructions below are an abbreviated version from

# http://www.openflowswitch.org/wk/index.php/Debian_Install

# ... modified to use Debian Lenny rather than unstable.

function of {

echo "Installing OpenFlow reference implementation..."

cd ~/

$install git-core autoconf automake autotools-dev pkg-config \

make gcc libtool libc6-dev

git clone git://openflowswitch.org/openflow.git

cd ~/openflow

# Patch controller to handle more than 16 switches

patch -p1 < ~/mininet/util/openflow-patches/controller.patch

# Resume the install:

./boot.sh

./configure

make

sudo make install

# Remove avahi-daemon, which may cause unwanted discovery packets to be

# sent during tests, near link status changes:

$remove avahi-daemon

# Disable IPv6. Add to /etc/modprobe.d/blacklist:

if [ "$DIST" = "Ubuntu" ]; then

BLACKLIST=/etc/modprobe.d/blacklist.conf

else

BLACKLIST=/etc/modprobe.d/blacklist

sudo sh -c "echo 'blacklist net-pf-10\nblacklist ipv6' >> $BLACKLIST"

cd ~

}

function wireshark {

echo "Installing Wireshark dissector..."

sudo apt-get install -y wireshark libgtk2.0-dev

if [ "$DIST" = "Ubuntu" ] && [ "$RELEASE" != "10.04" ]; then

# Install newer version

sudo apt-get install -y scons mercurial libglib2.0-dev

sudo apt-get install -y libwiretap-dev libwireshark-dev

cd ~

hg clone https://bitbucket.org/barnstorm/of-dissector

cd of-dissector/src

export WIRESHARK=/usr/include/wireshark

scons

# libwireshark0/ on 11.04; libwireshark1/ on later

WSDIR=`ls -d /usr/lib/wireshark/libwireshark* | head -1`

WSPLUGDIR=$WSDIR/plugins/

sudo cp openflow.so $WSPLUGDIR

echo "Copied openflow plugin to $WSPLUGDIR"

else

# Install older version from reference source

cd ~/openflow/utilities/wireshark_dissectors/openflow

make

sudo make install

# Copy coloring rules: OF is white-on-blue:

mkdir -p ~/.wireshark

cp ~/mininet/util/colorfilters ~/.wireshark

}

# Install Open vSwitch

# Instructions derived from OVS INSTALL, INSTALL.OpenFlow and README files.

function ovs {

echo "Installing Open vSwitch..."

# Required for module build/dkms install

$install $KERNEL_HEADERS

ovspresent=0

# First see if we have packages

# XXX wget -c seems to fail from github/amazon s3

cd /tmp

if wget $OVS_PACKAGE_LOC/$OVS_PACKAGE_NAME 2> /dev/null; then

$install patch dkms fakeroot python-argparse

tar xf $OVS_PACKAGE_NAME

orig=`tar tf $OVS_PACKAGE_NAME`

# Now install packages in reasonable dependency order

order='dkms common pki openvswitch-switch brcompat controller'

pkgs=""

for p in $order; do

pkg=`echo "$orig" | grep $p`

# Annoyingly, things seem to be missing without this flag

$pkginst --force-confmiss $pkg

done

ovspresent=1

# Otherwise try distribution's OVS packages

if [ "$DIST" = "Ubuntu" ] && [ `expr $RELEASE '>=' 11.10` = 1 ]; then

if ! dpkg --get-selections | grep openvswitch-datapath; then

# If you've already installed a datapath, assume you

# know what you're doing and don't need dkms datapath.

# Otherwise, install it.

$install openvswitch-datapath-dkms

if $install openvswitch-switch openvswitch-controller; then

echo "Ignoring error installing openvswitch-controller"

ovspresent=1

# Switch can run on its own, but

# Mininet should control the controller

if [ -e /etc/init.d/openvswitch-controller ]; then

if sudo service openvswitch-controller stop; then

echo "Stopped running controller"

sudo update-rc.d openvswitch-controller disable

if [ $ovspresent = 1 ]; then

echo "Done (hopefully) installing packages"

cd ~

return

# Otherwise attempt to install from source

$install pkg-config gcc make python-dev libssl-dev libtool

if [ "$DIST" = "Debian" ]; then

if [ "$CODENAME" = "lenny" ]; then

$install git-core

# Install Autoconf 2.63+ backport from Debian Backports repo:

# Instructions from http://backports.org/dokuwiki/doku.php?id=instructions

sudo su -c "echo 'deb http://www.backports.org/debian lenny-backports main contrib non-free' >> /etc/apt/sources.list"

sudo apt-get update

sudo apt-get -y --force-yes install debian-backports-keyring

sudo apt-get -y --force-yes -t lenny-backports install autoconf

else

$install git

# Install OVS from release

cd ~/

git clone git://openvswitch.org/openvswitch $OVS_SRC

cd $OVS_SRC

git checkout $OVS_TAG

./boot.sh

BUILDDIR=/lib/modules/${KERNEL_NAME}/build

if [ ! -e $BUILDDIR ]; then

echo "Creating build sdirectory $BUILDDIR"

sudo mkdir -p $BUILDDIR

opts="--with-linux=$BUILDDIR"

mkdir -p $OVS_BUILD

cd $OVS_BUILD

../configure $opts

make

sudo make install

modprobe

}

function remove_ovs {

pkgs=`dpkg --get-selections | grep openvswitch | awk '{ print $1;}'`

echo "Removing existing Open vSwitch packages:"

echo $pkgs

if ! $remove $pkgs; then

echo "Not all packages removed correctly"

# For some reason this doesn't happen

if scripts=`ls /etc/init.d/*openvswitch* 2>/dev/null`; then

echo $scripts

for s in $scripts; do

s=$(basename $s)

echo SCRIPT $s

sudo service $s stop

sudo rm -f /etc/init.d/$s

sudo update-rc.d -f $s remove

done

echo "Done removing OVS"

}

# Install NOX with tutorial files

function nox {

echo "Installing NOX w/tutorial files..."

# Install NOX deps:

$install autoconf automake g++ libtool python python-twisted \

swig libssl-dev make

if [ "$DIST" = "Debian" ]; then

$install libboost1.35-dev

elif [ "$DIST" = "Ubuntu" ]; then

$install python-dev libboost-dev

$install libboost-filesystem-dev

$install libboost-test-dev

# Install NOX optional deps:

$install libsqlite3-dev python-simplejson

# Fetch NOX destiny

cd ~/

git clone https://github.com/noxrepo/nox-classic.git noxcore

cd noxcore

if ! git checkout -b destiny remotes/origin/destiny ; then

echo "Did not check out a new destiny branch - assuming current branch is destiny"

# Apply patches

git checkout -b tutorial-destiny

git am ~/mininet/util/nox-patches/*tutorial-port-nox-destiny*.patch

if [ "$DIST" = "Ubuntu" ] && [ `expr $RELEASE '>=' 12.04` = 1 ]; then

git am ~/mininet/util/nox-patches/*nox-ubuntu12-hacks.patch

# Build

./boot.sh

mkdir build

cd build

../configure

make -j3

#make check

# Add NOX_CORE_DIR env var:

sed -i -e 's|# for examples$|&\nexport NOX_CORE_DIR=~/noxcore/build/src|' ~/.bashrc

# To verify this install:

#cd ~/noxcore/build/src

#./nox_core -v -i ptcp:

}

# "Install" POX

function pox {

echo "Installing POX into $HOME/pox..."

cd ~

git clone https://github.com/noxrepo/pox.git

}

# Install OFtest

function oftest {

echo "Installing oftest..."

# Install deps:

$install tcpdump python-scapy

# Install oftest:

cd ~/

git clone git://github.com/floodlight/oftest

cd oftest

cd tools/munger

sudo make install

}

# Install cbench

function cbench {

echo "Installing cbench..."

$install libsnmp-dev libpcap-dev libconfig-dev

cd ~/

git clone git://openflow.org/oflops.git

cd oflops

sh boot.sh || true # possible error in autoreconf, so run twice

sh boot.sh

./configure --with-openflow-src-dir=$HOME/openflow

make

sudo make install || true # make install fails; force past this

}

function other {

echo "Doing other setup tasks..."

# Enable command auto completion using sudo; modify ~/.bashrc:

sed -i -e 's|# for examples$|&\ncomplete -cf sudo|' ~/.bashrc

# Install tcpdump and tshark, cmd-line packet dump tools. Also install gitk,

# a graphical git history viewer.

$install tcpdump tshark gitk

# Install common text editors

$install vim nano emacs

# Install NTP

$install ntp

# Set git to colorize everything.

git config --global color.diff auto

git config --global color.status auto

git config --global color.branch auto

# Reduce boot screen opt-out delay. Modify timeout in /boot/grub/menu.lst to 1:

if [ "$DIST" = "Debian" ]; then

sudo sed -i -e 's/^timeout.*$/timeout 1/' /boot/grub/menu.lst

# Clean unneeded debs:

rm -f ~/linux-headers-* ~/linux-image-*

}

# Script to copy built OVS kernel module to where modprobe will

# find them automatically. Removes the need to keep an environment variable

# for insmod usage, and works nicely with multiple kernel versions.

# The downside is that after each recompilation of OVS you'll need to

# re-run this script. If you're using only one kernel version, then it may be

# a good idea to use a symbolic link in place of the copy below.

function modprobe {

echo "Setting up modprobe for OVS kmod..."

sudo cp $OVS_KMODS $DRIVERS_DIR

sudo depmod -a ${KERNEL_NAME}

}

function all {

echo "Running all commands..."

kernel

mn_deps

wireshark

ovs

# NOX-classic is deprecated, but you can install it manually if desired.

# nox

pox

oftest

cbench

other

echo "Please reboot, then run ./mininet/util/install.sh -c to remove unneeded packages."

echo "Enjoy Mininet!"

}

# Restore disk space and remove sensitive files before shipping a VM.

function vm_clean {

echo "Cleaning VM..."

sudo apt-get clean

sudo rm -rf /tmp/*

sudo rm -rf openvswitch*.tar.gz

# Remove sensistive files

history -c # note this won't work if you have multiple bash sessions

rm -f ~/.bash_history # need to clear in memory and remove on disk

rm -f ~/.ssh/id_rsa* ~/.ssh/known_hosts

sudo rm -f ~/.ssh/authorized_keys*

# Remove Mininet files

#sudo rm -f /lib/modules/python2.5/site-packages/mininet*

#sudo rm -f /usr/bin/mnexec

# Clear optional dev script for SSH keychain load on boot

rm -f ~/.bash_profile

# Clear git changes

git config --global user.name "None"

git config --global user.email "None"

# Remove mininet install script

rm -f install-mininet.sh

}

function usage {

printf 'Usage: %s [-acdfhkmntvxy]\n\n' $(basename $0) >&2

printf 'This install script attempts to install useful packages\n' >&2

printf 'for Mininet. It should (hopefully) work on Ubuntu 10.04, 11.10\n' >&2

printf 'and Debian 5.0 (Lenny). If you run into trouble, try\n' >&2

printf 'installing one thing at a time, and looking at the \n' >&2

printf 'specific installation function in this script.\n\n' >&2

printf 'options:\n' >&2

printf -- ' -a: (default) install (A)ll packages - good luck!\n' >&2

printf -- ' -b: install controller (B)enchmark (oflops)\n' >&2

printf -- ' -c: (C)lean up after kernel install\n' >&2

printf -- ' -d: (D)elete some sensitive files from a VM image\n' >&2

printf -- ' -f: install open(F)low\n' >&2

printf -- ' -h: print this (H)elp message\n' >&2

printf -- ' -k: install new (K)ernel\n' >&2

printf -- ' -m: install Open vSwitch kernel (M)odule from source dir\n' >&2

printf -- ' -n: install mini(N)et dependencies + core files\n' >&2

printf -- ' -r: remove existing Open vSwitch packages\n' >&2

printf -- ' -t: install o(T)her stuff\n' >&2

printf -- ' -v: install open (V)switch\n' >&2

printf -- ' -w: install OpenFlow (w)ireshark dissector\n' >&2

printf -- ' -x: install NO(X) OpenFlow controller\n' >&2

printf -- ' -y: install (A)ll packages\n' >&2

exit 2

}

if [ $# -eq 0 ]

then

all

else

while getopts 'abcdfhkmnprtvwx' OPTION

case $OPTION in

a) all;;

b) cbench;;

c) kernel_clean;;

d) vm_clean;;

f) of;;

h) usage;;

k) kernel;;

m) modprobe;;

n) mn_deps;;

p) pox;;

r) remove_ovs;;

t) other;;

v) ovs;;

w) wireshark;;

x) nox;;

?) usage;;

esac

done

shift $(($OPTIND - 1))

FilesExpand file tree

install.sh

Latest commit

History

install.sh

File metadata and controls