ManageIQ Self Service UI

The Service UI (SUI) previously Self Service UI (SSUI), for the ManageIQ project.

Developer Setup

Logging in to the SUI requires a running instance of ManageIQ. Instructions on how to install ManageIQ can be found here.

Install Repository and Prerequisites

• Have the ManageIQ repo cloned into a directory named manageiq, and ready to be started. See here for the steps reqiured to setup ManageIQ.
• Have this repo as a sibling to the manageiq directory: git clone [email protected]:ManageIQ/manageiq-ui-self_service.git.
• Have nodejs v6.7.0 and npm 3.10.3 installed (NVM is a popular solution to manage node and npm versions).
• Have bower and gulp globally installed.
  • npm install -g bower gulp

Install Dependencies

• cd manageiq-ui-self_service
• npm install
• bower install

Setup

• From the manageiq-ui-self_service directory, build the production version of the SUI. This task will compile the assets and drop them into the manageiq/public/self_service directory.
  • gulp build

Deployment

• From the manageiq directory, start the ManageIQ application to initiate the server listening on http://localhost:3000 order and serve up the REST API. Either one of the following commands can be used.

  • bundle exec rails server
  • bundle exec rake evm:start

• From the manageiq-ui-self_service directory, start the development version of the self service UI, which will initiate the UI listening on http://localhost:3001, and talking to the REST API at http://[::1]:3000. This command will also open a browser page to http://localhost:3001/self_service/login.

  • gulp serve-dev

Troubleshooting

• When running ManageIQ with bundle exec rake evm:start, it may be necessary to override the REST API host via a PROXY_HOST environment variable.

  • PROXY_HOST=127.0.0.1:3000 gulp serve-dev

• ActiveRecord::ConnectionTimeoutError: could not obtain a connection from the pool within 5.000 seconds; all pooled connections were in use or Error: socket hang up or Error: connect ECONNREFUSED might be caused to by lower than expected connection pool size this is remedied by navigating to manageiq/config/database.yml and increasing the pool: xx value.

• For a full list of gulp tasks available to the SUI.

  • gulp help

Documentation

• Coding Style and Standards
• Internationalization Guidelines
• Complete ManageIQ Documentation

License

See LICENSE.txt

Export Notice

By downloading ManageIQ software, you acknowledge that you understand all of the following: ManageIQ software and technical information may be subject to the U.S. Export Administration Regulations (the "EAR") and other U.S. and foreign laws and may not be exported, re-exported or transferred (a) to any country listed in Country Group E:1 in Supplement No. 1 to part 740 of the EAR (currently, Cuba, Iran, North Korea, Sudan & Syria); (b) to any prohibited destination or to any end user who has been prohibited from participating in U.S. export transactions by any federal agency of the U.S. government; or (c) for use in connection with the design, development or production of nuclear, chemical or biological weapons, or rocket systems, space launch vehicles, or sounding rockets, or unmanned air vehicle systems. You may not download ManageIQ software or technical information if you are located in one of these countries or otherwise subject to these restrictions. You may not provide ManageIQ software or technical information to individuals or entities located in one of these countries or otherwise subject to these restrictions. You are also responsible for compliance with foreign law requirements applicable to the import, export and use of ManageIQ software and technical information.