---

Installing WebObjects Deployment on Solaris

In this section:

System Requirements
Before You Install
Installing WebObjects
Installing Web Server Adaptors
Installing Third-Party JAR Files
Removing WebObjects
Upgrading Your License

System Requirements

• Solaris 8

• 256 MB of RAM

• at least 1 GB of available hard disk space

Before You Install

Before installing WebObjects, you should remove any previously installed WebObjects components.

WebObjects Deployment needs the Java Runtime Environment (JRE) version 1.3.1. If you do not already have it installed, install the JRE available at http://java.sun.com before installing WebObjects.

WebObjects Deployment works in concert with your HTTP server software. If you haven’t installed an HTTP server already, do so before installing WebObjects Deployment.

Before installing, you need to determine if you are going to perform a full installation or install only the Web server adaptors. If you plan to install the WebObjects application server on another computer than the computer (or computers) running your Web server, do an adaptor-only installation on the computer running a Web server; perform a full installation on the computer that you will use as your WebObjects application server. The installer gives you this option.

During installation, you will be prompted to enter the paths to your HTTP server’s cgi-bin (or scripts) directory and document root directory. Although you can specify a temporary directory for the installed files, you may want to note the paths before beginning your installation. By default Apache uses /var/apache/cgi-bin and /var/apache/htdocs respectively. If you do not set these paths during the installation you will need to manually copy the appropriate files after installation:

• Copy /opt/AppleNOAdaptor/Library/WebObjects/Adaptors/CGI/WebObjects into your cgi-bin directory.

• Copy the /opt/AppleNOAdaptor/Library/WebObjects/WODocumentRoot/WebObjects directory into your Web server’s document root directory.

Make sure to have a valid license key handy.

Installing WebObjects

1. Log in as the root user.

2. If necessary, mount the CD-ROM.

3. Navigate to Deployment/SOLARIS/WebObjects/ in the mount directory of the CD-ROM.

4. Start the install script with this command:

   ./install.sh

   Note: If your system displays filenames from the CD-ROM in uppercase, you need to start the install script using uppercase shell commands.

5. Follow the onscreen prompts to complete the installation.

As the installer finishes, it mentions three installation details to finalize:

• Add the following line to your httpd.conf file:

  Include /opt/Apple/Library/WebObjects/Adaptors/Apache/apache.conf

• Enable WebObjects services to start when your computer starts (if you want this and did not choose that option when prompted) by typing:

  /opt/Apple/Library/WebObjects/Executables/WOServices enable

• Define the NEXT_ROOT environment variable in your shell startup script. Unless you have chosen a nonstandard location to install WebObjects, this should be defined as /opt/Apple.

With the completion of the installation process, all of the necessary files are copied to the target computer, the cgi-bin and document root directories are created (if necessary), an uninstall script is created, startup scripts for WebObjects services are created (if requested), and WebObjects services are started (if requested).

This completes the installation of WebObjects. If you did a full installation, you can verify a successful installation of WebObjects Deployment by connecting to port 1085 of your computer. You should see a page that displays the configuration information for wotaskd.

If you did an adaptors-only installation, you can verify that the adaptors are functioning properly or troubleshoot incorrect behavior using the following procedure:

1. Stop your Web server.

2. As the root user: touch /tmp/logWebObjects

3. Start your Web server.

This enables WebObjects logging. When your Web server starts, it creates a file in /tmp named WebObjects.log. The existence of this file verifies that your adaptor is correctly installed.

Installing Web Server Adaptors

If you specify a cgi-bin directory during installation, the installer puts WebObjects CGI adaptors into this directory and configures WebObjects to use them. WebObjects also includes a number of other Web server adaptors. To use one of these, see the online adaptor installation instructions in NEXT_ROOT/Library/WebObjects/Adaptors/. These adaptors are provided in source form and can be customized. For instructions on rebuilding these WebObjects Web server adaptors, see NEXT_ROOT/Developer/Examples/WebObjects/Source/Adaptors/BuildingInstructions.html.

Installing Third-Party JAR Files

WebObjects 5.2 includes third-party JAR files that you need for applications that use Enterprise JavaBeans (EJB), JavaServer Pages (JSP), Java Servlet integration, Web services, or Java Database Connectivity (JDBC). The JAR files you need are provided for you in the ThirdPartyJars directory on your WebObjects 5.2 CD. They should be copied into NEXT_ROOT/Local/Library/WebObjects/Extensions.

Removing WebObjects

1. Stop your Web server.

2. Find and kill any WebObjects processes that may be running.

   ps -ef | grep -i wo will help you in finding running WebObjects processes.

3. From the root level of your directory structure (/), run NEXT_ROOT/Library/Executables/uninstall.sh.

Upgrading Your License

To apply a deployment license to an existing deployment installation, you need only change the installed serial number. Using a text editor, edit NEXT_ROOT/Library/Frameworks/WebObjects.framework/Resources/License.key and replace the license key found there with the new license key obtained from Apple.

---