WMS Settings menu:
- Tools and utilities
Set up the connection between Master and Slave PBXs.
In case the PBXs are remote and communicate via Internet, forward to the Master the ports 443 TCP and 1194 UDP on the router of the Master PBX.
- PBX mode: Master or Slave
- Master PBX IP: WAN IP address or *.wildixin.com domain name of Master PBX (only for Slave)
- Sync configuration port: communication port for sync of configuration (only for Slave)
- VPN port: communication port of WMS protocol (only for Slave)
- MTU: the size of the largest protocol data unit that the can be passed on VPN (MTU = maximum transmission unit)
- Login: user name (must be the same on Master and Slave)
- Password: password (must be the same on Master and Slave)
- Update parameters: updates the parameters after they have been changed
- Start activates the sync between the PBXs (first start the sync on Master, then on Slaves)
- Stop stops the configuration sync for this PBX
- Re-initialize slave restarts the connection (only on Slaves)
Master configuration example:
Slave configuration example:
Set up and select the backend used for CDR storage
Step 1. Enable connection to the database.
The tabs “CDR MSSQL”, “CDR MySQL”, “CDR Sqlite” and “CDR CSV” allow you to enable connection to a local or an external database for saving CDR. All the four storage modes can be enabled at the same time.
For WGW90 and bigger models, use external database MSSQL or MySQL.
CDR Sqlite (local storage on USB device) is not available for PBX models bigger than WGW40.
CDR CSV allows you to save CDR to a temporary CSV file, which is saved till the next PBX reboot or to a storage device (network share).
Example of MSSQL/MySQL configuration:
- Enabled: Check the box to enable the backend
- Hostname: The name or the IP address of the remote server
- Database name: The existing database where the CDR must be saved
- CDR Table name: The name of the table that the PBX creates on the remote database
- User: The user to access to the server
- Password: The password to access to the server
- Port: specify the port used
Step 2. Select the backend for CDR storage.
The first tab “CDR Settings” allows you to select the backend used for displaying CDR statistics. You can choose only one backend.
- CDR-backend: choose the backend for saving CDR
- Enable contact notes: enables the Notes feature of Wildix Collaboration.
- Save chat history: enables centralized management of chat history (beta version); if disabled chat is saved locally
- Tags: enables usage of tags; tags can be set via Dialplan (see Dialplan applications manual) and managed via Coallaboration (see Collaboration manual)
General PBX parameters and parameters for the voice transport.
- Auto discover external IP address: if enabled, uses DynDNS url to discover the external IP
- DynDNS website url: url of the service to discover the external IP
- External IP address: external IP address manually set up
- External secure port (Default 443): option to use a different port for TLS connections
- Language: select the PBX language
- Default music on hold: select default music on hold
- RTP start port / RTP end port: set up the port range out of which the RTP ports are dynamically taken, normally 10 000 : 15 000
- Outgoing registration timeout (seconds): set up timeout for SIP registrations on the PBX, for stable connections it’s better to augment this value to reduce the network traffic
- Jitter buffer (min / average / max delay): set up the jitter buffer delay values
- RTP / T.38 ToS / DSCP and SIP ToS / DSCP: optimal values are set up by default for these parameters and should be changed only if necessary
- Use TLS / SRTP for local devices:* TLS is by default ON for remote devices, here you can enable/disable TLS/SRTP encryption also for local devices
- Require provisioning password in local networks: when enabled, the system does not provision those devices whose passwords are different from the passwords present on Devices page (default passwords are given to devices during reset procedure)
- Auto add new devices in local networks: when enabled, devices are added and provisioned automatically in local networks
- Enable wideband codec usage in LAN:* enabled by default, the system uses G.711 codec in local network (IP classes specified in “Network field which must be considered local”)
- Networks where force usage of wideband codecs:* if the usage of wideband codec is disabled, it’s still possible to force its usage on some networks
- Custom Direct RTP Subnets: the networks that are considered local by the PBX and on which the wideband codec usage is forced
- TLS Certificate (*.crt): upload a TLS certificate file
- TLS Private Key (*.key): upload a TLS private key file
* In case of changing these parameters, it’s necessary to make “configure/sync” of all the devices.
Enables the integration with QueueMetrics software.
- Remote queues logging: enables MySQL remote Queues logging service
- Hostname: IP or host name of MySQL database
- User: the user to access to the server
- Password: the password to access to the server
- Database name: the name of the database
Set up the network parameters based on the selected network scenario: you can keep the data and voice networks separated or shared.
- Shared data and voice networks: the single connected port is eth0, IP address is received from the DHCP server.
WAN eth0 gets the address from DHCP server, LAN eth1 interface is inactive:
- Data and voice networks are separated: the PBX itself functions as a DHCP server. Eth0 port is configured as DHCP client, eth1 port must be set up with the static IP and DHCP server enabled. The default address of the eth1 port is 10.135.0.1.
WAN eth0 interface gets the address from DHCP server:
LAN eth1 interface – static:
After you have changed the network settings, click “Apply network settings” to apply the new parameters.
- + Virtual: add a virtual interface to be able to assign more than one IP to a physical interface
- + Vlan: add an interface with VLAN settings
- Enable routing eth0: enables devices connected to other interfaces to use the data connectivity of the PBX (WAN port)
- Enable traffic shaper eth0-eth2: creates a bridge between the two interfaces and gives a higher priority to the data traffic coming from eth0
- “-” button: delete the selected virtual interface
- Edit: edit the settings of a selected interface (IP, subnet, status)
Routing and gateways
If the PBX’s WAN interface is connected to the network with the active DHCP server, the entry is automatically created in this table, containing the gateway assigned by DHCP server
- “+” button: add a new interface
- “-” button: delete a selected interface
- “Edit”: edit the settings of a selected interface
Hosts, DNS server and System name
Here you can modify the DNS server and System name.
“System name” is used as the PBX alias name – *.wildixin.com domain name.
Each PBX with Public IP can be accessed by either its serial number of by the value set up in “System name”:
Note: Value set up in “System name” is synced with the one set up in WMP > PBX Details > “Name”.
HTTP proxy client
Allows you to enter the data for connection to a proxy server.
- Enable HTTP proxy for Support VPN: this option allows you to activate remote support and connection to Wildix server in case HTTP proxy is used
- Proxy host: IP address of the proxy server
- Port: listening port of the proxy server
- Proxy authentication method: authentication method used by server
- Login: user name (if required by authentication method)
- Password: password (if required by authentication method)
Set up connection to LDAP server and Radius server. This feature allows you to use a PBX as an LDAP server for users sync.
- Enable external connections to LDAP/Radius: enables access for connections external to the PBX
- Allowed host(s): security parameter allowing access only to the sunbnets entered here (e.g.: 192.168.0.0/24, 10.0.0.0/8); when using Overlay solution, enter here the IP of the Overlay Core
- Password: allows you to set up a password for connection to the server
If the chosen network scenario uses the service of the DHCP server of the PBX, make sure that the options of the service are enabled with the correct settings.
DHCP server is integrated for auto provisioning of supported devices. It’s possible to enable the server for the initial configuration of the devices and successively disable it, otherwise to enable the parameter “Deny unknown clients”.
- Enable DHCP server at boot time: enables internal DHCP server and allows you to select the interface on which the server is enabled (normally eth1)
- must be more than / must be less than: range of IP addresses that can be assigned to hosts
- Default lease time (mins): minimum time period for lease duration
- Maximum leases: maximum number of leases that can be assigned
- Domain name suffix: if the hosts are inserted in the network which is managed by the domain controller
- Default gateway: IP address of the router or of the PBX (in case of LAN interface)
- Primary / Secondary DNS server: addresses of DNS servers
- Primary /Secondary NTP Server: addresses of NTP servers
- Primary / Secondary WINS Server: addresses of WINS servers
- Deny unknown clients if enabled, IP addresses are not automatically assigned to unknown hosts
All the IP addresses which DHCP server has assigned to devices, appear in this table
- “-” button: delete a lease
- Edit: allows you to set up this IP address as static
- Purge leases: this option releases the previously assigned addresses
SMTP client enables the PBX to send notifications of the new voicemails, missed calls, chat requests, call recordings, faxes, etc.
- Email from: address to be used by PBX to send emails
- SMTP mail server: server’s postal address used by the company
- Port: listening port of the SMTP server
- User: user name to access the server
- Password: password to access the server
- HELO domain: domain defined for sending emails. Default value is “localhost”, change it in case anti-spam filters of the SMTP server block sending the message
- Enable TLS: TLS protocol enabled for the security of the connection to the server
- Enable STARTTLS: STARTTLS option enabled if provided by SMTP
To make sure that the entered parameters are correct, select the SMTP profile and click “Test”.
You receive a test email:
Allows you to enable Mail2Fax and Mail2SMS services and specify the general parameters for FAX/SMS management.
- Send a copy of sent and received faxes and sent SMS to this e-mail: this option allows you to enter an email address to which all the incoming and outgoing faxes are saved
- Standard SMS header: allows you to enter the header for SMS messages sent by PBX
- Remote PBX (for SMS sending): allows you to select the PBX in WMS Network to send SMS messages
- Fax delivery notification: allows you to enable fax delivery confirmation notification
FAX/SMS server parameters:
The PBX checks the mailbox, once new emails corresponding to the parameters of Mail2Fax service are found, the PBX sends them to the destination fax number(s) present in the email.
- Name: enter the profile name (identifier)
- Protocol: select the protocol of communication with your email server (POP3 or IMAP)
- Server: settings of your email server to access incoming messages
- Use SSL: enables secure connection to the server (required by some email servers)
- User: email address of user to access to the server
Note: don’t use here an email of a user who must send faxes via Fax2Mail service
- Password: password to access to email address of user specified in the field above
- Keep e-mails and faxes on server: enables storing of messages on the server
- Dialplan procedure: select the Dialplan procedure to manage
- Protection password: security password for MAIL2FAX service
- Default LOCALSTATION: sender’s fax machine ID, appears at the top of each page of outgoing fax, if not specified the default value “Fax Server” is used
- Default LOCALHEADER: fax header to identify the sender, appears at the top of each page of outgoing fax, if not specified the default value “Wildix PBX” is used
Click “Save” to apply the settings and to close the profile.
Select the profile from the list and click “Test fetching faxes” to make a test and check if the entered parameters are correct.
Start the SNMP server integrated into the PBX to allow remote monitoring of system resources.
- SNMP Server: enables the access to the SNMP server
- Community: server identifier
- Port: external port of access
- Trusted IP: list of the clients that can connect
Configure a backend to store all the data of the PBX (Voicemail, call records, faxes, CDR, backups, etc).
For an on-premise PBX, the USB drive inserted into the PBX serves as a backend for storing all the data. It is recommended to store the Backups on another USB drive or on a Windows share, to be able to restore the system in case of the primary USB drive’s failure.
This table displays all the storage devices mounted at the system startup with the relative table of the partitions and the usage of the specified partition.
Click “Initialize” to start the partition and formatting procedure of the storage device.
Click “Add” to add the partition for each service.
Click “Remove” to remove a selected partition.
Click “+” to add a new Windows share
- Server windows host: IP address or host name of the server
- Windows Share: name of the Windows share created at the host
- Windows domain: domain name of the host machine
- User name: user name to access to the resource
- Password: password to access to the resource
- Service: select the service to be saved to the Windows share
Click “+” to add a new NFS share
Synchronize the PBX with an external NTP server.
- Synchronize time with servers: enables the sync
- Primary NTP server: enter the primary server address
- Secondary NTP server: enter the secondary server address
- Time zone: select the time zone
In case the sync with an external NTP server is disabled, it is possible to manually enter the time and date (not recommended)
Tools and utilities
Displays the information about the the Wildix server, which is used for remote support and the PBX sync with the Wildix Management Portal.
Firewalls that limit the Internet access to the PBX should allow the traffic to wmp.wildix.com and vpn2.wildix.com on the 443 TCP and 1194 UDP ports.
Create and download the system backup and set up a scheduled system backup.
Backup system tab allows you to create the copies of PBX configuration on the Windows share or on the USB storage device (defined in System > Storages), otherwise the backup can be created and downloaded directly on your PC
- Generate and download backup: generates a copy of the backup file and saves it to your PC
- Generate backup: generates a copy of the backup file and saves it on the storage device
- Generate and download sounds backup: generates a backup copy of all the sounds saved on the PBX. The backup of the configuration does not contain all the sounds that can be saved after the first modifications to a separate file.
- “-“ button: deletes the selected backup
- Apply backup: configures the PBX using the selected backup file
- Download: starts the download of the file in the browser
- Select file / Upload allows selecting the backup file on your PC and uploading it (it is useful for restoring the backups generated by other PBXs)
- Reset: restores PBX to the default configuration
The Scheduled backups tab allows setting up a scheduled backup to share, FTP or email (daily, weekly, monthly).
Check if there is a new version available and perform the upgrade.
Note: to perform the upgrade the PBX must be able to connect to the remote server wmp.wildix.com (via http).
- Enter the name of the repository (rel380) into the field “Upgrade repository” and click “Save”
- Wait till the system checks whether there is a new version available in the selected repository.
- In case there is a new version available, click “Perform upgrade”. Click “Yes” in the popup window.
As a rule, the Upgrade procedure takes several minutes (however it depends on your Internet connection and the number and volume of packages that must be downloaded).
As soon as the PBX is ready, the button “Reboot” appears:
- Click “Reboot” and wait till the WMS access link appears:
Click the link “Access the WMS interface”.
The current WMS version is shown in the upper right part of the screen.
Activate PBX and Wildix licenses.
Activate PBX and licenses from Wildix Management Portal, after which click the button “Refresh via Internet” from WMS to complete the activation procedure.
In case you have no Internet connection at the moment, it is possible to generate the license file on WMP portal and then upload it manually on the PBX, and enter the License and the activation code on this page.
Generate a *.pcap trace which allows you to debug and analyze problems with VoIP traffic.
There are several ways to generate a trace:
- Tick off “IP Address” and leave the input field empty
This option allows you to capture all the traffic passing through the PBX interfaces
- Tick off “IP Address” and enter the host address
This option allows you to capture all the traffic passing to or from a specified host.
- Tick off “Custom tcpdump” and specify the interfaces, the ports and the hosts in the input field.
After you have selected the way to generate a trace, enter the Trace name and click “Start”
When finished, click “Stop”. You can start a trace and continue navigating other menus of the MWS.
Open the trace with Wireshark program.
Please find more information on using *.pcap trace generation feature in THIS GUIDE to debugging and troubleshooting VoIP problems.