Do I need to define FISHEYE_INST when installing FishEye?

[Jeremy Largman]

What's the purpose of this environment variable?

[Dylan Hansen · Accepted solution]

The FISHEYE_INST environment variable allows you to separate your FishEye installation data (caches, indexes, temp files, etc.) from the installation binaries. The FISHEYE_INST environment variable is optional. If you choose not to set it, by default FishEye will create all installation data inside the directory that you unpack the binaries.

Please note that this environment variable is differnt from FISHEYE_HOME variable. By default, FISHEYE_HOME is the directory that contains the default binaries that are shipped with the product.

For more information, please see the following documents:

• Installing FishEye
• Environment Variables

[spuddy ಠ_ಠ]

Note that this INST/HOME naming convention in FishEye/Crucible is different to the other Atlassian products. For example, JIRA_HOME refers to the same type of directory that FISHEYE_INST does.

[Tom Davies]

While you don't *need* to define it, you *should* if you are running an instance you expect to upgrade. Having a separate FISHEYE_INST directory makes upgrades easier -- you don't need to transfer the installation data from the old unpacked binaries directory to the new.

[Peter Bernier]

I needed to have it created in order to get FishEye successfully installed. (2.7.11)

[Jeff Jeff]

I was running through Stage 5 of the DragonSlayer and ran into a problem related to this answer, so thought I'd post my observation:

In these Slayer instructions, it has the user setup FECRU_INST, but you never set FISHEYE_INST. Then when you get to step 3.8, you're only given the option of using "FISHEYE_INST/lib" when trying to tell the wizard where you JDBC driver lives. This got me completely stuck because the FISHEYE_INST variable is never set. From reading the details above, guess I could have just put the JDBC driver into my application installation /lib directory, but didn't find this information until I had already restarted the fisheye/crucible installation section over from scratch end setting both variables FECRU_INST and FISHEYE_INST and going back over the steps. Worked.. =)

[rverschoor]

FECRU_INST is a typo, it should be FISHEYE_INST. This typo has been reported internally to get it fixed in the documentation.