The Zulu 3 server is backward compatible with Zulu Desktop Client versions 1 and 2 which should ease the transition and allow users to gradually move to the new release. To install the new version of Zulu Server, please follow the steps below:
Before You Begin
If you are using Zulu Server versions ABOVE 22.214.171.124.2 or 126.96.36.199.2, the steps below can be done after the Zulu Server Module is installed
Zulu does not work with FreePBX or PBXact self-signed certificates. To use Zulu, please configure a valid certificate in the Certificate Manager, using the instructions in the Certificate Management User Guide.
- Login to the UI of your PBX
- Browse to Settings, Advanced Settings
- Change Display Readonly Settings to YES
- Change Override Readonly Settings to YES
- Search for Enable the mini-HTTP Server and change it to YES
- Search for Enable TLS for the mini-HTTP Server and change it to YES
- Search for Force WebSocket Mode and change it to PJSIP
Search for Enable the Asterisk REST Interface and change it to YES
Search for SIP Channel Driver and change it to BOTH only if it's previously set to chan_sip
Browse to Admin, Certificate Management
ensure you have at least one certificate and that there is a default certificate selected (green check)
Browse to Settings, Asterisk SIP Settings, PJSIP tab
enable both "and "
Click Submit and Apply Changes
After completing this step, SSH to your PBX and issue the following:
The commands below will restart core pieces of your PBX when there are no calls on the system (which may take some time):
To restart immediately please run the following, but NOTE that you will lost any existing calls running the command below. The commands below will restart core pieces of your PBX, so please do this after hours or during a scheduled maintenance window.
At this point Asterisk is running, PJSIP modules are loaded and ws/wss transports are bound, which you can confirm with:
If the above gives an error instead of the transports shown above, then there is still an issue with enabling PJSIP. Browse to Admin, Asterisk Modules and delete res_pjproject.so from the Excluded Modules tab (expand list if necessary). Then restart Asterisk and do the same test again to confirm PJSIP is loaded and ws/wss transports are enabled.
SSH to your PBX
Then run the following to install Zulu Server:
It's possible that you may receive the following message:
If this occurs please run the following:
It is also possible in rare cases when upgrading from earlier Zulu versions, that the install will fail with text like the following:
If this occurs, purge the Zulu tokens by doing the following:
If your Zulu 3 client can successfully login and make calls, but can't receive calls and you see this error on the Asterisk console
You can resolve by restarting Asterisk from the bash prompt with "fwconsole restart" (without quotes)