Documentation Archive Developer
Search
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:

  • In your server's cgi-bin directory:
    • WebObjects.exe : The WebObjects adaptor
    • WebObjects : This file is simply a copy of the WebObjects.exe file above minus the .exe extension. Some HTTP servers disallow the extension.
  • Your server's document root directory
    • WebObjects : This directory should contain Documentation and Java subdirectories, plus a Frameworks subdirectory that contains directories for WOExtensions and DirectToWeb.
  • NEXT_ROOT directory
This is the location where you installed the WebObjects software. Check for these files and directories:
    • Library\WebObjects\Executables : Contains WODefaultApp.exe , the default application executable for scripted WebObjects applications
    • Library\Frameworks\WebObjects.framework : WebObjects library of classes, plus header files (Developer installations only)
    • Library\Frameworks\WOExtensions.framework : WebObjects Extensions framework, which contains extra dynamic elements and shared components
    • Library\Java : The Java interfaces to WebObjects classes.
    • Library\WebObjects\Adaptors : Contains WebObjects configuration files and adaptors.

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:

  • Your server's cgi-bin directory.
    • WebObjects : The WebObjects adaptor
  • Your server's document root directory
    • WebObjects : This directory should contain Documentation and Java subdirectories, plus a Frameworks subdirectory that contains directories for WOExtensions and DirectToWeb.
  • NEXT_ROOT directory
This is the location where you installed the WebObjects software. Check for these files and directories:
    • Library/WebObjects/Executables : Contains WODefaultApp , the default application executable for scripted WebObjects applications
    • Library/Frameworks/WebObjects.framework : WebObjects library of classes, plus header files (Developer installations only)
    • Library/Frameworks/WOExtensions.framework : WebObjects Extensions framework, which contains extra dynamic elements and shared components
    • Library/Java : The Java interfaces to WebObjects classes. (Solaris only)
    • Library/WebObjects/Adaptors : Contains WebObjects configuration files and adaptors.

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:

  • Your Apache server's CGI_Executables directory ( /Local/Library/WebServer/CGI-Executables ).
    • WebObjects : The WebObjects adaptor
  • Your server's document root directory
    • WebObjects : This directory should contain Documentation and Java subdirectories, plus a Frameworks subdirectory that contains directories for WOExtensions and DirectToWeb.
  • /System/Library directory
Check for these files and directories:
    • WebObjects/Executables : Contains WODefaultApp , the default application executable for scripted WebObjects applications
    • Frameworks/WebObjects.framework : WebObjects library of classes, plus header files (Developer installations only)
    • Frameworks/WOExtensions.framework : WebObjects Extensions framework, which contains extra dynamic elements and shared components
    • Java : The Java interfaces to WebObjects classes.
    • WebObjects/Adaptors : Contains WebObjects configuration files and adaptors.

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