GNS3 WorkBench Files

GNS3 WorkBench 8.7 Linux Appliance Installation Instructions

Download Instructions
=====================

1. Create a directory on your computer where you keep your VMware virtual machines (VMware is a prerequisite - see below). A good name would be GNS3WB87 (or on OS_X GNS3WB7.vmwarevm)

2. Download the 23 files:
	Qiana32.zip
	Virtual Disk-s001.vmdk.zip - Virtual Disk-s022.vmdk.zip
and extract them to the directory you just created.

****************************************************************************
* Note: These files are ~2GB each - if this is too big for you, select the *
* Smaller Files folder above.                                              *
****************************************************************************

You may wish to check the MD5 hash of your downloaded files to see that the hashes match the numbers below:
MD5 (Qiana32.zip) = 0fbb880fd660eba717afbb996be026ca
MD5 (Virtual Disk-s001.vmdk.zip) = dbbdb4738b6ee1c913afaa5d64125e4e
MD5 (Virtual Disk-s002.vmdk.zip) = 22383f3d4e9579bae204ba7fe8e6e26d
MD5 (Virtual Disk-s003.vmdk.zip) = cb6f02284381edead069036c74a018dd
MD5 (Virtual Disk-s004.vmdk.zip) = 07fb182a6801a596b0c22b70ab8b33f2
MD5 (Virtual Disk-s005.vmdk.zip) = a7fc58d3345053b8dc899e1f49471392
MD5 (Virtual Disk-s006.vmdk.zip) = fa504d9b3e94dc89e2bee3f8f14bc9e8
MD5 (Virtual Disk-s007.vmdk.zip) = 94986c14b3d278b6fdb6d4ae25e71fc6
MD5 (Virtual Disk-s008.vmdk.zip) = 7026a794e2c1cad7872dfaf9a1d1821c
MD5 (Virtual Disk-s009.vmdk.zip) = f6218ebc89ae3cf63714fb60758e45d9
MD5 (Virtual Disk-s010.vmdk.zip) = 4c2c7bf5364fc601c4a9c3e8b87bfd2f
MD5 (Virtual Disk-s011.vmdk.zip) = b90fbfd32472f72147e9c4ae55098fc2
MD5 (Virtual Disk-s012.vmdk.zip) = c439d41b08b9c9d1611d9e2fe9d605ab
MD5 (Virtual Disk-s013.vmdk.zip) = 3d618026c90bdfcaa1d2661b1d168995
MD5 (Virtual Disk-s014.vmdk.zip) = dd51aa43b9fcdad601f0733259fc59ba
MD5 (Virtual Disk-s015.vmdk.zip) = 276b0c90b552c3dc4b412f6d39940b51
MD5 (Virtual Disk-s016.vmdk.zip) = 1e4ed79e8e0dbb093460c96dd472f4a7
MD5 (Virtual Disk-s017.vmdk.zip) = 1aeea147973fedb320b5a6c3c5467b0d
MD5 (Virtual Disk-s018.vmdk.zip) = 1565646744f4bac3a01d61aa79ca1837
MD5 (Virtual Disk-s019.vmdk.zip) = 9e71f7d78d5f1846d3826a0bfa2ab6e8
MD5 (Virtual Disk-s020.vmdk.zip) = b24ebbc9c30c1070914a60153b7273d7
MD5 (Virtual Disk-s021.vmdk.zip) = 2c10459a56e99b793e018340d7261ea9
MD5 (Virtual Disk-s022.vmdk.zip) = 122e3293acabbe7bfa82185af9edd904



Inside the folder, find the Qiana32.vmx file. Double-clicking this file should open the GNS3 WorkBench appliance.


Prerequisites:
==============

Before you can even begin to get GNS3 WorkBench (Linux Appliance) installed you will need two elements:

1. A copy of a VMware hypervisor in which you run this VM image.
2. Images for a Cisco IOS routers, ASA and Juniper routers.

If you don't have a copy of a Cisco IOS, you will still be able to use GNS3 WorkBench, but you will be restricted to the ONE routing lab that you could run using a Vyetta image - which you can then use as a model to create more labs of your own.

But ideally, before you start you will have copies of:

c3725-adventerprisek9-mz.124-15.T10.bin [to run Cisco routers - this is the only image you need for MOST labs and exercises]
c3640-ik9o3s-mz.124-25a.bin [to run GNS3 Vault exercises]
c7200-adventerprisek9-mz.150-1.M.bin [to run some GNS3 Vault exercises]
asa842-k8.bin [to run Cisco Adaptive Security Appliances]
jinstall-9.6R1.13-domestic-signed.tgz [to run Juniper Junos]

You will also need to have a VMware Hypervisor.  I have VMware Fusion v6.0, but the steps will be similar for other versions.

Task 1 - Install VMware Player/Fusion/Workstation...
----------------------------------------------------

Use the VMware supplied instructions to get started

Task 2 - Download this Appliance
---------------------------------

As explained above

Save the files in the place where you normally store VMs.  Typically:
		Windows Users\<username>\Documents\Virtual Machines\
		Macintosh OS X ~/Documents/Virtual Machines/
...and decompress them so that all files exist in one folder


Task 3: First run...
--------------------

From that folder, open the .vmx file (double click - or open from VMWare)

When asked "Did you move this virtual machine...", answer "I copied it"

When the VM opens - maximise the VM to the full screen (you may have to 
	maximise/shrink/maximise to get it to work)

Your VM will open a page headed "CONGRATULATIONS: You have GNS3 WorkBench running but.."
This page will take you through the steps to get GNS3 working.  A summary of these steps are shown in the following task.

Task 4 -  Prepare Linux image with OS files
-------------------------------------------

Make sure you have the firmware images that will make GNS3 WorkBench run - in other words you need the following files copied to your VM:

* At least one IOS image.  Ideally, this will be c3725-adventerprisek9-mz.124-15.T10.image in the /home/user/GNS3/Images directory.  
* If you intend to run the GNS3 Vault exercises, make sure you also have copies of c3640-ik9o3s-mz.124-25a.image and c7200-adventerprisek9-mz.150-1.M.image in the /home/user/GNS3/Images directory.
* If you intend to run ASA labs, make sure you also have a copy of asa842-k8.bin in the /home/user/GNS3/Images/ASA directory.  
* If you intend to run Juniper Junos, make sure you have a Junos image.  This install has been tested with jinstall-9.6R1.13-domestic-signed.tgz.  Make sure you have this file or another Juniper Junos image in the same format.
	o This image needs to be placed in the /home/user/GNS3/Images/Junos directory. 


Walkthrough of Task 4
.....................

To download the Cisco IOS images, do a Google search for the image name - such as c3725-adventerprisek9-mz.124-15.T10.bin.  You should see a link to the Cisco website where you can download the image (provided you have a valid maintenance contract for a Cisco c3725).

Once downloaded, move the image to /home/user/GNS3/Images.  Next decompress the image, giving it a .image extension.  The commands to do this are:

cd /home/user/GNS3/Images
unzip -p c3725-adventerprisek9-mz.124-15.T10.bin > c3725-adventerprisek9-mz.124-15.T10.image

Similarly, download and decompress c3640-ik9o3s-mz.124-25a.bin and c7200-adventerprisek9-mz.150-1.M.bin to c3640-ik9o3s-mz.124-25a.image and c7200-adventerprisek9-mz.150-1.M.image.

The ASA image MUST NOT be decompressed.  Find asa842-k8.bin and move it to the /home/user/GNS3/Images/ASA directory, then run the "repack" script found there from a command line.

A Google search for jinstall-9.6R1.13-domestic-signed.tgz may not give you a link to the Juniper website where you can download the image.  Instead, you may have to visit http://www.juniper.net/support/downloads/junos.html - but you may find that you'll have to get a later version than 9.6R1.13 - which may or may not work.

Once you have downloaded jinstall-9.6R1.13-domestic-signed.tgz, move it to the /home/user/GNS3/Images/Junos directory.  In that directory you will find a base Qemu VM (freebsd-4.11) and a "junos-auto-fix-checkpic.sh" script that will need to run from a command line to prepare your image ready for use.

Task 5 -  Enjoy your GNS3 WorkBench Labs
----------------------------------------

You can launch your labs in one of three ways:

1. Double-click on one of the desktop "shortcuts" folders to launch one of the GNS3 Exercises.  This will always load Snapshot 0... for the particular exercise.

2. In the file browser, browse to a ~/GNS3/WorkBench/Projects/<Exercise_Type_Name>/<Exercise_Name> folder.  In this folder you will see some (at least one) script files called runSnapshot.x (Description).  Launching this script will launch GNS3 and load Snapshot.x (where x is a digit) ready for you to complete.

3. 
3a.  Open GNS3. 
3b.  Choose File | Open Project: browse to a ~/GNS3/WorkBench/Projects/<Exercise_Type_Name>/<Exercise_Name> folder.  In this folder you will see a topology called openMeFirst.net.  Opening this topology orients GNS3 to the correct folder.
3b. (Alternative) Choose File | Open Project: browse to a ~/GNS3/WorkBench/Projects/<Exercise_Type_Name>/<Exercise_Name> folder.  In this folder you will see a topology called toppology.net.  Opening this topology orients GNS3 to the correct folder, and loads the topology in the state it was when you last saved it.  This is useful if you have started an exercise, saved it and wish to return to it to continue.  If the exercise has never been saved, opening topology.net is the same as opening openMeFirst.net

3c.  Choose File | Manage snapshots.  Select the snapshot you wish to run and restore it.

Enjoy
RedNectar