Skip to Content Java Solaris Communities Partners My Sun Sun Store United States Worldwide

»  Spotlight Articles
»  Projects
»  Publications
»  People
»  Awards
»  Events
»  Downloads
»  Internships
»  Contrarian Minds
»  About Sun Labs

Specifying the Store Location

In order to support very large object spaces, a persistent store may span several files and/or raw disk partitions. To simplify adminstration this information is specified in a configuration file. The location of the configuration file, as an absolute pathname, is given to the OPJ Virtual Machine using the -store argument.

For example:

  -store /usr/mjj/TestStore.pjc

Configuration File Format

The configuration file format is a sequence of ASCII characters, separated into sections that cover specific aspects of store management. These are Session, Log, Recovery and Store. A section is begun by its name in angle brackets and terminated by a new section name or the end of the file. Comments are specified by ## characters and continue until and end-of-line character is encountered.

A persistent store has two parts, a log and the store proper. Ultimately all objects ends up in the store proper, and we will refer to this as the object store when we need to distinguish this from the log. The log is used during the stablization phase of a checkpoint, and during restart, to ensure that a stabilization appears atomic in the face of application or system failure.

The location of the log and the object store must be provided in the configuration file. Both of these may be specified as an operating system file, or a raw (disk) partition. If performance is a serious consideration, it is advantageous to keep the log and the object store on separate disks, so that head movement is minimized. Simple applications with modest store sizes typically do not need to worry about this. Similarly raw partitions offer some performance benefits, but reduce flexibility and require more adminstration.  

Standard Filename Extensions

You may use any filename extensions that  you choose, but we recommend that you consider observing the following convention:
  • Configuration file:  .pjc
  • Object Store file:   .pjs
  • Log file:            .pjl
  • Logical archive file:  .pja

Sample Configurations

Most applications will work correctly with a standard configuration and will only require the location of the log and store segments to be specified. As a convenience, three sample configurations are provided that correspond to small, medium and large application store sizes.  The maximum store size for these three configurations is as follows:
  • Small:       32MB
  • Medium:      256MB
  • Large:       1GB
Many applications, especially during the development phase, will work acceptably using the small configuration.

To use these sample configurations, you must copy and edit them to localize the path to the log file and store segments.

For instant prototyping, the configuration tmp.pjc, which places the log in /tmp/opj.pjl and the store in /tmp/opj.pjs can be used in single-user installations.


Please mail us comments, questions, and bug reports.
Tutorial Home Page

Last changed: Dec 7th 1999

Questions and comments to forest-info@sunlabs.com
Would you recommend this Sun site to a friend or colleague?
Contact About Sun News Employment Privacy Terms of Use Trademarks Copyright 1994-2008 Sun Microsystems, Inc.