Hi. How can we help?

Migrate DOCman 2 to a different site

Last updated: 22 October 2022
  1. Backup, the backup
  2. Export from the old site
  3. Import in the new site
  4. Move files
  5. Check menu items
  6. Check modules

How it works

Requirements

Migrating data requires the latest DOCman version (2.1.x) on both sites. You should first upgrade both EXTman and DOCman to the latest maintenance release in both sites.

If you need to migrate a DOCman 1.x installation check our DOCman 1.x to DOCman 2.x upgrade tutorial. 

What data will be migrated?

Everything except the uploaded files. You will need to move the uploaded files manually.

1. Backup, the backup

Before you start the migration process please make a full backup of your site.

2. Export from the old site

  1. Upgrade EXTman and DOCman to the latest versions
  2. Go to EXTman in the components list and click Export on the sidebar
  3. Select DOCman from the component list and click Export
  4. After the process is complete, you should have an export file downloaded

3. Import in the new site

  1. Install the latest EXTman and DOCman versions in the new site
  2. Go to EXTman in the components list and click Import on the sidebar
  3. Select the export file you downloaded from the old site to start the import process

4. Move files

You also need to move your files to the new site. They are typically found in the joomlatools-files directory in the root of your site.

Move your files from OLD_SITE/joomlatools-files into the NEW_SITE/joomlatools-files directory.

5. Check menu items

DOCman menu items from the old site are migrated into a Migrated menu items menu type.

We recommend that you move these menu items to the appropriate location using the Menu Manager in the administrator instead of creating new ones.

6. Check modules

DOCman modules from the old site are also migrated. You might need to set their position to a different value if the new site is using a different template.