{"id":608,"date":"2020-10-28T09:13:26","date_gmt":"2020-10-28T16:13:26","guid":{"rendered":"https:\/\/ephesoft.com\/docs\/?p=608"},"modified":"2020-10-28T10:16:24","modified_gmt":"2020-10-28T17:16:24","slug":"migrating-the-ephesoft-sharedfolders-location","status":"publish","type":"post","link":"https:\/\/ephesoft.com\/docs\/migrating-the-ephesoft-sharedfolders-location\/","title":{"rendered":"Migrating the Ephesoft SharedFolders Location"},"content":{"rendered":"

Applies to:\u00a0<\/strong>Ephesoft Transact 4.x and above<\/span><\/p>\n

This page provides instructions on how to migrate your Ephesoft SharedFolders location to a different path, either Network or Local.<\/span><\/p>\n

\n

Update Property Files<\/strong><\/span><\/h2>\n
    \n
  1. application.properties, <\/strong>located at [Ephesoft_Directory]<\/em>\\Application\\WEB-INF\\classes\\META-INF\\<\/span><\/li>\n<\/ol>\n
     Line 28: plugin_upload_folder_path=\\\\\\\\NEW_UNC_PATH\\\\SharedFolders\/plugin-upload-folder\r\n<\/span><\/pre>\n
      \n
    1. dcma-batch.properties<\/strong>, located at [Ephesoft_Directory]<\/em>\\Application\\WEB-INF\\classes\\META-INF\\dcma-batch\\<\/span><\/li>\n<\/ol>\n
       Line 1: batch.base_folder=\\\\\\\\NEW_UNC_PATH\\\\SharedFolders\r\n Line 2: batch.local_folder=\\\\\\\\NEW_UNC_PATH\\\\SharedFolders\/ephesoft-system-folder\r\n Line 4: batch.export_folder=\\\\\\\\NEW_UNC_PATH\\\\SharedFolders\/final-drop-folder\r\n Line 17: batch.export_import_folder=\\\\\\\\NEW_UNC_PATH\\\\SharedFolders\/export-batch-folder\r\n Line 24: batch.test_folder=\\\\\\\\NEW_UNC_PATH\\\\SharedFolders\/ephesoft-test-data\r\n<\/span><\/pre>\n
        \n
      1. dcma-db.properties<\/strong>, located at [Ephesoft_Directory]<\/em>\\Application\\WEB-INF\\classes\\META-INF\\dcma-data-access\\<\/span><\/li>\n<\/ol>\n
         Line 17: upgradePatch.folder=\\\\\\\\NEW_UNC_PATH\\\\SharedFolders\/database-update\r\n<\/span><\/pre>\n
          \n
        1. dcma-backup-service.properties<\/strong>, located at [Ephesoft_Directory]<\/em>\\Application\\WEB-INF\\classes\\META-INF\\dcma-util\\<\/span><\/li>\n<\/ol>\n
           Line 1: backup.local_folder=\\\\\\\\NEW_UNC_PATH\\\\SharedFolders\/ephesoft-system-folder\r\n Line 8: backup.report_folder=\\\\\\\\NEW_UNC_PATH\\\\SharedFolders\/report-data\r\n<\/span><\/pre>\n
            \n
          1. dcma-workflows.properties<\/strong>, located at [Ephesoft_Directory]<\/em>\\Application\\WEB-INF\\classes\\META-INF\\dcma-workflows\\<\/span><\/li>\n<\/ol>\n
             Line 15: newWorkflows.basePath=\\\\\\\\NEW_UNC_PATH\\\\SharedFolders\/workflows\r\n<\/span><\/pre>\n
              \n
            1. etl-variables.properties<\/strong>, located at [Ephesoft_Directory]<\/em>\\Application\\WEB-INF\\classes\\META-INF\\dcma-reporting\\<\/span><\/li>\n<\/ol>\n
              \n
               Line 1: reportdata.path=\\\\\\\\NEW_UNC_PATH\\\\SharedFolders\/report-data\r\n<\/span><\/pre>\n<\/div>\n
                \n
              1. server.xml<\/strong>, located at [Ephesoft_Directory]<\/em>\\JavaAppServer\\conf\\<\/span><\/li>\n<\/ol>\n
                 Line 156: <Context path=\"\/dcma-batches\" docBase=\"\\\\\\\\NEW_UNC_PATH\\\\SharedFolders\" debug=\"10\" privileged=\"false\"\/><\/span><\/pre>\n
                  \n
                1. Analysis_Grid.Document_Correction_Analysis_Grid.lgx<\/strong>, located at [Ephesoft_Directory]<\/em>\\EphesoftReports\\_Definitions\\_Reports\\<\/span><\/li>\n<\/ol>\n
                   Line 23: SavedAnalysisGridFolder=\"\\\\\\\\NEW_UNC_PATH\\\\SharedFolders\\SavedAnalysisGrid\"<\/span><\/pre>\n
                   Line 65: DashboardSaveFile=\"\\\\\\\\NEW_UNC_PATH\\\\SharedFolders\\SavedDashboards\\Dashboard_User_@Session.userName~.xml\"<\/span><\/pre>\n
                    \n
                  1. Analysis_Grid.Field_Correction_Analysis_Grid.lgx<\/strong>, located at [Ephesoft_Directory]<\/em>\\EphesoftReports\\_Definitions\\_Reports\\<\/span><\/li>\n<\/ol>\n
                     Line 23: SavedAnalysisGridFolder=\"\\\\\\\\NEW_UNC_PATH\\\\SharedFolders\\SavedAnalysisGrid\"<\/span><\/pre>\n
                     Line 62: DashboardSaveFile=\"\\\\\\\\NEW_UNC_PATH\\\\SharedFolders\\SavedDashboards\\Dashboard_User_@Session.userName~.xml\"<\/span><\/pre>\n
                      \n
                    1. Dashboard.Dashboard.lgx<\/strong>, located at [Ephesoft_Directory]<\/em>\\EphesoftReports\\_Definitions\\_Reports\\<\/span><\/li>\n<\/ol>\n
                       Line 19: SaveFile=\"\\\\\\\\NEW_UNC_PATH\\\\SharedFolders\\SavedDashboards\\Dashboard_User_@Session.userName~.xml\"<\/span><\/pre>\n
                        \n
                      1. Dashboard.serverStatus.lgx<\/strong>, located at [Ephesoft_Directory]<\/em>\\EphesoftReports\\_Definitions\\_Reports\\<\/span><\/li>\n<\/ol>\n
                         Line 140: XMLFile=\"\\\\\\\\NEW_UNC_PATH\\\\SharedFolders\\SavedDashboards\\Dashboard_User_@Session.userName~.xml\" \/><\/span><\/pre>\n
                        \n
                        Update the Ephesoft Application Database<\/b><\/span><\/h2>\n
                        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:<\/span><\/p>\n
                         UPDATE batch_class SET unc_folder = Replace(unc_folder, '\\\\\\\\OLD_UNC_PATH\\\\SharedFolders', '\\\\\\\\NEW_UNC_PATH\\\\SharedFolders')WHERE  local_folder LIKE '%SharedFolders%';\r\n<\/span><\/pre>\n
                        Note:<\/b>\u00a0You will need to update each record.<\/span><\/p>\n
                        \n
                        Update the batch_instance table with the New SharedFolders Location.<\/b><\/span><\/h2>\n
                        Use similar SQL Statements to the ones below to update each Batch Instance record:<\/span><\/p>\n
                         UPDATE batch_instance SET local_folder='\\\\\\\\NEW_UNC_PATH\\\\SharedFolders\\\\ephesoft-system-folder';\r\n UPDATE batch_instance SET unc_subfolder = Replace(unc_subfolder, '\\\\\\\\OLD_UNC_PATH\\\\SharedFolders', '\\\\\\\\NEW_UNC_PATH\\\\SharedFolders' WHERE  local_folder LIKE '%SharedFolders%');\r\n<\/span><\/pre>\n
                        Note:<\/b>\u00a0We have to run this query for all the UNC subfolders present inside the UNC folder. If you do not update this table, you must make sure that all batch instances are in the FINISHED or DELETED State.<\/span><\/p>\n
                        \n
                        Update Windows Registry Information<\/span><\/h2>\n
                        Update HKEY_LOCAL_MACHINE\\SOFTWARE\\Wow6432Node\\Temp\\Ephesoft Windows registry information with the new SharedFolders location. This will ensure future upgrades will be performed correctly.<\/span><\/p>\n
                        \n
                        Additional Configurations<\/span><\/h2>\n
                        Depending on your database application, you may also need to update the default DB property files, located at [Ephesoft_Directory]<\/em>\\Application\\WEB-INF\\classes\\META-INF\\dcma-data-access. This includes either the MSSQL <\/strong>or MYSQL <\/strong>folder.<\/span><\/p>\n
                          \n
                        1. MSSQL: dcma-db.properties<\/strong>, located at [Ephesoft_Directory]<\/em>\\Application\\WEB-INF\\classes\\META-INF\\dcma-data-access\\MSSQL\\<\/span><\/li>\n<\/ol>\n
                           Line 16: upgradePatch.folder=\\\\\\\\NEW_UNC_PATH\\\\SharedFolders\/database-update\r\n<\/span><\/pre>\n
                            \n
                          1. MYSQL: dcma-db.properties<\/strong>, located at [Ephesoft_Directory]<\/em>\\Application\\WEB-INF\\classes\\META-INF\\dcma-data-access\\MYSQL\\<\/span><\/li>\n<\/ol>\n
                             Line 26: upgradePatch.folder=\\\\\\\\NEW_UNC_PATH\\\\SharedFolders\/database-update\r\n<\/span><\/pre>\n
                              \n
                            1. MYSQL: post-schema.sql<\/strong>, located at [Ephesoft_Directory]<\/em>\\Application\\WEB-INF\\classes\\META-INF\\dcma-data-access\\MYSQL\\<\/span><\/li>\n<\/ol>\n
                               Line 150: update batch_class set unc_folder='\\\\\\\\NEW_UNC_PATH\\\\SharedFolders\\\\mailroom-import' where batch_class_name='MailroomAutomationTemplate';\r\n Line 151: update batch_class set unc_folder='\\\\\\\\NEW_UNC_PATH\\\\SharedFolders\\\\searchablepdf-import' where batch_class_name='SearchablePDFTemplate';\r\n Line 152: update batch_class set unc_folder='\\\\\\\\NEW_UNC_PATH\\\\SharedFolders\\\\grid-computing-import' where batch_class_name='GridComputingTemplate';\r\n Line 156: update batch_class_plugin_config set batch_class_plugin_config.plugin_config_value='\\\\\\\\NEW_UNC_PATH\\\\SharedFolders\\\\final-drop-folder' \r\n Line 164: update batch_class_plugin_config set batch_class_plugin_config.plugin_config_value='\\\\\\\\NEW_UNC_PATH\\\\SharedFolders\\\\csv-export-folder' \r\n Line 172: update batch_class_plugin_config set batch_class_plugin_config.plugin_config_value='\\\\\\\\NEW_UNC_PATH\\\\SharedFolders\\\\ibm-cm-export-folder' \r\n Line 180: update batch_class_plugin_config set batch_class_plugin_config.plugin_config_value='\\\\\\\\NEW_UNC_PATH\\\\SharedFolders\\\\export-script.properties' \r\n Line 188: update batch_class_plugin_config set batch_class_plugin_config.plugin_config_value='\\\\\\\\NEW_UNC_PATH\\\\SharedFolders\\\\tabbed-pdf-export-folder' \r\n Line 196: update batch_class_plugin_config set batch_class_plugin_config.plugin_config_value='\\\\\\\\NEW_UNC_PATH\\\\SharedFolders\\\\NSI-export-folder' \r\n<\/span><\/pre>\n
                              For a local disk, you can use something like “C:\\\\Folder\\\\Path”<\/span><\/p>\n
                              Note:<\/b>\u00a0Mapped network drives will not work with Ephesoft. For drive letter format, only local disks are supported.<\/span><\/p>\n
                              You may also need to update the following settings and files:<\/span><\/p>\n
                                \n
                              1. EphesoftTransact.exe<\/strong>, located at [Ephesoft_Directory]<\/em>\\JavaAppServer\\bin<\/span>\n
                                  \n
                                1. Right-click\u00a0EphesoftTransact.exe\u00a0<\/strong>and select\u00a0Run as administrator<\/strong>.<\/span><\/li>\n
                                2. Select the\u00a0Java\u00a0<\/strong>tab<\/span><\/li>\n
                                3. In the\u00a0Java Options<\/strong> field, update the “-Dshared.folders” parameter.<\/span><\/li>\n<\/ol>\n<\/li>\n<\/ol>\n
                                  \"\"<\/a><\/em><\/span><\/p>\n
                                  Figure 1. Ephesoft Transact Properties<\/em><\/span><\/p>\n
                                    \n
                                  1. startup.bat<\/strong>, located at [Ephesoft_Directory]<\/em>\\JavaAppServer\\bin.<\/span>\n
                                      \n
                                    1. Open\u00a0startup.bat\u00a0<\/strong>using an editor.<\/span><\/li>\n
                                    2. Locate and update the SHARED_FOLDERS<\/code> entry to point to the new SharedFolders path.<\/span><\/li>\n<\/ol>\n<\/li>\n<\/ol>\n
                                      \"\"<\/a><\/span><\/p>\n
                                      Figure 2. startup.bat\u00a0<\/em><\/span><\/p>\n
                                        \n
                                      1. applicationContext.xml<\/strong>, located at [Ephesoft_Directory]<\/em>\\Application.<\/span>\n
                                          \n
                                        1. Open\u00a0applicationContext.xml\u00a0<\/strong>using an editor.<\/span><\/li>\n
                                        2. Locate and update the import resource<\/code> parameter.<\/span><\/li>\n<\/ol>\n<\/li>\n<\/ol>\n
                                          <\/span><\/p>\n
                                          Figure 3. applicationContext.xml<\/em><\/span><\/p>\n
                                          \n
                                          Restart Batches<\/span><\/h2>\n
                                          After you’ve completed the above updates, restart your batch instances from the first module.<\/span><\/p>\n","protected":false},"excerpt":{"rendered":"
                                          Applies to:\u00a0Ephesoft Transact 4.x and above This page provides instructions on how to migrate your Ephesoft SharedFolders location to a […]<\/p>\n","protected":false},"author":62,"featured_media":0,"comment_status":"closed","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[12345,12348],"tags":[361,143,166,1067,167,1068],"yoast_head":"\nMigrating the Ephesoft SharedFolders Location | Ephesoft Docs<\/title>\n<meta name=\"robots\" content=\"noindex, follow\" \/>\n<meta property=\"og:locale\" content=\"en_US\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"Migrating the Ephesoft SharedFolders Location\" \/>\n<meta property=\"og:description\" content=\"Applies to:\u00a0Ephesoft Transact 4.x and above This page provides instructions on how to migrate your Ephesoft SharedFolders location to a […]\" \/>\n<meta property=\"og:url\" content=\"https:\/\/ephesoft.com\/docs\/migrating-the-ephesoft-sharedfolders-location\/\" \/>\n<meta property=\"og:site_name\" content=\"Ephesoft Docs\" \/>\n<meta property=\"article:published_time\" content=\"2020-10-28T16:13:26+00:00\" \/>\n<meta property=\"article:modified_time\" content=\"2020-10-28T17:16:24+00:00\" \/>\n<meta property=\"og:image\" content=\"https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2014\/08\/ephesoft_Transact_javaproperties.png\" \/>\n<meta name=\"author\" content=\"Breanna Fitzgerald\" \/>\n<meta name=\"twitter:card\" content=\"summary_large_image\" \/>\n<meta name=\"twitter:label1\" content=\"Written by\" \/>\n\t<meta name=\"twitter:data1\" content=\"Breanna Fitzgerald\" \/>\n\t<meta name=\"twitter:label2\" content=\"Est. reading time\" \/>\n\t<meta name=\"twitter:data2\" content=\"5 minutes\" \/>\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\"@context\":\"https:\/\/schema.org\",\"@graph\":[{\"@type\":\"WebPage\",\"@id\":\"https:\/\/ephesoft.com\/docs\/migrating-the-ephesoft-sharedfolders-location\/\",\"url\":\"https:\/\/ephesoft.com\/docs\/migrating-the-ephesoft-sharedfolders-location\/\",\"name\":\"Migrating the Ephesoft SharedFolders Location | Ephesoft Docs\",\"isPartOf\":{\"@id\":\"https:\/\/ephesoft.com\/docs\/#website\"},\"datePublished\":\"2020-10-28T16:13:26+00:00\",\"dateModified\":\"2020-10-28T17:16:24+00:00\",\"author\":{\"@id\":\"https:\/\/ephesoft.com\/docs\/#\/schema\/person\/d74c698404588430489bf05dfdf4bedd\"},\"breadcrumb\":{\"@id\":\"https:\/\/ephesoft.com\/docs\/migrating-the-ephesoft-sharedfolders-location\/#breadcrumb\"},\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\/\/ephesoft.com\/docs\/migrating-the-ephesoft-sharedfolders-location\/\"]}]},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\/\/ephesoft.com\/docs\/migrating-the-ephesoft-sharedfolders-location\/#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Home\",\"item\":\"https:\/\/ephesoft.com\/docs\/\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Migrating the Ephesoft SharedFolders Location\"}]},{\"@type\":\"WebSite\",\"@id\":\"https:\/\/ephesoft.com\/docs\/#website\",\"url\":\"https:\/\/ephesoft.com\/docs\/\",\"name\":\"Ephesoft Docs\",\"description\":\"Intelligent Document Processing Made Easy\",\"potentialAction\":[{\"@type\":\"SearchAction\",\"target\":{\"@type\":\"EntryPoint\",\"urlTemplate\":\"https:\/\/ephesoft.com\/docs\/?s={search_term_string}\"},\"query-input\":\"required name=search_term_string\"}],\"inLanguage\":\"en-US\"},{\"@type\":\"Person\",\"@id\":\"https:\/\/ephesoft.com\/docs\/#\/schema\/person\/d74c698404588430489bf05dfdf4bedd\",\"name\":\"Breanna Fitzgerald\",\"image\":{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\/\/ephesoft.com\/docs\/#\/schema\/person\/image\/\",\"url\":\"https:\/\/secure.gravatar.com\/avatar\/e0624b0af4f5f3caa370053f6eef54c8?s=96&r=g\",\"contentUrl\":\"https:\/\/secure.gravatar.com\/avatar\/e0624b0af4f5f3caa370053f6eef54c8?s=96&r=g\",\"caption\":\"Breanna Fitzgerald\"}}]}<\/script>\n<!-- \/ Yoast SEO Premium plugin. -->","yoast_head_json":{"title":"Migrating the Ephesoft SharedFolders Location | Ephesoft Docs","robots":{"index":"noindex","follow":"follow"},"og_locale":"en_US","og_type":"article","og_title":"Migrating the Ephesoft SharedFolders Location","og_description":"Applies to:\u00a0Ephesoft Transact 4.x and above This page provides instructions on how to migrate your Ephesoft SharedFolders location to a […]","og_url":"https:\/\/ephesoft.com\/docs\/migrating-the-ephesoft-sharedfolders-location\/","og_site_name":"Ephesoft Docs","article_published_time":"2020-10-28T16:13:26+00:00","article_modified_time":"2020-10-28T17:16:24+00:00","og_image":[{"url":"https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2014\/08\/ephesoft_Transact_javaproperties.png"}],"author":"Breanna Fitzgerald","twitter_card":"summary_large_image","twitter_misc":{"Written by":"Breanna Fitzgerald","Est. reading time":"5 minutes"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"WebPage","@id":"https:\/\/ephesoft.com\/docs\/migrating-the-ephesoft-sharedfolders-location\/","url":"https:\/\/ephesoft.com\/docs\/migrating-the-ephesoft-sharedfolders-location\/","name":"Migrating the Ephesoft SharedFolders Location | Ephesoft Docs","isPartOf":{"@id":"https:\/\/ephesoft.com\/docs\/#website"},"datePublished":"2020-10-28T16:13:26+00:00","dateModified":"2020-10-28T17:16:24+00:00","author":{"@id":"https:\/\/ephesoft.com\/docs\/#\/schema\/person\/d74c698404588430489bf05dfdf4bedd"},"breadcrumb":{"@id":"https:\/\/ephesoft.com\/docs\/migrating-the-ephesoft-sharedfolders-location\/#breadcrumb"},"inLanguage":"en-US","potentialAction":[{"@type":"ReadAction","target":["https:\/\/ephesoft.com\/docs\/migrating-the-ephesoft-sharedfolders-location\/"]}]},{"@type":"BreadcrumbList","@id":"https:\/\/ephesoft.com\/docs\/migrating-the-ephesoft-sharedfolders-location\/#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"Home","item":"https:\/\/ephesoft.com\/docs\/"},{"@type":"ListItem","position":2,"name":"Migrating the Ephesoft SharedFolders Location"}]},{"@type":"WebSite","@id":"https:\/\/ephesoft.com\/docs\/#website","url":"https:\/\/ephesoft.com\/docs\/","name":"Ephesoft Docs","description":"Intelligent Document Processing Made Easy","potentialAction":[{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https:\/\/ephesoft.com\/docs\/?s={search_term_string}"},"query-input":"required name=search_term_string"}],"inLanguage":"en-US"},{"@type":"Person","@id":"https:\/\/ephesoft.com\/docs\/#\/schema\/person\/d74c698404588430489bf05dfdf4bedd","name":"Breanna Fitzgerald","image":{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/ephesoft.com\/docs\/#\/schema\/person\/image\/","url":"https:\/\/secure.gravatar.com\/avatar\/e0624b0af4f5f3caa370053f6eef54c8?s=96&r=g","contentUrl":"https:\/\/secure.gravatar.com\/avatar\/e0624b0af4f5f3caa370053f6eef54c8?s=96&r=g","caption":"Breanna Fitzgerald"}}]}},"_links":{"self":[{"href":"https:\/\/ephesoft.com\/docs\/wp-json\/wp\/v2\/posts\/608"}],"collection":[{"href":"https:\/\/ephesoft.com\/docs\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/ephesoft.com\/docs\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/ephesoft.com\/docs\/wp-json\/wp\/v2\/users\/62"}],"replies":[{"embeddable":true,"href":"https:\/\/ephesoft.com\/docs\/wp-json\/wp\/v2\/comments?post=608"}],"version-history":[{"count":0,"href":"https:\/\/ephesoft.com\/docs\/wp-json\/wp\/v2\/posts\/608\/revisions"}],"wp:attachment":[{"href":"https:\/\/ephesoft.com\/docs\/wp-json\/wp\/v2\/media?parent=608"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/ephesoft.com\/docs\/wp-json\/wp\/v2\/categories?post=608"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/ephesoft.com\/docs\/wp-json\/wp\/v2\/tags?post=608"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}