Creating Company Login Pages

Each Company in a multiple-Company deployment requires a separate, customized login page. After you create the login page for a Company, you can add a system message, disclaimer text, and a company logo. You can also add a logo or other image to the header section of each page within xMatters.

It is recommended that you create and configure the Company within xMatters before creating a customized login page.

To create a Company-specific login page:
  1. On the xMatters web server, navigate to the following folder:
<xMatters>/webserver/webapps/cocoon/alarmpoint/jsp/login/
 
  1. Create a new subfolder in the login directory that identifies the Company for which you are creating the login page. Note the following requirements:
    1. Use lower-case characters only, and do not include any spaces in the folder name. This is important as different operating systems do not process white spaces and upper-case characters in the same way. 
    2. The directory name will appear as part of the web user interface path for the Company. For example, if you create a subfolder named company_a, the URL to access the web user interface for that Company would resemble the following:
http://company.com:8888/alarmpoint/company_a/signOn.do
 
  1. Open the ../alarmpoint/jsp/login/default directory, and copy the following files from that folder into your new Company folder:
    1. SystemMessage.xml
    2. signOn.jsp
    3. Disclaimer.xml
Note: Do not modify the names of the files.
  1. In your new Company folder, open the signOn.jsp file in a text or Java Script editor, and locate the following parameter:
<signon-page companyName=""
 
  1. Insert a value between the quote marks to match the name of the Company you created within xMatters. For example:
<signon-page companyName="Company A"
 
Note: If you change the name of the Company (e.g., via the xMatters web user interface), you must also update this parameter in the signOn.jsp file.
  1. Save and close the signOn.jsp file.

You can now add message text or custom logos to your Company login page.

Adding System Messages and Disclaimers

You can customize Company login pages by adding system messages and disclaimers. System messages appear below the Company and xMatters logos, immediately above the ID and password fields. Disclaimers appear below the login area, immediately above the xMatters copyright notice.

Both messages are visible by every User that logs into xMatters using that Company login page. You can specify a different system message and disclaimer for each Company in the system.

To add text to the xMatters login page:
  1. On the xMatters web server, navigate to the folder containing the Company login page.
    1. By default, this page is located in the <xMatters>/webserver/webapps/cocoon /alarmpoint/jsp/login/<Company Name>/ directory.
  2. Do one or both of the following:
    1. To add a system message, open the SystemMessage.xml file in an XML editor, and add your message text after the <div id="sign-on-system-message"> tag.
    2. To add a disclaimer, open the Disclaimer.xml file in an XML editor, and add your disclaimer text after the <div id="sign-on-disclaimer"> tag.
  3. Save and close the file.
Note: If you want to change the appearance of the system message and disclaimer text, you can format the font using standard XML parameters and the alarmpoint.css file located in the <xMatters>/webserver/webapps/cocoon/alarmpoint/css/ folder.