Main -> Documentation -> OCLC SiteSearch Record Builder -> Record Builder Administration -> Operating Record Builder -> Operating Record Builder on UNIX

Operating Record Builder on UNIX

 

Contents

Introduction
Document Conventions
Requirements
Record Builder in a SiteSearch Environment
Starting the Record Builder Application
Starting and Stopping the Apache Server
Starting and Stopping the MySQL Server (beginning with SiteSearch 4.1.2)
Starting and Stopping the mSQL Server (SiteSearch 4.1.1 and earlier)
Using the ssadmin Interface
Shutting Down the Record Builder Application
Starting and Stopping Individual Record Builder Components


Introduction

This topic provides procedures for operating OCLC Database Builder's Record Builder application on UNIX platforms (AiX, DIGITAL UNIX, IRIX, Solaris, HP-UX (versions 4.1.1 and earlier), or Linux (beginning with version 4.1.2).

Note:  If you are using the Netscape Web server, refer to Netscape documentation for instructions regarding server administration.

Document Conventions

  • <WebZ_root> is the location of the environment that contains the Record Builder application.
  • Commands you type appear in quotes, like this: "poll".
  • SQL server is the database server used in the Access component:
    • MySQL (beginning with SiteSearch 4.1.2)
    • mSQL (SiteSearch 4.1.1 and earlier versions)
  • sql_dir is the your SQL server's top-level directory:
    • <WebZ_root>/mysql for MySQL (beginning with SiteSearch 4.1.2)
    • <WebZ_root>/msql for mSQL (SiteSearch 4.1.1 and earlier versions)

Requirements

Before starting these procedures, complete the following tasks:

Because Record Builder is an application included with Open SiteSearch Database Builder, it is installed concurrently with Database Builder.


Record Builder in a SiteSearch Environment

In a SiteSearch environment that includes Record Builder, a single OpServe manages both WebZ and Record Builder. Record Builder has its own Web server port and Web server extension, JaSSI, ZBase, and Access servers (JaSSIRB, ZBaseRB, and AccessServerRB, respectively), and a Lock server. This is the usual configuration, although it is possible to set up a Record Builder-only environment.

The procedures in this document assume that you are using a SiteSearch environment with both WebZ and Record Builder.

Return to Contents


Starting the Record Builder Application

Follow these steps to start Record Builder (and WebZ, if desired):

1. Verify that that the Web server for Record Builder is running. If you are using the Apache server included with the Database Builder installation, see Starting and Stopping the Apache Server. Otherwise, see your Web server's documentation.

2. Shut down WebZ if it is currently running.

3. Do you want to restart WebZ when you start Record Builder?

  • Yes. Verify that the Web server for WebZ is running. If you are using the Apache server that was included with the WebZ installation, refer to Starting and Stopping the Apache Server (for WebZ). Otherwise, see your Web server's documentation.
  • No. Go directly to step 4.

4. Are you using the Access component to provide staff authentication and and authorization for Record Builder (and WebZ, if applicable)?

  • Yes. Assuming that you configured the Access component for Record Builder, start the SQL server:

  • Note: 

    WebZ and Record Builder share the same SQL server, but use separate databases for storing authentication and authorization data. You must configure the Access component separately for WebZ and Record Builder.


  • No. Go directly to step 5.

5. Start the ssadmin utility. In the <WebZ_root>/scripts directory, type "ssadmin_rb" and press Enter. This starts the JaSSIRB, ZBaseRB, Lock, and AccessRB servers for Record Builder and the JaSSI, ZBase, and Access servers for WebZ.

Note:  The ssadmin_rb command starts the ssadmin utility, which starts the OpServe if it is not already running. OpServe then starts the Record Builder and WebZ servers listed in the OpServe_rb.ini configuration file.
6. After displaying a series of messages, the ssadmin interface opens and you see the SSAdmin Cmd> prompt.
7. Use the ssadmin poll command to verify that the JaSSIRB, ZBaseRB, AccessRB, and Lock servers for Record Builder and the OpServe, JaSSI, ZBase, and Access servers for WebZ have started.

Note: 

If you did not start the SQL server software or configure the Access component for Record Builder, the AccessRB server shuts down immediately after starting up.

Return to Contents


Using the ssadmin Interface

The ssadmin utility has an interface to the Operations server, OpServe, for both WebZ and the Record Builder application. This interface allows you to monitor system status and issue commands directly to the system components.

While you are working in ssadmin, the command prompt changes to "SSAdmin Cmd>". Some commonly-used ssadmin commands are:

  • poll, which lists the servers that are currently running
  • help, which lists and briefly describes all ssadmin commands
  • quit, which closes the ssadmin interface without shutting down any servers
  • term, which shuts down all currently-running servers

For detailed information about all ssadmin commands, refer to the ssadmin Command Reference.

Return to Contents


Starting and Stopping the Apache Server

Issue the following commands to start and stop the Apache Web server included with your Database Builder installation:

Starting Apache

  • In the <WebZ_root>/scripts directory, type "apache_rb start" and press Enter. This starts the Apache server for Record Builder.

Stopping Apache

  • In the <WebZ_root>/scripts directory, type "apache_rb stop" and press Enter. This command stops the Apache server for Record Builder.

Starting and Stopping the MySQL Server (beginning with SiteSearch 4.1.2)

follow the instructions below to start and stop the MySQL AB's MySQL server to allow you to use the SiteSearch Access component with Record Builder. If you do not use the Access component for authentication and authorization for Record Builder staff, you do not need to start the mSQL server.

Starting the MySQL Server

  • In the <WebZ_root>/scripts directory, type "mysql start" and press Enter.
Note: 

You must issue this command before you start the Record Builder application for the Access component to function correctly. If the Record Builder application and WebZ are already running, use the term command to stop the system in ssadmin, start the MySQL server, and then restart Record Builder.

Stopping the MySQL Server

  • In the <WebZ_root>/scripts directory, type "mysql stop" and press Enter.
Note: 

If you stop the MySQL server without stopping the Access component or the Record Builder application, the Access component cannot authenticate staff members before they start a session; they will have search, write, delete, view, and admin privileges for all local databases populated and maintained with Record Builder.

Return to Contents


Starting and Stopping the mSQL Server (SiteSearch 4.1.1 and earlier)

Follow the instructions below to start and stop the Hughes Technologies Pty. Ltd.'s Mini Structured Query Language (mSQL) server to allow you to use the Site Search Access component. If you do not use the Access component for authentication and authorization for Record Builder staff, you do not need to start the mSQL server.

Starting the mSQL Server

  • In the <WebZ_root>/scripts directory, type "msql start" and press Enter.
Note: 

You must issue this command before you start the Record Builder application for the Access component to function correctly. If the Record Builder application and WebZ are already running, use the term command to stop the system in ssadmin, start the mSQL server, and then restart Record Builder.

Stopping the mSQL Server

  • In the <WebZ_root>/scripts directory, type "msql stop" and press Enter.
Note: 

If you stop the mSQL server without stopping the Access component or the Record Builder application, the Access component cannot authenticate staff members before they start a session; they will have search, write, delete, view, and admin privileges for all local databases populated and maintained with Record Builder.


Return to Contents


Shutting Down the Record Builder Application

Perform the following procedure to shut down the Record Builder application (and WebZ as well if it is currently running):

1. Start the ssadmin utility. From the <WebZ_root>/scripts directory, type "ssadmin_rb" and press Enter.

Note:  Because OpServe is already running, no servers start up this time when you issue the ssadmin_rb command.
2. After displaying a series of messages, the ssadmin interface opens and you see the SSAdmin Cmd> prompt.

3. To shut down all of the Record Builder servers (JaSSIRB, ZBaseRB, AccessRB, and Lock) and all WebZ servers, type "term" and press Enter from the "SSAdmin Cmd>" command prompt. The OpServe terminates each of the Record Builder and WebZ servers and returns you to the system command prompt.

Refer to Starting and Stopping Individual Record Builder Components for instructions about stopping a single Record Builder or WebZ component. It is also possible to shut down the Record Builder application without shutting down WebZ or vice versa.

Note: 

You need to stop the Web server and the SQL server separately. See Starting and Stopping the Apache Server, Starting and Stopping the MySQL server, and Starting and Stopping the mSQL Server for further information. If you just shut down WebZ as well, see Starting and Stopping the Apache Server (for WebZ).

Return to Contents


Starting and Stopping Individual Record Builder Components

Use the ssadmin start and stop commands to start or stop individual Record Builder components (JaSSIRB, ZBaseRB, and AccessRB). For example, you can stop all Record Builder servers individually and leave the WebZ servers running or just shut down a specific server(s).

Return to Contents


See Also

Operating the WebZ System on UNIX
mSQL Scripts and Templates


[Main][Documentation][Support][Technical Reference][Community][Glossary][Search]

Last Modified: