Jabber Config File Generator


Jul 5, 2012 6:44 AM
Jul 5th, 2012

Please find the attached HTML document, download and open it on your PC.  This provides an easy to use form where you simply answer a few questions and it will render the proper jabber-config.xml file for you to copy/paste.  There is built in logic to verify you are entering in the correct information for the deployment selected, as well as valid XML characters.

The XML file structre is rendered in JavaScript, so you'll still need to copy/paste the contents into a text file and upload the file to your CUCM server, but you can rest assured that the configuration is correct and valid by using this form.

Update 2014-01-02: Added partial Mac 9.2 specific fields for BDI, Windows 9.6 specific fields.

Update 2013-07-25: Modified Search Base validation logic to include the default CN in addition to OU's

Update 2013-05-17: Added 9.2 specific fields.

Update 2012-12-29: Added 9.1 specific fields and implented version switching for it to work with both 9.0, 9.1, and any future version dependent fields

Update 2012-08-16: resolution to CSCua39052 in Jabber 9.0(4) resolved the Base Filter open/close bracket problem.  Updated validation tests to reflect this change.  As such, this script will only work for Jabber 9.0(4) and later when using a custom Base Filter; if using Jabber prior to 9.0(4), simply remove the last closing bracket in the Base Filter tag before uploading to TFTP.

Average Rating: 5 (14 ratings)


chrlunsf Tue, 07/10/2012 - 11:15

Haven't tried this yet, but I just want to say...  Awesome Idea and Intiative!!!

Thank You!


abcronin Thu, 07/26/2012 - 15:25

Great idea and will be very useful in J4E rollouts, I have used it in a Lab and will defiantly use for customers in the coming months.



muranskycotech Sat, 08/11/2012 - 06:25

Wow, thank you thank you thank you! I was beating my head against the desk trying to manually create the config file for my environment, and this took me 20 minutes to set, upload, and test.

jiri.solc Sun, 08/19/2012 - 12:02

Great idea, I'm looking forward to test it! It will speed up deployments a lot, no more manual XML writting with notepad++ :-)

skilambi Fri, 08/24/2012 - 11:31


I think you meant to say UDS instead of UCS if I am not mistaken for directory integration

nidia.gutierrez Mon, 04/15/2013 - 19:05

Very helpful however I need to display a DOD Banner (MOTD) do I add this to the jabber-config file so users receive notice or is this option configured else where.

Thank you

CondorXIII Wed, 05/15/2013 - 13:48

I might just be blind or new to the Cisco world to not know where exactly I'm supposed to be looking but does anyone really understand how BDI works. The BDI is missing from the tool and more importantly with the Jabber for Mac client getting a big refresh that is going to need to get some attention. Just not sure how to do some mapping of LDAP using BDI for the Mac clients. Thanks in advance.

szelenka Fri, 05/17/2013 - 11:00

BDI would be configured similar to how you configure non-AD LDAP integrations.  Esentially it's setting up EDI but manually specifying the LDAP servers to connect to and a service account for them to connect with.  This guide may help some:


Once Jabber Mac 9.2 is posted, I'll revise this script to work with that as well if there are any additional paramters that need to be added.

yvelazco@synops... Thu, 07/25/2013 - 09:40

This seems a useful tool, but I cannot get past the Search Base OU's.  I've tried using the following:


But the field validation keeps refering to an invalid OU string. 

I've looked at my existing jabber config file and the above is how it was setup.  Just wanted to test this out so I can generate a new config with new entries (not necessarilyt the search base).

Exactly what type of validation does the Search Base OU check for?


szelenka Thu, 07/25/2013 - 10:13 (reply to yvelazco@synops...)

The validation is checking that the value entered is not empty, and matches a regular expression.  The JavaScript logic for this is:

(e.value !== '' && (e.value.match(/^(OU=).+,\s*(DC=).+/i) === null || e.value.match(/[^\w-_\s=,]/ig) !== null))

From your example, it appears you're using a Container rather than an OU for the Search Base.  And the logic is hard coded to check specifically for "OU" at the begining of the line.  I'll have to make some changes to that regex to allow "CN" to be included as well.

In the short term, you could edit the file you downloaded in a text editor and simply comment out or remove lines 2528 to 2530 and this will remove the validation checking for the Search Bases.

joshdowning Tue, 07/30/2013 - 13:04

Getting error when clicking on the link for http://www.cisco.com/en/US/partner/docs/voice_ip_comm/jabber/Windows/9_2/JABW_BK_C9731738_00_jabber-windows-install-config_chapter_0101.html#JABW_TK_CD3600CC_00

Forbidden File or Application.The file or application you are trying to access may require additional entitlement or you are trying to access a file with an invalid name. Additional entitlement levels are granted based on a users relationship with Cisco on a per-application basis.

If you feel you have reached this page in error, please try one of the following methods to locate your document:

1.If you are manually entering the URL into your browser location bar, be sure to include the file name of the page you are trying to access (file names typically end in .htm, .html or .shtml).
2.Use the Search feature located in the upper right section of this page.
3.Return to the Cisco.com Home or select a primary site area from the top navigation bar.
4.Consult with your Cisco Account Manager to confirm you have the appropriate entitlement to access this page.
If you would like to contact someone about this problem, please click on the Contacts & Feedback link below.

CondorXIII Tue, 09/24/2013 - 15:06

Really excited about Jabber for Mac 9.2.1 and looking forward to the hopeful addition of BDI to the config generator! I can't seem to wrap my head around how it works compared to EDI or UDS .

mduling Thu, 10/17/2013 - 15:22

Here's the jabber-config.xml file I used to get directory searches for Mac Jabber 9.2.1 working in AD environment.  Note that though I am using TLS, I could not get it working over the standard ldaps (636) port. I assume this is a bug in 9.2.1, but in any case wireshark confirms it is doing ssl.  Also, I have the UCM service profile for Jabber is set to ldap not global catalog mode if that even matters when using a config file.

<?xml version="1.0" encoding="UTF-8"?>

<config version="1.0">







        <BDISearchBase1>ou=My Users,dc=ad,dc=mycompany,dc=com</BDISearchBase1>







NOTE (from v9.2.1 doc): The default value is (&(objectCategory=person). Configuration files can contain only valid XML character entity references. Use &amp; instead of & if you specify a custom base filter.

fabio1981 Fri, 03/14/2014 - 09:22

Hi there,

just to let you notice that the tool, when enabling URI Dialing, writes:


that is not working, as Jabber is expecting:



Anyway it's a very nice tool.



jasonmid99 Tue, 03/18/2014 - 16:20

Great tool, has saved me hours!

Does anyone know if it is possible to force these settings on the clients?

So far, I can see that the Jabber client uses the settings in here the first time, but then if a user changes a setting, like the inactive time, it stays at the user setting, not what is in the jabber-config.xml.





lowen@utah.gov Tue, 04/01/2014 - 13:45


This is most helpfull. Could you possibly update this to include the new client parameter "Persistent_Chat_Enabled"?


bhasker.mistry Thu, 04/03/2014 - 09:14

Hi Szelenka,

Just had a look at the tool, look pretty useful. I am in the process of integrating CUCILync in 9.2.1 and looks like this also require the creation of a jabber-config.xml file any chance it can be tailored to be used for this?



Login or Register to take actions

This Document

Posted July 5, 2012 at 6:44 AM
Comments:22 Avg. Rating:5
Views:40567 Contributors:20

Related Content

Documents Leaderboard