Latest 3.x Release

This documentation covers the latest release of the legacy 3.x Fedora. Looking for another version? See all documentation.

Fedora 4 Development

Looking for Fedora's currently active development?

For networks within an organization, the access to the public domain Internet is often routed through a web proxy and therefore only accessible by using this proxy. Fedora >= v3.3 allows the usage of a http proxy. This means that you can for example have objects with external referenced content that is only reachable through a proxy server.

Proxy Properties

There are five properties that can be used for configuring the http proxy:

Parameter

Description

http.proxyHost

The hostname or IP address of the machine the proxy server is running on.

http.proxyPort

The port of the proxy. Defaults to 80.

http.nonProxyHosts

A list of hosts that should be reached directly, bypassing the proxy. This is a list of regular expressions separated by '|'. Any host matching one of these regular expressions will be reached through a direct connection instead of through a proxy. If the nonProxyHosts list is invalid, the Fedora web client dismisses it, writes the error to the logfile and continues its operation.

http.proxyUser

Should the http proxy require credentials in the form of username and password, you must provide them with these properties. Note: if the proxyUser is set the proxyPassword must not be empty, otherwise the username is not being used by Fedora's web client.

http.proxyPassword

The password for the http proxy.

https proxies are currently not supported.

For more detailed information see the official java documentation.

Tomcat Setup

The proxy setup can be done in basically two ways. Either by using the JAVA_OPTS environment variable:

JAVA_OPTS="-DproxyHost=host -DproxyPort=3128 -DnonProxyHosts=host1|host2 -DproxyUser=fedora -DproxyPassword=secret

Or by supplying these values directly to Tomcat ($CATALINA_HOME/bin/catalina.sh for *nix or %CATALINA_HOME%/bin/catalina.bat for Windows). Please consult the official Tomcat documentation for further details.

  • No labels

All content on the LYRASIS Wiki is licensed under the CC BY (Attribution) license, unless otherwise noted.