27.0 Rebranding the Cloud Marketplace Mobile App

If you want users of the Cloud Marketplace mobile app for iPad to see proprietary branding of Cloud Manager customized for their organization, you need to copy the re-themed resources (that is, proprietary text and graphics) to the Cloud Manager Application Server.

NetIQ Cloud Marketplace uses images installed on the Cloud Manager Application Server to rebrand its user interface. The default images you can use to re-theme Marketplace are located in a downloadable.zip file at the NetIQ Cloud Manager documentation website.

To re-theme these images:

  1. Extract the contents of the .zip file.

  2. Evaluate the contents. You can change the colors, the logo, and the product name (embedded in the .json file) in your re-theming. Some things to remember:

    • When a graphic designer creates the new brand images, the image size, format, and filename must remain the same. The image resources can help the designer maintain these criteria.

  3. After you customize the images to match your own branding, save them and compress them in a file named marketplace_rebrand.zip.

    NOTE:Remember to save the rebranding files in a flat hierarchy; there should be no folder inside the .zip file.

  4. Upload your marketplace_rebrand.zip file to the Cloud Manager Application Server at

    /opt/netiq/cloudmanager/themes/CloudManager/en/mobile/marketplace_rebrand.zip

    You must create this file path if it does not already exist.

  5. Verify that the images display properly in the Cloud Marketplace app.

    A Cloud Manager Application servlet serves up marketplace_rebrand.zip. When the Cloud Marketplace iPad app launches, it retrieves this .zip file, extracts it and uses the images and information within to change its appearance.

    You can check the contents of the newly themed .zip file from a browser at

    http://<cloud_manager_application_server>/theme/mobile/marketplace_rebrand.zip

  6. If the servlet attempts to find the file and fails, or if the image you replaced displays incorrectly in Marketplace, you need to use the following Karaf command to flush the cache and refresh it with a new image from the marketplace_rebrand.zip file:

    cm:flush-branding-resources-cache
    

NOTE:The language aspect of Marketplace rebranding is determined by headers that the Marketplace client provides to the server. The theme name is based on the hostname that the iPad application uses to access the server. The server can be configured to respond to several virtual host names, and each can have its own theme.

For more information, see Section 24.1, Additional Theming Infrastructure.