Differences

This shows you the differences between two versions of the page.

--- kb:kb_articles:kb1092 [2024/02/19 16:07] – bshumsky
+++ kb:kb_articles:kb1092 [2024/02/20 14:09] (current) – bshumsky
@@ Line 1: / Line 1: @@
 ====== Moving OpenInsight and Universal Driver To A New Server ======
-While moving an OpenInsight installation to a new server is relatively straightforward, there are several steps that you will need to follow.
+==== Created at 20 FEB 2024 10:00am ====
+As older versions of MS Windows servers are retired or taken off of support, users of Revelation-based products may find that they need to migrate their applications to a newer platform. This document describes how to move both the OpenInsight and Universal Driver (Linear Hash server) products from an existing installed server to a new system.  While moving an OpenInsight installation to a new server is relatively straightforward, there are several steps that you will need to follow.
 As always, please ensure you have a good backup of your OpenInsight system before proceeding.
-===== Step 1: Ensure All Users Have Exited The System =====
+==== Step 1: Ensure All Users Have Exited The System ====
+This includes turning off any "automated" users, such as the Engine Server service.  To use the Windows Services dialog to stop the Engine Server service, go to the "search" bar, and type in "Services":
+{{kb:kb_articles:kb1092_1.png}}
+Look for the "OEngine Server" service - if it's there, and running, right-click on it and choose "Stop":
-This includes turning off any "automated" users, such as the Engine Server service.
+{{kb:kb_articles:kb1092_1a.png}}
-===== Step 2: Turn Off The Current Universal Driver =====
+==== Step 2: Turn Off The Current Universal Driver ====
 Using the Windows Services application, look for the "Linear Hash Service" and stop it.  Go to the "search" bar, and type in "Services":
@@ Line 20: / Line 28: @@
-===== Step 3: Copy the OpenInsight Folder(s) and Universal Driver Folder =====
+==== Step 3: Copy the OpenInsight Folder(s) and Universal Driver Folder ====
 These are both often found under C:\RevSoft.  Note that you may have other data folders installed elsewhere on the server; you will need to copy them as well, to the same relative location on the new server.  If you get errors that some files are "locked", you may need to reboot the old server before copying.
@@ Line 38: / Line 46: @@
 {{kb:kb_articles:kb1092_5.png}}
-===== Step 4: Install the Universal Driver On The New Server =====
+==== Step 4: Install the Universal Driver On The New Server ====
 After copying over the exported registry subtree(s) from the old server, you can right-click and choose to install them in the registry of the new server.
-Open up a DOS cmd prompt as "Administrator", cd to the Universal Driver folder on the new server, and type in:
+Open up a DOS cmd prompt as "Administrator" - using the Windows "search", type in "cmd":
+{{kb:kb_articles:kb1092_8.png}}
+When found, right-click on the command and choose "Run as Administrator":
+{{kb:kb_articles:kb1092_9.png}}
+Use the "cd" command to change to the Universal Driver folder on the new server, and type in:
      <ud exe name> install
-The name of the exe will vary depending on the version of the Universal Driver - for UD 5.x, use "revlhsrvc.exe", for UD 4.7 use "revlh47srvc.exe", etc.:
+The name of the exe will vary depending on the version of the Universal Driver - for UD 5.x, use "revlhsrvc.exe", for UD 4.7 use "lh47srvc.exe", for UD 4.5 use "lhsrvc45.exe", etc.:
 {{kb:kb_articles:kb1092_6.png}}
@@ Line 54: / Line 70: @@
 If you are running the Universal Driver using TCP/IP, you may need to make sure the UD port is "opened" in any software or hardware firewall.  The port is usually 777 (for UD 4.x) or 1777 (for UD 5.x).
-===== Step 5: Install the OpenInsight On The New Server =====
+If you are using a Universal Driver Manager, be sure to copy the shortcut from the old server to the new server, updating the "target" and "start in" properties of the shortcut if needed.  Also be sure to update any REVPARAM in the UD folder, or the UD Manager subfolder, to point to the new server.
-In the OpenInsight folder, locate and run the "clientsetup.exe".  Note that if you choose to install the .Net 2 components, you may need to first install the .Net framework ([[kb:kb_articles:kb1090|please see this document for instructions on enabling/installing the .net 2.0 framework]]).
+==== Step 5: Install the OpenInsight On The New Server ====
+In the OpenInsight folder, locate and run the "clientsetup.exe".  Note that if you choose to install the .Net 2 components, you must ensure that the .Net 3.5 framework is installed:
+{{kb:kb_articles:kb1092_7.png}}
+([[kb:kb_articles:kb1090|please see this document for instructions on enabling/installing the .net 2.0 framework]]).
 Locate and edit, using Notepad or another Windows editor, the REVPARAM file in your OpenInsight folder, and in any subfolders or data folders, so that the ServerName parameter is now pointing to the new server.
@@ Line 66: / Line 88: @@
 If you were previously using a Web Server (IIS or Apache) on the old server, you will need to recreate your "virtual directory(s)" on the new server, and enable CGI access to OECGI3.EXE or OECGI4.EXE.
-===== Step 6: Set Up Users =====
+==== Step 6: Set Up Users ====
 If the users have a shortcut on their desktop, make sure it points to the new server location.
-From each user's desktop, find and run the clientsetup.exe file in the server's OpenInsight folder.  Note that if you choose to install the .Net 2 components, you may need to first install the .Net framework ([[kb:kb_articles:kb1090|please see this document for instructions on enabling/installing the .net 2.0 framework]]).
+From each user's desktop, find and run the clientsetup.exe file in the server's OpenInsight folder.  Note that if you choose to install the .Net 2 components, you must ensure that the .Net 3.5 framework is installed:
+{{kb:kb_articles:kb1092_7.png}}
+([[kb:kb_articles:kb1090|please see this document for instructions on enabling/installing the .net 2.0 framework]]).
-===== Step 7: Final Cleanup =====
+==== Step 7: Final Cleanup ====
 If you have mapped drives on the old server you will want to make the same mappings point to the same folders on the new server.