Collaboration SRV check

From ip tuning
Jump to: navigation, search
Remember this is a command line tool! If you're using Windows, clicking on the icon will not show anything! Use the command line!

Use this tool to check if the SRV records are properly configured for a domain.

Currently the tool only checks SRV records.

The tool checks both current Cisco and Lync SRV records.

Requirements

  • Pre-compiled binaries exist for Windows
  • If your want to run directly in Perl (Linux, MacOS X, Windows with Perl, etc...):
    • The following modules need to be installed:
      • Net::DNS
      • Text::Table
    • Tested in Windows using http://strawberryperl.com/, MacOS X, Debian and Ubuntu[1] Linux
  • Internet access

Pre-defined SRV records

The tool will check, if not given an SRV record to search, the following pre-define SRV records:

SRV record Description
_sip._tcp SIP TCP
_sip._udp SIP UDP
_sips._tcp Secure SIP TCP
_sips._tls Secure SIP TLS
_sip._tls SIP TLS
_h323cs._tcp H.323 Call signaling
_h323ls._udp H.323 Location service
_h323rs._udp H.323 Registration service
_cisco-uds._tcp Cisco Unified Communications Manager
_cuplogin._tcp Cisco Unified Presence
_collab-edge._tls Cisco VCS Expressway-E
_sipinternaltls._tcp Microsoft Lync SIP TLS for internal registrations
_sipinternal._tcp Microsoft Lync SIP for internal registrations
_sipfederationtls._tcp Cisco and Lync SIP TLS federation
_xmpp-client._tcp XMPP, Cisco WebEx Messenger
_xmpp-server._tcp XMPP
_cisco-phone-tftp._tcp Cisco Unified Communications Manager TFTP
_cisco-phone-http._tcp Cisco Unified Communications Manager CCMIP
_sip._tcp.internal Cisco TelePresence Video Communication Server (Internal)
_sip._tcp.external Cisco TelePresence Video Communication Server (External)
_ciscowtp._tcp Cisco Jabber Video for TelePresence
_ciscowtp._tcp Cisco WebEx TelePresence
_turn._tcp TURN TCP
_turn._udp TURN UDP
_turns._tcp TURNS TCP
_stun._tcp STUN TCP
_stun._udp STUN UDP
_stuns._tcp STUNS TCP
_gc._msdcs._tcp Active Directory Global Catalog
_ldap._msdcs._tcp Active Directory LDAP Directories

For TCP and TLS records, the tool will also check if the TCP port is open.

Command line arguments

Either call the file directly (Unix like OSes need +x bit set) or invoke it via Perl.

Usage: csc.pl [-options] [domain]

where options are:
 -d     Enable debug mode
 -h     This help text
 -s srv Test a specific SRV record
 -v     Enable verbose mode. It will also list SRV records not found in DNS.
 -V     Version information

If domain is absent, will try to use the host's domain

Invoking the tool

No arguments

The tool will check the local domain and show the only SRV records it finds in DNS.


D:\Development\csc>csc.pl
+----------------------+-----------------------+--------+------+----+---------+--------+
|SRV record            |Target                 |Priority|Weight|Port|SRV Found|TCP Open|
+----------------------+-----------------------+--------+------+----+---------+--------+
|_sip._tcp             |videoconf.network.local|10      |10    |5060|Yes      |Yes     |
|_sip._udp             |videoconf.network.local| 0      | 0    |5060|Yes      |N/A     |
|_sips._tcp            |videoconf.network.local| 0      | 0    |5061|Yes      |Yes     |
|_sips._tls            |videoconf.network.local| 0      | 0    |5061|Yes      |Yes     |
|_sip._tls             |sip.network.local      | 0      | 0    | 443|Yes      |Yes     |
|_h323cs._tcp          |videoconf.network.local| 0      | 0    |1720|Yes      |Yes     |
|_h323ls._udp          |videoconf.network.local| 0      | 0    |1719|Yes      |N/A     |
|_collab-edge._tls     |videoconf.network.local|10      |10    |8443|Yes      |No      |
|_sipfederationtls._tcp|sip.network.local      | 0      | 0    |5061|Yes      |Yes     |
+----------------------+-----------------------+--------+------+----+---------+--------+

D:\Development\csc>

With domain

Enter the domain without any option.


D:\Development\csc>csc.pl  cisco.com
+----------------------+------------------------------+--------+------+----+---------+--------+
|SRV record            |Target                        |Priority|Weight|Port|SRV Found|TCP Open|
+----------------------+------------------------------+--------+------+----+---------+--------+
|_sip._tcp             |vcsgw.cisco.com               |1       |0     |5060|Yes      |Yes     |
|_sips._tcp            |vcsgw.cisco.com               |1       |0     |5061|Yes      |Yes     |
|_h323cs._tcp          |vcsgw.cisco.com               |1       |0     |1720|Yes      |Yes     |
|_h323ls._udp          |vcsgw.cisco.com               |1       |0     |1719|Yes      |N/A     |
|_sipfederationtls._tcp|sip.oscar.aol.com             |0       |1     |5061|Yes      |Yes     |
|_xmpp-client._tcp     |isj3cmx.webexconnect.com      |0       |1     |5222|Yes      |Yes     |
|_xmpp-server._tcp     |isj3jxf.webexconnect.com      |0       |1     |5269|Yes      |Yes     |
|_sip._tcp.external    |sjce-dmza-tsbu-vcse1.cisco.com|1       |1     |5060|Yes      |Yes     |
|_sip._tcp.external    |sjce-dmza-tsbu-vcse2.cisco.com|0       |0     |5060|Yes      |Yes     |
|_sip._tcp.external    |lys-alpha-vcse1.cisco.com     |0       |0     |5060|Yes      |Yes     |
|_sip._tcp.external    |lys-alpha-vcse2.cisco.com     |0       |0     |5060|Yes      |No      |
|_sip._tcp.external    |rusc01-vcse7.cisco.com        |1       |1     |5060|Yes      |Yes     |
|_sip._tcp.external    |rusc01-vcse6.cisco.com        |1       |1     |5060|Yes      |Yes     |
+----------------------+------------------------------+--------+------+----+---------+--------+

D:\Development\csc>

Show all tested SRV records (verbose)


D:\Development\csc>csc.pl -v cisco.com
Using the default Cisco SRV records
Using 'cisco.com' domain
+-----------------------+------------------------------+--------+------+----+---------+--------+
|SRV record             |Target                        |Priority|Weight|Port|SRV Found|TCP Open|
+-----------------------+------------------------------+--------+------+----+---------+--------+
|_sip._tcp              |vcsgw.cisco.com               |1       |0     |5060|Yes      |Yes     |
|_sip._udp              |                              |        |      |    |No       |        |
|_sips._tcp             |vcsgw.cisco.com               |1       |0     |5061|Yes      |Yes     |
|_sips._tls             |                              |        |      |    |No       |        |
|_sip._tls              |                              |        |      |    |No       |        |
|_h323cs._tcp           |vcsgw.cisco.com               |1       |0     |1720|Yes      |Yes     |
|_h323ls._udp           |vcsgw.cisco.com               |1       |0     |1719|Yes      |N/A     |
|_h323rs._udp           |                              |        |      |    |No       |        |
|_cisco-uds._tcp        |                              |        |      |    |No       |        |
|_cuplogin._tcp         |                              |        |      |    |No       |        |
|_collab-edge._tls      |                              |        |      |    |No       |        |
|_sipinternaltls._tcp   |                              |        |      |    |No       |        |
|_sipinternal._tcp      |                              |        |      |    |No       |        |
|_sipfederationtls._tcp |sip.oscar.aol.com             |0       |1     |5061|Yes      |Yes     |
|_xmpp-client._tcp      |isj3cmx.webexconnect.com      |0       |1     |5222|Yes      |Yes     |
|_xmpp-server._tcp      |isj3jxf.webexconnect.com      |0       |1     |5269|Yes      |Yes     |
|_cisco-phone-tftp._tcp |                              |        |      |    |No       |        |
|_cisco-phone-http._tcp |                              |        |      |    |No       |        |
|_sip._tcp.internal     |                              |        |      |    |No       |        |
|_sip._tcp.external     |sjce-dmza-tsbu-vcse1.cisco.com|1       |1     |5060|Yes      |Yes     |
|_sip._tcp.external     |lys-alpha-vcse2.cisco.com     |0       |0     |5060|Yes      |No      |
|_sip._tcp.external     |rusc01-vcse6.cisco.com        |1       |1     |5060|Yes      |Yes     |
|_sip._tcp.external     |lys-alpha-vcse1.cisco.com     |0       |0     |5060|Yes      |Yes     |
|_sip._tcp.external     |sjce-dmza-tsbu-vcse2.cisco.com|0       |0     |5060|Yes      |Yes     |
|_sip._tcp.external     |rusc01-vcse7.cisco.com        |1       |1     |5060|Yes      |Yes     |
|_ciscowtp._tcp         |                              |        |      |    |No       |        |
|_ciscowtp._tcp         |                              |        |      |    |No       |        |
|_turn._tcp             |                              |        |      |    |No       |        |
|_turn._udp             |                              |        |      |    |No       |        |
|_turns._tcp            |                              |        |      |    |No       |        |
|_stun._tcp             |                              |        |      |    |No       |        |
|_stun._udp             |                              |        |      |    |No       |        |
|_stuns._tcp            |                              |        |      |    |No       |        |
|_gc._msdcs._tcp        |                              |        |      |    |No       |        |
|_ldap._msdcs._tcp      |                              |        |      |    |No       |        |
+-----------------------+------------------------------+--------+------+----+---------+--------+

D:\Development\csc>

Custom SRV record

If you want to check a specific SRV record, use the -s option. You can also combine options.

D:\Development\csc>csc.pl -vs _cisco._tcp cisco.com
Using '_cisco._tcp' SRV record
Using 'cisco.com' domain
+-----------+------+--------+------+----+---------+--------+
|SRV record |Target|Priority|Weight|Port|SRV Found|TCP Open|
+-----------+------+--------+------+----+---------+--------+
|_cisco._tcp|      |        |      |    |No       |        |
+-----------+------+--------+------+----+---------+--------+

D:\Development\csc>

Debug

Use the -d switch to check how each discovered step goes.

Version

Use the -V switch to check the version before submitting any bugs.

Download

You can download the latest version here: https://github.com/azevedo-manuel/csc/releases.

For Microsoft windows there is a pre-compiled binary in each release.

These binaries use Perl Package (PP). They contain a small run-time version of Strawberry Perl that unzips into your %userprofile\temp% directory. These temporary files will not be deleted after being run for the first time for subsequent faster loading times. The folder that is created starts with par-.
The pre-compiled binaries are supplied as courtesy. I do not support them. I just compile them.

Development

The current development can be followed on Github at https://github.com/azevedo-manuel/csc You can use GitHub to submit bugs.

Notes

  1. Thanks to Falk