Bug 9418 - Server Error when viewing help
Summary: Server Error when viewing help
Status: RESOLVED FIXED
Alias: None
Product: Platform
Classification: Eclipse Project
Component: User Assistance (show other bugs)
Version: 1.0   Edit
Hardware: PC Windows NT
: P3 normal (vote)
Target Milestone: ---   Edit
Assignee: Dorian Birsan CLA
QA Contact:
URL:
Whiteboard:
Keywords: readme
: 29083 (view as bug list)
Depends on:
Blocks:
 
Reported: 2002-02-11 14:31 EST by Eric Havens CLA
Modified: 2007-09-19 09:13 EDT (History)
2 users (show)

See Also:


Attachments

Note You need to log in before you can comment on or make changes to this bug.
Description Eric Havens CLA 2002-02-11 14:31:33 EST
I have installed eclipse version R1.0 build 0.137 on a Windows NT machine. If I 
try to view any locally installed help, I get the following html back in the 
browser:

<HTML>
<HEAD><TITLE>500 Server Error</TITLE></HEAD>
<BODY>
<H1>Server Error</H1>
<H4>
The following error occurred:<P>
Bad URL
</H4>
<HR>
Please contact the administrator.
</BODY>
</HTML>

The URL that the browser is trying to display is (for example):
http://127.0.0.1:1328/org.eclipse.jdt.doc.user/gettingStarted/qs-
2.htm?lang=en_US

It seems that there is a process on my host trying service the port; if I do a 
"netstat -a | grep 1328" I get:
  TCP    e0040ca155e96:1328     0.0.0.0:0              LISTENING

Each time I start eclipse, I different port is used in the URL and the port 
appears to have a process listening on it, but I get the same html if I try to 
view a section of help. However, some sections of the help refer to a URL with 
a host other than localhost (for example Java Development User Guide->Getting 
Started->Creating Your First Java Project->Refer to http://www.junit.org ...). 
In these cases, the help browser is able to display the URL correctly.

Should the eclipse process be listening on the port and servicing and http 
requests that arrive on it? It appears that this is not working in my 
installation. Is there a way to turn on any tracing or debugging to see how the 
http requests are being processed?
Comment 1 Eric Havens CLA 2002-02-13 10:26:34 EST
This turned out to not really be a bug (although it could be considered a
request for improvement). My problem was that my IE was configured to send all
requests through a proxy, even those being sent to host "127.0.0.1". The proxy
could not resolve the request back to the server running on my host, so the
proxy returned a 500 response code.

Perhaps the installation procedure should prompt the user to ensure that if an
http proxy is being used by their web browser then "127.0.0.1" is in the list of
hosts that shall not use the proxy. If nothing else, there should be an
installation README file mentioning that this change must be done in order for
the online documentation to be accessible. Currently, the download web page
simply tells you to install the application and "go through the user and
developer documentation provided in the online help system". Unless the user
knows to first change the browser setting, he/she can't even read the help!
Since it is not particularly obvious to a new user that eclipse is using IE as
an embedded browser, it may well not occur to them to check their IE browser
settings; the documentation should prompt them to do so.
Comment 2 Dorian Birsan CLA 2002-07-10 11:23:08 EDT
The eclipse README has section on setting the bypass addresses when using a 
proxy.
I will close this bug as "fixed" in the README.
Comment 3 Felix L J Mayer CLA 2003-01-08 21:06:12 EST
*** Bug 29083 has been marked as a duplicate of this bug. ***
Comment 4 Jason A Wrang CLA 2007-09-19 09:13:58 EDT
(In reply to comment #1)
> This turned out to not really be a bug (although it could be considered a
> request for improvement). My problem was that my IE was configured to send all
> requests through a proxy, even those being sent to host "127.0.0.1". The proxy
> could not resolve the request back to the server running on my host, so the
> proxy returned a 500 response code.
> 
> Perhaps the installation procedure should prompt the user to ensure that if an
> http proxy is being used by their web browser then "127.0.0.1" is in the list of
> hosts that shall not use the proxy. If nothing else, there should be an
> installation README file mentioning that this change must be done in order for
> the online documentation to be accessible. Currently, the download web page
> simply tells you to install the application and "go through the user and
> developer documentation provided in the online help system". Unless the user
> knows to first change the browser setting, he/she can't even read the help!
> Since it is not particularly obvious to a new user that eclipse is using IE as
> an embedded browser, it may well not occur to them to check their IE browser
> settings; the documentation should prompt them to do so.

I can't ask users to 'ensure that if an http proxy is being used by their web browser then "127.0.0.1" is in the list of hosts that shall not use the proxy.' Changing "127.0.0.1" to "localhost" would fix the problem, at least for my user base. Is there a preference that can be set to change this? I recall finding a troubleshooting guide that supposedly did this prior to the Eclipse 3.3 release. If not, why can't one be created?