64 lines
2 KiB
Markdown
64 lines
2 KiB
Markdown
# 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.9+. More detailed instructions and install options can be found
|
|
[here](https://coreemu.github.io/core/install.html).
|
|
|
|
### Package Install
|
|
Grab the latest deb/rpm from [releases](https://github.com/coreemu/core/releases).
|
|
|
|
This will install vnoded/vcmd, system dependencies, and CORE within a python
|
|
virtual environment at `/opt/core/venv`.
|
|
```shell
|
|
sudo <yum/apt> install -y ./<package>
|
|
```
|
|
|
|
Then install OSPF MDR from source:
|
|
```shell
|
|
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](https://github.com/USNavalResearchLaboratory/ospf-mdr) from source.
|
|
|
|
```shell
|
|
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.
|
|
|
|
* [Documentation](https://coreemu.github.io/core/)
|
|
* [Discord Channel](https://discord.gg/AKd7kmP)
|