KB: Changing Documents Folder Path

From RangerMSP Wiki - PSA software for MSPs and IT services providers
Jump to navigation Jump to search

Introduction

When transferring your CommitCRM Installation from 1 server to another, the need to move the CommitCRM Accounts Documents Folder also comes up many times. The problem here is that if you move the directory, then the database will not know where to look for the documents you have imported into CommitCRM.

How to change the database paths

We have a find&replace utility designed for updating the Docs path in the files imported in to CommitCRM pointing to the old location.

There is a 3 step process that will update your docs paths in your database to the new location, update your accounts to the new location, and update your default settings.

Here’s the steps:

IMPORTANT: Please backup the Commit folder and sub-folders and only then:

Step 1 - Update the path for existing docs:

  • Make sure you are using CommitCRM version 5.0 (you can check this from the Help > About window). If you are using a version prior to 5.0, please contact us again for a different link to the program.
  • Save it in folder:
<server>\Commit\Utils
  • Run the downloaded program
  • Set the original/old path
  • Set the new path of the new server

NOTE: The path should point to the root folder where the documents are stored

e.g. <server>/x/y/z/docs/
  • Make SURE you end each path you set with a slash ( / )
  • Click Replace
  • Done.
  • Run Commit and make sure the path was updated successfully.

Step 2 - Update the Account Defaults

Note: The default folder location for your accounts is not modified by the document path updater program. You should update the relevant default folders for your Accounts (via the Account's Details tab > Docs Dir). This is relevant only for accounts who have the default directory defined.

Step 3 – Update the Global defaults for new accounts

  • Set the default folder to be used for new accounts by going to:
Tools menu > Options > Documents tab > Default Documents Folder