The procedure described here will guide you through the installation of the Fedora 8
Operating System on your LANforge appliance.
Before beginning this procedure, verify that the Keyboard-Video-Mouse (KVM) are all
connected and the appliance's management port is connected to your network. If you
are using a KVM switch, ensure it is set to display LANforge once it is powered up.
LANforge is very flexible, so if you have hardware constraints that do not appear
to be supported by LANforge, please contact
support@candelatech.com. It is likely we have a solution!
-
System Requirements
The Candela Technologies CT962 is a mid-range 1U rackmount appliance with the following hardware
specifications:
- 2.8Ghz Pentium-4 processor
- 40GB Hard Drive
- 1GB RAM
- Slim CDROM drive
- Up to 6 64-bit PCI-X Intel Pro/1000 10/100/1000 Ethernet ports
- Additional 10/100/1000 ethernet interface for management
If you choose to load LANforge software on your own appliance, system performance will
vary depending on your system's specifications. Candela Technologies does not guarantee
performance on your own system. We recommend you compare the system specifications of our
pre-configured LANforge Systems.
-
Download Fedora
The latest Fedora operating system can be downloaded from
http://www.fedoraproject.org/. Both standard
32-bit or 64-bit systems are available. If your system has more than 4GB of RAM, you may want to install
the 64-bit system. You will need to download all Fedora 8 install CDs and then create a boot CD.
-
Boot System from Fedora CD
- Apply power to your LANforge appliance
- Open the CD tray and insert the Fedora 8 boot CD
- Enter BIOS and check settings according to the LANforge BIOS Configuration guide
- Reboot
When rebooted, your system should detect the bootable Fedora CD and boot from the disc.
If your system does not boot from the CD, you may need to modify the BIOS to boot from
the CD-ROM drive. When the boot sequence is complete, the Fedora welcome screen will
be displayed on the monitor.
-
Install Fedora Operating System
From the Fedora welcome screen, the button for 'Install or upgrade an existing system' should be selected.
The system will boot again from the boot CD and start the Fedora 8 installer program. After a few
minutes 'Welcome to Fedora for i386' will be displayed on the monitor. Select the following from
the menu:
- Choose a Language: [English]
- Keyboard Type: [us]
- Installation Method [NFS directory]
Networking Device. All ports should be visible (e.g, eth0-eth3 for 2-port NIC + 2 onboard ports).
Select the port to install through (Management port = leftmost port facing rear of 1U).
Configure TCP/IP. Press the Space bar to deselect 'Enable IPv6 support' (IPv6 will be enabled
for LF version 5.0.8 and subsequent) and Tab to [OK].
NFS Setup (if successsful in getting IP address).
- Type in NFS server name: (IP address)
- Type in Fedora directory: /mnt/d2/pub/fc8-32
- Tab to [OK]
The graphical installer program will now execute. When complete, the Fedora default screen will be displayed
on the monitor.
- Click [Next]
- The button for 'Install Fedora' should be set, and click [Next]
- Select 'Remove all partitions on selected drives and create default layout' from pull-down
menu
- Select the 'Review and modify partitioning layout' checkbox, and click [Next]
- Warning (Are you sure...?). click [Yes]
The partitioning layout screen is now displayed. Verify that three partitions have been created (root, boot,
and swap).
The button for 'The GRUB boot loader will be installed on /dev/sda' should be set.
Network Devices
- ethX (management port should be checked)
- Set the hostname. Select [manually] and type in hostname (e.g., ct502-113 or lf1002-155) [Next]
- Select the nearest city in the customer's time zone (red X on map) [Next]
- Root Password: lanforge (and Confirm) [Next]
The LANForge machine will now retrieve installation information.
Install the following optional Fedora software:
- Add (select) 'Web server' checkbox
- Select the 'Customize now' button, and click [Next]
- Select 'Applications' from the list on the left:
- Select the 'Engineering and Scientific' checkbox
- Deselect the 'games' checkbox
- Select 'Servers' from the list on the left:
- Select 'Base System' from the list on the left:
- Select 'Base' then [Optional Packages]. Check the 'bridge-utils - 1.2.2.fc8.i386'
checkbox and [Close]
- Select the 'System Tools' checkbox then [Optional Pacakges]. Check the
'wireshark-gnome - 0.99.6-3.fc8.i386' checkbox and [Close]
- Click [Close]
- Click [Next]. The system will now check dependencies in packages selected for
installation.
- Click [Next]
The hard drive will now be formatted and Fedora software will be installed. This may take several minutes. When
complete, the following message will be displayed on the monitor:
'Contratulations, the installation is complete. Press the "Reboot" button to reboot your system.'
NOTE: Before rebooting, remove Fedora boot CD from the CD drive. If the boot CD remains in the drive,
the system will not boot from the hard drive.
The system will now reboot automatically from the LANforge hard drive. When the boot sequence is complete, the Fedora welcome screen will be displayed on the monitor.
-
Configure Computer Settings and Create User Login
The default display settings will most likely need to be changed to display correctly on your monitor.
- Click [Forward]
- License Information: [Forward]
- Firewall: select 'Disabled' from pulldown menu [Forward]
- Warning (Are you sure...?). Click [Yes]
- SELinux Setting: select 'Disabled' from pulldown menu [Forward]
- Warning (Would you like to continue...?). Click [YES]
Date and Time:
- Select 'Network Time Protocol' tab
- Select 'Enable Network Time Protocol' checkbox [Forward]
- Hardware Profile: [Forward]
- Warning (Are you sure...?). Click [No, do not send.]
Create User:
- Username: lanforge
- Full Name: lanforge
- Password: lanforge
- Click [Finish]
- Warning (Password is weak... Do you want to use it anyway?). Click [Yes]
- Warning (The system must now reboot). Click [OK]
When the boot sequence is complete, the Fedora welcome screen will be displayed on the monitor.
-
Configure Monitor and Customize Desktop
Login as user to the Welcome screen:
- Username: lanforge
- Password: lanforge
The Fedora default Desktop will now be displayed. The default display settings will most likely need
to be changed to display correctly on your monitor.
- Select the System pulldown menu then mouse over Administration > and select
Display
- Enter the root password (lanforge) and click [OK]
The Display Settings window will pop up with the Hardware tab selected.
- Select [Configure...] opposite Monitor Type.
- Click the carrot in front of Generic LCD Display to expand the menu, select
[LCD Panel 1280x1024] and click [OK]
- Click [OK] at the bottom of the window.
- Display settings changed (You need to log out and restart). Click [OK]
- Select the System pulldown menu followed by Log Out lanforge... and click
[Log Out]
Login again as user to the Welcome screen:
- Username: lanforge
- Password: lanforge
The Fedora Desktop will again be displayed.
- Select the System pulldown menu then mouse over Administration > and select
Display
- Enter the root password (lanforge) and click [OK]
The Display Settings window will pop up. Select the Settings tab.
- Resolution: select 1280x1024 from the pull-down menu and click [OK]
- Click [OK] at the bottom of the window.
- Display settings changed (You need to log out and restart). Click [OK]
- Select the System pulldown menu followed by Log Out lanforge... and click
[Log Out]
Login a third time as user to the Welcome screen:
- Username: lanforge
- Password: lanforge
The Fedora Desktop will now be correctly displayed on the monitor.
- Select the System pulldown menu then mouse over Preferences >, Look and Feel,
and select Screensaver
- Deselect 'Activate screensaver when computer is idle' checkbox and click [Close]
Right-click on the lower panel displayed on the Desktop and select Properties. This will pop up the
Panel Properties window. Select the General tab.
- Orientation: select 'Top' from pulldown menu
- Size: type '50' in the window
- Click [Close]
Right-click on the following icons and select [Remove From Panel] (any order is OK)
- Email
- Tomboy Notes (notepad icon)
- User Switcher ('lanforge')
- Volume Control (speaker icon)
- Trash (on second panel)
Right-click on the top panel and select Add to Panel...
- Select System Monitor, then click [Add] and [Close]
Right-click the following to change their settings:
- Update daemon (box icon): select [Quit]
- Date & Time display: select Preferences, select the 'Show seconds' checkbox [Close]
- Workspace (1 of the gray squares): deselect the 'Lock To Panel' checkbox. Right-click
again and select Move and move to the left of date (top panel)
- Show Desktop (blotter icon): deselect the 'Lock To Panel' checkbox. Right-click again
and select Move and move to the left of Workspace icons (top panel)
- System Monitor (processor): select Move and move to the left of the Desktop
(blotter) icon
Right-click the System Monitor (processor) and select Preferences. This will pop up the
System Monitor Preferences window.
- Select the checkboxes for the following Monitored Resources: Memory, Swap Space, Load,
and Harddisk
- System monitor Update interval: type '800' in the window and click [Close]
Install the following launchers to the top panel of the Desktop (will appear to the right of firefox icon):
- Select the Applications pulldown then mouse over System Tools > and right-click
on Terminal and select [Add this launcher to panel]
- Select the Applications pulldown then mouse over Internet > and right-click
on Wireshark Network Analyzer and select [Add this launcher to panel]
-
Firefox Web Browser Configuration
Perform the following from the Firefox menu:
- Select Edit followed by Preferences:
- Click on the Tabs icon, then select the 'Always show the tab bar' checkbox
- Click on the Security icon, then deselect the 'Remember passwords for sites'
checkbox
- Click [Close]
- Select View and mouse over Toolbars >
- Deselect the 'Bookmarks Toolbar' checkbox
-
Modify System Properties for LANforge
Click the terminal icon on the top panel two times to open two terminal windows on the Desktop.
Change terminal window scrollback to 10,000 lines (equal to 6367 kilobytes in memory size)
- Select the Edit pulldown and select Current Profile... to open the Editing
Profile "Default" window
- Select the Scrolling tab
- Scrollback: type '10000' lines in window and select [Close]
- Save these Desktop settings as lanforge:
$ gnome-session-save
Change the default run level:
- Change to root user and enter the password (lanforge):
$ su -
- Edit inittab as root:
# vi /etc/inittab
- Change 'id:5:initdefault:' to 'id:3:initdefault:'
(line 18)
- Write changes:
# :wq
- Edit GNOME Display Manager (GDM) custom configuration file to enable remote login:
# vi /etc/gdm/custom.conf
- Scroll down below comments (#) and insert a line below [security]
# Have fun!
[daemon]
[security]
DisallowTCP=false
- Press Esc to exit edit mode
- Write changes:
# :wq
-
Load Software and Updates
Open two additional terminal windows (or as required) to perform the following
systems modifications.
Change keepcache value to from 0 (don't keep files) to 1 (keep files):
- Edit yum configuration file as root:
# vi /etc/yum.conf
- Change 'keepcache=0' to 'keepcache=1' (line 3)
- Write changes:
# :wq
[BEGIN CANDELA ONLY]
- Edit the file system table to download lanforge:
- Edit fstab as root:
# vi /etc/fstab
- Scroll down to the last line
- Type 'o' (new line) and add the following in column format similar to
previous lines (separated by spaces):
(IP address):/mnt/d2 /mnt/d2 nfs
noauto 0 0
- Press Esc to exit edit mode
- Write changes:
# :wq
- Stop yum updates as root and wait for [OK]:
# service yum-updatesd stop
- Load LANforge and Fedora software:
- Mount directory d2 as root:
# mkdir /mnt/d2
# mount /mnt/d2
- Copy lanforge software from d2 to home directory as lanforge:
$ cp -ar /mnt/d2/pub/lf-staging .
- Copy Fedora software from d2 to home directory as root (this may take several minutes):
# cd /var/cache
# cp -ar /mnt/d2/pub/fc8-32-yum .
- Replace existing yum file with Fedora yum file (fc8-32-yum):
# rm -rf yum
# mv fc8-32-yum yum
[END CANDELA ONLY]
Download yum updates via fastestmirror:
- Change directories to root:
# cd
- Install fastest mirror:
# yum -y install yum-fastestmirror
- Download updates (this may take several minutes):
# yum -y update
- Stressing the CPUs
[BEGIN CANDELA ONLY]
Each CPU will now be 'burned' for 10 minutes (cpuburn is a set of programs that load the CPUs as heavily
as possible for the purposes of system testing). This process will be repeated for each processor. The
task manager should be displayed to monitor the progress of the cpuburn.
Display and modify the task manager for the CPU burn:
- Display the task manager in a terminal window as lanforge:
$ top
- Change task manager delay (Type 's' on the keyboard):
Change delay from 3.0 seconds to:
- Type '1' on the keyboard and press the Enter key
Start the CPU burn program on another terminal window:
- Change directories to cpuburn-(version) as lanforge:
$ cd lf-staging/cpuburn-1.4/
- Run cpuburn (repeat command for all logical cores):
$ ./burnP6 &
- Monitor the cpu burn on the task manager window for 10 minutes, then stop the CPU burn:
$ killall burnP6
[END CANDELA ONLY]
- Install Required LANforge Packages
- Install Perl scripts (this may take several minutes):
# yum -y install perl-CPAN
- Install DHCP, Expect, and other tools as root (7 packages total):
# yum -y install dhcp expect telnet telnet-server nautilus-open-terminal
- Manually configure the -MCPAN interface:
# perl -MCPAN -e shell
- Type 'no' and Enter to the following prompt:
Are you ready for manual configuration? [yes]
- After the cpan> prompt, type the following (this may take several minutes):
cpan> force install Net::SSLeay IO::Socket::SSL Net::Telnet Digest::HMAC_MD5
- When complete, the cpan> prompt will appear again. Type 'exit'
cpan> exit
-
Upgrade/Install the LANforge kernel
- Change directory to / as root:
# cd /
- Extract and install the Candela kernel
# tar xvf /home/lanforge/lf-staging/candela_cdrom.5.0.7/ct2.6.23.(version).tar.gz
- Copy last line of kernel script (below) and copy to command line:
# usr/local/bin/kinstall_ct2.6.23.17.bash
- Edit GRUB configuration file:
# vi /etc/grub.conf
- Select the 4 lines of Fedora kernel and type '4yy' on the keyboard
4 lines yanked
- Paste Fedora kernel text above its current location
- Edit pasted kernel text to read (kernal title line will vary by system):
title Candela Technologies (ct2.6.23.17_FC8smp) or (ct2.6.23.17_FC8_x86_64)
root (hd0,0)
kernel /ct2.6.23.17.img ro root=/dev/VolGroup00/LogVol00 rhgb quiet
initrd /initrd-ct2.6.23.17.img
- Press Esc to exit edit mode
- Write changes:
# :wq
-
Configure Level 3 Services
The System Services utility can be launched as root from the command prompt or from a terminal window.
It may be easier here to reboot the system and run the utility from the command prompt.
-
Configure Level 5 Services
-
Configure Network Scripts
- Change to root user and enter the password (lanforge):
$ su -
- Change directories to edit network-scripts:
# cd /etc/sysconfig/network-scripts
- Add XORP open routing software
# adduser xorp
- Edit group setting for xorp
# vi /etc/group
- Scroll down to end of file and change xorp information to:
xorp:x:501:xorp,root
- Press Esc to exit edit mode
- Write changes:
# :wq
- Change directories to /usr/local:
# cd /usr/local
- Extract xorp
# tar xvf /home/lanforge/lf-staging/candela_cdrom.5.0.7/xorp.tgz
-
Configure Ports
- Edit configuration file for all ports (eth0, eth1, eth2, etc.) as root:
# cd /etc/sysconfig/network-scripts
- List ports to confirm all ifcfg-ethX ports exist and no dev@XYZ alias present:
# ls
- Edit configuration file for all non-management ports (X):
# vi ifcfg-ethX
- Delete the following lines:
HWADDR=(hex address)
DHCP_HOSTNAME=(hostname)
- Edit lines:
BOOTPROTO=none
ONBOOT=no
- Press Esc to exit edit mode
- Write changes:
# :wq
- Edit configuration file for the management port:
# vi ifcfg-ethX
- Remove the following line:
HWADDR=(hex address)
- Edit line:
BOOTPROTO=dhcp
ONBOOT=yes
DHCP_HOSTNAME=(name)
- Add line to end of file:
PEERDNS=yes
- Press Esc to exit edit mode
- Write changes:
# :wq
- If hardware configuration has been changed or modified, run the following as root.
Then reboot and make port modifications described above:
# /bin/rm /etc/sysconfig/network-scripts/ifcfg-eth*
# /bin/rm /etc/sysconfig/hwconf
# /bin/rm -fr /etc/sysconfig/networking/*
# /bin/rm /etc/udev/rules.d/70-persistent-net.rules
- Also, verify the following file for extra interfaces, incorrect alias, etc.
# vi /etc/modprobe.conf
-
Install LANForge GUI and Desktop Icons
- Change directories for this procedure as lanforge:
$ cd /home/lanforge
- Extract the LANforge GUI to /home/lanforge:
$ tar xvf /lf-staging/candela_cdrom.5.0.7/LANforgeGUI_5.0.7_Linux.tar.bz2
- Add LANforge Anvil icon to /usr/share/pixmaps as root:
# cp /home/lanforge/lf-staging/lfgui-deskdop/canvil.ico /usr/share/pixmaps
- Add LANforge-GUI icon to the Desktop:
$ cp /lf-staging/lfgui-desktop/LANforge.desktop Desktop/
- As required, add the following icons to the Desktop:
$ cp /lf-staging/lfgui-desktop/LANforge-FIRE.desktop Desktop/
$ cp /lf-staging/lfgui-desktop/LANforge-ICE.desktop Desktop/
- Create symbolic link to desktop icons as root:
# ln -s /home/lanforge/LANforgeGUI_5.0.7/ /home/lanforge/LANforgeGUI
- Add LANforge options (all) to /usr/local/bin as root:
# cp /home/lanforge/lf-staging/lfgui-deskdop/lfgui* /usr/local/bin
- Options from /usr/local/bin:
- lfgui [LANforge-ICE icon] =-nofire -nofe -noarm -nogen -nol4 -nospans -not1ice -noppp
- lfgui1 [LANforge-FIRE icon] =-noice -nospans -not1ice
- lfgui2 [LANForge-GUI icon] =no restrictions
- lfgui3 (limited FIRE) =-noice -nofe -noarm -nogen -nol4 -nospans -not1ice -noppp
-
Install and Start LANForge Server
- Extract the LANforge Server as lanforge (creates LANforgeServer-5.0.7 directory):
$ tar xvf /lf-staging/candela_cdrom.5.0.7/LANforgeServer_5.0.7_Linux-x86.tar.gz
- Change to newly created directory as root:
# cd /home/lanforge/LANforgeServer-5.0.7/
- Verify and backup the version of the current IP configuration tool utility:
# ip -V
# mv /sbin/ip /sbin/ip.orig
- Add FC8 IP configuration and verify as root:
# cp ip.fc8 /sbin/ip
# ip -V
- Run install script as root:
# ./install.bash
Continue: (enter)
- Configure Management Port if required:
# cd .. (to home/lanforge)
# ./lfconfig
Your command: mgt_dev ethX (management port)
Your command: config
[BEGIN CANDELA ONLY]
- Configure Port Layout (for display on GUI 'Status' tab):
# vi lanforge_eth_1.cfg (cp from "Generating /home/lanforge/lanforge_eth_1.cfg)
PORT_CONF (tab) eth2 (tab) eth3 (tab) NA (tab) eth1 (tab) eth0 (tab) ~
(Delete excess lines)
- Press Esc to exit edit mode
- Write changes:
# :wq
[END CANDELA ONLY]
- Start LANforge (ensure all processes PASSED):
# ./serverctl.bash start
-
Install LANForge License
- cd to home/lanforge as root:
# vi license.txt
- Start the LANforge GUI. Verify LANforge license on the 'License Info' pane of
the Status page
-
LANforge GUI Configuration
- On the LANforge Connection Management window, select a resource from the pull-down
menu and click [Connect]
- Save a clean test configuration database prior to configuring system
- Type 'CLEAN' in the Name field of the Test Configuration Database panel and
click [Save]
- Run traffic test per customer requirements
- Save customer configuration
- Type 'FACTORY_DFLT' in the Name field of the Test Configuration Database panel and
click [Save]
-
Configure Wireshark
- Click the Wireshark icon on the top panel to start Wireshark and type in the root
password
- Warning (Running as "root"): Select the 'Don't show this message again' checkbox
- Select the Port Mgr tab on the GUI, select a port which is running traffic,
and click [Sniff Packets]
- Run GUI (or Wireshark?) on a remote system by entering in another IP and test
Wireshark again
- Select File [Quit] to exit Wireshark when complete
- Clean LANforge System Prior to Shutdown & Shipping
[BEGIN CANDELA ONLY]
- Make sure system can boot w/out keyboard & mouse
- Delete the list of 'Discovered' servers from the LANforge Connection Management
window as lanforge
$ cd /home/lanforge/LANforgeGUI
$ rm lfcnf.txt
- Remove EULA 'ok' files for server and GUI (server-eula-ok.txt and gui-eula-ok.txt)
$ cd /home/lanforge/LANforgeGUI
$ rm *ok*
- Delete all daily Test Configuration Databases (day_169, etc.) as root:
# cd /home/lanforge/DB
# rm -rf day_*
- Shutdown the LANforge GUI
- Select the Control pulldown menu followed by Connect
- From the LANforge Connection Management window, click [Disconnect]
- Select the Control pulldown menu followed by Exit
- Close all applications
- Log out of LANforge
- Select the System pulldown menu followed by Log Out lanforge... and click
[Log Out]
- Delete history as lanforge (from the console):
$ history -c
- Change to root user and delete history as root (from the console):
$ su -
# history -c
- Secure LANforge
# init 0
[END CANDELA ONLY]
- Final Preparation
[BEGIN CANDELA ONLY]
- Documentation:
- Shipping
- QuickBooks entries
- Customer Relationship Management
- Candela records
- E-mail to appliance recipient
- Hardcopy invoice?
- Update CVS
- Record the serial number of the hardware (on packing slip)
- Appliance case:
- Attach Candela label to faceplate (upper right)
- Label MGT and ethX ports on back (stock labels or use label maker)
- Power down and disconnect all cables
- Re-attach case screws
- WiFi MAC Address Sticker if supplied (CT520)
- Include the following in a medium size manila envelope:
- Customer notes (NOTES_XXX.txt)
- License file Hcopy & license.txt
- Warranty/ASA
- Candela brochure (1 page)
- Current CDROMs in jewel cases (LANforge + Ubuntu Live CD)
- Include the following in the shiping container:
- Appliance (include antennae for WiFi units)
- Manila envelope (above)
- User manuals for the Hardware shipped (MB, NICs, ...)
- SUPERMICRO CD for Iron Systems
- Key for front panel of the machine if it needs one (e.g., 2U rackmount)
- Power cord
- Rackmount Hardware
- CT920 (continued) BIOS: Disable FLoppy, Disable DMA, 38400, Disable LAN
[END CANDELA ONLY]
- Shipping/Delivery
[BEGIN CANDELA ONLY]
- Plan on eating lunch at the Asian Bistro (1730 Labounty Drive)
- Invoice in US mail (envelope size?) and with the shipment (??). (Don't forget Sales Tax if applicable!!)
- Packing Slip/Shipping List (Like quote/invoice, but no prices)
- Postal tracking number and receipt
[END CANDELA ONLY]
