Merge lp:~talligent/charms/trusty/openbook/trunk into lp:charms/trusty/openbook

[Jeremy Fluhmann]

updated README and metadata with newer descriptions and tags

[Review Queue (review-queue)]

This item has failed automated testing! Results available here http://juju-ci.vapour.ws:8080/job/charm-bundle-test-lxc/1852/

review: Needs Fixing (automated testing)

[Review Queue (review-queue)]

The results (PASS) are in and available here: http://juju-ci.vapour.ws:8080/job/charm-bundle-test-aws/1832/

review: Approve (automated testing)

[José Antonio Rey (jose)]

Hey!

First of all, thank you for the reading improvements for the README of the OpenBook charm. I wanted to point out a couple things.

When you are using long dashes, they are not rendering correctly, meaning it can cause troubles with UTF-8 // ASCII people when reading on their browsers. I would suggest changing them for short dashes instead.

On the other hand, you are adding some tags to the metadata.yaml file. However, the only supported tags are the ones found at https://jujucharms.com/docs/stable/authors-charm-metadata. Please remove the ones that are not available for charm store categorization.

Apart from that, it all looks good. The README.md file does render correctly (aside from the dashes). Hope to see the next iteration of this soon!

review: Needs Fixing

[Andrew McLeod (admcleod)]

Hi Jeremy,

I've re-reviewed this - and regarding the tags - although they should also be changed to "approved" tags so we can ensure consistency in the charm store, I don't believe this should block this merge request. Similarly, with the long dashes, they should also be fixed, but this shouldn't block the merge either. If you could change this, that would be great, but regardless I am willing to give this my +1.

Andrew

review: Approve

[Charles Butler (lazypower)]

Thanks for the submission Jeremy!

I've taken Adam's feedback and taken the liberty of merging this proposal. It should be live in the charm store for consumption within the next hour.

All the best!

review: Approve

=== modified file 'README.md'
--- README.md	2015-08-12 22:29:23 +0000
+++ README.md	2015-12-14 22:39:20 +0000
@@ -1,83 +1,110 @@
 #Openbook
 
-[Openbook](http://talligent.com/) reliably solves the customer lifecycle of
-onboarding, self-service, and cloud billing or charge-back with minimal
-manual intervention.
-
-IT service delivery models are changing quickly – you need a solution that
-has the flexibility to keep ahead of the pack and differentiate your cloud.
-Whether you are a service provider billing customers for cloud services, or
-an enterprise needing showback and tenant self-service, Talligent delivers
-a fully-functional, simple to use cloud management solution that has been
-built specifically for OpenStack.
-
-OpenBook – Measure, manage and monetize clouds built on OpenStack
+[Openbook](http://talligent.com/) reliably solves the customer lifecycle of 
+onboarding, self-service, and cloud billing or charge-back with minimal manual 
+intervention. Whether you are a service provider billing customers for cloud 
+services, or an enterprise needing showback and tenant self-service, Talligent 
+delivers a fully-functional, simple to use cloud management solution that has 
+been built specifically for OpenStack.
+
+Enterprise adoption of OpenStack is growing quickly, driven by the interest 
+in providing on-demand cloud services behind the firewall. Private cloud 
+deployments increase the agility of IT departments to respond to infrastructure
+requests, increase control of company digital assets, and reduce the need for 
+shadow IT services from public cloud providers. In response to this increase 
+in market demand, Talligent has added functionality to support private cloud 
+use cases such as chargeback, utilization tracking for sprawl control, single 
+pane of glass view of hybrid clouds, and capacity reporting to improve resource
+and budget planning of cloud growth.
 
 #Overview
 
-##About Talligent OpenBook Customer Management Solution
-
-Whether you are a service provider billing tenants for cloud services, or an
-enterprise needing showback and customer self-service, Talligent delivers a
-fully-functional, simple to use cloud management solution that has been built
-specifically for OpenStack.
-
-##Intelligent Cloud Reporting
-
-OpenBook creates an independent and detailed historical record of your cloud
-configuration and tenant resource consumption. With an intuitive graph view of
-resource assignments, administrators can answer questions about overall cloud
-utilization and costs as well as drill down to the specific details that comprise
-a particular bill for audit purposes, or show license count of software applications.
-
-##Robust Billing & Showback
-
-The OpenBook Billing Engine offers a sophisticated cloud billing platform, with granular
-rate plans for various personas of tenants and usage patterns, supporting billing,
-chargeback or showback for private or public clouds. Resellers experience the same range
-of flexibility as the root cloud owner. Invoice and cost accounting information can easily
-be shared with CRM and accounting packages via Rest-based APIs. Rate plans can be as simple
-as a flat monthly charge per instance or can be fairly complex packages that include tiered
-resource usage, operating system and application surchanges, and service level prices.
-
-##Self-Service Automation
-
-Talligent provides delegated administration and customer self-service for a true on-demand
-cloud. Using deep integration, OpenBook takes full advantage of the OpenStack platform for
-the automated provisioning of cloud projects and tenants. Resource efficiency is increased
-and service response times are reduced.
-
-##OpenBook Key Features
-OpenBook provides functionality for a complete automated customer lifecycle in the Openstack
-cloud environment.  This functionality is designed to support public or private cloud deployments;
-billing, chargeback or showback reporting; and direct to customer or reseller channels.  Users
-can register new accounts, manage users at the project level, view unbilled charges and past
-invoices, and pay their bill all through the OpenBook interface.  Key features of the OpenBook
-tenant lifecycle solution include:
-
-*	On-boarding the cloud tenant within OpenStack via OpenBook self-registration portal.
-*	Measuring cloud resource usage via integration with Ceilometer and other resources like Nova,
-    Swift, and Cinder.  A detailed historical record of the environment is stored in the OpenBook database.
-*	Applying a flexible rate plan at any level of the tenant hierarchy.  Resellers are assigned a resource
-    quota within the OpenStack environment.  Within that subset, resellers have full autonomy to sign up customers,
-    create rate plans and set prices independent of the master cloud provider.
-*	Calculating charges that include local taxes, foreign currency support, marketing promotions, and discounts.
-*	Generating an invoice that can be emailed, printed, or integrated with a payment gateway of choice.  The cloud
-    invoice information can be shared with legacy CRM or billing solutions and integrated into a master invoice
-    for the customer.
-*	Reporting of aggregated usage statics and unbilled charges via the CIO dashboard for forecasting, capacity
-    planning, and customer management.
+##About Talligent Openbook
+
+Talligent delivers a fully-functional, simple to use cloud management solution 
+that has been built specifically for OpenStack. The functionality is designed 
+to support public or private cloud deployments; billing, chargeback or showback 
+reporting; and direct to customer or reseller channels. Users can register new 
+accounts, manage users at the project level, view unbilled charges and past 
+invoices, and pay their bill all through the Openbook interface. Key features of
+the Openbook tenant lifecycle solution include:
+
+For the Enterprise private cloud:
+
+*	On Demand Cloud Infrastructure: Openbook enables enterprises to provide 
+    on demand cloud services based on the OpenStack platform. This includes 
+    dedicated instances, networks, storage, applications, virtual desktops, and 
+    other infrastructure elements or services.
+
+*	Capacity Planning: Without visibility into the growth of cloud services 
+    by department, it is impossible to accurately predict how much new capacity 
+    to add, and when. Detailed reports of growth trends and seasonal patterns 
+    allow you to better plan for new capacity. Forecasts of the cost of cloud 
+    projects is coming soon.
+
+*	Single Solution: We do OpenStack well but also know that you have other 
+    services to account for. Our RestAPI allows you to push additional 
+    infrastructure elements into Openbook for inclusion into the rate plans. A 
+    VMware adapter allows you to compare costs across your private hybrid cloud 
+    environment. All cost information can be easily shared with legacy 
+    accounting systems for detailed budget planning.
+
+*	KPIs: Quickly answer key management questions about your environment – 
+    largest tenants, service growth, and accrued costs. Ad hoc reporting allows 
+    you to drill down to the relevant details of your cloud environment
+
+*	Showback/Chargeback: Openbook has a robust ratings engine tuned to 
+    OpenStack and VMware clouds. Costs can be assigned by tenant, business unit,
+    VP, project, or other cost center. Managers are automatically updated on
+    their accrued costs as well as performance against budget
+
+*	Sprawl Control: Reduce VM sprawl and help your internal users be better
+    stewards of the environment by giving them the visibility and tools to
+    control resources assigned to them. Openbook tracks orphaned entities and
+    underutilized instances to keep your cloud clean.
+
+For Service Providers:
+
+*	Simple to Deploy: No custom coding and integration is required for
+    Openbook to take full advantage of the power and flexibility of OpenStack.
+    You can be up and running in just a few minutes without engaging expensive
+    developers or OpenStack resources
+
+*	Sell On Demand Cloud Infrastructure: Openbook enables you to sell the
+    cloud services you want and customers demand. This includes dedicated
+    instances, networks, storage, applications, virtual desktops, and other
+    infrastructure elements or services. Services can be packaged by tiers,
+    metered and sold by the hour, delivered on-site or as part of a shared
+    infrastructure.
+
+*	Customer Self Service: Talligent self-service means that customers can
+    log into the portal at any time and view the resources they have
+    provisioned, costs accrued to date, past and present invoices, payment
+    status and account details. Customers can make quota change requests to
+    align resources with billing and project needs. Workflow is automatically
+    routed to the admin for processing, eliminating ticketing and speeding
+    responses.
+
+*	Reseller Workflow: Cloud service providers can expand their customer
+    reach and strengthen their existing relationship via resellers. Openbook
+    natively supports reseller workflow with corresponding rate plans that
+    support taxation, currency conversion, proration, discounts, and promotional
+    codes independent from the master service provider.
+
+*	Customize and Brand: Openbook is a full white label solution. Service
+    providers can change the look and feel of the solution to support their
+    brand. Resellers likewise can independently customize the look and feel of
+    the interface and customer communications.
 
 ##Product documentation
 
 Additional documentation can be found online:
 
-* [OpenBook QuickStart guide](http://www.talligent.com/OpenBook_Quick_Start_Guide.pdf)
-* [OpenBook API Instructions](http://www.talligent.com/Talligent_API_instructions_OpenBook_v2.0.pdf)
-* [OpenBook HA Configuration](http://www.talligent.com/Openbook_HA_8-2014.pdf)
+* [Openbook QuickStart guide](http://talligent.com/wp-content/uploads/2015/12/Openbook-Installation-Guide-12-2015-v3.pdf)
+* API documentation can be found after installation via this URL - /Openbook/resource/apidoc
 
 ##Subscription
-Talligent can offer a subscription for those who want to use OpenBook for production. Contact us for more
+Talligent offers a 12 month subscription license for those who want to use Openbook for production. Contact us for more
 information – [e-mail].
 
 
@@ -112,21 +139,21 @@
 page at: https://IP_ADDRESS:8443/Openbook/ Where IP_ADDRESS is the public address
 of the tomcat container and can be found by typing `juju status tomcat`.
 
-The initial username and password is openbook/Tall!g3nt.  Please refer to the "Initial
-Configuration for OpenStack Integration" section of the [OpenBook QuickStart guide](http://www.talligent.com/OpenBook_Quick_Start_Guide.pdf)
-for more details on how to get started with Openbook.
+The initial username and password is openbook/Tall!g3nt.  Please refer to the 
+[Openbook installation guide](http://talligent.com/wp-content/uploads/2015/12/Openbook-Installation-Guide-12-2015-v3.pdf) for more details on how to get started 
+with Openbook.
 
 ##Scale out Usage
 For high availability, we recommend a standard two-tier web-app redundant configuration.
 
 ##Known Limitations and Issues
-This release of OpenBook is meant for evaluation purposes only and will violate the license
+This release of Openbook is meant for evaluation purposes only and will violate the license
 terms if used in a production environment. There is no limitation in features of the product.
 
 
 ##Contact Information
 
-More information about Openbook can be found at:
+For more information about Openbook, please drop us a note at [e-mail] or visit our website at:
 
 * [Talligent Website](http://talligent.com/)
 

=== modified file 'metadata.yaml'
--- metadata.yaml	2015-02-04 20:52:08 +0000
+++ metadata.yaml	2015-12-14 22:39:20 +0000
@@ -3,14 +3,24 @@
   Openbook billing engine for OpenStack
 maintainer: Michael Garza <[e-mail]>
 description: >
-  The OpenBook Billing Engine offers a sophisticated cloud billing platform, with granular rate plans for
-  various personas of tenants and usage patterns, supporting billing, chargeback or showback for private or
-  public clouds. Resellers experience the same range of flexibility as the root cloud owner. Invoice and cost
-  accounting information can easily be shared with CRM and accounting packages via Rest-based APIs.
+  Openbook by Talligent is cloud management software that simplifies the tasks of planning, charging,
+  and predicting capacity requirements for cloud services. Talligent gives the administrator and tenant
+  real-time visibility of resources and accrued costs, as well as the ability to scale up or down
+  according to budget and resource requirements. The Openbook Billing Engine offers a sophisticated
+  cloud billing platform, with granular rate plans for various personas of tenants and usage patterns,
+  supporting billing, chargeback or showback for private or public clouds. Resellers experience the
+  same range of flexibility as the root cloud owner. Invoice and cost accounting information can easily
+  be shared with CRM and accounting packages via Rest-based APIs.
 subordinate: true
 tags:
   - openstack
   - monitoring
+  - billing
+  - chargeback
+  - reporting
+  - showback
+  - capacity_planning
+  - sprawl_control
 requires:
   juju-info:
     interface: juju-info