Thursday, February 20, 2014

Configuring Self-Service Login Page

Oracle Enterprise Manager Cloud Control 12c allows us to customize the page that self service users see when logging in instead of the usual EM Console login page. This is useful for Cloud Providers who offer private cloud services to their clients. With just a few small steps you can have your own customized login  page.

Enable the SSA login page
$ emctl set property -name oracle.sysman.ssa.logon.ssa_oms -value true
Oracle Enterprise Manager Cloud Control 12c Release 2
Copyright (c) 1996, 2012 Oracle Corporation.  All rights reserved.
SYSMAN password:
Property oracle.sysman.ssa.logon.ssa_oms for oms oms.example.com:4889_Management_Service has been set to value true

OMS restart is required to reflect the new property value

Set a custom alternate text message for the Cloud Provider on the login page. 
$ emctl set property -name oracle.sysman.ssa.logon.cloud_provider_alt_text -value "Nelson Cloud Provider"
Oracle Enterprise Manager Cloud Control 12c Release 2
Copyright (c) 1996, 2012 Oracle Corporation.  All rights reserved.
SYSMAN password:
Property oracle.sysman.ssa.logon.cloud_provider_alt_text has been set to value Nelson Cloud Provider for all Management Servers
OMS restart is required to reflect the new property value

Set a custom alternate text message for the tenant on the login page:
$ emctl set property -name oracle.sysman.ssa.logon.cloud_tenant_alt_text -value "Nelson Cloud Tenant"
Oracle Enterprise Manager Cloud Control 12c Release 2
Copyright (c) 1996, 2012 Oracle Corporation.  All rights reserved.
SYSMAN password:
Property oracle.sysman.ssa.logon.cloud_tenant_alt_text has been set to value Nelson Cloud Tenant for all Management Servers
OMS restart is required to reflect the new property value

After restarting the OMS the SSA login page should look like the one in the figure below.

Figure 1. SSA login page with custom text

Enable Cloud Provider logos
$emctl set property -name oracle.sysman.ssa.logon.show_cloud_provider_brand -value true
Oracle Enterprise Manager Cloud Control 12c Release 2
Copyright (c) 1996, 2012 Oracle Corporation.  All rights reserved.
SYSMAN password:
Property oracle.sysman.ssa.logon.show_cloud_provider_brand has been set to value true for all Management Servers
OMS restart is required to reflect the new property value

Enable Cloud Tenant logos
$ emctl set property -name oracle.sysman.ssa.logon.show_cloud_tenant_brand -value true
Oracle Enterprise Manager Cloud Control 12c Release 2
Copyright (c) 1996, 2012 Oracle Corporation.  All rights reserved.
SYSMAN password:
Property oracle.sysman.ssa.logon.show_cloud_tenant_brand has been set to value true for all Management Servers
OMS restart is required to reflect the new property value
Restart OMS

The following logos are required:
  • cloud_provider_small_brand.png 
  • cloud_tenant_small_brand.png
  • cloud_provider_large_brand.png
  • cloud_tenant_large_brand.png
The two _small_ logos appear as headers in the login portal and the two _large_ logos appear on the login page. If two _small_ logos are used then they should be less than 200 * 20 px each. If a single _small_ image is used then it should be less than 500 * 20 px.
The _large_ logos should be less than 250 * 50 px if two images are used or less than 525 * 50 px for a single image.

Copy logos to $ORACLE_HOME/sysman/config
$ pwd
/u01/app/oracle/Middleware/oms/sysman/config
$ ls *.png
cloud_provider_large_brand.png  cloud_provider_small_brand.png  cloud_tenant_large_brand.png  cloud_tenant_small_brand.png
[oracle@oms config]$ file cloud_provider_small_brand.png
cloud_provider_small_brand.png: PNG image data, 195 x 19, 8-bit/color RGB, non-interlaced
[oracle@oms config]$ file cloud_tenant_small_brand.png
cloud_tenant_small_brand.png: PNG image data, 195 x 15, 8-bit/color RGB, non-interlaced

After restarting the OMS the login page should display the logos similar to the one in the figure below.

Figure 2. SSA login page with Cloud Provider and Tenant Logos
You can also add a disclaimer text and copyright text. Unfortunately, other attributes such as background colors and custom style sheets cannot be modified but hopefully this will  be enhanced in future versions. 

4 comments:

  1. Is Nelson Corp hiring? :) Great post Leighton!!

    ReplyDelete
    Replies
    1. Thanks Maaz.
      As soon as they do you'll be the first to know :).

      Delete
  2. How does this affect non-self service users (like DBAs and OEM admins)? Does force everyone login this way or is there a separate URL for self-service?

    ReplyDelete
    Replies
    1. Hi Ray,
      From what I can tell all users including non-SSA users will access the same login page. However, after logging in they'll see the usual EM Console based on their privileges.

      Delete