Common Open Research Emulator

emane emulating-networks emulation emulator network python rf wireless

Find a file

Blake Harnden e5e14ad67b grpc: added wlan/emane links to grpc calls to allow knowing initial wireless link state, same as before changes		2022-03-21 09:55:57 -07:00
.github	moved python black configuration to pyproject.toml and fixed bad exclude	2020-07-14 13:33:40 -07:00
daemon	grpc: added wlan/emane links to grpc calls to allow knowing initial wireless link state, same as before changes	2022-03-21 09:55:57 -07:00
docs	docs: updated emane python example to use updated set_config	2022-03-11 11:04:01 -08:00
gui	updates to sample1 scenarios to remove any custom service configurations, since the defaults should be used, fixes an issue specifically in sample1.imn	2021-10-29 14:11:11 -07:00
man	removed configuration option for number of for corehandler threads as it cannot properly deal with anything more than 1, updated man pages to current 6.4 versions for now	2020-06-05 14:34:19 -07:00
netns	update to installation docs, tweaks to handling python2/3 package builds	2019-06-10 11:41:27 -07:00
.editorconfig	added net client to consolidate bridge and interface creation	2019-09-26 15:20:32 -07:00
.gitignore	removed python buid/installation from makefiles, poetry will handle	2020-07-14 12:08:05 -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	initial pass at removing bsd and code related to using bsd nodes	2018-03-07 12:54:19 -08:00
CHANGELOG.md	added 8.1.0 notes to changelog	2022-02-18 09:08:22 -08:00
configure.ac	install: bumping version to 8.1.0 for next release	2022-02-10 16:17:22 -08:00
Dockerfile	added docs on how to leverage Dockerfile install for core and update Dockerfile to default to master for latest release	2022-01-12 15:30:10 -08: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	daemon: updates to switch from using ebtables to nftables for wlan linking/unlinking	2021-05-10 15:07:42 -07:00
README.md	install: updated install instructions to use the right command for centos example	2022-02-28 10:03:34 -08:00
setup.sh	install: adjustments to have a better workflow for installation	2022-02-17 15:17:07 -08:00
tasks.py	install: updated ospf check to use sudo to account for sbin potentially not being on path	2022-02-18 15:25:41 -08:00

README.md

CORE

CORE: Common Open Research Emulator

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

The following should get you up and running on Ubuntu 18+ and CentOS 7+ from a clean install, it will prompt you for sudo password. This would install CORE into a python3 virtual environment and install OSPF MDR from source. For more detailed installation see here.

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.