This procedure describes the process required to update the jtel system, assuming a MySQL server 8.0.x and portal release 3.23 or above.
Running Commands
| Info |
|---|
All of the commands on this page are designed to be run by the jtel user. |
Backup
| Warning |
|---|
Always have a way back. Remember to backup your system before updating. |
...
| Machine(s) | Stop what | It is installed if you are using | How to stop |
|---|---|---|---|
| Telephony Servers | 8-Server | ACD / IVR | X the cmd file starter window. For service installations, stop the robot5 service. |
| Platform UDP Listener | ACD / IVR | X the cmd file starter window. For service installations, stop the jtel Platform UDP Listener service. | |
REST API | REST | X the cmd file starter window. For service installations, stop the jtel jrest service. | |
| Presence Aggregator | A PBX or presence connector which uses the presence aggregator:
| X the cmd file starter window. For service installations, stop the jtel Presence Aggregator service. | |
| Telephony Connector | A PBX which uses a custom connector:
| X the cmd file starter window. For service installations, stop the service, for example the jtel TAPI service or jtel Innovaphone Service. | |
| Web Servers | Wildfly | Anything | sudo systemctl stop wildfly For installations not using systemctl: sudo service wildfly stop |
| Chat Servers | Chat Server | CHAT | sudo systemctl stop jtel-clientmessenger For installations not using systemctl: sudo service jtel-clientmessenger stop |
| DB Servers | Platform UDP Listener | SOAP | sudo systemctl stop jtel-listener For installations not using systemctl: sudo service jtel-listener stop |
Pull the
...
Updates
Pull the updates as follows:
JTEL
| Code Block |
|---|
cd /srv/jtel/shared/JTEL
git pull |
JTELCarrierPortal
| Code Block |
|---|
cd /srv/jtel/shared/JTELCarrierPortal
git pull |
Checkout the Release
Checkout the required release as follows:
| Code Block |
|---|
cd /srv/jtel/shared/JTEL
git checkout release/stable-3.28
cd /srv/jtel/shared/JTELCarrierPortal
git checkout release/stable-3.28 |
Check for a Customer Directory
Check if there is a customer directory with customised software.
This will be in /srv/jtel/shared and will resemble the customer name. For example, for jtel it might be cjtel-software.
Remember the directory name - you will need it in the next step.
Note: recommend you do not mess with this directory, unless you are the author of the directory contents.
Get the new Binaries and Run the Update Script
Run as follows:
| Code Block |
|---|
cd /srv/jtel/shared/JTELCarrierPortal/Update
bash ./get_binaries.sh
sudo bash ./update_release.sh |
You will be asked for the following:
| Question | Answer |
|---|---|
| [sudo] password for jtel: | The jtel user password |
| mysql host address: | acd-dbm For redundant installations only: acd-dbm1 or acd-dbm2, depending on which is active |
| mysql user name: | root |
| mysql password: | The MySQL root password |
| customer directory: | The customer directory from above, or just ENTER if none is present. |