Migrating to SAS Federation Server 4.1 :: SAS(R) Federation Server 4.1: Administrator's Guide

Overview

SAS Federation Server 4.1 installation contains a migration utility that enables you to migrate DataFlux Federation Server 2.1.x. The Windows installation contains a shortcut labeled Migrate 2.1.x Database, and the UNIX installer uses the migrate option with dfsadmin. Each option requires that you point the migration utility to the 2.1.x installation directory.

Invoking the Migration Utility on Windows

The migration process involves copying data from your old installation into the current installation and upgrading it from the 2.x format to the 4.1 format. When running the migration utility, you will be asked for the location of the 2.1.x installation as shown in the following task.

After installing SAS Federation Server, run the Migrate 2.1.x Database tool, which launches a mini-installer.
Click Next in the Setupdialog box.
At Choose Old Install Location, navigate to the root directory for Federation Server 2.1.x (for example, C:\Program Files (x86)\DataFlux\FederationServer\2.1).
Click Next and Start to begin the migration.
When the migration completes, click Next and Finish.

Note: Migration results are written to the dfs_log_213_310.xml file located in the \etc\migrate directory.

Invoking the Migration Utility on UNIX

The UNIX utility, dfsadmin, contains a migration tool to migrate a Federation Server system database (syscat.tdb) from 2.1.x to 4.1. Use the following syntax to invoke migration:

./bin/dfsadmin migrate <2.1.x_installation_directory>

The migration tool reads from the 2.1.x federation server configuration file to determine where the 2.1.x system database (syscat.tdb) file is located and then migrates it to the location for release 4.1. Migration results are written to a log file, dfs_log_213_310.xml, located in /etc/migrate.