Security

Unable to access online documentation

VBScab
Engager

I have trialled v4.3 and it has now switched to the free version. My problem, however, existed prior to the license change. This is not a connectivity issue, as the browser can open a window to splunk.com with no problem. The test workstation is running Windows XP SP3.

When clicking the 'Learn more' link on an entry in the License Manager screen, after 10 seconds the page simply displays "Unable to access online documentation". On examining the source for the page, it appears that I am missing an entire folder tree, viz. [webroot]/en-GB, as in:

        <script type="text/javascript" src="/en-GB/config?autoload=1"></script>             
        <script type="text/javascript" src="/en-GB/static/@115073/js/common.min.js"></script>                 

Having said that, the installing MSI doesn't contain an entry in the Directory table to create that folder. Perhaps one of the myriad Custom Actions does that....

mykol_j
Communicator

This has never worked for me (since version 4.0). I always assumed it was because we're on an isolated enclave (no Internet) regardless of the URL shown. Well, I'm on 9.0.0.1 now and it's still not working. Thought I'd try one more time... nope. I can't believe something so simple has *never* been fixed by Splunk. Going back to giving up on it again.

0 Karma

ww9rivers
Contributor

I am having the same issue with version 8.1.5. We upgraded from 7.3.4 a few months ago but I don't know if this has happened before. The error message is the same: "Unable to access online documentation. Please ensure docsCheckerBaseURL in web.conf is correct." I get that with any inline help or Help >> Tutorials.

So the URL is: https://localhost:8000/en-US/help?location=search_app.tutorial

I looked in web.conf using Splunk btool, which is the default setting:

app/splunk/etc/system/default/web.conf docsCheckerBaseURL = https://quickdraw.splunk.com/help 

When I manually put that URL in the browser, I get a complete blank response with status 200.

I checked the Chrome browser console in the developer tool. There is no error about client blocking the request. The error messages is in the HTML response.

What else can I check? Thanks!

0 Karma

jbillings
Path Finder

I receive "Unable to access online documentation. Please ensure docsCheckerBaseURL in web.conf is correct." with pop-up blocker turned off, no blocking. Do you know what the configuration for docsCheckerBaseURL in web.conf should look like? https://localhost:8000/en-US/help?location=learnmore.datamodel.about

0 Karma

ChrisG
Splunk Employee
Splunk Employee

Do you have other extensions running? Does your console show net::ERR_BLOCKED_BY_CLIENT?

0 Karma

jbillings
Path Finder

I have other extensions, but none are blocking. I get "help?location=manager.apps.local:142 GET http://docs.splunk.com/Documentation/pro/7.1.2/manager.apps.local/prod/default?locale=en-US&product=... net::ERR_ABORTED 404 (Not Found)"

0 Karma

ChrisG
Splunk Employee
Splunk Employee

Correction. I can't reproduce the issue here. Apologies for the confusion. I was not looking at 7.1.2.

In 7.1.2 (for real), in a fresh local installation, the help links work for me.

http://localhost:8000/en-US/help?location=manager.apps.local

correctly resolves to

https://docs.splunk.com/Documentation/Splunk/7.1.2/Admin/Managingappobjects.

0 Karma

jbillings
Path Finder

Thank you for working on this Chris.
What is your Web.conf CheckerBaseURL set to?

0 Karma

jbillings
Path Finder

The solution was I changed the docsCheckerBaseURL URL to https://quickdraw.splunk.com/help and I'm able to reach the documentation now. Thank you for your help working on this.

ChrisG
Splunk Employee
Splunk Employee

There are a few possible causes for the help links to fail.

  • Sometimes it is a firewall or network issue.
  • You might have a browser extension running that interferes with the call (AdBlock Plus is one likely culprit, or based on the comments below, Privacy Badger). Your browser developer tools console will show net::ERR_BLOCKED_BY_CLIENT if this is the case.
  • Occasionally there is a transient problem that causes help links to fail, but that should resolve if you clear your cache and refresh the page.

wrangler2x
Motivator

I have EFF Privacy Badger on my (Chrome) browser. I was getting this same thing. After reading this I disabled it for my Splunkweb site, and now the Splunk Documentation and Tutorial buttons work correctly.

wrangler2x
Motivator

When I get this message and I do <ctrl><shift>I a pane opens on the right which shows this (Chrome, by the way):

Failed to load resource: net::ERR_BLOCKED_BY_CLIENT quickdraw.splunk.com/help/pro/6.5.2/splunkcore.homepage.docs/prod/default?locale=en-US&product=enterprise:1

I added quickdraw.splunk.com to the Disabled Sites list in Privacy Badger, and tried it again, and got the exact same thing.

I tried this on a co-workers browser and it worked fine, and then I noticed that quickdraw.splunk.com had redirected to docs.splunk.com, so I added that into the Disabled Sites list and it still does not work.

What did you do in Privacy Badger to allow this to work properly?

0 Karma

wrangler2x
Motivator

Okay, I figured it out. I had to click on Privacy Badger icon after the error occurred, then click on Disable Privacy Badger for this site.

Why manually editing the exception list did not fix it I do not know. But it works now. I reported this to IETF

0 Karma

xavierashe
Contributor

EFF Privacy Badger was the culprit for me too.

0 Karma

millenniumdan
Engager

Same problem here: Splunk 6.4.0 on Windows 8.1,
http://localhost:8000/en-US/help?location=learnmore.search.transforming

0 Karma

lesterw
Explorer

I am having the same problem on two separate servers: Brand new fresh install of Splunk for Windows. The URL in question:

http://splunkserver:8000/en-US/help?license=pro&locale=en-US&versionNumber=4.3.2&installType=trial&l...

0 Karma

VBScab
Engager

Update 20120308_0942
I have uninstalled and reinstalled Splunk, this time opting directly for the free license. I am still prompted, after 10 seconds, "Unable to access the online documentation".

Interestingly, the free license is set to expire 6 days AGO!

0 Karma

piebob
Splunk Employee
Splunk Employee

can you provide the URL for that help link? (hover over, right click, copy link)

0 Karma
Get Updates on the Splunk Community!

Earn a $35 Gift Card for Answering our Splunk Admins & App Developer Survey

Survey for Splunk Admins and App Developers is open now! | Earn a $35 gift card!      Hello there,  Splunk ...

Continuing Innovation & New Integrations Unlock Full Stack Observability For Your ...

You’ve probably heard the latest about AppDynamics joining the Splunk Observability portfolio, deepening our ...

Monitoring Amazon Elastic Kubernetes Service (EKS)

As we’ve seen, integrating Kubernetes environments with Splunk Observability Cloud is a quick and easy way to ...