Applies to: All Versions

The following are the instructions necessary for migrating your Ephesoft Sharedfolders location to a different path (Network or Local). All that is required in order to successfully migrate your Sharefolders Location are the following:


1. Update all property files that reference the Old SharedFolders location, see all the required files below: 

[Ephesoft Installation Folder]\Application\WEB-INF\classes\META-INF\application.properties

 Line 28: plugin_upload_folder_path=\\\\NEW_UNC_PATH\\SharedFolders/plugin-upload-folder

[Ephesoft Installation Folder]\Application\WEB-INF\classes\META-INF\dcma-batch\dcma-batch.properties

 Line 1: batch.base_folder=\\\\NEW_UNC_PATH\\SharedFolders
 Line 2: batch.local_folder=\\\\NEW_UNC_PATH\\SharedFolders/ephesoft-system-folder
 Line 4: batch.export_folder=\\\\NEW_UNC_PATH\\SharedFolders/final-drop-folder
 Line 17: batch.export_import_folder=\\\\NEW_UNC_PATH\\SharedFolders/export-batch-folder
 Line 24: batch.test_folder=\\\\NEW_UNC_PATH\\SharedFolders/ephesoft-test-data

[Ephesoft Installation Folder]\Application\WEB-INF\classes\META-INF\dcma-data-access\dcma-db.properties

 Line 17: upgradePatch.folder=\\\\NEW_UNC_PATH\\SharedFolders/database-update

[Ephesoft Installation Folder]\Application\WEB-INF\classes\META-INF\dcma-util\dcma-backup-service.properties

 Line 1: backup.local_folder=\\\\NEW_UNC_PATH\\SharedFolders/ephesoft-system-folder
 Line 8: backup.report_folder=\\\\NEW_UNC_PATH\\SharedFolders/report-data

[Ephesoft Installation Folder]\Application\WEB-INF\classes\META-INF\dcma-workflows\dcma-workflows.properties

 Line 15: newWorkflows.basePath=\\\\NEW_UNC_PATH\\SharedFolders/workflows

[Ephesoft Installation Folder]\Application\WEB-INF\classes\META-INF\dcma-reporting\dcma-report.properties (Applies to v3.1)

 Line 3: ephesoft.report_folder==\\\\NEW_UNC_PATH\\SharedFolders /report-data

[Ephesoft Installation Folder]\Application\WEB-INF\classes\META-INF\dcma-reporting\etl-variables.properties (Applies to 4.x onwards)

 
 Line 1: reportdata.path=\\\\NEW_UNC_PATH\\SharedFolders/report-data

[Ephesoft Installation Folder]\JavaAppServer\conf\server.xml

 Line 156: <Context path="/dcma-batches" docBase="\\\\NEW_UNC_PATH\\SharedFolders" debug="10" privileged="false"/>

[Ephesoft Installation Folder]\EphesoftReports\_Definitions\_Reports\Analysis_Grid.Document_Correction_Analysis_Grid.lgx (Applies to 4.x onwards)

 Line 23:         SavedAnalysisGridFolder="\\\\NEW_UNC_PATH\\SharedFolders\SavedAnalysisGrid"
 Line 65:         DashboardSaveFile="\\\\NEW_UNC_PATH\\SharedFolders\SavedDashboards\Dashboard_User_@Session.userName~.xml"

 

[Ephesoft Installation Folder]\EphesoftReports\_Definitions\_Reports\Analysis_Grid.Field_Correction_Analysis_Grid.lgx (Applies to 4.x onwards)

 Line 23:         SavedAnalysisGridFolder="\\\\NEW_UNC_PATH\\SharedFolders\SavedAnalysisGrid"
 Line 62:         DashboardSaveFile="\\\\NEW_UNC_PATH\\SharedFolders\SavedDashboards\Dashboard_User_@Session.userName~.xml"

 

[Ephesoft Installation Folder]\EphesoftReports\_Definitions\_Reports\Dashboard.Dashboard.lgx (Applies to 4.x onwards)

 Line 19:         SaveFile="\\\\NEW_UNC_PATH\\SharedFolders\SavedDashboards\Dashboard_User_@Session.userName~.xml"

 

[Ephesoft Installation Folder]\EphesoftReports\_Definitions\_Reports\Dashboard.serverStatus.lgx (Applies to 4.x onwards)

 Line 140:     XMLFile="\\\\NEW_UNC_PATH\\SharedFolders\SavedDashboards\Dashboard_User_@Session.userName~.xml" />

2. Update the Ephesoft Application Database.

Update all Batch Classes listed in the “batch_class” Table. Use a similar SQL Statement, as the one below, to update each Batch Class record:

 UPDATE batch_class SET unc_folder = Replace(unc_folder, '\\\\OLD_UNC_PATH\\SharedFolders', '\\\\NEW_UNC_PATH\\SharedFolders')WHERE  local_folder LIKE '%SharedFolders%';

Note: You will need to update each record.


3. Update the “batch_instance” table with the new SharedFolders location.

Use a similar SQL Statements, as the ones mentioned below, to update each Batch Instance record:

 UPDATE batch_instance SET local_folder='\\\\NEW_UNC_PATH\\SharedFolders\\ephesoft-system-folder';
 UPDATE batch_instance SET unc_subfolder = Replace(unc_subfolder, '\\\\OLD_UNC_PATH\\SharedFolders', '\\\\NEW_UNC_PATH\\SharedFolders' WHERE  local_folder LIKE '%SharedFolders%');

Note: We have to run this query for all the UNC sub folders present inside UNC folder. If you do not update this table, you must make sure that all batch instances are in the FINISHED or DELETED State.


4. Update HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\Temp\Ephesoft Windows registry information with the new SharedFolders location. This will insure future upgrades will be performed correctly.


5.  Restart a Batch instances from the first module.


Optional:
You will also need to update the Default DB property files located in the “\dcma-data-access\MSSQL\” or “\dcma-data-access\MYSQL\” folders, depending on your DB application.

[Ephesoft Installation Folder]\Application\WEB-INF\classes\META-INF\dcma-data-access\MSSQL\dcma-db.properties

 Line 16: upgradePatch.folder=\\\\NEW_UNC_PATH\\SharedFolders/database-update

[Ephesoft Installation Folder]\Application\WEB-INF\classes\META-INF\dcma-data-access\MYSQL\dcma-db.properties

 Line 26: upgradePatch.folder=\\\\NEW_UNC_PATH\\SharedFolders/database-update

[Ephesoft Installation Folder]\Application\WEB-INF\classes\META-INF\dcma-data-access\MYSQL\post-schema.sql

 Line 150: update batch_class set unc_folder='\\\\NEW_UNC_PATH\\SharedFolders\\mailroom-import' where batch_class_name='MailroomAutomationTemplate';
 Line 151: update batch_class set unc_folder='\\\\NEW_UNC_PATH\\SharedFolders\\searchablepdf-import' where batch_class_name='SearchablePDFTemplate';
 Line 152: update batch_class set unc_folder='\\\\NEW_UNC_PATH\\SharedFolders\\grid-computing-import' where batch_class_name='GridComputingTemplate';
 Line 156: update batch_class_plugin_config set batch_class_plugin_config.plugin_config_value='\\\\NEW_UNC_PATH\\SharedFolders\\final-drop-folder' 
 Line 164: update batch_class_plugin_config set batch_class_plugin_config.plugin_config_value='\\\\NEW_UNC_PATH\\SharedFolders\\csv-export-folder' 
 Line 172: update batch_class_plugin_config set batch_class_plugin_config.plugin_config_value='\\\\NEW_UNC_PATH\\SharedFolders\\ibm-cm-export-folder' 
 Line 180: update batch_class_plugin_config set batch_class_plugin_config.plugin_config_value='\\\\NEW_UNC_PATH\\SharedFolders\\export-script.properties' 
 Line 188: update batch_class_plugin_config set batch_class_plugin_config.plugin_config_value='\\\\NEW_UNC_PATH\\SharedFolders\\tabbed-pdf-export-folder' 
 Line 196: update batch_class_plugin_config set batch_class_plugin_config.plugin_config_value='\\\\NEW_UNC_PATH\\SharedFolders\\NSI-export-folder' 

For a local disk you would use something like “C:\\Folder\\Path”

Note: Mapped network drives will not work with Ephesoft. For drive letter format, only local disks are supported.


Was this article helpful to you?

Walter Lee

Comments are closed.