FishEye provides a read-only window into your Subversion, Perforce, CVS, Git and Mercurial repositories. FishEye can be run as a Windows Service using FireDaemon Pro, which lets you start the application automatically at boot prior to login, start multiple instances of the application and more. This HOWTO will show you how to set it up. You can also use Fusion to manage FireDaemon and other Windows services via a web browser.

FishEye Setup Under FireDaemon Pro

Download the latest FishEye files from here.

Extract the zip file someplace on your hard drive, for example, C:\fecru-x.y.z

Install Java JDK from here. Java JDK is different than the client version of Java (JRE) because it includes optimizations for running Java applications as a server.

Install FireDaemon Pro into the directory of your choice, typically C:\Program Files\FireDaemon. FireDaemon can be downloaded here.

Next, start the FireDaemon Pro GUI from the desktop shortcut. Click on the "Create a new service definition" button in the toolbar (or type Ctrl+N) and enter the information into the fields as you see below. Adjust paths to suit your installation.

  • Executable: The path to run.bat in Fisheye's bin/ directory. For the purposes of this HOWTO, the path is C:\fecru-3.3.1\bin\run.bat.
  • Working Directory: The directory in which FishEye resides. For the purposes of this HOWTO, the path is C:\fecru-3.3.1
  • Parameters: None. Leave this field blank.

Note: Do not use start.bat to start FishEye because it will not start the FireDaemon Service properly.

Now click on the Settings tab. If you DON'T want to see your FishEye console running, uncheck the Interact with Desktop check box & select “Hidden” from the “Show Window” dropdown. You must run FishEye as a non-privileged user (i.e. non-admin) for security reasons. The user should also have access to read and write files to FishEye's data directory. In the Logon Account field type your username and then enter the user's password twice in the Password and Confirm fields. You can change the Process Priority to allocate more CPU time to fisheye or specify which CPU or core FishEye will run on (in the case of multi-processor, hyperthreaded or multi-core CPUs). You must change the "Job Type" to "Global Job"; otherwise when FishEye is restarted, the child processes will not be terminated properly.

Now click on the Lifecycle tab. Leave "Graceful Shutdown" checked and check "Console Application".

Now click on the Pre / Post-Service tab. Append a new Post-Service Program. This is where we set up FishEye to stop gracefully when we shut down the service.

  • Executable: The path to stop.bat. For the purposes of this HOWTO, the path is C:\fecru-3.3.1\bin\stop.bat.
  • Working Directory: The bin directory in which FishEye resides. For the purposes of this HOWTO, the path is C:\fecru-3.3.1\bin
  • Execution Time: Enter 10000
  • Run Program: Set it to "Before Event"
  • Run Detached: Leave this box unchecked.

Now click on the OK button to finish setup and start FishEye! Then go to http ://localhost:8060 to configure FishEye.