bootcat:help:troubleshooting

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Next revision		 Previous revision
Last revisionBoth sides next revision
bootcat:help:troubleshooting [2016/02/12 13:02] – created erosbootcat:help:troubleshooting [2016/05/23 09:44] – eros
Line 1: Line 1:
 ====== Troubleshooting ====== ====== Troubleshooting ======
  
-==== BootCaT gets stuck while "retrieving URLs" ====+===== BootCaT gets stuck while "retrieving URLs" =====
  
 This could depend on one of the following causes: This could depend on one of the following causes:
  
----- +==== Wrong account Key ====
- +
-=== Wrong account Key ===+
  
 Cause 1: maybe when subscribing to Windows Azure Marketplace you choose "Bing Search API - Web results only" instead of "Bing search API" Cause 1: maybe when subscribing to Windows Azure Marketplace you choose "Bing Search API - Web results only" instead of "Bing search API"
Line 17: Line 15:
 **Solution:** see [[bootcat:help:search_engine_key#where_is_my_account_key|this page]] **Solution:** see [[bootcat:help:search_engine_key#where_is_my_account_key|this page]]
  
-**NB**: please note that when you use the wrong account key (for any of the reasons listed above), Bing might block your access to the service and refuse to answer all requests coming from your computer (even those made using a legitimate key) for a few hours. **This means that if you realise you used the wrong account key, you might need to wait a few hours (I'm not sure how many) before you can try again with the correct key.** ((requests are probably blocked by IP address, so switching to a different network might be helpful))+**NB**: please note that when you use the wrong account key (for any of the reasons listed above), Bing might block your access to the service and refuse to answer all requests coming from your computer (even those made using a legitimate key) for a few hours. **This means that if you realise you used the wrong account key, you might need to wait a few hours (I'm not sure how many) before you can try again with the correct key.** ((requests are probably blocked based on IP address, so switching to a different network might be helpful (e.g. switching to your home wifi if you used BootCaT at work or vice versa).))
  
 ---- ----
  
-=== "Collecting URLs" stops working === +==== Mac OS X and Java ====
- +
-Cause: for reasons yet to be determined, sometimes "Collecting URLs" stops working +
- +
-**Solution:** try the following workaround (:!: please note that this will make BootCaT 'forget' your Windows Azure Marketplace accountKey, so either make a copy of it before you start this procedure or make sure you can retrieve it from somewhere else :!:): +
-    * close BootCaT +
-    * **Windows XP users**, remove the folder ''.bootcat'' located in ''C:\Documents and Settings\<your username>\'' +
-    * **Windows Vista/7/8 users**, remove the folder ''.bootcat'' located in ''C:\Users\<your user name>\appData\Roaming\'' +
-    * **Mac/Linux users**, remove the folder ''.bootcat'' located in your home folder. +
-    * restart BootCaT +
- +
----- +
- +
-**This only applies to Mac OS X**+
  
 If you don't have Java, the first time you run BootCaT, Mac OS X (up to version 11, El Capitan) will install its own flavour of Java (version 6) and after you've installed it, **it's very, very difficult to remove it**. If you don't have Java, the first time you run BootCaT, Mac OS X (up to version 11, El Capitan) will install its own flavour of Java (version 6) and after you've installed it, **it's very, very difficult to remove it**.
Line 50: Line 35:
 </code> </code>
  
-  * Download Java from [[https://www.java.com]] and run the installer+  * Download the Java JDK from [[http://www.oracle.com/technetwork/java/javase/downloads/index.html|this site]] and run the installer
  
   * go back to Terminal and type:   * go back to Terminal and type:
Line 72: Line 57:
  
 You should now see java version "1.7.0_21" (or similar). You should now see java version "1.7.0_21" (or similar).
 +
 +----
 +
 +==== "Collecting URLs" stops working ====
 +
 +Cause: for reasons yet to be determined, sometimes "Collecting URLs" stops working
 +
 +**Solution:** try the following workaround (:!: please note that this will make BootCaT 'forget' your Windows Azure Marketplace accountKey, so either make a copy of it before you start this procedure or make sure you can retrieve it from somewhere else :!:):
 +    * close BootCaT
 +    * **Windows XP users**, remove the folder ''.bootcat'' located in ''C:\Documents and Settings\<your username>\''
 +    * **Windows Vista/7/8 users**, remove the folder ''.bootcat'' located in ''C:\Users\<your user name>\appData\Roaming\''
 +    * **Mac/Linux users**, remove the folder ''.bootcat'' located in your home folder.
 +    * restart BootCaT