{"id":3785,"date":"2015-03-10T04:52:58","date_gmt":"2015-03-10T04:52:58","guid":{"rendered":"https:\/\/ephesoft.com\/docs\/?p=3785"},"modified":"2021-11-29T15:31:38","modified_gmt":"2021-11-29T22:31:38","slug":"ephesoft-linux-multi-server-installation-guide","status":"publish","type":"docs","link":"https:\/\/ephesoft.com\/docs\/products\/transact\/install-and-upgrade\/4-5-0-0\/install-upgrade-multi-server\/installing-on-linux\/ephesoft-linux-multi-server-installation-guide\/","title":{"rendered":"Ephesoft Transact Linux Multi-Server Installation Guide"},"content":{"rendered":"

Prerequisites<\/h1>\n

Following configuration is required for installing Ephesoft Transact on Linux machine using command line Single script Linux installer:<\/p>\n

    \n
  1. RedHat 6.8 or Ubuntu 13.10 OS (Installer is specifically built and tested on RedHat v 6.8 and Ubuntu v 13.10).<\/li>\n
  2. Make sure that sudo apt-get update and sudo apt-get upgrade have been run before running the installer.<\/li>\n
  3. Internet connection is required as some software need to be updated or installed from OS\u2019s repository during Transact\u2019s installation.<\/li>\n
  4. Executeble permission must be given to all files present in installer folder by executing following command.<\/li>\n
  5. Navigate to installer directory by executing cd \/path to installer<\/li>\n
  6. sudo chmod \u2013R 755 *<\/li>\n
  7. Installation script must be run with super user permissions otherwise user will get an error message and script will exit (use root user in case of Redhat and sudo user in case of Ubuntu).<\/li>\n
  8. Ephesoft Transact license must be installed in order to use Transact.<\/li>\n
  9. Installer is specifically built for Ephesoft Transact v4.0.0.0 and currently supports MariaDB\/MySQL database as MSSQL database can not be installed on Linux.<\/li>\n
  10. SharedFolders must be configured on network using Samba server file sharing. Scripts doesn\u2019t handles this automatically.<\/li>\n
  11. SharedFolders path must be same on all the servers in multiserver cluster beacuse Linux doesn\u2019t understand network paths in manner that windows does. Hence in order to use SharedFolders on network user will have to create a Samba share of installed SharedFolders on one of the machine e.g. user has SharedFolders locally on \/opt\/SharedFolders on the first machine in cluster. User will have to share this folder using Samba share. In order to configure same shared folders on other Linux machines in multicluster environment an empty folder will be created on machine being configured at same location i.e. \/opt\/SharedFolders by the installer (shared folders path must be same on all machines in multiserver cluster) and this empty folder will act as mount point for the Samba Share network path.<\/li>\n
  12. Makes sure that the server name configured in the dcma-batch.properties is also listed in the\u00a0\/etc\/hosts file.<\/li>\n<\/ol>\n

    Installation Steps<\/h1>\n

    This guide explains steps to install Ephesoft Transact on two Linux servers. Database and SharedFolders will be installed on server-1 and server-2 will use the database and SharedFolders installed on server-1. First install Ephesoft on Server-1. Please follow the step by step installation of Ephesoft Transact on RedHat 6.5 or Ubuntu 13.10 operating system through single script Linux installer (This document takes example of RedHat OS):<\/p>\n

      \n
    1. Copy the Ephesoft_4.0.0.0.tar.gz, Response-Files directory and installation scripts to some path using WINSCP or any other tool. As shown in the below example all the required files have been copied to \/home\/turbo directory.<\/li>\n<\/ol>\n

      \"\"<\/p>\n

        \n
      1. In order to execute the scripts, give appropriate permission for executing the scripts using the command \u201cchmod 755 * \u201c.<\/li>\n<\/ol>\n

        \"\"<\/p>\n

          \n
        1. Now, proceed with the fresh installation of Ephesoft Transact on Linux operating system (RedHat or Ubuntu). Run the installation script using command \u201c.\/install\u201d. The script must be run as a super user.\u00a0 Installation will be interrupted if script is not run with super user permission.<\/li>\n<\/ol>\n

          \"\"<\/p>\n

            \n
          1. Ephesoft Transact installation will start and first installer will ask if user wants to run installer as a silent installer or not. By default \u201cn<\/strong>\u201d option will be displayed on terminal as shown in the below snapshot:<\/li>\n<\/ol>\n

            \"\"<\/p>\n

              \n
            1. Then installer will check for the internet connection availability. Installation will be interrupted if no internet connection is available as some of the software requires update or installation from OS\u2019s repository during Ephesoft Transact installation.<\/li>\n<\/ol>\n

              \"\"<\/p>\n

                \n
              1. Installer will identify system as Red Hat where user can also change the operating system if installer identifies wrong operating system. By default \u201cn<\/strong>\u201d option will be displayed on the terminal as shown in the below snapshot:<\/li>\n<\/ol>\n

                \"\"<\/p>\n

                  \n
                1. Installer will ask for the path where user wants to install the Ephesoft Transact application.<\/li>\n<\/ol>\n

                  \"\"<\/p>\n

                    \n
                  1. By default installer will install the Ephesoft Transact application inside \u201copt\u201d directory. User has an option to change the path manually. Installation path can be changed for Ephesoft Transact application as shown in the below snapshot:<\/li>\n<\/ol>\n

                    \"\"<\/p>\n

                      \n
                    1. Now, installation script will extract the Ephesoft_4.0.0.0.tar.gz file inside the defined directory and tar file extraction may take some time as shown in the below screenshot:<\/li>\n<\/ol>\n

                      \"\"<\/p>\n

                        \n
                      1. Once the tar file extraction completes, Ephesoft Transact application is copied to the desired directory. Now, installer will ask whether user wants to use existing SharedFolders or new SharedFolders. By default \u201cn<\/strong>\u201d option will be displayed on terminal as shown in the below snapshot:<\/li>\n<\/ol>\n

                        \"\"<\/p>\n

                          \n
                        1. SharedFolders will be installed inside Ephesoft Transact directory by default (For example in this case SharedFolders will be installed inside \/home\/turbo\/Linux\/Ephesoft\/SharedFolders). User has an option to change the SharedFolders path in case if one wants to install SharedFolders at some other location.<\/li>\n<\/ol>\n

                          \"\"<\/p>\n

                            \n
                          1. Selecting \u201cy<\/strong>\u201d option will install the SharedFolders at user defined path. For example in this case SharedFolders will be installed inside \/home\/turbo\/Linux\/unc-share directory as shown in the below snapshot:<\/li>\n<\/ol>\n

                            \"\"<\/p>\n

                              \n
                            1. After successful installation of SharedFolders, installer will ask for the port number on which the tomcat server is to be run. By default tomcat will be run on 8080 port number. User can manually change the port number as desired.<\/li>\n<\/ol>\n

                              \"\"<\/p>\n

                                \n
                              1. Now, installer will ask for the server name. By default, it automatically identifies the hostname and will replace the server name with hostname in property files. In case if user wants to give IP address, user can manually change the same.<\/li>\n<\/ol>\n

                                \"\"<\/p>\n

                                  \n
                                1. Now, installer will install the Ephesoft Transact dependencies (development tools) on the system as shown below:<\/li>\n<\/ol>\n

                                  \"\"<\/p>\n

                                    \n
                                  1. After successful installation of Development Tools, Installer will install Checkinstall on system. Checkinstall installation will take some time as it will compile and build the libraries as per the operating system.<\/li>\n<\/ol>\n

                                    \"\"<\/p>\n

                                      \n
                                    1. After successful installation of CheckInstall, Installer will install dependencies from OS repositories on system.<\/li>\n<\/ol>\n

                                      \"\"<\/p>\n

                                        \n
                                      1. Now, installer will ask for MariaDB installation whether user wants to use existing MariaDB instance or install a new MariaDB instance.<\/li>\n<\/ol>\n

                                        \"\"<\/p>\n

                                          \n
                                        1. The example showsfresh installation of MariaDB database instance and assuming that MariaDB is not installed on the system. It will then ask for database required configuration details. Enter the database port number (3306 is the default database port).<\/li>\n<\/ol>\n

                                          \"\"<\/p>\n

                                            \n
                                          1. Enter the root user password and again re-enter the password. Please make sure the password entered is correct. Enter the Ephesoft Transact application database name (ehpesoft is default application DB name).<\/li>\n<\/ol>\n

                                            \"\"<\/p>\n

                                              \n
                                            1. Enter the report database name (report is default report DB name).<\/li>\n<\/ol>\n

                                              \"\"<\/p>\n

                                                \n
                                              1. Confirm that database configuration details entered is correct. If user wants to change the details, press \u201cy<\/strong>\u201d and press \u201cn<\/strong>\u201d for continuing the installation process.<\/li>\n<\/ol>\n

                                                \"\"<\/p>\n

                                                  \n
                                                1. Installer will now install the MariaDB database. This installation may take some time.<\/li>\n<\/ol>\n

                                                  \"\"<\/p>\n

                                                    \n
                                                  1. After successful installation of MariaDB, installer will install Libreoffice on system. Libreoffice installation may take some time.<\/li>\n<\/ol>\n

                                                    \"\"<\/p>\n

                                                      \n
                                                    1. After successful installation of Libreoffice, installer will install Ghostscript on system. Ghostscript installation may take some time as it will compile and build the libraries as per the operating system.<\/li>\n<\/ol>\n

                                                      \"\"<\/p>\n

                                                        \n
                                                      1. After successful installation of Ghostscript, installer will install Imagemagick on system. Imagemagick installation may take some time as it will compile and build the libraries as per the operating system.<\/li>\n<\/ol>\n

                                                        \"\"<\/p>\n

                                                          \n
                                                        1. Once imagemagick is installed successfully on the system, installer will ask whether user wants to install Tesseract or not.<\/li>\n<\/ol>\n

                                                          \"\"<\/p>\n

                                                            \n
                                                          1. If user chooses the option \u201cy<\/strong>\u201d then it will install the Leptonica 1.69 required for installing Tesseract on Linux operating system. Leptonica installation may take some time as it compiles and build the libraries as per the operating system.<\/li>\n<\/ol>\n

                                                            If user chooses the option \u201cn<\/strong>\u201d then installation of both tesseract and leptonica will be skipped which will save installation time in case the user does not want to use tesseract along with Ephesoft Transact.<\/p>\n

                                                            \"\"<\/p>\n

                                                              \n
                                                            1. Now, it will install Tesseract 3.0.1. Tesseract installation may take some time as it compiles and build the libraries as per the operating system.<\/li>\n<\/ol>\n

                                                              \"\"<\/p>\n

                                                                \n
                                                              1. Once Tesseract is installed successfully, Installer will install the Nuance on the system. It will install Nuance 18.6.5 on the system. Nuance installation will take some time as it will compile and build the libraries as per the operating system.<\/li>\n<\/ol>\n

                                                                \"\"<\/p>\n

                                                                  \n
                                                                1. After successful installation of Nuance. It will install POCO 1.4.6 on the system. POCO installation may take some time as it will compile and build the libraries as per the operating system.<\/li>\n<\/ol>\n

                                                                  \"\"<\/p>\n

                                                                    \n
                                                                  1. Once POCO is installed successfully, Ephesoft Transact installation will be completed.<\/li>\n<\/ol>\n

                                                                    \"\"<\/p>\n

                                                                      \n
                                                                    1. Go to the licensing directory inside <Ephesoft Transact Installation Directory>\/Ephesoft\/Dependencies folder and share generated details.properties<\/strong> file with Ephesoft Transact support team to get the license file. If details.properties<\/strong> is not present then, please generate the same by executing .\/license-info<\/strong>.<\/li>\n
                                                                    2. Now, put the Ephesoft Transact license file (ephesoft.lic<\/strong>) inside <Ephesoft Installation Directory>\/Ephesoft\/Dependencies\/license-util\/ephesoft-license-installer.<\/li>\n<\/ol>\n

                                                                      \"\"<\/p>\n

                                                                        \n
                                                                      1. Run the install-license.sh<\/strong> file using super user permission and your license is successfully installed on the machine. (Make sure Ephesoft server is not running while installing the license<\/strong>)<\/li>\n<\/ol>\n

                                                                        \"\"<\/p>\n

                                                                          \n
                                                                        1. Now, start the Ephesoft Transact server. For this go inside the bin directory of JavaAppServer placed inside Ephesoft Transact directory.<\/li>\n<\/ol>\n

                                                                          \"\"<\/p>\n

                                                                            \n
                                                                          1. Now, start the server by running the command \u201c.\/startup.sh<\/strong>\u201d. It will start the server. This may take some time as data is being populated in the database.<\/li>\n<\/ol>\n

                                                                            User can also start ephesoft server through ephesoft service by using the command:<\/p>\n

                                                                            service ephesoft start<\/strong><\/p>\n

                                                                            Note*: Make sure to start Ephesoft Transact using super user permissions as Ephesoft Transact has been installed with super user permissions.<\/strong><\/p>\n

                                                                            \"\"<\/p>\n

                                                                            Through service:<\/p>\n

                                                                            \"\"<\/p>\n

                                                                              \n
                                                                            1. Now, open browser and hit the application using the following URL:<\/li>\n<\/ol>\n

                                                                              http:\/\/<server name>:<port number>\/dcma\/home.html<\/em><\/p>\n

                                                                                \n
                                                                              1. The following screen will open when server comes to RUNNING state:<\/li>\n<\/ol>\n

                                                                                \"\"<\/p>\n

                                                                                  \n
                                                                                1. Installing the Ephesoft Transact application on server-2. Please note that Ephesoft Transact application on server-2 will use the SharedFolder deployed on server-1 and will point to the database installed on server-1. Repeat steps 1 to 8 and copy the Ephesoft Transact application to some user configurable path.<\/li>\n<\/ol>\n

                                                                                  \"\"<\/p>\n

                                                                                    \n
                                                                                  1. Choose option \u201cy<\/strong>\u201d for installing the SharedFolders since user has to use existing SharedFolders.<\/li>\n<\/ol>\n

                                                                                    \"\"<\/p>\n

                                                                                      \n
                                                                                    1. Now, please enter the mounted SharedFolders path. Please note that mounted shared folder path should point to the exact location\u00a0as that of server-1.<\/li>\n<\/ol>\n

                                                                                      \"\"<\/p>\n

                                                                                        \n
                                                                                      1. After successful installation of SharedFolders, installer will ask for the port number on which tomcat server is to be run. By default tomcat will be run on 8080 port number. User can manually change the port number as desired.<\/li>\n<\/ol>\n

                                                                                        \"\"<\/p>\n

                                                                                          \n
                                                                                        1. Now, installer will install development tools, checkinstall and other various dependencies. Then user has to enter the database configuration details. User must point it to the same database which server-1 is using. First, it will ask for the system IP on which MariaDB has been installed.<\/li>\n<\/ol>\n

                                                                                          \"\"<\/p>\n

                                                                                            \n
                                                                                          1. Enter the database user name, database password, application database name, report database name etc. details. Please make sure that database details entered are correct.<\/li>\n<\/ol>\n

                                                                                            \"\"<\/p>\n

                                                                                              \n
                                                                                            1. Enter the database port number and confirm that database configuration details entered is correct. If user wants to change press \u201cy<\/strong>\u201d and press \u201cn<\/strong>\u201d for continuing the installation process.<\/li>\n<\/ol>\n

                                                                                              \"\"<\/p>\n

                                                                                                \n
                                                                                              1. Perform the steps from 24 to 32. Now Ephesoft Transact is successfully installed on the server-2. Now mount the SharedFolders on server-2 using samba server manually. Please refer to Samba Share Configuration for Ephesoft Transact in Multi-Cluster environment on REDHAT Linux.docx.<\/strong> Once mount is successful start the server as shown in steps 33, 34, 35, 36.<\/li>\n
                                                                                              2. Now, open browser and hit the application using the following URL:<\/li>\n<\/ol>\n

                                                                                                http:\/\/<server name>:<port number>\/dcma\/home.html<\/em><\/p>\n

                                                                                                  \n
                                                                                                1. Following screen will open when server comes to RUNNING state:<\/li>\n<\/ol>\n

                                                                                                  \"\"<\/p>\n

                                                                                                    \n
                                                                                                  1. For shutting down the Ephesoft Transact server, go inside the bin directory of JavaAppServer placed inside Ephesoft Transact directory and run the following command as shown below:<\/li>\n<\/ol>\n

                                                                                                    \"\"<\/p>\n

                                                                                                    User can also stop Ephesoft Transact server by using Ephesoft Transact service.<\/p>\n

                                                                                                    service ephesoft stop<\/strong><\/p>\n

                                                                                                    \"\"<\/p>\n

                                                                                                     <\/p>\n

                                                                                                     <\/p>\n

                                                                                                     <\/p>\n

                                                                                                    Ephesoft Transact v4.1.1.0 Installation on Linux with Oracle Database<\/strong><\/h1>\n

                                                                                                    User can now perform silent installation of Ephesoft Transact v4.1.1.0 on Linux as a non-root user. Also, Ephesoft Transact v4.1.1.0, supports offline installation in case you do not have internet access on the system where you are performing installation.<\/p>\n

                                                                                                    Ephesoft Transact v4.1.1.0 also supports Red Hat Enterprise Linux v 6.8.<\/p>\n

                                                                                                    Earlier, Ephesoft Transact supported the following databases:<\/p>\n