FishEye 2.5 : Environment Variables
This page last changed on Sep 16, 2009 by edawson.
Environment variables are system-wide settings that are required for certain applications. Instructions on Setting Environment Variables are here. JAVA_HOMEThe JAVA_HOME environment variable is used by FishEye to select the Java Virtual Machine (JVM) to be used to run FishEye. If this environment variable is not set, FishEye will use whatever Java executable is available on the path. In Linux systems, this may sometimes be GCJ-based which causes some problems running FishEye. See the instructions on setting JAVA_HOME. FISHEYE_OPTSFishEye uses the FISHEYE_OPTS environment variable to pass parameters to the Java Virtual Machine (JVM) used to run FishEye. This is typically used to set the Java heap size available to FishEye (see Fix out of Memory Errors). With a Sun JVM, for example, you would use: FISHEYE_OPTS=-Xmx1024m -XX:MaxPermSize=128m This would give FishEye a max of 1024 MByte heap, a Max permanent generation size of 128m. See Tuning FishEye for more information. After having set the FISHEYE_OPTS and restarting your server, go to Administration > Sys Info/Support > System Info, and check your JVM Input Arguments to ensure that your server is picking up your FISHEYE_OPTS as expected. FISHEYE_ARGSFISHEYE_ARGS are the arguments which will be passed to FishEye when it is started. You can set this to --debug, for example, or --debug-perf if you always want to have FishEye debugging put into the FishEye log files. FISHEYE_LIBRARY_PATHThe FISHEYE_LIBRARY_PATH environment variable tells FishEye where it should look to load any additional native libraries. FISHEYE_INSTThe FISHEYE_INST variable tells FishEye where to store its data. If you wish to separate FishEye's data from its application files in FISHEYE_HOME, you should use this variable.
Setting Environment Variables under Windows XP(If you are running Fisheye as a windows service you need to refer to the instructions here) 1. Click 'Start' > 'Control Panel' > 'System'. Screenshot: System Properties under Windows XP Control Panel 2. Click the 'Advanced' tab. Screenshot: Environment Variables under Windows XP Control Panel 4. Click 'New'. FISHEYE_OPTS 6. In the 'Variable value' field, enter the setting as required. This may be quite cryptic, for example the default value for FISHEYE_OPTS is this: -Xmx256m Screenshot: Setting Environment Variables under Windows XP Setting Environment Variables for Windows ServicesPlease note, that if you do run as a service, then any Environment Variables that you want to set, need to be set in your FISHEYE_HOME/wrapper/conf/wrapper.conf file. If there are other java parameters you wish to add, then you will need to add them under the additional parameters, e.g. # JDK 1.5 Additional Parameters for jmx wrapper.java.additional.4=-Dcom.sun.management.jmxremote wrapper.java.additional.5=-Dcom.sun.management.jmxremote.port=4242 wrapper.java.additional.6=-Dcom.sun.management.jmxremote.authenticate=false wrapper.java.additional.7=-Dcom.sun.management.jmxremote.ssl=false wrapper.java.additional.8=-Dcom.sun.management.jmxremote.authenticate=false wrapper.java.additional.9=-Dcom.sun.management.jmxremote.password.file=./wrapper/jmxremote.password wrapper.java.additional.10=-Dwrapper.mbean.name="wrapper:type=Java Service Wrapper Control" For example if you wish to add a FISHEYE_INST environment variable or add the java parameter "MaxPermSize", or the -Xrs options (should be used if running FishEye as a service under Windows, to prevent the JVM closing when an interactive user logs out) then it would be something like: wrapper.java.additional.11=-Dfisheye.inst="c:/path/to/FISHEYE_INST" wrapper.java.additional.12=-XX:MaxPermSize=128m wrapper.java.additional.13=-Xrs Your memory settings can also be found in this file: # Initial Java Heap Size (in MB) wrapper.java.initmemory=32 # Maximum Java Heap Size (in MB) wrapper.java.maxmemory=256 Increase these values if you have a large repository or expect to use more memory (init of 256, and a max of 1024 would be reasonable).
Setting Environment Variables under Linux or UNIX based platformsThere are a number of ways to set environment variables on Linux or UNIX based systems (including Mac OS X). Here are just two: For your current user: 1. Open up a shell or terminal window vi ~/.profile (vi is a text editor, you can use another if desired) export (variable name)=(variable value) Where (variable name) and (variable value) are the environment variable elements. For example, if the environment variable you are setting is FISHEYE_OPTS, and the variable value is -Xmx256m, you would type the following: export FISHEYE_OPTS=-Xmx256m Add this command on its own line at the end of the file. For all users in the system: 1. Open up a shell or terminal window If you are using a GUI, you may not need to open up the shell. Instead, you might be able to open the file directly in a graphical text editor.
![]() ![]() ![]() |
![]() |
Document generated by Confluence on Apr 03, 2011 23:09 |