Overview

This document describes step by step procedure of installing Ephesoft silently on a machine. This document should be referred when user wants to install Ephesoft silently using Ephesoft installer setup.

What Is Silent Installation?

Silent-mode installation allows you to define an installation configuration only once and then use the configuration to duplicate the installation on many machines. During installation in silent mode, the installation program reads the settings from a properties file created before beginning the installation. The installation program does not display any configuration options during the installation process.

Prerequisites

In order to use Ephesoft Silent Installer user will need to install following prerequisites:

  1. Microsoft Visual C++ 2005 Redistributable
  2. Microsoft Visual C++ 2005 Redistributable – KB2467175
  3. Microsoft Visual C++ 2008 Redistributable
  4. Microsoft Visual C++ 2010 Redistributable
  5. Microsoft Visual C++ 2012 Redistributable
  6. Microsoft Visual C++ 2013 Redistributable (x86 version)  – Download
  7. Microsoft Hotfix KB2919355 – Download
  8. Microsoft Visual C++ 2015 Redistributable (x86 version)  – Download
  9. .Net framework 4.5.1
  10. Windows OS should be updated with latest windows Update

Note: During silent installation, the installer checks for the prerequisites on the system. If those are not already preinstalled, then installer triggers their installation and proceeds. If the installation completes and some recostar.dll related issues are still observed, it would mean that prerequisites have not been properly installed or are corrupted. You will need to check if .Net Framework 4.5.1 (or higher), Microsoft Visual C++ 2013 Redistributable, and Microsoft Visual C++ 2015 Redistributable are installed or not. If all these prerequisites are installed, then Microsoft Visual C++ 2013 Redistributable and Microsoft Visual C++ 2015 Redistributable may be corrupt. You will need to reinstall these and make sure they are of 32bit version. If redistributables are corrupt or installed incorrectly, Ephesoft can’t detect it while installation. You need to ensure that they are installed properly.
Prerequisites Download: Prerequisites.zip

Additionally, if user wants to use Ephesoft Silent Installer with MS SQL Server then user can either use an already installed instance of MS SQL Server or the user will need to install MS SQL Server as prerequisite. See Supported versions of MS SQL Server

If user wants to use/execute Ephesoft Silent Installer from custom installer then it would be responsibility of custom installer to install all the above mentioned prerequisites

Similarly custom installer will need to install MS SQL Server, if user wants to install MSSQL Server 2008 R2 along with Ephesoft. Ephesoft Silent installer will be responsible for configuring MSSQL server but its installation must be handled by custom installer.

Ephesoft v 4.0.2.0 installer only works in fresh installation mode for silent installation. For upgrading the existing Ephesoft v 3.1.x.x installation by Ephesoft v 4.0.2.0 installer, GUI/Interactive installation mode must be used.

Before beginning the installation user should have a properties file ready which contains all the required configuration.

You may download for the current version here:

http://demoephesoft.com/products/ephesoft-transact/

A sample screenshot for properties file is shown below:

C:\Users\lipsysingla\Desktop\oe1.png

Important Considerations for Silent-Mode Installation

When using silent mode, keep the following considerations in mind:

  • Silent-mode installation requires the same amount of temporary disk space (approximately 7 GB) and uses the same temporary storage directories as a standard installation. The installation program does not alert you if enough space is not there in the temporary directory.
  • A silent-mode installation takes the same amount of time as a standard installation. At the beginning of a silent-mode installation, an installation program window is displayed, indicating that the installation has started. It remains throughout the installation process displaying the progress bar.
  • Incorrect entries in the properties file can cause installation failures. To help you determine the cause of a failure, a log file named “installation.log” is created in a sub directory named logs. This sub directory is created in the directory where properties file is placed.
  • Please do not use semi-colon or special characters in properties file.
  • After installation is completed, a success message is displayed in the installation .log file created during installation.
  • If Ephesoft fresh silent installation uses remote MariaDB\MS SQL server then user will need to execute “{Ephesoft-install-dir}\Dependencies\mariadb\MariaDBSetup\ephesoft-mariadb-config.sql”\”{Ephesoft-install-dir}\Dependencies\MsSQLSetup\ephesoft-mssql-config.sql” manually over Ephesoft Reporting database.
  • If Ephesoft upgrade silent installation uses remote MySql\MS SQL server then user will need to execute ‘{Ephesoft-install-dir}\Dependencies\MySqlSetup\ephesoft-mysql-config.sql’\'{Ephesoft-install-dir}\Dependencies\MsSQLSetup\upgrade-mssql-config.sql’ manually over Ephesoft Reporting database.

Property File

Property Name Default Value Possible Values Description
installation_directory C:\Ephesoft Any valid path in the system. Path where to install the product.
execute_patch 1 0 or 1 Whether to execute patch or not. It’s 1 for yes and 0 for no.
database_type 1 1 or 2 Whether to install MariaDb or MSSQL. It’s 1 for MariaDb and 2 for MSSQL.
configure_maria_db 1 1 or 2 Whether to install new MariaDb instance or use existing. It’s 1 for new and 2 for use existing.
existing_maria_db_username EMPTY Existing MariaDb name If use existing MariaDb, Username of existing MariaDb.
existing_maria_db_password EMPTY Existing MariaDb password If use existing MariaDb, password of existing MariaDb
existing_maria_db_servername EMPTY Existing MariaDb servername If use existing MariaDb, servername of existing MariaDb.
mariadb_root_password root Any value If new MariaDb, it’s root password.
mariadb_confirm_password root Same as mariadb_root_password If new MariaDb, confirm password.
mariadb_port_number 3306 Any value between 1024 & 65535 (including) If use existing MariaDb, then give its port number else give port number for where to install new instance.
configure_mssql_db 1 1 or 2 Whether to install new MSSQL instance or use existing. It’s 1 for new and 2 for use existing.
existing_ms_db_username EMPTY Any value If use existing MSSQL, Username of existing MSSQL.
existing_ms_db_password EMPTY Any value If use existing MSSQL, password of existing MSSQL.
existing_ms_db_servername EMPTY Any value If use existing MSSQL, server name of existing MSSQL.
ms_sql_port_number 1433 Port number of existing MSSQL. If use existing MSSQL, password of existing MSSQL.New instance is installed at 1433 port.
enable_always_on_feature 0 0 or 1 Whether to enable always on feature in case of use existing MSSQL. It’s 1 for enable and 0 for disable.
application_db_name ephesoft Any value Application database name
report_db_name report Any value Report database name
user_registration_name EMPTY Any value Name of registered user.
user_registration_company EMPTY Any value Company of registered user.
user_registration_department EMPTY Any value Department of registered user.
user_registration_street EMPTY Any value Street of registered user.
user_registration_city EMPTY Any value City of registered user.
user_registration_state EMPTY Any value State of registered user.
user_registration_country EMPTY Any value Country of registered user.
use_existing_shared_folders 1 0 or 1 Whether to use existing shared folders or install new. It’s 0 for new and 1 for use existing.
shared_folder_path C:\Ephesoft Any valid path. Shared folders path. If configuring existing shared folders then give path of parent directory of existing shared folders else give path to install new shared folders.
os_type 0 0 or 1 Operating system type. It’s 0 for 64 bits and 1 for 32 bits.

Steps of execution

Following steps must be followed for fresh installation with Installer version 4.0.2.0

  1. Copy msi in system.
  2. Create property file as described above with required configuration. Say its name is config.properties
  3. Install Prerequisites
  4. Run command prompt as administrator and execute following command :

msiexec /i “path where msi is copied” /qb /norestart  USERINPUTSPATH=path where properties file is copied

For example:

msiexec /i  “C:\Ephesoft_4.0.2.0.msi” /qb /norestart USERINPUTSPATH=C:\config.properties

Refer below screenshot: C:\Users\lipsysingla\Desktop\orca4.png

The above command will initiate Ephesoft installer setup on machine and following screen will be displayed to user:

C:\Users\lipsysingla\Desktop\oe3.png

Once the installation is prepared, following progress is displayed to the user:

C:\Users\lipsysingla\Desktop\4020.png

  • Note: When installations begins, a log file named “installation.log” is created in a sub directory named “logs”. This sub directory is created in the directory where properties file is placed.

If any error occurs during installation, error logs are created in this log file, else success message is shown in this.

After installation complete system do not restarts. User has to manually restart if needed or if user wants to restart remove /restart tag from command line and uses below command:

msiexec /i “path where msi is copied” /qb  USERINPUTSPATH=path where properties file is copied

In case user would like to create custom installer and wants to include Ephesoft Silent Installer in their custom installer then the custom installer would have to follow all the above mentioned steps.

How to use ORCA ?

Orca is a database table editor for creating and editing Windows Installer packages. This is a small utility provided by Microsoft to enable user to get inside MSI installer files and edit them to suit their needs.

For editing Ephesoft_4.0.2.0.msi using ORCA, follow below steps:

1. Download orca from below mentioned link :

http://www.technipages.com/download-orca-msi-editor

2. After successfully installing orca, open it.

C:\Users\lipsysingla\Desktop\orca.png

3. Drag and drop Ephesoft_4.0.2.0.msi in it. Following view will appear :

C:\Users\lipsysingla\Desktop\orca1.png

4. Now for editing any property firstly click on Transform menu and then Click New Transform.

C:\Users\lipsysingla\Desktop\orca2.png

5. Say user wants to change the display name of the product, for this open property table and enter new name and click on generate transform.

C:\Users\lipsysingla\Desktop\orca3.png

A mst file with name say (test.mst) at path say (C:\test.mst) will be generated.

6. Now close orca, and run below command from command prompt.

msiexec /i “path where msi is copied” /qb /norestart  TRANSFORMS=path where mst file is placed USERINPUTSPATH=path where properties file is copied

For example:

msiexec /i  “C:\Ephesoft_4.0.2.0.msi” /qb /norestart TRANSFORMS=C:\test.mst USERINPUTSPATH=C:\config.properties

C:\Users\lipsysingla\Desktop\ooo.png

Alternate Way

Instead of creating transforms in orca ,user can directly make changes in msi file opened in orca and use that msi file.

Warning : Using above way will not preserve original msi file.

 

 

 

 

 

<Back| 4.0.0.0 Release Documentation

Was this article helpful to you?

Engineering

Comments are closed.