HP Large Objects System Management Manual

HP Large Objects System Management Manual – 543599.001
4 Suggested Usage
4.1 Installation
Users should either modify the shell scripts supplied to reflect their environment, or
create their own scripts to perform the tasks covered. Users can run InstallOSS.sh
script directly to install the product in OSS environment.
At the minimum, it would be sensible to review the parameter values setup during the
running of metaData.sh to determine whether they suit the environment being created.
In order to setup a typical environment using the supplied scripts, one would run:
1) .profile (after renaming dotProfile to .profile)
2) createCatalog.sh
3) createObjectStore.sh
4) createPartition.sh (optional)
5) metaData.sh
After running these scripts, the SQL data is in place to start creating the BuddySpace
storage. This storage is created with the management APIs. Sample programs are
provided to indicate how to call the APIs. A typical installation would run in this
order:
1) Create as many BuddyGroups as are required by calling the
CreateBuddyGroup API. For a Large Object system required to store up to a 5
or 6 gigabytes of objects, one BuddyGroup usually suffices.
2) Create as many BuddySets as are required for each BuddyGroup by calling the
CreateBuddySet API. Multiple BuddySets are generally created, with one per
disk.
3) Start the Buddymon program. There must be one Buddymon program running
per BuddyGroup for the entire time that the Large Object system is in use.
See the buddymon section, for an example, of how to make the program run
persistently in the Guardian environment.
The Large Object system is then ready for use.
4.2 Using the Core APIs
With the Large Object system, it is possible to store and retrieve objects in a number
of ways, and performance is affected accordingly.
4.2.1 Typical Usage
The Large Object system is simple to use in the most efficient manner. The calling
application needs to initialise the storage by calling OpenBuddyGroup for a single
BuddyGroup. OpenBuddyGroup is a very expensive operation, and so should be done
once at start-up.
Once the BuddyGroup is open, the calling application may call PutBuddyObject to
store an object, GetBuddyObject to retrieve an object and DeleteBuddyObject to
destroy one. The core APIs only function for the currently open BuddyGroup.
Once processing is complete, CloseBuddyGroup closes all of the storage.
Page 28 of 37