Clarify where npm install must be run

There was some confusion on this at the hackathon. People
were running this prior to cloning the git repository which
then resulted in issues with the run-script server command
later.

Change-Id: I7f13f7dd90899d0b64ccd83f19a9a2eb0e10cf1e
Signed-off-by: Andrew Geissler <geissonator@yahoo.com>
1 file changed
tree: 340a1c6b1fd49cbee2a6d6e91d8489c705398d23
  1. app/
  2. gulp_tasks/
  3. .babelrc
  4. .clang-format
  5. .gitignore
  6. bower.json
  7. config.json
  8. format-code.sh
  9. gulp-options.js
  10. gulpfile.js
  11. karma.conf.js
  12. LICENSE
  13. MAINTAINERS
  14. package-lock.json
  15. package.json
  16. postcss.config.js
  17. README.md
  18. sonar-project.properties
  19. webpack.config.js
README.md

OpenBMC Web User Interface

The OpenBMC WebUI is a Web-based user interface for the OpenBMC firmware stack. The WebUI uses AngularJS. Features include:

  • View system overview data such as model information and serial number
  • View and manage event logs
  • View inventory data
  • View sensor data
  • Power On/Off server operations
  • Reboot BMC
  • Manage and update BMC and Host firmware
  • IPv4 network settings
  • SoL console

Requirements

nodejs npm

Installation

npm install

Note This must be run from within the phosphor-webui git repository.

Running locally

npm run-script server

This will start a server instance and begin listening for connections at http://localhost:8080. This development server provides live reloading on code changes. NOTE: Browsing to https://<BMC> and accepting the self-signed certificate might be required to prevent your browser from blocking traffic to the BMC.

Logging in

Enter the BMC Host or BMC IP address, username, and password. The default username and password are root/0penBmc.

Note that some OpenBMC implementations use bmcweb for its backend. For security reasons, bmcweb will need to be recompiled and loaded onto the target BMC Host before the above redirect command will work. The option to turn on within bmcweb is BMCWEB_INSECURE_DISABLE_XSS_PREVENTION.