{"id":51680,"date":"2022-11-28T10:13:54","date_gmt":"2022-11-28T17:13:54","guid":{"rendered":"https:\/\/ephesoft.com\/docs\/?post_type=docs&#038;p=51680"},"modified":"2022-11-28T16:31:03","modified_gmt":"2022-11-28T23:31:03","slug":"linux-upgrade-guide-2022-1-01","status":"publish","type":"docs","link":"https:\/\/ephesoft.com\/docs\/products\/transact\/install-and-upgrade\/transact-2022-1-01\/linux-upgrade-guide-2022-1-01\/","title":{"rendered":"Linux Upgrade Guide 2022.1.01"},"content":{"rendered":"<h1><a id=\"post-51680-_heading=h.gjdgxs\"><\/a>Introduction<\/h1>\n<p><a id=\"post-51680-_heading=h.30j0zll\"><\/a> This document describes how to upgrade Ephesoft Transact 2022.1.01 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)\n<ul>\n<li>Refer to <a href=\"https:\/\/ephesoft.com\/docs\/products\/transact\/install-and-upgrade\/system-requirements\/platform-configurations-and-third-party-integrations\/\">Platform Configurations and Third-Party Integrations<\/a> for information on supported versions.<br \/>\n<strong>Note<\/strong>: Ephesoft Transact 2022.1.01 is only supported for these Linux distributions. The yum update will upgrade the system to the latest RHEL version in the same series. Ensure the latest version is in the supported Linux distributions list. 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.<\/li>\n<\/ul>\n<\/li>\n<\/ul>\n<ul>\n<li>Installation types \u2014 normal or silent<\/li>\n<\/ul>\n<h2><a id=\"post-51680-_heading=h.1fob9te\"><\/a>Upgrade Overview<\/h2>\n<p>The process of upgrading to Ephesoft Transact 2022.1.01 follows this general sequence of tasks. Before proceeding, review the <a href=\"https:\/\/ephesoft.com\/docs\/products\/transact\/release-notes\/2022-1-01\">2022.1.01 Release Notes<\/a>.<\/p>\n<table>\n<tbody>\n<tr style=\"color: #ffffff;background-color: #1f3864\">\n<td>Installation Task<\/td>\n<td>General Scope of Activity<\/td>\n<\/tr>\n<tr bgcolor=\"#d9e2f3\">\n<td><a href=\"#post-51680-_heading=h.3znysh7\">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=\"#post-51680-_heading=h.tyjcwt\">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=\"#post-51680-_heading=h.3dy6vkm\">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 silent upgrade, provide the required configurations in the <strong>config.properties<\/strong> file.<\/td>\n<\/tr>\n<tr>\n<td><a href=\"#post-51680-_heading=h.4d34og8\">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=\"#post-51680-_heading=h.17dp8vu\">License and Launch Ephesoft Transact 2022.1.01<\/a><\/td>\n<td>Perform these steps to complete the upgrade for Ephesoft Transact 2022.1.01.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<h1><a id=\"post-51680-_heading=h.3znysh7\"><\/a>Prerequisites<\/h1>\n<p>Perform these steps for a successful software upgrade and startup:<\/p>\n<ol>\n<li>Determine if you need to perform a single-server or multi-server upgrade.<br \/>\n<strong>Important:<\/strong> Steps unique to a multi-server environment upgrade are identified where applicable.<\/li>\n<li>Verify that the existing installation of Ephesoft Transact is supported for direct upgrade to Ephesoft Transact 2022.1.01.\n<ul>\n<li>If the system is currently running Ephesoft Transact version 2022.1.00, your system is supported for direct upgrade to Ephesoft Transact 2022.1.01.<br \/>\n<b>Note: <span style=\"font-weight: 400\">After the upgrade, reinstallation is recommended for the AI Table Rule Builder and Cloud OCR (Advanced HOCR) plugins<\/span><\/b><span style=\"font-weight: 400\">.<\/span><\/li>\n<li><span style=\"font-weight: 400\">If the system is currently running a release prior to Ephesoft Transact 2022.1.00, you will need to upgrade to version 2022.1.00 before upgrading to Ephesoft Transact 2022.1.01.<\/span><br \/>\n<strong>Important:<\/strong> If you are required to perform an intermediate upgrade, then you must successfully start Ephesoft Transact 2022.1.00 before upgrading to version 2022.1.01 or the upgrade process will fail.<\/li>\n<\/ul>\n<\/li>\n<li>Verify that your database version is supported. Refer to <a href=\"https:\/\/ephesoft.com\/docs\/install-and-upgrade\/2020-1\/platform-configuration-and-third-party-integrations-transact-2020-1\/\">Platform Configuration and Third-Party Integrations<\/a> for additional information.<br \/>\n<strong>Important<\/strong>: If you are upgrading to Ephesoft Transact 2022.1.01 with an existing version of MariaDB or MySQL database engine, refer to <a href=\"https:\/\/ephesoft.com\/docs\/install-and-upgrade\/2020-1\/install-and-migrate-to-mariadb-for-linux\/\">Install and Migrate to MariaDB for Linux<\/a> before proceeding any further with the upgrade.<\/li>\n<li>Verify that internet connectivity is available for this upgrade.\n<pre>nm-online<\/pre>\n<p><strong>Note<\/strong>: The installation will be interrupted if an internet connection is unavailable, as some software requires updates or installation from the operating system\u2019s repository.<\/li>\n<li>Verify that you have super-user (root) permissions. If you are not a super-user, execute the following command to gain super-user permissions.\n<pre>sudo su root<\/pre>\n<p><strong>Important<\/strong>: The installation script must be run with super-user permissions, or an error will occur, and the script will exit.<\/li>\n<li>Verify that SharedFolders is accessible on the server undergoing upgrade.<\/li>\n<\/ol>\n<h1><a id=\"post-51680-_heading=h.2et92p0\"><\/a>Installation Instructions<\/h1>\n<h2><a id=\"post-51680-_heading=h.tyjcwt\"><\/a>Prepare the Server for Upgrade<\/h2>\n<p>Perform these steps to prepare the server for an upgrade to Ephesoft Transact 2022.1.01:<\/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:\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<\/ol>\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 default, take note 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:\n<pre>\/etc\/.java\/.systemPrefs\/com\/Ephesoft\/license\/core\/annotation<\/pre>\n<\/li>\n<li>Ensure the following paths and settings are properly configured:\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 <code>1<\/code> for MariaDB Server(MySQL compatible).<\/li>\n<li>Select <code>2<\/code> for Oracle Database Server.<\/li>\n<\/ul>\n<p><strong>Important<\/strong>: If the upgrade to Ephesoft Transact 2022.1.01 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 Configurations and Third-Party Integrations<\/a> 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.<\/li>\n<\/ul>\n<\/li>\n<\/ol>\n<ol start=\"7\">\n<li>Stop Ephesoft Transact running as a service using the following command:\n<pre>service ephesoft stop.<\/pre>\n<p><img decoding=\"async\" width=\"466\" height=\"37\" class=\"wp-image-51681\" src=\"https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2022\/11\/word-image-51680-1.png\" srcset=\"https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2022\/11\/word-image-51680-1.png 466w, https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2022\/11\/word-image-51680-1-300x24.png 300w\" sizes=\"(max-width: 466px) 100vw, 466px\" \/><\/p>\n<p><em>Figure 1: Stop Ephesoft Transact Service<\/em><\/li>\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<h2><a id=\"post-51680-_heading=h.3dy6vkm\"><\/a>Download and Run the Ephesoft Transact Installer<\/h2>\n<p><a id=\"post-51680-_heading=h.1t3h5sf\"><\/a> Perform these steps to upgrade to Ephesoft Transact:<\/p>\n<ol>\n<li>Refer to the <a href=\"https:\/\/ephesoft.com\/docs\/download\/\">Downloads<\/a> page for information on how to obtain the Ephesoft Transact Installer.<\/li>\n<li>After saving the zip file, unzip the Ephesoft Transact installer by navigating to the folder containing the ZIP file and execute the following command:\n<pre>unzip Ephesoft_Transact_&lt;Version Number&gt;_Linux.zip<\/pre>\n<ul>\n<li>If unzip is not installed, use the sudo yum install unzip command.<br \/>\n<img decoding=\"async\" width=\"1089\" height=\"399\" class=\"wp-image-51682\" src=\"https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2022\/11\/word-image-51680-2.png\" srcset=\"https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2022\/11\/word-image-51680-2.png 1089w, https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2022\/11\/word-image-51680-2-300x110.png 300w, https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2022\/11\/word-image-51680-2-1024x375.png 1024w, https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2022\/11\/word-image-51680-2-768x281.png 768w\" sizes=\"(max-width: 1089px) 100vw, 1089px\" \/><br \/>\n<em>Figure 2: Execute the unzip command<\/em><\/li>\n<\/ul>\n<\/li>\n<li>Run the following command to make the files executable:\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=\"909\" height=\"60\" class=\"wp-image-51683\" src=\"https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2022\/11\/word-image-51680-3.png\" srcset=\"https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2022\/11\/word-image-51680-3.png 909w, https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2022\/11\/word-image-51680-3-300x20.png 300w, https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2022\/11\/word-image-51680-3-768x51.png 768w\" sizes=\"(max-width: 909px) 100vw, 909px\" \/><br \/>\n<em>Figure 3: Execute the cmod 777 Command<\/em><\/li>\n<li>Run the following command to start the installation process:\n<pre>.\/install<\/pre>\n<p><img decoding=\"async\" width=\"510\" height=\"30\" class=\"wp-image-51684\" src=\"https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2022\/11\/word-image-51680-4.png\" srcset=\"https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2022\/11\/word-image-51680-4.png 510w, https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2022\/11\/word-image-51680-4-300x18.png 300w\" sizes=\"(max-width: 510px) 100vw, 510px\" \/><br \/>\n<em>Figure 4: Execute the .\/install Command<\/em><br \/>\n<strong>Important<\/strong>: If the Ephesoft Transact installer stops fails 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>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<\/ol>\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 <code>n<\/code> and proceed to <strong>Normal Upgrade<\/strong>.<\/li>\n<li>If you are performing a silent upgrade, select <code>y<\/code> and proceed to <strong>Silent Upgrade<\/strong>.<\/li>\n<\/ul>\n<\/li>\n<\/ol>\n<p><img decoding=\"async\" width=\"1398\" height=\"788\" class=\"wp-image-51685\" src=\"https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2022\/11\/word-image-51680-5.png\" srcset=\"https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2022\/11\/word-image-51680-5.png 1398w, https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2022\/11\/word-image-51680-5-300x169.png 300w, https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2022\/11\/word-image-51680-5-1024x577.png 1024w, https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2022\/11\/word-image-51680-5-768x433.png 768w\" sizes=\"(max-width: 1398px) 100vw, 1398px\" \/><br \/>\n<em>Figure 5: Silent or Normal Installation<\/em><\/p>\n<h3><a id=\"post-51680-_heading=h.4d34og8\"><\/a>Normal Upgrade<\/h3>\n<ol>\n<li>The following screen will display while the installer checks the internet connection. Press <code>y<\/code> to confirm that you want to upgrade.<br \/>\n<img decoding=\"async\" width=\"1286\" height=\"232\" class=\"wp-image-51686\" src=\"https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2022\/11\/word-image-51680-6.png\" srcset=\"https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2022\/11\/word-image-51680-6.png 1286w, https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2022\/11\/word-image-51680-6-300x54.png 300w, https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2022\/11\/word-image-51680-6-1024x185.png 1024w, https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2022\/11\/word-image-51680-6-768x139.png 768w\" sizes=\"(max-width: 1286px) 100vw, 1286px\" \/><br \/>\n<em>Figure 6: Upgrade to Ephesoft Transact 2022.1.01<\/em><\/li>\n<li>You will be prompted to forcefully stop the Ephesoft Transact service if it is running. Press <code>y<\/code> to stop the Ephesoft Transact service on all nodes. The upgrade process cannot proceed if the Ephesoft Transact server is running.<strong>Important<\/strong>: The following steps vary depending on a single or multi-server installation. Carefully read the steps below before proceeding further.<\/li>\n<li>The following screen displays:<img decoding=\"async\" width=\"722\" height=\"83\" class=\"wp-image-51687\" src=\"https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2022\/11\/word-image-51680-7.png\" srcset=\"https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2022\/11\/word-image-51680-7.png 722w, https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2022\/11\/word-image-51680-7-300x34.png 300w\" sizes=\"(max-width: 722px) 100vw, 722px\" \/><br \/>\n<em>Figure 7: Database Patch<\/em><\/p>\n<ul>\n<li>For single-server upgrade, press <code>y<\/code> 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 <code>n<\/code> for subsequent server upgrades.<br \/>\n<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.<\/li>\n<\/ul>\n<\/li>\n<li>If Tesseract (an OCR engine) was not installed with the previous installation, the following screen will display:\n<ul>\n<li>Select <code>n<\/code> to decline installing Tesseract. Tesseract is optional, and not required for Ephesoft Transact to function properly.<br \/>\n<img decoding=\"async\" width=\"887\" height=\"154\" class=\"wp-image-51688\" src=\"https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2022\/11\/word-image-51680-8.png\" srcset=\"https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2022\/11\/word-image-51680-8.png 887w, https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2022\/11\/word-image-51680-8-300x52.png 300w, https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2022\/11\/word-image-51680-8-768x133.png 768w\" sizes=\"(max-width: 887px) 100vw, 887px\" \/><br \/>\n<em>Figure 8: Install Tesseract<\/em><\/li>\n<li>Select <code>y<\/code> to install Tesseract.<\/li>\n<\/ul>\n<\/li>\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.<br \/>\n<img decoding=\"async\" width=\"752\" height=\"443\" class=\"wp-image-51689\" src=\"https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2022\/11\/https-ephesoft-com-docs-wp-content-uploads-2019-1-1.png\" alt=\"https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2019\/06\/word-image-331.png\" srcset=\"https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2022\/11\/https-ephesoft-com-docs-wp-content-uploads-2019-1-1.png 752w, https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2022\/11\/https-ephesoft-com-docs-wp-content-uploads-2019-1-1-300x177.png 300w\" sizes=\"(max-width: 752px) 100vw, 752px\" \/><br \/>\n<em>Figure 9: Registration Information<br \/>\n<\/em><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.<br \/>\n<img decoding=\"async\" width=\"827\" height=\"392\" class=\"wp-image-51690\" src=\"https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2022\/11\/word-image-51680-10.png\" srcset=\"https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2022\/11\/word-image-51680-10.png 827w, https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2022\/11\/word-image-51680-10-300x142.png 300w, https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2022\/11\/word-image-51680-10-768x364.png 768w\" sizes=\"(max-width: 827px) 100vw, 827px\" \/><br \/>\n<em>Figure 10: Ephesoft Transact Upgrade Complete<\/em><\/li>\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<li>The upgrade is complete. Proceed to <a href=\"#post-51680-_heading=h.17dp8vu\">License and Launch Ephesoft Transact 2022.1.01<\/a>.<\/li>\n<\/ol>\n<h3><a id=\"post-51680-_heading=h.2s8eyo1\"><\/a>Silent Upgrade<\/h3>\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:\n<ul>\n<li style=\"list-style-type: none\">\n<ul>\n<li><code>vi config.properties<\/code><\/li>\n<li><code>vim config.properties<\/code><\/li>\n<li><code>nano config.properties<\/code><\/li>\n<\/ul>\n<\/li>\n<\/ul>\n<p><img decoding=\"async\" width=\"1032\" height=\"57\" class=\"wp-image-51691\" src=\"https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2022\/11\/word-image-51680-11.png\" srcset=\"https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2022\/11\/word-image-51680-11.png 1032w, https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2022\/11\/word-image-51680-11-300x17.png 300w, https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2022\/11\/word-image-51680-11-1024x57.png 1024w, https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2022\/11\/word-image-51680-11-768x42.png 768w\" sizes=\"(max-width: 1032px) 100vw, 1032px\" \/><br \/>\n<em>Figure 11: vi config.properties Command <\/em><br \/>\n<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.<\/li>\n<li>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 <code>i<\/code> command to enter <strong>insert mode<\/strong> and edit the content. See the table on configurable properties below for explanations of important parameters.<br \/>\n<img decoding=\"async\" width=\"1530\" height=\"740\" class=\"wp-image-51692\" src=\"https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2022\/11\/word-image-51680-12.png\" srcset=\"https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2022\/11\/word-image-51680-12.png 1530w, https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2022\/11\/word-image-51680-12-300x145.png 300w, https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2022\/11\/word-image-51680-12-1024x495.png 1024w, https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2022\/11\/word-image-51680-12-768x371.png 768w\" sizes=\"(max-width: 1530px) 100vw, 1530px\" \/><br \/>\n<em>Figure 12: Edit <\/em><strong><em>config.properties<\/em><\/strong><em> File<\/em><strong>Important<\/strong>: The upgrade may fail if any of the following settings in the <strong>config.properties<\/strong> file are incorrect.<\/p>\n<table>\n<tbody>\n<tr style=\"color: #ffffff;background-color: #1f3864\">\n<td>Configurable Property<\/td>\n<td>Description<\/td>\n<\/tr>\n<tr bgcolor=\"#d9e2f3\">\n<td><code>input_database_patch_enable<\/code><\/td>\n<td>Select one of the following options depending on your server environment:<\/p>\n<ol>\n<li>For single-server upgrade, press <code>y<\/code> 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 <code>n<\/code> for subsequent server upgrades.<\/li>\n<\/ol>\n<\/td>\n<\/tr>\n<tr>\n<td><code>input_upgrade_application<\/code><\/td>\n<td>Select <code>y<\/code> to upgrade Ephesoft Transact from an older version.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<\/li>\n<li>Save the updated <strong>config.properties<\/strong> file to the same name in the <strong>Response-Files<\/strong> folder. If using the 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:\n<pre>.\/install -silentinstall -product<\/pre>\n<p><img decoding=\"async\" width=\"914\" height=\"812\" class=\"wp-image-51693\" src=\"https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2022\/11\/word-image-51680-13.png\" srcset=\"https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2022\/11\/word-image-51680-13.png 914w, https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2022\/11\/word-image-51680-13-300x267.png 300w, https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2022\/11\/word-image-51680-13-768x682.png 768w\" sizes=\"(max-width: 914px) 100vw, 914px\" \/><\/p>\n<p><em>Figure 13: Start the Silent Installation<\/em><\/li>\n<li>The installer will pick up all required details from the <strong>config.properties<\/strong> files.<br \/>\n<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.<br \/>\n<img decoding=\"async\" width=\"848\" height=\"500\" class=\"wp-image-51694\" src=\"https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2022\/11\/word-image-51680-14.png\" srcset=\"https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2022\/11\/word-image-51680-14.png 848w, https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2022\/11\/word-image-51680-14-300x177.png 300w, https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2022\/11\/word-image-51680-14-768x453.png 768w\" sizes=\"(max-width: 848px) 100vw, 848px\" \/><br \/>\n<em>Figure 14: Back-up Directory<\/em><\/li>\n<li>All configuration 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 with the new <strong>log4j.xml<\/strong> at <strong>\/opt\/Ephesoft\/Application\/log4j.xml<\/strong>.<\/li>\n<li>The silent upgrade is complete. Proceed to <strong>License and Launch Ephesoft Transact 2022.1.01<\/strong>.<\/li>\n<\/ol>\n<h2><a id=\"post-51680-_heading=h.17dp8vu\"><\/a>License and Launch Ephesoft Transact 2022.1.01<\/h2>\n<p><a id=\"post-51680-_heading=h.3rdcrjn\"><\/a> To complete the upgrade, refer to <a href=\"https:\/\/ephesoft.com\/docs\/install-and-upgrade\/system-requirements\/licensing\/\">Licensing Requirements<\/a>.<\/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.<strong>Note<\/strong>: The upgrade installer creates a backup folder to store the pre-upgrade configuration settings and components.Use the diff 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<p>Refer to <a href=\"https:\/\/ephesoft.com\/docs\/what-are-the-folders-where-customer-specific-data-is-stored\/\">Ephesoft Folders with Customer-Specific Data<\/a> for additional information.<\/p>\n<p><img decoding=\"async\" width=\"1254\" height=\"809\" class=\"wp-image-51695\" src=\"https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2022\/11\/word-image-51680-15.png\" srcset=\"https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2022\/11\/word-image-51680-15.png 1254w, https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2022\/11\/word-image-51680-15-300x194.png 300w, https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2022\/11\/word-image-51680-15-1024x661.png 1024w, https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2022\/11\/word-image-51680-15-768x495.png 768w\" sizes=\"(max-width: 1254px) 100vw, 1254px\" \/><br \/>\n<em>Figure 15: diff Command to Compare Configurations<\/em><\/li>\n<li>Start the Ephesoft Transact service by running the following command:\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\" width=\"842\" height=\"711\" class=\"wp-image-51696\" src=\"https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2022\/11\/https-ephesoft-com-docs-wp-content-uploads-2019-1-2.png\" alt=\"https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2019\/06\/word-image-338.png\" srcset=\"https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2022\/11\/https-ephesoft-com-docs-wp-content-uploads-2019-1-2.png 842w, https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2022\/11\/https-ephesoft-com-docs-wp-content-uploads-2019-1-2-300x253.png 300w, https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2022\/11\/https-ephesoft-com-docs-wp-content-uploads-2019-1-2-768x649.png 768w\" sizes=\"(max-width: 842px) 100vw, 842px\" \/><br \/>\n<em>Figure 16: Start Ephesoft Transact<\/em><\/li>\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.<br \/>\n<strong>Important<\/strong>: If you receive an error or connection warning, you will need to open the firewall ports to connect to Ephesoft Transact.<\/li>\n<li>The Ephesoft Transact home page displays. Select <strong>Administrator <\/strong>or <strong>Operator<\/strong> to log in.<br \/>\n<img decoding=\"async\" width=\"1467\" height=\"912\" class=\"wp-image-51697\" src=\"https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2022\/11\/word-image-51680-17.png\" srcset=\"https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2022\/11\/word-image-51680-17.png 1467w, https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2022\/11\/word-image-51680-17-300x187.png 300w, https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2022\/11\/word-image-51680-17-1024x637.png 1024w, https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2022\/11\/word-image-51680-17-768x477.png 768w\" sizes=\"(max-width: 1467px) 100vw, 1467px\" \/><br \/>\n<em>Figure 17: Ephesoft Transact Home Screen<\/em><\/li>\n<li><a id=\"post-51680-_heading=h.26in1rg\"><\/a> Enter the username and password. The default username is <strong>ephesoft<\/strong>, and the default password is <strong>demo<\/strong>.<br \/>\n<img decoding=\"async\" width=\"657\" height=\"488\" class=\"wp-image-51698\" src=\"https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2022\/11\/word-image-51680-18.png\" srcset=\"https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2022\/11\/word-image-51680-18.png 657w, https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2022\/11\/word-image-51680-18-300x223.png 300w\" sizes=\"(max-width: 657px) 100vw, 657px\" \/><br \/>\n<em>Figure 18: Login Screen<\/em><br \/>\n<strong>Note<\/strong>: The system may require additional time to complete the initial login.<\/li>\n<\/ol>\n","protected":false},"featured_media":0,"parent":51935,"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>Linux Upgrade Guide 2022.1.01 | 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 2022.1.01\" \/>\n<meta property=\"og:description\" content=\"Introduction This document describes how to upgrade Ephesoft Transact 2022.1.01 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-2022-1-01\/linux-upgrade-guide-2022-1-01\/\" \/>\n<meta property=\"og:site_name\" content=\"Ephesoft Docs\" \/>\n<meta property=\"article:modified_time\" content=\"2022-11-28T23:31:03+00:00\" \/>\n<meta property=\"og:image\" content=\"https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2022\/11\/word-image-51680-1.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=\"13 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-2022-1-01\/linux-upgrade-guide-2022-1-01\/\",\"url\":\"https:\/\/ephesoft.com\/docs\/products\/transact\/install-and-upgrade\/transact-2022-1-01\/linux-upgrade-guide-2022-1-01\/\",\"name\":\"Linux Upgrade Guide 2022.1.01 | Ephesoft Docs\",\"isPartOf\":{\"@id\":\"https:\/\/ephesoft.com\/docs\/#website\"},\"datePublished\":\"2022-11-28T17:13:54+00:00\",\"dateModified\":\"2022-11-28T23:31:03+00:00\",\"breadcrumb\":{\"@id\":\"https:\/\/ephesoft.com\/docs\/products\/transact\/install-and-upgrade\/transact-2022-1-01\/linux-upgrade-guide-2022-1-01\/#breadcrumb\"},\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\/\/ephesoft.com\/docs\/products\/transact\/install-and-upgrade\/transact-2022-1-01\/linux-upgrade-guide-2022-1-01\/\"]}]},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\/\/ephesoft.com\/docs\/products\/transact\/install-and-upgrade\/transact-2022-1-01\/linux-upgrade-guide-2022-1-01\/#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 2022.1.01\",\"item\":\"https:\/\/ephesoft.com\/docs\/products\/transact\/install-and-upgrade\/transact-2022-1-01\/\"},{\"@type\":\"ListItem\",\"position\":5,\"name\":\"Linux Upgrade Guide 2022.1.01\"}]},{\"@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 2022.1.01 | Ephesoft Docs","robots":{"index":"noindex","follow":"follow"},"og_locale":"en_US","og_type":"article","og_title":"Linux Upgrade Guide 2022.1.01","og_description":"Introduction This document describes how to upgrade Ephesoft Transact 2022.1.01 in the following environments: Environments \u2014 single or multi-server Operating [&hellip;]","og_url":"https:\/\/ephesoft.com\/docs\/products\/transact\/install-and-upgrade\/transact-2022-1-01\/linux-upgrade-guide-2022-1-01\/","og_site_name":"Ephesoft Docs","article_modified_time":"2022-11-28T23:31:03+00:00","og_image":[{"url":"https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2022\/11\/word-image-51680-1.png"}],"twitter_card":"summary_large_image","twitter_misc":{"Est. reading time":"13 minutes"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"WebPage","@id":"https:\/\/ephesoft.com\/docs\/products\/transact\/install-and-upgrade\/transact-2022-1-01\/linux-upgrade-guide-2022-1-01\/","url":"https:\/\/ephesoft.com\/docs\/products\/transact\/install-and-upgrade\/transact-2022-1-01\/linux-upgrade-guide-2022-1-01\/","name":"Linux Upgrade Guide 2022.1.01 | Ephesoft Docs","isPartOf":{"@id":"https:\/\/ephesoft.com\/docs\/#website"},"datePublished":"2022-11-28T17:13:54+00:00","dateModified":"2022-11-28T23:31:03+00:00","breadcrumb":{"@id":"https:\/\/ephesoft.com\/docs\/products\/transact\/install-and-upgrade\/transact-2022-1-01\/linux-upgrade-guide-2022-1-01\/#breadcrumb"},"inLanguage":"en-US","potentialAction":[{"@type":"ReadAction","target":["https:\/\/ephesoft.com\/docs\/products\/transact\/install-and-upgrade\/transact-2022-1-01\/linux-upgrade-guide-2022-1-01\/"]}]},{"@type":"BreadcrumbList","@id":"https:\/\/ephesoft.com\/docs\/products\/transact\/install-and-upgrade\/transact-2022-1-01\/linux-upgrade-guide-2022-1-01\/#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 2022.1.01","item":"https:\/\/ephesoft.com\/docs\/products\/transact\/install-and-upgrade\/transact-2022-1-01\/"},{"@type":"ListItem","position":5,"name":"Linux Upgrade Guide 2022.1.01"}]},{"@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\/51680"}],"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=51680"}],"version-history":[{"count":18,"href":"https:\/\/ephesoft.com\/docs\/wp-json\/wp\/v2\/docs\/51680\/revisions"}],"predecessor-version":[{"id":52012,"href":"https:\/\/ephesoft.com\/docs\/wp-json\/wp\/v2\/docs\/51680\/revisions\/52012"}],"up":[{"embeddable":true,"href":"https:\/\/ephesoft.com\/docs\/wp-json\/wp\/v2\/docs\/51935"}],"wp:attachment":[{"href":"https:\/\/ephesoft.com\/docs\/wp-json\/wp\/v2\/media?parent=51680"}],"wp:term":[{"taxonomy":"doc_tag","embeddable":true,"href":"https:\/\/ephesoft.com\/docs\/wp-json\/wp\/v2\/doc_tag?post=51680"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}