Ephesoft Linux Multi-Server Installation guide – Red Hat/CentOS 6.5 (CentOS 6.X and Transact 4.X are not compliant, only for testing!)

Prerequisites

Following configuration is required for installing Ephesoft on Linux machine using command line installer:

    1. RedHat 6.5 (Installer is specifically built and tested on RedHat v 6.5).
    2. Internet connection is required as some software need to be updated or installed from RedHat’s repository while Ephesoft’s installation.
    3. Executeble permission must be given to all files present in installer folder by executing following command.
      • Navigate to installer directory by executing cd /path to installer
      • sudo chmod –R 755 *
    4. Installation script must be run as root otherwise install will fail. We recommend using ‘su – root‘ to change to root user in the terminal from which you will be installing Ephesoft.
    5. Ephesoft license must be installed on the machines on which Ephesoft has been installed.
    6. Installer is specifically built for Ephesoft v3.1.2.2 and currently supports MySQL database as MSSQL database can not be installed on Linux.
    7. SharedFolders must be configured on network using Samba server file sharing. Scripts doesn’t handles this automatically.
    8. SharedFolders path must be same on all the servers in multiserver cluster beacuse Linux doesn’t understand netowk 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.

 

Note: For Offline Installation Instructions see the following link: Linux Offline Installation – Redhat 

Installation Steps

This guide explains steps to install Ephesoft on two 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 on RedHat 6.5 operating system through command line installer:

    1. Copy the Ephesoft_3.1.2.2.tar.gz and installation scripts to some path using WINSCP or any other tool. As shown in the below example all the required files are copied to /home/turbo directory.

 

 Untitled

    1. In order to execute the scripts, give appropriate permission for executing the scripts using the command “chmod 755 * “.

 Untitled1

 

    1. Before installing Ephesoft, you need to change your user in the terminal to root. We highly recommend using ‘su – root’ instead of ‘su root’. Failure to install as root user will cause install to fail. Sudo username does not give acceptable install permissions.
    1. Now, proceed with the fresh installation of Ephesoft on Linux operating system (RedHat). Run the installation script using command “./install”. The script must be run as a super user. Installation will be interrupted if script is not run with super user permission.

 

 Untitled2

    1. Ephesoft installation will start and first 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 Red Hat’s repository during Ephesoft installation.

 

 Untitled3

    1. Installer will ask for the path where user wants to install the Ephesoft application.

 Untitled4

 

    1. By default installer will install the Ephesoft application inside “opt” directory. User has an option to change the path manually. Installation path can be changed for Ephesoft application as shown in the below snapshot:

 Untitled5

 

    1. Now, installation script will extract the Ephesoft_3.1.2.2.tar.gz file inside the directory defined and tar file extraction will take some time as shown in the below screenshot:

 Untitled6

 

    1. Once the tar file extraction completes, Ephesoft application is copied to the desired directory. Now, installer will ask whether user wants to use existing SharedFolders or new SharedFolders. By default “n” option will be displayed on terminal as shown in the below snapshot:

 Untitled7

 

    1. SharedFolders will be installed inside Ephesoft 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.

 

 Untitled8

    1. Selecting “y” 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:

 Untitled9

 

    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.

 Untitled10

 

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

 Untitled11

 

    1. Now, installer will ask for MySQL installation whether user wants to use existing MySQL instance or install a new MySQL instance.

 Untitled12

 

    1. We are taking here the example for installing fresh MySQL database instance assuming that MySQL is not installed on the system. It will then ask for database configuration details required. Enter the database port number (3306 is the default database port).

 

 Untitled13

    1. Enter the root user password and again re-enter the password. Please make sure password enter is correct. Enter the Ephesoft application database name (ehpesoft is default application DB name).

 Untitled14

 

    1. Enter the report database name (report is default report DB name).

 Untitled15

 

    1. Confirm that database configuration details entered is correct. If you want to change press “y” and press “n” for continuing the installation process.

 Untitled16

 

    1. Installer will now install the MySQL database. This installation may take some time. Please wait for some time.

 

 Untitled17

    1. As soon as MySQL is installed on the system, installer will install the Ephesoft dependencies on the system as shown below:

 Untitled18

 

 Untitled19

 

    1. After successful installation of Ephesoft dependencies, 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.

 Untitled20

 

    1. After successful installation of Checkinstall, installer will install Libreoffice on system. Libreoffice installation will take some time.

 Untitled21

 

    1. After successful installation of Libreoffice, installer will install Ghostscript on system. Ghostscript installation will take some time as it will compile and build the libraries as per the operating system.

 Untitled22

 

    1. After successful installation of Ghostscript, installer will install Imagemagick on system. Imagemagcik installation will take some time as it will compile and build the libraries as per the operating system.

 Untitled23

 

    1. Once imagemagick is installed successfully on the system, installer will ask whether user wants to install Tesseract or not.

 Untitled24

 

    1. If user chooses the option “Y” then it will install the Leptonica 1.69 required for installing Tesseract on Linux operating system. Leptonica installation will take some time as it will compile and build the libraries as per the operating system.

If user chooses the option n then installation of both tesseract and leptonica will be skipped which will save installation time in case user does not want to use tesseract along with Ephesoft

 

 Untitled25

    1. Now, it will install Tesseract 3.0.1. Tesseract installation will take some time as it will compile and build the libraries as per the operating system.

 Untitled26

 

    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.

 

 Untitled27

    1. After successful installation of Nuance. It will install POCO 1.4.6 on the system. POCO installation will take some time as it will compile and build the libraries as per the operating system.

 Untitled28

 

    1. Once POCO is installed successfully, Ephesoft is successfully installed on the machine.

 Untitled30

 

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

 Untitled32

 

 

    1. Run the install-license.sh file using super user permission and your license is successfully installed on the machine.

 Untitled33

 

    1. Now, start the Ephesoft server. For this go inside the bin directory of JavaAppServer placed inside Ephesoft directory.

 Untitled34

 

    1. Now, start the server by running the command “./ startup.sh”. It will start the server. This will take some time as data is being populated in the database.

Note*: Make sure to start Ephesoft using super user permissions as Ephesoft has been installed with super user permissions.

 Untitled35

 

    1. Now, open browser and hit the application using the following URL:

http://<server name>:<port number>/dcma/home.html

    1. Following screen will open when server comes to RUNNING state:

 Untitled37

 

    1. Installing the Ephesoft application on server-2. Please note that Ephesoft application on server-2 will use the SharedFolder deployed on server-1 and will point to the database installed on server-1. Repeat from steps 1 to 7 and copy the Ephesoft application to some user configurable path.

 Untitled38

 

    1. Choose option “y” for installing the SharedFolders since we have to use existing SharedFolders.

 Untitled39

 

    1. Now, please enter the mounted SharedFolders path. Please note that mounted shared folder path should be exactly same as that of server-1.

 Untitled40

 

    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.

 Untitled41a

 

 Untitled41b

 

    1. Now user has to enter the database configuration details. We have to point to the same database which server-1 is using. First, it will ask for the system IP on which MySQL is installed.

 Untitled42

 

    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.

 Untitled43

 

    1. Enter the database port number and confirm that database configuration details entered is correct. If you want to change press “y” and press “n” for continuing the installation process.

Untitled44

 

    1. Perform the steps from 19 to 32. Now Ephesoft is successfully installed on the server-2. Now mount the SharedFolders on server-2 using samba server manually. Once mount is successful start the server as shown in steps 33, 34, 35, 36.
    1. Now, open browser and hit the application using the following URL:

http://<server name>:<port number>/dcma/home.html

    1. Following screen will open when server comes to RUNNING state:

 Untitled47

 

    1. For shutting down the Ephesoft server, go inside the bin directory of JavaAppServer placed inside Ephesoft directory and run the following command as shown below:

 Untitled48

 




Was this article helpful to you?

J.D. Abbey