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. 

Comments

  1. UnknownFebruary 21, 2014 at 9:23 AM

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

    ReplyDelete
    Replies
    1. LeightonnFebruary 22, 2014 at 12:40 PM

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

      Delete
  2. UnknownFebruary 21, 2014 at 9:35 AM

    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. LeightonnFebruary 22, 2014 at 12:44 PM

      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

Post a Comment

Popular posts from this blog

Setup a Wordpress site in 10 Minutes using Oracle Container Cloud Service

Image
Oracle Container Cloud Service Oracle Container Cloud Service lets you easily deploy applications based on docker images. If you don't have an existing application you can create one on docker. However, the easiest method to get a full application up and running is by deploying a stack. Oracle Container Cloud Service provides several example stacks that you can deploy, including web servers based on NGINX or Apache, MongoDB database, and Wordpress. You can find more examples on Oracle GitHub Site . Let's see just how easy it is to spin up a Wordpress site using the Oracle Container Cloud Service. Prerequisites: Access to Oracle Cloud Account Subscription to Oracle IaaS Service First, go to the Oracle Container Cloud Service console and launch a new service. In this example, I created a service with three containers. One manager and two worker nodes. Choose an appropriate "shape" for your compute instances. Note: Oracle uses the term "shape" to r...
Read more

Oracle Home Cloning: Tools and Techniques

One of the many necessary and frequent tasks that a database administrator performs before creating a database is installing the Oracle database binaries. These binaries form what is known as an Oracle Home (referenced by the ORACLE_HOME environment variable on Linux and UNIX environments). Unfortunately, this is also one of the most mundane and uninteresting tasks a DBA can perform. So like all good DBAs know, the best way to deal with such repetitive task is to automate it. Automating installations of Oracle database binaries enables us to reliably repeat the process to enable faster installation as well as provide identical copies of the software in multiple environments. Fortunately, Oracle allows us to clone the Oracle database binaries from one environment to another. Cloning your Oracle binaries from a source copy with all the necessary patches applied enables us to have gold images which can then be deployed to multiple environments. The procedure for cloning an Oracle home...
Read more

Using XFS on Oracle Linux

Install xfs packages on Oracle Linux 6.6 via Oracle Public Yum [root@matthew ~]# yum install xfsprogs Loaded plugins: refresh-packagekit Setting up Install Process public_ol6_UEKR3_latest | 1.2 kB 00:00 public_ol6_UEK_latest | 1.2 kB 00:00 public_ol6_UEK_latest/primary | 19 MB 00:02 public_ol6_UEK_latest 407/407 public_ol6_addons | 1.2 kB 00:00 public_ol6_addons/primary | 77 kB 00:00 public_ol6_addons 269/269 public_ol6_latest | 1.4 kB 00:00 public_ol6_latest/primary | 46 MB 00:05 public_ol6_latest 29302/29302 http://public-yum.oracle.com/beta/repo/OracleLinux/OL6/uek3/x86_64/repodata/repomd.xml: [Errno 14] PYCURL ERROR 22 - "The requested URL returned error: 404 Not Found" Trying other mirror. Resolving Dependencies --> Running transaction check ---> Package xfsprogs.x86_64 0:3.1.11-1.0.5.el6 will be installed --> Finished Dependency Resolution Dependencies Resolved ===================================================================================================...
Read more