Configuring the FishEye web server

To configure the server settings, click Server (under 'Server Settings') in the Admin area.

For information on configuring SSL for Fisheye, see FishEye SSL configuration.

Some settings on this page require you to restart FishEye for changes to take effect.

If you set proxy scheme/host/port values, then sessions accessing the port locally rather than through the reverse proxy will be redirected to the external proxy URL. This means that Application Links set up using the internal address will fail.

If you want to use a connector both internally and externally, you must not set proxy values in the FishEye configuration, but instead ensure that your proxy server is setting the X-Forwarded-Host header in the requests it sends to FishEye. Note that the  X-Forwarded-Host header does not contain the URL scheme, so the scheme must be the same internally and externally.

Screenshot: Configuring server settings

Setting

HTTP Bind

Description

The hostname the FishEye web server will bind to. This can take the form of a host name and port number, or you can leave the host name blank. If no host name is specified, then FishEye will bind to all available interfaces.

Examples

You can use bindings like the following:

Host name and port number:

hostname:8060

Port number only(requires a leading colon):

:8060

IP address and port number:

10.0.0.11:60

(At least one of 'AJP13 Bind' or 'HTTP Bind' must be set.)

Do not add http:// to the beginning i.e. do not add http://hostname:8060 or http://10.0.0.11:60. Simply define hostname:port or IpAddress:port

Restart required

Yes

Setting

Web context

Description

By default, the FishEye application can be accessed via http://HOST:PORT/, where HOST and PORT are defined as above. You can force the FishEye application to be hosted on a different 'context' or 'path' by specifying a value here.

Example

If you specify a web context of 'fisheye' then FishEye will be accessible from http://HOST:PORT/fisheye/ instead of http://HOST:PORT/.

Restart required

Yes

Setting

Proxy scheme

Description

Can be set if you are forwarding through to FishEye from another web server. If you set proxy values, you must also add a matching site URL (see below).

Example

Valid settings are http and https.

Restart required

Yes

Setting

Proxy host

Description

Can be set if you are forwarding through to FishEye from another web server. If you set proxy values, you must also add a matching site URL (see below).

Example

A valid setting would be www.example.com, where 'example' is the domain name of your web server.

Restart required

Yes

Setting

Proxy port

Description

Can be set if you are forwarding through to FishEye from another web server. If you set proxy values, you must also add a matching site URL (see below).

Example

The port number of the web server, an integer from 0 through 32,765.

Restart required

Yes

Setting

AJP13 Bind

Description

Leave this empty unless you are connecting to FishEye/Crucible using the AJP protocol (for example via Apache and mod_jk.)

The bind host name for ajpv13. If no host name is specified, then FishEye will bind to all available interfaces.

Examples

You can use bindings like the following:

Host name and port number:

hostname:8009

Port number only(requires a leading colon):

:8009

IP address and port number:

10.0.0.11:8009

(At least one of 'AJP13 Bind' or 'HTTP Bind' must be set.)

Do not add http:// to the beginning i.e. do not add http://hostname:8060 or http://10.0.0.11:60. Simply define hostname:port or IpAddress:port

Restart required

Yes

Setting

Server timezone

Description

The time zone to use within FishEye. This time zone is used when displaying dates and parsing EyeQL date expressions. If blank, then the time zone of the server running FishEye is used.

Example

This defaults to the FishEye server's time zone, but you can select another zone from the drop-down list.

Restart required

No

Setting

Site URL

Description

The base URL for this FishEye instance. If not specified, FishEye will attempt to determine this value.

You need to set this if you are forwarding through to FishEye from another web server, or if FishEye does not correctly determine the host name you want FishEye users to see FishEye on.

This URL is used to:

  • Generate links in notification e-mails.
  • Generate the gadget subscription URL, which other applications use to access XML data.
  • Generate the Display URL during Application Link creation.

If you have set a proxy scheme/host/port, the values used there must match the site URL.

Do not include a trailing slash ('/') at the end of the URL.

Example

http://www.example.com/apps/fisheye

Restart required

No

Was this helpful?

Thanks for your feedback!

Why was this unhelpful?

Have a question about this article?

See questions about this article

Powered by Confluence and Scroll Viewport