2.8 Customizing the Error Pages of the Access Gateway Service

The Access Gateway Service uses the Apache method for localizing error messages. You can modify these messages or customize the page they are displayed on.

  1. To change a message:

    1. Change to the Apache message configuration directory:

      Linux: /etc/opt/novell/apache2/conf/extra

      Windows: \Program Files\Novell\apache\conf\extra

    2. Open the http-multilang-errordoc.conf file.

      The first few lines of this file contains comments on how Apache recommends modifying the error messages. You can select to use their method or continue with the following steps.

    3. Locate the ErrorDocument section and determine the error code message you want to modify. Make note of the *.var filename.

    4. Change to the Apache error directory:

      Linux: /opt/novell/apache2/share/error

      Windows: \Program Files\Novell\apache\error

    5. Open the *.var file that you want to modify.

      The message is listed alphabetically by language code.

    6. Save the changes.

  2. To change the header of the error page:

    1. Change to the Apache error include directory:

      Linux: /opt/novell/apache2/share/error/include

      Windows: \Program Files\Novell\apache\error\include

    2. Open the top.html page.

    3. To change the title of the page, locate the following line:

      <title>Access Manager 3.1<\title>
      
    4. Replace the Access Manager 3.1 string with the content you require.

    5. To replace the image in the header, locate the following line:

      <img src="NAGErrors/images/Odyssey_LoginHead.gif" alt="" height="80" width="550" border="0">
      
    6. Replace Odyssey_LoginHead.gif with the filename of the image you want to display.

    7. Adjust the height and width values to match your image.

    8. Save the file.

    9. Copy your image to the images directory:

      Linux: /opt/novell/apache2/share/error/images

      Windows: \Program Files\Novell\apache\error\images

  3. To change the footer of the error page:

    1. Change to the Apache error include directory:

      Linux: /opt/novell/apache2/share/error/include

      Windows: \Program Files\Novell\apache\error\include

    2. Open the bottom.html page.

    3. To change the image, find the following line:

      <td style="background-color: #E6D88C; padding-left: 10px"><img style="padding-right: 200px" src="/NAGErrors/images/LAP_interoperable_logo_100.gif" align="absmiddle" border="0">
      
    4. Change LAP_interoperable_logo_100.gif to the filename of the image you want to display.

    5. Save the file.

    6. Copy your image to the images directory:

      Linux: /opt/novell/apache2/share/error/images

      Windows: \Program Files\Novell\apache\error\images

  4. Copy all modified files and image files to all Access Gateways in the cluster.