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 |
---|---|
|
The hostname or IP address of the machine the proxy server is running on. |
|
The port of the proxy. Defaults to 80. |
|
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. |
|
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. |
|
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.