Metron Management UI

This module provides a user interface for management functions in Metron.

Prerequisites

A network accessible Metron REST application
nodejs v6.9+ (nodejs can be installed on quick dev with curl --silent --location https://rpm.nodesource.com/setup_6.x | bash - && yum install -y nodejs)

Installation

From Source

Package the application with Maven:

cd metron-interface/metron-config
mvn clean package

Untar the archive in the $METRON_HOME directory. The directory structure will look like:

bin
  metron-management-ui
web
  expressjs
    package.json
    server.js
  management-ui
    web assets (html, css, js, ...)

Copy the $METRON_HOME/bin/metron-management-ui script to /etc/init.d/metron-management-ui
Install the Express web framework from the package.json file in $METRON_HOME/web/expressjs:
```
npm --prefix $METRON_HOME/web/expressjs/ install
```

From Package Manager

Deploy the RPM at /metron/metron-deployment/packaging/docker/rpm-docker/target/RPMS/noarch/metron-config-$METRON_VERSION-*.noarch.rpm

Install the RPM with:

rpm -ih metron-config-$METRON_VERSION-*.noarch.rpm

Install the Express web framework from the package.json file in $METRON_HOME/web/expressjs:
```
npm --prefix $METRON_HOME/web/expressjs/ install
```

Configuration

The Managment UI is configured in the $METRON_HOME/config/management_ui.yml file. Create this file and set the values to match your environment:

port: port the managment UI will run on

rest:
  host: REST application host
  port: REST applciation port

Usage

After configuration is complete, the Management UI can be managed as a service:

service metron-management-ui start

The application will be available at http://host:4200 assuming the port is set to 4200. Logs can be found at /var/log/metron/metron-management-ui.log.

Development

The Management UI can also be started in development mode. This allows changes to web assets to be seen interactively.

Install the application with dev dependencies:

cd metron-interface/metron-config
npm install

Start the application:
```
./scripts/start_dev.sh
```

The application will be available at http://localhost:4200/. The REST application url defaults to http://localhost:8080 but can be changed in the proxy.conf.json file.

Testing

Install the application with dev dependencies:

cd metron-interface/metron-config
npm install

Unit tests can be run with:
```
npm test
```

License

This projects bundles Font Awesome which is available under the SIL Open Font License. See http://fontawesome.io/license/ for more details.