loading table of contents...

2.7.1.3. Adding a product

If an already existing product (e.g. which was created with another Docmenta installation) shall be added to the product list, two possibilities exist:
Moving the product directory
If the storage-type of the product is filesystem-storage or embedded-database-storage, then one possibility is to just move the product directory to the default location <Base-Directory>/docstores of the target installation and then to restart the web-server (where <Base-Directory> is the configured document-store directory of the target installation).

Figure 2.7.14. Moving the product directory

After restart, Docmenta lists the added product together with the other products that are located in the docstores folder of the target installation.
Adding the product directory as an external product
The second possibility is to add the existing product as an external product. To do this, click the "Add product" button next to the product list. This opens following dialog:

Figure 2.7.15. Adding an external product

Enter a Product-ID and, in case of filesystem- or embedded-database-storage, enter the filesystem path of the product. Click "Okay" to add the product to the application configuration.
If the directory path of the external product changes, the new path can be configured by selecting the product from the list and clicking the "Change path" button :

Figure 2.7.16. Changing the product path

In the opened dialog, enter the new product directory path and click "Okay". Note that if you change the product path, then you also have to move the files from the previous filesystem-location to the new location (this has to be done manually, i.e. moving the files to the new location is not done by Docmenta).
Important!
When using external products, it has to be assured, that the external product is only accessed by one Docmenta installation at the same time. Parallel access to the same product directory from different Docmenta installations might damage the data structure!
You can also add a product that is stored in an external database. Instead of entering the filesystem path, select "External Database (JDBC)" from the storage type selection list and enter the connection data as described in Section 2.7.1.2, “Creating a new product”:

Figure 2.7.17. Adding a product from an external database