{"id":34131,"date":"2019-07-01T10:31:34","date_gmt":"2019-07-01T18:31:34","guid":{"rendered":"https:\/\/ephesoft.com\/docs\/?page_id=34131"},"modified":"2020-05-19T12:23:47","modified_gmt":"2020-05-19T19:23:47","slug":"upgrade-single-server-linux","status":"publish","type":"docs","link":"https:\/\/ephesoft.com\/docs\/products\/transact\/install-and-upgrade\/2019-1\/upgrading-on-linux\/upgrade-single-server-linux\/","title":{"rendered":"Ephesoft Transact 2019.1 Upgrade Guide &#8211; Single-Server &#8211;  for Linux"},"content":{"rendered":"<h1><a id=\"post-34131-_Toc8144132\"><\/a><strong>Overview<\/strong><\/h1>\n<p>This document provides information on how to install Ephesoft Transact 2019.1 in the following environment:<\/p>\n<ul>\n<li>Environment \u2014 single-server<\/li>\n<li>Operating system \u2014 Linux<\/li>\n<li>Installation type \u2014 upgrade<\/li>\n<\/ul>\n<p>The following tasks describe how to upgrade to Ephesoft Transact 2019.1:<\/p>\n<table>\n<thead>\n<tr>\n<th><strong>#<\/strong><\/th>\n<th><strong>Installation Task<\/strong><\/th>\n<th><strong>General Scope of Activity<\/strong><\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td>1<\/td>\n<td>Complete the Prerequisites Check<\/td>\n<td>Prepare for installation by gathering installation resources and verifying that the environment is supported.<\/td>\n<\/tr>\n<tr>\n<td>2<\/td>\n<td>Run the Ephesoft Transact Installer:<\/p>\n<ul>\n<li>Normal upgrade<\/li>\n<li>Silent upgrade<\/li>\n<\/ul>\n<\/td>\n<td>Run the Ephesoft Transact installer in the command line interface. For silent upgrade, provide required configurations in the <strong>config.properties<\/strong> file.<\/td>\n<\/tr>\n<tr>\n<td>3<\/td>\n<td>Install the Ephesoft Transact License (if required)<\/td>\n<td>Obtain and install the license if upgrading from Ephesoft Transact versions prior to 4.5.0.0.<\/td>\n<\/tr>\n<tr>\n<td>4<\/td>\n<td>Install the Ephesoft Transact 2019.1 Hotfix<\/td>\n<td>Download and install the 2019.1 hotfix.<\/td>\n<\/tr>\n<tr>\n<td>5<\/td>\n<td>Start the Ephesoft Transact Service<\/td>\n<td>Launch the Ephesoft Transact service.<\/td>\n<\/tr>\n<tr>\n<td>6<\/td>\n<td>Launch Ephesoft Transact 2019.1<\/td>\n<td>Access the Ephesoft Transact app in a browser.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<h1><a id=\"post-34131-_Toc8144133\"><\/a><strong>Upgrade Process<\/strong><\/h1>\n<h2><a id=\"post-34131-_Toc6848123\"><\/a><a id=\"post-34131-_Toc8144134\"><\/a><strong>1. Complete the Prerequisites Check<\/strong><\/h2>\n<ul>\n<li>Upgrade any necessary hardware or software on the current servers. Refer to the <a href=\"https:\/\/ephesoft.com\/docs\/2019-1\/installing-upgrading\/system-requirements\/platform-integration-2019-1\/\">System Requirements and Platform Support<\/a> for additional information.<\/li>\n<li>Complete all in-flight batches. All the batch instances need to be in the Finished state for the reporting jobs to run successfully after the upgrade.<\/li>\n<li>Perform a complete backup of the databases (ephesoft, report and report_archive databases).<\/li>\n<li>Back up all batch classes (export from Batch Class Management).<\/li>\n<li>Back up the Ephesoft <strong>SharedFolders<\/strong> directory.<\/li>\n<li>Run all reports and ensure they are complete and in sync.<\/li>\n<li>Document the Tomcat memory settings (if changed from default) so that they can be restored after the upgrade. For additional information, please refer to the following article: <a href=\"https:\/\/ephesoft.com\/docs\/ephesoft-optimal-memory-settings\/\">Configuring Tomcat Memory Settings<\/a>.<\/li>\n<li>Verify registry information with the following command:<br \/>\n<strong>\/etc\/.java\/.systemPrefs\/com\/ephesoft\/license\/core\/annotation<\/strong><\/li>\n<li>The path for <strong>sharedFolderDir<\/strong> must match the <strong>SharedFolders<\/strong> path currently being used by Ephesoft Transact.<\/li>\n<li>The server.xml and registry database entries must match before starting an upgrade. Check the registry settings to ensure proper configuration for the database upgrade.<\/li>\n<li>Edit the <strong>SelectedDb<\/strong> entry in the registry to reflect the correct database type.<\/li>\n<li>Enter the number in the Value data field in the registry setting to match the database type number.The database options are as follows:\n<ul>\n<li>MariaDB Server (MySQL compatible)<\/li>\n<li>Oracle Database Server<\/li>\n<\/ul>\n<\/li>\n<li>If installing with Oracle Database 11g, confirm that the time zone is set for your local area before running the Transact installer.<\/li>\n<li>For a normal upgrade, make sure you are connected to the internet. Some software will need to be updated or installed from the OS repository during the Ephesoft Transact installation.<\/li>\n<li>Run the installation script with super-user permissions (use the <strong>root<\/strong> user), otherwise, an error message will be displayed, and the script will exit.<\/li>\n<\/ul>\n<p><strong>Note:<\/strong> Ephesoft recommends testing any software upgrade with an existing application before moving the upgrade into production. This is an essential approach to the success of the upgrade process. This approach is particularly important if the software being upgraded is integrated with any other applications, systems, or workflows.<\/p>\n<h2><a id=\"post-34131-_Toc8144135\"><\/a><strong>2. Run the Ephesoft Transact Installer <\/strong><\/h2>\n<h3><a id=\"post-34131-_Toc8144136\"><\/a><strong>Normal Upgrade to Transact 2019.1<\/strong><\/h3>\n<p>1. Download the Ephesoft Transact installer and save it on your Linux machine.<\/p>\n<p>2. Unzip the Ephesoft Transact installer by navigating to the folder containing the .zip file and running the <strong>unzip<\/strong> command.<\/p>\n<p><img decoding=\"async\" width=\"816\" height=\"222\" class=\"wp-image-34132 aligncenter\" src=\"https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2019\/06\/word-image-347.png\" srcset=\"https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2019\/06\/word-image-347.png 816w, https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2019\/06\/word-image-347-300x82.png 300w, https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2019\/06\/word-image-347-768x209.png 768w\" sizes=\"(max-width: 816px) 100vw, 816px\" \/><\/p>\n<p>3. To install Ephesoft Transact, you need super-user permissions.<\/p>\n<p style=\"padding-left: 40px\">3.1. Run the <strong>sudo su root <\/strong>command.<br \/>\n3.2. Use the <strong>chmod -R 777 *<\/strong> command.<\/p>\n<p><strong>Note<\/strong>: If the installation process is started without obtaining the super-user permissions, one of the following messages will be displayed depending on the OS:<\/p>\n<ul>\n<li>\u201cPermission Denied\u201d<\/li>\n<li>\u201cPlease run Ephesoft installation script with super user permissions\u201d<\/li>\n<\/ul>\n<p>4. To start the installation process, use the <strong>.\/install<\/strong> command. Then, select <strong>n<\/strong> as we are not using silent installer.<\/p>\n<p><img decoding=\"async\" width=\"784\" height=\"522\" class=\"wp-image-34133 aligncenter\" src=\"https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2019\/06\/word-image-348.png\" srcset=\"https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2019\/06\/word-image-348.png 784w, https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2019\/06\/word-image-348-300x200.png 300w, https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2019\/06\/word-image-348-768x511.png 768w\" sizes=\"(max-width: 784px) 100vw, 784px\" \/><\/p>\n<p>5. Follow the prompts to complete the upgrade as shown in the image below.<\/p>\n<p style=\"padding-left: 40px\">5.1. Confirm you want to upgrade to Ephesoft Transact 2019.1 by selecting <strong>y<\/strong>.<br \/>\n5.2. Stop the Ephesoft service on all nodes if it is running.<br \/>\n<strong>\u00a0 \u00a0 Note: <\/strong>Ephesoft Transact server needs to be stopped for the upgrade installation.<br \/>\n5.3. Execute the database patch. The database patch is mandatory for a single-server installation. In case of multi-node installation, the database patch must be run only on the first server, and the option can be selected for all remaining servers in the cluster.<\/p>\n<p><strong>Note:<\/strong> If you select <strong>n<\/strong> for a single server, the installation process will continue, however, there could be errors when running database queries.<\/p>\n<p><img decoding=\"async\" width=\"932\" height=\"702\" class=\"wp-image-34134 aligncenter\" src=\"https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2019\/06\/word-image-349.png\" srcset=\"https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2019\/06\/word-image-349.png 932w, https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2019\/06\/word-image-349-300x226.png 300w, https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2019\/06\/word-image-349-768x578.png 768w\" sizes=\"(max-width: 932px) 100vw, 932px\" \/><\/p>\n<p><strong>Important<\/strong>: When upgrading to the latest version of Ephesoft Transact, the <strong>Certs<\/strong>, <strong>lib<\/strong>, and <strong>META-INF<\/strong> folders along with other critical configuration and license files are saved in the back-up directory for future reference. Refer to the image below:<\/p>\n<p><img decoding=\"async\" width=\"848\" height=\"406\" class=\"wp-image-34135 aligncenter\" src=\"https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2019\/06\/word-image-350.png\" srcset=\"https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2019\/06\/word-image-350.png 848w, https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2019\/06\/word-image-350-300x144.png 300w, https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2019\/06\/word-image-350-768x368.png 768w\" sizes=\"(max-width: 848px) 100vw, 848px\" \/><\/p>\n<p>All configurations files are automatically transferred to the newly upgraded application. The only exception is the <strong>log4j.xml<\/strong> file (<strong>&lt;Ephesoft Installation Directory&gt;\/Application<\/strong>), which needs to be updated manually.<\/p>\n<h3><a id=\"post-34131-_Toc8144137\"><\/a><strong>Silent Upgrade to Transact 2019.1<\/strong><\/h3>\n<p>1. Download the Ephesoft Transact installer and save it on your Linux machine.<\/p>\n<p>2. Unzip the Transact installer by navigating to the folder containing the .zip file and running the <strong>unzip<\/strong> command.<\/p>\n<p><img decoding=\"async\" width=\"816\" height=\"222\" class=\"wp-image-34136 aligncenter\" src=\"https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2019\/06\/word-image-351.png\" srcset=\"https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2019\/06\/word-image-351.png 816w, https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2019\/06\/word-image-351-300x82.png 300w, https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2019\/06\/word-image-351-768x209.png 768w\" sizes=\"(max-width: 816px) 100vw, 816px\" \/><\/p>\n<p>3. To install Ephesoft Transact, you need super-user permissions.<\/p>\n<p style=\"padding-left: 40px\">3.1. Run the <strong>sudo su root <\/strong>command.<\/p>\n<p style=\"padding-left: 40px\">3.2. Use the <strong>chmod -R 777 *<\/strong> command.<\/p>\n<p>4. Open the <strong>config.properties<\/strong> file located in the <strong>Response-Files<\/strong> folder in any text editor by running the <strong>vi <\/strong>or<strong> vim <\/strong>or<strong> nano<\/strong> command. Alternatively, you can use WinSCP to connect to your Linux server and open the file in any UI text editor application.<\/p>\n<p><img decoding=\"async\" width=\"874\" height=\"70\" class=\"wp-image-34137 aligncenter\" src=\"https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2019\/06\/word-image-352.png\" srcset=\"https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2019\/06\/word-image-352.png 874w, https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2019\/06\/word-image-352-300x24.png 300w, https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2019\/06\/word-image-352-768x62.png 768w\" sizes=\"(max-width: 874px) 100vw, 874px\" \/><\/p>\n<p>5. Edit the values for the parameters in <strong>config.properties<\/strong> to reflect the required configuration for the upgrade. If using the <strong>vi<\/strong> editor, run the <strong>i<\/strong> command to enter the insert mode to edit the content.<\/p>\n<p>All available parameters are explained in the <strong>config.properties<\/strong> file and also described in the Silent Installation Guide.<\/p>\n<p><img decoding=\"async\" width=\"872\" height=\"620\" class=\"wp-image-34138 aligncenter\" src=\"https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2019\/06\/word-image-353.png\" srcset=\"https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2019\/06\/word-image-353.png 872w, https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2019\/06\/word-image-353-300x213.png 300w, https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2019\/06\/word-image-353-768x546.png 768w\" sizes=\"(max-width: 872px) 100vw, 872px\" \/><\/p>\n<p><strong>Important:<\/strong><\/p>\n<ul>\n<li>Incorrect entries in the <strong>config.properties<\/strong> file can cause installation failure.<\/li>\n<li>Make sure to configure the following two parameters correctly as per the table below:<\/li>\n<\/ul>\n<table>\n<tbody>\n<tr>\n<td>Configurable Property<\/td>\n<td>Description<\/td>\n<\/tr>\n<tr>\n<td>input_database_patch_enable<\/td>\n<td>This parameter is used to define whether to run the database patch:<\/p>\n<p><strong>n <\/strong>\u2013 do not run the database patch<\/p>\n<p><strong>y <\/strong>\u2013 run the database patch<\/p>\n<p>The database patch is mandatory for a single-server installation. In case of a multi-node installation, the database patch is run only on the first server, and the <strong>n<\/strong> option can be selected for all remaining servers in the cluster.<\/p>\n<p>If you select <strong>n<\/strong> for a single server, the installation process will continue, however, there could be errors when running database queries.<\/td>\n<\/tr>\n<tr>\n<td>input_upgrade_application<\/td>\n<td>This parameter is used to define whether the application is being upgraded from an older version. In this case, select <strong>y<\/strong>.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<p>6. Save the updated <strong>config.properties<\/strong> file without changing its name in the <strong>Response-Files<\/strong> folder. If using <strong>vi<\/strong> editor, press <strong>ESC<\/strong> to exit from the insert mode and use the <strong>:wq<\/strong> command to save and close the file.<\/p>\n<p>7. Navigate to the folder with the unzipped Ephesoft Transact installer and start the silent installation process by running the <strong>.\/install -silentinstall -product<\/strong> command.<\/p>\n<p><img decoding=\"async\" width=\"944\" height=\"966\" class=\"wp-image-34139 aligncenter\" src=\"https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2019\/06\/word-image-354.png\" srcset=\"https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2019\/06\/word-image-354.png 944w, https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2019\/06\/word-image-354-293x300.png 293w, https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2019\/06\/word-image-354-768x786.png 768w\" sizes=\"(max-width: 944px) 100vw, 944px\" \/><\/p>\n<p>All required details will be picked up by the installer from the <strong>config.properties<\/strong> files.<\/p>\n<p><strong>Important<\/strong>: When upgrading to the latest version of Ephesoft Transact, the <strong>Certs<\/strong>, <strong>lib<\/strong>, and <strong>META-INF<\/strong> folders along with other critical configuration and license files are saved in the back-up directory for future reference. Refer to the image below:<\/p>\n<p><img decoding=\"async\" width=\"848\" height=\"406\" class=\"wp-image-34140 aligncenter\" src=\"https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2019\/06\/word-image-355.png\" srcset=\"https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2019\/06\/word-image-355.png 848w, https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2019\/06\/word-image-355-300x144.png 300w, https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2019\/06\/word-image-355-768x368.png 768w\" sizes=\"(max-width: 848px) 100vw, 848px\" \/><\/p>\n<p>All configurations files are automatically transferred to the newly upgraded application. The only exception is the <strong>log4j.xml<\/strong> file (<strong>&lt;Ephesoft Installation Directory&gt;\/Application<\/strong>), which needs to be updated manually.<\/p>\n<h2><a id=\"post-34131-_Toc8144138\"><\/a><strong>3. Install the Ephesoft Transact License<\/strong><\/h2>\n<p>If upgrading from previous versions of Ephesoft Transact, you may be required to get a new license. For Ephesoft Transact releases prior to 4.5.0.0, it is mandatory to obtain a new license. For upgrades from Transact 4.5.5.0, we recommend obtaining a new license as there are screen enhancements that were included in version 2019.1.<\/p>\n<p>To obtain a new license, follow the steps below:<\/p>\n<p>1. Navigate to\u00a0<strong>\/opt\/Ephesoft\/Dependencies\/licensing<\/strong>\u00a0and send the <strong>details.properties<\/strong> file to <a href=\"mailto:licenses@ephesoft.com\">licenses@ephesoft.com<\/a> for all nodes that make up environment.<\/p>\n<p><img decoding=\"async\" width=\"668\" height=\"68\" class=\"wp-image-34141 aligncenter\" src=\"https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2019\/06\/word-image-356.png\" srcset=\"https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2019\/06\/word-image-356.png 668w, https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2019\/06\/word-image-356-300x31.png 300w\" sizes=\"(max-width: 668px) 100vw, 668px\" \/><\/p>\n<p>Be sure to note that your installation is a Linux installation and advise the Ephesoft licensing team of the number of CPU cores for all nodes with Ephesoft Transact on them that make up the environment. If you are not sure how many CPU cores your server has, type\u00a0<strong>nproc<\/strong>\u00a0in the terminal and it will give you the number of cores as an output.<\/p>\n<p><img decoding=\"async\" width=\"612\" height=\"73\" class=\"wp-image-34142 aligncenter\" src=\"https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2019\/06\/word-image-357.png\" srcset=\"https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2019\/06\/word-image-357.png 612w, https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2019\/06\/word-image-357-300x36.png 300w\" sizes=\"(max-width: 612px) 100vw, 612px\" \/><\/p>\n<p>2. The Ephesoft licensing team will send you a file named\u00a0<strong>ephesoft.lic<\/strong>.\u00a0Save it to the following folder: <strong>\/opt\/Ephesoft\/Dependencies\/license-util\/ephesoft-license-installer\/<\/strong><\/p>\n<p><img decoding=\"async\" width=\"787\" height=\"114\" class=\"wp-image-34143 aligncenter\" src=\"https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2019\/06\/word-image-358.png\" srcset=\"https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2019\/06\/word-image-358.png 787w, https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2019\/06\/word-image-358-300x43.png 300w, https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2019\/06\/word-image-358-768x111.png 768w\" sizes=\"(max-width: 787px) 100vw, 787px\" \/><\/p>\n<p>3. Navigate to the folder <strong>\/opt\/Ephesoft\/Dependencies\/license-util\/ephesoft-license-installer<\/strong>, and run the <strong>.\/install-license.sh<\/strong> file to install the Ephesoft Transact license.<\/p>\n<p><strong>Important<\/strong>: You need to have super-user permissions to install the Ephesoft Transact license.<\/p>\n<p><img decoding=\"async\" width=\"689\" height=\"229\" class=\"wp-image-34144 aligncenter\" src=\"https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2019\/06\/word-image-359.png\" srcset=\"https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2019\/06\/word-image-359.png 689w, https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2019\/06\/word-image-359-300x100.png 300w\" sizes=\"(max-width: 689px) 100vw, 689px\" \/><\/p>\n<p>The license is installed.<\/p>\n<p><img decoding=\"async\" width=\"696\" height=\"140\" class=\"wp-image-34145 aligncenter\" src=\"https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2019\/06\/word-image-360.png\" srcset=\"https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2019\/06\/word-image-360.png 696w, https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2019\/06\/word-image-360-300x60.png 300w\" sizes=\"(max-width: 696px) 100vw, 696px\" \/><\/p>\n<h2><a id=\"post-34131-_Toc8144139\"><\/a><strong>4. Install the Ephesoft Transact 2019.1 Hotfix<\/strong><\/h2>\n<p>Once Ephesoft Transact is installed and licensed, you need to install the Transact 2019.1 hotfix, which includes important updates and improvements. Note that this hotfix MUST be installed to ensure proper Ephesoft Transact functionality.<\/p>\n<p>To install the hotfix:<\/p>\n<p>1. Download the <a href=\"http:\/\/download.ephesoft.com\/Ephesoft_Product\/2019.1\/Hotfix\/2019.1_Fix_Pack.zip\">2019.1_Fix_Pack.zip<\/a> file, save it to a temporary location and unzip it.<\/p>\n<p>2. Copy the extracted dcma-batch-*, dcma-util-*, dcma-recostar-*, gxt-core-*, gxt-review-validate-* JAR files to the <strong>&lt;Ephesoft Installation Directory&gt;\\Application\\WEB-INF\\lib\\HOT-FIXES <\/strong>directory.<\/p>\n<p>3. Back up the existing <strong>reviewValidate<\/strong> and <strong>bm<\/strong> folders present in the <strong>&lt;Ephesoft Installation Directory&gt;\\Application\\<\/strong> directory.<\/p>\n<p>4. Copy the extracted <strong>reviewValidate<\/strong> and <strong>bm<\/strong> folders to the <strong>&lt;Ephesoft Installation Directory&gt;\\Application\\ <\/strong>directory.<\/p>\n<p>For more information, refer to <a href=\"https:\/\/ephesoft.com\/docs\/announcements\/2019.1-Hotfix\/\">Ephesoft Transact 2019.1 Hotfix<\/a>.<\/p>\n<h2><a id=\"post-34131-_Toc8144140\"><\/a><strong>5. Start the Ephesoft Transact Service<\/strong><\/h2>\n<p>Start the Ephesoft Transact service by running the <strong>service ephesoft start<\/strong> command.<\/p>\n<p>You can open the <strong>catalina.out<\/strong> file in the <strong>\/opt\/Ephesoft\/JavaAppServer\/logs\/<\/strong> folder to track the service start-up process. For that, run the following command: <strong>tail -f catalina.out<\/strong> (the screenshot below shows extracts from the log file).<\/p>\n<p><img decoding=\"async\" width=\"934\" height=\"552\" class=\"wp-image-34146 aligncenter\" src=\"https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2019\/06\/word-image-361.png\" srcset=\"https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2019\/06\/word-image-361.png 934w, https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2019\/06\/word-image-361-300x177.png 300w, https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2019\/06\/word-image-361-768x454.png 768w\" sizes=\"(max-width: 934px) 100vw, 934px\" \/><\/p>\n<h2><a id=\"post-34131-_Toc8144141\"><\/a><strong>6. Launch Ephesoft Transact 2019.1<\/strong><\/h2>\n<p>Open your browser and access the application using the following URL:<\/p>\n<p>http:\/\/<strong><em>&lt;server name&gt;<\/em><\/strong>:<strong><em>&lt;port number&gt;<\/em><\/strong>\/dcma\/home.html.<\/p>\n<p>If any connection error or warning is received, you will need to open the firewall ports to connect to Ephesoft Transact.<\/p>\n<p><img decoding=\"async\" width=\"1126\" height=\"804\" class=\"wp-image-34147 aligncenter\" src=\"https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2019\/06\/word-image-362.png\" srcset=\"https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2019\/06\/word-image-362.png 1126w, https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2019\/06\/word-image-362-300x214.png 300w, https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2019\/06\/word-image-362-768x548.png 768w, https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2019\/06\/word-image-362-1024x731.png 1024w\" sizes=\"(max-width: 1126px) 100vw, 1126px\" \/><\/p>\n<p style=\"text-align: center\"><em>Figure 1. Ephesoft Transact Home Page<\/em><\/p>\n<p>Clicking on the\u00a0<strong>Administrator<\/strong>\u00a0or\u00a0<strong>Operator<\/strong>\u00a0icon will take you to the login screen. The username is\u00a0<strong>ephesoft<\/strong>\u00a0and the password is\u00a0<strong>demo<\/strong>.<\/p>\n<p><strong>Note<\/strong>: If you installed Ephesoft Transact with the Active Directory, use the username and password provided for AD.<\/p>\n<p><img decoding=\"async\" width=\"594\" height=\"436\" class=\"wp-image-34148 aligncenter\" src=\"https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2019\/06\/word-image-363.png\" srcset=\"https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2019\/06\/word-image-363.png 594w, https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2019\/06\/word-image-363-300x220.png 300w\" sizes=\"(max-width: 594px) 100vw, 594px\" \/><\/p>\n<p style=\"text-align: center\"><em>Figure 2. Ephesoft Transact Login Dialogue<\/em><\/p>\n<p>Once you have authenticated, you have completed the installation and configuration with your choice of database and authentication type.<a id=\"post-34131-_Toc8144142\"><\/a><\/p>\n<h1><strong>Appendix<\/strong><\/h1>\n<h2><a id=\"post-34131-_Toc8144143\"><\/a><strong>Custom Script Support<\/strong><\/h2>\n<p>A customer or Ephesoft can develop any customization using custom scripts for Ephesoft Transact 2019.1.<\/p>\n<p>Ephesoft provides support only for custom scripts developed by Ephesoft for the appropriate version of Ephesoft Transact.<\/p>\n<p>Ephesoft does not provide support for such scripts in subsequent releases.<\/p>\n<p>If you have custom scripts developed by someone other than the Ephesoft, please make sure to test these scripts, as we do not provide support unless otherwise agreed.<\/p>\n<p>Before upgrading to Ephesoft Transact 2019.1, Ephesoft highly recommends testing any custom scripts in a test or development environment before upgrading your production environment.<\/p>\n<p>If you need any assistance with custom script creation, upgrading your environment(s) or a consulting session, please contact your Ephesoft Sales Manager.<\/p>\n<h2><a id=\"post-34131-_Toc8144144\"><\/a><strong>API Support<\/strong><\/h2>\n<p>API calls that are deprecated will be noted in the release notes for each version of Ephesoft Transact. Please check the release notes before installing any upgrade.<\/p>\n<h2><a id=\"post-34131-_Toc8144145\"><\/a><strong>Troubleshooting<\/strong><\/h2>\n<ul>\n<li>If the Ephesoft Transact installer stops with an error during any step of the installation process, please send the following files to Ephesoft Support at tickets@ephesoft.com and include the distribution and version of Linux on which you are installing.<\/li>\n<\/ul>\n<p style=\"padding-left: 40px\"><strong>\/var\/log\/install-ephesoft.log<\/strong><\/p>\n<p style=\"padding-left: 40px\"><strong>\/etc\/Ephesoft\/ephesoft.conf\u00a0<\/strong>(only root user has access to this folder; if the file does not exist, send only the first file)<\/p>\n<ul>\n<li>If you do not have <strong>root<\/strong> or <strong>sudo<\/strong> permissions on the server, please contact your system administrator for permissions and\/or instructions.<\/li>\n<li>If installing the <strong>SharedFolders<\/strong> directory on a remote server\/NAS\/SAN, please advise your system administrator to mount the share locally to your server and use the path they provide during the installation. Contact support for assistance if you run into issues. Persistent mount of the share on the local server will be necessary for Ephesoft Transact to function.<\/li>\n<\/ul>\n<p><strong>Notes:<br \/>\n<\/strong>Although Ephesoft Transact may support other Ubuntu and RHEL based distributions, we have not tested them all. Please contact support at tickets@ephesoft.com before attempting an installation so that we can advise you of any changes that may need to be made during the installation process.<\/p>\n<p>In Ubuntu, Ephesoft Transact installation will turn the firewall (ufw) on after install. At the end of the installation, if you want\u00a0ufw turned off, please remember to turn it off again with the command\u00a0<strong>sudo ufw disable<\/strong>.<\/p>\n<p>When shutting down the Ephesoft Transact service in Ubuntu, use the command\u00a0<strong>sudo \/opt\/Ephesoft\/JavaAppServer\/bin\/shutdown.sh<\/strong>.<\/p>\n<p>After installing Ephesoft Transact and before running the application for the first time, run the following commands (dos2unix is installed by Ephesoft):<\/p>\n<p><strong>sudo dos2unix \/opt\/Ephesoft\/JavaAppServer\/conf\/*<\/strong><\/p>\n<p><strong>sudo dos2unix \/opt\/Ephesoft\/JavaAppServer\/bin\/*<\/strong><\/p>\n<h2><a id=\"post-34131-_Toc8144146\"><\/a><strong>Post-Upgrade Health Check<\/strong><\/h2>\n<p>Use WinMerge to compare settings from [backed up pre-upgrade] and [post-upgrade] META-INF config *.properties files and config *.xml files.<\/p>\n<p>Download WinMerge from the following location: <a href=\"http:\/\/winmerge.org\/\">http:\/\/winmerge.org\/<\/a><\/p>\n<p>Expect new line items in the config files if upgrading to a new version of Ephesoft Transact.<\/p>\n<p>Adjust customized settings as found.<\/p>\n<p>Examples of lines you would not change would be completely new config lines that exist in new config files but not in old ones. These configuration files are primarily the *.properties files that are found in:<\/p>\n<p><strong>&lt;Ephesoft Installation Directory&gt;:\\Ephesoft\\Application\\WEB-INF\\classes\\META-INF\\<\/strong><\/p>\n<p>An example of acceptable differences between files would be changes to paths of the database, <strong>SharedFolder<\/strong>, or computer names (if you moved these parts of the environment to various locations).<\/p>\n<p>An example of a configuration that may have changed is the <strong>imagemagick.properties<\/strong> file, which contains different compression settings for TIF and PDF files. If these were previously changed from the default values, they may have reverted back to the default settings.<\/p>\n<p>In some config files, such as user-connectivity properties, config entries that used to have separate lines for LDAP and AD may have consolidated config lines that are now used for both. In these cases, careful consideration should be made before making changes.<\/p>\n<p>For clustered environments, closely check the workflow and reporting properties files against the backup files for consistency across cron expressions.<\/p>\n<p>Restore any custom Tomcat memory settings.<\/p>\n<p>&nbsp;<\/p>\n","protected":false},"featured_media":0,"parent":28328,"menu_order":0,"comment_status":"closed","ping_status":"closed","template":"","doc_tag":[],"yoast_head":"<!-- This site is optimized with the Yoast SEO Premium plugin v19.0 (Yoast SEO v22.1) - https:\/\/yoast.com\/wordpress\/plugins\/seo\/ -->\n<title>Ephesoft Transact 2019.1 Upgrade Guide - Single-Server - for Linux | 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=\"Ephesoft Transact 2019.1 Upgrade Guide - Single-Server - for Linux\" \/>\n<meta property=\"og:description\" content=\"Overview This document provides information on how to install Ephesoft Transact 2019.1 in the following environment: Environment \u2014 single-server Operating [&hellip;]\" \/>\n<meta property=\"og:url\" content=\"https:\/\/ephesoft.com\/docs\/products\/transact\/install-and-upgrade\/2019-1\/upgrading-on-linux\/upgrade-single-server-linux\/\" \/>\n<meta property=\"og:site_name\" content=\"Ephesoft Docs\" \/>\n<meta property=\"article:modified_time\" content=\"2020-05-19T19:23:47+00:00\" \/>\n<meta property=\"og:image\" content=\"https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2019\/06\/word-image-347.png\" \/>\n<meta name=\"twitter:card\" content=\"summary_large_image\" \/>\n<meta name=\"twitter:label1\" content=\"Est. reading time\" \/>\n\t<meta name=\"twitter:data1\" content=\"12 minutes\" \/>\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\"@context\":\"https:\/\/schema.org\",\"@graph\":[{\"@type\":\"WebPage\",\"@id\":\"https:\/\/ephesoft.com\/docs\/products\/transact\/install-and-upgrade\/2019-1\/upgrading-on-linux\/upgrade-single-server-linux\/\",\"url\":\"https:\/\/ephesoft.com\/docs\/products\/transact\/install-and-upgrade\/2019-1\/upgrading-on-linux\/upgrade-single-server-linux\/\",\"name\":\"Ephesoft Transact 2019.1 Upgrade Guide - Single-Server - for Linux | Ephesoft Docs\",\"isPartOf\":{\"@id\":\"https:\/\/ephesoft.com\/docs\/#website\"},\"datePublished\":\"2019-07-01T18:31:34+00:00\",\"dateModified\":\"2020-05-19T19:23:47+00:00\",\"breadcrumb\":{\"@id\":\"https:\/\/ephesoft.com\/docs\/products\/transact\/install-and-upgrade\/2019-1\/upgrading-on-linux\/upgrade-single-server-linux\/#breadcrumb\"},\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\/\/ephesoft.com\/docs\/products\/transact\/install-and-upgrade\/2019-1\/upgrading-on-linux\/upgrade-single-server-linux\/\"]}]},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\/\/ephesoft.com\/docs\/products\/transact\/install-and-upgrade\/2019-1\/upgrading-on-linux\/upgrade-single-server-linux\/#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Home\",\"item\":\"https:\/\/ephesoft.com\/docs\/\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Transact\",\"item\":\"https:\/\/ephesoft.com\/docs\/products\/transact\/\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Install and Upgrade\",\"item\":\"https:\/\/ephesoft.com\/docs\/products\/transact\/install-and-upgrade\/\"},{\"@type\":\"ListItem\",\"position\":4,\"name\":\"Transact 2019.1\",\"item\":\"https:\/\/ephesoft.com\/docs\/products\/transact\/install-and-upgrade\/2019-1\/\"},{\"@type\":\"ListItem\",\"position\":5,\"name\":\"Upgrading on Linux\",\"item\":\"https:\/\/ephesoft.com\/docs\/products\/transact\/install-and-upgrade\/2019-1\/upgrading-on-linux\/\"},{\"@type\":\"ListItem\",\"position\":6,\"name\":\"Ephesoft Transact 2019.1 Upgrade Guide &#8211; Single-Server &#8211; for Linux\"}]},{\"@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\"}]}<\/script>\n<!-- \/ Yoast SEO Premium plugin. -->","yoast_head_json":{"title":"Ephesoft Transact 2019.1 Upgrade Guide - Single-Server - for Linux | Ephesoft Docs","robots":{"index":"noindex","follow":"follow"},"og_locale":"en_US","og_type":"article","og_title":"Ephesoft Transact 2019.1 Upgrade Guide - Single-Server - for Linux","og_description":"Overview This document provides information on how to install Ephesoft Transact 2019.1 in the following environment: Environment \u2014 single-server Operating [&hellip;]","og_url":"https:\/\/ephesoft.com\/docs\/products\/transact\/install-and-upgrade\/2019-1\/upgrading-on-linux\/upgrade-single-server-linux\/","og_site_name":"Ephesoft Docs","article_modified_time":"2020-05-19T19:23:47+00:00","og_image":[{"url":"https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2019\/06\/word-image-347.png"}],"twitter_card":"summary_large_image","twitter_misc":{"Est. reading time":"12 minutes"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"WebPage","@id":"https:\/\/ephesoft.com\/docs\/products\/transact\/install-and-upgrade\/2019-1\/upgrading-on-linux\/upgrade-single-server-linux\/","url":"https:\/\/ephesoft.com\/docs\/products\/transact\/install-and-upgrade\/2019-1\/upgrading-on-linux\/upgrade-single-server-linux\/","name":"Ephesoft Transact 2019.1 Upgrade Guide - Single-Server - for Linux | Ephesoft Docs","isPartOf":{"@id":"https:\/\/ephesoft.com\/docs\/#website"},"datePublished":"2019-07-01T18:31:34+00:00","dateModified":"2020-05-19T19:23:47+00:00","breadcrumb":{"@id":"https:\/\/ephesoft.com\/docs\/products\/transact\/install-and-upgrade\/2019-1\/upgrading-on-linux\/upgrade-single-server-linux\/#breadcrumb"},"inLanguage":"en-US","potentialAction":[{"@type":"ReadAction","target":["https:\/\/ephesoft.com\/docs\/products\/transact\/install-and-upgrade\/2019-1\/upgrading-on-linux\/upgrade-single-server-linux\/"]}]},{"@type":"BreadcrumbList","@id":"https:\/\/ephesoft.com\/docs\/products\/transact\/install-and-upgrade\/2019-1\/upgrading-on-linux\/upgrade-single-server-linux\/#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"Home","item":"https:\/\/ephesoft.com\/docs\/"},{"@type":"ListItem","position":2,"name":"Transact","item":"https:\/\/ephesoft.com\/docs\/products\/transact\/"},{"@type":"ListItem","position":3,"name":"Install and Upgrade","item":"https:\/\/ephesoft.com\/docs\/products\/transact\/install-and-upgrade\/"},{"@type":"ListItem","position":4,"name":"Transact 2019.1","item":"https:\/\/ephesoft.com\/docs\/products\/transact\/install-and-upgrade\/2019-1\/"},{"@type":"ListItem","position":5,"name":"Upgrading on Linux","item":"https:\/\/ephesoft.com\/docs\/products\/transact\/install-and-upgrade\/2019-1\/upgrading-on-linux\/"},{"@type":"ListItem","position":6,"name":"Ephesoft Transact 2019.1 Upgrade Guide &#8211; Single-Server &#8211; for Linux"}]},{"@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"}]}},"comment_count":0,"_links":{"self":[{"href":"https:\/\/ephesoft.com\/docs\/wp-json\/wp\/v2\/docs\/34131"}],"collection":[{"href":"https:\/\/ephesoft.com\/docs\/wp-json\/wp\/v2\/docs"}],"about":[{"href":"https:\/\/ephesoft.com\/docs\/wp-json\/wp\/v2\/types\/docs"}],"replies":[{"embeddable":true,"href":"https:\/\/ephesoft.com\/docs\/wp-json\/wp\/v2\/comments?post=34131"}],"version-history":[{"count":0,"href":"https:\/\/ephesoft.com\/docs\/wp-json\/wp\/v2\/docs\/34131\/revisions"}],"up":[{"embeddable":true,"href":"https:\/\/ephesoft.com\/docs\/wp-json\/wp\/v2\/docs\/28328"}],"wp:attachment":[{"href":"https:\/\/ephesoft.com\/docs\/wp-json\/wp\/v2\/media?parent=34131"}],"wp:term":[{"taxonomy":"doc_tag","embeddable":true,"href":"https:\/\/ephesoft.com\/docs\/wp-json\/wp\/v2\/doc_tag?post=34131"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}