---

Installing WebObjects on Windows

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

• 100% Pentium-compatible computer

• Microsoft Windows 2000 Professional or Server

• 256 MB of RAM

• at least 1 GB of available hard disk space (except on a FAT file system where you’ll need considerably more space)

Before You Install

Before installing the WebObjects components you need to make sure that some other details are taken care of:

• If you have a previous version of WebObjects installed, it is important that you first remove the old version before installing WebObjects 5.2.

• WebObjects works in concert with your Web server software. If you haven’t installed the Web server software already, you should do so before installing WebObjects. The WebObjects installer will ask you for the location of your cgi-bin and document root directories; make sure to take note of these locations before proceeding.

• WebObjects Deployment requires the Java 2 Platform, Standard Edition version 1.3.1 Java Runtime Environment (JRE). WebObjects Developer requires the Java 2 Platform, Standard Edition version 1.3.1 Software Development Kit (SDK).

  If you plan to use the JNDI (Java Naming and Directory Interface) adaptor to access information in an LDAP (Lightweight Directory Access Protocol) data source you also need to install the Java Platform, Standard Edition version 1.1.8 Java Development Kit (JDK).

  Install the appropriate Java components (available at http://java.sun.com) before proceeding.

  

  Warning: When installing the JDK, do not add the Java Runtime Environment directory to the Windows PATH environment variable. Doing so may break the Java extension mechanism.

Installing WebObjects

1. Log in to an account that has administrator privileges.

2. Insert the WebObjects CD in your computer’s CD-ROM drive and navigate to the Windows folder.

3. Open the Setup application. (Depending on your system settings, the name may be Setup.exe or just Setup.) The installer for WebObjects starts.

4. Click Next. Read the software license agreement. If you agree to its terms, click Yes to continue with the installation.

5. Follow the onscreen prompts to the Customer Information screen. You are asked for a serial number, which is included with your WebObjects CD.

6. Continue to the Setup Type screen. Apple recommends that you perform a Typical installation. Perform a Custom installation only in the following circumstances:

   • You need to install WebObjects in a location on the file system other than the default (C:\Apple\).

   • You are installing WebObjects Developer on a system running the Japanese version of Windows. In this case you need to install the IME Support package, which is part of the Extras component.

   • You are installing WebObjects Developer and need to install the GNU source code with Apple modifications (part of the Extras component).

   If you do a Custom installation follow these guidelines:

   • Do not install WebObjects into a system-related folder such as WinNT, directly to the root of a disk, or to any path or folder whose name contains spaces. If you do, the software may not work.

   • Make sure that the entire WebObjects root directory path (for example C:\Apple\) is no longer than twelve characters and does not include any spaces. If the root directory path is too long, the software may not work. WebObjects will resolve NEXT_ROOT to the location where you install WebObjects instead of the default, C:\Apple\.

   • Apple recommends that you do not deselect any of the default packages during a Custom installation.

7. Follow the onscreen prompts to complete the installation. You need to restart your computer to finish the WebObjects installation.

Once you have restarted, you can verify that the application server is running by connecting to http://localhost:1085. You should see a page that displays the configuration information for wotaskd.

Installing Web Server Adaptors

The installer puts the WebObjects CGI adaptor into the cgi-bin directory you specified during installation and configures WebObjects to use it. WebObjects also includes a number of Web server adaptors. To use another adaptor, see the adaptor installation instructions in NEXT_ROOT\Library\WebObjects\Adaptors.

These adaptors are provided in source form so that you can customize them for your needs. Instructions for rebuilding the WebObjects Web server adaptors accompany the source code in NEXT_ROOT\Developer\Examples\WebObjects\Source\Adaptors\.

Installing Third-Party JAR Files

WebObjects 5.2 includes some 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). These JAR files are provided in the ThirdPartyJars directory on your WebObjects 5.2 CD. The JDBC extensions and JTA JAR files should be put into the location specified in your JavaConfig.plist along with any of the necessary JDBC drivers. (If you are installing WebObjects Development, install the Java 1.1.8 JDBC driver, not the Java 2 JDBC driver.) Any other JAR files you need should be put into NEXT_ROOT\Local\Library\WebObjects\Extensions.

Removing WebObjects

You can remove WebObjects 5.2 using Add/Remove Programs in the Control Panel. This requires you to be logged in to an account with administrator privileges. You need to restart your computer to completely remove WebObjects. For information on removing previous versions of WebObjects, see the documentation that came with the version you wish to remove.

Upgrading Your License

You may upgrade your WebObjects Developer license to a WebObjects Deployment license on a particular computer without reinstalling the software. Run the WebObjects 5 License Upgrader application (Start > Programs > WebObjects > WebObjects 5 License Upgrader) as a user with administrator privileges. This application prompts you for the license key obtained from Apple. This application is installed only with WebObjects Developer.

---