Administration Tools - oocopyfd

Printer-friendly version
Creates a complete copy of a federated database, placing all the copied files in the specified directory.
oocopyfd
-fdnumber fdId
[-host hostName] -dirpath path
[-lockserverhost lockServerHost]
[-fdname fdSysName]
[-exists ask | delete | quit]
[-standalone]
[-notitle]
[-quiet]
[-help]
[bootFilePath]
Options
-fdnumber fdId
Integer identifier of the new federated database. This number must not be the same as the original federated-database identifier (in the boot file for the original federated database). The maximum identifier is 65533.
Warning: The maximum identifier is 32767 if you are copying a pre-Release 9.0 federated database, and the copy is to be accessed by unrebuilt pre-Release 9.0 applications.
-host hostName
Host on which to place the copied files. If you omit this option, the default host is:
n
The current host, if -dirpath specifies a local path.
n
The host implied by -dirpath, if an NFS mount name is specified.
If -dirpath specifies a Windows UNC share name, hostName is set to the literal string oo_local_host; any value you specify is ignored.
-dirpath path
Path to the directory in which to place the copied files. If the -host option specifies a remote system, the path value must be full, not relative.
-lockserverhost lockServerHost
Lock-server host for the new federated database.
-fdname fdSysName
System name of the new federated database.
-exists ask | delete | quit
Action to take if a filename clash exists between the original system-database file and a file in the destination directory.
ask Prompts whether to overwrite the existing file. If the answer is No, the program terminates. No is the default.
delete Overwrites the file in the destination directory.
quit Terminates without copying the database to the destination directory.
The default value is ask.
-standalone
Nonconcurrent mode. Use this option only if the lock server for the specified federated database is stopped. If the lock server is running, the tool reports an error and terminates.
-notitle
Suppresses the copyright notice and program title banner. Useful when invoking the tool from another tool or product.
-quiet
Suppresses all normal program output.
-help
Prints the tool syntax and definition to the screen.
bootFilePath
Path to the boot file of the federated database to be copied. You can omit this argument if you set the OO_FD_BOOT environment variable to the correct path.
Discussion
This tool is useful for preparing to deploy an existing federated database. It finds all the files of the federated database, copies them to one directory, updates all catalogs with the location of the copied files, and writes a new boot file. The copy is fully operational.
(HA) You may not copy a federated database that has multiple autonomous partitions. Before you can use oocopyfd, you must choose a partition that best represents the federated database, transfer any unique databases from the other partitions into that partition, and then delete the other partitions.
This tool obtains an exclusive write lock on the federated database for the duration of the copy operation.

Date: 
Tuesday, October 30, 2012
Product: 
Objectivity/DB
Version: 
10.2.1
10.2
10.1.4
10.1.2
9.4.1