Main -> Documentation -> Database Builder – Pears  -> SSDOT Registration Procedures for a Pears Database

SSDOT Registration Procedures for a Pears Database

Before you can update or maintain a Pears database using SSDOT for Pears, you must first register it. As part this registration, you name the database and declare the location of its database description configuration file. By supplying this initial information, SSDOT for Pears is then able to find the rules for creating a new Pears database and it is able to derive the names and locations for other incidental files and directories. Registration information for a Pears database does not have to remain static, though. After initially registering a Pears database in SSDOT for Pears, you can change, print, or delete its registration information by selecting the Edit Registration option off the Registration Menu. For example, you may change your mind about where you want to store log files or backup copies of the database. The procedure below walks you through the initial registration activity that you must perform on each Pears database in order to manage it within the SSDOT for Pears environment.

Contents

Prerequisites
SSDOT Registration Procedure


Prerequisites

Before you can register a Pears database in SSDOT for Pears, you need to complete the following tasks:


SSDOT Registration Procedure

Follow the steps below to register a new Pears database in SSDOT.

1.Change directories to the <WebZ_root>/dbbuilder/pearsExes subdirectory.

 

2. Which operating system are you using?

  • UNIX: Type ssdot at the system prompt.
  • Windows NT: Double-click on the ssdot.bat file.


Result: The following ssdot prompts should appear:

 

-----------SiteSearch Database Operations Tool----------

Type [newton] to do Legacy SSDOT Administration
or
Press [ENTER] key to do Pears Database Administration

--------------------------------------------------------

>

3. Press the Enter key.

Result: The following Main Menu should appear:

#### SSDOT Pears Database Administration ####

Main Menu

1. Database Registration
2. BER Records
3. Database Creation and Maintenance
4. Database Backup
5. Advanced Options
6. Exit SSDOT

Working Database: No database selected

Type "l" To LIST available databases
Type "s" To SET a working database
Type "u" To UNSET the working database

Press [ENTER] key to return to Main Menu
>

4. Go to the Registration Menu by selecting 1 from the Main Menu and then pressing the Enter key.

Result: The following SSDOT Registration Menu should appear:

#### SSDOT Pears Database Administration ####

Registration Menu

1. Add Database
2. Remove Database
3. Edit registration
4. Print registration
5. Exit SSDOT

Working Database: No database selected

Type "l" To LIST available databases
Type "s" To SET a working database
Type "u" To UNSET the working database

Press [ENTER] key to return to Main Menu
>

5. Select 1 and press the Enter key to begin adding a database to the Pears SSDOT environment.

Result: The following prompt appears:

Name of database (must be unique):

6. Type a unique name for your new database and press the Enter key.

Example: Name of database (must be unique): marcus

 

Result: The following prompt appears:

Database description file:

7. Type the full path to the database description configuration file.


Example: Database description file: <WebZ_root>/dbbuilder/dbs/marcus/marcusdesc.ini

Result: The following confirmation information and prompt appear:

Database Name=marcus
Database File=<WebZ_root>/dbbuilder/dbs/marcus/marcus.pdb
Description File=<WebZ_root>/dbbuilder/dbs/marcus/marcusdesc.ini
Backup Directory=<WebZ_root>/dbbuilder/dbs/marcus/backups
Log Directory=<WebZ_root>/dbbuilder/dbs/marcus/logs
Zbase File=Not Set

Is information correct? (yes/no)

8. Is the information correct?
  • Yes: Type "yes" and press the Enter key to complete the registration procedure and return to the Registration Menu.
  • No: Type "no" and press the Enter key.


Result: The following edit menu appears:

################################################################
Database Name = marcus
Database File = <WebZ_root>/dbbuilder/dbs/marcus/marcus.pdb
Description File = <WebZ_root>/dbbuilder/dbs/marcus/marcusdesc.ini
Backup Directory = <WebZ_root>/dbbuilder/dbs/marcus/backups
Log Directory = <WebZ_root>/dbbuilder/dbs/marcus/logs
Database Config File = <WebZ_root>/ini/dbs/marcus_pears.ini

################################################################
Field to edit:
1. Database name
2. Database file
3. Database description file
4. Backup directory
5. Logs directory
6. Database configuration file

Type "s" to SAVE edits
Type "c" to CANCEL edits
>

Follow the instructions on the edit menu to correct the appropriate file names or directory paths and then type "s" and press the Enter key.

9. Press the Enter key to go back to the Main Menu.

See Also

Pears System Overview
Creating a New Pears Database
Pears Database Description Configuration File



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

Last Modified: