Welcome to the CloudForms Essentials Project

This project was designed to augment Red Hat ® CloudForms installations.

Current supported appliance version: 5.5.x

This repo contains imports for the following areas of the product:

• Automate

• Dialogs

• Buttons

• Reports

• Control

• Alerts

• Roles

• Service_Catalogs

[top]

More documentation can be found here: Docs

Installation Instructions

• Download the repo at CloudForms Essentials

• Extract to a temporary location your desktop

• Use instructions in following sections as applicable to your use cases

  • Automate

  • Dialogs

  • Reports

  • Control

  • Alerts

  • Buttons

  • Roles

  • Service_Catalogs

  • Rake Import

[top]

Automate

Automate domain contains enhancements for IT Process automation, lifecycle provisioning, integrations with providers that Red Hat CloudForms currently supports i.e. EC2, vCenter, RHEV, Satellite, OpenStack, etc…​

Important

3rd party integrations will be included in a separate repo in the near future.

Follow these steps to install the CloudForms_Essentials automate domain:

1. Compress/zip the Automate / CloudForms_Essentials directory

2. Log into your CloudForms/ManageIQ UI as an administrator

3. Navigate to Automate / ImportExport

4. Upload the zip file. This can take 60-90 seconds.

5. When done, navigate to Automate / Explorer

6. You will need to edit the new CloudForms_Essentials domain and check the "enable" box.

7. The CloudForms_Essentials automate domain is ready to use!.

Tip	The CloudForms_Essentials automate model is locked by default. To modify something simply create a new domain and copy the moethod, class, etc…​ to the new domain. This preserves the domain and makes it easy to see what changes were made. Great for PRs!

[top]

Dialogs

Sample service dialogs for provisioning VMs and performing other tasks via custom buttons.

Follow these steps to install the CloudForms_Essentials dialogs:

1. Log into your CloudForms/ManageIQ UI as an administrator

2. Navigate to Automate / Customization / ImportExport (This is located in the bottom left of your accordion)

3. Import the dialog(s) in the Dialog director

[top]

Reports

Sample reports and dashboard widgets.

Follow these steps to install the CloudForms_Essentials reports:

1. Log into your CloudForms/ManageIQ UI as an administrator

2. Navigate to Cloud Intelligence / Reports / ImportExport (This is located in the bottom left of your accordion)

3. Import the reports(s) in the Reports directory

4. Import the widgets(s) in the Reports directory

[top]

Control

Sample policies that perform event drive actions.

Follow these steps to install the CloudForms_Essentials control policies:

1. Log into your CloudForms/ManageIQ UI as an administrator

2. Navigate to Control / ImportExport.

3. Import the Policies.yml found in the Alerts directory

[top]

Alerts

Sample alerts that perform actions.

Follow these steps to install the CloudForms_Essentials alerts:

1. Log into your CloudForms/ManageIQ UI as an administrator

2. Navigate to Control / ImportExport.

3. Import the Alerts.yml found in the Alerts directory

[top]

Buttons

Sample buttons to perform day-2 operations for various object types.

Follow these steps to install the CloudForms_Essentials buttons:

Note	You must complete the pre-req step and have the import utility & scripts installed. This process is documented here.

1. Use your utility of choice (i.e. scp) to upload the buttons/buttons.yml to the CloudForms/ManageIQ appliance

2. Log into your appliance console as root

3. Import the buttons using the miqimport utility:

   /usr/bin/miqimport buttons /<full-path-to-upload-directory>/buttons.yml

[top]

Roles

Sample roles for self-service users.

Follow these steps to install the CloudForms_Essentials roles:

Note	You must complete the pre-req step and have the import utility & scripts installed. This process is documented here.

1. Use your utility of choice (i.e. scp) to upload the roles/roles.yml to the CloudForms/ManageIQ appliance

2. Log into your appliance console as root

3. Import the roles using the miqimport utility:

   /usr/bin/miqimport roles /<full-path-to-upload-directory>/roles.yml

[top]

Service_Catalogs

Sample preconfigured service catalog items for you to work with.

Follow these steps to install the CloudForms_Essentials services:

Note	You must complete the pre-req step and have the import utility & scripts installed. This process is documented here.

1. Use your utility of choice (i.e. scp) to upload the service_catalogs/*.yml to the CloudForms/ManageIQ appliance

2. Log into your appliance console as root

3. Import the catalogs using the miqimport utility:

   /usr/bin/miqimport service_catalogs /<full-path-to-upload-directory>

Note	service_catalogs import will look at all yaml files in a directory, so you do not need to specify individual files.

[top]

Rake Import

The rake scripts are required in order to import some of the items referenced on this page when a UI is not available.

Follow these steps to install the miqimport/miqexport utilities:

1. Install git on the CFME appliance

2. While in /root directory, clone the rhconsulting repository:

   git clone https://github.com/rhtconsulting/cfme-rhconsulting-scripts.git

3. In the newly created /root/cfme-rhconsulting-scripts directory, install the rake scripts and utilities:

   make install

The /usr/bin/miqimport and /usr/bin/miqexport utilities are now available to assist you when importing and exporting from CFME.

[top]