Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Last
Sv translation
languageen


Warning
titleUnder Construction

This site is currently under construction. Contained Information is subject to change.

Introduction

A jtel ACD consists of a minimum 2 of virtual machines and may grow to sizes of 30 or more, in concurrence with for example redundancy or performance requirements. Based on a systems architecture, there are certain dependencies between the services, so a clean startup and shutdown is required and only done in a certain order to prevent problems during and after startup. The following page describes the various possible scenarios for proper shutdown and startup procedures, depending on the systems architecture. 

Info
titleOn Premise

Caution for on premise jtel ACD systems:

Shutting down and starting the virtual machines of your jtel ACD back is not part of the jtel service contract and may incur service fees as a result. For further information, or to book a service appointment, please contact us at service@jtel.de 

Page Layout

This page is split into three rows, each named after a different type of sizing. The sizing variants are Small, Medium and Large  

General

Info

The Hostnames of an ACDs jtel virtual machines may not be in concurrence with the aliases displayed below.


AliasSignifiesShutdown PriorityStartup Priority
acd-dbmDatabase MasterThirdThird
acd-dbm1First Database MasterThirdThird
acd-dbm2Second Database MasterThirdThird
acd-dbsDatabase SlaveSecondFourth
acd-dbs1First Database SlaveSecondFourth
acd-dbs2Second Database SlaveSecondFourth
acd-dbrReporting DatabaseSecondFourth
acd-lbThe Load BalancerFourthSecond
acd-lb1First Load BalancerFourthSecond
acd-lb2Second Load BalancerFourthSecond
acd-storeThe File StorageLastFirst

acd-tel1
...
acd-telN

The Telephony Machine(s) Numbered from 1 ... NFirstLast

acd-jb1
...
acd-jbN

The Webserver Machine(s) Numbered from 1 ... NFirstLast
acd-apiThe REST-APIFirstLast
acd-chatChat and or WhatsAppFirstLast
acd-chatbotChatbot FirstLast

Dependencies

All services of the platform are dependent on two central entities:

  • The Storage(s)
  • The Database(s)

To boot the solution, the storage should always be booted first. If this is external to the solution, continue with the next step. Otherwise, the computer (or in case of redundancy - both computers) is started on which the storage is located. This is usually the load balancer, but for larger systems a separate storage machine could have been implemented. Afterwards, the master database is booted. As soon as its is finished, the slave can be started up. Finally, the telephony servers and web servers can be started up in any order, even simultaneously.

Small V1

Machine
Steps 1 to NShutdownStartup
1acd-tel
First
acd-store/lb/dbm/dbs/dbr/jb
2acd-store/lb/dbm/dbs/dbr/jb
LastFirst
acd-tel

Small V2

Machine
Steps 1 to N
ShutdownStartup
1acd-tel
First Last
acd-store/lb/jb
2acd-dbm/dbs/dbr
SecondSecond
acd-dbm/dbs/dbr
3acd-store/lb/jb
LastFirst
acd-tel

Small V3

Machine
Steps 1 to NShutdownStartup
1acd-tel
FirstLast
acd-store/lb
2acd-jbN
First
acd-dbm/dbs/dbr
3
Last
acd-dbm/dbs/dbr
Second
acd-jbN
Second
4acd-store/lb
/
LastFirst

Start Up

Order

A non-redundant solution is assumed in the following. The operation of a redundant solution requires extra schooling.

This results in the following starting order:

  1. Storage (Separates Storage acd-store or Load-Balancer acd-lb). 
    Wait until Storage is up.
  2. With separate storage, now start the load balancer acd-lb.
    There is no need to wait here.
  3.  acd-dbm - Database Master .
    Wait until DB-Master is up.
  4.  acd-dbs -  Database Slave- .
    Wait until DB slave is up.
  5. Boot acd-jb1 ... acd-jb(x) aswell as acd-tel1 ... acd-tel(x)

Checks

  1. Log on to the Web via the load balancer. 
    1. Log on OK?
      If Not, check /home/jtel/jboss-(version)/standalone/log/server.log
    2. ESSENTIAL: Logo visible in the web application?
      If not, the storage is not up. Check with mount on the web servers. If necessary restore mount /home/jtel/shared Mount.
  2. Call System.
    1. Calls are put through?
      If not, check the telephony server.
      Look for red messages in the telephony server and act accordingly.
    2. Calls are signalled in the Agent Home or Mini Client?
      If not, check the Hazelcast cluster (PlatformListener for telephony and web server).

Shutdown

Order

Shutting down is done in the reverse order:

  1. Shutdown All Webservers acd-jb1 ... acd-jb(x) and Telephony servers acd-tel1 ... acd-tel(x) 
    Finish step or make sure that the computers are really shutting down before continuing.
  2. Shut down database slave acd-dbs.
  3. Shut down database master acd-dbm.
  4. Shut down load balancer acd-lb.
  5. For separate storage, shut down acd-store.

It is not absolutely necessary to wait between the individual steps, just step 1 should be completed before continuing.

Medium V1

MachineShutdownStartupacd-telFirstLastacd-jbNFirstLastacd-dbs/dbrSecondSecondacd-dbmThirdThirdacd-store/lb/LastFirst

Medium V2

MachineShutdownStartupacd-telFirstLastacd-jbNFirstLastacd-dbs/dbrSecondSecondacd-dbmThirdThirdacd-lbFourthFourthacd-storeLastFirst
acd-tel


Shutdown Dependencies for Small, Medium and Large systems

Small V1

The two computers should be shutdown in the correct order. You do not have to wait until acd-tel is shutdown fully before starting the shutdown on acd-store/lb/dbm/dbs/dbr/jb, but the order should be kept anyhow.

Small V2

First shutdown acd-tel. You do not have to wait until acd-tel is down before starting the shutdown at acd-dbm/dbs/dbr. Wait for acd-dbm/dbs/dbr to be shutdown before starting the shutdown on acd-store/lb/jb.

Small V3

First shutdown acd-tel and acd-jbN in no particular order. You do not have to wait until acd-tel and acd-jbN are down before starting the shutdown at acd-dbm/dbs/dbr. Wait for acd-dbm/dbs/dbr to be shutdown before starting the shutdown on acd-store/lb.

Medium V1

First shutdown acd-tel and acd-jbN in no particular order. You do not have to wait until acd-tel and acd-jbN are down before starting the shutdown at acd-dbs/dbr. Wait until acd-dbs/dbr is shutdown before starting the shutdown on acd-dbm. Wait until acd-dbm is shutdown before starting the shutdown on acd-store/lb.

Medium V2

First shutdown acd-tel and acd-jbN in no particular order. You do not have to wait until acd-tel and acd-jbN are down before starting the shutdown at acd-dbs/dbr. Wait until acd-dbs/dbr is shutdown before starting the shutdown on acd-dbm. Wait until acd-dbm is shutdown before starting the shutdown on acd-lb. Wait until acd-lb is down before starting the shutdown on acd-store

Large V1

When shutting down a redundant database architecture, the inactive machines are shutdown first. Therefore, before a shutdown procedure can begin, the active machines must be known. The table at Large V1 assumes that acd-XXX is currently the active master database and displays the shutdown procedure according to that.

Large V2

When shutting down a redundant load balancing architecture, the inactive machines are shutdown first. Therefore, before a shutdown procedure can begin, the active machines must be known. The table at Large V2 assumes that acd-XXX is currently the active load balancer and displays the shutdown procedure according to that.

Large V3

When shutting down a redundant storage architecture, the inactive machine is shutdown first. Therefore, before a shutdown procedure can begin, the active machine must be known. The table at Large V3 assumes that acd-XXX is currently the active load balancer and displays the shutdown procedure according to that.