The Diagnostics tools give you views of the call activity in Switchvox and help you evaluate potential problems:
This tool displays Connection Status information for the following entities connected to Switchvox:
- VOIP Providers
- SIP Phones
- Hardware Devices
- Fax Print Jobs
This tool lists the following information for each VoIP provider:
- Name of the provider as entered when the provider was created
- Host that Switchvox connects to when registering and sending calls
- Account ID
- Callback Extension that incoming calls are sent to by default
- Latency (ms)
- State of the connection. This value is Registered when the system is operating properly. If it is not, outgoing calls will fail and incoming calls cannot be received. Here are some common reasons a VOIP provider is in a non-registered state and a resolution:
- VOIP provider has just been entered and the registration has not finished yet. Wait a few minutes and then refresh the page.
- Username or password are incorrect. Check to make sure you have entered them correctly.
- Firewall is not allowing the communication between Switchvox and your provider to flow freely. When you use a SIP-aware firewall, it recognizes the data being sent back and forth. A normal router does not require any special configuration, but a SIP-aware firewall does. Contact the manufacturer of the firewall for details on setting up any necessary routing rules.
This tool lists all phone Extensions with their respective Caller ID, User Agent, IP Address, and Phone State.
- Phone States. The following are possible phone states:
- Registered. This indicates the phone is configured properly and is on the network.
- Timeout: This indicates the phone was registered at some point, but the server no longer recognizes it and does not send calls to this phone anymore.
- Unreachable. This indicates the phone is not registered with Switchvox.
If a phone is not registered but it should be, check the following:
- The phone should be set to register every 120 seconds. Some phones are by default set to only register once. See your phone’s user manual for more information about this setting.
- The phone must know the Switchvox IP address, and it must have the same password as the "Phone Password" for the extension. For more information on configuring your phone, see your phone's manual or call your phone's technical support.
- The phone must be ON, its Ethernet cord plugged into the phone and the correct Ethernet jack, and it must be on the same LAN as Switchvox (not on a separate partitioned LAN subnet).
- There should be no firewall between your phone and Switchvox that could block your phone from accessing Switchvox.
NOTE: If a SIP phone is not in a Registered state, click its Diagnose button to run a diagnostic tool for that phone.
- External Phones. Phones are considered External if they are not on the same network as Switchvox. This generally means they have to connect to Switchvox over the Internet, or they are located on a separately partitioned network. External phones cannot go through the full diagnostics because Switchvox does not have direct access to these phones.
- Finding the IP Address of your SIP Phone. To run the diagnostic tool, you need to know the IP address for your phone.
- Polycom Soundpoint IP 300/301/500/501/600/601 Each phone is set up to obtain its IP address via DHCP. You can find the IP address of a Polycom phone by pressing the Menu button on your phone. Then, on the LCD screen of your phone highlight "Status..." and press select and then highlight "Network..." and press select again, then highlight "TCP/IP Parameters..." and press select. Now find the line that starts with "IP:" and write down the IP Address.
- Sipura ATA. Connect a phone to the jack labeled "Phone 1" on the front of your ATA. Then on the phone dial "****" you will then hear a voice say "Configuration Menu". Then dial "110#" and it will read back the IP address of your ATA.
This tool lists all the channels on the hardware devices installed for Switchvox and an alarm state for each.
The state of these channels, if properly connected, should be No Alarm. If any other alarm state is shown (a RED Alarm or a Loss of Signal), check that the device is plugged into the correct line and that you have the appropriate signaling type selected.
This tool lists any peered Switchvoxes with each peer’s Name, Host, Status Details, and available Actions.
This tool is typically used after creating peered Switchvoxes during setup. If Status Details reports any errors, click the Diagnose icon to execute a diagnosis of the Peered Switchvox. This lists the tests performed and the results (Passed, Failed, Not Tested, and Warning) followed by a comment. You can Return to the Connection Status page, make the correction and repeat the Diagnose action.
Fax Print Jobs
This tool lists the current Print Jobs for faxes. These Print Jobs occur when an extension-owner is creating a fax from his or her desktop computer.
This tool lists all current calls. It shows the person who called, the person who took the call, the duration of the call (in seconds), the current state of the call, and the provider. You can select the time interval for refreshing the call list. The default is to
refresh the list every 60 seconds.
To hang up on a call, click Hangup, then click Yes, Hangup.
This tool displays information about the Switchvox server.
This offers information about the health of the Switchvox server. As long as the Current Status for each item is Good, the hardware is fine. If a field is over threshold, it needs immediate attention.
- memory. If memory is over threshold, one option is to turn the system off (wait afew moments), then turn it back on. This normally frees up the memory usage. Another option is to install more RAM. You can also attempt to identify the process that is overloading the memory (call recording, concurrent calls, concurrent conference calls, etc.), and stop that process.
- disk. If disk is over threshold, check voicemail, fax, call recordings, and backups to find out what is taking up the disk space.
- load. If load is over threshold, check Diagnostics > Current Calls to see if the system is hitting a peak (spike) amount of concurrent calls.
- Advanced Server Information. A Switchvox Technical Support representative may ask you check this area for a specific issue. In most cases, you will not need to use this tool.
Disk Usage has two tabs: Disk Usage and Mailbox Usage.
Disk Usage Breakdown tab
Disk Usage Breakdown gives the percentage that the Disk is full and displays a color-coded bar graph showing the amount of disk space taken by the following:
- PBX Software
- Call Recordings
For information about disk-space quotas, see General Settings (Setup > Extensions > Manage > Phone and Virtual Extensions > Profile Information > Advanced Options > General Settings).
Mailbox Usage Breakdown Tab
Mailbox Usage Breakdown
displays Voicemail and Fax usage by extension, including Name, Quota Class, Quota Used, # Of VM, VM Usages, # Of Faxes, and Fax Usage. You can search for an extension by extension number or name.
SNMP (Simple Network Management Protocol) is used to monitor devices on an IP network. If you are not already using SNMP, then you can ignore these settings. If you are already using SNMP, you can monitor the OIDs that the Switchvox agent provides.
IMPORTANT: Be sure to allow SNMP traffic in Switchvox Access Control. (By default, SNMP traffic is not allowed).
- SNMP v1/v2c Community Name. Enter the Community Name for the SNMP community to which Switchvox should belong.
- SNMP v3 User Name. Enter the SNMP User Name if you are using SNMP version 3.
- SNMP v3 Password. Enter the SNMP Password if you are using SNMP version 3.
See the switchvox-mib
file, or use the OIDs below.
The Switchvox prefix is .18.104.22.168.4.1.22736.10
.1 Switchvox Information
.22.214.171.124.4.1.227126.96.36.199 software version
.188.8.131.52.4.1.227184.108.40.206 max concurrent calls
.220.127.116.11.4.1.22718.104.22.168 used feature packs
.22.214.171.124.4.1.227126.96.36.199 max feature packs
.188.8.131.52.4.1.227184.108.40.206 used extensions
.220.127.116.11.4.1.22718.104.22.168 max extensions
.2 VOIP Providers
.22.214.171.124.4.1.227126.96.36.199 number of VOIP providers
.188.8.131.52.4.1.227184.108.40.206 number of state 'Ok' VOIP providers
.220.127.116.11.4.1.22718.104.22.168.1.1 first VOIP provider id
.22.214.171.124.4.1.227126.96.36.199.1.2 first VOIP provider type
.188.8.131.52.4.1.227184.108.40.206.1.3 first VOIP provider name
.220.127.116.11.4.1.22718.104.22.168.1.4 first VOIP provider host
.22.214.171.124.4.1.227126.96.36.199.1.5 first VOIP provider account id
.188.8.131.52.4.1.227184.108.40.206.1.6 first VOIP provider callback extension
.220.127.116.11.4.1.22718.104.22.168.1.7 first VOIP provider latency
.22.214.171.124.4.1.227126.96.36.199.1.8 first VOIP provider state
.188.8.131.52.4.1.227184.108.40.206.[2-xxx].[1-8] details for each additional VOIP provider
.3 Hardware Status
.220.127.116.11.4.1.22718.104.22.168.1 memory used
.22.214.171.124.4.1.227126.96.36.199.2 memory total
.188.8.131.52.4.1.227184.108.40.206.3 swap used
.220.127.116.11.4.1.22718.104.22.168.4 swap total
.22.214.171.124.4.1.227126.96.36.199.5 last update (memory/swap)
.188.8.131.52.4.1.227184.108.40.206.1 disk used
.220.127.116.11.4.1.22718.104.22.168.2 disk total
.22.214.171.124.4.1.227126.96.36.199.3 last update (disk)
.4 Phone Status
.188.8.131.52.4.1.227184.108.40.206 number of SIP phones
.220.127.116.11.4.1.22718.104.22.168 number of reachable SIP phones
.22.214.171.124.4.1.227126.96.36.199.1.1 first phone id
.188.8.131.52.4.1.227184.108.40.206.1.2 first phone extension
.220.127.116.11.4.1.22718.104.22.168.1.3 first phone caller id
.22.214.171.124.4.1.227126.96.36.199.1.4 first phone user agent
.188.8.131.52.4.1.227184.108.40.206.1.5 first phone ip address
.220.127.116.11.4.1.22718.104.22.168.1.6 first phone state
.22.214.171.124.4.1.227126.96.36.199.[2-xxx].[1-6] details for each additional phone
.188.8.131.52.4.1.227184.108.40.206 number of reachable SIP phones
.5 Current Calls
.220.127.116.11.4.1.22718.104.22.168 total current calls
.22.214.171.124.4.1.227126.96.36.199 number of calls in state 'agent_login'
.188.8.131.52.4.1.227184.108.40.206 number of calls in state 'agent_logout'
.220.127.116.11.4.1.22718.104.22.168 number of calls in state 'checking_voicemail'
.22.214.171.124.4.1.227126.96.36.199 number of calls in state 'conference'
.188.8.131.52.4.1.227184.108.40.206 number of calls in state 'directory'
.220.127.116.11.4.1.22718.104.22.168 number of calls in state 'faxing'
.22.214.171.124.4.1.227126.96.36.199 number of calls in state 'intercom'
.188.8.131.52.4.1.227184.108.40.206 number of calls in state 'ivr'
.220.127.116.11.4.1.22718.104.22.168 number of calls in state 'leaving_voicemail'
.22.214.171.124.4.1.227126.96.36.199 number of calls in state 'monitoring'
.188.8.131.52.4.1.227184.108.40.206 number of calls in state 'parked'
.220.127.116.11.4.1.22718.104.22.168 number of calls in state 'queued'
.22.214.171.124.4.1.227126.96.36.199 number of calls in state 'receiving_fax'
.188.8.131.52.4.1.227184.108.40.206 number of calls in state 'ringing'
.220.127.116.11.4.1.22718.104.22.168 number of calls in state 'talking'
.22.214.171.124.4.1.227126.96.36.199 number of calls in state 'unknown'
.6 Telephony Cards
.188.8.131.52.4.1.227184.108.40.206 number of devices
.220.127.116.11.4.1.22718.104.22.168 number of state 'Ok' devices
.22.214.171.124.4.1.227126.96.36.199.1.1 first device id
.188.8.131.52.4.1.227184.108.40.206.1.2 first device name
.220.127.116.11.4.1.22718.104.22.168.1.3 first device channel
.22.214.171.124.4.1.227126.96.36.199.1.4 first device channel group
.188.8.131.52.4.1.227184.108.40.206.1.5 first device signalling
.220.127.116.11.4.1.22718.104.22.168.1.6 first device state
.22.214.171.124.4.1.227126.96.36.199.[2-xxx].[1-6] details for each additional device
.7 Switchvox Subscription
.188.8.131.52.4.1.227184.108.40.206 expire date
.220.127.116.11.4.1.22718.104.22.168 days left
.8 RAID Controller
22.214.171.124.4.1.227126.96.36.199 controller status
188.8.131.52.4.1.227184.108.40.206 logical device status
220.127.116.11.4.1.22718.104.22.168 device #0 status
22.214.171.124.4.1.227126.96.36.199 device #1 status
The Switchvox agent provides some additional OIDs that are not specific to the Switchvox application.
.iso.org.dod.internet.mgmt.mib-2.system Linux system OIDs. You can use any OID under this.
.iso.org.dod.internet.private.enterprises.ucdavis Linux system OIDs. You can use any OID under this.
These tools are for our customer service representatives to help you with problems you might have with Switchvox. You do not need to use these tools unless we ask you to. The tools included here are simple error logs, advanced error logs, and advanced debugging sessions.
We recommend that you do not use this tool unless you are being directed by a technical support representative. These debugging sessions collect detailed PCAP, PRI, or ACLI information to help you see exactly what is happening in Switchvox. The information can be useful in identifying the source of a problem; however, these sessions place an additional load on Switchvox system resources.
These tools are for Switchvox Technical Support representatives to help you with problems that you might have with Switchvox.
IMPORTANT: You do not need to, and should not use these tools unless it is at the request of a Switchvox Technical Support representative.
Technical Support Access lets us access your machine to help diagnose a problem. You must enable Technical Support Access to use the VPN connection. If you disable it, then all access to your system will be closed, including an open VPN connection. A Technical Service Request (TSR) can be downloaded, then sent to Switchvox Technical Support.