You must install the entire Apache Web server even if you intend to use an existing Apache server to run the Open SiteSearch Suite. The Web server installation package contains the WebZ extension module that you need to configure your existing Apache server to access WebZ.

If you have an existing Apache Web server and you use the Web server only to run the Open SiteSearch software, OCLC recommends that you install all SiteSearch software in the same directory as your Web server.

All users:

Do not set a document root in Netscape or IIS until after you install both the WebZ Extension and WebZ. These servers use the same directory for HTML documents. Doing so creates a root directory for HTML documents (htdocs) that the installer cannot override.

1. Are you going to run SiteSearch under UNIX or Windows NT/2000?

• UNIX.
  • Which version of the Java Development Kit (JDK) are you using?
    • Version 1.3 or higher. Enter this command from the directory where the installers reside:
        java -jar SiteSearch4_2_1Installer.jar
       

    Note:

    If you do not have a graphics server running or if InstallShield does not work, enter the following command from the command line:      java -jar SiteSearch4_2_1Installer.jar -console

    
    
    • Version 1.2.2 or below. Enter this command from the directory where the installers reside:
        java -classpath \
        <fullpath_to_JDK>/lib/classes.zip:SiteSearch4_2_1Installer.jar
      
      

      Note:

      Do not include the backslashes on the command line. They are included only for readability. Insert a space in place of the first backslash. Do not insert a space in place of the second backslash.

• Windows NT/2000.
  • From Windows Explorer, double-click the SiteSearch4_2_1Installer.jar file.
  • If double-clicking the file doesn't work, open a DOS window and enter one of the commands shown for UNIX users, based on your JDK version.

2. The installer searches for your Java Development Kit (JDK). After it finds the JDK, it displays a Welcome screen.

3. Click Next> at the bottom of the Welcome screen.

4. Carefully review the source code license agreement. Use the scroll bars to scroll horizontally or vertically as needed. After reviewing the license agreement:

• Click the Approve radio button to accept the terms specified in the license agreement and continue the installation. Then click Next>.
            OR

• Click the Disapprove radio button to cancel the installation. Then click Cancel>.

5. Specify the directory where you want to install SiteSearch in the Directory Name text box. The default is the directory where the installer resides. To specify a different directory, type its name in the text box or click Browse to select the directory. (The directory must already exist on the host system.)

6. Enter information about the server where you are installing SiteSearch.

Click Next> to continue.

7. Which operating system are you using?

• UNIX. Go to step 8.
• Windows NT/2000. Go to step 10.

8. If you are installing under UNIX and you selected Apache as your Web server, you see a screen requesting the following information about the Apache Web server.

Click Next> to continue.

9. If you are installing under UNIX, you see a screen requesting additional information about your Web server.

Click Next> to continue.

10. Enter the following information about the SiteSearch access component. While the installers use this information, you do not have to use the Access component to operate WebZ and/or Record Builder.

Click Next> to continue. Then go to step 12.

11. If you are installing under Windows NT/2000, you see a screen requesting information about the SiteSearch access component. Enter information about your SQL server. WebZ and Record Builder for Windows NT/2000 supports Microsoft SQL server as the relational database management system for WebZ's access control database, as part of the SiteSearch Access component. While the installers use this information, you do not have to use the Access component to operate WebZ and/or Record Builder.

Click Next> to continue.

12. Indicate whether you want to install WebZ only or WebZ and Database Builder by clicking the appropriate radio button:

• WebZ. Includes WebZ, the WebZ extension, and the WebZ source code. For UNIX, this also includes a preconfigured Apache Web server and the WebZ extension for Netscape. For Windows NT, it includes the WebZ extensions for both Netscape and IIS. (The WebZ extensions take little space and SiteSearch functions properly with both WebZ extensions installed.)
• Database Builder. Includes everything included in a WebZ-only installation, plus Database Builder (the Pears database engine, Record Builder, and the SiteSearch Database Operations Tool (SSDOT)), and
  and the Database Builder source code.

Click Next> to continue.

13. The installer displays a confirmation screen, which includes the <WebZ_root> directory, the components that will be installed, and the amount of disk space required for the installation. Click:

• Next> to begin installing files.

• Back> to modify the components to be installed or the <WebZ_root> directory. To change <WebZ_root>, you need to click Back> several times to find the screen where you specify this directory.

14. While the installation proceeds, you can follow its progress by reading the messages displayed and the progress bar.

15. When the installer completes, click Finish to end the installation.

16. Is your operating system Solaris?

• Yes. Are you using JDK 1.3.x?
  • Yes. Verify that the text in dark bold blue print has been added to the two places shown below in the jassi section of your ssmgr.hostname file in <WebZ_root>/scripts:
    

    jassi)
     if [ $# -eq 1 ]
      then
       Java -Dfile.encoding=ISO-8859-1 ORG.oclc.jassi.JaSSI \
         $ROOTDIR/ini/JaSSIServer.ini &
     else
       Java -Dfile.encoding=ISO-8859-1 ORG.oclc.jassi.JaSSI \
         $ROOTDIR/ini/$ININAME &
    fi
     ;;

    Note:

    The backslashes (\) are included for readability. DO NOT add them to ssmgr.hostname.

  • No. Go to step 17.
• No. Go to step 17.

17. Are you planning to use Record Builder?

• Yes. Go to step 18.
• No. Go to step 21.

18. Set the startup and maximum sizes of the memory allocation pool for the JaSSIRB server.

• UNIX. Open <WebZ_root>/scripts/ssmgr.hostname (where hostname is the name of the system where you installed your SiteSearch environment.
  
  
  • Edit the jassi section of this file. Add -Xms8m -Xmx200m, as shown in dark bold blue text:

    jassi)
     if [ $# -eq 1 ] 
      then
       Java -Xms8m -Xmx200m ORG.oclc.jassi.JaSSI \
          $ROOTDIR/ini/JaSSIServer.ini &
      else
       Java -Xms8m -Xmx200m ORG.oclc.jassi.JaSSI  \
          $ROOTDIR/ini/$ININAME & 
     fi

  • Go to step 21.

• Windows NT/2000. Open the <WebZ_root>\scripts\ssmgr.bat file. Edit the jassi section of this file as follows:
  

  • Edit the jassi section of this file. Add -Xms8m -Xmx200m, as shown in dark bold blue text:

    jassi)
     if [ $# -eq 1 ] 
      then
       Java -Xms8m -Xmx200m ORG.oclc.jassi.JaSSI \
          $ROOTDIR/ini/JaSSIServer.ini &
      else
       Java -Xms8m -Xmx200m ORG.oclc.jassi.JaSSI \
          $ROOTDIR/ini/$ININAME & 
     fi

  • Go to step 19.

19. For Windows NT, edit the following variables in the [servername] section of <WebZ_root>\ini\JaSSIServer_rb.ini so that they read as follows:

LowUsedMemory  = 45000
MedUsedMemory  = 50000
HighUsedMemory = 55000

20. Edit the StartThreshold and StopThreshold variables in the [JaSSI] and [JaSSIRB] sections of <WebZ_root>\ini\OpServe_rb.ini so that they read as follows:

StartThreshold = 4.0
StopThreshold  = 2.25

21. If you are using Netscape or Microsoft IIS, configure your WebZ server to use the WebZ extension, as described in the following documents:

• Configuring Netscape to Use the WebZ Extension
• Configuring Microsoft Internet Information Server (IIS) to Use the WebZ Extension

Note:

The installer establishes version 1 of the WebZ Out-of-the-Box Interface (OBI, version 1) as the default interface. To modify this, edit the following variables in the JaSSIServer.ini file: Document Root in the [JaSSI] section. The name and/or path to the interface style and interface display configuration files referenced in the [InterfaceStyles] and [InterfaceDisplayGadgets] sections.