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. Proxy server settings are set in the system.properties file:

## HTTP
    # Set the location of the HTTP proxy that the portal will use to fetch
    # external content.
    #http.proxyHost=192.168.0.200
    #http.proxyPort=4480

    # These are read for backwards compatibility and only used if the
    # "http.proxyHost" and "http.proxyPort" settings are not specified.
    #com.liferay.util.Http.proxy.host=192.168.0.200
    #com.liferay.util.Http.proxy.port=4480
 
    # Set the proxy authentication type.
    #com.liferay.util.Http.proxy.auth.type=username-password
    #com.liferay.util.Http.proxy.auth.type=ntlm
 
    # Set user name and password used for HTTP proxy authentication.
    #com.liferay.util.Http.proxy.username=
    #com.liferay.util.Http.proxy.password=
 
    # Set additional properties for NTLM authentication.
    #com.liferay.util.Http.proxy.ntlm.domain=
    #com.liferay.util.Http.proxy.ntlm.host=
 
    # Set the connection timeout when fetching HTTP content.
    #com.liferay.util.Http.timeout=5000

To update the Dashboard proxy server settings:

  1. Open the /OperationsCenter_Dashboard_install_path/server/webapps/ROOT/WEB-INF/classes/system-ext.properties file 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 above. Uncomment and modify the appropriate lines for your environment.

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

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

  3. Save the system-ext.custom.properties file when your changes are complete.

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

    • Windows: Update the /OperationsCenter_Dashboard_install_path/bin/catalina.bat file:

      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 /OperationsCenter_Dashboard_install_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"
      
  5. Restart the Dashboard server for the changes to take affect.

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