WebIOU on Linux (x86)

as VMware Virtual Machine (aka WebIOL)

Mike Timm mtimm@cisco.com
Kaoru Yamashita {kaoru, kyamashi}@cisco.com
Feb 14, 2011

V 0.991

Release History
WebIOL-0.6 (Sep 3, 2010)
Web-based License Key setup by Mike Timm
Added adventerprisek9 Pagent Image

WebIOL-0.5 (Aug 15, 2010)

Reduce package size (1.3GB 550MB). Switch to Fedora 13

WebIOL-0.4 by Mike Timm (Aug 12, 2010)

Add Cisco360 labs

WebIOL-0.3 by Mike Timm (Aug 9, 2010)

Add L2IOL image and sample lab template
Modified script to support L2IOL image

WebIOL-0.21 (Jan 18, 2010)

Maintenance Release. Added adventerprisek9 IOL image.

WebIOL-0.2 (Jan 17, 2010)

Maintenance Release. Most of labs will start. Multi-user might work.
WebIOL as VM

2010 Cisco Systems, Inc. All rights reserved.

Cisco Confidential

Introduction
This is a package contains WebIOU with IOL (IOU on Linux) images
running as VMware Virtual Machine (VM).
Once installed, you can run WebIOU on your laptop powered by
Windows XP, 7, MacOS X and so on.
You can also run this VM when your laptop is offline. (or on ESX)

If you can modify the VMware related settings on Host OS you only
have to generate IOU license key and install it.
Its click twice on WebIOL-0.6 and later.

VMware software confirmed :

VMware Server 2.0.2 Build 203138 --- mother of VM
VMware Player 3.1.0 Build 261024
VMware ESX 4.0.0, 208167
VMware Fusion 2.0.6 (196839)

Linux distribution used: Fedora 13 (WebIOL-0.5 and later)

WebIOL as VM

2010 Cisco Systems, Inc. All rights reserved.

Cisco Confidential

Pre-configured Parameters
Username / Password
for daily use:

webiou / webiou

(unlike internal WebIOU servers, this package does local authentication)

administration: root / cisco123

Ethernet Interface
eth0, 192.168.72.11/24
Associated to VMnet8

Run Level : 3 (Full Multiuser mode, no GUI/X11)

WebIOL as VM

2010 Cisco Systems, Inc. All rights reserved.

Cisco Confidential

How to get this Package

This package is compressed by WinZip 12.0.
See IOU Wiki about the location. (last slide)
As the zip file is so huge, some archive software
can not extract files.
You can install and use WinZip 12.0 by Cisco IT
go to http://wwwin-download.cisco.com/alpha/
Select Software Packages Complete List of Software
Packages
Choose Winzip 12.0

WebIOL as VM

2010 Cisco Systems, Inc. All rights reserved.

Cisco Confidential

Preparation
Install VMware Player, Fusion (or Server).
You can go with VMware ESX (vSphere) and Workstation
or other flavors.

Assign 192.168.72.0 to VMnet8

vmnetcfg.exe is not installed by default with recent
VMware Player. See next slide if you are using VMware
Player 3

Or edit some configuration files of Fedora Linux,

after booting the VM.
see later slide

WebIOL as VM

2010 Cisco Systems, Inc. All rights reserved.

Cisco Confidential

Default Network Configuration

(based on VMware Server on Windows XP)

VMnet8

IP Address
= Any

172.16.72.2/24
Default G/W &
DNS Server

WebIOL
VM
(Fedora 13)

eth0
172.16.72.0/24

Physical
NIC

(NAT Router
by VMware)

172.16.72.11/24

VMware Player (Fusion etc.)

VMnet8
172.16.72.1/24

Host OS Kernel
Host OS (Windows, MacOS)

WebIOL as VM

2010 Cisco Systems, Inc. All rights reserved.

Cisco Confidential

vmnetcfg.exe on VMware Player 3

http://www.sohoadvisers.com/tutorials/32-vmware-player/64-vmware-player-vmnetcfg

WebIOL as VM

2010 Cisco Systems, Inc. All rights reserved.

Cisco Confidential

vmnetcfg.exe on VMware Server 2

WebIOL as VM

2010 Cisco Systems, Inc. All rights reserved.

Cisco Confidential

Tips on VMware Server 2 on Windows

Console of VM is not available on Firefox 3.6. ;-(
Downgrade Firefox or use other browser.

Remote Console is sometimes disconnected when your

laptop become offline. To fix this problem, change the
property of this file.
C:\Program Files\VMware\VMware Server\serverui
In URL (U) field, your computer name of Windows is embedded.
Change the computer name to localhost.

If not fixed, they try :

http://communities.vmware.com/thread/190424?tstart=120

Personal comment about VMware Server 2

Its not so bad if we learn Web based interface.
WebIOL as VM

2010 Cisco Systems, Inc. All rights reserved.

Cisco Confidential

10

How to change the IP addresses of

VMnet on VMware Fusion 1.0 and 2.0
http://www.scribd.com
/doc/7828011/VMware-Fusion-Network-Settings-Par
t-1
http://communities.vmware.com/thread/97712

WebIOL as VM

2010 Cisco Systems, Inc. All rights reserved.

Cisco Confidential

11

How to change the IP addresses of VMnet

on VMware Fusion 3.0 (by mtimm)
Edit /Library/Application Support/VMware Fusion/networking
as root such as:
answer VNET_8_DHCP no
answer VNET_8_DHCP_CFG_HASH
E5C7199F59C87B58EE08FB7BD14706369E0C4040
answer VNET_8_HOSTONLY_NETMASK 255.255.255.0
answer VNET_8_HOSTONLY_SUBNET 192.168.72.0
answer VNET_8_NAT yes
answer VNET_8_VIRTUAL_ADAPTER yes
answer VNET_8_VIRTUAL_ADAPTER_ADDR 192.168.72.1

Then perform sudo /Library/Application\ Support/VMware\

Fusion/boot.sh restart
WebIOL as VM

2010 Cisco Systems, Inc. All rights reserved.

Cisco Confidential

12

When you start this VM first time

Please choose I moved it instead of I copied it
Or you will lose eth0 by udev of Linux
http://communities.vmware.com/thread/83063

WebIOL as VM

2010 Cisco Systems, Inc. All rights reserved.

Cisco Confidential

13

How to run WebIOL VM on VMware ESX

(vSphere)
Please use VMware vCenter Converter Standalone
to transfer the VM into ESX.
After your VM loses eth0 thanks to udev :
Type below command as root and reboot.
rm /etc/udev/rules.d/70-persistent-net.rules

Refer next slide to change network settings.

WebIOL as VM

2010 Cisco Systems, Inc. All rights reserved.

Cisco Confidential

14

When your VM boots successfully

You can change IP address of this package by
editing below files. You may also change hostname
and other settings.
/etc/sysconfig/network-scripts/ifcfg-eth0
/etc/hosts
/etc/resolv.conf
/etc/httpd/conf/httpd.conf
ServerName 192.168.72.11:80
Please perform /etc/init.d/network restart or reboot VM.

If you want to use GUI (GNOME / X11), change run

level to 5 in below file, then reboot VM.
/etc/inittab
GUI is no longer available on WebIOL-0.5 and later.
WebIOL as VM

2010 Cisco Systems, Inc. All rights reserved.

Cisco Confidential

15

Open http://192.168.72.11/ then you will see:

Note:
Username and
Password are
same as Linux.
(webiou)

WebIOL as VM

2010 Cisco Systems, Inc. All rights reserved.

Cisco Confidential

16

IMPORTANT! Install License Key

Web-based setup available on WebIOL-0.6
Click Tools tab and Setup IOU License.
Then license key is
installed automatically
if your network settings
are okay.

WebIOL as VM

2010 Cisco Systems, Inc. All rights reserved.

Cisco Confidential

17

IMPORTANT! Install License Key

Get Host ID
[webiou@webiou ~]$ /home/webiou/WebIOL/bin/hostinfo
Hostname: webiou IOU_Host_id: (your Host ID)

Generate License Key at :

http://wwwin-deployment.cisco.com/wiki/bin/view/IOU/LicenseKeys

Put the Key in this file.

/home/webiou/WebIOL/.iourc

WebIOL as VM

2010 Cisco Systems, Inc. All rights reserved.

Cisco Confidential

18

When your WebIOU lab wont start

See following logs under /home/webiou/WebIOL/
./log/error_log.txt
./labs/tmp/webiou/.startlog-*

WebIOL as VM

2010 Cisco Systems, Inc. All rights reserved.

Cisco Confidential

19

How to specify L2IOL image (by mtimm)

Choose L2 image
upon lab Startup
In NETMAP,
add SWITCHES and
l2 or layer2 as
comment.
/* SWITCHES: * R8: *
-c SW1.txt -e3 -s0 * l2 */

WebIOL as VM

2010 Cisco Systems, Inc. All rights reserved.

Cisco Confidential

20

How to shutdown your VM

[webiou@webiou ~]$ halt p
You might have to become root.

WebIOL as VM

2010 Cisco Systems, Inc. All rights reserved.

Cisco Confidential

21

Issues
Some labs wont start.
-m48 option in NETMAPs were root cause. Fixed in
WebIOL-0.2.zip. But not all labs are actually tested.

Multiuser (i.e. add another user than webiou)

Might work on WebIOL-0.2.zip or later.
Need further testing.

WebIOL as VM

2010 Cisco Systems, Inc. All rights reserved.

Cisco Confidential

22

Caveats of L2IOL image (by mtimm)

1. cef doesn't work, workaround, configure 'no ip cef' and
'no ipv6 cef
2. No ISL support, you can configure it but it won't switch
ISL traffic
3. Vlan interfaces are shutdown by default, this differs
from the behavior of most switches
4. No mls support, so mls qos is not going to work, this is
unlikely to change since mls is a hardware concept
5. Many features that work in low end switches do not yet
work in the l2iol image, for example etherchannel does
not work.
WebIOL as VM

2010 Cisco Systems, Inc. All rights reserved.

Cisco Confidential

23

To Do
Find stable server to host this package
Confirm swap space checking is correct for IOL images
I observed one IOL image consumes about 132MB of memory

Try LDAP-based CEC Authentication

http://wwwin.cisco.com/it/afs/cec_htaccess.shtml

Try running natively on PC without VMware - Done

Multiuser support (might be) Done. Need more testing
Porting to coLinux --- stretch

WebIOL as VM

2010 Cisco Systems, Inc. All rights reserved.

Cisco Confidential

24

Special Thanks To:

Robert Raszuk
Hiroshi Yoshimura
Tetsuhiro Sato
IOL builders

WebIOL as VM

2010 Cisco Systems, Inc. All rights reserved.

Cisco Confidential

25

For more information

http://wwwin-deployment.cisco.com/wiki/bin/view/
IOU/WebIOULinuxPort
http://wwwin-people.cisco.com/kaoru/WebIOL/

WebIOL as VM

2010 Cisco Systems, Inc. All rights reserved.

Cisco Confidential

26