Ephesoft Linux Multi-Server Installation guide – Ubuntu 13.10

Prerequisites

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

  1. Ubuntu 13.10 (Installer is specifically built and tested on Ubuntu Desktop 13.10).
  2. Internet connection is required as some software need to be updated or installed from Ubuntu’s repository while Ephesoft’s installation.
  3. Executable permission must be given to all files present in installer folder by executing following command.
  4. Navigate to installer directory by executing cd /path to installer
  5. sudo chmod –R 755 *
  6. Installation script must be run as super user otherwise user will get an error message and script will exit.
  7. Ephesoft license must be installed on the machines on which Ephesoft has been installed.
  8. Installer is specifically built for Ephesoft v3.1 and currently supports MySQL database as MSSQL database can not be installed on Linux.
  9. SharedFolders must be configured on network using Samba server file sharing. Scripts doesn’t handles this automatically.
  10. 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.

Important Notes

  1. Ephesoft installation will turn the Firewall(ufw) on after install. At the end of the install, if you had the ufw turned off, please remember to turn it off again.
  2. When shutting down the Ephesoft service in Ubuntu, do not use the shutdown.sh script, but instead use the ephesoft-shutdown.sh script.
  3. After you install Ephesoft, before you run Ephesoft for the first time, run the following commands(dos2unix is installed by Ephesoft):
   Sudo dos2unix /opt/Ephesoft/JavaAppServer/bin
   Sudo dos2unix /opt/Ephesoft/JavaAppServer/conf

Installation Steps

In this guide we will deploy 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 Ubuntu 13.10 operating system through command line installer:

  • Copy the Ephesoft_3.1.0.0.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/Linux directory.

3.1.0.0 Linux Multi 10001.jpg

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

3.1.0.0 Linux Multi 10002.jpg

  • Now, proceed with the fresh installation of Ephesoft on Linux operating system. Run the installation script using command “sudo ./install”. The script must be run as a super user hence we have put sudo before the script. Installation will be interrupted if script is not run with super user permission.

3.1.0.0 Linux Multi 10003.jpg

  • 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 Ubuntu’s repository during Ephesoft’s installation.

3.1.0.0 Linux Multi 10004.jpg

  • First, it will update the package lists from repositories. This process will take some time. As soon as package lists update completes, installer will ask for the path where user wants to install the Ephesoft application.

3.1.0.0 Linux Multi 10005.jpg

  • 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:

3.1.0.0 Linux Multi 10006.jpg

  • Now, installation script will extract the Ephesoft_3.1.0.0.tar.gz file inside the directory defined and tar file extraction progress bar will be shown as shown in the below screenshot:

3.1.0.0 Linux Multi 10007.jpg

  • 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. Since it’s a fresh installation on single server environment hence choose the “n” option. By default “n” option will be displayed on terminal as shown in the below snapshot:

3.1.0.0 Linux Multi 10008.jpg

  • 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.

3.1.0.0 Linux Multi 10009.jpg

  • 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:

3.1.0.0 Linux Multi 10010.jpg

  • 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.

3.1.0.0 Linux Multi 10011.jpg

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

[[File:3.1.0.0_Linux_Multi_10012.jpg|400px]]

  • 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).

3.1.0.0 Linux Multi 10013.jpg

  • 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).

3.1.0.0 Linux Multi 10014.jpg

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

3.1.0.0 Linux Multi 10015.jpg

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

3.1.0.0 Linux Multi 10016.jpg

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

3.1.0.0 Linux Multi 10017.jpg

  • As soon as MySQL is installed successfully, installer will install Imagemagick on system.

3.1.0.0 Linux Multi 10018.jpg

  • Imagemagcik installation will take some time as it will compile and build the libraries as per the operating system.

3.1.0.0 Linux Multi 10019.jpg

3.1.0.0 Linux Multi 10020.jpg

  • As soon as Imagmagick is installed successfully, Installer will now start installing dependencies for Ephesoft.

400px

  • Installer will install the dependencies like ghostscript, libreoffice, libtool, libjpeg, libpng etc.

3.1.0.0 Linux Multi 10022.jpg

  • Now, it will install the Leptonica 1.69 required for installing Tesseract on Linux operating system.

3.1.0.0 Linux Multi 10023.jpg

  • Leptonica installation will take some time as it will compile and build the libraries as per the operating system.

3.1.0.0 Linux Multi 10024.jpg

  • 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.

3.1.0.0 Linux Multi 10025.jpg

  • Once Tesseract is installed successfully, Installer will install the Nuance on the system.

3.1.0.0 Linux Multi 10026.jpg

  • Now, 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.

3.1.0.0 Linux Multi 10027.jpg

  • 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.

3.1.0.0 Linux Multi 10028.jpg

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

3.1.0.0 Linux Multi 10029.jpg

  • Now install license on this system. Go to the licensing directory inside Dependencies folder and run the full file using sudo user permission.

3.1.0.0 Linux Multi 10030.jpg

  • details.properties file is created in the present working directory as shown below:

3.1.0.0 Linux Multi 10031.jpg

  • Now, put the Ephesoft license file (ephesoft.lic) inside <Ephesoft Installation Directory>/Ephesoft/Dependencies/license-util/ephesoft-license-installer.

3.1.0.0 Linux Multi 10032.jpg

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

3.1.0.0 Linux Multi 10033.jpg

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

3.1.0.0 Linux Multi 10034.jpg

  • Now, start the server by running the command “sudo sh 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 sudo /super user permissions as Ephesoft has been installed with sudo/ super user permissions.

3.1.0.0 Linux Multi 10035.jpg

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

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

  • Following screen will open when server comes to RUNNING state:

3.1.0.0 Linux Multi 10036.jpg

  • 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.

3.1.0.0 Linux Multi 10037.jpg

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

3.1.0.0 Linux Multi 10038.jpg

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

3.1.0.0 Linux Multi 10039.jpg

  • 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.

3.1.0.0 Linux Multi 10040.jpg

  • 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.

3.1.0.0 Linux Multi 10041.jpg

  • Enter the database user name, database password, application database name, report database name etc. details. Please make sure that database details entered are correct.

3.1.0.0 Linux Multi 10042.jpg

  • 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.

3.1.0.0 Linux Multi 10043.jpg

  • Repeat 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.
  • Now, open browser and hit the application using the following URL:

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

  • Following screen will open when server comes to RUNNING state:

3.1.0.0 Linux Multi 10044.jpg

  • 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:

3.1.0.0 Linux Multi 10045.jpg

 




Was this article helpful to you?

J.D. Abbey

Comments are closed.