Adding the Admin Console to Your CloudForms Menu

If you use Red Hat CloudForms, you can add the Admin Console to your CloudForms menu. When you click on the Admin Console from your CloudForms menu, the Admin Console appears in the CloudForms application. For information on Red Hat CloudForms, go to the Red Hat website, CloudForms.

Before You Begin

Add the additional settings needed to view the Admin Console in an iFrame. For instructions, see Viewing the Admin Console in an iFrame.

About This Task

Best Practice: Perform these steps on a test system. If you do not have access to a test system, make backup copies of all of the Red Hat files before you make changes to them.


  1. Go to the Red Hat /var/www/miq/vmdb/product/menubar directory, and create section and item configuration files:
    • Create a section file named commvault_section.yml with the following content:

      type: section
      name: Commvault Admin Console
      id: commvault_admin_console_menu
      icon: optional icon
      before: optional positioning in the menu
      section_type: big_iframe

      Note: The default placement of the Admin Console is at the end of the menu. Go to the permissions.yml file to find the value you need to populate the before parameter. For example, to place Admin Console before Automate in the CloudForms menu, add before: aut to the commvault_section.yml file.

    • Create an item file named commvault_item.yml with the following content:

      type: item
      name: Access
      id: admin_console_access
      feature: admin_console_access
      feature: admin_console_access
      parent: commvault_admin_console_menu
      href: the URL to your Admin Console
      item_type: big_iframe

  2. Go to the Red Hat /var/www/miq/vmdb/db/fixtures/miq_product_features directory, and create a menu configuration file:
    • Create a menu file named commvault_menu.yml with the following content:

      :name: Commvault
      :description: Access to the Commvault Admin Console
      :feature_type: node
      :parent: everything
      :identifier: commvault
      - :name: Access
      :description: access.commvault.admin.console
      :feature_type: node
      :identifier: admin_console_access

  3. Go to the Red Hat /var/www/miq/vmdb/db/fixtures/miq_product_roles/ directory, and add the identifiers from the commvault_menu.yml file to the redhat_access_user_roles.yml file:

    - existing identifiers
    - commvault
    - admin_console_access

  4. Go to the Red Hat /var/www/miq/vmdb/config directory, and add the ID from the commvault_section.yml file to the permissions.yml file:

    :existing section IDs

  5. Go to the Red Hat /var/www/miq/vmdb directory and run the following command:

    # RAILS_ENV=production rake assets:clean
    # RAILS_ENV=production rake assets:precompile
    # systemctl restart evmserverd

    Tip: If you receive an error, check the production.log file.


Commvault will appear as an entry in the CloudForms menu.

Related Topics

Branding the Admin Console

Last modified: 10/16/2018 9:26:43 PM