Home for HMNL Enterprise Computing


Ian Tree  09 May 2012 15:37:24

The DXTools QCopy Application Package

DX Tools

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.


  • 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.


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 Name


File Size

Download zip
QCopy-20602-117.zipDXTools QCopy Source Package Version: 2.6.2 for Windows46 Kb
Download tgz
QCopy-20602-117.tar.gzDXTools QCopy Source Package Version: 2.6.2 for Linux33 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 Name


File Size

Windows (32 bit):
Download exe
QCopy.exeDXTools QCopy Executable Version: 2.6.2 for Windows 32 bit316 Kb
Download pdb
QCopy.pdbDXTools QCopy Program Debug Database Version: 2.6.2 for Windows 32 bit1,899 Kb
Windows (64 bit):
Download exe
QCopy.exeDXTools QCopy Executable Version: 2.6.2 for Windows 64 bit316 Kb
Download pdb
QCopy.pdbDXTools QCopy Program Debug Database Version: 2.6.2 for Windows 64 bit1,899 Kb
Download executable
qcopyDXTools QCopy Executable Version: 2.6.2 for Linux363 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


[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:



Source Packages