If for any reason, you wish to move the entire infoRouter installation to another machine, please follow the instructions below in the order in which they are explained. This guide assumes that you intend to move the IIS application content of infoRouter. If your intent is to switch installation modes (Simple versus Distributed), please refer to the appropriate documentation on how to switch installation models.

It is critical that you pay close attention to the details. You must read this document in full before attempting the migration. Sections explained towards the end of this guide may determine or change your plans.

Important Note:

If you are migrating from a Windows 2003 or Windows 2008 platform to Windows 2012, 2016, 2019 or above, pay close attention to the indexing section below. MS Index Server is no longer an option on Windows 2012 and above. You will need to switch the content indexing to Windows Search. Third-party content indexing is also an option for large infoRouter instances that have 1M documents or more.

STEP BY STEP MIGRATION



READ THE REQUIREMENTS DOCUMENT


Review the Server & Client Requirements document to make sure that you have allocated resources that meet the minimum requirements for best performance on the new server on which infoRouter is to be migrated.

Make sure to have the .NET framework installed and install the latest patches. For more on this topic, please review the Requirements document for the server on which you intend to install the new copy of infoRouter.

infoRouter Requirements for Version 8.x

You will need to take a look at this document if you intend to install infoRouter on a Windows 2012 server:

Windows 2012 Standard Edition Required Features. The instructions in this document also applies to Windows 2012 R2, 2016 and 2019 versions.


DO NOT TRY TO CHANGE THE INSTALLATION MODEL DURING THE MIGRATION


If you have installed infoRouter in the Single server mode, do not change this model until a successful migration is complete. You will be able to change modes once you have successfully migrated infoRouter.


PLAN FOR THE MIGRATION


Weekends or after hours is probably the best choice to minimize the impact on users. Do not try the migration when users are attempting to access infoRouter.


RECORD SPECIAL SETTINGS


If you installed infoRouter using the Simple Model (you have your entire warehouse on one server, IIS is on the same server and the DB is also on the same server), record the path used. (C:\infoRouter\WH or other path)

If you installed infoRouter using the Distributed Model (you have your warehouse on another server other than the IIS machine), record the path(s) used. You must have used a UNC path such as //<Server Name>/<drive name>/<directory name>.

Make a careful and complete list of machines, drives and directories. You will need this information after installing infoRouter on to the new server. Do not remove/un-install or change the original infoRouter installation until after you have verified the migration process.


STOP IIS


To stop access to the infoRouter application, please stop the IIS Server.

To do this, perform the following:

  • Click on the Start Button
  • Select the RUN menu item.
  • Enter the following command:
    iisreset /stop

Stopping IIS is critical. This will prevent all access to the infoRouter application. You must make sure that the database and the warehouse are not being accessed while the backups are being performed.


PERFORM ALL REQUIRED BACKUPS


Backups for the infoRouter database and warehouse must be performed while infoRouter is NOT running and the DB-Warehouse pairs must match.


BACKUP THE WAREHOUSE


Perform a complete backup of your warehouse(s). Please make sure that you have a complete backup set of all warehouse folders comparing your backups to the list you prepared in Step 6.


BACKUP THE DATABASE


Perform a complete database backup of your database.

Please refer to the specific backup instructions of your DBMS and make sure that you can restore a copy of your backup in the target server.

If you installed infoRouter using the Distributed Model and your DBMS is already on another server and you wish to keep your configuration the same, you may skip this step.

Note: We always recommend making backups of everything before a migration.

BACKUP SECTIONS OF THE APPLICATION DIRECTORY


In addition to the database and warehouse, the application directory is used to record special settings and user data so these must be backed up as well.

Copy the following directories from the original infoRouter application directory:

infoRouter/Categories (Contains the “saved search” screens you have created.)

infoRouter/SearchPages (Contains the custom search screens created within infoRouter.)

infoRouter/Portals (Contains the portals created and edited within infoRouter)

infoRouter/Logs (Contains the audit logs for various actions performed within infoRouter.)

infoRouter/domains.xml (Contains library descriptions.)

Configuration files:

infoRouter/config/mimetypes.custom.xml

infoRouter/config/taskdefs

infoRouter/config/lookup_*.xml

infoRouter/config/customMenus.xml

infoRouter/config/tifftopdf.xml

Customized email templates if any

infoRouter\emailTemplates\


INSTALL infoRouter ON THE NEW SERVER


Please contact the infoRouter Technical Support department to get the migration key.

Before installing infoRouter on the new server, please refer to the infoRouter implementation Guide.

Install infoRouter on the new server using installation program. Try to select installation defaults when installing the new instance of infoRouter.

Please refer to the infoRouter Implementation Guide to make sure you follow all the required steps. For version 8.x of infoRouter, the implementation guide can be found here: Version 8.x Implementation Guide


Important Notes:


Database Name & Server selection during the installation:

At one point of the installation you will be prompted for a database server and name. Make sure to enter a fake database name such as XYZ or DUMMY.

Let the installation create/update this fake database. Remember, you already have a database that you will restore from so this one is just to fool the installation program.


Warehouse location selection during the installation:

If you intend to store the warehouse on this same server, make sure to choose a drive letter that has enough storage capacity to house the warehouse you are about to restore.

If the warehouse is on a network location and you would like to continue to use this same location, specify a local disk location on this server. This location will be changed after the installation is complete.


RESTORE YOUR DATABASE & ADJUST SETTINGS


If you installed infoRouter using the Distributed Model (originally) and the database was on a different server and you wish to keep it that way. Skip the restore process but you must still make one adjustment.

If the infoRouter database is also moving as a part of the migration, restore the database using the backup performed in Step 10 of this guide. Restore the infoRouter database over the one created in the installation step (Step 12) or simply restore from your DB backup and delete the database created during the installation (Step 12).

After the restore operation you must make one additional adjustment to point infoRouter to the correct database server and database name. Remember that you entered a fake database name; this must be corrected.


Perform The Following:

Navigate to the infoRouter installation path and edit the file called IRWEB.DSN This file stores the database connection information. When edited with Notepad, the contents should look similar to the following:

[ODBC]
DRIVER=MYSQL
UID=root
PASSWORD=/Crypto:nZBf69bCJIM=
STMT=
OPTION=3
PORT=3308
SERVER=infoRouterDBServer
DB=DUMMY
DESC=
			

The example above is for a MySQL database. This file looks slightly different for SQL Server and Oracle.

Edit this file so that the “SERVER”, “DB” and “PASSWORD” information is correct. When you are finished, the file contents should look like the following:

[ODBC]
DRIVER=MYSQL
UID=root
PASSWORD=<infoRouter_database_passsword>
STMT=
OPTION=3
PORT=3308
SERVER= infoRouterDBServer
DB=infoRouter
DESC=
			

Change the database name to infoRouter (or whatever the original production database was called) and make sure to enter the correct password for the restored database.

When infoRouter runs and accesses this file for the first time, the password you entered here in clear text will be encrypted and will look like the following:

[ODBC]
DRIVER=MYSQL
UID=root
PASSWORD=/Crypto:nZBf69bCJIM=
STMT=
OPTION=3
PORT=3308
SERVER=infoRouterDBServer
DB=infoRouter
DESC=
			 
			 

RESTORE YOUR WAREHOUSE OR ADJUST SETTINGS


Depending on the warehouse location of the original installation, the warehouse must either be moved to the new location or the new infoRouter application must be configured to access the existing warehouse location.


Case 1:

The original warehouse is somewhere on the network and you wish to use the same warehouse

In this case, you do not need to restore the warehouse because it is already in the final location. However, because you chose a fake warehouse location during the installation, this information must be changed so that this new instance of infoRouter knows about the original location of the warehouse on the network.


Perform the following:

Edit the configuration file called warehousepaths.xml located in a directory called “config” in the infoRouter application path.

Be sure to enter the network path in UNC notation for every warehouse path.

For more information on how to adjust the warehouse paths and assign appropriate security, refer to this guide:

Warehouse Migration Guide


Case 2:

The original warehouse is on the original server and you wish to move the warehouse to the new server.

Perform the following:

Simply copy and paste the warehouse over the warehouse location you specified during the setup of infoRouter.


WINDOWS SEARCH CATALOG


The setup program will automatically create the Windows Search catalog.

Unfortunately, Windows Search is not able to catalog warehouse entries that live on a network drive. If your warehouse is on a network drive, you will have to make the network drive look like a local drive. Please consult your network administrator on how to do this.


ADDITIONAL REQUIREMENTS TO BE PERFORMED ON THE NEW SERVER


Only perform this if you are migrating and 8.x version to another server.

RUN LIVE UPDATE ON THE NEW SERVER

Now that you have a working copy of infoRouter on the new server, you must run Live Update. This will ensure that you have all the latest patches and upgrades to the original software.

Perform this option if you are migrating a 7.x version and which to upgrade while migrating.

RUN THE SETUP PROGRAM AND CHOOSE THE UPGRADE OPTION

You have a newer version of infoRouter but your warehouse and and database is old. You now need to run the setup program and choose the "Upgrade" option so that your older warehouse and database are upgraded to the latest version.


VERIFY THE MIGRATION


To verify a successful migration, launch your browser and type in the URL for infoRouter.


Verify the following:

  • The application appears to be in working condition.
  • Performing a search for documents based on content works.
  • You are able to download existing documents
  • You are able to upload and create new documents

If all of the above is in good working order, congratulations, you have successfully migrated infoRouter.


FINAL STEPS:


Be sure to keep DB and Warehouse backups from the original server in a safe place.

Make the required plans to maintain and backup the new infoRouter server.

Update your documentation and instructions so that the new server is backed up and maintained by your IT staff.

Make the required DNS changes so your users can access the new server instead of the old production machine.