LiveDVDInstall

Table of Contents Live DVD installation and setup Downloading the LiveDVD Installing from the LiveDVD Fix ordering of network interfaces Install CAD tools -- Xilinx ISE and Modelsim Xilinx ISE Install Tutorial setup after installing from LiveDVD

Live DVD installation and setup

The LiveDVD provides an easier method for setting up a new system. It installs Fedora 13, the NetFPGA packages, and the necessary package dependencies. The LiveDVD does not install the CAD tools (eg. Xiliinx ISE, Modelsim) -- these must be done separately after installation of the LiveDVD.

Downloading the LiveDVD

The LiveDVD can be downloaded here: Fedora Core 13 with NetFPGA (A valid wiki account is required to download the DVD. Please register if you don't already have an account.)

Installing from the LiveDVD

1. Boot from LiveDVD
2. Wait for automatic login or click 'login'
3. Click Desktop Icon "Install to Hard Drive"
4. Click 'Next'
5. Select Language
6. Choose the storage devices ("Basic Storage Devices" is usually okay)
   1. Basic Storage Devices instructions:
   2. select the hard drive to use
   3. Enter a host name
   4. Select Time timezone/nearest city
   5. Enter root passwd
   6. Select installation type -- use all space for new installation
   7. Write changes to disk
7. Click 'Close'
8. Reboot

After reboot welcome screen:

1. Click 'Forward'
2. Click 'Forward'
3. Create user -- recommend creating an account 'tutorial'
4. Date and time -- recommend sync date and time over network
5. Click 'Forward' for NetFPGA Grub update
6. Click 'Finish'
7. Click 'OK' to reboot

Fix ordering of network interfaces

The network interfaces are often ordered incorrectly after installation from the LiveDVD. For systems with a network interface on-board the motherboard and a dual-port PCI Express NIC, we recommend that the ports be ordered as follows:

• eth0: on-board interface
• eth1: PCI Express NIC
• eth2: PCI Express NIC

Verify (and correct) the ordering of network interfaces as follows:

1. Log in as 'tutorial' -- assuming you have an account named tutorial for the tutorial users
2. Open terminal window
3. Become root: su -
4. Edit /etc/udev/rules.d/70-persistent-net.rules The file will look something like the example below -- of importance are the MAC address and name listed for each interface.

# This file was automatically generated by the /lib/udev/write_net_rules # program, run by the persistent-net-generator.rules rules file. # # You can modify it, as long as you keep each rule on a single # line, and change only the value of the NAME= key. # PCI device 0x10de:0x0269 (forcedeth) SUBSYSTEM=="net", ACTION=="add", DRIVERS=="?*", ATTR{address}=="00:1a:92:b8:dc:b9", ATTR{dev_id}=="0x0", ATTR{type}=="1", KERNEL=="eth*", NAME="eth0" # PCI device 0x8086:0x105e (e1000e) SUBSYSTEM=="net", ACTION=="add", DRIVERS=="?*", ATTR{address}=="00:15:17:20:bb:2a", ATTR{dev_id}=="0x0", ATTR{type}=="1", KERNEL=="eth*", NAME="eth1" # PCI device 0x8086:0x105e (e1000e) SUBSYSTEM=="net", ACTION=="add", DRIVERS=="?*", ATTR{address}=="00:15:17:20:bb:2b", ATTR{dev_id}=="0x0", ATTR{type}=="1", KERNEL=="eth*", NAME="eth2"

Steps to follow only if the names assigned to any of the interfaces is incorrect:

1. Change the NAME section on each line to place the interfaces in the correct order.
2. Save and exit the editor.
3. Migrate to the network-scripts directory: cd /etc/sysconfig/network-scripts
4. Edit each of the files corresponding to the interfaces in the 70-persistent-net.rules file above (in this case: ifcfg-eth0, ifcfg-eth1, ifcfg-eth2)
5. Each file should contain a line that specifies the hardware address. eg.: HWADDR=00:1A:92:B8:DC:B9 Set the hardware address in each file to the MAC address of the of the network interface to be used.
6. Reboot the system

Install CAD tools -- Xilinx ISE and Modelsim

Xilinx ISE Install

1. Download the ISE 10.1 install (http://www.xilinx.com/csi/dlc-tab-10_1.htm)
2. Unzip or untar the files
3. Obtain License from Xilinx (http://www.xilinx.com/getlicense)
4. Run setup
5. Make sure to install updates (SP3 and IP3) when asked
6. Install PCI32 core license for simulations (http://www.xilinx.com/products/ipcenter/DO-DI-PCI32-SP.htm)
7. (Assuming the install path is /cad/xilinx/ise10.1/) Add the following to /etc/profile

# Xilinx version to use XILINX_ISE=10.1 # Source the Xilinx settings32.sh if [ -f /cad/xilinx/ise$XILINX_ISE/ISE/settings32.sh ] ; then unset LMC_HOME . /cad/xilinx/ise$XILINX_ISE/ISE/settings32.sh fi

Tutorial setup after installing from LiveDVD

1. Login as 'tutorial' -- assuming you have an account named tutorial for the tutorial users
2. Open terminal window
3. Become root: su -
4. Disable sshd for root. (SSH logins for root may be a security risk. Enable it only at your own risk):
   1. Edit /etc/ssh/sshd_config
   2. Add the line: PermitRootLogin no
5. Run visudo and perform the following edits:
   1. Add Defaults env_delete -= ="PERL5LIB PYTHONPATH"=
   2. Add Defaults env_keep += ="NF_ROOT NF_DESIGN_DIR"=
   3. Change Defaults requiretty to Defaults <literal>!</literal> requiretty
   4. Add tutorial user privileges (assuming the user name is 'tutorial'): tutorial ALL=NOPASSWD: /home/tutorial/netfpga/projects/tutorial_router/sw/tut_router_gui.pl, /home/tutorial/netfpga/projects/tutorial_router/sw/tut_adv_router_gui.pl, /usr/bin/iperf, /home/tutorial/netfpga/lib/scripts/tutorial_setup/tutorial_setup.pl
6. Install sample videos into /var/www/html/video
7. Exit out of root back to local user
8. Run: /usr/local/netfpga/lib/scripts/user_account_setup/user_account_setup.pl
9. Run: sudo /usr/local/netfpga/lib/scripts/tutorial_setup/tutorial_setup.pl
10. cd into ~/netfpga and Run: make
11. Reboot