QCopy

Ian Tree  09 May 2012 15:37:24

The DXTools QCopy Application Package

Distributions for Version 2.6.2

QCopy copies Notes databases, it is as simple and as complicated as that. The application is driven by a queue of transactions, each transaction is a request to copy a single database, or a collection of databases. Each copy operation is controlled through settings supplied in each transaction. The settings support many kinds of common operations that are involved in transformations of large volumes of databases. Transformations such as consolidations, mergers, de-mergers and all sorts of migrations can be addressed using QCopy.

QCopy is fast and resilient. Each individual database is copied by a multi-threaded copy engine and multiple databases can be copied in parallel allowing sustained high rates of data transfer.

The QCopy application is constructed as a Domino Server Add-In task, as such it is perfectly suited to unattended operations.

Features:

• Domino Server AddIn task
• Fully controllable from the server console
• Queue database driven for integration with migration or other tooling
• Automatic "throttling" of requests based on how busy servers are
• Makes replica or non-replica copies
• ACL is automatically copied
• Folder contents are automatically maintained in replica copies
• Folder contents are optionally maintained in non-replica copies
• Variable threads control the degree of network saturation
• Very, Very fast especially across slow WAN links
• Deletion stubs are OPTIONALLY copied by QCopy
• Private design elements can be copied
• Full-Text Index settings can be copied
• Select the ODS of the database copy
• Optionally re-compress attachments using LZ1  
• Enable local security (encryption)
• Domino 5,6,7,8 & 9 compliant

QCopy is a C++ application constructed on the DXCommon application kernel supporting Domino version from 6.0 through 9.0 on both Widows & Linux server platforms.

The copy engine at the heart of the QCopy application is mature and well tested component having been used in production environments for many years. It has been used in different configurations to copy over 300,000 databases with more than 200Tb of data.

The following options can be applied to individual copy operations.

• Adding an administrative group to the ACL.
• Disabling the “Enforce Consistent ACL” setting.
• Creating replica or non-replica copies.
• Copying private design elements.
• Copying deletion stubs.
• Copying Full-Text Index settings and building the Full-Text Index.
• Disabling agents in the copy.
• Building all view indexes in the copy.
• Enabling transaction logging on the copy.
• Setting the design template name on the copy.
• Refreshing the design of the copy.
• Running an agent in the copy of the database.
• Performing a final replication between the copy and the original databases.

Downloads

Click (once) on the icon of the file you want to download and select "Save" when asked what you want to do with the file.

Source Packages

File	File Name	Contents/Usage	File Size
Windows:
QCopy	QCopy-20602-117.zip	DXTools QCopy Source Package Version: 2.6.2 for Windows	46 Kb
Linux:
QCopy	QCopy-20602-117.tar.gz	DXTools QCopy Source Package Version: 2.6.2 for Linux	33 Kb

Executable Files

The executable files below are provided as a convenience, the distribution is intended to be at the source level with users building their own executable files.

File	File Name	Contents/Usage	File Size
Windows (32 bit):
QCopy.exe	QCopy.exe	DXTools QCopy Executable Version: 2.6.2 for Windows 32 bit	316 Kb
QCopy.pdb	QCopy.pdb	DXTools QCopy Program Debug Database Version: 2.6.2 for Windows 32 bit	1,899 Kb
Windows (64 bit):
QCopy.exe	QCopy.exe	DXTools QCopy Executable Version: 2.6.2 for Windows 64 bit	316 Kb
QCopy.pdb	QCopy.pdb	DXTools QCopy Program Debug Database Version: 2.6.2 for Windows 64 bit	1,899 Kb
Linux:
qcopy	qcopy	DXTools QCopy Executable Version: 2.6.2 for Linux	363 Kb

Installing the QCopy Control Database

The installation of the control database is done from a “Virtual Template” that is available on the internet, this section assumes that you have available and installed the Remote Database Create (Windows:
RDBCreate.exe Linux: rdbcreate) tool. If you do not have this tool then download the DXTool source for RDBCreate and build it. Refer to the “Using RDBCreate” manual.

Install the Database

From a command window go to the Notes Executable directory where RDBCreate exists enter the following command.
RDBCreate [server name] [database name] [templateURL] -V

Where:

[server name] is the abbreviated name of the server on which you want to install the control database.
[database name] is the name of the control database relative to the notes data directory.
[templateURL] is the URL for the Virtual Template you wish to install.

For the QCopy Control Database, use the following URL:
http://hmnl.nl/HMNL/DX/VTTDepot.nsf/Payloads/qcopy22.manifest/$File/manifest.xml

LINKS

Information	Source Packages	Documentation	Articles
Background DX Reference Environments DX Development Environments DX Support DX Services Frequently Asked Questions License	DX Common Code QCopy QMove QACLMorph RDBCreate DXIPA DXTell SPZap	DX Application Design Guide DX Kernel API Reference DX Component Architecture DX Class Catalogue Using QCopy Using QMove Using QACLMorph Using RDBCreate Using DXIPA Using DXTell Using SPZap	Heavy Lift Computing Autonomic throughput optimisation

• Comments [0]