WebUI: How to customize colors and/or logo in 12.x releases

Products

• Autosys Workload Automation

Issue/Introduction

This document provides the necessary steps for customizing certain colors and text in the WebUI. This can be beneficial for allowing users to easily distinguish between production and lower environments.  

Environment

Release: 12.x releases
Note: These steps will not work for r24.x release. L2 is working on documenting steps for v24. 

Component : WebUI

Resolution

NOTES:

• All of the steps below can be performed back to back and then clear the browser cache one time - there is no need to restart the WebUI services.
• Changes are on a per instance basis. If WebUI is configured for high availability, changes are will not get propogated to other WebUI instances. The same changes will need to be performed on each individually.
• Use the HTML Color Picker to select a color of choice.
• After applying an incremental patch to the WebUI, the modified color(s) of the login and launcher page(s) WILL NOT be affected. If any additional text was addedto the login and/or launcher page(s), this modification WILL be affected.
  

Change Color of Login Page

1. Navigate to the $CA_WCC_INSTALL_LOCATION/tomcat/webapps/wcc/login/css directory [or %CA_WCC_INSTALL_LOCATION%\tomcat\webapps\wcc\login\css directory].
2. Make a backup copy of the wcc-common.css file.
3. Open the original file and look for the following statements (near the beginning of file).
   

   login-viewport {
           background-color: #FFFFFF;

4. Change the hexadecimal value to color of your choice (make sure you keep the # sign).
   

   login-viewport {
           background-color: #ffcce6;      

5. Save the file.
6. Click the refresh button in your Internet browser and you should see that the login page color has changed.
   
   Notes:
   • If after clicking the refresh button, the changes are not seen, logout of the WebUI and clear the browser cache. Then log back into WebUI.
   • For ease of visiblity, it is recommended to use a light/pastel color for the login page.
     Neither the color of the login button, nor the color of the Broadcom logo and text can be changed.

---

Change Color of Launcher Header

4. Navigate to the $CA_WCC_INSTALL_LOCATION/tomcat/webapps/wcc/launcher/ca/css directory [or %CA_WCC_INSTALL_LOCATION%\tomcat\webapps\wcc\launcher\ca\css directory].
5. Make a backup copy of the ca-all.css file.
6. Open the original file and look for the following statements:
   

   /* ca header css */
.ca-header
{
  #width:100%;
  background-color: #20465f;
}

7. Change the hexadecimal value to color of your choice (make sure you keep the # sign).
   
   /* ca header css */
.ca-header
{
  #width:100%;
     background-color: #e60000;
   }

5. Save the file.
6. If logged in to the WebUI, click the refresh button in the browser. If not, log in to the WebUI. The top of the Launcher page should reflect the color changes. 
   
   Note: If after clicking the refresh button, the changes are not seen, logout of the WebUI and clear the browser cache. Then log back into WebUI.

---

Change Color of Launcher Footer

1. Navigate to the $CA_WCC_INSTALL_LOCATION/tomcat/webapps/wcc/launcher/css directory [or %CA_WCC_INSTALL_LOCATION%\tomcat\webapps\wcc\launcher\css directory].
2. Make a backup copy of the wcc-common.css file.
3. Open the original file and look for the following statements (toward the bottom of file).
   
   .ca-footer {
    background-color: #ffffff;
    padding: 5px;
}

.ca-footer-copyright,.ca-footer-link {
    font-family: Arial;
    font-size: 12px;
    color: #58666C;
}

5. Change the hexadecimal value to reflect the color of choice (make sure to keep the # sign).
   
   .ca-footer {
         background-color: #e60000;
         padding: 5px;
}
   
   
6. To ensure the text is still visible on the footer, change the color of the text to white. (make sure to keep the # sign).
   
   .ca-footer-copyright,.ca-footer-link {
    font-family: Arial;
    font-size: 12px;
    color: #ffffff;
}

6. Save the file.
7. If logged in to the WebUI, click the refresh button in the browser. If not, log in to the WebUI. The bottom of the Launcher page should reflect the color changes. 
   
   Note: If after clicking the refresh button, the changes are not seen, logout of the WebUI and clear the browser cache. Then log back into WebUI.

---

Add/Modify Text to the Login Page 

1. Navigate to the $CA_WCC_INSTALL_LOCATION/tomcat/webapps/wcc/login directory [or %CA_WCC_INSTALL_LOCATION%\tomcat\webapps\wcc\login directory].
2. There will be 5 JavaScript files with a filename that starts with a hexadecimal number and ends with cache.js. Make a backup copy of all 5 JavaScript files.
   
   EXAMPLE: 5CE5ADE3325A6742C7FAA2909247D567.cache.js

3. Open the JavaScript file and look for the following string: 'AutoSys Workload Automation'.
   Note: The string 'CA Workload Automation AE' appears before 'login-product'.

4. Change the string from 'CA Workload Automation AE' to 'AutoSys Workload Automation - PRODUCTION'.
5. Save the file.
6. Do this for all 5 JavaScript files.
7. Click the refresh button in your Internet browser and you should see the text modifications.
   Note: If the changes that were made do not reflect after clicking the refresh button, clear the browser cache. Then access the WebUI again.

The text under the login box (ex. where it says © 2020 CA. All rights reserved.) can also be modified by completing these steps:

1. Use the same 5 JavaScript files noted above for adding text to the login page.
2. Open the JavaScript file and look for the following string: 'All rights reserved.' It appears before 'login-copyright'.
3. Change the text or add additional text. Be sure that the text appears between the two tick marks.
4. Save the file.
5. Do this for all 5 JavaScript files.
6. Click the refresh button in your Internet browser and you should see the text modifications.
   Note: If the changes that were made do not reflect after clicking the refresh button, clear the browser cache. Then access the WebUI again.

---

Add/Modify Text to the Launcher Page Header

1. Navigate to the $CA_WCC_INSTALL_LOCATION/tomcat/webapps/wcc/launcher directory [or %CA_WCC_INSTALL_LOCATION%\tomcat\webapps\wcc\launcher directory].
2. There will be 5 JavaScript files with a filename that starts with a hexadecimal in it and ends with cache.js. Make a backup copy of all 5 JavaScript files.
3. Open the JavaScript file and look for the following string 'AutoSys Workload Automation'.

PAY ATTENTION! You will see 'AutoSys Workload Automation' in more than one string. You want the string that ONLY has 'AutoSys Workload Automation' in it. (The string 'AutoSys Workload Automation' appears after 'ca-header-logo' and before 'ca-header-product-name'.)

4. Change the string from 'AutoSys Workload Automation' to 'AutoSys Workload Automation - PRODUCTION'.
5. Save the file.
6. Do this for all 5 JavaScript files.
7. If currently logged in to the WebUI, click the refresh button in the browser. If not, log in to the WebUI. The text modifications should be noted at the top of the Launcher page.
   Note: If the changes that were made do not reflect after clicking the refresh button, clear the browser cache. Then access the WebUI again.

---

Add/Modify Text to the Launcher Page Footer

The footer text (© 2020 CA. All rights reserved.) can also be modified by completing these steps:

1. Use the same 5 JavaScript files referenced above.
2. Open the JavaScript file and look for the following string: 'All rights reserved.' It appears before 'ca-footer-copyright'.
3. Change the text or add additional text. Be sure that the text appears between the two tick marks.
4. Save the file.
5. Do this for all 5 JavaScript files.
6. If currently logged in to the WebUI, click the refresh button in the browser. If not, log in to the WebUI. The text modifications should be noted at the top of the Launcher page.
   Note: If the changes that were made do not reflect after clicking the refresh button, clear the browser cache. Then access the WebUI again.