Licensing Information  Quick Start Guide  LANforge LIVE Bootable CD Instructions

Current LANforge Software Release  All LANforge Software Releases

You may download the LANforge testing suite here. The software is fully functional and comes with a demo license that allows only two machines with one data generating port each or one machine with two data generating ports. If you wish to trial the LANforge ICE WAN Emulator or utilize more LANforge FIRE ports, contact sales@candelatech.com and you will be sent a trial license. This software may be used for a trial period of 15 days, after which you must either obtain a non-trial license from Candela Technologies, or un-install and delete the software you downloaded. You may purchase a full license at any time during the trial period.

You may want to read the LANforge Server Installation Documentation page completely before attempting to install! There is also an FAQ that may answer your questions.

1. Consider the LANforge bootable CDROM, it may have all the functionality you need. Otherwise, continue.
2. For optimum performance, you should upgrade your kernel.
3. Create a directory in which to place everything.
4. Make sure the version of the GUI matches the Manager/Resource version.
5. Download and read the release notes.
6. Download at least one of the LANforge-GUI -> options.
7. Download the Manager/Resource package.
8. Optional: Download the Extras package, and unpack it in the same directory (contains kernel patches), or get a pre-built kernel (below)
9. Optional: Download a pre-compiled Linux kernel (below), patched with the Candela patch-set. This enables Armageddon, virtual routers, and other advanced features.
10. Configure your Operating System according to: LANforge Hardware Installation Guide ->
11. Install the LANforge Software according to: LANforge Software Installation Guide ->
12. Install the LANforge-GUI according to: LANforge-GUI Installation Guide ->
13. Install demo licenses if required (see above)
14. LANforge should now be installed!

For detailed instructions on how to install and use the complete LANforge software suite, please see the LANforge Documentation Page.

If you have questions not answered there, send email to: support@candelatech.com, and we will attempt to answer your questions.

For optimum LANforge performance, and to enable all of LANforge's features, you should be running a LANforge Linux kernel. You can download the pre-compiled kernels, or you can build your own kernel using the candela patch (found in the LANforge Extras package under Optional Packages). For detailed instructions on compiling and installing LANforge Linux kernels, see the LANforge Server Installation Documentation.

NOTE: The LANforge GUI version and the LANforge Manager/Resource/Server version must match for the LANforge GUI to communicate correctly with the LANforge Manager/Resource/Server. See the All Releases link to find the all LANforge versions.

• LANforge Release 5.2.3 (FIRE & ICE)
• All Releases

Directory listing of all Release 5.2.3 files.

LANforge Release Notes (Get One)

Current Release Notes

release_notes.txt

LANforge GUI Downloads (Get at least one)
NOTE: LANforge GUI version must match installed LANforge Manager/Resource/Server version.

Microsoft (32bit) Operating Systems*	LANforge-GUI-5.2.3-Installer.exe(29MB)
For 32 bit Linux*	LANforgeGUI_5.2.3_Linux.tar.bz2 (40MB)
For 64 bit Linux*	LANforgeGUI_5.2.3_Linux64.tar.bz2 (40MB)
For any other Java supported system	LANforgeGUI_5.2.3_NO_JRE.zip (45MB)

* LANforge GUIs come complete with Sun's 1.6 Java Runtime Environment.

LANforge Manager/Resource/Server (Get at least one)

Manager/Resource for Linux (Intel x86 Platform, Fedora 11 and above)	LANforgeServer-5.2.3_Linux-F11-x86.tar.gz
Manager/Resource for Linux (Intel/AMD x86-64 Platform, Fedora 11 and above)	LANforgeServer-5.2.3_Linux-F11-x64.tar.gz
Manager/Resource for Windows	LANforge-Server-5.2.3-Installer.exe
Manager/Resource for Linux (Fedora 15)	32-bit Server    |    64-bit Server
Manager/Resource for Linux (Fedora 14)	32-bit Server    |    64-bit Server
Manager/Resource for Linux (Fedora 13)	32-bit Server    |    64-bit Server
Manager/Resource for Linux (Fedora Core 8)	32-bit Server    |    64-bit Server
Manager/Resource for Solaris x86	(Contact Candela)
Manager/Resource for Solaris SPARC	(Contact Candela)
Manager/Resource for Linux (ARM Platform)	(Contact Candela)
Manager/Resource for Linux (Power-PC Platform)	(Contact Candela)

Optional Packages

LANforge LIVE CDROM ISO Image, see below	Ubuntu-Live-11.04-LANforge.iso
LF0200 2GB+ Compact-Flash image	(Contact Candela)
LANforge Extras (CLI scripting, kernel patches, etc)	LANforgeExtras-5.2.3_Linux.tar.gz
LANforge-ICEcap Java Webstart (optional)	http://www.candelatech.com/oss/icecapwebpage.html
LANforge-GUI source code (optional)	lfgui-src-5.2.3.tar.gz (GPL) (java)
GNU-server Source code, probes Ethernet devices (optional)	gnuserver.src.tar.gz (GPL) (c++)

Pre-Compiled Linux Kernels for LANforge 5.2.3
If you do not wish to compile your own kernels, you can use one of the following. To install, un-tar the file in / and then change your /etc/grub.conf or /etc/lilo.conf file appropriately. SMP kernels will work on uni-processor machines too.

• Pre-compiled LANforge 5.2.3 Linux 3.0.19+ kernel (VIA C3)
• Pre-compiled LANforge 5.2.3 Linux 3.0.19+ kernel (32-bit Intel/AMD/Generic)
• Pre-compiled LANforge 5.2.3 Linux 3.0.19+ kernel (Intel/AMD x86-64)

If you are only running a single LANforge machine, consider the LANforge bootable CDROM (based on a modified version of Ubuntu Linux This ISO image, when burned to a CD, will boot into Linux with the Candela Linux kernel and LANforge programs already installed. The CD will run entirely out of RAM with no lasting affect on the machine.

Bootable CDROM Hardware & Configuration Suggestions:

• Must have 686 (Pentium-II compatible or higher CPU).
• Minimum of 512MB RAM, 1+GB is better.
• Most configurations are easier with at least 2 ethernet interfaces, but LANforge can be configured to work with fewer.
• BIOS that allows booting from CDROM
• USB Floppy disk or USB storage for license files and configuration database is suggested, but not required.

Usage Instructions:

1. Ensure BIOS is configured to boot from CDROM
2. Obtain license key from sales@candelatech.com.
3. Boot computer with LANforge bootable CDROM inserted. You should see standard Ubuntu screen with several options. Select the English language and use the default boot option.
4. Log in as user: lanforge with password: lanforge
   Root password is also 'lanforge'
5. With LANforge release 5.0.8 and newer, LANforge is no longer started automatically on boot. Double-click the LANforge-Server icon to start it. If you are using persistent media to store the LANforge database, insert it and make sure it is discovered before you start LANforge.
6. If you do not want to use 'lo' for the management interface, or wish to reconfigure LANforge for other reasons, open a console window and run these commands:

   su -
   # Enter 'lanforge' for the root user password.
   cd /home/lanforge
   # Remove any persistent media (floppy, usb-drive, etc)
   ./serverctl.bash stop
   ./lfconfig --new_layout
   > # make your config changes here
   > config
   ./serverctl.bash start interactive
   # If you plan to use persistent storage media, insert that now.
   

7. If you want a management interface to use DHCP, run these commands:

   su -
   dhclient <interface>
   cd /home/lanforge
   ./serverctl.bash stop
   ./serverctl.bash start interactive
   

8. If you want to use persistent storage media, make sure LANforge is stopped:

   cd /home/lanforge
   ./serverctl.bash stop
   

   Then insert a floppy and/or USB drive. You must create a file called: lanforge_db.txt on the root directory of the media or LANforge will not use this media. The file can be empty, it just has to exist.

   After it is inserted, start LANforge again:

   cd /home/lanforge
   ./serverctl.bash start interactive
   

9. Double-click the LANforge-GUI icon and connect to the server at localhost:4002
10. You may use the limited license included with the Live CD, or you may install another temporary license obtained from sales@candelatech.com.
11. When you are done using LANforge and want to save your configuration, make sure the persistent storage devices are inserted into the machine and at the command prompt type:

    ./serverctl.bash stop
    

    If the media has the file lanforge_db.txt on it, LANforge will attempt to save its DB to a file called lfdb.tgz on the media. This file stores your LANforge configuration and license key, and can be used next time you run the CD on this machine.
12. The LANforge Live CDROM may have problems on some machines due to driver issues or other unforseen problems.
    Please contact support@candelatech.com if you run into any problems.

To download the LANforge bootable CD ISO image, see the "Optional Packages" sections above.