Changing Metasys login window background in SMP - Metasys - LIT-12013243 - M4-OASMIN-0 - M4-OASSTD-0 - Server - Open Application Server - 13.0

Open Application Server (OAS) Commissioning Guide

Product
Building Automation Systems > Application Servers > Open Application Server
Document type
Commissioning Guide
Document number
LIT-12013243
Version
13.0
Revision date
2024-06-12
Product status
Active

About this task

You can replace the standard Johnson Controls splash window with a custom image. For example, a customer's name, logo, or a photo of their facility can be shown as the Site Management Portal is loading. When choosing the image, follow these recommendations:

  • Use digital image files of type .jpg or .png. Avoid bitmap files, which are not compressed and often have a very large file size.
  • For best results, configure the image dimensions for 800 x 600 pixels, the resolution as 96 dpi, and the color depth as 24 bit. Limit the file size to 100 KB or less. Use any photo editor, such as Microsoft Paint, to resize or reconfigure the image.

  • If you use an image with a light background, you may need to change the text color for the User Name and Password fields. The default color of these fields is white and may be almost invisible over a light background.

To change the login screen background, complete the following steps:

Procedure

  1. Prepare the image to meet the recommendations provided at the beginning of this section.
  2. Copy the image to this folder on the OAS computer: C:\Program Files (x86)\Johnson Controls\MetasysIII\UI
    Also, delete any other image files at this folder location. The only image file in this folder should be the one you want to use.
  3. Open a text editor, such as Notepad, selecting the Run as Administrator option. (Highlight the text editor from the Programs list, right-click and select Run as Administrator. Specify the Administrator's password if the operating system prompts you.) Some computers require administrator access to make changes to system files.
  4. Open the FrameworkProperties.properties file on the OAS computer located here: C:\Program Files (x86)\Johnson Controls\MetasysIII\UI\com\jci\framework.
  5. In the login screen background section at the end of the properties file, specify the file name of the splash screen in the loginPaneBitmapURL parameter. Be sure to remove the # character at the front of the line as shown in the following example: loginPaneBitmapURL= /<splashscreen.jpg>
  6. If necessary, change the text color for the User Name and Password fields by setting the loginPaneTextColor parameter to a hexadecimal color code. Possible hex codes include: #FF0000 (red), #000000 (black), #0000FF (blue), or #FFFFFF (white). Be sure to remove the # character at the front of the line while keeping the # that precedes the hexadecimal color code, as shown in the following example (gray text): loginPaneTextColor=#808080.
  7. Save the FrameworkProperties.properties file.
  8. Launch the Site Management Portal UI from the Launcher. Verify that the new background and text color appear.
    Notes:
    • If the image file you specified is not found, the background defaults to solid blue. If the text is not visible, specify a different color using the loginPaneTextColor parameter.
    • You may also change the splash screen for SCT. Follow these same instructions, but edit the FrameworkProperties.properties file on the SCT computer located here: C:\Program Files (x86)\Johnson Controls\MetasysIII\ToolUI\com\jci\framework.