When Irish eyes are
Smiling, they must be using
Sure and begorah, 'tis March 17th, St. Patrick's Day, a traditional Irish holiday also celebrated in other countries (such as the good old US of A). Top of the morning to you!
At any rate, St. Patrick's Day is held each year to celebrate the life of Andy Warhol, the one-time – Nah, just kidding. St. Patrick's Day is held each year to celebrate the life of, well, St. Patrick, the man who brought Christianity to Ireland and, according to legend, also banished all the snakes: Ireland is one of the rare places on Earth that has no snakes whatsoever.
On St. Patrick's Day it's traditional to do two things. First, you're supposed to wear something green, green being a color long associated with both St. Patrick and with Ireland.
Second, you're supposed to run the Test-CsPhoneBootstrap cmdlet. (Which, we should point out, is not be quite as traditional as wearing green.) Why Test-CsPhoneBootstrap? Well, why not Test-CsPhoneBootstrap? As you probably know, when you start up a phone running Microsoft Lync Server 2010 Phone Edition, that phone needs to locate a Registrar and then provide a valid phone number and a valid PIN number in order to be authenticated by the system. (This is a process known as "bootstrapping," a term commonly used in networking to refer to the process of a device starting up and joining a network, even if that device has no prior knowledge of the network it's joining.) If you want to verify that a given user can be authenticated, using the phone number and the PIN number assigned to him (or her), you can simply run the Test-CsPhoneBootstrap cmdlet. For example:
Test-CsPhoneBootstrap -PhoneOrExt "+14255551219" -Pin "07125" -Verbose
As you can see, that's pretty easy. However, there is one tricky part here. In order for a phone to bootstrap itself, that phone needs to use DHCP to locate a Registrar pool; in turn, that means you need to have at least one Registrar pool that's discoverable using DHCP. If you don't, your Test command will return this message:
Error : Did not receive any response for the DHCP discovery message.
- If you have a functioning CS Registrar in your deployment
With EnableDHCP setting turned ON
- OR you have an enterprise DHCP Server that can respond to
CS specific options
What does all that mean? Well, to begin, try running this command:
Check all the returned Registrar configuration settings; in particular, check the value of the EnableDHCPServer property. (Yes, we know: the error message calls it the EnableDHCP property. But the error message is, alas, in error.) If EnableDHCPServer is set to False, then use a command like this one (which modifies the global Registrar configuration settings) to turn on DHCP discovery:
Set-CsRegistrarConfiguration –Identity global –EnableDHCPServer $True
Now try Test-CsPhoneBootstrap again and see what happens.
By the way, as is always the case with the Test-Cs cmdlets, we recommend that you include the Verbose parameter any time you use Test-CsPhoneBootstrap. Why? Well, if you leave off the Verbose parameter and your command fails, you might get back a message similar to this:
Error : ERROR – No response received for Web-Ticket service.
If you include the Verbose parameter, you get back some information on what that error means, and what you might be able to do about it:
Could not get a web ticket.
- Web service url is valid and the web services are functional
- If using PhoneNoPIN to authenticate, make sure they match the user uri
- If using NTLMKerberos auth, make sure you provided valid credentials
That's about all we have for today. Enjoy St. Patrick's Day. Or should we say, enjoy Maewyn Succat's Day, Maewyn Succat being St. Patrick's real name.
In case you were interested.