This documentation relates to an earlier version of FishEye.
View

Unknown macro: {spacejump}

or visit the current documentation home.

This page describes the initial configuration of FishEye, including the steps contained in the FishEye setup wizard.

Initial Configuration

FishEye runs its own HTTP web server, and additionally listens on a socket for administration/shutdown commands. These default to :8060 and 127.0.0.1:8059 respectively. You can change both these addresses before starting FishEye by editing config.xml.

On this page:

Running FishEye for the First Time

To run FishEye for the first time:

  • On Windows: 
    C:\> cd FISHEYE_HOME\bin
C:\FISHEYE_HOME\bin> run.bat
  • On UNIX-based systems: 
    $ cd /FISHEYE_HOME/bin
$ ./run.sh

Once started, FishEye will run its own HTTP web server, on port 8060 by default.

You can access FishEye immediately by going to http://HOSTNAME:8060/ in a browser.

If you want to run FishEye as a Windows service, please refer to this document.

Setting the Administration Password

The first time you run FishEye, when you access the FishEye web server you will be asked for:

  • An administrator password. This password controls access to the FishEye Administration pages.
  • A license key. You can get a trial license from the Atlassian website.

If you need to reset the administrator password, delete the admin-hash attribute in the <config> element. You will be prompted to enter an administrator password next time you start FishEye.

Integrating FishEye with JIRA

You can connect your application to a JIRA server, to manage your users via JIRA and share information with JIRA. When you are installing the application, the setup wizard gives you the opportunity to configure the JIRA connection automatically. This is a quick way of setting up your JIRA integration with the most common options.

You can also configure the JIRA connections via the application administration screens. In that case, you will need to set up connections individually. There are two parts to the integration process:

  • A peer-to-peer link between JIRA and the application for sharing information and facilitating integration features. This link is set up via Application Links.
  • A client-server link between the application and JIRA for delegating user and group management to your JIRA server.

Requirements: You need JIRA 4.3 or later.

For detailed instructions and troubleshooting, see Configuring JIRA Integration in the Setup Wizard.

Accessing the Administration Pages

Once you have set up an administrator password, you can access the administration pages at http://HOSTNAME:8060/admin/.

One of your first steps will be to add a repository.

You will also want to read about the command-line options for controlling FishEye.

You can disable FishEye's Administration pages by setting admin-hash="" in the <config> element of config.xml before starting FishEye.

What's Next?

Want a hands-on tour of the best FishEye features? See FishEye 101.



Log a request with our support team.



Raise an issue for our developers.



See answers from the community.



Blog and update our documentation.

Except where otherwise noted, content in this space is licensed under a Creative Commons Attribution 2.5 Australia License.