1. Home
  2. Transact
  3. Install and Upgrade
  4. Transact 2019.2
  5. Install and Upgrade – Single and Multi-Server
  6. Upgrading on Linux Single and Multi-Server
  7. Ephesoft Linux Multi-Server Upgrade Installation Guide

Ephesoft Linux Multi-Server Upgrade Installation Guide


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

  1. RedHat 6.5 or Ubuntu 13.10 OS (Installer is specifically built and tested on RedHat v 6.5 and Ubuntu v 13.10).
  2. Internet connection is required as some software need to be updated or installed from OS’s repository during Ephesoft’s installation.
  3. Executeble 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 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).
  7. Ephesoft license must be installed in order to use Ephesoft.
  8. Installer is specifically built for Ephesoft v and currently supports MySQL and MariaDB 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 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.

Upgrade Installation Steps

This guide explains steps to upgrade Ephesoft from Ephesoft v to v Please follow the step by step upgrade installation of Ephesoft on RedHat 6.5 operating system using command line installer:

This installer will upgrade Ephesoft Linux installation over already Ephesoft v 3123.

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

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

3. Now, proceed with the upgrade installation of Ephesoft on Linux operating system (RedHat or Ubuntu). Run the installation script using command “./install”. The script must be run as a super user. Installation will be interrupted if script is not executed with super user permission.

4. Ephesoft upgrade installation will start and installer will ask user if he want to use silent installer or not. By default “n” option will be displayed on terminal as shown in the below snapshot:

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

6. Installer will identify the previous version of Ephesoft application installed on the system and asks for the confirmation from user whether he wants to upgrade Ephesoft version to Ephesoft version If user inputs “n” installer will exit and if user inputs “y” then installer will proceed further with processes for up gradation.

7. In this step, if the server is running then installer will ask user to stop the Ephesoft server. As for upgrade installation Ephesoft server needs to be stopped.

8. Now, installation script will extract the Ephesoft_4.0.0.0.tar.gz file inside the existing installation directory and tar file extraction will take some time as shown in the below screenshot:

9. Once the tar file extraction completes, Ephesoft application will be copied to the desired directory. Now, installer will ask whether user wants to execute database patch. By default “y” option will be displayed on terminal as shown in the below snapshot:

10. Once this process is complete Ephesoft upgrade will be complete.

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

12. Now, start the server by running the command “./”. It will start the server.

User can also start ephesoft server through ephesoft service by using the command:

service ephesoft start

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

Through service:

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

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

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


Was this article helpful to you? Yes No