Page MenuHomePhabricator
Diviner AG Projects RTC Platforms Obtaining/Requesting support

Obtaining/Requesting support
AG Projects RTC Platforms (Support Guides)

This guide describes how to obtain support if there is a problem.

AG Projects provides support via its ticketing system available at: http://support.ag-projects.com

To open a ticket you must have a login account on AG Projects support system. You need a support contract from AG Projects before opening a ticket. If you already have a support contract and login account you can create sub-accounts for your team members. Use the sub-accounts to login and open support tickets. The Operator must be able to provide remote access to equipment(s) where the problem occur and must provide remote hands and eyes at the facility when necessary.

The person that opens the ticket must have good understanding about how the platform works.

How to Open a Ticket

In order to receive prompt and accurate support from AG Projects, please describe a single problem per ticket. Do not mix multiple problems in one ticket.

The ticket must contain minimum the following information:

  1. What is the problem, describe it as accurately as you can
  2. Where the problem occurs - specify the SIP Account, Internet Address, URL or the hostname of the machine that exhibit the problem. In case of failed calls, please specify the Call Id, see the Failed Calls section below
  3. When the problem happened, the date and time, if the problem is still in progress and how it can be reproduced (when possible)

To speed up the process, please paste relevant information from the syslog of the machine where the problem occurs.

Failed Calls

If you have a problem with failed SIP sessions through the platform use CDRTool application follow this procedure:

  1. Find the call detail record (a.k.a. CDR) of the failed session in CDRTool application. The CDR contains the SIP Call Id and links to the SIP trace and media trace of the session. Save the CDRTool query by giving it a name in the results screen.
  2. Locate the SIP session in /var/log/syslog or the journal of each machine involved (SIP Proxy, Call Control, Media Proxy, CDRTool rating engine). To locate the lines in the log belonging to a session you can use grep command and the SIP Call Id learned above as search key. Read the log above and below the found log lines they usually provide clues about the failure reason.
  3. Open a ticket in AG Projects support system and provide the link to the failed session saved previously.

The CDRTool application for SIPThor Net runs at https://mdns.sipthor.net/CDRTool/

book-general-sip-platform-cdr-search (527×1 px, 108 KB)

book-general-sip-platform-cdr-detail (418×1 px, 138 KB)

SIP Trace

Each successful CDR has a SIP trace associated with it. The trace is available by clicking on the CDR id in the result screen of CDRTool search.

SIP trace can be turned on and off by controlling OpenSIPS:

/etc/init.d/opensips siptrace-on
/etc/init.d/opensips siptrace-off

book-general-sip-platform-sip-trace (791×1 px, 226 KB)

The trace information is stored by default in opensips.sip_trace table. Purging this table is a disc-access intensive operation during which the server will act slower than normal. Purge operations must be done during a maintenance window with no SIP traffic. Do not purge the file using an SQL query that selects by date, such a query will take long time to execute on a large table, during such query the server cannot access the database anymore.

Media Trace

Each successful SIP session has information about the RTP media associated with it. The trace is available by clicking on the CDR id in the result screen of CDRTool search.

book-general-sip-platform-cdrtool-media-trace (687×743 px, 66 KB)

DNS Lookups

Use dig command in a UNIX console to check if the DNS servers part of the platform are responding to queries.

Syslog

All platform software log relevant messages to /var/log/syslog and optional additional files. Please always monitor these files when searching or troubleshooting a problem.

Network Sniffers

If the problem is not captured by the high-level tools described above use:

  1. ngrep
  2. tcpdump

to isolate the network traffic in question.

Next Steps

Continue by: