3.7 Configuring the Proxy Server

Some of the portlets utilized by Dashboard users might have links to external web sites. If using a proxy server, configure those Dashboard settings to allow users access to these external web site references. The system.properties file includes default proxy server settings. To override the default settings, you must modify the system-ext.properties file as described in the procedure that follows.

The system.properties file includes the following default proxy server settings:

    # Set the location of the HTTP proxy that the portal will use to fetch
    # external content.

    # These are read for backwards compatibility and only used if the
    # "http.proxyHost" and "http.proxyPort" settings are not specified.
    # Set the proxy authentication type.
    # Set user name and password used for HTTP proxy authentication.
    # Set additional properties for NTLM authentication.
    # Set the connection timeout when fetching HTTP content.

For more information about the system.properties file, see Section A.0, System Properties File.

To update the Dashboard proxy server settings:

  1. Open Operations_Center_Dashboard_installation_path/server/webapps/ROOT/WEB-INF/classes/system-ext.properties in a text editor.

    The system-ext.properties file overrides any default settings from the system.properties file.

  2. Add the HTTP proxy server settings as shown in the above example. Uncomment and modify the appropriate lines for your environment, and then save your changes.

    Do not change any other properties in this file unless you are aware of the consequences.

  3. Edit the Web Server startup file to add –Dsystem.properties.load=true to the Java JM arguments line:

    • Windows: Update Operations_Center_Dashboard_installation_path/bin/catalina.bat as follows:

      set JAVA_OPTS=-Xmx768m -XX:MaxPermSize=128m -XX:+PrintHeapAtGC -XX:+PrintGCDetails -Xloggc:%CATALINA_HOME%\logs\mymogc.log -XX:+DisableExplicitGC -Dsystem.properties.load=true -Dfile.encoding=UTF8 - Djava.security.auth.login.config=%CATALINA_HOME%/conf/jaas.config
    • UNIX: Update the Operations_Center_Dashboard_installation_path/bin/catalina.sh file:

      JAVA_OPTS="-Xmx768m -XX:MaxPermSize=128m -XX:+PrintHeapAtGC -XX:+PrintGCDetails -Xloggc:$CATALINA_HOME/logs/mymogc.log -XX:+DisableExplicitGC -Dsystem.properties.load=true -Dfile.encoding=UTF8  -Djava.security.auth.login.config=$CATALINA_HOME/conf/jaas.config"
  4. Restart the Dashboard server.

    For more information, see Section 2.3.1, Starting the Dashboard.