OFFLINE-MODE ENABLER

(FOR SYSTEM TO SYSTEM USERS)

Installation guide
Version 1.0

EFRIS
kakasa@ura.go.ug
Contents
Purpose of this document ....................................................................................................................................................... 2
System Preparation.................................................................................................................................................................... 2
Minimum Hardware Requirements for Offline-Mode Server................................................................................. 2
Software Requirements........................................................................................................................................................ 2
Installation..................................................................................................................................................................................... 2
Device Registration .................................................................................................................................................................... 4
Get device number................................................................................................................................................................ 4
System initialization .............................................................................................................................................................. 4
Purpose of this document
This guide covers the installation of the offline mode server component and its related components using
the Windows installer.

System Preparation
Minimum Hardware Requirements for Offline-Mode Server
Item Specifications
Processor >= 3.0 Ghz * 4 cores
RAM 16 GB
HDD 100 GB

Software Requirements
1. Operating System: Windows Server 2012
2. JDK 1.8 or higher

Installation
1. Unzip the tcsSetup zip
2. Open the unzipped folder and double click the installation file
3. Select the destination folder as per the image below
4. Select the JDK and JRE path as per the image below

5. Select the ports on which the tax control service and the tax control update service shall run.
These must be unique and not being used any other service on the current installation server.
 6. Select the MySQL port

7. Click the Install button

8. When the installation is complete, open the browser and visit http://127.0.0.1:9880/efristcs, if the
page shows "service is running...", then the service has been installed successfully.

Device Registration
After the service is installed and successfully started, the server needs to be registered on EFRIS. The
service will generate the corresponding device number according to the relevant attributes of the server.
Get device number
Open the browser and enter the address "http://IP:port/efristcs/ws/tcsapp/getDeviceNo". The system will
return a device number starting with TCS. Share this number with the EFRIS technical contact at URA for
registration on the system.
System initialization
When URA confirms that the device has been registered, to initialize the system open the browser and
visit http://IP:port/efristcs/ws/tcsapp/init/***. Please note that "***" needs to be replaced with the
taxpayer’s TIN. For example, if the taxpayer’s TIN is 1000199999, the link should be:
http://127.0.0.1:9880/efristcs/ws/tcsapp/init/1000199999. (Note that if the default ports were adjusted
during the installation, modify the address appropriately)
If the initialization is successful, it will return true and in case of failure, it will return false. Each server can
only be initialized once; the second request will directly return true. After initialization, taxpayer can
integrate the system according to the API documents.