Main -> Documentation -> Getting Started -> Installing and Configuring the Open SiteSearch Suite -> Installing Database Builder (Version 4.1.0/4.1.1) |
Installing Database Builder (Version 4.1.0/4.1.1) Table of Contents Introduction This document explains how to install version 4.1.0 or 4.1.1 of the SiteSearch Database Builder. The Open SiteSearch Database Builder installation process installs the database utility programs, the SiteSearch Database Operations Tool (SSDOT), the Record Builder application, and a local test database (localERIC) on your host system. See Installing Database Builder (Version 4.0.x) for installing previous versions of the WebZ extension and Installing Database Builder (Version 4.1.2a) for the latest SiteSearch version. Before completing this installation, review the information in the Installing and Configuring the Open SiteSearch Suite and OCLC SiteSearch Suite System Requirements documents to ensure that you meet the system requirements and have all of the information that you need to install Database Builder successfully. If you have not already installed the Web server/WebZ Extension and the WebZ software, OCLC recommends that you do so before you install the Database Builder software.
For Example
Record Builder and Web Servers The Database Builder installation includes Record Builder, Record Builder is an end-user application built on WebZ technology that harnesses Database Builder's administrative utilities to allow the creation, modification, and maintenance of Newton searchable databases for local collections of such things as images, sound files, Web sites, and data. The Database Builder installation automatically installs Record Builder, but its use is optional. The Database Builder installation asks you to specify the Web server port for Record Builder. If you are using the Apache Web server provided as part of the WebZ/Web Server Extension installation for UNIX systems, or a Netscape Web server, specify another port for Record Builder's Web server. If you are using the Microsoft Internet Information Server (IIS) as your Web server, it is not possible to run WebZ and Record Builder simultaneously on a single machine. Your options are to:
You can install the WebZ software using one of two methods, the Java Installation Procedure (UNIX and NT) (a graphical user interface), or the Perl Installation Procedure (UNIX).(a command line interface). Java Installation Procedure (UNIX and NT) Before you install the Database Builder software, configure your system environment variables. Read the instructions below, and make sure that you have the following installation files:
Time Required for Installation Plan on about 20 minutes to install Database Builder using the Java installer. The specific time required depends on the speed of your processor and the system load at the time you perform the installation. A Note to UNIX Administrators The following instructions assume that you have configured your UNIX DISPLAY variable for your desktop display and started an X server session and terminal emulator window with a connection to the system hosting the Database Builder installation. Directions Follow the instructions below to install Database Builder using the Java installer.
|
||||||||||||||||||||||||||||||||||||||
Perl Installation Procedure (UNIX)
Before you install the Database Builder software, read the instructions below. You should have the following installation files:
Time Required for Installation
Plan on about 10 to 15 minutes to install Database Builder using Perl scripts. The specific time required depends on the speed of your processor and the system load at the time you perform the installation.
Directions
Follow the instructions below to install Database Builder using Perl scripts.
Note: | Install Database Builder under the same user name (user account) that you used to install the WebZ Extension and WebZ. To conform to good UNIX system administration practices, we recommend that you do not use root as the user name. |
1. Copy the Ss<version>.dbbuilder.tar.Z and DbBuilderInstaller_<version>.sh files into the <WebZ_root> directory. |
|||
2. Type "DbBuilderInstaller_<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: ******************************************************** Installing the Open SiteSearch Database Builder - 4_1_1. ******************************************************** 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.
|
|||
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.
|
|||
6. Is everything on the verification screen correct?
|
|||
7. While the installation proceeds, you see a number of messages. If you see the following messages, ignore them. They do not affect successful completion of the installation. If no messages appear for a little while, do not be concerned. This part of the installation usually takes between 5 and 10 minutes. |
|||
8. When the installation script finishes, you see a message similar to the following:
|
|||
9. Add the local version of the localERIC test database to your WebZ Out-of-the-Box Interface (OBI).
dB* = dbs/localERIC.ini |
|||
10. Check your Database Builder license for the basis of your licensing agreement. Is your Database Builder license based on the number of simultaneous users?
|
|||
11. Open the OpServe_rb.ini configuration file (located in <WebZ_root>/ini/) with a text editor. | |||
12. Specify the number of simultaneous Database Builder users in your license by editing the MaxSimultaneousUsers variable in the [RecordBuilderLicense] section of OpServe_rb.ini. Then save and close this file.
|
|||
13. Are you planning to use Record Builder?
|
|||
14. Set the startup and maximum sizes of the memory allocation pool for the JaSSIRB server. 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 as follows:
|
|||
15. Edit the following variables in the [servername] section of <WebZ_root>/ini/JaSSIServer_rb.ini so that they read as follows: LowUsedMemory = 20000 MedUsedMemory = 30000 HighUsedMemory = 40000 |
|||
16. If you wish to use the sample databases provided with Record Builder, register these databases with SSDOT. Use each database's top-level directory (in <WebZ_root>/dbbuilder/dbs) as the database's name in SSDOT. | |||
See Also
Installing and Configuring the Open SiteSearch Suite
Installing the WebZ Extension (Version 4.1.0/4.1.1)
Installing WebZ (Version 4.1.0/4.1.1)
databases.ini Configuration File
The SiteSearch Database Operations Tool
(SSDOT)
[Main][Documentation][Support][Technical
Reference][Community][Glossary][Search]
|