Managing ObjectStore

oscopy: Copying Databases

 The oscopy utility makes a copy of an ObjectStore database. A key benefit of oscopy is that it performs transaction-consistent database copying without incurring locking conflicts.

oscopy cannot copy segment-level permissions and it cannot copy ObjectStore/Single databases. For copying ObjectStore/Single databases, use the standard operating system copy facilities.

Syntax

oscopy source target



source 

Specifies the ObjectStore file or rawfs database to be copied. 



target 

Specifies the pathname for the copy. ObjectStore either creates this database or overwrites it.













oscopy -R source_dir target_dir



source_dir 

Specifies the pathname of the rawfs directory to be copied.



target_dir 

Specifies the target rawfs pathname. If this directory does not exist, ObjectStore creates it if its base name exists. ObjectStore copies the source directory recursively into the target directory. 













oscopy source ... target 



source 

Specifies the rawfs or file databases to be copied. 



target 

Specifies the rawfs directory to contain the copies.

Options
-R
Instructs oscopy to copy a directory recursively. You must specify a rawfs directory for both the source and the destination pathnames. The top-level name of the destination pathname must exist before you issue oscopy.

Description

 This command has three forms. The first copies a file or rawfs database to another file or rawfs database. The second recursively copies a rawfs directory and its contents to another location. The third copies a database or databases to a rawfs file system. In this form, you can specify either file or rawfs databases as sources; the target must always be a rawfs directory.

Restrictions

You cannot specify wildcards in database pathnames.

Transaction consistency

When you specify more than one database as a copy source, oscopy ensures transaction consistency among the specified databases for a particular moment in time.

Copying a rawfs database to a file database

Copying a rawfs database to a file database results in the loss of segment-level access control information.

Database size might change

Your database might appear to have a different size after you use oscopy to copy it. This is because the Server might allocate the copy in a way that is different from the way it allocated the original database. Also, when you perform oscopy, the size of the database is set. The Server can make exactly the right amount of space available for the copy of the database.

Variables that affect pathname interpretation

There are many conditions that can affect pathname interpretation:

When you copy a file and the result is not what you expect, be sure to consider these conditions.



[previous] [next]

Copyright © 1999 Object Design, Inc. All rights reserved.

Updated: 03/11/99 11:19:07