<commit_before><!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1" />
<title>Troubleshooting FAQ</title></head>

<body>
Having trouble?  Maybe we've heard of it before.  If not, try our <a href="userForums.action">user forums</a>.

<h3><a name="404" />During the tutorial, I get a 404 error when running the getNewBrowserSession command!</h3>

<p>First, finish reading the <a href="tutorial.html">tutorial</a>.  Make sure you read the section about the "Same Origin Policy" carefully.</p>

<p>If you're getting a 404 error while attempting to open a page on "http://www.google.com/selenium-server/", then it must be because the Selenium Server was not correctly configured as a proxy.  Remember, that directory doesn't really exist on google.com; it only appears to exist when the proxy is properly configured.</p>

<p>Now the question to ask is: <i>why isn't my proxy properly configured</i>?  There are a number of possible reasons, depending on which way you launched your browser: with *firefox, *iexplore, *opera, or *custom.</p>

<ul>
    <li><b>*iexplore</b>: If you launched your browser using *iexplore, there are a number of likely possibilities.
        
<p>Selenium Server attempts to configure the global proxy settings in your Internet Options control panel; we need to make sure that those are correctly configured when Selenium Server launches the browser.  Try looking at your Internet Options control panel.  Click on the "Connections" tab and click on "LAN Settings".</p>

<ul>
<li>If you have checked "Automatically detect settings", (the top check box,) you'll need to uncheck it before using Selenium RC.  This is filed as bug <a href="http://jira.openqa.org/browse/SRC-22">SRC-22</a>.

<p>If you need to use a proxy to access the application you want to test, you'll need to start Selenium Server with "-Dhttp.proxyHost"; see the <a href="options.html">command line options</a> for more details.</p></li>
<li>Also note, as this Control Panel states, that "these settings will not apply to dial-up or VPN connections".  If you're on a dial-up or VPN connection, Selenium RC cannot automatically configure the IE proxy... in fact, as far as we know, there's no standard way to configure your proxy at all!  (This is filed as bug <a href="http://jira.openqa.org/browse/SRC-21">SRC-21</a>, but it may not be possible to fix it.)  As a workaround, you may be able to use the <a href="#experimental">experimental *iehta browser launcher</a> instead.
</ul>

<li><b>*custom</b>: When using *custom, it's up to you to configure the proxy correctly (manually).  If you forgot to do this, or if you configured the proxy incorrectly, you'll get a 404 error.  Double-check that you've configured your proxy settings correctly.

<li><b>SSL/HTTPS</b>: If you attempt to start a browser session on an HTTPS URL, we cannot use our proxy to intercept these encrypted instructions.  We hope to one day add SSL support to our proxy (this is issue <a href="http://jira.openqa.org/browse/SRC-3">SRC-3</a>), but in the meantime, you'll have to use one of our <a href="#experimental">experimental browser launchers</a> to test sites that require HTTPS support.

<li><b>others (*firefox, *opera)</b>: For the others, we automatically hard-code the proxy for you, and don't know of any known issues with this functionality (except for the SSL/HTTPS issue, noted previously).  If you're encountering 404 errors during the tutorial while using these browser launchers, post them to our <a href="userForums.action">user forums</a>... they might be bugs!

</ul>

<h3>During the tutorial, I can't access Google when running the "open" command!</h3>

<p>First, finish reading the <a href="tutorial.html">tutorial</a>.  Make sure you read the section about the "Same Origin Policy" carefully.</p>

<p>There's a couple of possible reasons this might be happening:</p>
<ul>
    <li>This might be a simple issue where you've mistyped the commands.  Make sure you type the commands exactly as they appear in the tutorial.</li>
<li>Selenium RC automatically configures the browser to use the Selenium Server as a proxy.  But if you need to use another proxy to access the Internet, then you may not be able to access Google while using the Selenium Server as a proxy.  (The Selenium Server will not automatically use your proxy; it will attempt to contact Google directly.)

<p>If you need to use a proxy to access the application you want to test, you'll need to start Selenium Server with "-Dhttp.proxyHost"; see the <a href="options.html">command line options</a> for more details.</p>.</li>
</ul>

<h3><a name="permission-denied" />Why am I getting a Permission Denied error when using Selenium RC?</h3>
    
<p>This usually happens because you have run afoul of the <a href="tutorial.html#sameorigin">Same Origin Policy</a>.  If your browser session starts on one origin, but then you attempt to load up a page from another origin (with a different domain, protocol or port), you'll run into these Permission Denied errors.</p>

<p>In most cases, you can remedy this just by making sure that your browser session starts on the right origin.  You can't test www.google.com from a browser session starting at google.com, so you'll just need to start your browser session differently.</p>

<p>If for some reason you absolutely need to be able to access websites on multiple domains, then right now the only way to do that is to use one of our <a href="#experimental">experimental browser launchers</a>.
    
<h3><a name="custom" />Selenium Server launches the browser in just one particular configuration (pop-ups blocked, etc.).  I need to test running the browser in a different configuration.  How do I do that?</h3>

<p>Normally Selenium RC automatically configures your browser, but if you launch your browser using "*custom" as your browser launcher, you can force Selenium RC to launch the browser as-is, without changing your configuration.  (Note that this is also the way you launch other browsers that Selenium RC doesn't yet explicitly support.)</p>

For example, you can launch Firefox with a custom configuration like this:

<blockquote>
  <p><code> cmd=getNewBrowserSession&amp;1=<strong>*custom c:\Program Files\Mozilla Firefox\firefox.exe</strong>&amp;2=http://www.google.com</code></p>
</blockquote>

<p>Note that when we launch the browser in this way, you'll have to <em>manually</em> configure your browser to use the Selenium Server as a proxy. (Normally this just means opening your browser preferences and specifying &quot;localhost:4444&quot; as an HTTP proxy, but instructions for this can differ radically from browser to browser, so consult your browser's documentation for details.)</p>

<p>If you attempt to launch a *custom browser but don't configure the proxy correctly, you won't be able to get through even a simple Google test, because you'll get a 404 (File not found) error trying to access http://www.google.com/selenium-server/.  Remember, that directory doesn't really exist on Google.com; it only appears to exist when the proxy is properly configured.</p>

<p>Also beware that Mozilla browsers can be a little fidgety about how they start and stop.  Avoid launching your browser using a shell script; always prefer to use the binary executable directly.  You may need to set the MOZ_NO_REMOTE environment variable to make Mozilla browsers behave a little more predictably.</p>
<commit_msg>Adding more info to the troubleshooting guide<commit_after><!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1" />
<title>Troubleshooting FAQ</title></head>

<body>
Having trouble?  Maybe we've heard of it before.  If not, try our <a href="userForums.action">user forums</a>.

<h3><a name="404" />During the tutorial, I get a 404 error when running the getNewBrowserSession command!</h3>

<p>First, finish reading the <a href="tutorial.html">tutorial</a>.  Make sure you read the section about the "Same Origin Policy" carefully.</p>

<p>If you're getting a 404 error while attempting to open a page on "http://www.google.com/selenium-server/", then it must be because the Selenium Server was not correctly configured as a proxy.  Remember, that directory doesn't really exist on google.com; it only appears to exist when the proxy is properly configured.</p>

<p>Now the question to ask is: <i>why isn't my proxy properly configured</i>?  There are a number of possible reasons, depending on which way you launched your browser: with *firefox, *iexplore, *opera, or *custom.</p>

<ul>
    <li><b>*iexplore</b>: If you launched your browser using *iexplore, there are a number of likely possibilities.
        
<p>Selenium Server attempts to configure the global proxy settings in your Internet Options control panel; we need to make sure that those are correctly configured when Selenium Server launches the browser.  Try looking at your Internet Options control panel.  Click on the "Connections" tab and click on "LAN Settings".</p>

<ul>
<li>If you have checked "Automatically detect settings", (the top check box,) you'll need to uncheck it before using Selenium RC.  This is filed as bug <a href="http://jira.openqa.org/browse/SRC-22">SRC-22</a>.

<p>If you need to use a proxy to access the application you want to test, you'll need to start Selenium Server with "-Dhttp.proxyHost"; see the <a href="options.html">command line options</a> for more details.</p></li>
<li>Also note, as this Control Panel states, that "these settings will not apply to dial-up or VPN connections".  If you're on a dial-up or VPN connection, Selenium RC cannot automatically configure the IE proxy... in fact, as far as we know, there's no standard way to configure your proxy at all, even manually!  (This is filed as bug <a href="http://jira.openqa.org/browse/SRC-21">SRC-21</a>, but it may not be possible to fix it.)  As a workaround, you may be able to use the <a href="#experimental">experimental *iehta browser launcher</a> instead.
</ul>

<p>As a last resort, you may try configuring your proxy manually and then launching your browser with <a href="#custom">*custom</a>, or with our <a href="#experimental">experimental *iehta browser launcher</a>.</p>

<li><b>*custom</b>: When using *custom, it's up to you to configure the proxy correctly (manually).  If you forgot to do this, or if you configured the proxy incorrectly, you'll get a 404 error.  Double-check that you've configured your proxy settings correctly.  Note that in some browsers it's very easy to make a mistake and change the wrong settings, thinking that you've configured your proxy, when you've really had no effect at all.

<p>One way to tell whether you've configured your proxy correctly is to attempt to intentionally configure your browser <i>incorrectly</i>.  Try configuring your browser to use the wrong proxy server hostname, or the wrong port.  If you've successfully configured your browser's proxy settings <i>incorrectly</i>, your browser will be unable to connect to the Internet, which is one way to make sure you're adjusting the relevant settings.</p>

<p>For example, you might try configuring your browser to use the proxy server "asdflkjdasf" on port "1234".  Then try connecting to google.com in the ordinary way, and doing a search.  If you connect successfully to google.com, then you must not have really changed your proxy settings at all!  You might also try turning your Selenium Server off while using the correct settings (localhost on port 4444).  You should not be able to connect to Google if your proxy is disabled.  If it seems like you can, then you know you've almost certainly made a mistake.</p>

<p>Note that this problem can be especially troublesome on Internet Explorer, which can sometimes ignore whatever proxy settings are configured, even manually!  (This normally happens when you're using a dial-up Internet connection, or if you're using a VPN.)  In that case, you may not be able to configure your proxy at all.  As a workaround, you may be able to use the <a href="#experimental">experimental *iehta browser launcher</a> instead.</p>

<li><b>SSL/HTTPS</b>: If you attempt to start a browser session on an HTTPS URL, we cannot use our proxy to intercept these encrypted instructions.  We hope to one day add SSL support to our proxy (this is issue <a href="http://jira.openqa.org/browse/SRC-3">SRC-3</a>), but in the meantime, you'll have to use one of our <a href="#experimental">experimental browser launchers</a> to test sites that require HTTPS support.

<li><b>others (*firefox, *opera)</b>: For the others, we automatically hard-code the proxy for you, and don't know of any known issues with this functionality (except for the SSL/HTTPS issue, noted previously).  If you're encountering 404 errors during the tutorial while using these browser launchers, post them to our <a href="userForums.action">user forums</a>... they might be bugs!

</ul>

<h3>During the tutorial, I can't access Google when running the "open" command!</h3>

<p>First, finish reading the <a href="tutorial.html">tutorial</a>.  Make sure you read the section about the "Same Origin Policy" carefully.</p>

<p>There's a couple of possible reasons this might be happening:</p>
<ul>
    <li>This might be a simple issue where you've mistyped the commands.  Make sure you type the commands exactly as they appear in the tutorial.</li>
<li>Selenium RC automatically configures the browser to use the Selenium Server as a proxy.  But if you need to use another proxy to access the Internet, then you may not be able to access Google while using the Selenium Server as a proxy.  (The Selenium Server will not automatically use your proxy; it will attempt to contact Google directly.)

<p>If you need to use a proxy to access the application you want to test, you'll need to start Selenium Server with "-Dhttp.proxyHost"; see the <a href="options.html">command line options</a> for more details.</p>.</li>
</ul>

<h3><a name="permission-denied" />Why am I getting a Permission Denied error when using Selenium RC?</h3>
    
<p>This usually happens because you have run afoul of the <a href="tutorial.html#sameorigin">Same Origin Policy</a>.  If your browser session starts on one origin, but then you attempt to load up a page from another origin (with a different domain, protocol or port), you'll run into these Permission Denied errors.</p>

<p>In most cases, you can remedy this just by making sure that your browser session starts on the right origin.  You can't test www.google.com from a browser session starting at google.com, so you'll just need to start your browser session differently.</p>

<p>If for some reason you absolutely need to be able to access websites on multiple domains, then right now the only way to do that is to use one of our <a href="#experimental">experimental browser launchers</a>.
    
<h3><a name="custom" />Selenium Server launches the browser in just one particular configuration (pop-ups blocked, etc.).  I need to test running the browser in a different configuration.  How do I do that?</h3>

<p>Normally Selenium RC automatically configures your browser, but if you launch your browser using "*custom" as your browser launcher, you can force Selenium RC to launch the browser as-is, without changing your configuration.  (Note that this is also the way you launch other browsers that Selenium RC doesn't yet explicitly support.)</p>

For example, you can launch Firefox with a custom configuration like this:

<blockquote>
  <p><code> cmd=getNewBrowserSession&amp;1=<strong>*custom c:\Program Files\Mozilla Firefox\firefox.exe</strong>&amp;2=http://www.google.com</code></p>
</blockquote>

<p>Note that when we launch the browser in this way, you'll have to <em>manually</em> configure your browser to use the Selenium Server as a proxy. (Normally this just means opening your browser preferences and specifying &quot;localhost:4444&quot; as an HTTP proxy, but instructions for this can differ radically from browser to browser, so consult your browser's documentation for details.)</p>

<p>Beware that Mozilla browsers can be a little fidgety about how they start and stop.  You may need to set the MOZ_NO_REMOTE environment variable to make Mozilla browsers behave a little more predictably.  Unix users should avoid launching your browser using a shell script; always prefer to use the binary executable (e.g. firefox-bin) directly.</p>

<p>If you attempt to launch a *custom browser but don't configure the proxy correctly, you won't be able to get through even a simple Google test, because you'll get a 404 (File not found) error trying to access http://www.google.com/selenium-server/.  Remember, that directory doesn't really exist on Google.com; it only appears to exist when the proxy is properly configured.  If you get this error, double-check that you've configured your proxy settings correctly.  Note that in some browsers it's very easy to make a mistake and change the wrong settings, thinking that you've configured your proxy, when you've really had no effect at all.</p>

<p>One way to tell whether you've configured your proxy correctly is to attempt to intentionally configure your browser <i>incorrectly</i>.  Try configuring your browser to use the wrong proxy server hostname, or the wrong port.  If you've successfully configured your browser's proxy settings <i>incorrectly</i>, your browser will be unable to connect to the Internet, which is one way to make sure you're adjusting the relevant settings.</p>

<p>For example, you might try configuring your browser to use the proxy server "asdflkjdasf" on port "1234".  Then try connecting to google.com in the ordinary way, and doing a search.  If you connect successfully to google.com, then you must not have really changed your proxy settings at all!  You might also try turning your Selenium Server off while using the correct settings (localhost on port 4444).  You should not be able to connect to Google if your proxy is disabled.  If it seems like you can, then you know you've almost certainly made a mistake.</p>

<p>Note that this problem can be especially troublesome on Internet Explorer, which can sometimes ignore whatever proxy settings are configured, even manually!  (This normally happens when you're using a dial-up Internet connection, or if you're using a VPN).  In that case, you may not be able to configure your proxy at all.  As a workaround, you may be able to use the <a href="#experimental">experimental *iehta browser launcher</a> instead.</p>

{'fraction_non_alphanumeric': 0.08344805676162237, 'fraction_numerical': 0.006989304246531823, 'mean_word_length': 4.5878698224852075, 'pattern_counts': {'":': 0, '<': 255, '<?xml version=': 0, '>': 255, 'https://': 0, 'lorem ipsum': 0, 'www.': 12, 'xml': 2}, 'pii_count': 0, 'substrings_counts': 0, 'word_list_counts': {'cursed_substrings.json': 0, 'profanity_word_list.json': 0, 'sexual_word_list.json': 0, 'zh_pornsignals.json': 0}}
{'dir': 'git-commits-cleaned', 'id': '7364347', 'n_tokens_mistral': 5248, 'n_tokens_neox': 4923, 'n_words': 2722}