Common Open Research Emulator
Find a file
2022-10-12 20:53:59 -07:00
.github moved python black configuration to pyproject.toml and fixed bad exclude 2020-07-14 13:33:40 -07:00
daemon gui: improved throughputs start/stop to coincide with session start and stop based on a tracked variable 2022-10-12 20:53:59 -07:00
docs docs: added notes about new wireless node type to GUI documentation 2022-10-12 08:48:23 -07:00
man daemon: removing python tlv related code and tests related to it 2022-03-08 14:18:47 -08:00
netns daemon: removing python tlv related code and tests related to it 2022-03-08 14:18:47 -08:00
package install: add option to avoid y/n prompt when uninstalling core during post install script 2022-07-29 14:03:45 -07:00
.editorconfig added net client to consolidate bridge and interface creation 2019-09-26 15:20:32 -07:00
.gitignore install: updated automated install to place virtual environment to /opt/core/venv to be consistent with new package location 2022-09-29 13:58:09 -07:00
ASSIGNMENT_OF_COPYRIGHT.pdf updated assignment of copyright file name to add to dist file 2017-12-18 09:28:41 -08:00
bootstrap.sh daemon: removing python tlv related code and tests related to it 2022-03-08 14:18:47 -08:00
CHANGELOG.md updated changelog for 8.2.0 release 2022-03-21 21:43:24 -07:00
configure.ac install: bumped version to 9.0.0 for next release 2022-05-11 09:19:00 -07:00
Dockerfile.centos update dockerfiles to fix default branch name in the oracle linux dockerfile and update pip in the centos dockerfile to get back to working order 2022-06-27 09:38:52 -07:00
Dockerfile.oracle update dockerfiles to fix default branch name in the oracle linux dockerfile and update pip in the centos dockerfile to get back to working order 2022-06-27 09:38:52 -07:00
Dockerfile.ubuntu install: updated and added dockerfiles for ubuntu/centos, updated notes on install page to correlate 2022-05-25 21:43:52 -07:00
LICENSE updates to simplify tracking the copyright and an update to 2018, still room for improvement 2018-03-15 10:36:54 -07:00
Makefile.am install: updates to support building deb/rpm packages that contain python wheels and install core from a single file, updates to core to install scripts by way of python directly 2022-07-27 16:00:10 -07:00
README.md docs: update quickstart readme for installation covering new package option 2022-10-07 13:05:16 -07:00
setup.sh install: updated option to skip system python packages for setup.sh to be more appropriately named 2022-09-14 22:43:33 -07:00
tasks.py install: updated automated install to place virtual environment to /opt/core/venv to be consistent with new package location 2022-09-29 13:58:09 -07:00

CORE

CORE: Common Open Research Emulator

Copyright (c)2005-2022 the Boeing Company.

See the LICENSE file included in this distribution.

About

The Common Open Research Emulator (CORE) is a tool for emulating networks on one or more machines. You can connect these emulated networks to live networks. CORE consists of a GUI for drawing topologies of lightweight virtual machines, and Python modules for scripting network emulation.

Quick Start

Requires Python 3.6+. More detailed instructions and install options can be found here.

Package Install

Grab the latest deb/rpm from releases.

This will install vnoded/vcmd, system dependencies, and CORE within a python virtual environment at /opt/core/venv.

sudo <yum/apt> install -y ./<package>

Then install OSPF MDR from source:

git clone https://github.com/USNavalResearchLaboratory/ospf-mdr.git
cd ospf-mdr
./bootstrap.sh
./configure --disable-doc --enable-user=root --enable-group=root \
  --with-cflags=-ggdb --sysconfdir=/usr/local/etc/quagga --enable-vtysh \
  --localstatedir=/var/run/quagga
make -j$(nproc)
sudo make install

Script Install

The following should get you up and running on Ubuntu 22.04. This would install CORE into a python3 virtual environment and install OSPF MDR from source.

git clone https://github.com/coreemu/core.git
cd core
# install dependencies to run installation task
./setup.sh
# run the following or open a new terminal
source ~/.bashrc
# Ubuntu
inv install
# CentOS
inv install -p /usr

Documentation & Support

We are leveraging GitHub hosted documentation and Discord for persistent chat rooms. This allows for more dynamic conversations and the capability to respond faster. Feel free to join us at the link below.