Table of Content

Creating a d.3 repository

A repository is a central storage location for systematically collecting documents and dossiers and managing them with the aid of metadata.

You can set up multiple d.3 repositories. Since each d.3 repository has its own database, the data in several d.3 repositories can be physically separated from each other, for instance, to enable you to implement different security and data backup concepts in parallel.

You can use up to 50 repositories in your d.3 system environment.

Each d.3 repository consists of the following components:

  • Document storage on the file server
  • Database with database connection
  • d.3 server processes in d.3 process manager, for managing the processes for each d.3 repository.
  • Configuration files in the directory d3server.prg

You create a d.3 repository to facilitate working with documents. In this article, you can learn about the steps required to create a d.3 repository.


We recommend creating a repository to test the configuration first (e.g. Test). You can transfer the configuration to a different repository (e.g. Production) later.

Starting to create the repository

In the Windows start menu, choose d.velop > Create d.3 repository to start the setup.

Defining the basic properties for the repository

You define the master data for the d.3 repository on the Repository creation configuration page.

In the Server ID field, enter the unique designation for the d.3 repository, which can consist of one or two upper case letters. Examples: T for your test environment or P for your production environment. You can save up to 999,999,999 data records (documents or dossiers) in a d.3 repository with a single-digit server ID. In a repository with a two-digit ID, the number is reduced to 99,999,999 data records.

You can no longer change the server ID after creating the d.3 repository.

The name of the repository is displayed in all the dialog boxes that the user can view.

Defining the storage location for storing documents

Specify the storage location on the Document storage configuration page.

If the directory for storing the documents refers to a server other than the d.3 application server, specify the directory as a UNC path.

Creating the d.3 database

On the Database configuration page, enter the information for the database.

Select the database system required to create the database.

If you want to create a database with Microsoft SQL Server, you can use the Database Creation button.

Perform the following steps in the d.3 DB Creation Wizard:

  • On the MSSQL connection data configuration page, enter the login details of a database user who has the server roles dbcreator and securityadmin at minimum. We recommend using an identical name for the database and the d.3 repository. Examples: D3T for your test environment or D3P for your production environment.
  • On the Driver selection configuration page, select the checkbox Create ODBC connection on this computer.
  • On the Database capacity configuration page, you have the option of determining the amount of storage space to be reserved for d.3. Activate the checkbox Use capacity for filegroup settings to individually define the size and number of documents.
  • On the Distribution of database files configuration page, define where you want to store the database files.
  • On the Database Creation configuration page, choose Install to start creating the database.

Then go to the Database configuration page to continue creating the repository.

To create the d.3 tables required for the repository automatically, perform the following steps:

  • Enter the user name that you used to create the database.
  • Enable the checkbox for creating d.3 tables.
  • Enter the database administrator’s password.

Defining your own database users

For the d.3 processes d3_server, d3_async and hostimport, database users are created and default passwords are defined automatically. For security reasons, we recommend setting your own passwords on the Database user configuration page. Optionally, you can also specify your own user names.

The database users are created just once per database server and are then valid for all the other repositories. You can use the same login details for all future repositories.

Finishing the creation of the repository

Select the Restart d.3 gateway checkbox to connect the new d.3 repository to the d.3ecm system environment.

You have now created a d.3 repository with a database and can continue checking the installation.

See also: _A_V_How can I transfer the configuration of one repository to another repository?