Symptoms

1. When browsing to files with special characters (e.g. +, ~, etc) the link is redirected incorrectly, with these characters omitted. For example:

   
   http://FISHEYE_URL/cru/abc-1/edit-browse/%7E/src/c++
   

   becomes,

   
   http://FISHEYE_URL/cru/abc-1/edit-browse/%7E/src/c
   

   so you cannot browse to that particular file.
2. The following exception may also appear in your logs:

   
   java.lang.IllegalArgumentException Not encoded
   

3. Your Fisheye/Crucible instance is running behind an Apache Webserver.

Cause

Fisheye/Crucible is being running behind an Apache Webserver via mod_proxy_http or mod_proxy, and the Apache server is omitting these special characters.

Resolution

To tell Apache to not omit these characters, set the following into $APACHE_SERVER/conf/httpd.conf

ProxyPass /fisheye http://localhost:8060/fisheye nocanon
ProxyPassReverse /fisheye http://localhost:8060/fisheye

<Location /fisheye>
    Order allow,deny
    Allow from all
</Location>

Reference

• http://httpd.apache.org/docs/2.2/mod/mod_proxy.html (Search for the nocanon option)