<< Click to Display Table of Contents >> RayFlow > 8.0 > Release Notes > Migration  RayFlow Server

Migration from 1.x RayFlow Servers

If migrating from a 1.x RayFlow server to RayFlow 8.0, it is recommended to ask for the help of our consultants.

Migration from 2.x RayFlow Servers or Higher to 8.0

1. Make a Backup of the Current System (This step is optional but strongly recommended)

 

A.Backup the SQL database:

•Start the SQL Server Management Studio.

•Right-click on the existing RayFlow database and select Task > Back Up from the context menu.

 

B.Backup the file system:

•Go to the RayFlow Server Installation directory (%INSTALLDIR%).

•Right-click on the directory and select Send To > Compressed Zip Folder.

•Store the database and the file backups at a safe location.

 

 

 

2.Uninstall the Previous RayFlow Server

 

 

After the old web.config file has been saved uninstall the old version of RayFlow Server.

To uninstall RayFlow Server use the Windows Control Panel. In the Uninstall or change a program section, select the entry for RayFlow Server. Right-click on the entry and select Uninstall from the context menu.

 

 

In the screenshot below there is an example of data that will remain after uninstalling the old RayFlow Server.

 

 

3.Installation of RayFlow Server 8.0

 

Install the current version of the RayFlow Server to the %INSTALLDIR% folder using the MSI installer. Detailed information on how to install the new RayFlow Server can be found in the Server Installation Guide for RayFlow.

 

 

4.Edition of the New Web.config File

 

Open the web.config file which is located in the %INSTALLDIR% in a text editor and replace the connection string with the connection string of the old web.config file (see either the first or the second step). Save the changes to the new web.config file.

 

Example:

 

<!-- Your connectionstring -->

  <connectionStrings>

    <add name="RayflowEntities"

      connectionString="Data Source=(local);Initial Catalog=Rayflow;Integrated 

      Security=True;MultipleActiveResultSets=True;App=EntityFramework"

      providerName="System.Data.SqlClient"/>

  </connectionStrings>

 

5.Upgrade the RayFlow Database

 

The database needs to be updated using the RayFlow-Updater. This is a simple console program which contains the four parameters which are necessary to update the RayFlow database to the latest state without the use of SQL scripts.

 

rfDBUpdater.exe –path %INSTALLDIR%\RFDBUpdater\ -upgrade –wait

 

The application itself is located in the following directory of the RayFlow Server installation: %INSTALLDIR%\RFDBUpdater\

 

Example of how to launch an update from a local folder:

 

rfDBUpdater.exe -upgrade –wait

 

Example of hof to launch an update from any folder:

 

rfDBUpdater.exe -path %INSTALLDIR%\RFDBUpdater\ -upgrade –wait (with full path %INSTALLDIR%)

 

List of Arguments:

 

-path: The path containing the RayFlow Server installation. It is necessary for the Database/Connection string which will be taken from the web.config in the given path. At the same time, the path is the address of the SQL Scripts folder which also resides in the same folder. The path can be omitted if the command is launched from the RayFlow Server installation folder.

 

-upgrade: Using this parameter will update the database to the latest state.

 

-version: Get the current version of RayFlow.

 

-wait: Wait for a key action.

 

 

 

6.Manual Configuration

(The necessity of these steps depends on the environment.)

 

Internet Information Services (IIS) restart

 

Restart the Internet Information Services either using the Internet Information Services Manager or via Command Prompt using the iisreset command line.

 

Internet Information Services Manager:

 

 

"iisreset" command line: