Webitel: Documentation

Upgrade Notes 25.04-25.05

Before the update begins

Ensure to back up the database prior to starting the update!

Update Algorithm

  1. Complete shutdown of all Webitel services.

  2. Update Webitel applications to v25.05.

  3. Migrate the database from Webitel v25.04 to v25.05.

  4. Restart all services after updating to Webitel v25.05.

Full stop of all Webitel services:

Bash
systemctl stop webitel-api webitel-app webitel-uac messages-bot messages-srv \
  engine call_center storage flow_manager rabbitmq-server webitel-logger webitel-cases \
  consul freeswitch ngcp-rtpengine-daemon opensips grafana-server nginx

Updating Webitel applications to v25.05:

Bash
sed -i 's/25.04-releases/25.05-releases/g' /etc/apt/sources.list.d/*

apt update
apt upgrade

Migrating the database from Webitel v25.04 to v25.05:

Bash
su postgres
cd ~
psql webitel -qxc "ALTER DATABASE webitel SET timescaledb.restoring='on';"
psql -1 -f /usr/share/postgresql/15/webitel/migration/25.04-25.05.sql webitel
psql webitel -qxc "ALTER DATABASE webitel RESET timescaledb.restoring;"
exit

Cleaning up old packages:

Bash
apt --purge autoremove

Editing the file /etc/systemd/system/storage.service

Remove the line:

-translations_directory /usr/share/webitel/storage/i18n \

Replace it with the line:

-message_broker_url amqp://webitel:webitel@127.0.0.1:5672?heartbeat=10 \

Execute:

systemctl daemon-reload

Restarting all services after upgrading to Webitel v25.05:

Bash
systemctl restart consul
systemctl restart postgresql
systemctl restart rabbitmq-server

rabbitmqctl list_queues | awk '{ print $1 }' | xargs -L1 rabbitmqctl delete_queue

systemctl restart webitel-app webitel-uac webitel-api engine \
  messages-srv flow_manager messages-bot call_center storage webitel-cases webitel-logger \
  freeswitch ngcp-rtpengine-daemon opensips grafana-server nginx