Install and Configure GNS3 With TunTap on the Mac

Install and configure GNS3 with TunTap on the Mac - GNS3 - IT Certification Forum

27/04/14 12:26 am

Ad by Vidx

IT Certification Forum

!

CISCO TECHNICAL SECTION

!

GNS3

Install Inst all and configure configure GNS3 with TunTap on the Mac Started By ccie4lab , Mar 17 2014 06:35 AM

Posted 17 March 2014 - 06:35 AM

ccie4lab

A virtual network has many great great uses. It can be indispensable indispensable when testing device configurations configurations before applying to your your production pro duction network, and an d it also can be beneficial ben eficial for training purposes when studying for the Cisco and Juniper certification exams. GNS3 is a graphical network simulator. It's an impressive tool that ties together the Dynamips (http://en.wikipedia.org/wiki/Dynamips) , VirtualBox (https://www.virtualbox.org) , VMware (http://www.vmware.com) , and QEMU (http://wiki.qemu.org) hypervisors abstracted to the user as a modular and flexible graphical user interface for network design and testing.

(https://dl.dropboxusercontent.com/u/1030586/blog/img/gns3apple.png) Download the Software You can grab the components components needed for this tutorial from their respective websites: GNS3 (http://www.gns3.net/) TunTap (http://tuntaposx.sourceforge.net/) Cisco IOS image (http://www.cisco.com/) Install the Software # TunTap The TunTap package will provide us with a collection of virtual network interfaces for t he Mac operating system. The TAP drivers allow us to bridge our GNS3 virtual network with the physical Mac host. Unpack and install t he downloaded TunTap package. Verify the TunTap package installed successfully. Run this command from Terminal.app Terminal.app:: $ ls -l /dev/tap* You should see the device device files listed (tap0 - tap15). crw-rw---- 1 root wheel 33, 0 Oct 5 07:27 tap0 crw-rw---- 1 root wheel 33, 1 Oct 5 07:27 07:27 tap1 crw-rw---- 1 root wheel 33, 10 Oct 5 07:27 tap10 crw-rw---- 1 root wheel 33, 11 Oct 5 07:27 tap11 crw-rw---- 1 root wheel 33, 12 Oct 5 07:27 tap12 crw-rw---- 1 root wheel 33, 13 Oct 5 07:27 tap13 crw-rw---- 1 root wheel 33, 14 Oct 5 07:27 tap14 crw-rw---- 1 root wheel 33, 15 Oct 5 07:27 tap15 crw-rw---- 1 root wheel 33, 2 Oct 5 07:27 tap2 crw-rw---- 1 root wheel 33, 3 Oct 5 07:27 07:27 tap3 crw-rw---- 1 root wheel 33, 4 Oct 5 07:27 07:27 tap4 crw-rw---- 1 root wheel 33, 5 Oct 5 07:27 07:27 tap5

http://certcollection.org/forum/topic/219974-install-andhttp://certcollection.org/forum/to pic/219974-install-and-configure-gns3-with-tuntap-o configure-gns3-with-tuntap-on-the-mac/ n-the-mac/

Page 1 of 9


27/04/14 12:26 am

crw-rw---- 1 root wheel 33, 6 Oct 5 07:27 tap6 crw-rw---- 1 root wheel 33, 7 Oct 5 07:27 tap7 crw-rw---- 1 root wheel 33, 8 Oct 5 07:27 tap8 crw-rw---- 1 root wheel 33, 9 Oct 5 07:27 tap9

A reboot of the computer may be required if the virtual devices are not listed in the output. # GNS3 Open the GNS3 DMG image file, and move the GNS3.app to the Applications folder. We also need to change the ownership and permissions for the Dynamips binary file(s). The Dynamips process will need to run with elevated privileges (root) to attach the TAP devices. Change the ownership of the Dynamips binary file(s) to the root user. Run this command from Terminal.app: $ sudo chown root /Applications/GNS3.app/Contents/Resources/dynamips*.bin Modify the setuid (http://en.wikipedia.org/wiki/Setuid) attribute for the Dynamips binary file(s). Run this command from Terminal.app: $ sudo chmod 4755 /Applications/GNS3.app/Contents/Resources/dynamips*.bin Verify the new configuration. Run this command from Terminal.app: $ ls -oh /Applications/GNS3.app/Contents/Resources/dynamips*.bin -rwsr-xr-x@ 1 root 1.0M Sep 9 21:01 /Applications/GNS3.app/Contents/Resources/dynamips-0.2.10-OSX.intel64.bin -rwsr-xr-x@ 1 root 958K Sep 9 21:01 /Applications/GNS3.app/Contents/Resources/dynamips-0.2.8-RC3-communityOSX.intel64.bin

Note: Recent versions of GNS3 include multiple versions of the Dynamips binary file. GNS3 Base Configuration # Create the GNS3 Folders Create the main GNS3 folder as well as the GNS3/Projects, GNS3/Images, and GNS3/Tmp subfolders in your Documents folder. Feel free to use the Finder, but I will use the command line method in my example. Create the main GNS3 folder and subfolders. Run this command from Terminal.app: $ mkdir -p $HOME/Documents/GNS3/{Projects,Images,Tmp}

(https://dl.dropboxusercontent.com/u/1030586/blog/img/gns3-folders.png) # Cisco IOS Image File Let's now unpack the image file and move it to the Images folder. I will be using the c3725-adventerprisek9-mz.12415.T10.bin image file in my example. I will first navigate to the directory where I have it saved (/Users/marc/Downloads/Labs), so I would run this command from Terminal.app: $ cd $HOME/Downloads/Labs

http://certcollection.org/forum/topic/219974-install-and-configure-gns3-with-tuntap-on-the-mac/

Page 2 of 9


27/04/14 12:26 am

Now uncompress the IOS image. Run t his command from Terminal.app: $ unzip c3725-adventerprisek9-mz.124-15.T10.bin Archive: c3725-adventerprisek9-mz.124-15.T10.bin warning [c3725-adventerprisek9-mz.124-15.T10.bin]: 28328 extra bytes at beginning or within zipfile (attempting to process anyway) inflating: C3725-AD.BIN You can safely ignore the warning message. It should have uncompressed successfully. From the output, you will notice the unpacked IOS image filename is C3725-AD.BIN. Rename it back to original filename substituting the extension with .image (e.g. c3725-adventerprisek9-mz.124-15.T10.bin -> c3725-adventerprisek9-mz.12415.T10.image). Run this command from Terminal.app: $ mv C3725-AD.BIN c3725-adventerprisek9-mz.124-15.T10.image Then move the c3725-adventerprisek9-mz.124-15.T10.image file to the GNS3 Images folder. Run this command from Terminal.app: $ mv c3725-adventerprisek9-mz.124-15.T10.image $HOME/Documents/GNS3/Images We will now map the GNS3 settings with the new folders we just created. # GNS3 Preferences (General) Open the GNS3 Preferences. [Command-, (Command key plus the comma key)] Select the General node on the left. Select the General Settings tab. Set the directory path for both Projects and OS images. Click the Apply button to save the settings.

(https://dl.dropboxusercontent.com/u/1030586/blog/img/gns3-prefs-general.png) # GNS3 Preferences (Dynamips) Select the Dynamips node on the left. Select the Dynamips tab. Set the directory path for both Executable path to Dynamips and Working directory for Dynamips. What value should we enter in the Executable path to Dynamips field? As stated previously, GNS3 now includes multiple versions of the Dynamips binary file. R un the following command from Terminal.app to see our options: $ ls /A pplications/GNS3.app/Contents/Resources/dynamips*.bin /Applications/GNS3.app/Contents/Resources/dynamips-0.2.10-OSX.intel64.bin /Applications/GNS3.app/Contents/Resources/dynamips-0.2.8-RC3-community-OSX.intel64.bin

I decide to use the latest version, so I would enter the value /Applications/GNS3.app/Contents/Resources/dynamips-0.2.10-OSX.intel64.bin in the Executable path to Dynamips field. Click the Apply button to save the settings. Then click the Test Settings button to verify the configuration is valid. Click the OK button to close the window.


Page 3 of 9


27/04/14 12:26 am

(https://dl.dropboxusercontent.com/u/1030586/blog/img/gns3-prefs-dynamips.png) # IOS images and hypervisors Open the IOS images and hypervisors settings window. [ Shift-Command-I] Select the IOS Images tab. Set the directory path for the Image file. Verify the Platform and Model fields coincide with the Cisco IOS image file. Verify/Set the Default RAM value for the image. Click the Auto calculation button to start the operation to retrieve the IDLE PC value for the image.

(https://dl.dropboxusercontent.com/u/1030586/blog/img/gns3-idlepc-auto.png) Click the Close button in the foreground window after the message Working Idle PC value found. is displayed. Click the Save button. Then click the Close button to close the window.


Page 4 of 9


27/04/14 12:26 am

(https://dl.dropboxusercontent.com/u/1030586/blog/img/gns3-ioshyp.png) Basic Lab Setup Our sample lab will consist of a Router, an Ethernet Switch, and a Cloud node type. Drag the objects from the Node Types dock onto the blank Workspace. It should look similar to this once we get everything configured:

(https://dl.dropboxusercontent.com/u/1030586/blog/img/topologysm.png) We need to configure the Cloud object before we wire it to the switch. The object will be using a TAP virtual network interface. 1. Right-click the Cloud object. 2. Select Configure. 3. Select the subnode (ex. C1). 4. Select NIO TAP. 5. Enter /dev/tap0 into the top field. 6. Click the Add button to add the interface. 7. Click the Apply button to save the setting. 8. Then click the OK button to close the window.


Page 5 of 9


27/04/14 12:26 am

(https://dl.dropboxusercontent.com/u/1030586/blog/img/gns3-cloudconf.png) Connect the objects with the Add a link tool. R1 with f0/0 C1 (Mac) with nio_tap:/dev/tap0 # Start R1 Start the router. [Right-click (or Control-click) -> Start] on the router object, and find the console port for the virtual router by entering the list command in the GNS3 management console.

(https://dl.dropboxusercontent.com/u/1030586/blog/img/gns3-console.png) Emulate a console port connection to the router by establishing a telnet session. Run this command from Terminal.app: $ telnet 127.0.0.1 2103 Let the router load until it presents the prompt. Take note you may need to press the return key multiple times to capture the prompt in the terminal window. # Save the Project I prefer to save the GNS3 project at this point before I continue with the rest of the configuration. File -> Save project as...


Page 6 of 9


27/04/14 12:26 am

(http://dl.dropbox.com/u/1030586/blog/img/saveproject.png) # Configure IOS for the Router Set the IP configuration for the network interface that is connected to the switch. R1# conf t R1(config)# int fa0/0 R1(config-if)# ip address 10.11.1.1 255.255.255.0 R1(config-if)# no shut R1(config-if)# end Let's verify the configuration of the interfaces by executing the following commands: R1# sh run int fa0/0 Building configuration... Current configuration : 94 bytes ! interface FastEthernet0/0 ip address 10.11.1.1 255.255.255.0 duplex auto speed auto end

R1# sh ip int br Interface IP-Address OK? Method Status Protocol FastEthernet0/0 10.11.1.1 YES manual up up FastEthernet0/1 unassigned YES unset administratively down down

Copy the current running configuration to the startup configuration in the virtual NVRAM, so we don't have to repeat the previous steps the next time we start this lab in GNS3. R1# copy run start Destination filename [startup-config]? Building configuration... [OK]

# TAP Interface By linking the Cloud with the switch, it should have brought up the TAP network interface on the physical Mac host. Let's check. Run the following command from a separate Terminal.app window (tab): $ ifconfig tap0 tap0: flags=8842 mtu 1500 ether ce:d1:be:72:33:67 open (pid 34415)

Set the IP configuration for the tap0 interface. The IP address will need to be in the same subnet as the one we configured for the network interface on the router. You will be requested for your user account password because modifying the logical network configuration for a network interface requires superuser privilege. Run this command from


Page 7 of 9


27/04/14 12:26 am

Terminal.app: $ sudo ifconfig tap0 inet 10.11.1.254/24 up

Verify the IP configuration on the interface. Run this command from Terminal.app: $ ifconfig tap0 tap0: flags=8843 mtu 1500 ether ce:d1:be:72:33:67 inet 10.11.1.254 netmask 0xffffff00 broadcast 10.11.1.255 open (pid 34415)

Test the Connectivity Ping from our Mac (tap0) to the virtual router. Run this command from Terminal.app: $ ping -c 3 10.11.1.1 PING 10.11.1.1 (10.11.1.1): 56 data bytes 64 bytes from 10.11.1.1: icmp_seq=0 ttl=255 time=3.223 ms 64 bytes from 10.11.1.1: icmp_seq=1 ttl=255 time=1.316 ms 64 bytes from 10.11.1.1: icmp_seq=2 ttl=255 time=1.328 ms Ping from the virtual router to our Mac (tap0). Run the following command from the R1 Terminal.app window (tab): R1# ping 10.11.1.254 Type escape sequence to abort. Sending 5, 100-byte ICMP Echos to 10.11.1.254, timeout is 2 seconds: !!!!! Success rate is 100 percent (5/5), round-trip min/avg/max = 8/10/16 ms

Automate (optional) I don't want to manually configure the TAP interface(s) every time I load a GNS3 project, so I created a simple script to take care of this.

001 002 003 004 005 006 007 008 009 010 011 012 013 014 015 016 #!/usr/bin/env bash # Topology file located in GNS3/Projects directory TOPFILE=$HOME/Documents/GNS3/Projects/test/topology.net # tap0 interface IP configuration TAP0IP=10.11.1.254/24 # Open GNS3 with topology file /Applications/GNS3.app/Contents/MacOS/GNS3 "$TOPFILE" & # Number of seconds to wait before assigning IP conf iguration to tap0 sleep 5 # Set the IP configuration for the the tap0 inte rface sudo ifconfig tap0 inet $T AP0IP up

Copy and paste the text into your preferred text editor (exclude the line numbers), then save the file as launch-gns3 with-test-project.sh. Give the file the execute permission. Run this command from Terminal.app: $ chmod u+x launch-gns3-with-test-project.sh Run the script. You will be requested for your user account password because modifying the logical network configuration for a network interface requires superuser privilege via the sudo command. Run this command from Terminal.app: $ ./launch-gns3-with-test-project.sh GNS3 and VMware Fusion GNS3 has built-in support for VirtualBox and QEMU, but GNS3 also works excellent with VMware Fusion. Check out the following posts for more information: Edited by ccie4lab, 17 March 2014 - 06:36 AM.

Back to GNS3

IT Certification Forum

!

CISCO TECHNICAL SECTION

!

GNS3

Organization

Community

Downloads

Test Providers

Site Info

About Us

Forums

Apple

Pearson VUE

© 2008 - 2011 CertCollection IT Certification Forum

Advertising

Blogs

Cisco

Prometric

Contact Us

Downloads

Citrix

Exin-Exams


Community Forum Software by IP.Board

Page 8 of 9


Follow us on Twitter

Privacy Statement

CompTIA

27/04/14 12:26 am

Go to top

Microsoft


Page 9 of 9

Install and Configure GNS3 With TunTap on the Mac

Recommend Documents