Ozone Administration and Configuration Manual

Rob Lapensee

Ozone Documentation License, Version 1

This document is free software; you can redistribute it and/or modify it provided that the terms of the GNU Library General Public License as published by the Free Software Foundation version 2 of the License; and the following terms are met.

The Ozone Database Project <ozone@ozone-db.org>

Included in the ozone distribution is code and documentation made available by other copyright holders and under different licenses. All these licenses allow worldwide, royalty free distribution, whether alone or as part of a larger product. License, copyright and disclaimer of this software is included in this directory.

The document is Copyright (C) 1997-2001 by SMB GmbH, Rohrteichstr. 18, 04347 Leipzig, Germany, All rights reserved.

You must give prominent notice with each copy of the work that the document is used in it and that its use are covered by this License. You must supply a copy of this License. If the work during execution displays copyright notices, you must include the copyright notice for the Library among them, as well as a reference directing the user to the copy of this License.

The name ozone must not be used to endorse or promote software products derived from this software without prior written permission of SMB.

Software products derived from this document may not be called ozone nor may ozone appear in their names without prior written permission of SMB.

This document is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Library General Public License for more details.


Table of Contents

Administration and Configuration
Administration
Overview
Build a New Database
Starting up and shutting down Ozone
Backing up an Ozone Database
Creating Users
Removing Users
Listing All Users
Creating Groups
Removing Groups
Adding Users to Groups
Listing All Groups
User Control Notes
Configuration
Configuration Parameters
Setting Parameters
Altering Parameters
Classic Store vs. Wizzard Store

Administration and Configuration


When the database is created, there will be an administrator user in the admin group. When the database is started with the -uUSER, then the specified USER will be created if it does not already exist.

By utilizing the org.ozoneDB.ExternalDatabase.openDatabase(URL) without the username or password specified will give access to the database under the administrator user and admin group.

The org.ozoneDB.ExternalDatabase.openDatabase(URL,user,password) must be used if the objects need to be segregated by user or group.

The password parameter in the openDatabase method does not seem to do anything. Any password can be used as long as the user name matches.

The access parameter in the ExternalDatabase.createObject method can be used to specify read or update access to the object created. The org.ozoneDB.OzoneInterface class has the access bits. These bits can be combined (or them together) to give additional access.

ozoneDB.store
Normally set to org.ozoneDB.core.wizardStore.WizardStore. This specifies the class to be used to store the Ozone database. WizardStore is a re-write of the original ClassicStore.
ozoneDB.wizardStore.clusterSize
Ozone will cluster objects together into files of clusterSize or less. If the compression flag is set to true, the cluster files may be smaller then the set clusterSize. If there is a single object that exceeds the cluster size, then the file size will exceed clusterSize.
ozoneDB.wizardStore.tableCacheSize
The number of significant bits of a hash value for the 1st level direct mapped cache. Internally, this is used in the instance variable idTable in the WizardStore class.
ozoneDB.wizardStore.clusterSizeRatio
Bytes per container (whatever a container is).
ozoneDB.wizardStore.tableBufferSize
The number of b-tree pages in the second level cache. Used in the WizardStore class in the creation of the idTable instance variable.
ozoneDB.wizardStore.tableSubtableSize
The number of significant bits for one b-tree level. Used in the WizardStore class in the creation of the idTable instance variable.
ozoneDB.wizardStore.compressClusters
If set to true, the GZIPOutputStream will be used in the creation of the cluster files, which will reduce the total disk space utilized in the storing of the Ozone database.
ozoneDB.fileLog and ozoneDB.stdoutLog
Through out the code there are 'env.logWriter.newEntry' statements that will dump various information out. Each of these is marked with one of (INFO, WARN, ERROR, DEBUG, DEGUG2, DEBUG3) so, the more of these that are set, the more stuff ends up in the log file (ozoneDB.fileLog) or standard out (ozoneDB.stdoutLog)
ozoneDB.dbID
I presume some sort of global id that would span multiple Ozone databases. This is normally set to zero.
ozoneDB.adminPort
ozoneDB.port
The port that Ozone will be listening on.
ozoneDB.classicStore.tableCacheSize
ozoneDB.classicStore.clusterSpaceSize
ozoneDB.classicStore.clusterSize
ozoneDB.classicStore.tableBufferSize