18 Support for Customization of Enterprise Manager Login Page

Enterprise Manager allows customization of the EM login page in order to accommodate corporate policies and standards.

This chapter covers the following topics:

18.1 Logo on Enterprise Manager Login Page

From EM 13c Release 3, a logo can be placed on the upper left corner of the Enterprise Manager login page. The supported image formats are jpeg, jpg, png, and gif. The logo ratio of the image file is adjusted according to the allocated space. The current size of the space provided is “width:200px;height:70px”. It is recommended to modify the logo image so that it fits into the space provided.

Figure 18-1 Modify the logo image to accommodate the allocated space

18.1.1 Setup Weblogic Server to Host Images

In order to load a custom logo image file on the Enterprise Manager login page, a web application containing the static image file needs to be deployed to the Weblogic domain on the Admin Server. For instructions on how to install a Web application, see https://docs.oracle.com/middleware/1213/wls/WLACH/taskhelp/web_applications/InstallWebApplications.html

To deploy the custom loge image file, perform the following steps:

On the OMS host, create a directory to store the logo image file to be used on the EM login page. For example, /u01/oracle/gc_inst/em/EMGC_OMS1/temp
Copy the logo image file to the newly created directory. For example, /u01/oracle/gc_inst/em/EMGC_OMS1/temp/custom_logo.png
In the newly created directory, create a WEB-INF directory. For example, /u01/oracle/gc_inst/em/EMGC_OMS1/temp/WEB-INF

In the WEB-INF directory create a file called web.xml with the following content:

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE web-app PUBLIC
"-//Sun Microsystems, Inc.//DTD Web Application 2.3//EN"
"http://java.sun.com/j2ee/dtds/web-app_2_3.dtd">
<web-app>
</web-app>

Login to the Weblogic console. Username by default is weblogic and password is the sysman password.

URL: https://host:port/console

Example: https://page.domain.com:7102/console

Note:
The Weblogic console URL (Admin Server URL) is not the same URL as the Enterprise Manager console. The host and the port are values specified in the AS_HOST and AS_HTTPS_PORT parameters, respectively, in the emgc.properties file. This properties file is available in the Oracle Management Service Instance Base location of the first OMS. For example, /u01/oracle/gc_inst/em/EMGC_OMS1/emgc.properties. The Admin Server URL can also be found in the <EM Home Dir>/install/setupinfo.txt file.
Enable ‘http’ port for the Admin Server. This can be done from the Admin Server settings.
1. From the tree view, expand Environment and then select Servers. Find and click EMGC_ADMINSERVER (admin) in the table.
2. Settings for EMGC_ADMINSERVER page opens. Go to the General Tab, if not opened already. Select the Listen Port Enabled check box.
3. Edit the port number as required. The default port number is 7001. The value of Listen Port will be the http port which will be used later to run the emctl command to set the image file.
4. Click Save. The following message appears at the top of the screen:
  
  All changes have been activated. No restarts are necessary.
  
  Settings updated successfully.
  
  Figure 18-2 Setting http listen port on the Weblogic Server Administration Console
Click Deployments menu at the left. The Install button is disabled by default.
Click Lock & Edit to enable the Install button.
In the Deployments screen, click the Install button.
Set the path to the directory created from Step 1 ( /u01/oracle/gc_inst/em/EMGC_OMS1/temp).
Click Next.
In the next screen, accept the default values for the selected options. By default Install this deployment as an application option will be selected.
Click Next.
In the next screen, select EMGC_ADMINSERVER as the target.
Click Next.
In the next screen, accept the default values.
Click Finish.

If the application is successfully deployed, the following message appears:

All changes have been activated. No restarts are necessary.

The deployment has been successfully installed.
Ensure that the status of the web application 'temp' deployed above is in 'Active' state. If not, click Activate Changes on the upper left corner to activate.
If the status of ‘temp’ appears as Prepared even after Step 18, select ‘temp’ from the table and click Start.

Note:
Ensure that the status of ‘temp’ appears ‘Active’ in the Deployments table.

Figure 18-3 Deploying a Web Application on the Weblogic Server Administration Console
Access the file path to ensure the the image appears on the browser screen.

URL: http://host:port/console/<newly created directory>/<logo image filename>

Example: http://page.domain.com:7001/temp/custom_logo.png

Note:
It is http and not https protocol which is referred in the url. Only http based image location is supported.

18.1.2 Run EMCTL Command to set the Logo Image

The login page logo can be set by using EMCTL commands. For more information, see Executing EMCTL Commands. OMS restart is not required to reflect the new property value.

The EMCTL command to set the logo image is:

emctl set property -name oracle.sysman.core.uifwk.loginPageLogo –value '<HTTP URL to the image file>' -sysman_pwd <sysman password>

For example,

emctl set property -name oracle.sysman.core.uifwk.loginPageLogo –value ‘http://page.domain.com:7001/temp/custom_logo.png’ -sysman_pwd password

Below is a sample output after running the EMCTL command to set the logo image:

bash-4.2$ ./emctl set property -name oracle.sysman.core.uifwk.loginPageLogo –value ‘http://page.domain.com:7001/temp/custom_logo.png’ -sysman_pwd password

Oracle Enterprise Manager Cloud Control 13c Release 3
Copyright (c) 1996, 2018 Oracle Corporation.  All rights reserved.
Property oracle.sysman.core.uifwk.loginPageLogo has been set to value http://page.domain.com:7001/temp/custom_logo.png for all Management Servers
OMS restart is not required to reflect the new property value

The EMCTL command to unset the logo image is:

emctl set property -name oracle.sysman.core.uifwk.loginPageLogo -value null -sysman_pwd <sysman password>

For example,

emctl set property -name oracle.sysman.core.uifwk.loginPageLogo -value null -sysman_pwd password

18.1.3 Access EM Login Page to see the Logo

From the browser, go to https://<hostname>:<port>/em/faces/logon/core-uifwk-console-login

Note:

You must clear the browser cache if you do not see the custom logo on the Enterprise Manager login page.

Figure 18-4 Enterprise Manager Login Page with Custom Logo

18.2 License Agreement Popup

A License Agreement popup can be configured to appear after the user clicks on the Login button from the Enterprise Manager login page. On pressing Login, a License Agreement popup message appears confirming the user whether they ‘Agree’ or ‘Disagree’. On pressing Agree the user will be able to successfully login. On pressing Disagree or Close, the user will stay in the login page. By default, the popup title is License Agreement and the button labels are Agree and Disagree. The License Agreement popup title, message, and the button labels are customizable using EMCTL commands. OMS restart is not required to reflect the new property value.

The EMCTL command to set the License Agreement popup title is:

emctl set property -name oracle.sysman.core.uifwk.licenseAgreementMessagePopupTitle -value ‘<popup title>' -sysman_pwd <sysman password>

For example,

emctl set property -name oracle.sysman.core.uifwk.licenseAgreementMessagePopupTitle -value ‘ABC Company License Agreement’ -sysman_pwd password

The EMCTL command to set the License Agreement popup message is:

emctl set property -name oracle.sysman.core.uifwk.licenseAgreementMessage -value ‘<popup message>’ -sysman_pwd <sysman password>

For example,

emctl set property -name oracle.sysman.core.uifwk.licenseAgreementMessage -value ‘Do you agree to the License Agreement?’ -sysman_pwd password

The popup message supports HTML tags. For a list of supported HTML tags, see https://docs.oracle.com/html/E12419_09/tagdoc/af_outputFormatted.html

For example,

emctl set property -name oracle.sysman.core.uifwk.licenseAgreementMessage -value '<H2 align=center>ABC Company </H2>
Warning: You are accessing a system operated by ABC Company. Unauthorized access or use of this system is prohibited and may constitute an offense under the Computer Misuse Act 1990. 
</b> <br><br> ABC Company will take appropriate actions if information is disclosed without prior authorization. This may include legal proceedings, prosecution and disciplinary action up to and including dismissal.
<br><br> <b>Click &quot;Agree&quot; if you are authorized to access this application and agree to the stated Terms of Service Agreement. 
</b>' -sysman_pwd password

The EMCTL command to unset the License Agreement popup message is:

emctl set property -name oracle.sysman.core.uifwk.licenseAgreementMessage -value null -sysman_pwd <sysman password>

For example,

emctl set property -name oracle.sysman.core.uifwk.licenseAgreementMessage -value null -sysman_pwd password

The EMCTL command to set the License Agreement popup’s agree button label is:

emctl set property -name oracle.sysman.core.uifwk.licenseAgreementMessageAgreeButton -value ‘<Agree button label>’ -sysman_pwd <sysman password>

For example,

emctl set property -name oracle.sysman.core.uifwk.licenseAgreementMessageAgreeButton -value ‘Yes’ -sysman_pwd password

The EMCTL command to set the License Agreement popup’s disagree button label is:

emctl set property -name oracle.sysman.core.uifwk.licenseAgreementMessageDisagreeButton -value '<Disagree button label>' -sysman_pwd <sysman password>

For example,

emctl set property -name oracle.sysman.core.uifwk.licenseAgreementMessageDisagreeButton -value ‘No’ -sysman_pwd password

Figure 18-5 Enterprise Manager License Agreement Popup

18.3 Informational Text on Enterprise Manager Login Page

An informational text can be placed to the left of the Enterprise Manager login fields. The Informational text can be used to provide contextual help with using the site. Some examples of usage include instructions to apply for access, password reset policy, and instructions for assistance. Similar to the License Agreement popup message, informational text also supports HTML tags. OMS restart is not required to reflect the new property value.

The EMCTL command to set the informational text is:

emctl set property -name oracle.sysman.core.uifwk.loginPageInformationText -value ‘<informational text>’ -sysman_pwd <sysman password>

For example,

emctl set property -name oracle.sysman.core.uifwk.loginPageInformationText -value ‘<b> Please use your IUSER credentials to log into OEM </b> <br><br> For lost/forgotten passwords, please use the reset facility: http://page.domain.com <br><br> To apply for access please complete this application form: http://page.domain.com <br>' -sysman_pwd password

The EMCTL command to unset the informational text is:

emctl set property -name oracle.sysman.core.uifwk.loginPageInformationText -value null -sysman_pwd <sysman password>

For example,

emctl set property -name oracle.sysman.core.uifwk.loginPageInformationText -value null -sysman_pwd password

Figure 18-6 Enterprise Manager Login Page Informational Text