fuel-plugin-openbook/doc/source/guide.rst

3.8 KiB
Raw Blame History

User Guide

Plugin configuration

  1. Create a new environment with the Fuel UI wizard. At the moment only the Ubuntu distribution is supported.

    Note

    Please note the Ceilometer service is not required for all Openbook use cases. Where Ceilometer is not available or has been disabled, you still have the ability to bill for service instances such as instances, volumes, or floating IPs in intervals of 15 minutes (service instances created and deleted within the 15 minute interval will not be billed). In this circumstance, unselect the incremental sync, and decrease the interval for the full resync.

    With Ceilometer, you have the ability to bill for service instances in intervals of a second or ability to bill for metered resources such as network bandwidth, object storage bytes on disk.

  2. Click on the Settings tab of the Fuel web UI.

    Select "Other", enable the plugin by clicking on the "Openbook Plugin" checkbox and fill-in the required fields (default for 'database password' is Tall!g3nt):

    A screenshot of the Openbook Plugin settings UI for 8.0

  3. Click Save Settings at the bottom of the page to save the configuration parameters.

  4. Switch to the Nodes tab.

  5. After adding all OpenStack nodes/roles, add an Openbook node (optional: rename to something meaningful, such as "openbook"):

    A screenshot of the Openbook host name

  6. Select the Networks tab, select Connectivity Check, and Verify Networks.

  7. Then finally, Deploy Changes.

Plugin Install Verification

Once the deployment is finished, the Dashboard tab will display the "Success" notification, stating that the plugin is deployed and will give the URL schema for accessing the Openbook UI.

A screenshot of the Dashboard Success notification

Use the fuel command line to retrieve the IP address of the openbook node.

[root@fuel ~]# fuel nodes
id | status   | name          | cluster | ip        | [..] | roles             | [..] 
---|----------|---------------|---------|-----------|------|-------------------|------
2  | ready    | compute-01    | 2       | 10.20.0.4 |      | cinder, compute   |      
1  | ready    | controller-01 | 2       | 10.20.0.3 |      | controller        |      
3  | ready    | openbook      | 2       | 10.20.0.5 |      | openbook          |      
.. | .....    | ..............| ...     | ......... |      | ...............   |      

In this example, the Openbook UI would be accessed at https://10.20.0.5:8443/Openbook

Using Openbook

Official documentation for various features of Openbook can be found below.