How do I migrate Intranet Connections to a new server? (ColdFusion)

Moving SQL and Intranet Connections to a new Server

Your first step is to move your SQL database from the old server to the new server. The following steps will walk you through how to accomplish this. Following the move of SQL, you will then need to bring over the Intranet directory and all of its subfolders and contents to the new server, which is outlined at the end of this document. 

Overview

  1. Install and Configure new SQL Server
  2. Create IntranetConnections database and login on New Server
  3. Backup existing production database and restore it to the new SQL database
  4. Install ColdFusion
  5. Create the SQL data source

Step 1) SQL Server Migration (from one SQL server to another)

  1. Install and Configure new SQL Server
  2. Install SQL Server as per the Microsoft installation instructions.
  3. Only note is to ensure that you have enabled Mixed Authentication (i.e. both SQL and Windows Authentication on the SQL server are enabled).
  4. Take a backup of your database and copy the .bak file to the new SQL Server (click here for backup instructions)

Step 2) Creating the IntranetConnections SQL Database

  1. Open SQL Management Studio
  2. Right click Databases and select New Database…
  3. In the Database Name field type in IntranetConnections
  4. You can keep the rest of the default settings as per the screen below
  5. You should now have a database called IntranetConnections under the Databases heading in the left hand pane
  6. Create the IntranetConnections Login
  7. Right Click Logins (under Security) and select New Login…
  8. In the Name field type in IntranetConnections
  9. Change the default of Windows NT Authentication to SQL Server Authentication
  10. Enter a password or leave it blank. If entering a password, please note it down for later use when creating the datasource. If entering a password ensure that you uncheck the ‘Enforce Password Policy’, ‘Enforce Password Expiration’ and ‘User must change password at next login’ options. In the Database Field from the drop down box choose the database IntranetConnections (see image on next page)
  11. Now click on the User Mapping page
  12. Select the Database IntranetConnections by clicking in the checkbox
  13. Under Database Roles make sure public is checked and db_owner is checked
  14. Click on OK to finish creating the login

Step 3) Moving your old SQL content to the new SQL IntranetConnections database

  1. First create a backup of your old production IntranetConnections database. You can do this via the SQL Management Studio.
  2. Right click the database name > Tasks (or All tasks) > Backup
  3. Backup the database to a location on Disk
  4. Copy the backup file (filename.bak) from the old server to the new server
  5. Open SQL Management Studio on the new server. Right click on the IntranetConnections database and choose Tasks  Restore  Database.
  6. Go to Options in the top left hand corner and choose ‘Overwrite the existing database’ from the Restore options menu. Click OK. Click OK again on the main backup screen to run the backup.
  7. Once the backup has completed, open a new query window pointing to the IntranetConnections database (you can select the database from the drop down). Enter the following into the query and execute it. If your SQL user created in the previous section is not called intranetconnections then replace the occurrence of that name in the query below with the appropriate name. This query repairs any orphaned user issues associated with the database transfer. 

    EXEC sp_change_users_login 'auto_fix', 'intranetconnections'

Step 4) Install ColdFusion

Before installing ColdFusion, log into your current Production server's ColdFusion admin portal and locate your serial number.

The following image shows where you can locate the serial number within your CF admin:

Choose your version of ColdFusion from the following list:

STOP - Before installing ColdFusion, refer to the know Windows Server requirements:

  • Windows Server 2008 can support ColdFusion 8 and 9
  • Windows Server 2012 can only support ColdFusion 10+
  • IC does not support ColdFusion 11+

ColdFusion version

Supported Intranet Connections (IC) version

ColdFusion 10.0.0: 32Bit download, 64Bit download

IC 11.5.12 to IC 12.5

ColdFusion 9.0.1 

ColdFusion 9.0.2: 32Bit download, 64Bit download 

Up to IC 12.5

ColdFusion 8.0.1: 32Bit download 

(Click here for the CF 8.0.1 update. Please note that you need to be on CF 8.0.0 to apply this update.)

Up to IC 12.5

ColdFusion 7.0.2 

Up to IC 10.5.131

ColdFusion 6.0.0

Up to IC 9.5.173

Step 5) Create Datasource

Creating your IntranetConnections SQL Data source in Cold Fusion. 

Now that you have created your IntranetConnections SQL database and the IntranetConnections Login, you need to set up the SQLFunctions data source in the ColdFusion Administrator for your new SQL database.

The following steps will walk you through creating additional data source for SQL.

  1. Go to the Cold Fusion Administrator through the browser: 
    http://ipaddress/CFIDE/Administrator/index.cfm
  2. Click on ODBC Data Sources
  3. Create a new Data source called: SQLFunctions
  4. Select SQL Server Driver from the drop down list as per the below screen snap
  5. Enter in the name of your server
  6. For Database, type in: IntranetConnections
  7. For Username, type in: IntranetConnections

Final Steps

  1. Bring over the Intranet directory and all of its subfolders and files to the inetpub/wwwroot of the new server.
  2. Bring up the intranet site through your browser
  3. Click on Site Settings / Administrator Info
  4. Change the drive and path field to point to where you placed the Intranet directory on the new server (if applicable)

 

Migrating old versions of IC (up to 9.5): Are you encountering a SessionError message when trying to access your site? Click here for instructions on how to correct this issue.

Have more questions? Submit a request

0 Comments

Article is closed for comments.