1. Move to the <WebServer_root> directory or create a new directory for the Open SiteSearch suite components. This directory is referred to as the <WebZ_root> directory in this procedure.

2. Copy the installation files to your <WebZ_root> directory.

• UNIX: Copy the WebZInstaller_<version>.class file into your <WebZ_root> directory.
• NT: Copy the WebZInstaller_<version>.class file and the WebZInstaller_<version>.bat file into your <WebZ_root> directory.

3. Start the installation process:

• UNIX: From the command prompt in the <WebZ_root> directory, type "java WebZInstaller_<version>" and press Enter.
• NT: Double-click the WebZInstaller _<version>.bat file.

4. The installation program extracts the compressed Java class file and begins the installation. The Welcome screen appears.

5. Click Next at the bottom of the Welcome screen to move to the System Information screen.

6. Select the appropriate operating system from the Choose an Operating System drop-down list. Click Next to move to the WebZ Installation Root screen.

7. Enter the location where you want to install the WebZ software and the other Open SiteSearch components. The directory that appears in the WebZ Installation Root field on the WebZ Installation Root screen is your current directory. Be sure you include the full path name of the directory.

8. Click Next at the bottom of the screen to move to the System Configuration Information screen.

9. Enter the following information on the System Configuration Information screen:

UNIX and NT Fields

• JDK Location - the full path name of the Java Development Kit (JDK) on the host system. Example: user/java.
• Web Server CGI-BIN Directory - the full path name of the directory that contains any Common Gateway Interface (CGI) scripts used for the Web server and WebZ operations. If you are using the Apache server, this directory MUST be the same CGI-BIN directory that you defined in the WebZ Extension installation.
  Example: <WebServer_Root>/cgibin
• Web Server Document Root Directory - the full path name of the directory that contains all of the HTML and image files associated with the Web server and WebZ. This directory MUST be the same document root directory that you defined in the WebZ Extension installation.
  Example: <WebZ_Root>/htdocs
  
• Host Name IP Address - the Internet Protocol (IP) address of the host system.
  Example: 123.456.78.90
• SQLDriver Classname - The fully qualified class name of the Mini Structured Query Language (mSQL) driver. The default is com.imaginary.sql.msql.MsqlDriver, which is located in the imaginary.zip file in the <WebZ_root>/msql/classes/lib directory.

UNIX Fields

• miniSQL Host Name - the name of the host system that the Hughes Technology (mSQL) server runs on to provide user authentication to the WebZ OBI.
  Example: admin.anywhereU.edu
• miniSQL Port - the port number of the host system that the mSQL server runs on to provide user authentication to the WebZ OBI. The port number must be greater than 1024.
  Example: 1114
• miniSQL Process Username - the user name of the mSQL system administrator.
  Example: jsmith
• miniSQL Server Admin Email - the electronic mail (e-mail) address of the mSQL system administrator.
  Example: jsmith@anywhereU.edu

NT Fields

• Host Name - the name of the host system that your SQL server runs on to provide user authentication to the WebZ OBI.
  Example: admin.anywhereU.edu
• JDBC URL -the Uniform Resource Locator (URL) and protocols that the Java Database Connectivity (JDBC) driver uses to locate your SQL server.
  Example: jdbc:odbc:Accessdb

10. Click Next at the bottom of the screen to continue the WebZ installation.

11. You receive a message asking whether you want to overwrite <WebZ_root>/ini/HostMap.ini? Click Yes.

12. While the installation proceeds, you can follow its progress by reading the messages displayed. You will see the following messages, in this order:

Extracting files...

Configuring installation files. This may take several minutes, please wait...

Making backup files, please wait...

Cleaning up temporary files, please wait...

This part of the installation usually takes about 25 minutes.

13. When the installer completes, you see you see a screen that lists the files and directories extracted during the installation.

14. Click Finish to end the installation.

15. If you are using Netscape or IIS as your Web server, set the document root in the Web server configuration now.

16. Proceed to the Database Builder installation, if applicable.

1. Move to the <WebServer_root> directory or create a new directory for the Open SiteSearch Suite components. This directory is referred to as the <WebZ_root> directory in this procedure. Copy the ss<version>.webz.tar.Z and WebZInstaller_<version>.sh files into this directory.

2. Type "WebZInstaller_<version>.sh" at the command prompt in the <WebZ_root> directory and press Enter to execute the installation scripts.

3. You see the following prompt:

    Do you want to continue? [y]

Press Enter or type "y".

4. You receive a series of prompts asking you for information needed to complete the installation. Accept the default value that appears by pressing Enter at the prompt (a bracketed value appears after most prompts; this is the default). If there is no default or the default value is incorrect, type the necessary information and press Enter. Definitions of each prompt, in the order in which they appear, follow.

• Directory of Perl Interpreter - the full path name of the Perl interpreter.
  Example: /usr/perl
• Operating System - the operating system of your host environment. Enter the value for your operating system from those shown: "aix" (AiX), "osf1" (DIGITAL UNIX), "hpux" (HP-UX), "irix" (IRIX), or "sol" (Solaris).
  Example: sol
• WebZ Installation Root - the full path name of the <WebZ_root> directory.
  Example: /dove1/netscape/ss_prod
• JDK Location - the full path name of the Java Development Kit (JDK) on the host system.
  Example: /usr/java/
• Web Server CGI-BIN Directory - the full path name of the directory that contains any Common Gateway Interface (CGI) scripts used for the Web server and WebZ operations. If you are using the Apache server, this directory MUST be the same CGI-BIN directory that you defined in the WebZ Extension installation.
  Example: <WebServer_Root>/cgi-bin
• Web Server Document Root Directory - the full path name of the directory that contains all of the HTML and image files associated with the Web server and WebZ. This directory MUST be the same document root directory that you defined in the WebZ Extension installation.
  Example: <WebZ-root>/htdocs
• Host Name - the name of the host system that the Hughes Technology Mini Structured Query Language (mSQL) server runs on to provide user authentication to the OBI.
  Example: admin.anywhereU.edu
• Host Name IP Address - the Internet Protocol (IP) address of the host system.
  123.456.789.01
• miniSQL Port - the port number of the host system that the mSQL server runs on to provide user authentication to the WebZ OBI. The port number must be greater than 1024.
  Example: 1114
• miniSQL Process Username - the user name of the mSQL system administrator.
  Example: jsmith
• miniSQL Server Admin Email - the electronic mail (e-mail) address of the mSQL system administrator.
  Example: jsmith@anywhereU.edu
• SQLDriver Class - The fully qualified class name of the mSQL driver. The default is com.imaginary.sql.msql.MsqlDriver, which is located in the imaginary.zip file in the <WebZ_root>/msql/classes/lib directory.

5. A verification screen appears. Check this screen to ensure that the information you entered is correct. An example of the verification screen is shown below:

Directory of Perl Interpreter: /usr/perl WebZ Installation Root: <WebZ_root> JDK Location: /usr/java/ Web Server CGI-BIN Directory: <WebZ_root>/cgi-bin Web Server Document Root Directory: <WebZ_root>/htdocs Host Name IP Address: 123.456.78.90 Operating System: sol miniSQL Port: 1114 miniSQL Process Username: jsmith miniSQL Server Admin Email: jsmith@anywhereU.edu SQLDriver Classname: com.imaginary.sql.sql.MsqlDriver Is this correct? [y]

6. Is everything on the verification screen correct?

• Yes. Continue the installation by pressing Enter.
• No. Type "n" and press Enter to cycle through the prompts again. Edit any value that you need to change. When the verification screen appears again, press Enter to continue with the installation.

7. While the installation proceeds, you will see a number of messages. If no messages appear for a little while, do not be concerned. This part of the installation should take about 15 minutes.

8. When the installation script finishes, you see a message similar to the following:

WebZInstaller script Finished! creating ./config.status

9. If you are using Netscape or IIS as your Web server, set the document root in the Web server configuration now.

10. Proceed to the Database Builder installation, if applicable.