afonso/core-extra
1
0
Fork 0
Code Issues Pull requests Projects Releases Wiki Activity
Common Open Research Emulator
835 commits 17 branches 33 tags 20 MiB
Python 91.8%
C 5.4%
Shell 1.5%
Makefile 0.7%
M4 0.4%
Other 0.2%
Find a file
bharnden b844f647e3
Merge pull request #185 from coreemu/bugfix/build-without-python-sphinx 
make python-sphinx optional
2018-10-10 09:18:54 -07:00
daemon fixes #197 removes wireless_link_all and updates example 2018-10-09 12:46:27 -07:00
docs #193 updates to service validation, will retry validation for validation_timer period, instead of just waiting, using configurable validation_period 2018-09-26 14:20:19 -07:00
gui #192 updated default gnome-terminal command for gui 2018-09-12 11:16:15 -07:00
man moved core markdown documentation to live within to repo, this will eventually be the docs hosted on github and allow them to be versioned with the code 2018-07-31 12:57:30 -07:00
netns updated versioning to 5.2 2018-07-06 14:26:33 -07:00
ns3 updated versioning to 5.2 2018-07-06 14:26:33 -07:00
scripts fixed typo for sysv script PYTHONPATH 2018-04-20 20:38:50 -07:00
.editorconfig removed pip check, updated make files for using DESTDIR, removed usage of pip during make install 2017-08-21 12:55:51 -07:00
.gitignore removed swap file and added to gitignore 2018-03-25 22:18:37 -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 Update Changelog 2018-05-22 20:56:24 -07:00
configure.ac do not try to build docs by default, unless './configure --enable-docs' is specified 2018-10-09 15:51:54 -07:00
Jenkinsfile broke out testing to individual tests 2018-03-07 10:00:50 -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 moved core markdown documentation to live within to repo, this will eventually be the docs hosted on github and allow them to be versioned with the code 2018-07-31 12:57:30 -07:00
README.md updates to README to add Discord and online documentation link 2018-05-02 08:50:38 -07:00
sonar-project.properties updated versioning to 5.2 2018-07-06 14:26:33 -07:00

README.md

CORE

CORE: Common Open Research Emulator

Copyright (c)2005-2018 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.

Documentation and Examples

Support

We are leveraging Discord for persistent chat rooms, voice chat, and GitHub integration. This allows for more dynamic conversations and the capability to respond faster. Feel free to join us at the link below. https://discord.gg/AKd7kmP

You can also get help with questions, comments, or trouble, by using the CORE mailing lists:

  • core-users for general comments and questions
  • core-dev for bugs, compile errors, and other development issues

Building CORE

./bootstrap.sh
./configure
make
sudo make install

Building Documentation

./bootstrap.sh
./configure
make doc

Building Packages

Install fpm: http://fpm.readthedocs.io/en/latest/installing.html

Build package commands, DESTDIR is used for gui packaging only

./bootstrap.sh
./configure
make
mkdir /tmp/core-gui
make fpm DESTDIR=/tmp/core-gui

This will produce:

  • CORE GUI rpm/deb files
    • core-gui_$VERSION_$ARCH
  • CORE ns3 rpm/deb files
    • python-core-ns3_$VERSION_$ARCH
  • CORE python rpm/deb files for SysV and systemd service types
    • python-core-sysv_$VERSION_$ARCH
    • python-core-systemd_$VERSION_$ARCH

Running CORE

First start the CORE services:

# sysv
sudo service core-daemon start
# systemd
sudo systemctl start core-daemon

This automatically runs the core-daemon program. Assuming the GUI is in your PATH, run the CORE GUI by typing the following:

core-gui

This launches the CORE GUI. You do not need to run the GUI as root.