{"id":48277,"date":"2021-03-04T13:22:37","date_gmt":"2021-03-04T20:22:37","guid":{"rendered":"https:\/\/ephesoft.com\/docs\/?post_type=docs&#038;p=48277"},"modified":"2021-03-04T13:22:37","modified_gmt":"2021-03-04T20:22:37","slug":"linux-upgrade-guide-2020-1-04","status":"publish","type":"docs","link":"https:\/\/ephesoft.com\/docs\/products\/transact\/install-and-upgrade\/transact-2020-1-04\/linux-upgrade-guide-2020-1-04\/","title":{"rendered":"Linux Upgrade Guide 2020.1.04"},"content":{"rendered":"<h2>Introduction<\/h2>\n<p><a id=\"post-46332-_heading=h.30j0zll\"><\/a> This document describes how to upgrade Ephesoft Transact 2020.1.04 in the following environments:<\/p>\n<ul>\n<li>Environments \u2014 single or multi-server<\/li>\n<li>Operating system \u2014 Red Hat Enterprise Linux (RHEL) 7.5 or 7.6<\/li>\n<\/ul>\n<p><strong>Note<\/strong>: Ephesoft Transact 2020.1.04 is only supported for these Linux distributions. Do not run the <code>yum update<\/code> command, as this updates RHEL to an unsupported version. Refer to <a href=\"https:\/\/ephesoft.com\/docs\/how-to-update-to-a-previous-version-of-rhel\/\">How to Update to a Previous Version of RHEL<\/a> for more information.<\/p>\n<ul>\n<li>Installation types \u2014 normal or silent<\/li>\n<\/ul>\n<h3><a id=\"post-46332-_heading=h.1fob9te\"><\/a>Upgrade Overview<\/h3>\n<p>The process of upgrading to Ephesoft Transact 2020.1.04 follows this general sequence of tasks. Before proceeding, review the <a href=\"https:\/\/ephesoft.com\/docs\/products\/transact\/announcements\/release-notes\/release-notes-2020-1-04\/\">2020.1.04 Release Notes<\/a>.<\/p>\n<table>\n<tbody>\n<tr bgcolor=\"#1f3864\">\n<td><span style=\"color: #ffffff\"><strong>Installation Task<\/strong><\/span><\/td>\n<td><span style=\"color: #ffffff\"><strong>General Scope of Activity<\/strong><\/span><\/td>\n<\/tr>\n<tr bgcolor=\"#d9e2f3\">\n<td><a href=\"#prerequisites\">Prerequisites<\/a><\/td>\n<td>Prepare to upgrade by gathering the required resources and verifying that the environment and databases are supported.<\/td>\n<\/tr>\n<tr>\n<td><a href=\"#prepare-for-upgrade\">Prepare the Server for Upgrade<\/a><\/td>\n<td>Perform these steps to prepare the server for the upgrade installer.<\/td>\n<\/tr>\n<tr bgcolor=\"#d9e2f3\">\n<td><a href=\"#download-and-run\">Download and Run the Ephesoft Transact Installer<\/a><\/td>\n<td>Run the Ephesoft Transact installer in the command line interface.<\/p>\n<p>For a silent upgrade, provide the required configurations in the <strong>config.properties<\/strong> file.<\/td>\n<\/tr>\n<tr>\n<td><a href=\"#normal-or-silent\">Select Normal or Silent Upgrade<\/a><\/td>\n<td>Determine if you are performing a normal or silent upgrade and follow the steps for your selected option.<\/td>\n<\/tr>\n<tr bgcolor=\"#d9e2f3\">\n<td><a href=\"#license-and-launch\">License and Launch Ephesoft Transact 2020.1.04<\/a><\/td>\n<td>Perform these steps to complete the upgrade for Ephesoft Transact 2020.1.04.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<h2><a id=\"prerequisites\"><\/a>Prerequisites<\/h2>\n<p><span style=\"font-weight: 400\">Perform these steps for a successful software upgrade and startup:<\/span><\/p>\n<ol>\n<li style=\"font-weight: 400\"><span style=\"font-weight: 400\">Determine if you need to perform a single-server or multi-server upgrade.<\/span><\/li>\n<\/ol>\n<p><b>Important:<\/b><span style=\"font-weight: 400\"> Steps unique to a multi-server environment upgrade are identified where applicable.<\/span><\/p>\n<ol start=\"2\">\n<li style=\"font-weight: 400\"><span style=\"font-weight: 400\">Verify that the existing installation of Ephesoft Transact is supported for direct upgrade to Ephesoft Transact 2020.1.04.\u00a0<\/span><\/li>\n<\/ol>\n<ul>\n<li style=\"font-weight: 400\"><span style=\"font-weight: 400\">If the system is currently running Ephesoft Transact version 2020.1.x, your system is supported for direct upgrade to Ephesoft Transact 2020.1.04.\u00a0<\/span>\n<ul>\n<li style=\"font-weight: 400\"><span style=\"font-weight: 400\">If the system is currently running Ephesoft Transact 2020.1 and you are using the Cloud HyperExtender plugin, you will need to install the <\/span><a href=\"https:\/\/ephesoft.com\/docs\/products\/transact\/install-and-upgrade\/2020-1\/windows-upgrade-guide\/#service-pack-installation\"><span style=\"font-weight: 400\">2020.1.01 service pack<\/span><\/a><span style=\"font-weight: 400\"> before you can upgrade to 2020.1.04.<\/span><\/li>\n<\/ul>\n<\/li>\n<li style=\"font-weight: 400\"><span style=\"font-weight: 400\">If the system is currently running a release prior to Ephesoft Transact 2020.1, you will need to upgrade to version 2020.1 before upgrading to Ephesoft Transact 2020.1.04.<\/span><\/li>\n<\/ul>\n<p><b>Important:<\/b><span style=\"font-weight: 400\"> If you are required to perform an intermediate upgrade, then you must successfully start Ephesoft Transact 2020.1 before upgrading to version 2020.1.04 or the upgrade process will fail<\/span><span style=\"font-weight: 400\">.<\/span><\/p>\n<ol start=\"3\">\n<li style=\"font-weight: 400\"><span style=\"font-weight: 400\">Verify that your database version is supported. Refer to <\/span><a href=\"https:\/\/ephesoft.com\/docs\/install-and-upgrade\/2020-1\/platform-configuration-and-third-party-integrations-transact-2020-1\/\"><span style=\"font-weight: 400\">Platform Configuration and Third-Party Integrations<\/span><\/a><span style=\"font-weight: 400\"> for additional information.<\/span><\/li>\n<\/ol>\n<p><b>Important<\/b><span style=\"font-weight: 400\">: If you are upgrading to Ephesoft Transact 2020.1.04 with an existing version of MariaDB or MySQL database engine, refer to <\/span><a href=\"https:\/\/ephesoft.com\/docs\/install-and-upgrade\/2020-1\/install-and-migrate-to-mariadb-for-linux\/\"><span style=\"font-weight: 400\">Install and Migrate to MariaDB for Linux<\/span><\/a><span style=\"font-weight: 400\"> before proceeding any further with the upgrade.\u00a0<\/span><\/p>\n<ol start=\"4\">\n<li style=\"font-weight: 400\"><span style=\"font-weight: 400\">Verify that internet connectivity is available for this upgrade.<\/span><\/li>\n<\/ol>\n<pre><span style=\"font-weight: 400\">nm-online<\/span><\/pre>\n<p><b>Note<\/b><span style=\"font-weight: 400\">: The installation will be interrupted if an internet connection is unavailable, as some software requires updates or installation from the operating system\u2019s repository.\u00a0<\/span><\/p>\n<ol start=\"5\">\n<li style=\"font-weight: 400\"><span style=\"font-weight: 400\">Verify that you have super-user (root) permissions. If you are not a super-user, execute the following command to gain super-user permissions.\u00a0<\/span><\/li>\n<\/ol>\n<pre><span style=\"font-weight: 400\">sudo su root<\/span><\/pre>\n<p><b>Important<\/b><span style=\"font-weight: 400\">: The installation script must be run with super-user permissions, or an error will occur, and the script will exit.\u00a0<\/span><\/p>\n<ol start=\"6\">\n<li style=\"font-weight: 400\"><span style=\"font-weight: 400\">Verify that SharedFolders is accessible on the server undergoing upgrade.<\/span><\/li>\n<\/ol>\n<hr \/>\n<h2><a id=\"prepare-for-upgrade\"><\/a>Prepare the Server for Upgrade<\/h2>\n<p>Perform these steps to prepare the server for an upgrade to Ephesoft Transact 2020.1.03:<\/p>\n<ol>\n<li>Complete all in-flight batches. All batch instances must be in the <strong>Finished<\/strong> state for the upgrade to be successful.<\/li>\n<li>Perform a complete backup of the following:<\/li>\n<\/ol>\n<ul>\n<li style=\"list-style-type: none\">\n<ul>\n<li><strong>Ephesoft<\/strong>, <strong>Report<\/strong>, and <strong>Report_Archive<\/strong> databases<\/li>\n<li>Batch classes<\/li>\n<li>Ephesoft<strong> SharedFolders<\/strong> directory<\/li>\n<\/ul>\n<\/li>\n<\/ul>\n<ol start=\"3\">\n<li>Run all reports and ensure they are complete and in sync.<\/li>\n<li>If the Apache Tomcat memory settings were changed from the default, take note of your current configuration to restore after upgrading. Refer to <a href=\"https:\/\/ephesoft.com\/docs\/ephesoft-optimal-memory-settings\/\">Configuring Tomcat Memory Settings<\/a> for additional information.<\/li>\n<li>Verify registry information with the following command:<\/li>\n<\/ol>\n<pre>\/etc\/.java\/.systemPrefs\/com\/Ephesoft\/license\/core\/annotation<\/pre>\n<ol start=\"6\">\n<li>Ensure the following paths and settings are properly configured:<\/li>\n<\/ol>\n<ul>\n<li style=\"list-style-type: none\">\n<ul>\n<li>Check that the path for <strong>sharedFolderDir <\/strong>matches the SharedFolders path currently being used by Ephesoft Transact.<\/li>\n<li>Check the registry settings to ensure that the DB Names and IP Address in Apache Tomcat\u2019s <strong>server.xml<\/strong> and <strong>registry<\/strong> <strong>database<\/strong> entries match. If there are any changes in the database information you will need to edit the appropriate settings in the <strong>server.xml<\/strong> and <strong>registry<\/strong> <strong>database<\/strong> to reflect those changes.<\/li>\n<li>Edit the <strong>SelectedDb<\/strong> entry in the registry to reflect the correct database type.<\/li>\n<li>Edit the number in the <strong>Value data<\/strong> field in the registry settings to match the database.\n<ul>\n<li>Select 1 for MariaDB Server(MySQL compatible).<\/li>\n<li>Select 2 for Oracle Database Server.<\/li>\n<\/ul>\n<\/li>\n<\/ul>\n<\/li>\n<\/ul>\n<p><strong>Important<\/strong>: If the upgrade to Ephesoft Transact 2020.1.04 requires a database migration or database version upgrade, these changes must be made prior to starting the upgrade process. Refer to <a href=\"https:\/\/ephesoft.com\/docs\/install-and-upgrade\/2020-1\/platform-configuration-and-third-party-integrations-transact-2020-1\/\">Platform<\/a> Configurations and Third-Party Integrations for supported versions and <a href=\"https:\/\/ephesoft.com\/docs\/install-and-upgrade\/2020-1\/install-and-migrate-to-mariadb-for-linux\/\">Install and Migrate to MariaDB<\/a> for additional instructions.<\/p>\n<p><strong>Note<\/strong>: We recommend testing any software upgrade with an existing application before moving the upgrade into production if the software being upgraded is integrated with any other applications, systems, or workflows.<\/p>\n<ol start=\"7\">\n<li>Stop Ephesoft Transact running as a service using the following command:<\/li>\n<\/ol>\n<pre>service ephesoft stop.<\/pre>\n<p><img decoding=\"async\" width=\"466\" height=\"37\" class=\"wp-image-46468\" src=\"https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2020\/07\/word-image-156.png\" srcset=\"https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2020\/07\/word-image-156.png 466w, https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2020\/07\/word-image-156-300x24.png 300w\" sizes=\"(max-width: 466px) 100vw, 466px\" \/><\/p>\n<p><em>Figure 1: Stop Ephesoft Transact Service<\/em><\/p>\n<ol start=\"8\">\n<li>Ensure that the target installation drive has enough space for the installation files. You may require up to 8GB of space.<\/li>\n<\/ol>\n<hr \/>\n<h2><a id=\"download-and-run\"><\/a>Download and Run the Ephesoft Transact Installer<\/h2>\n<p><a id=\"post-46332-_heading=h.1t3h5sf\"><\/a> Perform these steps to upgrade to Ephesoft Transact 2020.1.04:<\/p>\n<ol>\n<li>Refer to the <a href=\"https:\/\/ephesoft.com\/docs\/products\/transact\/download\/\">Downloads<\/a> page for information on how to obtain the Ephesoft Transact installer.<\/li>\n<li>Unzip the Ephesoft Transact installer by navigating to the folder containing the ZIP file and execute the following command:<\/li>\n<\/ol>\n<pre>unzip Ephesoft_Transact_2020.1.04_Linux.zip<\/pre>\n<p>If unzip is not installed, use the following command:<\/p>\n<pre>sudo yum install unzip<\/pre>\n<p><img decoding=\"async\" width=\"638\" height=\"291\" class=\"wp-image-46469\" src=\"https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2020\/07\/word-image-157.png\" srcset=\"https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2020\/07\/word-image-157.png 638w, https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2020\/07\/word-image-157-300x137.png 300w\" sizes=\"(max-width: 638px) 100vw, 638px\" \/><\/p>\n<p><em>Figure 3: Execute the unzip command<\/em><\/p>\n<ol start=\"3\">\n<li>Run the following command to make the files executable:<\/li>\n<\/ol>\n<pre>chmod 777 install install-helper uninstall.<\/pre>\n<p>This is illustrated in Figure 3, below.<\/p>\n<p><img decoding=\"async\" width=\"758\" height=\"38\" class=\"wp-image-46470\" src=\"https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2020\/07\/word-image-158.png\" srcset=\"https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2020\/07\/word-image-158.png 758w, https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2020\/07\/word-image-158-300x15.png 300w\" sizes=\"(max-width: 758px) 100vw, 758px\" \/><\/p>\n<p><em>Figure 4: Execute the cmod 777 Command<\/em><\/p>\n<ol start=\"4\">\n<li>Run the following command to start the installation process:<\/li>\n<\/ol>\n<pre>.\/install<\/pre>\n<p><img decoding=\"async\" width=\"335\" height=\"24\" class=\"wp-image-46471\" src=\"https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2020\/07\/word-image-159.png\" srcset=\"https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2020\/07\/word-image-159.png 335w, https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2020\/07\/word-image-159-300x21.png 300w\" sizes=\"(max-width: 335px) 100vw, 335px\" \/><\/p>\n<p><em>Figure 5: Execute the .\/install Command<\/em><\/p>\n<p><strong>Important<\/strong>: If the Ephesoft Transact installer stops during any step of the upgrade process, contact Ephesoft Support at <a href=\"mailto:tickets@ephesoft.com\">tickets@ephesoft.com<\/a> and provide the following files and details:<\/p>\n<ul>\n<li style=\"list-style-type: none\">\n<ul>\n<li>Your distribution and version of Linux.<\/li>\n<li><strong>var\/log\/install-ephesoft.log <\/strong><\/li>\n<li><strong>\/etc\/Ephesoft\/Ephesoft.conf<\/strong>\n<ul>\n<li>Only the root user has access to this folder. If the file does not exist, send only the first file.<\/li>\n<\/ul>\n<\/li>\n<\/ul>\n<\/li>\n<\/ul>\n<ol start=\"5\">\n<li>You will be prompted to decide if you want to install Ephesoft Transact as a silent installer (figure 5).\n<ul>\n<li>If you are performing a normal upgrade, select n and proceed to <strong>Normal Upgrade<\/strong>.<\/li>\n<li>If you are performing a silent upgrade, select y and proceed to <strong>Silent Upgrade<\/strong>.<\/li>\n<\/ul>\n<\/li>\n<\/ol>\n<p><img decoding=\"async\" class=\"wp-image-46472\" src=\"https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2020\/07\/word-image-160.png\" width=\"630\" height=\"371\" srcset=\"https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2020\/07\/word-image-160.png 722w, https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2020\/07\/word-image-160-300x177.png 300w\" sizes=\"(max-width: 630px) 100vw, 630px\" \/><\/p>\n<p><em>Figure 6: Silent or Normal Installation<\/em><\/p>\n<hr \/>\n<h3><a id=\"normal-or-silent\"><\/a>Normal Upgrade<\/h3>\n<ol>\n<li>The following screen will display while the installer checks the internet connection. Press y to confirm that you want to upgrade to Ephesoft Transact 2020.1.04.<\/li>\n<\/ol>\n<p><img decoding=\"async\" width=\"722\" height=\"62\" class=\"wp-image-46473\" src=\"https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2020\/07\/word-image-161.png\" srcset=\"https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2020\/07\/word-image-161.png 722w, https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2020\/07\/word-image-161-300x26.png 300w\" sizes=\"(max-width: 722px) 100vw, 722px\" \/><\/p>\n<p><em>Figure 7: Upgrade to Ephesoft Transact 2020.1.04<\/em><\/p>\n<ol start=\"2\">\n<li>You will be prompted to forcefully stop the Ephesoft Transact service if it is running. Press y to stop the Ephesoft Transact service on all nodes. The upgrade process cannot proceed if the Ephesoft Transact server is running.<\/li>\n<\/ol>\n<p><strong>Important<\/strong>: The following steps vary depending on a single or multi-server installation. Carefully read the steps below before proceeding further.<\/p>\n<ol start=\"3\">\n<li>The following screen displays:<\/li>\n<\/ol>\n<p><img decoding=\"async\" width=\"722\" height=\"83\" class=\"wp-image-46474\" src=\"https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2020\/07\/word-image-162.png\" srcset=\"https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2020\/07\/word-image-162.png 722w, https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2020\/07\/word-image-162-300x34.png 300w\" sizes=\"(max-width: 722px) 100vw, 722px\" \/><\/p>\n<p><em>Figure 8: Database Patch<\/em><\/p>\n<ul>\n<li style=\"list-style-type: none\">\n<ul>\n<li>For a single-server upgrade, press <strong>y<\/strong> to run the database patch. The database patch is mandatory for a single-server upgrade, or if you are upgrading the first server in a multi-server installation.<\/li>\n<li>For a multi-server upgrade, the database patch is only required for the first server in the node. Press <strong>n<\/strong> for subsequent server upgrades.<\/li>\n<\/ul>\n<\/li>\n<\/ul>\n<p style=\"padding-left: 40px\"><strong>Important: <\/strong>If you run the database patch on a second or subsequent server in a multi-server installation, you may corrupt the existing database.<\/p>\n<ol start=\"4\">\n<li>If Tesseract (an OCR engine) was not installed with the previous installation, the following screen will display:\n<ul>\n<li>Select <strong>n<\/strong> to decline to install Tesseract. Tesseract is optional, and not required for Ephesoft Transact to function properly.<\/li>\n<\/ul>\n<\/li>\n<\/ol>\n<p><img decoding=\"async\" width=\"722\" height=\"82\" class=\"wp-image-46475\" src=\"https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2020\/07\/word-image-163.png\" srcset=\"https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2020\/07\/word-image-163.png 722w, https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2020\/07\/word-image-163-300x34.png 300w\" sizes=\"(max-width: 722px) 100vw, 722px\" \/><\/p>\n<p><em>Figure 9: Install Tesseract<\/em><\/p>\n<ul>\n<li style=\"list-style-type: none\">\n<ul>\n<li>Select <strong>y<\/strong> to install Tesseract.<\/li>\n<\/ul>\n<\/li>\n<\/ul>\n<ol start=\"5\">\n<li>The installer will begin upgrading sources. This may take some time.<\/li>\n<li>The installer will prompt for registration information. This information is used to assist in the generation of your license for Ephesoft Transact. Provide the registration details.<\/li>\n<\/ol>\n<p><img decoding=\"async\" class=\"wp-image-46476\" src=\"https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2020\/07\/https-ephesoft-com-docs-wp-content-uploads-2019-1-21.png\" alt=\"https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2019\/06\/word-image-331.png\" width=\"550\" height=\"324\" srcset=\"https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2020\/07\/https-ephesoft-com-docs-wp-content-uploads-2019-1-21.png 752w, https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2020\/07\/https-ephesoft-com-docs-wp-content-uploads-2019-1-21-300x177.png 300w\" sizes=\"(max-width: 550px) 100vw, 550px\" \/><\/p>\n<p><em>Figure 10: Registration Information<\/em><\/p>\n<p><strong>Note<\/strong>: The following screen will display after the installer saves critical configurations, license files, and folders in the back-up directory for future reference. The only exception is the <strong>log4j.xml<\/strong> file, which needs to be updated manually.<\/p>\n<p><img decoding=\"async\" class=\"wp-image-46477\" src=\"https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2020\/07\/word-image-164.png\" width=\"672\" height=\"145\" srcset=\"https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2020\/07\/word-image-164.png 742w, https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2020\/07\/word-image-164-300x65.png 300w\" sizes=\"(max-width: 672px) 100vw, 672px\" \/><\/p>\n<p><em>Figure 11: Ephesoft Transact Upgrade Complete<\/em><\/p>\n<ol start=\"7\">\n<li>Update the <strong>log4j.xml<\/strong> file. The old log4j.xml can be found at<strong> \/opt\/Ephesoft\/Application-backup-&lt;previous-version&gt;\/log4j.xml<\/strong>.<\/li>\n<li>Copy the old <strong>log4j.xml<\/strong> and replace the new <strong>log4j.xml<\/strong> with the old one at <strong>\/opt\/Ephesoft\/Application\/log4j.xml<\/strong>.<\/li>\n<\/ol>\n<p>The upgrade is complete. Proceed to <a href=\"http:\/\/post-46332-_heading=h.lnxbz9\">License and Launch Ephesoft Transact 2020.1.04<\/a>.<\/p>\n<hr \/>\n<h4><a id=\"post-46332-_heading=h.2s8eyo1\"><\/a>Silent Upgrade<\/h4>\n<ol>\n<li>Open the <strong>config.properties<\/strong> file located in the <strong>Response-Files<\/strong> folder. To do so, open a text editor and run one of the following commands:<\/li>\n<\/ol>\n<ul>\n<li style=\"list-style-type: none\">\n<ul>\n<li>vi config.properties<\/li>\n<li>vim config.properties<\/li>\n<li>nano config.properties<\/li>\n<\/ul>\n<\/li>\n<\/ul>\n<p><img decoding=\"async\" width=\"722\" height=\"37\" class=\"wp-image-46478\" src=\"https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2020\/07\/word-image-165.png\" srcset=\"https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2020\/07\/word-image-165.png 722w, https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2020\/07\/word-image-165-300x15.png 300w\" sizes=\"(max-width: 722px) 100vw, 722px\" \/><\/p>\n<p><em>Figure 12: vi config.properties Command <\/em><\/p>\n<p><strong>Note<\/strong>: You can also use <strong>WinSCP<\/strong> to connect to your Linux server and open the file in any UI text editor application.<\/p>\n<p>Edit the values for the parameters in <strong>config.properties<\/strong> to reflect the required configuration for the upgrade. If using vi editor, run the<strong> i<\/strong> command to enter <strong>insert mode<\/strong> and edit the content. See the table on configurable properties below for explanations of important parameters.<\/p>\n<p><img decoding=\"async\" width=\"722\" height=\"376\" class=\"wp-image-46479\" src=\"https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2020\/07\/word-image-166.png\" srcset=\"https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2020\/07\/word-image-166.png 722w, https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2020\/07\/word-image-166-300x156.png 300w\" sizes=\"(max-width: 722px) 100vw, 722px\" \/><\/p>\n<p><em>Figure 13: Edit <\/em><strong><em>config.properties<\/em><\/strong><em> File<\/em><\/p>\n<p><strong>Important<\/strong>: The upgrade may fail if any of the following settings in <strong>config.properties<\/strong> file are incorrect.<\/p>\n<table>\n<tbody>\n<tr>\n<td><strong>Configurable Property<\/strong><\/td>\n<td><strong>Description<\/strong><\/td>\n<\/tr>\n<tr>\n<td>input_database_patch_enable<\/td>\n<td>Select one of the following options depending on your server environment:<\/p>\n<ol>\n<li>For a single-server upgrade, press y to run the database patch. The database patch is mandatory for a single-server upgrade, or if you are upgrading the first server in a multi-server installation.<\/li>\n<li>For a multi-server upgrade, the database patch is only required for the first server in the node. Press n for subsequent server upgrades.<\/li>\n<\/ol>\n<\/td>\n<\/tr>\n<tr>\n<td>input_upgrade_application<\/td>\n<td>Select y to upgrade Ephesoft Transact from an older version.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<ol start=\"3\">\n<li>Save the updated <strong>config.properties<\/strong> file to the same name in the <strong>Response-Files<\/strong> folder. If using vi editor, press the <strong>ESC<\/strong> key to exit insert mode and use the :wq command to save and close the file.<\/li>\n<li>Navigate to the folder with the unzipped Ephesoft Transact installer and start the silent installation process by running the following command:<\/li>\n<\/ol>\n<pre>.\/install -silentinstall -product<\/pre>\n<p><img decoding=\"async\" class=\"wp-image-46480\" src=\"https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2020\/07\/word-image-167.png\" width=\"639\" height=\"468\" srcset=\"https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2020\/07\/word-image-167.png 722w, https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2020\/07\/word-image-167-300x220.png 300w\" sizes=\"(max-width: 639px) 100vw, 639px\" \/><\/p>\n<p><em>Figure 14: Start the Silent Installation<\/em><\/p>\n<ol start=\"5\">\n<li>The installer will pick up all the required details from the <strong>config.properties<\/strong> files.<\/li>\n<\/ol>\n<p><strong>Note<\/strong>: When upgrading to the latest version of Ephesoft Transact, critical configurations, license files, and the <strong>Certs<\/strong>, <strong>lib<\/strong>, and <strong>META-INF<\/strong> folders are saved in the back-up directory for future reference.<\/p>\n<p><img decoding=\"async\" width=\"723\" height=\"273\" class=\"wp-image-46481\" src=\"https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2020\/07\/word-image-168.png\" srcset=\"https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2020\/07\/word-image-168.png 723w, https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2020\/07\/word-image-168-300x113.png 300w\" sizes=\"(max-width: 723px) 100vw, 723px\" \/><\/p>\n<p><em>Figure 15: Back-up Directory<\/em><\/p>\n<ol start=\"6\">\n<li>All configurations files are automatically transferred to the newly upgraded application. The only exception is the <strong>log4j.xm<\/strong>l file, which needs to be updated manually.<\/li>\n<li>The old <strong>log4j.xml<\/strong> can be found at <strong>\/opt\/Ephesoft\/Application-backup-&lt;previous-version&gt;\/log4j.xml<\/strong>.<\/li>\n<li>Copy the old <strong>log4j.xml<\/strong> and replace it with the new <strong>log4j.xml<\/strong> at <strong>\/opt\/Ephesoft\/Application\/log4j.xml<\/strong>.<\/li>\n<\/ol>\n<p>The silent upgrade is complete. Proceed to the next section.<\/p>\n<hr \/>\n<h2><a id=\"license-and-launch\"><\/a>License and Launch Ephesoft Transact 2020.1.04<\/h2>\n<p><a id=\"post-46332-_heading=h.35nkun2\"><\/a> To complete the upgrade, refer to <a href=\"https:\/\/ephesoft.com\/docs\/install-and-upgrade\/system-requirements\/licensing\/\">Licensing Requirements<\/a>. You will need a new license for Transact 2020.1.04.<\/p>\n<p><strong>Important<\/strong>: Ephesoft recommends restarting the service after your license registry is updated.<\/p>\n<ol>\n<li>Compare the post-upgrade properties files against the pre-upgrade properties files. You must match the configuration settings of the post-upgrade property files to the pre-upgrade property files.<\/li>\n<\/ol>\n<p><strong>Note<\/strong>: The upgrade installer creates a backup folder to store the pre-upgrade configuration settings and components.<\/p>\n<ul>\n<li>Use the <strong>diff<\/strong> command to compare and merge the pre-upgrade configurations into the post-upgrade configurations. Original configuration files are backed up on the same server. Navigate to the folder where Ephesoft Transact was installed and find the backup folder of your previously installed version of Ephesoft Transact to get access to your prior configurations, files, and settings. Properties, file settings, or components that are unique to each deployment can include the following:\n<ul>\n<li>Computer names<\/li>\n<li>Database paths<\/li>\n<li>HTTPS (as applicable)<\/li>\n<li>ImageMagick (as applicable)<\/li>\n<li>JavaAppServer<\/li>\n<li>Keystore location<\/li>\n<li>Registry<\/li>\n<li>Single Sign-On (SSO)<\/li>\n<li>User connectivity for Microsoft Active Directory, Apache Tomcat, or LDAP<\/li>\n<\/ul>\n<\/li>\n<\/ul>\n<p>Refer to <a href=\"https:\/\/ephesoft.com\/docs\/what-are-the-folders-where-customer-specific-data-is-stored\/\">Folders where Customer-specific Data is Stored<\/a> for additional information.<\/p>\n<ul>\n<li>If you are upgrading from a version prior to 4.5.0.0, you will need a new license for 2020.1.04.<\/li>\n<\/ul>\n<p><img decoding=\"async\" width=\"722\" height=\"174\" class=\"wp-image-46482\" src=\"https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2020\/07\/word-image-169.png\" srcset=\"https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2020\/07\/word-image-169.png 722w, https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2020\/07\/word-image-169-300x72.png 300w\" sizes=\"(max-width: 722px) 100vw, 722px\" \/><\/p>\n<p><em>Figure 16: diff Command to Compare Configurations<\/em><\/p>\n<ol start=\"2\">\n<li>Start the Ephesoft Transact service by running the following command:<\/li>\n<\/ol>\n<pre>service ephesoft start<\/pre>\n<p>You can track the service start-up process by opening the <strong>catalina.out<\/strong> file in the <strong>\/opt\/Ephesoft\/JavaAppServer\/logs\/<\/strong> folder and running the following command:<\/p>\n<pre>tail -f catalina.out<\/pre>\n<p><img decoding=\"async\" class=\"wp-image-46483\" src=\"https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2020\/07\/https-ephesoft-com-docs-wp-content-uploads-2019-1-22.png\" alt=\"https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2019\/06\/word-image-338.png\" width=\"594\" height=\"502\" srcset=\"https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2020\/07\/https-ephesoft-com-docs-wp-content-uploads-2019-1-22.png 842w, https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2020\/07\/https-ephesoft-com-docs-wp-content-uploads-2019-1-22-300x253.png 300w, https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2020\/07\/https-ephesoft-com-docs-wp-content-uploads-2019-1-22-768x649.png 768w\" sizes=\"(max-width: 594px) 100vw, 594px\" \/><\/p>\n<p><em>Figure 16: Start Ephesoft Transact<\/em><\/p>\n<ol start=\"3\">\n<li>Open a web browser and enter the following Ephesoft Transact URL: <strong>http:\/\/&lt;servername&gt;:&lt;portnumber&gt;\/dcma\/home.html<\/strong>. The default port number is 8080. Allow time for the background configuration processes to complete. The initial startup may require several minutes.<\/li>\n<\/ol>\n<p><strong>Important<\/strong>: If you receive an error or connection warning, you will need to open the firewall ports to connect to Ephesoft Transact.<\/p>\n<ol start=\"4\">\n<li>The Ephesoft Transact 2020.1.04 home page displays. Select <strong>Administrator <\/strong>or <strong>Operator<\/strong> to log in.<\/li>\n<\/ol>\n<p><img decoding=\"async\" class=\"wp-image-46484\" src=\"https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2020\/07\/word-image-170.png\" width=\"578\" height=\"425\" srcset=\"https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2020\/07\/word-image-170.png 722w, https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2020\/07\/word-image-170-300x221.png 300w\" sizes=\"(max-width: 578px) 100vw, 578px\" \/><\/p>\n<p><em>Figure 17: Ephesoft Transact Home Screen<\/em><\/p>\n<ol start=\"5\">\n<li>Enter the username and password. The default username is <strong>ephesoft<\/strong>, and the default password is <strong>demo<\/strong>.<\/li>\n<\/ol>\n<p><em><img decoding=\"async\" class=\"wp-image-46485\" src=\"https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2020\/07\/word-image-171.png\" width=\"372\" height=\"268\" srcset=\"https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2020\/07\/word-image-171.png 437w, https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2020\/07\/word-image-171-300x216.png 300w\" sizes=\"(max-width: 372px) 100vw, 372px\" \/><\/em><\/p>\n<p><em>Figure 18: Login Screen<\/em><\/p>\n<p><strong>Note<\/strong>: The system may require additional time to complete the initial login.<\/p>\n<h2><a id=\"post-46332-_heading=h.1ksv4uv\"><\/a>Conclusion<\/h2>\n<p><a id=\"post-46332-_heading=h.44sinio\"><\/a> This completes the upgrade process.<\/p>\n","protected":false},"featured_media":0,"parent":48124,"menu_order":2,"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>Linux Upgrade Guide 2020.1.04 | 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=\"Linux Upgrade Guide 2020.1.04\" \/>\n<meta property=\"og:description\" content=\"Introduction This document describes how to upgrade Ephesoft Transact 2020.1.04 in the following environments: Environments \u2014 single or multi-server Operating [&hellip;]\" \/>\n<meta property=\"og:url\" content=\"https:\/\/ephesoft.com\/docs\/products\/transact\/install-and-upgrade\/transact-2020-1-04\/linux-upgrade-guide-2020-1-04\/\" \/>\n<meta property=\"og:site_name\" content=\"Ephesoft Docs\" \/>\n<meta property=\"og:image\" content=\"https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2020\/07\/word-image-156.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=\"11 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\/transact-2020-1-04\/linux-upgrade-guide-2020-1-04\/\",\"url\":\"https:\/\/ephesoft.com\/docs\/products\/transact\/install-and-upgrade\/transact-2020-1-04\/linux-upgrade-guide-2020-1-04\/\",\"name\":\"Linux Upgrade Guide 2020.1.04 | Ephesoft Docs\",\"isPartOf\":{\"@id\":\"https:\/\/ephesoft.com\/docs\/#website\"},\"datePublished\":\"2021-03-04T20:22:37+00:00\",\"dateModified\":\"2021-03-04T20:22:37+00:00\",\"breadcrumb\":{\"@id\":\"https:\/\/ephesoft.com\/docs\/products\/transact\/install-and-upgrade\/transact-2020-1-04\/linux-upgrade-guide-2020-1-04\/#breadcrumb\"},\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\/\/ephesoft.com\/docs\/products\/transact\/install-and-upgrade\/transact-2020-1-04\/linux-upgrade-guide-2020-1-04\/\"]}]},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\/\/ephesoft.com\/docs\/products\/transact\/install-and-upgrade\/transact-2020-1-04\/linux-upgrade-guide-2020-1-04\/#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 2020.1.04\",\"item\":\"https:\/\/ephesoft.com\/docs\/products\/transact\/install-and-upgrade\/transact-2020-1-04\/\"},{\"@type\":\"ListItem\",\"position\":5,\"name\":\"Linux Upgrade Guide 2020.1.04\"}]},{\"@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":"Linux Upgrade Guide 2020.1.04 | Ephesoft Docs","robots":{"index":"noindex","follow":"follow"},"og_locale":"en_US","og_type":"article","og_title":"Linux Upgrade Guide 2020.1.04","og_description":"Introduction This document describes how to upgrade Ephesoft Transact 2020.1.04 in the following environments: Environments \u2014 single or multi-server Operating [&hellip;]","og_url":"https:\/\/ephesoft.com\/docs\/products\/transact\/install-and-upgrade\/transact-2020-1-04\/linux-upgrade-guide-2020-1-04\/","og_site_name":"Ephesoft Docs","og_image":[{"url":"https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2020\/07\/word-image-156.png"}],"twitter_card":"summary_large_image","twitter_misc":{"Est. reading time":"11 minutes"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"WebPage","@id":"https:\/\/ephesoft.com\/docs\/products\/transact\/install-and-upgrade\/transact-2020-1-04\/linux-upgrade-guide-2020-1-04\/","url":"https:\/\/ephesoft.com\/docs\/products\/transact\/install-and-upgrade\/transact-2020-1-04\/linux-upgrade-guide-2020-1-04\/","name":"Linux Upgrade Guide 2020.1.04 | Ephesoft Docs","isPartOf":{"@id":"https:\/\/ephesoft.com\/docs\/#website"},"datePublished":"2021-03-04T20:22:37+00:00","dateModified":"2021-03-04T20:22:37+00:00","breadcrumb":{"@id":"https:\/\/ephesoft.com\/docs\/products\/transact\/install-and-upgrade\/transact-2020-1-04\/linux-upgrade-guide-2020-1-04\/#breadcrumb"},"inLanguage":"en-US","potentialAction":[{"@type":"ReadAction","target":["https:\/\/ephesoft.com\/docs\/products\/transact\/install-and-upgrade\/transact-2020-1-04\/linux-upgrade-guide-2020-1-04\/"]}]},{"@type":"BreadcrumbList","@id":"https:\/\/ephesoft.com\/docs\/products\/transact\/install-and-upgrade\/transact-2020-1-04\/linux-upgrade-guide-2020-1-04\/#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 2020.1.04","item":"https:\/\/ephesoft.com\/docs\/products\/transact\/install-and-upgrade\/transact-2020-1-04\/"},{"@type":"ListItem","position":5,"name":"Linux Upgrade Guide 2020.1.04"}]},{"@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\/48277"}],"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=48277"}],"version-history":[{"count":0,"href":"https:\/\/ephesoft.com\/docs\/wp-json\/wp\/v2\/docs\/48277\/revisions"}],"up":[{"embeddable":true,"href":"https:\/\/ephesoft.com\/docs\/wp-json\/wp\/v2\/docs\/48124"}],"next":[{"title":"Windows Installation Guide 2020.1.04","link":"https:\/\/ephesoft.com\/docs\/products\/transact\/install-and-upgrade\/transact-2020-1-04\/windows-installation-guide-2020-1-04\/","href":"https:\/\/ephesoft.com\/docs\/wp-json\/wp\/v2\/docs\/48220"}],"prev":[{"title":"Linux Installation Guide 2020.1.04","link":"https:\/\/ephesoft.com\/docs\/products\/transact\/install-and-upgrade\/transact-2020-1-04\/linux-installation-guide-2020-1-04\/","href":"https:\/\/ephesoft.com\/docs\/wp-json\/wp\/v2\/docs\/48273"}],"wp:attachment":[{"href":"https:\/\/ephesoft.com\/docs\/wp-json\/wp\/v2\/media?parent=48277"}],"wp:term":[{"taxonomy":"doc_tag","embeddable":true,"href":"https:\/\/ephesoft.com\/docs\/wp-json\/wp\/v2\/doc_tag?post=48277"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}