This upgrade makes no changes to the cdrs, so "enswitch upgrade" should run quickly even on large systems.
Before upgrading
- Review the functional changes, and ensure that none will cause problems.
- If running MySQL 8.x, check that its server configuration files do not include the "STRICT_TRANS_TABLES" value for the "sql_mode" option, because it will cause runtime failures in some Enswitch functionalities.
- If the database or some of its tables use the "latin1" character set, change it to "utf8mb4".
To upgrade
- On all machines, check out /opt/enswitch/4.3.
- On all machines, update the /opt/enswitch/current symlink.
- On all web machines running Debian or Ubuntu:
- apt install libatk-bridge2.0-0 libxkbcommon-x11-0 libxcomposite1 libxdamage1 libjson-webtoken-perl libxrandr2 libgtk-3-0 libgbm1
- curl -sL https://deb.nodesource.com/setup_12.x -o /tmp/nodesource_setup.sh
- bash /tmp/nodesource_setup.sh
- On all web machines running CentOS, Redhat Enterprise, or Fedora:
- yum install atk at-spi2-atk gtk3 libdrm libXcomposite libXdamage mesa-libgbm
- cpanm JSON::WebToken
- curl -sL https://rpm.nodesource.com/setup_12.x -o /tmp/nodesource_setup.sh
- bash /tmp/nodesource_setup.sh
- On the primary web machine:
- cp /opt/enswitch/current/install/etc/crontabs/web /etc/cron.d/enswitch_web
- On the primary database machine:
- enswitch upgrade
- On all machines:
- enswitch restart
- Test calls and the web interface.
- On the primary database machine:
- enswitch after_upgrade