{"id":46331,"date":"2020-07-24T08:45:00","date_gmt":"2020-07-24T15:45:00","guid":{"rendered":"https:\/\/ephesoft.com\/docs\/?post_type=docs&#038;p=46331"},"modified":"2020-08-03T10:25:40","modified_gmt":"2020-08-03T17:25:40","slug":"linux-installation-guide-2020-1-02","status":"publish","type":"docs","link":"https:\/\/ephesoft.com\/docs\/products\/transact\/install-and-upgrade\/transact-2020-1-02\/linux-installation-guide-2020-1-02\/","title":{"rendered":"Linux Installation Guide 2020.1.02"},"content":{"rendered":"<h2><a id=\"post-46331-_heading=h.gjdgxs\"><\/a>Introduction<\/h2>\n<p>This document describes how to install Ephesoft Transact 2020.1.02 in the following environments:<\/p>\n<ul>\n<li>Environment types \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.02 is only supported for these Linux distributions. Do not run the yum update 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-46331-_heading=h.30j0zll\"><\/a>Installation Overview<\/h3>\n<p>The\u00a0process of\u00a0installing\u00a0Ephesoft\u00a0Transact 2020.1.02\u00a0follows\u00a0this\u00a0general\u00a0sequence of tasks.<\/p>\n<table>\n<tbody>\n<tr>\n<td>Installation Task<\/td>\n<td>General Scope of Activity<\/td>\n<\/tr>\n<tr>\n<td><a href=\"#post-46331-_heading=h.1fob9te\">Prerequisites\u00a0<\/a><\/td>\n<td>Prepare for the installation by gathering installation resources and verifying that the environment is supported.<\/td>\n<\/tr>\n<tr>\n<td><a href=\"#post-46331-_heading=h.tyjcwt\">Download and Run the Ephesoft Transact Installer\u00a0<\/a><\/td>\n<td>Run the Ephesoft Transact installer in the command line interface.<\/td>\n<\/tr>\n<tr>\n<td><a href=\"#post-46331-_heading=h.3dy6vkm\">Select Normal or Silent Install<\/a><\/td>\n<td>Determine if you are performing a normal or silent installation and follow the steps for your selected option.<\/td>\n<\/tr>\n<tr>\n<td><a href=\"#post-46331-_heading=h.35nkun2\">License and Launch Ephesoft Transact 2020.1.02<\/a><\/td>\n<td>Perform these steps to complete the install for Ephesoft Transact 2020.1.02.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<h1><a id=\"post-46331-_heading=h.1fob9te\"><\/a>Prerequisites<\/h1>\n<p>Perform these steps to prepare for successful software installation and startup:<\/p>\n<ol>\n<li>Determine if you need to perform a single-server or multi-server installation.<\/li>\n<\/ol>\n<p><strong>Important: <\/strong>Installation steps unique to a multi-server installation are identified where applicable.<\/p>\n<ol start=\"2\">\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> and reference the 2020.1 table for additional information.<\/li>\n<li>The following database information is required when you run the installer:\n<ul>\n<li>Username and password<\/li>\n<li>Database connection parameters<\/li>\n<\/ul>\n<\/li>\n<\/ol>\n<p><strong>Important<\/strong>: The Ephesoft Transact 2020.1.02 installer does not install any database management systems (DBMS). You will need to install and configure any relevant DBMS prior to installing Ephesoft Transact 2020.1.02. If you\u2019re installing Ephesoft Transact for the first time using MariaDB, reference <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> for additional information.<\/p>\n<ol start=\"4\">\n<li>Verify that internet connectivity is available for this installation.<\/li>\n<\/ol>\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.<\/p>\n<ol start=\"5\">\n<li><a id=\"post-46331-_heading=h.3znysh7\"><\/a> If you are installing Ephesoft Transact with Microsoft Active Directory (MSAD), MSAD must already be installed and configured prior to installing Ephesoft Transact.<\/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.<\/li>\n<\/ol>\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.<\/p>\n<ol start=\"7\">\n<li>Refer to <a href=\"https:\/\/ephesoft.com\/docs\/how-to-manually-install-microsofts-truetype-core-fonts\/\">How to Manually Install Microsoft&#8217;s TrueType Core<\/a> Fonts and complete the steps for your Linux distribution.<\/li>\n<\/ol>\n<p><strong>Important<\/strong>: Ephesoft Transact requires Microsoft&#8217;s TrueType Core (msttcore) fonts to be installed when converting PDF to TIFF files. The msttcore fonts must be installed on the same processing server(s) as Ephesoft Transact.<\/p>\n<h1><a id=\"post-46331-_heading=h.2et92p0\"><\/a>User Instructions<\/h1>\n<h2><a id=\"post-46331-_heading=h.tyjcwt\"><\/a>Download and Run the Ephesoft Transact Installer<\/h2>\n<p>Perform these steps to run the Ephesoft Transact 2020.1.02 installer.<\/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.02_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-46336\" src=\"https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2020\/07\/word-image-70.png\" srcset=\"https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2020\/07\/word-image-70.png 638w, https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2020\/07\/word-image-70-300x137.png 300w\" sizes=\"(max-width: 638px) 100vw, 638px\" \/><\/p>\n<p><em>Figure 1. Execute the <\/em>unzip<em> 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 2, below.<\/p>\n<p><img decoding=\"async\" width=\"758\" height=\"38\" class=\"wp-image-46337\" src=\"https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2020\/07\/word-image-71.png\" srcset=\"https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2020\/07\/word-image-71.png 758w, https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2020\/07\/word-image-71-300x15.png 300w\" sizes=\"(max-width: 758px) 100vw, 758px\" \/><\/p>\n<p><em>Figure 2. Execute the <\/em>cmod 777<em> 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-46338\" src=\"https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2020\/07\/word-image-72.png\" srcset=\"https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2020\/07\/word-image-72.png 335w, https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2020\/07\/word-image-72-300x21.png 300w\" sizes=\"(max-width: 335px) 100vw, 335px\" \/><\/p>\n<p><em>Figure 3. Execute the .\/install Command<\/em><\/p>\n<p><strong>Important<\/strong>: If the Ephesoft Transact installer stops or 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<ol>\n<li style=\"list-style-type: none\">\n<ol type=\"a\">\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><\/li>\n<\/ol>\n<\/li>\n<\/ol>\n<ul>\n<li style=\"list-style-type: none\">\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<ol>\n<li style=\"list-style-type: none\">\n<ol start=\"4\" type=\"a\">\n<li>You will be prompted to decide if you want to install Ephesoft Transact as a silent installer (figure 4).<\/li>\n<\/ol>\n<\/li>\n<\/ol>\n<ul>\n<li style=\"list-style-type: none\">\n<ul>\n<li>If you are performing a normal install, select n and proceed to <a href=\"#post-46331-_heading=h.3dy6vkm\">Normal Install<\/a>.<\/li>\n<li>If you are performing a silent install, select y and proceed to <a href=\"#post-46331-_heading=h.17dp8vu\">Silent Install<\/a>.<\/li>\n<\/ul>\n<\/li>\n<\/ul>\n<p><img decoding=\"async\" width=\"886\" height=\"440\" class=\"wp-image-46339\" src=\"https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2020\/07\/word-image-73.png\" srcset=\"https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2020\/07\/word-image-73.png 886w, https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2020\/07\/word-image-73-300x149.png 300w, https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2020\/07\/word-image-73-768x381.png 768w\" sizes=\"(max-width: 886px) 100vw, 886px\" \/><\/p>\n<p><em>Figure 4. Execute the <\/em>.\/install<em> command<\/em><\/p>\n<h3><a id=\"post-46331-_heading=h.3dy6vkm\"><\/a>Normal Install<\/h3>\n<ol>\n<li>The installer will check the internet connection.<\/li>\n<li>After the installer runs a check on the Linux operating system, you will be prompted to change the detected operating system. In most cases, users select the operating system detected by the installer. Select n to keep the detected operating system.<\/li>\n<\/ol>\n<p><img decoding=\"async\" width=\"747\" height=\"144\" class=\"wp-image-46340\" src=\"https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2020\/07\/https-ephesoft-com-docs-wp-content-uploads-2019-.png\" alt=\"https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2019\/06\/word-image-316.png\" srcset=\"https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2020\/07\/https-ephesoft-com-docs-wp-content-uploads-2019-.png 747w, https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2020\/07\/https-ephesoft-com-docs-wp-content-uploads-2019--300x58.png 300w\" sizes=\"(max-width: 747px) 100vw, 747px\" \/><\/p>\n<p><em>Figure 5. Installer Detects Operating System<\/em><\/p>\n<ol start=\"3\">\n<li>While you must be the root user to install Ephesoft Transact, you do not have to be the root user to run the application. You will be prompted to decide whether to run Ephesoft Transact as either root or non-root user with one of the following:<\/li>\n<\/ol>\n<ul>\n<li style=\"list-style-type: none\">\n<ul>\n<li>\u201cDo you want to run Ephesoft Application as a non-root user?\u201d<\/li>\n<li>\u201cEphesoft Application will run as root. Do you want to change it?\u201d<\/li>\n<li>\u201cEphesoft Application will run as &lt;current user&gt;. Do you want to change it?\u201d<\/li>\n<\/ul>\n<\/li>\n<\/ul>\n<ol start=\"4\">\n<li>Select n for any option to proceed as a root user.<\/li>\n<li>Select y to change the user and provide the required information, as prompted by the installer.<\/li>\n<\/ol>\n<p><img decoding=\"async\" width=\"719\" height=\"282\" class=\"wp-image-46341\" src=\"https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2020\/07\/https-ephesoft-com-docs-wp-content-uploads-2019-1-1.png\" alt=\"https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2019\/06\/word-image-318.png\" srcset=\"https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2020\/07\/https-ephesoft-com-docs-wp-content-uploads-2019-1-1.png 719w, https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2020\/07\/https-ephesoft-com-docs-wp-content-uploads-2019-1-1-300x118.png 300w\" sizes=\"(max-width: 719px) 100vw, 719px\" \/><\/p>\n<p><em>Figure 6. Change to non-root user<\/em><\/p>\n<p>The following list further describes the configurable properties:<\/p>\n<ul>\n<li style=\"list-style-type: none\">\n<ul>\n<li><strong>New username<\/strong>: username for a new user to run the application<\/li>\n<li><strong>Password<\/strong>: valid password for a new user to run the application<\/li>\n<li><strong>Primary group<\/strong>: primary user group for a new user, which will give them required permissions (read, write, and execute). If the group doesn\u2019t exist, it will be created with the provided name.<\/li>\n<\/ul>\n<\/li>\n<\/ul>\n<ol start=\"6\">\n<li>Input the path for the target installation directory. The default option is <strong>\/opt<\/strong>. We recommend keeping the default directory, but you can change the directory by editing the text line if needed.<\/li>\n<\/ol>\n<p><img decoding=\"async\" width=\"760\" height=\"92\" class=\"wp-image-46342\" src=\"https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2020\/07\/https-ephesoft-com-docs-wp-content-uploads-2019-1-2.png\" alt=\"https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2019\/06\/word-image-319.png\" srcset=\"https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2020\/07\/https-ephesoft-com-docs-wp-content-uploads-2019-1-2.png 760w, https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2020\/07\/https-ephesoft-com-docs-wp-content-uploads-2019-1-2-300x36.png 300w\" sizes=\"(max-width: 760px) 100vw, 760px\" \/><\/p>\n<p><em>Figure 7. Installation path<\/em><\/p>\n<ol start=\"7\">\n<li>Press the <strong>Enter<\/strong> key to confirm the listed path. The installer will extract the Ephesoft tar file and copy the Ephesoft folder to the installation directory. This may take some time.<\/li>\n<\/ol>\n<p><strong>Important<\/strong>: Never install Ephesoft Transact in the <strong>\/home<\/strong> directory for a user, or in the <strong>\/root<\/strong>,<strong> \/bin<\/strong>,<strong> \/etc<\/strong>,<strong> \/sbin<\/strong>, <strong>\/usr<\/strong>, or<strong> \/boot <\/strong>directories.<\/p>\n<h4><a id=\"post-46331-_heading=h.nxbzfciqhbhg\"><\/a>Create SharedFolders<\/h4>\n<ol start=\"8\">\n<li>You will be prompted to determine whether you want to use an existing instance of SharedFolders. If you are installing on a single-server environment, or if you are installing the first server in a multi-server environment, you will need to install SharedFolders for Ephesoft Transact to function properly.<\/li>\n<\/ol>\n<p><strong>Important<\/strong>: For Ephesoft Transact to function properly, SharedFolders must be accessible on the local server. If you are installing the SharedFolders directory on a remote server (network path)\/NAS\/SAN, advise your system administrator to mount the share locally to your server and use the path they provide during the installation.<\/p>\n<ul>\n<li style=\"list-style-type: none\">\n<ol type=\"a\">\n<li>Press n if you are installing on a single-server environment, or if you are installing the first server in a multi-server environment.<\/li>\n<\/ol>\n<\/li>\n<\/ul>\n<p><img decoding=\"async\" width=\"825\" height=\"62\" class=\"wp-image-46343\" src=\"https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2020\/07\/https-ephesoft-com-docs-wp-content-uploads-2019-1-3.png\" alt=\"https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2019\/06\/word-image-320.png\" srcset=\"https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2020\/07\/https-ephesoft-com-docs-wp-content-uploads-2019-1-3.png 825w, https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2020\/07\/https-ephesoft-com-docs-wp-content-uploads-2019-1-3-300x23.png 300w, https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2020\/07\/https-ephesoft-com-docs-wp-content-uploads-2019-1-3-768x58.png 768w\" sizes=\"(max-width: 825px) 100vw, 825px\" \/><\/p>\n<p><em>Figure 8. Install SharedFolders<\/em><\/p>\n<ul>\n<li style=\"list-style-type: none\">\n<ol start=\"2\" type=\"a\">\n<li>Press y if you are installing the second or subsequent server in a multi-server environment.<\/li>\n<\/ol>\n<\/li>\n<\/ul>\n<ol start=\"9\">\n<li>You will be prompted to specify where to install SharedFolders. The recommended option is the default <strong>\/opt\/Ephesoft<\/strong>.\n<ol type=\"a\">\n<li>Select n to keep the default <strong>\/opt\/Ephesoft<\/strong> option.<\/li>\n<li>Select y to designate a different folder and provide the chosen location. For single server installation, enter a local server directory path. For a multi-server installation, enter the path of a shared location.<\/li>\n<\/ol>\n<\/li>\n<\/ol>\n<p><img decoding=\"async\" width=\"819\" height=\"143\" class=\"wp-image-46344\" src=\"https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2020\/07\/https-ephesoft-com-docs-wp-content-uploads-2019-1-4.png\" alt=\"https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2019\/06\/word-image-321.png\" srcset=\"https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2020\/07\/https-ephesoft-com-docs-wp-content-uploads-2019-1-4.png 819w, https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2020\/07\/https-ephesoft-com-docs-wp-content-uploads-2019-1-4-300x52.png 300w, https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2020\/07\/https-ephesoft-com-docs-wp-content-uploads-2019-1-4-768x134.png 768w\" sizes=\"(max-width: 819px) 100vw, 819px\" \/><\/p>\n<p><em>Figure 9. Change SharedFolders Path<\/em><\/p>\n<ol start=\"10\">\n<li>Press the <strong>Enter<\/strong> key to confirm the chosen folder.<\/li>\n<li>Confirm the server name that will be saved in the <strong>Properties<\/strong> files. The default server name is the OS hostname, which is automatically identified by the installer.<\/li>\n<\/ol>\n<p><strong>Note<\/strong>: If you want to confirm your hostname, run the following command:<\/p>\n<pre>hostname<\/pre>\n<p>This will display the current hostname of your Linux system.<\/p>\n<ul>\n<li style=\"list-style-type: none\">\n<ol type=\"a\">\n<li>Select <strong>y<\/strong> to change the default server name.<\/li>\n<\/ol>\n<\/li>\n<\/ul>\n<p><strong>Important<\/strong>: If you change the server name it must be to a fully qualified domain name (FQDN) that your Ephesoft Transact users will have access to. This allows browsers to resolve images correctly. For example, if your Linux hostname is <strong>server01 <\/strong>but you want users to access Ephesoft Transact via <a href=\"http:\/\/transact.ephesoft.com\">http:\/\/transact.ephesoft.com<\/a>, change the server name to <strong>transact.ephesoft.com. <\/strong><\/p>\n<ul>\n<li style=\"list-style-type: none\">\n<ol start=\"2\" type=\"a\">\n<li>Select <strong>n<\/strong> to keep the default server name.<\/li>\n<\/ol>\n<\/li>\n<\/ul>\n<p><img decoding=\"async\" width=\"826\" height=\"368\" class=\"wp-image-46345\" src=\"https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2020\/07\/https-ephesoft-com-docs-wp-content-uploads-2019-1-5.png\" alt=\"https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2019\/06\/word-image-322.png\" srcset=\"https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2020\/07\/https-ephesoft-com-docs-wp-content-uploads-2019-1-5.png 826w, https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2020\/07\/https-ephesoft-com-docs-wp-content-uploads-2019-1-5-300x134.png 300w, https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2020\/07\/https-ephesoft-com-docs-wp-content-uploads-2019-1-5-768x342.png 768w\" sizes=\"(max-width: 826px) 100vw, 826px\" \/><\/p>\n<p><em>Figure 10. Default Hostname Selected<\/em><\/p>\n<h4><a id=\"post-46331-_heading=h.egeab4j2tfxd\"><\/a>Select and Set Up the Database<\/h4>\n<p>You will be prompted to select the database type you want to use. This section will explain the available options for MariaDB and Oracle.<\/p>\n<p>The following screen displays:<\/p>\n<p><img decoding=\"async\" width=\"463\" height=\"297\" class=\"wp-image-46346\" src=\"https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2020\/07\/word-image-74.png\" srcset=\"https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2020\/07\/word-image-74.png 463w, https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2020\/07\/word-image-74-300x192.png 300w\" sizes=\"(max-width: 463px) 100vw, 463px\" \/><\/p>\n<p><em>Figure 11. Select Database Type<\/em><\/p>\n<h5><a id=\"post-46331-_heading=h.ex6np5pamms3\"><\/a>MariaDB Configuration<\/h5>\n<p><strong>Note<\/strong>: The installer does not install MariaDB as part of the installation process. You will need to configure the database for MariaDB prior to running the Ephesoft Transact installer. The installer allows you to connect to an existing MariaDB server during the installation of Ephesoft Transact. For the latest information about MariaDB version support and MariaDB installation, refer to these documents:<\/p>\n<ul>\n<li><a href=\"https:\/\/ephesoft.com\/docs\/install-and-upgrade\/2020-1\/install-and-migrate-to-mariadb-for-linux\/\">Install and Migrate MariaDB for Linux<\/a><\/li>\n<li><a href=\"https:\/\/ephesoft.com\/docs\/install-and-upgrade\/2020-1\/platform-configuration-and-third-party-integrations-transact-2020-1\/\">2020.1.02 Platform Configurations and Third-Party Integrations<\/a><\/li>\n<\/ul>\n<p>Follow these steps when setting up an existing MariaDB database during the installation of Ephesoft Transact.<\/p>\n<ol>\n<li>Select MariaDB by typing 1 and pressing the <strong>Enter <\/strong>key.<\/li>\n<\/ol>\n<p><img decoding=\"async\" width=\"463\" height=\"297\" class=\"wp-image-46347\" src=\"https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2020\/07\/word-image-75.png\" srcset=\"https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2020\/07\/word-image-75.png 463w, https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2020\/07\/word-image-75-300x192.png 300w\" sizes=\"(max-width: 463px) 100vw, 463px\" \/><\/p>\n<p><em>Figure 12. Provide MariaDB Details<\/em><\/p>\n<ol start=\"2\">\n<li>Provide the required details, as explained in the table below.<\/li>\n<\/ol>\n<table>\n<tbody>\n<tr>\n<td>Maria DB property<\/td>\n<td>Description<\/td>\n<\/tr>\n<tr>\n<td>system IP<\/td>\n<td>The hostname\/IP address on which MariaDB is installed.<\/td>\n<\/tr>\n<tr>\n<td>database username<\/td>\n<td>Enter root.<\/p>\n<p>This is the username for the administrator of the three Ephesoft databases (ephesoft, report, and report_archive).<\/td>\n<\/tr>\n<tr>\n<td>Admin password<\/td>\n<td>This is the password you created when installing MariaDB. This password will be used to log in as a database administrator.<\/td>\n<\/tr>\n<tr>\n<td>application database name<\/td>\n<td>Default database name is ephesoft. This name can be changed as needed.<\/p>\n<p><strong>Important: <\/strong>Do not include special characters besides underscore \u201c_\u201d.<\/td>\n<\/tr>\n<tr>\n<td>report database name<\/td>\n<td>Default report database name is report. This name can be changed as needed.<\/td>\n<\/tr>\n<tr>\n<td>report archive database name<\/td>\n<td>Default report archive database name is report_archive. This name can be changed as needed.<\/td>\n<\/tr>\n<tr>\n<td>database port number<\/td>\n<td>Default port number is 3306. This is the port that will be used to access the database.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<p><strong>Note<\/strong>: In the table above, the configurable properties are listed exactly how they display on the screen.<\/p>\n<ol start=\"3\">\n<li>Press y to change any details. Otherwise, press n to continue.<\/li>\n<\/ol>\n<p><img decoding=\"async\" width=\"463\" height=\"297\" class=\"wp-image-46348\" src=\"https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2020\/07\/word-image-76.png\" srcset=\"https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2020\/07\/word-image-76.png 463w, https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2020\/07\/word-image-76-300x192.png 300w\" sizes=\"(max-width: 463px) 100vw, 463px\" \/><\/p>\n<p><em>Figure 13. Change Details or Continue<\/em><\/p>\n<ol start=\"4\">\n<li>You have successfully configured MariaDB. Proceed to Run or Decline the Database Patch.<\/li>\n<\/ol>\n<h5><a id=\"post-46331-_heading=h.4gwhzi3py22y\"><\/a>Oracle Database Configuration<\/h5>\n<ol>\n<li>Select Oracle by typing 2 and pressing the <strong>Enter <\/strong>key.\n<ul>\n<li>Press y to create a new database schema. You will be prompted to configure several properties for the database. See the table below for details on configurable properties.<\/li>\n<\/ul>\n<\/li>\n<\/ol>\n<p><img decoding=\"async\" class=\"wp-image-46349\" src=\"https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2020\/07\/https-ephesoft-com-docs-wp-content-uploads-2019-1-6.png\" alt=\"https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2019\/06\/word-image-324.png\" width=\"564\" height=\"589\" srcset=\"https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2020\/07\/https-ephesoft-com-docs-wp-content-uploads-2019-1-6.png 897w, https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2020\/07\/https-ephesoft-com-docs-wp-content-uploads-2019-1-6-287x300.png 287w, https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2020\/07\/https-ephesoft-com-docs-wp-content-uploads-2019-1-6-768x802.png 768w\" sizes=\"(max-width: 564px) 100vw, 564px\" \/><\/p>\n<p><em>Figure 14. Select Oracle DB<\/em><\/p>\n<ul>\n<li style=\"list-style-type: none\">\n<ul>\n<li>Press n to use an existing database. Provide the required details, as explained in the table below.<\/li>\n<\/ul>\n<\/li>\n<\/ul>\n<table>\n<tbody>\n<tr>\n<td>Oracle schema property<\/td>\n<td>Description<\/td>\n<\/tr>\n<tr>\n<td>oracle hostname\/IP<\/td>\n<td>Hostname\/IP for accessing the Oracle database.<\/td>\n<\/tr>\n<tr>\n<td>User Name<\/td>\n<td>Username for the user of the Oracle database.<\/td>\n<\/tr>\n<tr>\n<td>Password<\/td>\n<td>The password that will be used to access the Oracle database.<\/td>\n<\/tr>\n<tr>\n<td>Port<\/td>\n<td>The port that will be used to access the Oracle database.<\/td>\n<\/tr>\n<tr>\n<td>connection mode<\/td>\n<td>Oracle SID: Oracle system identification used to uniquely identify the database on a system.<\/p>\n<p>Service Name: TNS alias used to remotely connect to the database.<\/td>\n<\/tr>\n<tr>\n<td>Application DB Schema<\/td>\n<td>Default application schema is ephesoft. This name can be changed as needed.<\/p>\n<p><strong>Important: <\/strong>Do not include special characters besides underscore \u201c_\u201d.<\/td>\n<\/tr>\n<tr>\n<td>Application DB Schema Password<\/td>\n<td>Password that will be used to access the Application database<\/td>\n<\/tr>\n<tr>\n<td>Report DB Schema<\/td>\n<td>Default report schema is report. This name can be changed as needed.<\/td>\n<\/tr>\n<tr>\n<td>Report DB Schema Password<\/td>\n<td>Password that will be used to access the Report database<\/td>\n<\/tr>\n<tr>\n<td>Report Archive DB Schema<\/td>\n<td>Default report archive schema is report_archive. This name can be changed as needed.<\/td>\n<\/tr>\n<tr>\n<td>Report Archive DB Schema Password<\/td>\n<td>Password that will be used to access the Report Archive database.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<p><strong>Note<\/strong>: In the table above, the configurable properties are listed exactly how they display on the screen.<\/p>\n<ol start=\"2\">\n<li>Press y to change any details. Otherwise, press n to continue.<\/li>\n<\/ol>\n<p><img decoding=\"async\" class=\"wp-image-46350\" src=\"https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2020\/07\/https-ephesoft-com-docs-wp-content-uploads-2019-1-7.png\" alt=\"https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2019\/06\/word-image-324.png\" width=\"643\" height=\"672\" srcset=\"https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2020\/07\/https-ephesoft-com-docs-wp-content-uploads-2019-1-7.png 897w, https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2020\/07\/https-ephesoft-com-docs-wp-content-uploads-2019-1-7-287x300.png 287w, https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2020\/07\/https-ephesoft-com-docs-wp-content-uploads-2019-1-7-768x802.png 768w\" sizes=\"(max-width: 643px) 100vw, 643px\" \/><\/p>\n<p><em>Figure 15. Finalizing Oracle DB Details<\/em><\/p>\n<ol start=\"3\">\n<li>You have successfully configured the Oracle Database. Proceed to <strong>Run or Decline the Database Patch<\/strong>.<\/li>\n<\/ol>\n<h4><a id=\"post-46331-_heading=h.1t3h5sf\"><\/a>Run or Decline the Database Patch<\/h4>\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<ul>\n<li>For single-server installation, press y to run the database patch. The database patch is mandatory for a single-server installation, or if you are installing the first server in a multi-server installation.<\/li>\n<li>For a multi-server installation, the database patch is only required for the first server in the installation. Press n for subsequent server installations.<\/li>\n<\/ul>\n<p><strong>Important<\/strong>: If you run the database patch on the second or subsequent servers in a multi-server installation, you may corrupt the existing database.<\/p>\n<p><img decoding=\"async\" class=\"wp-image-46351\" src=\"https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2020\/07\/https-ephesoft-com-docs-wp-content-uploads-2019-1-8.png\" alt=\"https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2019\/06\/word-image-324.png\" width=\"649\" height=\"678\" srcset=\"https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2020\/07\/https-ephesoft-com-docs-wp-content-uploads-2019-1-8.png 897w, https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2020\/07\/https-ephesoft-com-docs-wp-content-uploads-2019-1-8-287x300.png 287w, https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2020\/07\/https-ephesoft-com-docs-wp-content-uploads-2019-1-8-768x802.png 768w\" sizes=\"(max-width: 649px) 100vw, 649px\" \/><\/p>\n<p><em>Figure 16. Database Patch Execution<\/em><\/p>\n<h4><a id=\"post-46331-_heading=h.4d34og8\"><\/a>Configure Authentication Mode<\/h4>\n<p>The following text displays:<\/p>\n<p><img decoding=\"async\" width=\"709\" height=\"94\" class=\"wp-image-46352\" src=\"https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2020\/07\/https-ephesoft-com-docs-wp-content-uploads-2019-1-9.png\" alt=\"https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2019\/06\/word-image-325.png\" srcset=\"https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2020\/07\/https-ephesoft-com-docs-wp-content-uploads-2019-1-9.png 709w, https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2020\/07\/https-ephesoft-com-docs-wp-content-uploads-2019-1-9-300x40.png 300w\" sizes=\"(max-width: 709px) 100vw, 709px\" \/><\/p>\n<p><em>Figure 17. Authentication Configuration<\/em><\/p>\n<ul>\n<li>Press 1 for Standard Form Authentication. This is the default option.<\/li>\n<li>Press 2 for PKI Authentication, and follow the steps listed in <a href=\"https:\/\/ephesoft.com\/docs\/2019-1\/installing-upgrading\/install-upgrade-single-server\/installing-on-windows\/additional-resources\/installer-pki-auth\/#post-13844-normal_linux\">Configure PKI Authentication on Linux<\/a>.<\/li>\n<\/ul>\n<p>The following text displays:<\/p>\n<p><img decoding=\"async\" width=\"708\" height=\"79\" class=\"wp-image-46353\" src=\"https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2020\/07\/https-ephesoft-com-docs-wp-content-uploads-2019-1-10.png\" alt=\"https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2019\/06\/word-image-326.png\" srcset=\"https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2020\/07\/https-ephesoft-com-docs-wp-content-uploads-2019-1-10.png 708w, https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2020\/07\/https-ephesoft-com-docs-wp-content-uploads-2019-1-10-300x33.png 300w\" sizes=\"(max-width: 708px) 100vw, 708px\" \/><\/p>\n<p><em>Figure 18. Application Protocol Options<\/em><\/p>\n<ul>\n<li>Press 1 for HTTP<\/li>\n<li>Press 2 for HTTPS, and follow the steps listed in <a href=\"https:\/\/ephesoft.com\/docs\/2019-1\/installing-upgrading\/install-upgrade-single-server\/installing-on-windows\/additional-resources\/form-auth-https-installer\/#post-14514-Linux_HTTPS\">Form Authentication with HTTPS on Linux<\/a>.<\/li>\n<\/ul>\n<p>The following text displays:<\/p>\n<p><img decoding=\"async\" width=\"761\" height=\"81\" class=\"wp-image-46354\" src=\"https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2020\/07\/https-ephesoft-com-docs-wp-content-uploads-2019-1-11.png\" alt=\"https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2019\/06\/word-image-327.png\" srcset=\"https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2020\/07\/https-ephesoft-com-docs-wp-content-uploads-2019-1-11.png 761w, https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2020\/07\/https-ephesoft-com-docs-wp-content-uploads-2019-1-11-300x32.png 300w\" sizes=\"(max-width: 761px) 100vw, 761px\" \/><\/p>\n<p><em>Figure 19. Apache Tomcat Server Port Number<\/em><\/p>\n<ol>\n<li>The default port number will display (8080 for HTTP).<\/li>\n<li>You will be prompted to change any details. Press y if any changes are needed. Otherwise, press n to continue.<\/li>\n<\/ol>\n<p><strong>Note: <\/strong>If you press y, you will need to re-input all the information in <a href=\"#post-46331-_heading=h.4d34og8\">Configure Authentication Mode<\/a>.<\/p>\n<h4><a id=\"post-46331-_heading=h.44znbo1thx1s\"><\/a>Configure User Connectivity Settings<\/h4>\n<p>The following text displays:<\/p>\n<p><img decoding=\"async\" class=\"wp-image-46355\" src=\"https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2020\/07\/https-ephesoft-com-docs-wp-content-uploads-2019-1-12.png\" alt=\"https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2019\/06\/word-image-328.png\" width=\"581\" height=\"533\" srcset=\"https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2020\/07\/https-ephesoft-com-docs-wp-content-uploads-2019-1-12.png 630w, https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2020\/07\/https-ephesoft-com-docs-wp-content-uploads-2019-1-12-300x275.png 300w\" sizes=\"(max-width: 581px) 100vw, 581px\" \/><\/p>\n<p><em>Figure 20. User Connectivity Settings<\/em><\/p>\n<p>The available user connection types are as follows:<\/p>\n<ul>\n<li><strong>LDAP<\/strong> (included with the Ephesoft Transact installer)<\/li>\n<li><strong>Microsoft<\/strong> <strong>Active<\/strong> <strong>Directory<\/strong> (MSAD)<\/li>\n<li><strong>Apache Tomcat<\/strong> (included with the Ephesoft Transact installer)<\/li>\n<\/ul>\n<p><strong>Note<\/strong>: Apache Tomcat is the simplest user connection type to set up, as it does not require any configuration. However, any changes to users (each time the user file is changed) will require a restart of Ephesoft Transact.<\/p>\n<h5><a id=\"post-46331-_heading=h.3vf0u0bxnxza\"><\/a>LDAP<\/h5>\n<ol>\n<li>Select <strong>LDAP<\/strong> by typing 1 and pressing the <strong>Enter<\/strong> key.<\/li>\n<li>Provide the required details, as described in the table below.<\/li>\n<\/ol>\n<table>\n<tbody>\n<tr>\n<td>LDAP property<\/td>\n<td>Description<\/td>\n<\/tr>\n<tr>\n<td>Connection URL<\/td>\n<td>A valid URL to connect to an LDAP server. The connection URL should be in the following format:<\/p>\n<p>ldap:\/\/&lt;server_address&gt;:&lt;port_number&gt;.<\/td>\n<\/tr>\n<tr>\n<td>Connection Name<\/td>\n<td>A valid username to connect and access the LDAP server. This is the username of the user responsible for interacting with the server.<\/td>\n<\/tr>\n<tr>\n<td>Connection Password<\/td>\n<td>The password for the user responsible for interacting with the server.<\/td>\n<\/tr>\n<tr>\n<td>User Base<\/td>\n<td>The relative path where all users\u2019 information will be located. This attribute defines where to look for a user.<\/td>\n<\/tr>\n<tr>\n<td>User Search<\/td>\n<td>Search string for searching users.<\/td>\n<\/tr>\n<tr>\n<td>User Subtree<\/td>\n<td>This attribute defines the search scope.<\/p>\n<ul>\n<li>Set to true to search the entire subtree rooted at the user base entry.<\/li>\n<li>Set to false to request a single-level search including only the top level.<\/li>\n<\/ul>\n<\/td>\n<\/tr>\n<tr>\n<td>Role Base<\/td>\n<td>The relative path where all roles information will be located. This attribute defines where to look for a role corresponding to a user.<\/td>\n<\/tr>\n<tr>\n<td>Role Name<\/td>\n<td>The role name defines which attribute is used for a role.<\/td>\n<\/tr>\n<tr>\n<td>Role Search<\/td>\n<td>Search string for searching roles.<\/td>\n<\/tr>\n<tr>\n<td>Role Subtree<\/td>\n<td>This attribute defines the search scope.<\/p>\n<ul>\n<li>Set to true to search the entire subtree rooted at the role base entry.<\/li>\n<li>Set to false to request a single-level search including only the top level.<\/li>\n<\/ul>\n<\/td>\n<\/tr>\n<tr>\n<td>super admin group name<\/td>\n<td>The group name for users with super admin privileges, such as access to the entire functionality of Ephesoft Transact. The super admin users can assign the user roles from the <strong>Access<\/strong> <strong>Manager<\/strong> screen in Ephesoft Transact (<strong>Home<\/strong> &gt; <strong>System Configuration <\/strong>&gt; <strong>Access Manager)<\/strong>.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<p><strong>Note<\/strong>: In the table above, the configurable properties are listed exactly how they display on the screen.<\/p>\n<ol start=\"3\">\n<li>Press y if you need to change any details. Otherwise, press n to continue.<\/li>\n<li>Proceed to <a href=\"#post-46331-_heading=h.2s8eyo1\">Install Applications<\/a>.<\/li>\n<\/ol>\n<h5><a id=\"post-46331-_heading=h.ehrumunwqjvb\"><\/a>Microsoft Active Directory (MSAD)<\/h5>\n<ol start=\"5\">\n<li>Select <strong>MSAD<\/strong> by typing 2 and pressing the <strong>Enter<\/strong> key.<\/li>\n<li>Provide the required details, as described in the table below.<\/li>\n<\/ol>\n<table>\n<tbody>\n<tr>\n<td>MSAD property<\/td>\n<td>Description<\/td>\n<\/tr>\n<tr>\n<td>Connection URL<\/td>\n<td>A valid URL to connect to an Active Directory server. The connection URL should be in the following format:<\/p>\n<p>ldap:\/\/&lt;server_address&gt;:&lt;port_number&gt;.<\/td>\n<\/tr>\n<tr>\n<td>Connection Name<\/td>\n<td>A valid username to connect and access the Active Directory server. This is the username of the user responsible for interacting with the server.<\/td>\n<\/tr>\n<tr>\n<td>Connection Password<\/td>\n<td>The password for the user responsible for interacting with the server.<\/td>\n<\/tr>\n<tr>\n<td>User Base<\/td>\n<td>The relative path where all users\u2019 information will be located. This attribute defines where to look for a user.<\/td>\n<\/tr>\n<tr>\n<td>User Search<\/td>\n<td>Search string for searching users.<\/td>\n<\/tr>\n<tr>\n<td>User Subtree<\/td>\n<td>This attribute defines the search scope.<\/p>\n<ul>\n<li>Set to true to search the entire subtree rooted at the user base entry.<\/li>\n<li>Set to false to request a single-level search including only the top level.<\/li>\n<\/ul>\n<\/td>\n<\/tr>\n<tr>\n<td>Role Base<\/td>\n<td>The relative path where all roles information will be located. This attribute defines where to look for a role corresponding to a user.<\/td>\n<\/tr>\n<tr>\n<td>Role Name<\/td>\n<td>The role name defines which attribute is used for a role.<\/td>\n<\/tr>\n<tr>\n<td>Role Search<\/td>\n<td>Search string for searching roles.<\/td>\n<\/tr>\n<tr>\n<td>Role Subtree<\/td>\n<td>This attribute defines the search scope.<\/p>\n<ul>\n<li>Set to true to search the entire subtree rooted at the role base entry.<\/li>\n<li>Set to false to request a single-level search including only the top level.<\/li>\n<\/ul>\n<\/td>\n<\/tr>\n<tr>\n<td>MS AD Group Search Filter<\/td>\n<td>This attribute helps to filter search results and can have the following operators:<\/p>\n<ul>\n<li>|(OR)<\/li>\n<li>&amp;(AND)<\/li>\n<li>!(NOT)<\/li>\n<\/ul>\n<p>Example: ((!cn=a*))(|cn=Ephesoft*)(&amp;(cn=b*)))<\/p>\n<p>This parameter is optional and can be left empty.<\/td>\n<\/tr>\n<tr>\n<td>super admin group name<\/td>\n<td>The group name for users with super admin privileges, such as access to the entire functionality of Ephesoft Transact. The super admin users can assign the user roles from the <strong>Access<\/strong> <strong>Manager<\/strong> screen in Ephesoft Transact (<strong>Home<\/strong> &gt; <strong>System Configuration <\/strong>&gt; <strong>Access Manager)<\/strong>.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<p><strong>Note<\/strong>: In the table above, the configurable properties are listed exactly how they display on the screen.<\/p>\n<ol start=\"7\">\n<li>Press y if you need to change any details. Otherwise, press n to continue.<\/li>\n<li>Proceed to <a href=\"#post-46331-_heading=h.2s8eyo1\">Install Applications.<\/a><\/li>\n<\/ol>\n<h5><a id=\"post-46331-_heading=h.h11mbx7cn887\"><\/a>Apache Tomcat<\/h5>\n<ol start=\"9\">\n<li>Select <strong>Tomcat<\/strong> by typing 3 and pressing the <strong>Enter<\/strong> key.<\/li>\n<\/ol>\n<p><img decoding=\"async\" width=\"729\" height=\"202\" class=\"wp-image-46356\" src=\"https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2020\/07\/https-ephesoft-com-docs-wp-content-uploads-2019-1-13.png\" alt=\"https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2019\/06\/word-image-330.png\" srcset=\"https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2020\/07\/https-ephesoft-com-docs-wp-content-uploads-2019-1-13.png 729w, https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2020\/07\/https-ephesoft-com-docs-wp-content-uploads-2019-1-13-300x83.png 300w\" sizes=\"(max-width: 729px) 100vw, 729px\" \/><\/p>\n<p><em>Figure 21. Select Tomcat<\/em><\/p>\n<ol start=\"10\">\n<li>Press y if you need to change any details. Otherwise, press n to continue.<\/li>\n<li>Proceed to <a href=\"#post-46331-_heading=h.2s8eyo1\">Install Applications.<\/a><\/li>\n<\/ol>\n<h4><a id=\"post-46331-_heading=h.2s8eyo1\"><\/a>Install Applications<\/h4>\n<ol>\n<li>You will be prompted to install Tesseract (an OCR engine).<\/li>\n<\/ol>\n<p><strong>Note<\/strong>: Tesseract is optional and not recommended but has the option to support more languages. The recommended OCR engine is Nuance, which will be installed automatically in step 3 below.<\/p>\n<ul>\n<li style=\"list-style-type: none\">\n<ul>\n<li>Press n to decline installing Tesseract.<\/li>\n<li>Press y to install Tesseract.<\/li>\n<\/ul>\n<\/li>\n<\/ul>\n<p><img decoding=\"async\" width=\"752\" height=\"443\" class=\"wp-image-46357\" src=\"https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2020\/07\/https-ephesoft-com-docs-wp-content-uploads-2019-1-14.png\" alt=\"https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2019\/06\/word-image-331.png\" srcset=\"https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2020\/07\/https-ephesoft-com-docs-wp-content-uploads-2019-1-14.png 752w, https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2020\/07\/https-ephesoft-com-docs-wp-content-uploads-2019-1-14-300x177.png 300w\" sizes=\"(max-width: 752px) 100vw, 752px\" \/><\/p>\n<p><em>Figure 22. Installing Tesseract<\/em><\/p>\n<ol start=\"2\">\n<li>The installer will prompt for registration information, which will assist with generating your license for Ephesoft Transact. Provide the registration details.<\/li>\n<\/ol>\n<p><img decoding=\"async\" class=\"wp-image-46358\" src=\"https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2020\/07\/https-ephesoft-com-docs-wp-content-uploads-2019-1-15.png\" alt=\"https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2019\/06\/word-image-331.png\" width=\"645\" height=\"380\" srcset=\"https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2020\/07\/https-ephesoft-com-docs-wp-content-uploads-2019-1-15.png 752w, https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2020\/07\/https-ephesoft-com-docs-wp-content-uploads-2019-1-15-300x177.png 300w\" sizes=\"(max-width: 645px) 100vw, 645px\" \/><\/p>\n<p><em>Figure 23. Registration Information<\/em><\/p>\n<ul>\n<li style=\"list-style-type: none\">\n<ul>\n<li>Press y to make any changes. Otherwise, press n to continue.<\/li>\n<\/ul>\n<\/li>\n<\/ul>\n<p>The following screen will display:<\/p>\n<p><img decoding=\"async\" class=\"wp-image-46359\" src=\"https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2020\/07\/https-ephesoft-com-docs-wp-content-uploads-2019-1-16.png\" alt=\"https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2019\/06\/word-image-331.png\" width=\"640\" height=\"377\" srcset=\"https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2020\/07\/https-ephesoft-com-docs-wp-content-uploads-2019-1-16.png 752w, https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2020\/07\/https-ephesoft-com-docs-wp-content-uploads-2019-1-16-300x177.png 300w\" sizes=\"(max-width: 640px) 100vw, 640px\" \/><\/p>\n<p><em>Figure 24. Installing and Updating Applications<\/em><\/p>\n<ol start=\"3\">\n<li>The installer will continue to automatically install and upgrade other applications used by Ephesoft Transact such as LibreOffice, ImageMagick, Nuance, and Poco.<\/li>\n<\/ol>\n<p><img decoding=\"async\" class=\"wp-image-46360\" src=\"https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2020\/07\/https-ephesoft-com-docs-wp-content-uploads-2019-1-17.png\" alt=\"https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2019\/06\/word-image-332.png\" width=\"643\" height=\"361\" srcset=\"https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2020\/07\/https-ephesoft-com-docs-wp-content-uploads-2019-1-17.png 794w, https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2020\/07\/https-ephesoft-com-docs-wp-content-uploads-2019-1-17-300x169.png 300w, https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2020\/07\/https-ephesoft-com-docs-wp-content-uploads-2019-1-17-768x431.png 768w\" sizes=\"(max-width: 643px) 100vw, 643px\" \/><\/p>\n<p><em>Figure 25. Installing and Updating Applications (cont.)<\/em><\/p>\n<p><strong>Important<\/strong>: This step may take some time depending on your server configuration. If the installation process is interrupted at any point due to internet connectivity issues, you can restart the installation process by running the .\/install command again. To check the installation logs and see the installation status, you can use the following command:<\/p>\n<pre>tail -f \/var\/log\/install-ephesoft.log<\/pre>\n<ol start=\"4\">\n<li>This completes the normal installation. Continue to <a href=\"#post-46331-_heading=h.3rdcrjn\">Service Pack Installation<\/a>.<\/li>\n<\/ol>\n<h3><a id=\"post-46331-_heading=h.17dp8vu\"><\/a>Silent Install<\/h3>\n<ol>\n<li>Open the <strong>config.properties<\/strong> file located in the <strong>Response-Files<\/strong> folder.<\/li>\n<\/ol>\n<p><img decoding=\"async\" width=\"722\" height=\"37\" class=\"wp-image-46361 alignnone\" src=\"https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2020\/07\/word-image-77.png\" srcset=\"https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2020\/07\/word-image-77.png 722w, https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2020\/07\/word-image-77-300x15.png 300w\" sizes=\"(max-width: 722px) 100vw, 722px\" \/><\/p>\n<p><em>Figure 26. vi config.properties Command<\/em><\/p>\n<ol start=\"2\">\n<li>Edit the values for the parameters in <strong>config.properties<\/strong> to reflect the required configuration for the install. See the table on configurable properties below for explanations of important parameters.<\/li>\n<\/ol>\n<p><img decoding=\"async\" width=\"722\" height=\"376\" class=\"wp-image-46362\" src=\"https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2020\/07\/word-image-78.png\" srcset=\"https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2020\/07\/word-image-78.png 722w, https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2020\/07\/word-image-78-300x156.png 300w\" sizes=\"(max-width: 722px) 100vw, 722px\" \/><\/p>\n<p><em>Figure 27. 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>Configurable Property<\/td>\n<td>Description<\/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 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.<\/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-46363\" src=\"https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2020\/07\/word-image-79.png\" width=\"592\" height=\"434\" srcset=\"https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2020\/07\/word-image-79.png 722w, https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2020\/07\/word-image-79-300x220.png 300w\" sizes=\"(max-width: 592px) 100vw, 592px\" \/><\/p>\n<p><em>Figure 28. 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<li>The silent install is complete. Proceed to <strong>License and Launch Ephesoft Transact 2020.1.02.<\/strong><\/li>\n<\/ol>\n<h1><a id=\"post-46331-_heading=h.35nkun2\"><\/a>License and Launch Ephesoft Transact 2020.1.02<\/h1>\n<p>After installing the Ephesoft Transact service, you are ready to license and launch Ephesoft Transact. Follow the steps below:<\/p>\n<p><strong>Important<\/strong>: Refer to <a href=\"https:\/\/ephesoft.com\/docs\/install-and-upgrade\/system-requirements\/licensing\/\">Licensing Requirements<\/a> to complete the installation. Ephesoft recommends starting the service after your license is installed<\/p>\n<ol>\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-46364\" src=\"https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2020\/07\/https-ephesoft-com-docs-wp-content-uploads-2019-1-18.png\" alt=\"https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2019\/06\/word-image-338.png\" width=\"602\" height=\"508\" srcset=\"https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2020\/07\/https-ephesoft-com-docs-wp-content-uploads-2019-1-18.png 842w, https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2020\/07\/https-ephesoft-com-docs-wp-content-uploads-2019-1-18-300x253.png 300w, https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2020\/07\/https-ephesoft-com-docs-wp-content-uploads-2019-1-18-768x649.png 768w\" sizes=\"(max-width: 602px) 100vw, 602px\" \/><\/p>\n<p><em>Figure 29. Launch Ephesoft Transact<\/em><\/p>\n<ol start=\"2\">\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 process 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=\"3\">\n<li>The Ephesoft Transact 2020.1.02 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-46365\" src=\"https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2020\/07\/word-image-80.png\" width=\"602\" height=\"443\" srcset=\"https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2020\/07\/word-image-80.png 722w, https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2020\/07\/word-image-80-300x221.png 300w\" sizes=\"(max-width: 602px) 100vw, 602px\" \/><\/p>\n<p><em>Figure 30. Ephesoft Transact Home Screen<\/em><\/p>\n<ol start=\"4\">\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><img decoding=\"async\" width=\"437\" height=\"315\" class=\"wp-image-46366\" src=\"https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2020\/07\/word-image-81.png\" srcset=\"https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2020\/07\/word-image-81.png 437w, https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2020\/07\/word-image-81-300x216.png 300w\" sizes=\"(max-width: 437px) 100vw, 437px\" \/><\/p>\n<p><em>Figure 31. Login Screen<\/em><\/p>\n<p><strong>Important<\/strong>: The system may require additional time to complete the initial login.<\/p>\n<h1><a id=\"post-46331-_heading=h.1ksv4uv\"><\/a>Conclusion<\/h1>\n<p>This completes the installation process.<\/p>\n","protected":false},"featured_media":0,"parent":46138,"menu_order":1,"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 Installation Guide 2020.1.02 | 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 Installation Guide 2020.1.02\" \/>\n<meta property=\"og:description\" content=\"Introduction This document describes how to install Ephesoft Transact 2020.1.02 in the following environments: Environment types \u2014 single or multi-server [&hellip;]\" \/>\n<meta property=\"og:url\" content=\"https:\/\/ephesoft.com\/docs\/products\/transact\/install-and-upgrade\/transact-2020-1-02\/linux-installation-guide-2020-1-02\/\" \/>\n<meta property=\"og:site_name\" content=\"Ephesoft Docs\" \/>\n<meta property=\"article:modified_time\" content=\"2020-08-03T17:25:40+00:00\" \/>\n<meta property=\"og:image\" content=\"https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2020\/07\/word-image-70.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=\"18 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-02\/linux-installation-guide-2020-1-02\/\",\"url\":\"https:\/\/ephesoft.com\/docs\/products\/transact\/install-and-upgrade\/transact-2020-1-02\/linux-installation-guide-2020-1-02\/\",\"name\":\"Linux Installation Guide 2020.1.02 | Ephesoft Docs\",\"isPartOf\":{\"@id\":\"https:\/\/ephesoft.com\/docs\/#website\"},\"datePublished\":\"2020-07-24T15:45:00+00:00\",\"dateModified\":\"2020-08-03T17:25:40+00:00\",\"breadcrumb\":{\"@id\":\"https:\/\/ephesoft.com\/docs\/products\/transact\/install-and-upgrade\/transact-2020-1-02\/linux-installation-guide-2020-1-02\/#breadcrumb\"},\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\/\/ephesoft.com\/docs\/products\/transact\/install-and-upgrade\/transact-2020-1-02\/linux-installation-guide-2020-1-02\/\"]}]},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\/\/ephesoft.com\/docs\/products\/transact\/install-and-upgrade\/transact-2020-1-02\/linux-installation-guide-2020-1-02\/#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.02\",\"item\":\"https:\/\/ephesoft.com\/docs\/products\/transact\/install-and-upgrade\/transact-2020-1-02\/\"},{\"@type\":\"ListItem\",\"position\":5,\"name\":\"Linux Installation Guide 2020.1.02\"}]},{\"@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 Installation Guide 2020.1.02 | Ephesoft Docs","robots":{"index":"noindex","follow":"follow"},"og_locale":"en_US","og_type":"article","og_title":"Linux Installation Guide 2020.1.02","og_description":"Introduction This document describes how to install Ephesoft Transact 2020.1.02 in the following environments: Environment types \u2014 single or multi-server [&hellip;]","og_url":"https:\/\/ephesoft.com\/docs\/products\/transact\/install-and-upgrade\/transact-2020-1-02\/linux-installation-guide-2020-1-02\/","og_site_name":"Ephesoft Docs","article_modified_time":"2020-08-03T17:25:40+00:00","og_image":[{"url":"https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2020\/07\/word-image-70.png"}],"twitter_card":"summary_large_image","twitter_misc":{"Est. reading time":"18 minutes"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"WebPage","@id":"https:\/\/ephesoft.com\/docs\/products\/transact\/install-and-upgrade\/transact-2020-1-02\/linux-installation-guide-2020-1-02\/","url":"https:\/\/ephesoft.com\/docs\/products\/transact\/install-and-upgrade\/transact-2020-1-02\/linux-installation-guide-2020-1-02\/","name":"Linux Installation Guide 2020.1.02 | Ephesoft Docs","isPartOf":{"@id":"https:\/\/ephesoft.com\/docs\/#website"},"datePublished":"2020-07-24T15:45:00+00:00","dateModified":"2020-08-03T17:25:40+00:00","breadcrumb":{"@id":"https:\/\/ephesoft.com\/docs\/products\/transact\/install-and-upgrade\/transact-2020-1-02\/linux-installation-guide-2020-1-02\/#breadcrumb"},"inLanguage":"en-US","potentialAction":[{"@type":"ReadAction","target":["https:\/\/ephesoft.com\/docs\/products\/transact\/install-and-upgrade\/transact-2020-1-02\/linux-installation-guide-2020-1-02\/"]}]},{"@type":"BreadcrumbList","@id":"https:\/\/ephesoft.com\/docs\/products\/transact\/install-and-upgrade\/transact-2020-1-02\/linux-installation-guide-2020-1-02\/#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.02","item":"https:\/\/ephesoft.com\/docs\/products\/transact\/install-and-upgrade\/transact-2020-1-02\/"},{"@type":"ListItem","position":5,"name":"Linux Installation Guide 2020.1.02"}]},{"@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\/46331"}],"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=46331"}],"version-history":[{"count":1,"href":"https:\/\/ephesoft.com\/docs\/wp-json\/wp\/v2\/docs\/46331\/revisions"}],"predecessor-version":[{"id":50584,"href":"https:\/\/ephesoft.com\/docs\/wp-json\/wp\/v2\/docs\/46331\/revisions\/50584"}],"up":[{"embeddable":true,"href":"https:\/\/ephesoft.com\/docs\/wp-json\/wp\/v2\/docs\/46138"}],"next":[{"title":"Linux Upgrade Guide 2020.1.02","link":"https:\/\/ephesoft.com\/docs\/products\/transact\/install-and-upgrade\/transact-2020-1-02\/linux-upgrade-guide-2020-1-02\/","href":"https:\/\/ephesoft.com\/docs\/wp-json\/wp\/v2\/docs\/46332"}],"wp:attachment":[{"href":"https:\/\/ephesoft.com\/docs\/wp-json\/wp\/v2\/media?parent=46331"}],"wp:term":[{"taxonomy":"doc_tag","embeddable":true,"href":"https:\/\/ephesoft.com\/docs\/wp-json\/wp\/v2\/doc_tag?post=46331"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}