Technical article 105958

SCO Online Help gives the error "requested document could not be accessed."

OpenServer 5.0.0OpenServer 5.0.2OpenServer 5.0.4

Written · Last revised

Problem

When I try to use the SCO Online Help I get this error:

requested document could not be accessed. Document server is not running or you do not have permissions

My permissions are fine and scohttp is running.

Cause

This problem occurs on machines where the hostname of the document server cannot be resolved. In cases where the document server is the host itself, the problem occurs when the system's domain name has been set to something other than the default (uucp.com). If you change the default domain name, but do not configure an NIC and map an IP address to your hostname.domain.com, this cannot be resolved.

Thus, when scohttp uses the hostname to connect to port 457, the new domain is appended to the hostname. This does not resolve to an IP, and scohttp thinks the server is down.

Solution

On systems where the document server is the host itself (the default setup) and the domain name has been modified (for instance, it is NOT uucp.com) this problem can be solved by binding the loopback IP address (127.0.0.1) to the hostname. Add the following line to the /etc/hosts file:

127.0.0.1 hostname  hostname.domain.com

where "hostname" is the name returned by the hostname command and "domain.com" is your domain name.

NOTE:     If in the future you do configure TCP/IP on the system, this entry
          will have to be updated to reflect the machine's true IP address.

See also

ta104797, "How to use scohttp(ADM) as a World Wide Web server."

From the Xinuos technical article database, record 105958. Reproduced with permission. The original is at www.sco.com/ta/105958, which is reachable but blocked from search engines. Xinuos marks this article against a retired product line. That refers to the product’s lifecycle, not to whether the advice still works — plenty of it still applies to running systems.

Next step

Need this fixed rather than explained?

Tell us the release, what the system runs and what it is doing. We will reply by email with what we would do next.

  • You deal with the people who do the work
  • No obligation, and no upgrade required before we will help
  • We tell you plainly if something is not worth doing

Send an enquiry

We reply by email. If a server is down, say so in the first line. You can also write to help@scoexpert.com.