MEICAN

Management Environment of Inter-domain Circuits for Advanced Networks is a web application for the management of Dynamic Circuit Networks (DCNs). Users access MEICAN through a graphical user interface based on Web technologies, to requesting the creation of circuits between well defined endpoints. In this process, users specify the source and destination points of the circuits, the bandwidth required, the time at which the circuit must be created, as well as the time interval in which the circuit must be active. The system also provides mechanisms that allow circuit requests to be provisioned automatically or upon the approval of network administrators. For this purpose, MEICAN internally employs a machine workflows with support for network management, which represent the operating policies set by the operators.

Since version 2 the system meets the demands of users contacting a Connection Service Provider with the Network Service Interface (NSI) protocol. In our environment, a central server MEICAN interacts with the NSI Aggregator installed in the backbone of the Brazilian Research & Education Network ( RNP - Rede Nacional de Ensino e Pesquisa ). At RNP, MEICAN works as the central portal for all users who need to create circuits along its backbone.

Since version 3 the project has a better integration with monitoring systems. The circuits and networks can be monitored through of the same web application. Thus, it's unnecessary to access other systems to perform the monitoring of traffic in the circuits created by MEICAN.

This software is result of a partnership between the Brazilian Research & Education Network (RNP) and the Brazilian Federal University of Rio Grande do Sul (UFRGS).

Mobile friendly since version 3

Alt text

DIRECTORY STRUCTURE

certificates/           app certificates
config/                 app configurations
docker/         Docker files
mail/                   layouts and templates for mail sender
migrations/             database version control
modules/                application modules
aaa/            AAA Module
base/           Base Module
bpm/            BPM Module
circuits/       Circuits Module
home            Home Module
monitoring/             Monitoring Module
nmwg/                   NMWG Module
notify/         Notify Module
nsi/                    NSI Module
perfsonar/              PerfSONAR Module
oscars/         OSCARS Module
scheduler/      Scheduler Module
tester/                 Tester Module
topology/       Topology Module
    assets/     css, js files and bundle classes
    utils/      utils classes
    controllers/    containing controller class files
    forms/      form models for views
    messages/   I18N internationalization files
    models/     database or standard models, e.g., DAO classes
    views/      views and layout files
runtime/                folder for logging and debug features
tests/                  test scripts
web/                    web accessible files, e.g., assets cache, wsdl files and images.

REQUIREMENTS

Hardware

CPU 1+
Memory 1GB+
Storage 10GB+

Software

Ubuntu/CentOS/Any other OS with Crontab feature
Apache 2.2+
MySQL 5+
PHP 5.5+
cURL
Docker

GUIDES

Installation

Installation can be done using Docker and docker-compose commands.

git clone https://github.com/atlanticwave-sdx/sdx-meican.git
update then environment variables in web/index.php file

defined('MEICAN_URL') or define('MEICAN_URL', 'localhost'); defined('API_URL') or define('API_URL', 'http://xx.xx.xxx.xxx:8080/SDX-Controller/1.0.0/'); defined('ORCID_CLIENT_ID') or define('ORCID_CLIENT_ID', 'xxxxxxxx'); defined('ORCID_CLIENT_SECRET') or define('ORCID_CLIENT_SECRET', 'xxxxxxxx'); defined('ENABLE_CILOGON_PAGE') or define('ENABLE_CILOGON_PAGE', true); // Cilogon environment variable for enabling/disabling cilogon defined('CILOGON_CLIENT_ID') or define('CILOGON_CLIENT_ID', 'xxxxxxxxxxxx');
start the container: docker-compose -f docker-compose.yml -f docker-compose.dev.yml up --build

atlanticwave-sdx / sdx-meican

readme