Skip to content
Contact Support
  • There are no suggestions because the search field is empty.

Running the IC2 → IC3 Migration Tool

This article outlines the full process for preparing, backing up, and running the migration tool to migrate your IntranetConnections IC2 environment into IC3.

2. Back Up Your IC3 Environment

Perform a complete backup prior to migrating.

Steps

  1. Turn off IIS.
  2. Create the following folder: C:\temp\Backup.
  3. Copy the following into the backup folder:
    • C:\storage → C:\temp\Backup\storage
    • C:\inetpub\wwwroot\SITE
      C:\inetpub\wwwroot\SITE-API
      → C:\temp\Backup
  4. On SQL Server, generate a full database backup of the IC3 database.
    Save as: C:\temp\Backup\IC3.bak
  5. Turn on IIS.

2. Patch IC3 to Version 3.1.1‑rc07

Before beginning the migration, ensure the IC3 environment is patched to version 3.1.1‑rc07.

Steps

  1. Turn off IIS.
  2. Open Windows PowerShell and navigate to:
    C:\temp\IC3 (or wherever your download.ps1 script is located).
  3. Run the following command: .\download.ps1 -instanceName "SITE_NAME" -version "3.1.1-rc07"
  4. Turn on IIS.
  5. In a browser, open:
    https://[SITE_NAME-API].[DOMAIN]/Setting/LoginProviders
    • If "isSuccess": true appears, the deployment is successful.
  6. Verify the IC3 version at:
    https://[SITE_NAME].[DOMAIN]/
    Ensure the version displays 3.1.1‑rc07.

3. Migration Preparation

Gather and stage all required IC2 files and data.

Steps

  1. Create a full SQL backup of the IC2 “IntranetConnections” database from the IC2 server.
  2. On the IC3 SQL Server:
    • Create a new database named IC2.
    • Restore the IC2 backup into this database.
  3. Copy the IC2 Intranet folder (turn off Lucee and IIS first) to:
    C:\temp\MigrationFiles
  4. If the IC2 Documents folder resides on another drive, copy the documents folder into:
    C:\temp\MigrationFiles

4. Launch the Migration Tool

  1. Open a browser and navigate to the migration page:
    https://[SITE_NAME].[DOMAIN_NAME]/migration
  2. Enter the LegacyAppConnectionString, using the format below:

Example Connection String

Server=[SERVERNAME];
Initial Catalog=[IC2_DB_NAME];
Persist Security Info=False;
User ID=sa;
Password=[SA_PASSWORD];
MultipleActiveResultSets=False;
TrustServerCertificate=True;
Connection Timeout=30;

Sample

Server=localhost;
Initial Catalog=IC2;
Persist Security Info=False;
User ID=sa;
Password=123456Ab!;
MultipleActiveResultSets=False;
TrustServerCertificate=True;
Connection Timeout=30;
  1. Set LegacyAppFilesPath to:
    C:\temp\MigrationFiles
  2. Click Next.

5. Select and Migrate Applications

  1. Click Open Application List…
  2. Check all IC2 applications you want to migrate.
  3. Click Next.
  4. Click Migrate and allow the migration to complete without interruption.
  5. When the Migrate button becomes clickable again:
    • Confirm the migration status shows Complete.