PATH  WebObjects 4.0 Documentation > Post-Install Guide

Table of Contents Previous Section

Troubleshooting

WebObjects operates on a number of hardware platforms, running various operating systems and supporting many different types of HTTP servers. Taking these variables together means that WebObjects finds itself in a large number of distinctly different environments, a situation that can lead to problems affecting the installation of WebObjects or the running of WebObjects applications.

This short guide will help you find solutions to the problems most commonly encountered. It's divided into these major sections:

Start by reading the section for your operating system in " Checking the Installation ." If you don't see the solution there, continue with " Problems With Scripted Applications " and then " Problems With Compiled Applications ."

Remember that the WebObjects release notes, available online (on your disk and on Apple's web site), have the latest information about bugs and workarounds.

Checking the Installation

Windows NT

On Windows NT, these locations should contain the following files or directories:

This is the location where you installed the WebObjects software. Check for these files and directories:

Corrective actions:

If you are missing any of the files from your server's cgi-bin directory, you can copy them from Library\WebObjects\Adaptors\CGI to your HTTP server's cgi-bin directory.

If you are missing any of the contents of your server's document root directory copy them from where they were installed to the directory <DocRoot> \WebObjects . If the files were not installed, reinstall WebObjects.

If you are missing any of the contents of the NEXT_ROOT directory, reinstall WebObjects.

Solaris or HP-UX

On Solaris and HP-UX, these locations should contain the following files or directories:

This is the location where you installed the WebObjects software. Check for these files and directories:

Corrective action:

If you are missing any of the files from your server's cgi-bin directory, you can copy them from /Library/WebObjects/Adaptors/CGI to your HTTP server's cgi-bin directory.

If you are missing any of the contents of your server's document root directory copy them from where they were installed to your server's document root directory. If the files were not installed, reinstall WebObjects.

If you are missing any of the contents of the NEXT_ROOT directory, reinstall WebObjects.

Mac OS X Server

On Mac OS X Server, these locations should contain the following files or directories:

Check for these files and directories:

Corrective action:

If you are missing any of the files from your server's cgi-bin directory, check to see that you have moved them from /Local/Library/WebServer/CGI-Executables to your HTTP server's CGI-Executables directory.

Likewise, if you are missing any of the directories from your server's document root directory, check to see that you have moved them from /Local/Library/WebServer/Documents to your HTTP server's document root directory.

If you are missing any of the contents of your /System/Library directory, reinstall WebObjects.

Problems With Scripted Applications

Problems With Compiled Applications

Table of Contents Next Section