This guide provides the steps necessary for migrating your GlobalSearch and GlobalCapture installation to a new server. It is strongly recommended that this guide is reviewed in its entirety before beginning the migration process. Failure to follow these steps accurately may result in an unusable/broken GlobalSearch or GlobalCapture installation.

Important Notes

Step 1) Before You Begin

Before you begin the migration process, the following steps will need to be taken.

  1. Fully back up your GlobalSearch and GlobalCapture installation as detailed in our Back Up GlobalSearch and Back Up GlobalCapture documentation.
  2. Confirm that the destination server meets the current GlobalSearch and GlobalCapture Infrastructure and Hardware Requirements.
  3. If you are currently using GlobalSearch 4.1.0 or older, it is recommended that the old server is upgraded to at least version 4.1.1.
  4. If upgrading to the latest versions of GlobalSearch and GlobalCapture, download and extract your installation media to the new server. For media and registration serials, please contact Square 9 Fulfillment at

Step 2) Install and Prepare SQL on the Destination Server

Note that this step can be skipped if you are not migrating your SQL Server. Only perform these steps if you do not plan on using the same SQL server as the old GlobalSearch installation.

  1. Install Microsoft SQL Server on the destination server. This should be performed separately from the GlobalSearch/GlobalCapture installation. It is recommended that SQL Server Management Studio (SSMS) is also installed, to help with database migration. Media and documentation can be found on Microsoft's Web Site.
  2. Back up your Square 9 databases from the old SQL server to disk as a BAK file. Instructions and documentation can be found on Microsoft's Web Site.
  3. Restore the Square 9 databases to the new SQL instance from the BAK files, as documented on Microsoft's Web Site.
  4. On the new server, remove all references to the SSAdministrator user and SSAdmin group from the SQL instance security and from the database security for all migrated databases (including any system databases such as master).
  5. If you are not using the same SQL server as before, edit the values for "ConnectionString" in the tables SSMaster.dbo.ssConnectionStrings and SSCapture.dbo.ssConnectionStrings.

Step 3) Perform a Full Server Installation of GlobalSearch and GlobalCapture on the New Server

  1. Perform a Full Server installation of GlobalSearch on the new server, as detailed in our Install GlobalSearch documentation. When prompted, do not select “Complete” for your setup type. Instead, select “Custom”.
  2. During the installation, you will be prompted if you want to use Active Directory authentication or Local Server authentication, as detailed in our Install GlobalSearch Server documentation. If you were previously using one authentication type and would like to switch to the other), then all GlobalSearch security would need to be rebuilt. For this reason, it is recommended that the same authentication type is kept.
  3. If installing GlobalSearch 4.5.2 or older, do not select “create a new GetSmart database instance.” when prompted. Instead, select “Choose an existing SQL instance for use with GlobalSearch”.
  4. When selecting the SQL instance, choose the new SQL instance containing the migrated SQL databases (or the existing SQL instance if SQL is not being migrated).
  5. When prompted to enter your registration serial, leave the field empty. Your registration serials will not be valid if they have been used to register a different server. You can still fully install GlobalSearch unregistered.
  6. If you intend to apply a GlobalSearch release update, run the update installer after the GlobalSearch Server installation is complete.
  7. Once GlobalSearch is fully installed and updated, begin installing GlobalCapture as appropriate for your version of GlobalSearch. As with the GlobalSearch installation, you must perform a Full Server installation. Do not select any demo options. Your other choices (authentication type, SQL Server, etc.) should be the same as when the GlobalSearch server was installed. Details can be found in our Install GlobalCapture documentation.
  8. If you intend to apply a GlobalCapture release update, run the update installer after the GlobalCapture Server and Engines installations are complete.

Step 4) Migrate Your Documents

  1. Copy your documents from the old server on to the new server. By default, these will be kept in C:\GlobalSearch (or C:\SmartSearch if an older version was originally installed). The entire C:\GlobalSearch folder should be migrated.
  2. If the file paths on the new server are not the same as the file paths on the old server, then the paths will need to be updated in your SQL databases. (e.g., if they were kept in "C:\GlobalSearch\archive" on the old server but will be kept in "D:\GlobalSearch" on the new server).

Step 5) Migrate Your Mapped PDFs for GlobalForms/Frevvo Forms

This only applies to GlobalSearch servers that were importing forms from GlobalForms or Frevvo Forms.

  1. On the old server, locate the KAOS folder found in C:\GetSmart. Copy this folder to GetSmart on the new server.

Step 6) Migrate your Mongo Database

GlobalCapture 2.1.1 or later

  1. Use the Workflow Migration utility on the old server to export your GlobalCapture workflows and batch history to a file. If you are using GlobalCapture 2.1.2 or later, you can export GlobalAction workflows in the same manner.
  2. Import the workflows on the new server, using the same utility.

Full documentation for the Workflow Migration utility: Transporting Workflows

GlobalCapture 2.1.0 or older and GlobalSearch 4.3.1 or older

Note that these steps only apply to sites using GlobalCapture 2.1.0 or older, or sites using GlobalSearch without GlobalCapture (GlobalSearch 4.3.1 or older).

  1. On the old server, locate the “mongodb” folder.
  2. Run command prompt as an administrator on the old server and run the following commands. Do not copy/paste these commands. Type them out instead. Be sure to replace the file path to the mongodb folder with the one appropriate for your server.

    cd C:\GetSmart\mongodb\bin

  3. This command creates a folder called "dump" in the bin directory. Copy this folder to the mongodb\bin folder on the new server.
  4. On the new server, run the following commands in an administrator command prompt. As before, do not copy/paste these commands. Type them out instead. Be sure to replace the file path to the mongodb folder with the one appropriate for the new server.

    cd C:\GetSmart\mongodb\bin

  5. This will retrieve the contents of the mongodump and import them to the new MongoDB instance.
If migrating GlobalCapture workflows in this manner, the EngineID in the Mongo database will need to be updated to reflect the new server. This will require the assistance of a Square 9 Support technician. Do not attempt this without assistance from Square 9. Improperly editing your Mongo databases can result in irreversible loss of data or an unsupportable GlobalSearch/GlobalCapture installation.

Step 7) Migrate Your OCR Samples, OCR Templates, and Capture Workflows

GlobalSearch 4.4.0 or newer (GlobalCapture)

This step can be skipped if your OCR templates were migrated using the Workflow Migration Utility in the previous step.

  1. On the old server, locate your SampleOCR folder. This can be found in "C:\GlobalCapture\SampleOCR" by default, but may be in "C:\SmartSearch\SampleOCR" or "C:\GlobalSearch\SampleOCR" if an older version was originally installed.
  2. Copy this to the same file path on the new server.

This step only migrates the sample files from your OCR templates. The OCR templates themselves are migrated with the SSCapture SQL database, and the workflows are migrated with the Mongo database. It should be noted that samples are not necessary for OCR templates to function. They are only used by the OCR template designer, not by the GlobalCapture Engine itself.

GlobalSearch 4.3.1 or older (SmartCapture/Capture Workflow)

  1. On the old server, locate the "99" and "13" folders inside "C:\GetSmart". Copy these to "C:\GetSmart" on the new server. These two folders contain your OCR templates and your SmartCapture workflows, respectively.
  2. Copy the sample files used in your OCR templates from the old server to the new server. If you cannot locate your original sample files, you can specify new samples on the server.
It should be noted that samples are not necessary for OCR templates to function. They are only used by the OCR template designer, not by the Capture Workflow Engine itself.

Step 8) Migrate Additional Files

  1. If you are using the Call Assembly feature with GlobalCapture or GlobalAction, copy those to the new server. Consult your assembly file's documentation for file locations.
  2. If you are using Assembly Bound Lists, copy the associated DLL files and their parameter XMLs to the new server.

Step 9) Reconfigure Any Customized Features

If your previous installation had any post-install customization, they will need to be reconfigured or reinstalled at this point. Common examples of this include:

Step 10) Reinstall the GlobalSearch LAN Clients

If you encounter any issues with clients connecting to the server at this point, follow these steps. You may be able to skip this step if the new server has the same name, IP address, and domain/workgroup as the old server.

  1. Uninstall the GlobalSearch LAN client from all Windows workstations.
  2. Reinstall the client using the installer from the GlobalSearch server.

Step 11) Finishing Touches

These steps will require the assistance of a Square 9 Support technician. Please go to to submit a ticket, if needed.

  1. Transfer the registration from the old server to the new server. If both servers are registered, you may encounter license-related issues when using GlobalSearch or GlobalCapture.
  2. Correct file paths and/or connection strings in the migrated SQL databases.
  3. Correct the EngineID in Mongo, if the MongoDB was migrated using mongodump/restore.
After the migration is complete, it is recommended that you test your system before pushing things out to production. (i.e. open existing documents, import new documents, test workflows, etc.)

Related articles

Related articles appear here based on the labels you select. Click to edit the macro and add or change labels.

Related issues