Child pages
  • How to run Fisheye or Crucible on startup on Mac OS X

Documentation for FishEye 3.0.x. Documentation for other versions is available too.

Skip to end of metadata
Go to start of metadata

This article is only provided as a guide and has only been tested on Mac OS X 10.5

launchd does not provide support for service dependencies so if you are using an external database, this may not work for you. Fisheye assumes the database is available when it starts, and the startup scripts will not wait for the database to become available.

You need to create a .plist file to create items that will start at boot time. Please refer to the following page for details:

  •  

Here is an example .plist that should work for Fisheye/Crucible:

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
	<key>Label</key>
	<string>com.atlassian.fisheye</string>
	<key>ProgramArguments</key>
	<array>
		<string>/path/to/FISHEYE_HOME/bin/run.sh</string>
	</array>
        <key>OnDemand</key>
        <false/>
        <key>RunAtLoad</key>
        <true/>
	<key>StandardOutPath</key>
	<string>/path/to/FISHEYE_INST/var/log/fisheye.out</string>
	<key>StandardErrorPath</key>
	<string>/path/to/FISHEYE_INST/var/log/fisheye.out</string>
	<key>EnvironmentVariables</key>
	<dict>
		<key>FISHEYE_INST</key>  <string>/path/to/FISHEYE_INST/</string>
		<key>FISHEYE_OPTS</key>  <string>-Xms512m -Xmx1024m -XX:MaxPermSize=128m</string>
	</dict>

</dict>
</plist>

Customise the /path/to/FISHEYE_INST/ and /path/to/FISHEYE_HOME/ with the FISHEYE_INST and FISHEYE_HOME directories respectively and make any required modifications to FISHEYE_OPTS. Save the file as com.atlassian.fisheye.plist and then try and load it with:

[amyers@erdinger:fecru-2.1.3]$ launchctl load  com.atlassian.fisheye.plist
[amyers@erdinger:fecru-2.1.3]$ launchctl start com.atlassian.fisheye

Fisheye should now start up and you should be able to access it via your web browser.