23.3 The Theming Configuration File

When Cloud Manager components are called and their respective graphical interfaces rendered, Cloud Manager first looks at /etc/cloudmanager-themes.cfg, a configuration file that the theming system applies to a defined object (such as an organization). The default contents of the file are shown below:

server.theme = CloudManager
server.productname = NetIQ Cloud Manager
server.shortproductname = Cloud Manager
server.producturl = http://localhost:8182/CloudManager

These lines define the name you want to apply to the product throughout your theme, along with a URL link to the login of the Cloud Manager Application Server (a convenient way to embed server access into an email message).

This default theme is applied universally throughout the product, unless you create a new theme. You can do this by changing the values inside cloudmanager-themes.cfg, for example:

server.theme = DigitalAirCloudServices 
server.productname = Digital Airlines Cloud Services 
server.shortproductname = DAL Cloud 
server.producturl = http://cloud.dal.com 

NOTE:You should change only the contents of cloudmanager-themes.cfg when you want to use a new global theme. Do not change the name of the file.

You can also change the configuration file to discretely associate a new theme to the object where you want it applied. For example, if you create a new theme called “AcmeCloudServices” (a customized copy of the CloudManager theme), you might modify /etc/cloudmanager-themes.cfg to look like this:

server.theme = CloudManager
server.productname = NetIQ Cloud Manager
server.shortproductname = Cloud Manager
server.producturl = http://localhost:8182/CloudManager

164.theme = AcmeCloudServices
164.productname = Acme Cloud Services
164.server.shortproductname = Acme Cloud
164.server.producturl = http://localhost:8182/AcmeCloud

In the example above, the second section provides customization information for an organization with an ID of 164. This informs Cloud Manager that when a user from the “Acme” organization (164) logs in, he or she will see the branding defined in the AcmeCloudServices theme.

You can add as many new theming sections to the configuration file as you want.

HINT:To obtain a list of all the organizations in your Cloud Manager system, open a browser to this URL:

<your_cloudmanager_server:port>/cloudmanager-api/organizations

This URL displays a report of all the organizations in your Cloud Manager system, along with their respective Cloud Manager IDs.

You can also find the organization ID for an individual organization on the Edit Organization dialog in the Application Server Console.