NAME

osdir − start an ObjectStore Directory Manager on a given host

SYNOPSIS

$OS_ROOTDIR/lib/osdir[ options ]

DESCRIPTION

Using the Directory Manager gives you a fast, convenient way to keep track of all Object Store databases at your site. 

In a Directory Manager database, persistent data (data that survives beyond the lifetime of the process that created it) is typically stored on multiple hosts. Each host generally contains one ObjectStore file system. An ObjectStore file system consists of one or more partitions, which may be either raw or operating system partitions.  All of a file system’s databases reside in these partitions. A database may span partitions, and the partitions themselves may be spread across multiple disks. 

Each ObjectStore file system has its own Server. A single site can have many ObjectStore file systems, each managed by a Server. 

ObjectStore file systems are organized into ObjectStore directories.  ObjectStore Directories form hierarchical structures just as do operating system directories. But ObjectStore directory hierarchies are independent of the operating system directory hierarchies, and form a logical rather than physical organization. For example, two databases in the same ObjectStore directory may be stored on different file systems, and two databases in different ObjectStore directories may be stored on the same file system. 

The Directory Manager is a daemon process that manages a hierarchy of these ObjectStore directories, and maintains permission modes, creation dates, owners, and groups for each entry. There can be several independent directory hierarchies at a given site, each managed by a different Directory Manager, and the same application can use databases in different hierarchies. 

The Directory Manager is actually an ObjectStore application, and stores its in formation in an ObjectStore database, the directory database. Directory databases are normal ObjectStore databases, except that they have no name. Each Server can store only one directory database. Thus there is a maximum of one Directory Manager per Server. 

On AIX, the Directory Manager is configured by parameter options that are read from the ODM database at startup. Additionally, you can specify various command line options by using an alternative means of invoking the Directory Manager, shown below. 

On AIX:

the Directory Manager is normally started at boot by the script $OS_ROOT DIR/etc/rc.objectstore. Note that if you wish to create multiple Directory Managers at your site, you must use chostore to set each one’s Local Mode parameter. 

The command line to start the Directory Manager is normally:

startsrc -s osdir

If you want to set up temporary special conditions when you start the Directory Manager, you can use the following command line, and specify one or more of the options listed below. 

$OS_ROOTDIR/lib/osdir options

On other platforms:

the Directory Manager is configured by various command line options and parameter file options that are read at startup. The pathname of the Directory Manager executable is $OS_ROOTDIR/lib/osdir. (See your system administrator or the installation instructions for information on setting OS_ROOTDIR.) 

The command line to start the Directory Manager is: $OS_ROOTDIR/lib/osdir options

OPTIONS

-F Foreground. This reverses the normal behavior, where the Directory Manager is forked off as a background process. 

-p filename ON AIX, specifies a file containing parameter settings that override those in the ODM database. On other platforms, specifies a parameter file to use during the startup process. The search rules for the parame ters file are the same as for the Server, except that the file name suffix is directory_manager_parameters instead of server_parameters. 

-R Outputs a script of ObjectStore shell commands (osmkdir, oschmod, oschown, and oschgrp) to stdout.  You can save the output to a file for use as a (1) snapshot of the Directory Manager’s state and/or (2) a script for rebuilding the Directory Manager after a crash. A typical use for -R might be as part of a nightly backup script. 

-v Shows parameter values at startup. This option says to print out the Directory Manager parameter values after starting. In addition, a compilation message is displayed. 

When run without -F, osdir returns 0 for success (full startup of the background daemon), 1 otherwise. 

SEE ALSO

ObjectStore Administration and Development Tools, chapter

ObjectStore 2.0  —  Last change: October 1992