#summary How to get CORE up and running quickly.

= Quickstart =

CORE is a network emulation system, and version 3.5 requires the FreeBSD or Linux operating systems. It is recommended that you use *CORE on FreeBSD 7.2* for the best experience, and the Linux version only when you really need it (see the [http://hipserver.mct.phantomworks.org/core/manual/ manual] for more help on choosing which version to install).

|| *FreeBSD* (recommended) || *Linux* ||
|| Step 1. Install FreeBSD 7.2<br> http://hipserver.mct.phantomworks.org/core/images/cd_48.png  *7.2-RELEASE-i386-dvd1.iso* (2.1 gb)<br>[ftp://ftp.freebsd.org/pub/FreeBSD/releases/i386/ISO-IMAGES/7.2/]<br>Burn the ISO image to a blank DVDR using your CD writing software. Boot the DVD-ROM on your target system and follow the on-screen instructions. || Step 1. Install CentOS Linux 5.4<br> http://hipserver.mct.phantomworks.org/core/images/cd_48.png  *CentOS-5.4-i386-bin-DVD.iso* (4.4 gb)<br> [http://isoredirect.centos.org/centos/5/isos/i386/]<br>Burn the ISO image to a blank DVDR using your CD writing software. Boot the DVD-ROM on your target system and follow the on-screen instructions. ||
|| Step 2. Install prerequisite packages<br>`# pkg_add -r tk85 sudo bash` <br> <br>Consult the [http://hipserver.mct.phantomworks.org/core/manual/Required-Software-for-FreeBSD.html manual] for more details. <br><br><br><br><br><br><br><br><br><br> || Step 2. Install prerequisite packages, [http://download.fedora.redhat.com/pub/epel/5/i386/epel-release-5-3.noarch.rpm EPEL repo] and [http://wiki.openvz.org/Quick_installation#yum_pre-setup OpenVZ]<br> `# yum install bridge-utils iproute tcl.i386 tk.i386`<br> `# rpm -Uvh epel-release-5-3.noarch.rpm`<br> `# yum install ebtables`<br> `# cd /etc/yum.repos.d` <br> `# wget http://download.openvz.org/openvz.repo` <br>`# wget http://download.openvz.org/RPM-GPG-Key-OpenVZ` <br>`# rpm --import RPM-GPG-Key-OpenVZ` <br>`# yum install ovzkernel vzctl`<br><br>edit `/etc/grub.conf` to give your new OpenVZ kernel a name other than CentOS<br>edit the `/etc/sysctl.conf` and `/etc/sysconfig/selinux` files as described on [http://wiki.openvz.org/Quick_installation this page] <br>edit `/etc/vz/vz.conf` and change `DISK_QUOTA=no` and `IPV6="yes"`<br><br> Consult the [http://hipserver.mct.phantomworks.org/core/manual/Required-Software-for-Linux.html manual] for more details. ||
|| Step 3. Download and install the CORE packages<br> http://hipserver.mct.phantomworks.org/core/images/box_download_48.png [http://downloads.pf.itd.nrl.navy.mil/core/packages/3.5/freebsd/core-kernel-7.x-20090505.tbz core-kernel-7.x-20090505.tbz] (47 MB) <br>  [http://downloads.pf.itd.nrl.navy.mil/core/packages/3.5/freebsd/core-7.x-3.5.tbz core-7.x-3.5.tbz] (600 KB)<br> [http://downloads.pf.itd.nrl.navy.mil/core/packages/3.5/freebsd/quagga-manetmdr-0.99.9_5.tbz quagga-manetmdr-0.99.9_5.tbz] (3 MB)<br>`# pkg_add core-kernel-7.x-20090505.tbz`<br>`# pkg_add core-7.x-3.5.tbz`<br>`# pkg_add quagga-manetmdr-0.99.9_5.tbz`|| Step 3. Download and install the CORE packages<br> http://hipserver.mct.phantomworks.org/core/images/box_download_48.png [http://downloads.pf.itd.nrl.navy.mil/core/packages/3.5/linux/core-3.5-1.i386.rpm core-3.5-1.i386.rpm] (697 KB)<br>[http://downloads.pf.itd.nrl.navy.mil/core/packages/3.5/linux/core-root-3.5-1.i386.rpm core-root-3.5-1.i386.rpm] (208 MB)<br>`# rpm -ivh core-3.5-1.i386.rpm` <br>`# rpm -ivh core-root-3.5-1.i386.rpm` <br><br><br> ||
|| Step 4. Reboot and start the CORE daemons<br>`sudo /usr/local/etc/rc.d/core onestart` || Step 4. Reboot and start the CORE daemons<br>`sudo /etc/init.d/core start` ||
|| Step 5. Run the CORE GUI from X11<br>`sudo core &` || Step 5. Run the CORE GUI from X11<br>`sudo core &` ||


<br>

= Tips =
 * Once you see the CORE GUI, you can try loading one of the sample configuration such as `sample1.imn`
 * CORE requires the Tcl/Tk packages, either version 8.4 or 8.5. You may see warnings about specific package versions on FreeBSD, these may be safely ignored.
 * For system requirements and tips on the install process, visit the [http://hipserver.mct.phantomworks.org/core/manual/Prerequisites.html Prerequisites] page of the [http://hipserver.mct.phantomworks.org/core/manual/index.html CORE manual]; also refer to [http://www.freebsd.org], [http://www.centos.org], [http://www.openvz.org]


= Other Options =
 * *VMware image*<br>*Pros:* everything is already set up for you; one file to download.  *Cons:* poor performance; for quick evaluation only.<br>*vcore-3.5.zip* (1.3 gb) or *vcore-3.5-linux.zip* (850 mb)<br>[http://downloads.pf.itd.nrl.navy.mil/core/vmware-image/]<br>You can run CORE from within this pre-built VMware virtual machine with minimal setup. See the included vcore.txt in the zipfile for login information. _Note that you may experience decreased performance and timer issues, and there is the added confusion of virtualization within virtualization. If you decide to run in this mode, we suggest using SSH with X11 forwarding into the VCORE virtual machine, to mitigate the decreased performance of the VMware virtual display._

 * *FreeBSD 4.11* <br>lighter-weight virtual machines, but packages no longer provided
   # first install *4.11-RELEASE-i386-disc1-gnome.iso* (563 mb)<br>[ftp://ftp-archive.freebsd.org/pub/FreeBSD-Archive/old-releases/i386/ISO-IMAGES/4.11/]
   # then install from source or use the older *core-freebsd411-3.3.sh* (19 mb)<br>[http://downloads.pf.itd.nrl.navy.mil/core/installer-complete/]

 * *Build from source* <br>To build a CORE machine *from scratch*, including patching and compiling your own CORE kernel, see the [http://hipserver.mct.phantomworks.org/core/manual/Installing-from-Source.html Installing from Source] page of the [http://hipserver.mct.phantomworks.org/core/manual/index.html CORE manual].