
Troubleshooting Tips
WebSite Pro Top Page
May 22, 1996
The WebSite Pro troubleshooting tips page is divided into two
main sections: a section of specific problems and solutions, and
a section of guidelines for diagnosing and solving problems on
your own.
The problems and solutions have been collected from
O'Reilly Technical Support and reflect questions users have had
with previous versions of WebSite, and with other applications
included with WebSite Pro, such as Cold Fusion.
The guidelines section describes the troubleshooting tools that
come with WebSite Pro (such as the various logs and tracing
options), and suggests typical places to look for the causes of
problems.
This page also includes ends with information regarding other
resources that can be used to help with WebSite Pro, and for help
on how to contact Technical Support. We highly recommend that you
read this appendix and check the online resources before calling
Technical Support. Remember that tech support is available free
for 90 days to registered users. Send in the registration card
now (located in the front of the Getting Started book) or
register online.
Many of the problems you may encounter while installing and
starting your server are networking related. The specific
problems can be myriad, from a mistyped IP address to a wrongly
configured TCP/IP setup. These problems are beyond the scope of
this book and should be addressed to your network administrator
or your Internet service provider. If you suspect the problem is
with your TCP/IP configu- ration, see the documentation for your
operating and network systems.
Problems and Solutions
The following specific problems have been encountered by WebSite
users in earlier versions. The answers are from O'Reilly's
Technical Support staff.
- Problem
-
When using the NT command scheduler (AT or WinAT),
logcycle.exe doesn't cycle the server logs.
- Solution
-
Logcycle.exe is a desktop application. To successfully
schedule log cycling, it must be able to communicate with AT and
WebSite Pro.
To ensure proper communication, set up the following services:
-
Scheduler service (must be running for AT to work): allow
service to interact with desktop (control panel, services,
scheduler, startup button)
-
WebSite Pro as a service: allow service to interact with desktop
(control panel, services, webserver, startup button)
-
WebSite Pro as a desktop application: no special requirements
-
AT: command line needs to have the argument /interactive
-
WinAT (GUI AT interface from resource kit): interact with
desktop checked
Note that any time you run WinAT and edit an entry, verify that
/interactive is turned on. A bug in WinAT causes /interactive to
be turned off when entries are edited.
- Problem
-
When running WebSite Pro as a service (under NT), the icon doesn't show.
- Solution
-
To run as a service, WebSite Pro must be run under a system
account. Do not run WebSite Pro as a service under a nonprivileged
user account. Windows NT 3.51 security will not give an
unprivileged process access to the desktop. The simplest solution
is to run WebSite Pro under the system account as it was installed.
- Problem
-
How can I add more than five IP addresses to a Windows NT system? The Advanced
Networking option of the Control Panel limits me to five IP addresses.
- Solution
-
Having more than five IP addresses per Network Interface Card (NIC)
is not supported by Microsoft. However, it is possible to add more
IP addresses through the Registry.
Mistakes with the Registry Editor (regedit) can be fatal to your system!
To add more IP addresses, follow these steps:
-
With the Registry editor, look under HKEY_LOCAL_MACHINE\SYSTEM\
CurrentControlSet\Services and locate the entry, or entries, for
your Ethernet card. If you have more than one entry, you must
determine which is the primary one. For example, a 3Com Etherlink
III card probably has two keys, Elnk3 and Elnk31. Open each key and
look in the Linkage sub-key to see which one points to the other.
For the 3Com card, the Linkage sub-key Elnk3 points to Elnk31 as
the primary key.
-
Open the primary key for your Ethernet card and locate the Tcpip key under the
Parameters key. The hierarchical path should look something like this:
HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\Elnk31\
Parameters\Tcpip
-
Under the Tcpip key, locate the named value IPAddress. This value is of type
REG_MULTI_SZ (multi-string). Each of the component strings represents one of
the IP addresses on which the NIC will answer. If you have entered five IP
addresses using the Control Panel, those five IP addresses are listed.
-
Double-click the IPAddress value, and the multi-string editor dialog appears
showing all the IP addresses you have already assigned.
-
Add additional IP addresses by appending them to the list, each one
on a separate line. We recommend that you have no more than 16 IP
addresses total. If you add too many, TCP will not start.
Don't forget to add an appropriate subnet mask for each entry.
-
Reboot the system. If TCP doesn't start, remove some of the addresses and try
again.
You are now ready to set up multiple virtual servers (one for each
IP address), using the Identity wizard on the Identity page of Server Admin.
- Problem
-
I have a server that uses only CGI programs (no static documents),
and I would like to allow users to self-register. How can I get the
username and password information from the authentication dialog?
- Solution
-
First rename your CGI program so the name starts with a $. This
naming convention causes the server to pass the username and
password through the CGI interface. The CGI-BAS that ships with
WebSite Pro (V1.7) includes the CGI_AuthPass and CGI_AuthUser variables.
To get the browser to display the username and password dialog (if
the request doesn't contain a username), have your CGI program
respond something like this:
Send "HTTP/1.0 401 Not Authorized"
Send "WWW-Authenticate: Basic Realm=""My Cool App""")
Send ("")
This response causes the browser to display the username/password
dialog. The user fills it in, presses OK, and the browser repeats
the previous request with the username and password included. Your
CGI application will get both username and password if you start
its name with a $ in the variables CGI_AuthUser and CGI_AuthPass.
Note that this example is for CGI programs written in Visual Basic.
If you aren't using Visual Basic, the process is still the same,
except you need to know the key names for username and password
that are used in the INI file. For more information on this, see
the Windows CGI
Specification.
If you are using the Standard or DOS CGI interfaces, the
environment variable names are AUTH_USER and AUTH_PASSWORD.
- Problem
-
My CGI execution is slow and my disk seems to be beaten to death.
- Solution
-
Nothing will improve this situation better than adding more RAM. On
Windows NT, 16MB is not enough to run NT, WebSite Pro, and do
database CGI. In fact, the RAM requirements for WebSite Pro are 32
MB minimum for Windows NT and 16 MB minimum for Windows 95.
Note that those figures are the minimums. If you have a heavy load
and run complex CGI programs, or if you are running a mix of
database CGI and local work on the same system, you should consider
64MB or 128MB. WebSite users universally attest to dramatically
improved performance when they increase their RAM.
- Problem
-
When I set up virtual servers, all my CGI programs stop working.
- Solution
-
Make sure your CGI directories are properly mapped for each new
server. Each virtual server must have a URL prefix. Add that prefix
to the mapping for each CGI. For example:
/prefix/cgi-win/ C:\path\to\Win CGI directory
If you use the Identity wizard to set up your virtual servers, the
document and CGI mapping is done automatically for you. See the
Identity page in Server Admin and the instructions in Chapter 7,
"Virtual Servers and WebSite Pro," in WebSite Professional
Basics.
- Problem
-
I have WebSite Pro running under Windows 95 and I want to
administer it remotely. Why am I having problems?
- Solution
-
First, you cannot remotely administer the WebSite Pro server
running under Windows 95 from a computer running Windows NT.
Administering the server from another Windows 95 system requires
the following conditions:
-
The remote computer (the one running WebSite Pro) must be on a
network (in the same domain) as a Windows NT system with a user
list. The NT system enables user-level security for Windows 95
administration.
-
Enable remote Registry administration on the remote Windows 95
computer by installing the Remote Registry service, and by
selecting User-Level (rather than Share-Level) security.
Note also, in order to administer remotely, you must be logged into
the local computer as a user who has administrator privileges on
the remote computer (as defined by the user list on the NT system).
- Problem
-
I'm having problems with a CGI program that I wrote. Any tips for
debugging it?
- Solution
- See the white paper on
Debugging CGI Programs in the Tech Center at WebSite Central.
- Problem
-
My CGI programs work okay except that images in the resulting
documents are broken.
- Solution
-
CGI programs create virtual documents, which have no location in
file space. Thus, any relative URLs (for images or links) don't
work because relative URLs are relative to the current document
(see the next question for more on mapping). Note the following examples:
<img src="foo.gif">
This reference is bad because the URL path is completely relative.
The server will not be able to locate this document.
<img src="/foo.gif">
This reference is better because the leading slash makes the URL
path absolute to the document root of the server.
<img src="http://domain/foo.gif">
This is the best reference because the URL is complete, and it
leaves no ambiguity for the image's location.
- Problem
-
Some of my links work fine and others don't. I suspect my problem
may be mapping. Can you give me some pointers?
- Solution
-
First, read Chapter 6, Mapping, in WebSite Professional
Basics carefully and work through the examples. Apply the principles
covered in that chapter to your own situation.
In a nutshell, here are some general principles on relative URLs
that generally cause the most problems in creating document links
in your HTML files:
Q: Relative URLs are relative to what?
A: To the current document.
Q: What is the current document?
A: The URL displayed by the browser when a document is loaded.
Q: Why is a URL with a leading slash different?
A: A leading slash denotes the current server's document root.
Thus, the URL /index.html equals http://current_server/index.html
Q: Are there any URL forms that I should avoid?
A: Yes, avoid URLs beginning in ../. These URLs can easily cause grief.
- Problem
-
When I install WebSite Pro under Windows 95 or try to run the
server self-test under Windows 95, it fails.
- Solution
-
You may have insufficient DOS environment space. Try adding the
line CommandEnvSize=8192 to the [NonWindowsApp] section of
system.ini.
- Problem
-
Cold Fusion output fails and generates error messages.
- Solution
-
In Cold Fusion templates, make sure you include the end tag (for
example, </DBOUTPUT> or </DBTABLE>). Also make sure you properly
end SQL statements and <DBQUERY> tags. A SQL statement must end
with a doublequote ("), while a <DBQUERY> tag must end with a right
angle bracket (>).
Troubleshooting Guidelines
The following guidelines will help you diagnose and solve problems
you may encounter while using WebSite Pro. Please work through
these before calling technical support.
-
Reboot the system to ensure that the effects of any unstable or
faulty software are removed from memory.
- Make sure you have completed and used the WebSite Pro
Installation Requirements checklist (Chapter 2, Before You Start, in
Getting Started) during installation.
- Make sure you have tested the server according to the
procedures outlined in Chapter 3, Installing WebSite Professional,
in Getting Started.
- Run the WebSite Pro server self-test
to verify that your server is set up correctly.
(See Chapter 3 in Getting Started.)
- Complete specific examples in the server self-test for areas in
which you are having problems. For example, if an image map you are
creating won't work correctly, but the one in the server self-test
does, compare the source code in the self-test with the code you
created and find your error.
- Browse WebSite Pro from the local computer and from a different
computer. If browsing locally works, but remotely doesn't, you have
a network problem. Contact your network administrator.
- Test your network connection with another tool or application,
such as ping or telnet. For example, if you ping localhost, the
true name it resolves to should be the same name used in Server
Admin (Identity page) and in your TCP/IP configuration (computer
name and host/domain name).
- Stop the server and check the error log.
(See Chapter 10, Logging, of WebSite Professional Basics.)
- Stop the server and check the server log.
(See Chapter 10 of WebSite Professional Basics.)
- Enable various tracing options for the server log, and recreate
the problems you are having. Then stop the server and check the
tracing data in the server log.
(See Chapter 10 of WebSite Professional Basics.)
- Check the WebSite Pro abort log (located in the WebSite
directory) for fatal internal server errors. When the server won't
start, the abort log may show you why.
- Check the Application Event Log (from the Windows NT Event
Viewer) for information and warnings about problems with the application.
- Check the diagnostics information provided for HTML files in
WebView for possible HTML tagging errors. (See Chapter 1, Managing Your
Web Using WebView, in WebSite Professional Basics.)
- Look closely at the error messages sent from the server to the
browser. For example, in the Not Found return, the server reports
both the URL and the physical file pathname for the URL
target, information invaluable in diagnosing mapping problems. Not
all browsers save error messages. If yours doesn't, we recommend
that you try another browser or enable Dump Sent Data tracing,
which shows what the server sent to the browser.
(See Chapter 10 of WebSite Professional Basics.)
- Double-check your mapping. Make sure that CGI mappings do not
conflict with document mappings. Remember that CGI directories
cannot exist within document directories.
(See Chapter 6 of WebSite Professional Basics.)
- Your Web browser's View Source option often points out useful
information. Perhaps an HTML tag is missing or incomplete.
(See Chapter 2, HTML Tutorial and Quick Reference,
of WebSite Professional Basics.)
- If you are doing CGI work, enable CGI tracing in Logging and use the
DEBUG_MODE CGI variable to enable debugging/tracing features of your CGI
program. (See Chapter 10, Developing Applications with Windows CGI,
of WebSite Professional Advanced Topics.)
WebSite Central
WebSite Central, the
web site maintained for WebSite Pro users by
the technical support staff at O'Reilly & Associates, provides
product information, answers to frequently asked questions (FAQs),
troubleshooting help, advice for particular implementations of
WebSite Pro, ideas for new uses of WebSite Pro, sample HTML files,
helpful utility programs, and opportunities to interact with other
WebSite Pro users.
You can tap the resources at WebSite Central with your browser, and
find out how others have dealt with similar problems. In addition,
the Frequently Asked Questions (FAQs) and Infrequently Asked
Questions (IAQs) published on WebSite Central, may provide just the
answer you need. You will also find pointers to other resources on
the Web, such as specifi- cations, helpful application tools, and
resources for products bundled with WebSite Pro.
From WebSite Central you can send email to the technical support
staff for specific questions. Registered users of WebSite Pro are
placed on a special mailing list that tells them about updates to
the product, incremental releases, news, and ideas.
Contacting Technical Support
If you've thoroughly tried all the other resources to solve your
problem and you still need assistance, O'Reilly & Associates
provides technical support for WebSite Pro as listed below:
-
By queries from the WebSite Central home page,
[email protected]
- By phone at 1-707-829-0515 from 7:00 a.m. to 5:00 p.m. (Pacific Time).
Technical support for WebSite Pro is free of charge via telephone
for the first 90 days after your first call, if you have
registered your copy of WebSite Pro.
Per-incident and annual technical support options are available.
For per-incidence tech support, call O'Reilly Technical Support
at 1-707-829-0515. For setting up annual support contracts,
contact O'Reilly & Associates Customer Support at 800-998-9938.
Register Today!
Send in the registration card now (located in the front of
the Getting Started book) or
register online.
[email protected]
Copyright © 1994-96 O'Reilly & Associates, Inc.
All Rights Reserved.
O'Reilly Software Online, WebSite Central, WebSite, and
WebSite Professional are trademarks of O'Reilly & Associates, Inc.
All other names are the trademarks of their respective companies.