On Web UI

Copyright 2015, EMC, Inc.

Publicly hosted on GitHub page.

A live version of the UI can be used at:

Live RackHD UI

You can change the API endpoints from the settings page. Look for the gear icon.

A zip file of the live version can always be downloaded from the gh-pages branch:

Download latest build

Extract the zip file to any directory served over HTTP. This is done automatically by on-http with npm install.

Quick getting started guide.

Requires Node v6 or greater to run on-web-ui dev tools.

$ git clone https://github.com/RackHD/on-web-ui.git
$ cd on-web-ui
$ npm install
$ npm start             # Start development server at http://127.0.0.1:3000.
$ npm test              # Run automated tests.

Note:

This was a secure fix since webpack-dev-server v2.4.3, devServer.host='0.0.0.0' in webpack.config.babel.js will give "Invalid Host header". There are two solutions for this:

• Add disableHostCheck=false for devServer configuration, or
• Change the IP '0.0.0.0' to your IP that will be accessed in browser.

How to configure API endpoints.

You can change the RackHD API endpoint dynamically from the UI. Look for the settings link in the main navigation. This will open the Settings page where you can specify API endpoints.

The default API endpoints can be configured by renaming src/config/custom.json.example to src/config/custom.json, editing the API endpoint properties, and rebuilding the UI.

Note, that the endpoint URL is stored in your browsers local storage. This means that changing the default endpoint may not change the endpoint for your session. It is better to use the Settings page to update the endpoint in your browser.

How to build On Web UI applications.

$ npm run build         # Build `static/monorail.css` & `static/monorail.js` for production.

$ npm run build-css     # Build minified `static/monorail.css` from `less/monorail.less`.

$ npm run build-js      # Build production `static/monorail.js`.

Automated Testing.

Run unit tests powered by Karma, Mocha, and Chai, with Spies

Tests are designed to run in a real web browser such as Chrome or FireFox. By default Chrome must be present when running the tests.

$ npm test              # Or, `npm run-script test-ci` for Jenkins.

Test any javascript module by creating a __tests__/ directory where the file is. Name the test by appending -test.js to the JavaScript file.

Core Technologies

• BabelJS
• React
• Radium
• Material UI
• Webpack
• Karma

Licensing

Licensed under the Apache License, Version 2.0 (the “License”); you may not use this file except in compliance with the License. You may obtain a copy of the License at http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an “AS IS” BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.

RackHD is a Trademark of Dell EMC