{"id":31639,"date":"2015-10-01T12:32:30","date_gmt":"2015-10-01T20:32:30","guid":{"rendered":"https:\/\/ephesoft.com\/docs\/2019-1-2\/installing-upgrading\/install-upgrade-multi-server\/installing-on-windows\/multi-server-deployment-over-multiple-regions\/"},"modified":"2020-05-19T12:24:57","modified_gmt":"2020-05-19T19:24:57","slug":"multi-server-deployment-over-multiple-regions","status":"publish","type":"docs","link":"https:\/\/ephesoft.com\/docs\/products\/transact\/install-and-upgrade\/additional-resources\/windows\/multi-server-deployment-over-multiple-regions\/","title":{"rendered":"Multi-Server Deployment over Multiple Regions"},"content":{"rendered":"<p><strong>KB Article #9612<\/strong><\/p>\n<p><strong>Topic\/Category:\u00a0<\/strong>Multi-Server install<\/p>\n<p><strong>Issue:<\/strong>\u00a0Multi server Deployment Over Multiple Regions<\/p>\n<h3><span id=\"Overview_14\" class=\"mw-headline\">Overview<\/span><\/h3>\n<p>This document describes how to deploy an Ephesoft\u2019s failover mechanism which provides high-availability support for Ephesoft services like Folder Monitor service across servers over multiple regions( Data centers and cloud) and helps recover servers from crashes. If one of the servers fails then failover mechanism initializes another live server in multi-server environment and starts to provide (e.g. folder monitor) service through newly initialized server. Thus user experiences minimum or no disruption in services. At present two services are managed by failover mechanism i.e. folder monitor and application script.<\/p>\n<h3><span id=\"Overview_14\" class=\"mw-headline\">Introduction:<\/span><\/h3>\n<p><em>An Ephesoft\u00a0Server Failover Cluster is a group of independent servers that work together to increase the availability of applications and services.<\/em><\/p>\n<p>Ephesoft\u00a0Server Failover Clustering provides infrastructure features that support the high-availability and disaster recovery scenarios. The services that were hosted on that node can be automatically or manually transferred to another available node in a process known as failover.<\/p>\n<h3>Database<\/h3>\n<p>All the servers with in multi-server set up will share the single instance of Ephesoft database which will be the mode of synchronization between the servers.<\/p>\n<p><a href=\"https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2014\/08\/400px-3.1_FailoverMechanism_10001.jpg\"><img decoding=\"async\" class=\"size-full wp-image-652 alignleft\" src=\"https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2014\/08\/400px-3.1_FailoverMechanism_10001.jpg\" alt=\"400px-3.1_FailoverMechanism_10001\" width=\"400\" height=\"226\" srcset=\"https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2014\/08\/400px-3.1_FailoverMechanism_10001.jpg 400w, https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2014\/08\/400px-3.1_FailoverMechanism_10001-300x169.jpg 300w\" sizes=\"(max-width: 400px) 100vw, 400px\" \/><\/a><\/p>\n<p>&nbsp;<\/p>\n<p>&nbsp;<\/p>\n<p>&nbsp;<\/p>\n<p>&nbsp;<\/p>\n<p>&nbsp;<\/p>\n<p>&nbsp;<\/p>\n<p>&nbsp;<\/p>\n<p>Ephesoft Database will be running in all circumstances and will form the basis of all communication between the servers.<\/p>\n<p>The Ephesoft Data Base<\/p>\n<h3><span id=\"Approach\" class=\"mw-headline\">Approach<\/span><\/h3>\n<p>Ephesoft database will contain two tables to keep track of number of servers and also which server is responsible for providing which service.<\/p>\n<p>The two tables are as follows:-<\/p>\n<ul>\n<li>server_registry: To keep record of active and inactive servers.<\/li>\n<\/ul>\n<div class=\"table-responsive\">\n<table class=\"easy-table easy-table-default \" border=\"1\">\n<thead>\n<tr>\n<th>Field Name<\/th>\n<th>Data Type<\/th>\n<th>Description<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td>ID<\/td>\n<td>BIGINT<\/td>\n<td>ID is primary key of server_registry<\/td>\n<\/tr>\n<tr>\n<td>ip_address<\/td>\n<td>VARCHAR(255)<\/td>\n<td>Ip_address is the IP address of the server<\/td>\n<\/tr>\n<tr>\n<td>app_context<\/td>\n<td>VARCHAR(255)<\/td>\n<td>app_context is the application context like \/dcma<\/td>\n<\/tr>\n<tr>\n<td>port_number<\/td>\n<td>VARCHAR(255)<\/td>\n<td>Port_number is the port number on which application is running like: 8080<\/td>\n<\/tr>\n<tr>\n<td>is_active<\/td>\n<td>BIT<\/td>\n<td>Is_active is 1 for active server and 0 for in-active server<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<\/div>\n<ul>\n<li>service_status: To keep track of which server is providing which service.<\/li>\n<\/ul>\n<div class=\"table-responsive\">\n<table class=\"easy-table easy-table-default \" border=\"1\">\n<thead>\n<tr>\n<th>Field Name<\/th>\n<th>Data Type<\/th>\n<th>Description<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td>ID<\/td>\n<td>BIGINT<\/td>\n<td>ID is primary key of server_status<\/td>\n<\/tr>\n<tr>\n<td>service_registry_id<\/td>\n<td>BIGINT<\/td>\n<td>Service_registry_id is the foreign key to server_registry table<\/td>\n<\/tr>\n<tr>\n<td>service_type<\/td>\n<td>VARCHAR(255)<\/td>\n<td>Service_type is the type of service provided by the server<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<\/div>\n<p>A <b>heartbeat <\/b>service will be running on all the servers at different time intervals which will serve following purpose:-<\/p>\n<ol>\n<li>It will ping the servers listed in server_registry table on regular basis and update their status by updating the is_active field of table.<\/li>\n<li>It will update the service_status table and persist which service is being executed on which server.<\/li>\n<\/ol>\n<p><a href=\"https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2014\/08\/400px-3.1_FailoverMechanism_10002.jpg\"><img decoding=\"async\" class=\"size-full wp-image-659 alignnone\" src=\"https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2014\/08\/400px-3.1_FailoverMechanism_10002.jpg\" alt=\"400px-3.1_FailoverMechanism_10002\" width=\"400\" height=\"255\" srcset=\"https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2014\/08\/400px-3.1_FailoverMechanism_10002.jpg 400w, https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2014\/08\/400px-3.1_FailoverMechanism_10002-300x191.jpg 300w\" sizes=\"(max-width: 400px) 100vw, 400px\" \/><\/a><\/p>\n<p>Above figure shows a setup of a multi-server environment.<\/p>\n<p>Following are the cases which will ensure a high-availability support for folder monitor service:-<\/p>\n<p><b>When the server starts initially: <\/b>Heart beat service at each server will check the service_status table synchronously and folder monitor service will be registered to the server on first come first serve basis. For example, if there are three servers say A, B, C and if serverA starts first, then serverA will provide the folder monitor service .It will make an entry in service_status table and all other servers will wait until serverA is down.<\/p>\n<p>Please refer below:<\/p>\n<p><a href=\"https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2014\/08\/400px-3.1_FailoverMechanism_10003.jpg\"><img decoding=\"async\" class=\"size-full wp-image-662 alignnone\" src=\"https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2014\/08\/400px-3.1_FailoverMechanism_10003.jpg\" alt=\"400px-3.1_FailoverMechanism_10003\" width=\"400\" height=\"155\" srcset=\"https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2014\/08\/400px-3.1_FailoverMechanism_10003.jpg 400w, https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2014\/08\/400px-3.1_FailoverMechanism_10003-300x116.jpg 300w\" sizes=\"(max-width: 400px) 100vw, 400px\" \/><\/a><\/p>\n<p>Ephesoft database will look like this:<\/p>\n<p><b>server_registry<\/b><\/p>\n<div class=\"table-responsive\">\n<table class=\"easy-table easy-table-default \" border=\"1\">\n<thead>\n<tr>\n<th>ID<\/th>\n<th>IP_ADDRESS<\/th>\n<th>PORT<\/th>\n<th>IS_ACTIVE<\/th>\n<th>APP_CONTEXT<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td>1<\/td>\n<td>A<\/td>\n<td>8080<\/td>\n<td>1<\/td>\n<td>\/dcma<\/td>\n<\/tr>\n<tr>\n<td>2<\/td>\n<td>B<\/td>\n<td>8080<\/td>\n<td>1<\/td>\n<td>\/dcma<\/td>\n<\/tr>\n<tr>\n<td>3<\/td>\n<td>C<\/td>\n<td>8080<\/td>\n<td>1<\/td>\n<td>\/dcma<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<\/div>\n<p><b>service_status<\/b><\/p>\n<div class=\"table-responsive\">\n<table class=\"easy-table easy-table-default \" border=\"1\">\n<thead>\n<tr>\n<th>ID<\/th>\n<th>SERVER_REGISTRY_ID<\/th>\n<th>SERVICE_TYPE<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td>1<\/td>\n<td>1 (for A)<\/td>\n<td>FOLDER_MONITOR<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<\/div>\n<p><b>When all the servers are running: <\/b>Heartbeat service will keep checking the status of other servers in multi-server environment and if it detects the one of server server is down then it will query the service_status table synchronously to check whether there was any service being provided by that server. If any such service is found then the server which detected other server\u2019s status will take the responsibility of providing the service which the in-active server was providing. It will also update the service_status table and service_registry table to synchronize the state and communicate other servers that responsibility is now being handled by it. For example, server A goes down and server C detects first that server A is down then server C will take the responsibility of providing (folder monitor) service. Please refer below:-<\/p>\n<p><a href=\"https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2014\/08\/400px-3.1_FailoverMechanism_10004.jpg\"><img decoding=\"async\" class=\"size-full wp-image-667 alignnone\" src=\"https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2014\/08\/400px-3.1_FailoverMechanism_10004.jpg\" alt=\"400px-3.1_FailoverMechanism_10004\" width=\"400\" height=\"172\" srcset=\"https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2014\/08\/400px-3.1_FailoverMechanism_10004.jpg 400w, https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2014\/08\/400px-3.1_FailoverMechanism_10004-300x129.jpg 300w\" sizes=\"(max-width: 400px) 100vw, 400px\" \/><\/a><\/p>\n<p><b>server_registry<\/b><\/p>\n<div class=\"table-responsive\">\n<table class=\"easy-table easy-table-default \" border=\"1\">\n<thead>\n<tr>\n<th>ID<\/th>\n<th>IP_ADDRESS<\/th>\n<th>PORT<\/th>\n<th>IS_ACTIVE<\/th>\n<th>APP_CONTEXT<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td>1<\/td>\n<td>A<\/td>\n<td>8080<\/td>\n<td>0<\/td>\n<td>\/dcma<\/td>\n<\/tr>\n<tr>\n<td>2<\/td>\n<td>B<\/td>\n<td>8080<\/td>\n<td>1<\/td>\n<td>\/dcma<\/td>\n<\/tr>\n<tr>\n<td>3<\/td>\n<td>C<\/td>\n<td>8080<\/td>\n<td>1<\/td>\n<td>\/dcma<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<\/div>\n<p><b>service_status<\/b><\/p>\n<div class=\"table-responsive\">\n<table class=\"easy-table easy-table-default \" border=\"1\">\n<thead>\n<tr>\n<th>ID<\/th>\n<th>SERVER_REGISTRY_ID<\/th>\n<th>SERVICE_TYPE<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td>1<\/td>\n<td>3 (for C)<\/td>\n<td>FOLDER_MONITOR<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<\/div>\n<p>When other servers detect that one of the servers has become in-active, they will also query the service_status table to check whether any service was being handled by the in-active server. But if they found that there was no service for which in-active server was responsible then they will continue to keep track for further failures. If the server that went down starts again then it will also wait for other servers to go down and this process will continue.<\/p>\n<p>Failover mechanism will work the same way for all the other services under it.<\/p>\n","protected":false},"featured_media":0,"parent":44681,"menu_order":10,"comment_status":"closed","ping_status":"open","template":"","doc_tag":[],"yoast_head":"<!-- This site is optimized with the Yoast SEO Premium plugin v19.0 (Yoast SEO v22.1) - https:\/\/yoast.com\/wordpress\/plugins\/seo\/ -->\n<title>Multi-Server Deployment over Multiple Regions | Ephesoft Docs<\/title>\n<meta name=\"robots\" content=\"noindex, follow\" \/>\n<meta property=\"og:locale\" content=\"en_US\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"Multi-Server Deployment over Multiple Regions\" \/>\n<meta property=\"og:description\" content=\"KB Article #9612 Topic\/Category:\u00a0Multi-Server install Issue:\u00a0Multi server Deployment Over Multiple Regions Overview This document describes how to deploy an Ephesoft\u2019s [&hellip;]\" \/>\n<meta property=\"og:url\" content=\"https:\/\/ephesoft.com\/docs\/products\/transact\/install-and-upgrade\/additional-resources\/windows\/multi-server-deployment-over-multiple-regions\/\" \/>\n<meta property=\"og:site_name\" content=\"Ephesoft Docs\" \/>\n<meta property=\"article:modified_time\" content=\"2020-05-19T19:24:57+00:00\" \/>\n<meta property=\"og:image\" content=\"https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2014\/08\/400px-3.1_FailoverMechanism_10001.jpg\" \/>\n<meta name=\"twitter:card\" content=\"summary_large_image\" \/>\n<meta name=\"twitter:label1\" content=\"Est. reading time\" \/>\n\t<meta name=\"twitter:data1\" content=\"4 minutes\" \/>\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\"@context\":\"https:\/\/schema.org\",\"@graph\":[{\"@type\":\"WebPage\",\"@id\":\"https:\/\/ephesoft.com\/docs\/products\/transact\/install-and-upgrade\/additional-resources\/windows\/multi-server-deployment-over-multiple-regions\/\",\"url\":\"https:\/\/ephesoft.com\/docs\/products\/transact\/install-and-upgrade\/additional-resources\/windows\/multi-server-deployment-over-multiple-regions\/\",\"name\":\"Multi-Server Deployment over Multiple Regions | Ephesoft Docs\",\"isPartOf\":{\"@id\":\"https:\/\/ephesoft.com\/docs\/#website\"},\"datePublished\":\"2015-10-01T20:32:30+00:00\",\"dateModified\":\"2020-05-19T19:24:57+00:00\",\"breadcrumb\":{\"@id\":\"https:\/\/ephesoft.com\/docs\/products\/transact\/install-and-upgrade\/additional-resources\/windows\/multi-server-deployment-over-multiple-regions\/#breadcrumb\"},\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\/\/ephesoft.com\/docs\/products\/transact\/install-and-upgrade\/additional-resources\/windows\/multi-server-deployment-over-multiple-regions\/\"]}]},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\/\/ephesoft.com\/docs\/products\/transact\/install-and-upgrade\/additional-resources\/windows\/multi-server-deployment-over-multiple-regions\/#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Home\",\"item\":\"https:\/\/ephesoft.com\/docs\/\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Transact\",\"item\":\"https:\/\/ephesoft.com\/docs\/products\/transact\/\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Install and Upgrade\",\"item\":\"https:\/\/ephesoft.com\/docs\/products\/transact\/install-and-upgrade\/\"},{\"@type\":\"ListItem\",\"position\":4,\"name\":\"Additional Resources\",\"item\":\"https:\/\/ephesoft.com\/docs\/products\/transact\/install-and-upgrade\/additional-resources\/\"},{\"@type\":\"ListItem\",\"position\":5,\"name\":\"Windows\",\"item\":\"https:\/\/ephesoft.com\/docs\/products\/transact\/install-and-upgrade\/additional-resources\/windows\/\"},{\"@type\":\"ListItem\",\"position\":6,\"name\":\"Multi-Server Deployment over Multiple Regions\"}]},{\"@type\":\"WebSite\",\"@id\":\"https:\/\/ephesoft.com\/docs\/#website\",\"url\":\"https:\/\/ephesoft.com\/docs\/\",\"name\":\"Ephesoft Docs\",\"description\":\"Intelligent Document Processing Made Easy\",\"potentialAction\":[{\"@type\":\"SearchAction\",\"target\":{\"@type\":\"EntryPoint\",\"urlTemplate\":\"https:\/\/ephesoft.com\/docs\/?s={search_term_string}\"},\"query-input\":\"required name=search_term_string\"}],\"inLanguage\":\"en-US\"}]}<\/script>\n<!-- \/ Yoast SEO Premium plugin. -->","yoast_head_json":{"title":"Multi-Server Deployment over Multiple Regions | Ephesoft Docs","robots":{"index":"noindex","follow":"follow"},"og_locale":"en_US","og_type":"article","og_title":"Multi-Server Deployment over Multiple Regions","og_description":"KB Article #9612 Topic\/Category:\u00a0Multi-Server install Issue:\u00a0Multi server Deployment Over Multiple Regions Overview This document describes how to deploy an Ephesoft\u2019s [&hellip;]","og_url":"https:\/\/ephesoft.com\/docs\/products\/transact\/install-and-upgrade\/additional-resources\/windows\/multi-server-deployment-over-multiple-regions\/","og_site_name":"Ephesoft Docs","article_modified_time":"2020-05-19T19:24:57+00:00","og_image":[{"url":"https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2014\/08\/400px-3.1_FailoverMechanism_10001.jpg"}],"twitter_card":"summary_large_image","twitter_misc":{"Est. reading time":"4 minutes"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"WebPage","@id":"https:\/\/ephesoft.com\/docs\/products\/transact\/install-and-upgrade\/additional-resources\/windows\/multi-server-deployment-over-multiple-regions\/","url":"https:\/\/ephesoft.com\/docs\/products\/transact\/install-and-upgrade\/additional-resources\/windows\/multi-server-deployment-over-multiple-regions\/","name":"Multi-Server Deployment over Multiple Regions | Ephesoft Docs","isPartOf":{"@id":"https:\/\/ephesoft.com\/docs\/#website"},"datePublished":"2015-10-01T20:32:30+00:00","dateModified":"2020-05-19T19:24:57+00:00","breadcrumb":{"@id":"https:\/\/ephesoft.com\/docs\/products\/transact\/install-and-upgrade\/additional-resources\/windows\/multi-server-deployment-over-multiple-regions\/#breadcrumb"},"inLanguage":"en-US","potentialAction":[{"@type":"ReadAction","target":["https:\/\/ephesoft.com\/docs\/products\/transact\/install-and-upgrade\/additional-resources\/windows\/multi-server-deployment-over-multiple-regions\/"]}]},{"@type":"BreadcrumbList","@id":"https:\/\/ephesoft.com\/docs\/products\/transact\/install-and-upgrade\/additional-resources\/windows\/multi-server-deployment-over-multiple-regions\/#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"Home","item":"https:\/\/ephesoft.com\/docs\/"},{"@type":"ListItem","position":2,"name":"Transact","item":"https:\/\/ephesoft.com\/docs\/products\/transact\/"},{"@type":"ListItem","position":3,"name":"Install and Upgrade","item":"https:\/\/ephesoft.com\/docs\/products\/transact\/install-and-upgrade\/"},{"@type":"ListItem","position":4,"name":"Additional Resources","item":"https:\/\/ephesoft.com\/docs\/products\/transact\/install-and-upgrade\/additional-resources\/"},{"@type":"ListItem","position":5,"name":"Windows","item":"https:\/\/ephesoft.com\/docs\/products\/transact\/install-and-upgrade\/additional-resources\/windows\/"},{"@type":"ListItem","position":6,"name":"Multi-Server Deployment over Multiple Regions"}]},{"@type":"WebSite","@id":"https:\/\/ephesoft.com\/docs\/#website","url":"https:\/\/ephesoft.com\/docs\/","name":"Ephesoft Docs","description":"Intelligent Document Processing Made Easy","potentialAction":[{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https:\/\/ephesoft.com\/docs\/?s={search_term_string}"},"query-input":"required name=search_term_string"}],"inLanguage":"en-US"}]}},"comment_count":0,"_links":{"self":[{"href":"https:\/\/ephesoft.com\/docs\/wp-json\/wp\/v2\/docs\/31639"}],"collection":[{"href":"https:\/\/ephesoft.com\/docs\/wp-json\/wp\/v2\/docs"}],"about":[{"href":"https:\/\/ephesoft.com\/docs\/wp-json\/wp\/v2\/types\/docs"}],"replies":[{"embeddable":true,"href":"https:\/\/ephesoft.com\/docs\/wp-json\/wp\/v2\/comments?post=31639"}],"version-history":[{"count":0,"href":"https:\/\/ephesoft.com\/docs\/wp-json\/wp\/v2\/docs\/31639\/revisions"}],"up":[{"embeddable":true,"href":"https:\/\/ephesoft.com\/docs\/wp-json\/wp\/v2\/docs\/44681"}],"next":[{"title":"OpenLDAP: Separate Installation","link":"https:\/\/ephesoft.com\/docs\/products\/transact\/install-and-upgrade\/additional-resources\/windows\/openldap-separate-installation\/","href":"https:\/\/ephesoft.com\/docs\/wp-json\/wp\/v2\/docs\/46287"}],"prev":[{"title":"Multi-Server Deployment","link":"https:\/\/ephesoft.com\/docs\/products\/transact\/install-and-upgrade\/additional-resources\/windows\/multi-server-deployment\/","href":"https:\/\/ephesoft.com\/docs\/wp-json\/wp\/v2\/docs\/31641"}],"wp:attachment":[{"href":"https:\/\/ephesoft.com\/docs\/wp-json\/wp\/v2\/media?parent=31639"}],"wp:term":[{"taxonomy":"doc_tag","embeddable":true,"href":"https:\/\/ephesoft.com\/docs\/wp-json\/wp\/v2\/doc_tag?post=31639"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}