dbcopy (1)

Name

dbcopy - GroupWise Database Copy utility

Syntax

dbcopy /source_directory /destination_directory
dbcopy [-b] [-i] [-t] [-v] [-w] /source_directory /destination_directory
dbcopy -m [-d] [-p] [-f] [-s] [-a] [-u] [-k] [-o] [-l]
                                /source_directory /destination_directory

Description

The GroupWise Database Copy utility (DBCopy) copies files from a live GroupWise domain, post office, or remote document storage area to a static location for backup. During the copy process, it prevents the files from being modified, using the same locking mechanism used by other GroupWise programs that access databases. This ensures that the backed-up versions are consistent with the originals even when large databases take a substantial amount of time to copy.

The DBCopy utility is not installed automatically with the rest of the GroupWise software. The DBCopy RPM is located in the /admin subdirectory of your software distribution directory (/opt/novell/groupwise/software). When you install the RPM, the dbcopy executable is placed in the /opt/novell/groupwise/agents/bin directory.

In addition to backups, the DBCopy utility is used in conjunction with the GroupWise Server Migration Utility, which helps you migrate GroupWise data from NetWare or Windows to Linux. Some startup switches can be used for both backups and migration. Other startup switches are used only for migration.

Options

Usage Options:

source_directory

Specifies the full path to the domain directory, post office directory, or remote document storage area directory.

destination_directory

Specifies the full path to the directory where you want to copy the domain, post office, or remote document storage area.

-b

Copies a remote document storage area associated with a library, including all subdirectories and compressed BLOB (binary large object) files in which library documents are stored.

-i mm-dd-yyyy

Indicates that you are performing an incremental copy of only those files with the specified date or newer.

-t

Specifies the number of copy threads. The default is 5. Valid values range from 1 to 10.

-v

Turns on verbose logging. The DBCopy log file is named mmddgwbk.nnn. The first four characters represent the date. A three-digit extension allows for multiple log files created on the same day. The log file is created at the root of the destination domain, post office, or document storage area directory. In addition to status and error messages, it lists any remote document storage areas associated with a post office.

-w

Turns on continuous logging to the screen.

-m

Copies all directories and files associated with a domain, post office, or document storage area as part of a migration.

-d

Indicates migration of a domain.

-p

Indicates migration of a post office.

-f

Indicates that this is the first pass of the migration process.

-s

Indicates that this is the second pass of the migration process.

-a

Specifies the IP address to bind to for the migration process. The default is all available IP addresses.

-u

Specifies the TCP port number for status requests during the migration.

-k

Skips collecting database size information during the migration.

-o

Skips the second copy of the post office offiles directory during the migration

-l

Performs the GroupWise Check function of storelowercase on the migrated GroupWise databases. Its purpose is to do an “in-place” conversion of files and directories to lowercase, rather than as part of a copy operation. For a post office, it also updates the guardian database with the new, lowercase names.

For example, you could use this functionality if you have a domain or post office located on a SAN that was mounted for access by the GroupWise NetWare agents, but you now want to run the GroupWise Linux agents for the domain or post office.

Help Options:

-h , --help , -?

Displays the help information and exits.

Files

/pathname/mmddgwbk.nnn

Log file created at the root of the destination directory.

Examples

This program normally runs as root.

/opt/novell/groupwise/agents/bin/dbcopy /gwsystem/acct /backups/acct

Copies a post office to a backup location.

/opt/novell/groupwise/agents/bin/dbcopy --b /gwsystem/acct_library /backups/acct_library

Copies a library to a backup location.

Authors

Copyright 2004-2010, Novell, Inc.. All rights reserved.

See Also

gwtmstmp (1).

To report problems with this software or its documentation, visit Novell Bugzilla.