Skip to content

chrismetz09/netACL

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

30 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

OpenDaylight netACL App

OpenDaylight (ODL) is an open-source application development and delivery platform. This ACL app uses NETCONF to configure access lists on your routers.

Contact Email

netacl-app@external.cisco.com (Will be live July 4th 2016)

Getting started

Run frontend:

  1. Run pip install -r frontend/requirements.txt in your python environment
  2. Run python -m frontend.rest_server_v5

Run backend:

  1. Run pip install -r backend/requirements.txt in your python environment
  2. Create "backend/local_settings.py" with corresponding to "backend/settings.py" variables.
  3. controller_address and controller_auth variables should be set to establish connection to a working ODL instance with a running network topology. (TBD - supported controller versions)
  4. Make sure current user has enough permissions to create system path specified in "log_file" variable
  5. Run python -m backend.app

Running ACL app

After deploying frontend and backend:

  1. Open your browser. (TBD - supported browsers)
  2. Go to ACL app index page, which can be located at: %YOUR_HOST%:8020/cisco-ctao/apps/acl/index.html, where %YOUR_HOST should be substituted by host name of where frontend is deployed. You should see the main app screen: Main screen
  3. Enter an existing node name in the search field in the upper left corner of the page. You'll see a list of existing network interfaces on this node. Interface list screen
  4. Select an interface and click add to selection list, then click Add ACL. ACL choice screen
  5. Choose New from blank ACL or New from template. Here is an example of a preset template: Infrastructure template
  6. Click Deploy Inbound or Deploy Outbound, enter a name and hit Confirm. Click Back to full map view, then the chevron near selected ACLs and subsequently View ACL. You'll see the ACL applied to your selected interface. Interface ACLs
  7. The ACL is now applied to the interface.

Adding apps

  1. Create a python package with name equal to app name
  2. Create following python modules in app package with specific contents (list is to be altered):
  3. topology_parser.py: 1. Class Topology with parse_controller_topology method that handles parsing topology from controller format to UI usable one
  4. handler.py: 1. Class Handler that subclasses tornado.web.RequestHandler class. It should provide HTTP verb methods (at least get, post, put and delete) and behave like a tornado handler
  5. Add app name to INSTALLED_APPS list in backend/local_settings.py file
  6. Run backend and check logs to see if app connection has been successful

Releases

No releases published

Packages

No packages published

Languages

  • JavaScript 48.9%
  • CSS 33.6%
  • Python 16.9%
  • HTML 0.6%