Transact

  1. Home
  2. Transact
  3. Install and Upgrade
  4. Transact 2020.1.03
  5. Windows Installation Guide 2020.1.03

Windows Installation Guide 2020.1.03

Introduction

This document describes how to install Ephesoft Transact 2020.1.03 in the following environments:

  • Environment types — single and multi-server
  • Operating System — Windows®

Important: Steps unique to a multi-server installation are identified where applicable in this document.

Installation Overview

The process of installing Ephesoft Transact 2020.1.03 follows this general sequence of tasks.

Installation Task General Scope of Activity
Prerequisites Prepare for the installation by gathering installation resources and verifying that the environment and databases are supported.
Obtain and Launch the Install Wizard Package Launch the 2020.1.03 Install Wizard with the Windows Command Prompt. Complete all settings and dialogs as prompted.
License and Launch Ephesoft Transact 2020.1.03 License and launch Ephesoft Transact, then log in. Upon completion of this task and document, all authorized administrators and operators can log in for operations.

Prerequisites

Perform these steps to prepare for successful software installation and startup:

  1. Determine if you need to perform a single-server or multi-server installation.

Important: Steps unique to a multi-server environment upgrade are identified where applicable throughout this document. Follow the instructions and adjust as necessary if upgrading on a multi-server environment.

  1. Verify that Ephesoft Transact 2020.1.03 is supported on your operating system. Refer to Platform Configuration and Third-Party Integrations and reference the 2020.1 table for additional information.
  2. Use the document cited above to confirm and verify that your database version is supported.
  3. The following database information is required when you run the Install Wizard:
    • Username and password
    • Database connection parameters

Important Database Notes: The Ephesoft Transact 2020.1.03 Install Wizard 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.03.

  1. Verify that internet connectivity is available for this installation.
  2. Verify or complete .NET 4.5.2 installation on the server before running the Install Wizard. You will not be able to proceed with the installation if the listed requirements are not met. You can download .NET 4.5.2 from Microsoft.
  3. Confirm the requirements of the SharedFolders directory for this installation.

Note: This directory is used as a shared resource between Ephesoft Transact servers in a multi-server installation. The directory can be installed in one of two locations:

    • Local Disk: By default, the Install Wizard installs SharedFolders on the local system where the user installs Ephesoft Transact. Choose this location for single-server installations.
    • Network File Share Server: Ephesoft recommends installing the SharedFolders directory on a network shared folder, as it allows for future growth and scalability. Choose this location for multi-server installations. If you plan to use SharedFolders from a Network File Share Server, complete the following steps prior to using the Install Wizard:
      1. Obtain the Universal Naming Convention (UNC) server name for the network server.
      2. Create a base network path on that server that will host the SharedFolders directory.

Note: The Install Wizard creates the SharedFolders directory on the network server in a later step. The network server and base network path must be online and available when you run the Install Wizard.

Important: All multi-server installations require the SharedFolders to be on a network server.


Prepare the Server for Installation

Perform these steps to prepare the server to install Ephesoft Transact 2020.1.03.

  1. Log onto the Windows system and set the User Access Control (UAC) to Never notify.

Important: This is a temporary setting, and you must re-enable UAC after completing the installation later in this document.

    1. From the Windows Start menu, search for User Access Control or UAC. The Windows Control Panel displays the link. Click this link to display the page.

Figure 1. Change User Account Control settings in Windows Control Panel

The User Account Control Settings screen displays.

Figure 2. User Account Control Settings

    1. If the security setting is closer to the Always notify part of the scale, adjust this setting to the lowest position (i.e., Never notify) as shown in figure 2. You will be prompted to confirm this setting.
    2. Accept the changes.
  1. Create a Windows service account or confirm the username and password for an existing Windows service account to be used with Ephesoft Transact.

You are now ready to obtain and launch the Install Wizard.


Multi-Server Installation

If you are installing in a multi-server environment, it is important to follow the instructions outlined in Enter Ephesoft Registration, SharedFolders, and Installation Information. The steps for both single and multi-server environments are similar up to this section where the Ephesoft Registration Information screen is described.


Obtain and Launch the Install Wizard Package

Perform these steps to download and launch the Ephesoft Transact Install Wizard:

  1. Refer to the Downloads page for information on how to obtain the Ephesoft Transact installer.
  2. Download the Ephesoft Transact 2020.1.03 Install Wizard as instructed by Ephesoft. This is a zipped file with the following filename: Ephesoft_Transact_2020.1.03_Windows.zip
  3. Extract all contents of this .zip file to a temporary location. To extract the file, right-click the file, and from the pop-up menu, click Extract All.

Figure 7. Click Extract All

Important: You must extract all elements of the installer package. The following figure illustrates the contents of the extracted installer package:

Figure 8. Installer Package Contents

  1. Open the Windows Command Prompt as an Administrator. Navigate to the directory where you extracted the installer zip file, then execute the following command to install Ephesoft Transact 2020.1.03:
msiexec.exe /i Ephesoft_2020.1.03.msi

The following screen displays:

Figure 9. Open File – Security Warning

  1. Click Run to continue launching the Ephesoft Install Wizard. The Ephesoft Transact 2020.1.03 Setup screen displays.

Figure 10. The Ephesoft Transact 2020.1 Setup Screen

  1. Click Next. The End-User License Agreement displays.

Figure 11. End-User License Agreement

  1. Read the end-user license agreement, select the check box to accept the terms, and click Next to continue. The Ephesoft Prerequisites Check displays.

Figure 12. Ephesoft Prerequisites Check

  1. Note: The Install Wizard may take several minutes to perform these prerequisite checks. If a warning displays in the above screen, click Details for more information. Click Next when the prerequisites check is acceptable. Continue to .NET Framework 4.5.2 Installation.

.NET Framework 4.5.2 Installation

Ephesoft Transact performs a check to verify that the .NET Framework 4.5.2 is installed.

Figure 13. .NET Framework 4.5.2 Installation

Note: The following factors enable or disable the Next button:

  • The Next button is enabled if the .NET Framework 4.5.2 is installed on the system.
  • The Next button is disabled if the .NET Framework 4.5.2 is not installed on the system. A Download button will display. Follow these steps:

a. Click Download and go to the appropriate link.
b. Download and install the .NET 4.5.2 Framework.

  • Once you have completed the installation of .NET 4.5.2 Framework, continue to step 9.
  1. Click Next. The Install Wizard performs a check of Microsoft® Visual C++ Redistributables.

Figure 14. Ephesoft Prerequisites Installation

Important: If your system has newer versions of the Visual C++ redistributables, the Ephesoft Transact installer may fail. Perform the following steps:

    1. Uninstall the newer version of the library (not bundled with Transact).
    2. Run the Ephesoft Transact installer.
    3. If any external applications require it, re-install the newer version of the library that were uninstalled in step 1.
      Refer to the list of Visual C++ redistributables shown in Figure 14 for the required versions of these files.

Note: The Install Wizard may display the following message: “Transact prerequisites are being installed in the background.” Allow time for the background configuration processes to complete. Continue to Define Service Credentials.

Define Service Credentials

If you are running the Ephesoft Transact Server as a Windows service, the Install Wizard prompts you to choose which account to use. Choose the account that complies with your organization’s security policy.

  1. In most cases, users select Local System Account.
  2. To use another existing account, select This Account and enter the username and password for an account that has full access permissions to the network SharedFolders path.

Figure 15. Service Credentials and Account Selection

Note: Use this option with a Windows service account that has access to the SharedFolders component, whether local or remote. Ephesoft recommends configuring SharedFolders on a network location for future growth and scalability.

  1. Click Next. Continue to Select and Set Up the Database.

Select and Set Up the Database

The Configure Database screen displays. Perform the steps below to select and set up your database.

  1. Select the database you want to configure. Click Next.

Figure 16. Configure Database Screen

  1. Follow the instructions for the selected database:

MariaDB Configuration

Note: The Install Wizard does not install MariaDB as a part of the installation process. You will need to configure the MariaDB database prior to running the Ephesoft Transact Install Wizard. The Install Wizard 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:

Follow these steps when setting up an existing MariaDB database during the installation of Ephesoft Transact.

a. Enter the MariaDB server configuration settings as prompted.

Note: The user credentials supplied on this page must have permission to create a database service account user, databases, and stored procedures.

Figure 17. MariaDB Server Configuration

b. Once you have provided configuration information for the MariaDB server, click Next to display the Database Login Configuration dialog.

Note: The Install Wizard performs a check of the database connectivity. An error message will display if the database is unreachable.

Figure 18. Database Login Configuration

c. Specify login credentials that will be used as the service account to connect Ephesoft Transact and the databases at runtime.

d. Click Next to complete this MariaDB database setup. MariaDB is now configured for your Ephesoft Transact installation.

e. Continue to Configure OpenOffice to proceed with the Install Wizard.

Microsoft SQL Server Configuration

Before you configure Microsoft SQL Server, refer to Configuring Named Instance for Microsoft® SQL Server, and complete the steps. Then, follow these steps below to configure this database during the installation of Ephesoft Transact.

a. Select Microsoft SQL Server on the Configure Database screen, as illustrated below.

Figure 19. Configure Database Screen: Microsoft SQL Server Option

b. The following step is optional. Review the following two options when selecting the installation type for Microsoft SQL server and choose only if applicable to your installation process.

Figure 20. Selecting the Installation Type for Microsoft SQL Server Integration

The Install Wizard does not support the installation of a new instance of MS SQL Server. The only option is to configure an existing MS SQL instance, as illustrated in the following steps.

The following screen displays if you select both options:

Figure 21. Local/Remote Microsoft SQL Server Configuration Screen

  1. Define the settings in the Local/Remote Microsoft SQL Server Configuration screen. In most cases, users proceed with the default settings.
  2. Click Next once these settings are defined.
  3. Continue to Configure OpenOffice to proceed with the Install Wizard.

Oracle Database Configuration

Follow these steps when setting up an Oracle database during the installation of Ephesoft Transact.

a. Select Oracle Database Server in the Configure Database screen, as illustrated below:

Figure 22. Select Oracle Database Server

b. The Local/Remote Oracle Server Configuration Information screen displays with the option to create new schema or configure existing Oracle schema. With either of the following two options, a Security Identifier (SID) is required.

Figure 23. Oracle Schema Selection

      1. First Option: Select the first option to create a new Oracle schema. The following screen displays. Enter the appropriate information in the text fields and click Next.

Figure 24. Local/Remote Oracle Server Configuration — Create New Oracle Schema

      1. Second Option: Select the second option to use existing Oracle schema. The following screen displays. Enter the appropriate information in the text fields for the Oracle database.

Figure 25. Local/Remote Oracle Server Configuration — Use Existing Oracle Schema

c. Click Next. The Oracle database configuration for this installation of Ephesoft Transact is now complete.

d.  Continue to Configure OpenOffice to proceed with the Install Wizard.

Configure OpenOffice

After completing the database setup, the OpenOffice Configuration screen displays.

Figure 26. OpenOffice Configuration

a. Use the default port number, unless your network specifically requires a different port. Click Next to proceed.

Configure Authentication Mode

The Authentication Mode dialog displays, as illustrated below:

Figure 27. Select an Authentication Mode

  1. Select the Authentication Mode for this installation.
    • Select the first option for Standard Form Authentication. This is the default option.

a. Select either HTTP or HTTPS.
b. Click Next.

  1. Follow these steps if using HTTP: Click Next. The User Connectivity Settings screen displays, with the option to choose one of the following connection types:
    • LDAP
      Note: If you are performing a fresh installation of Ephesoft Transact 2020.1.03 and do not have Microsoft Visual C++ 2010 installed, you will need to perform a separate installation of LDAP. Refer to OpenLDAP: Separate Installation for more information.
    • Active Directory
    • Tomcat

Proceed to Configure User Connectivity Settings for the next step in configuration.

  1. Follow these steps if using HTTPS: Click Next. The following screen displays, allowing you to choose either Standard Form Authentication or PKI Authentication.

Note: If you select PKI Authentication, an additional field displays that allows you to navigate to and select the PKI Property file. Complete this field.

Figure 28. Authentication Mode

  1. Click Next to configure the Certificate Details for PKI.

Figure 29. JKS Server Cert and CA Cert Details

  • Both certificates are defined on the server for this installation.
  • The Server Cert is a Java Keystore File (JKS) file for the server. Provide the JKS file and password for HTTPS configuration for the server certificate.
  • The CA Cert is the certificate file for a client system. Provide the CA Cert, Password, and Alias Name for the client certificate.
  1. Click Next. The Realm Settings for PKI screen displays.

Figure 30. Realm Settings for PKI

  • Enter the appropriate information in the text fields and click Next. The Connector Settings for PKI screen displays.

Figure 31. Connector Settings for PKI

  • Enter the information in the text fields and define the corresponding settings.
  • Click Next to complete this configuration for authentication. Proceed to Configure User Connectivity Settings.

Configure User Connectivity Settings

Once you have configured authentication mode and the related screens, the Install Wizard displays the User Connectivity Settings, as illustrated below:

Figure 32. User Connectivity Settings

When selecting Tomcat, click Next. The Ephesoft Registration Information screen displays.

Note: The default selection is Tomcat.

  1. Define the User Connectivity Settings as prompted for LDAP, Active Directory or Tomcat.

a. LDAP — The following figure illustrates User Connectivity Setting for LDAP configuration. If this applies to the installation, enter the appropriate information in the text fields and click Next.

Figure 33. LDAP Configuration for User Connectivity Settings

b. Active Directory — The following figure illustrates User Connectivity Settings for Active Directory configuration. If this applies to the installation, enter the appropriate information in the text fields and click Next.

Figure 34. Active Directory Configuration for User Connectivity Settings

c. Tomcat — The following figure illustrates the first screen of User Connectivity Settings for Tomcat. If this applies to the installation, click Next.

Figure 35. User Connectivity Settings for Tomcat

Enter Ephesoft Registration, SharedFolders, and Installation Information

Once you have completed the User Connectivity Settings, the Ephesoft Registration Information screen displays.

  1. Enter the appropriate information in the text fields and click Next.

Figure 36. Ephesoft Registration Information Screen

The Shared Folder Configuration screen displays.

Important: With this screen, you define settings for the SharedFolders component, as described in the section titled Prerequisites. It is a requirement to use SharedFolders configured on a network location for multi-server installations.

Figure 37. Shared Folder Configuration Screen

Important: All steps up to this point are done regardless of server environment (single or multiple). The following steps vary depending on a single or multi-server installation.

  • Select No if you are installing on a single-server environment, or if you are installing the first server in a multi-server environment.
  • Select Yes if you are installing the second (third, fourth, etc.) server in a multi-server environment.

Note: For additional information on multi-server environments, refer to Multi-Server Installation.

  1. Click Next.
  2. The Installation Folder screen displays.

Figure 38. Installation Folder Setup Screen

  1. Select the checkbox labeled Install Shared folder separately and define the network location (if using SharedFolders on a network for this installation).

Important: When installing subsequent servers for multi-server deployments, the SharedFolders directory must be installed on a file share that will be accessible by all servers in the cluster. To do so, click Change to provide the network location of a previously installed shared folder.

Figure 39. Change Destination Folder

  1. Click Next in the Installation Folder screen.

Run and Finish the Install Wizard

After you have chosen the folder location, the Ready to Install screen displays.

Note: If needed, click Back to adjust your configurations in previous screens.

  1. Click Install. The status bar displays.

Figure 40. Ready to Install Screen

Figure 41. Status Bar of the Install Wizard Progress

Note: This may take some time.

Once the installation is completed, the Post-Installation Instructions screen displays.

Figure 42. Post-Installation Instructions

  1. Read the post-installation instructions and perform the necessary tasks, then click Next. The following screen displays to confirm that the installation is complete.

Figure 43. Ephesoft Transact 2020.1 Setup is Complete Screen

  1. Select Restart my computer.

Important: A restart is required for Ephesoft Transact to function properly.

  1. Click Finish.
  2. When the installation is complete, re-enable the User Access Control (UAC) on this server.

Important: This was a temporary setting required when running the Install Wizard in a previous task. This procedure reactivates the UAC after installation.

a. From the Windows Start menu, select the User Access Control settings. The Windows Control Panel displays a link. Click this link to display the page.

Figure 44. Change User Account Control settings in Windows Control Panel

The User Account Control Settings screen displays.

Figure 45. User Account Control Settings

b. Adjust this setting to the desired position for normal operations. Your setting may differ from the illustration shown above. The system prompts you to confirm this setting. Accept the changes.

This completes your installation. Continue to License and Launch Ephesoft Transact.


License and Launch Ephesoft Transact 2020.1.03

After starting the Ephesoft Transact service, you are ready to launch Ephesoft Transact. Follow the steps below:

Important: Ephesoft recommends restarting the service after your license is installed. For additional information about support for Microsoft SQL Server, refer to Platform Configuration and Third-Party Integrations.

  1. Follow the steps listed in Licensing Requirements.

Note: You will need a new license for Ephesoft Transact 2020.1.03 if you want to purchase the ID Extraction feature. To purchase the ID Extraction plugin, please contact your Sales Representative and ask for “Quickscreen”.

  1. Open a web browser.
  2. Enter the following Ephesoft Transact URL: http://<server_name>:8080/dcma/home.html

Note: Allow time for the background configuration processes to complete. The initial startup may require several minutes.

  1. The Ephesoft Transact 2020.1.03 home page displays. Select Administrator or Operator to log in.

Figure 46. Ephesoft Transact Home Screen

  1. Enter the username and password.

Figure 47. Login Screen

Important: The system may require additional time to complete the initial login.

Conclusion

This completes the installation process.

Was this article helpful to you? Yes No