How to Change Default Messages on Logon Page Access Gateway Enterprise Edition Appliance

How to Change Default Messages on Logon Page Access Gateway Enterprise Edition Appliance

book

Article ID: CTX125541

calendar_today

Updated On:

Description

Starting Access Gateway Enterprise Edition software release 9.2, the software is localized depending on the language of the client operating system. The strings used in the HTML for each supported language are available in the XML files existing in the /netscaler/ns_gui/vpn/resources directory of the appliance. The primary name of the xml files is the initial two characters of the related language, such as en.xml for English, fr.xml for French, and ja.xml for Japanese language. You need to edit the respective XML file to change the default message on the logon page for the respective language.


Instructions

To change the default messages on the Logon page of the Access Gateway Enterprise Edition appliance, complete the following procedure:

  1. Switch to the shell prompt.

  2. Run the following command to change to the resources directory:
    cd /netscaler/ns_gui/vpn/resources

  3. To change the default message, as shown in the following screen shot, run the following command to copy the en.xml to a permanent storage:
    cp /netscaler/ns_gui/vpn/resources/en.xml /var/customizations/resources/en.xml

    Note: The /netscaler file system exists in the RAM of the appliance. Therefore, changes you make in this file system are lost when you restart the appliance.

    The following screen shot displays the default message on the Logon page:

    User-added image

  4. Run the following command to change to the directory in the permanent storage:
    cd /var/customizations/resources

  5. Open the en.xml file in a text editor, such as the vi editor.

  6. In the en.xml file, locate the following entry:
    <String id="Welcome">Welcome</String>

  7. Replace the entry with the following entry:
    <String id="Welcome">Welcome to Example.com</String>

  8. Save and close the file.

  9. Run the following command to replace the en.xml file available in the RAM:
    cp /var/customizations/resources/en.xml /netscaler/ns_gui/vpn/resources/en.xml

  10. To ensure that the changes exist even after the appliance is restarted, add the following entry to the /nsconfig/rc.netscaler file:
    cp /var/customizations/resources/en.xml /netscaler/ns_gui/vpn/resources/en.xml

  11. Restart the appliance.

  12. Access the appliance from a web browser. The Logon page displays the customized message:

    User-added image

Environment

The above mentioned sample code is provided to you as is with no representations, warranties or conditions of any kind. You may use, modify and distribute it at your own risk. CITRIX DISCLAIMS ALL WARRANTIES WHATSOEVER, EXPRESS, IMPLIED, WRITTEN, ORAL OR STATUTORY, INCLUDING WITHOUT LIMITATION WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, TITLE AND NONINFRINGEMENT. Without limiting the generality of the foregoing, you acknowledge and agree that (a) the sample code may exhibit errors, design flaws or other problems, possibly resulting in loss of data or damage to property; (b) it may not be possible to make the sample code fully functional; and (c) Citrix may, without notice or liability to you, cease to make available the current version and/or any future versions of the sample code. In no event should the code be used to support ultra-hazardous activities, including but not limited to life support or blasting activities. NEITHER CITRIX NOR ITS AFFILIATES OR AGENTS WILL BE LIABLE, UNDER BREACH OF CONTRACT OR ANY OTHER THEORY OF LIABILITY, FOR ANY DAMAGES WHATSOEVER ARISING FROM USE OF THE SAMPLE CODE, INCLUDING WITHOUT LIMITATION DIRECT, SPECIAL, INCIDENTAL, PUNITIVE, CONSEQUENTIAL OR OTHER DAMAGES, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGES. Although the copyright in the code belongs to Citrix, any distribution of the sample code should include only your own standard copyright attribution, and not that of Citrix. You agree to indemnify and defend Citrix against any and all claims arising from your use, modification or distribution of the sample code.

Issue/Introduction

This article contains information about changing the default messages on the Logon page of the Access Gateway Enterprise Edition appliance.