To work on Traffic Portal you need a *nix (MacOS and Linux are most commonly used) environment that has the following installed:
The Traffic Portal consumes the Traffic Ops API. By default, Traffic Portal assumes Traffic Ops is running on https://localhost:8444. Temporarily modify traffic_portal/conf/config.js if you need to change the location of Traffic Ops.
Traffic Portal Project Tree Overview¶
Installing The Traffic Portal Developer Environment¶
- Clone the Traffic Control Repository
- Navigate to the
traffic_portalsubdirectory of your cloned repository.
npm installto install application dependencies into
traffic_portal/node_modules. Only needs to be done the first time unless
bower installto install client-side dependencies into
traffic_portal/app/bower_components. Only needs to be done the first time unless
gruntto package the application into
traffic_portal/app/dist, start a local HTTPS server (Express), and start a file watcher.
- Valid SSL certificates and keys are needed for Traffic Portal to run. Generate these (e.g. using this SuperUser answer) and edit the
traffic_portal/conf/config.jsonfile to reflect their names and locations
- Navigate to https://localhost:8443 (default listening address/port)