Solaris Post-Installation Steps
After you've finished installing on Solaris, perform the following steps:
- Install the Java Native Threads Pack
- Rebuild the Executable WODefaultApp
- Change the HTTP Server Process Owner
- Customize Documentation URLs
Install the Java Native Threads Pack
If you are running Solaris 2.5.1 (with patches 103566, 103600, and 103640), you must install the Java Native Threads Pack. You can download the Native Threads Pack from JavaSoft's Java Development Kit website.
Rebuild the Executable WODefaultApp
On Solaris, the Enterprise Objects Framework cannot automatically load your database's client library and its adaptor, as it can on other platforms. Because of this, you must rebuild the WODefaultApp executable, which is installed with WebObjects and is used to run purely scripted applications. If you don't rebuild this executable, any purely scripted applications you run with WODefaultApp won't be able to access the database.
include $(MAKEFILEDIR)/pdo-eoadaptor-linking.make
Change the HTTP Server Process Owner
You should change the user used to launch server processes if you want to be able to autostart WebObjects applications. You autostart a WebObjects application when you type its URL directly in the web browser without starting its executable first. Autostarting is a convenience that some people prefer to use when testing applications; however, you don't have to enable autostarting. In fact, autostarting is not recommended for WebObjects deployment sites. If you can't autostart, you can still launch applications from the command line.By default, the user nobody owns CGI processes, and so it is used to launch autostarted WebObjects applications. This user does not have access to the NEXT_ROOT environment variable. Without access to the NEXT_ROOT environment variable, autostarted applications won't be able to locate OpenStep and WebObjects resource files.
This problem won't affect you if you've installed WebObjects under the root directory (that is, NEXT_ROOT is /). If you installed WebObjects in some other directory, change your HTTP server's configuration so that CGI processes are launched by a user with the appropriate environment setup rather than user nobody. This will allow you to autostart web applications from the browser.
You may want to keep the user nobody for security reasons. If so, you can still launch WebObjects applications by hand in a command shell window. Only autostarting will not work.
Customize Documentation URLs
In the WebObjects documentation, links from the documentation to example WebObjects applications are of the form:
http://localhost/cgi-bin/WebObjects/Examples/WebScript/ApplicationNameAs long as you are accessing the documentation from the HTTP server machine (that is, localhost) and the HTTP server stores scripts in a directory named cgi-bin, these links work. If you are accessing the documentation over the network, or the HTTP server doesn't call its scripts directory "cgi-bin", the links will be broken.
We've provided a script, curls.sh, that modifies these URLs to use the name of the host and scripts directory specific to your installation. The script is in $NEXT_ROOT/NextLibrary/Documentation/NextDev/WebObjects/Installer.
Assuming your computer's hostname is "Mars" and its scripts directory is "Scripts", you could modify the URLs in the documentation by running these commands in a terminal window:
cd $NEXT_ROOT/NextLibrary/Documentation/NextDev/WebObjects/Installer curls.sh -h Mars -c Scripts -F WOPagesSee the curls.sh script itself for more information about its operation.
Table of Contents Next Section