Once you have installed WebObjects on your system, you must set it up to work with your Web server. To do this, you need to know where to find the various WebObjects files and directories and what to do with them.
WebObjects resides under the <NeXT_Root>/NextLibrary directory.
- On NEXTSTEP, the <NeXT_Root> directory is the root directory of the startup disk.
- On Solaris, the <NeXT_Root> directory is the /usr directory.
- On Windows NT, you use the WebObjects SETUP utility to specify a <NeXT_Root> directory. By default, the SETUP utility creates the C:\NeXT directory for <NeXT_Root>. See Windows NT platform dependencies for more information.
Remember to check NeXT Software's WebObjects Release Notes regularly for updated information.
The WebObjects directory resides under the <NeXT_Root>/NextLibrary directory. It contains a ReadMe.html file with installation instructions as well as these directories
- <NeXT_Root>/NextLibrary/WebObjects/cgi-bin contains the WebObject Adaptor
- <NeXT_Root>/NextLibrary/WebObjects/Examples contains a ReadMe and example WebObject programs
- <NeXT_Root>/NextLibrary/WebObjects/Executables contains the DefaultApp program
On NEXTSTEP or Solaris you may have an additional WebObjects directory to which the live WebObjects directory links. For example
- <NeXT_Root>/NextLibrary/WebObjects-Beta1
- <NeXT_Root>/NextLibrary/WebObjects-C
This scheme lets you store several versions of WebObjects. You link whichever you choose to the live WebObjects directory. By default, the latest version of WebObjects is linked to the WebObjects directory.
On UNIX-based systems, whether or not you received a Web server from NeXT, WebObjects provides a WebServer directory which resides under the <NeXT_Root>/NextLibrary directory. It contains two directories
- <NeXT_Root>/NextLibrary/WebServer/cgi-bin contains the WebObjects Adaptor.
- <NeXT_Root>/NextLibrary/WebServer/htdocs/WebObjects contains an Examples directory that is a link to the examples provided under the <NeXT_Root>/NextLibrary/WebObjects directory.
If you received a Web server from NeXT Software, Inc., then this Web server resides under the <NeXT_Root>/NextLibrary/WebServer directory, and these links have been made for you.
On Windows NT systems, WebObject's setup installation utility asks you to enter information about the location of your <NeXT_Root> directory as well as your Web server's cgi-bin and htdocs directories. The Setup program copies the appropriate files to these locations. See the description of Windows NT platform dependencies for more information.
On NEXTSTEP or Solaris systems, you must create links from the corresponding directories of your Web server.
If you're installing an upgraded version of WebObjects, be sure to clean up the following
- Make sure that you do not have any old /tmp/WebObjects.* files left.
- On NEXTSTEP and Solaris systems, verify the time-stamp of the WebObjects file in your Web server's cgi-bin directory.
- On Windows NT, you may need to rename your WebObjects, DefaultApp, and any compiled WebObjects applications with a .exe extension, depending on the Web server you are using.