How do I migrate CCH® ProSystem fx® Engagement or Workpaper Manager Administrator module to a new server?
Prior to starting the migration process, please review this important information:
- It is best practice to have the new server be the same CCH ProSystem fx Engagement or Workpaper Manager version (recommended procedure). If different versions of the Administrator module are installed on the new server, the migration may fail depending on the version installed (alternative procedure).
- Review step 11 for more details on the alternative procedure.
- Microsoft SQL Server versions - The new server will need to have the same version of SQL installed that was installed on the original server or a newer version of SQL that is supported. Review the article below for supported technologies.
- The following environments are not supported:
- Microsoft Windows Server Small Business Server.
- Click here for more information on Is Windows Small Business Server a viable platform for CCH® ProSystem fx® Engagement or Workpaper Manager? .
- Microsoft Windows Server 2012, 2012 R2, and Server Essentials.
- Microsoft SQL Sever 2012 and 2014.
- Domain Controllers.
- Click here for more information on Can CCH ProSystem fx Engagement be installed to a Domain Controller? .
- Microsoft Windows Server Small Business Server.
To avoid data loss, all binders should be synchronized and checked in prior to the migration process.
Warning! The steps below only involved migrating the Admin module. If you have other modules on your server such as the Terminal Services Database, all binders from Engagement Terminal Services Client sessions must be checked into the Central File Room (CFR) prior to migration. The Terminal Services Database is not included with the backup of the CFR SQL databases. The Terminal Server Database cannot be migrated.
The following steps must be followed to avoid data loss.
- Close all Engagement applications.
- On the new server, install SQL & the same version of the Engagement or Workpaper Manager Administrator that is on the original server. Do not open Administrator Module on the new server.
- If Engagement is running on an older version and are attempting to upgrade to a newer version of the software please review this article to review the supported upgrade path:
- How do I find which CCH® ProSystem fx® Engagement or Workpaper Manager upgrade I should install?
- NOTE: If your old server had Terminal Server Database installed:
- Do not install the Terminal Server Database module on the new server until after the full migration and upgrade of the Administrator module and the Central File Rooms has been completed.
- The same would go for Workpaper Manager module installed on the Administrator server; however this is less likely to be the case.
- After the server migration and upgrade has fully completed for the Administrator module:
- Perform a modify install to add the Terminal Server Database module to the new server.
- Do not install the Terminal Server Database module on the new server until after the full migration and upgrade of the Administrator module and the Central File Rooms has been completed.
- You can install Engagement 2022 on the new server if you are migrating and upgrading at the same time from Engagement 2020 or Engagement 2021. See step 11 for further details.
- You can install Engagement 2021 on the new server if you are migrating and upgrading at the same time from Engagement 2019 or Engagement 2020. See step 11 for further details.
- You can install Engagement 2020 on the new server if you are migrating and upgrading at the same time from Engagement 2018 or Engagement 2019. See step 11 for further details.
- Install and configure a Microsoft® SQL Server® instance for Engagement.
- Install Engagement Administrator.
- How do I install CCH® ProSystem fx® Engagement, Workpaper Manager, or Knowledge Coach?
- Warning! After installing do not open, login, or configure the Administrator Module on the new server! This will cause the following message on the workstations once they go to log into Engagement Administrator or Workpaper Manager Administrator:
- "The firm for the office server you have specified is different from the firm for the other CCH ProSystem fx Engagement profiles on this computer."
- When running the installer for the first time, the Engagement or Workpaper Manager installer by default will have selected to install "Workpaper Management" if so consider the following below:
- If running a terminal server environment, then choose to remove this feature from being installed and instead choose to install Terminal Server Database (we do not recommend installing both Workpaper Manager and Terminal Server database on the same server!).
- If this is a standalone firm running Engagement or Workpaper Manager on a single machine, then you choose to leave this module to be installed with the Administrator.
- If the environment is not running a terminal server environment or if it is not running as a standalone machine, then this module is not required as this is used for the local workstation installs.
- Move back to the original server and open the Admin module.
- Locate the Central File Room(s) in the lower-left corner.
- Right-click the Central File Room and select Properties.
- Locate the workpaper path and document it.
- Repeat steps 3 through 6 for each Central File Room.
- On the original server, run the Database Backup and Restore Utility and perform a full backup.
- IMPORTANT!: Locate the following services on the old server. Stop each of the services and and disable them:
- SQL Server (PROFXENGAGEMENT)
- PFXSYNPFTService
- PfxEngDesktop
- Pfx.Engagement.WcfServices (v7.0 and later versions only)
- Pfx.Engagement.SocketService (v7.2 and later versions only)
- To disable the services, review the following steps.
- Click on the Windows Start Menu and type in: Services.exe. Click on Services.exe to open the Services window.
- Right-click on the each service listed above and select Stop.
- Right-click on the services again and select Properties. Change the startup type to "Disabled," and select Apply.
- Close out of the Services window.
- Copy the .bak file created with the Database Backup and Restore Utility to the new server.
- On the new server, run the Database Backup and Restore Utility and restore the .bak file that you copied from the old server
- If you are using Engagement or Workpaper Manager v2017 or older, double-click on BackupRestoreUtil.exe.
- If you are using Engagement or Workpaper Manager v2018 or newer, right-click on BackupRestoreUtil.exe and select "Run as Administrator" from the menu.
- If the version of Engagement or Workpaper Manager installed on the new server is a 2018, 2019, or 2020 release, you will receive a prompt stating there is a "Database version mismatch." If the backup file is compatible to restore onto the new version of Engagement or Workpaper Manager, you will be allowed to proceed.
- If you are restoring an older version of Engagement or Workpaper Manager database onto a newer version of Engagement or Workpaper Manager, then run the Pfx Database Utility to upgrade the databases to the correct version after the Backup and Restore Utility completes the restore.
- The Pfx Database Utility is a version specific utility and can be found in the ?:\Pfx Engagement\Admin\Engagement CD Image\Utilities folder, where "?" is the drive Engagement or Workpaper Manager is installed on.
- If you are restoring an older version of Engagement or Workpaper Manager database onto a newer version of Engagement or Workpaper Manager, then run the Pfx Database Utility to upgrade the databases to the correct version after the Backup and Restore Utility completes the restore.
- Open the Administrator module on the new server for the first time.
- Note: If the server name has been changed, you will be prompted to change the Engagement or Workpaper Manager server name. Click Yes to accept the name change.
- Copy the Workpaper folder from the old server to the new server. The default location of the Workpaper folder is located at ?:\Pfx Engagement\Admin\Workpapers, where "?" represents the drive where Engagement or Workpaper Manager is installed. If you find that the Workpaper folder is empty or does not exist in ?:\Pfx Engagement\Admin\Workpapers, then you can check the location of the Central File Room workpapers folder by right-clicking on the Central File Room in the Administrator module and choosing Properties.
- If you choose to place the Workpaper folder to a different path on the new server compared to the old server, then you must use the CFR Workpaper utility located in the CD image\utilities folder to configure the new Administrator Module Workpaper path.
- How do I use the Central File Room (CFR) Workpaper Path Change Utility?
- When the Engagement Administrator or Workpaper Manager Administrator, Terminal Server Database, or Terminal Server Client are installed, necessary services are created and started by default under the Local System account. Depending on the configuration of the network topology or domain, the Local System account may not have the correct permissions or authentication credentials to read and write data on a remote file share or server where the physical files are located.
- If you choose to place the Workpaper folder to a different path on the new server compared to the old server, then you must use the CFR Workpaper utility located in the CD image\utilities folder to configure the new Administrator Module Workpaper path.
- If any of the following folders contain files, copy the content to the corresponding folder on the new server:
- ?:\Pfx Engagement\Admin\Admin Packages\
- ?:\Pfx Engagement\Admin\Archive\
- ?:\Pfx Engagement\Admin\Transition Binder Packages\
- "?" represents the drive where Engagement or Workpaper Manager is installed.
- If your Engagement or Workpaper Manager configuration uses one or more secondary office servers, create an admin package on the migrated server and receive it on all other main and secondary office servers.
- How do I create an Admin Package for CCH® ProSystem fx® Engagement Administrator or CCH® ProSystem fx® Workpaper Manager Administrator?
- How to receive an Admin Package in CCH® ProSystem fx® Engagement Administrator or CCH® ProSystem fx® Workpaper Manager Administrator?
If the server name changed, each workstation that has Engagement installed will need to do the following:
- In 2019.1.3 Engagement there is an additional process at this point in the workstation login.
- This is a previous issue that has been resolved and the below step under "Engagement or Workpaper Manager 2019.1.3" is not required to be performed in version 2019.2.1 or later and versions 2020.1.3 or later. Please proceed below to "For Engagement versions 2018.3.2 or earlier, versions 2019.2.1 or later, and versions 2020.1.3 perform the following below:"
- Log into Engagement or Workpaper Manager.
- A message will display indicating that the program could not find the old server. Click OK.
- Either click Browse and select the new office server, or type in the name of the new office server. Do not add "\\" to the beginning of the server name when typing in the server name.
- Click OK.
For Engagement 2019.1.3 or Workpaper Manager 2019.1.3:
- Download the utility attached to this article: RemoveServerNameOnLocalMachineUtil.exe.
- Copy and transfer RemoveServerNameOnLocalMachineUtil.exe to all workstations.
- On each workstation, right-click on the file and choose "Run as Administrator."
- When the utility finished, it will report "Server Name Changed Successfully On Local Machine."
- Log into Engagement or Workpaper Manager.
- A message will display indicating that the program could not find the old server. Click OK.
- Either click Browse and select the new office server, or type in the name of the new office server. Do not add "\\" to the beginning of the server name when typing in the server name.
- Click OK.
Notes:
- After migrating to the new server, please be sure to configure the Database Backup and Restore Utility to back up the database on a regular basis. For detailed steps, refer to the article below.
- If you find that your document completion date report is not functioning correctly on the new server, please review the article below.
Solution Id | 000239725/sw17114 |
---|---|
Direct Link |