Haiku #69

[NextHop_Team]

First published on TECHNET on Mar 17, 2011

When Irish eyes are

Smiling, they must be using

CsPhoneBootstrap.

Sure and begorah, 'tis March 17 ^th , 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!

Note . In case you're wondering, the begorah in the phrase Sure and begorah means "by God." For example: Sure, and by God it's a beautiful day, isn't it?

In case you were wondering.

Oh, and the phrase "Top of the morning to you"? Well, although American TV has long associated that saying with Ireland, we've been told that no one in Ireland ever says "Top of the morning to you." Instead, that's a phrase that’s used, and originated, in New Zealand.

In case you were wondering.

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.

Note . St. Patrick never visited the Seattle area. Instead, we were visited by St. Nimbostratus, who banished all the sunshine from our area. Seattle is one of the rare places on Earth that gets no sunshine whatsoever.

In case you were wondering.

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.

Note . When the author of today's haiku was a kid, you were supposed to pinch anyone who didn't wear green on St. Patrick's Day. Modern society being what it is, though, he assumes that's no longer socially acceptable.

Which is probably just as well, because he's not wearing anything green himself.

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.

CHECK:

- 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:

Get-CsRegistrarConfiguration

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.

CHECK:

- 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

Note . In case you're wondering, our above failure occurred because the PIN number 07125 is not the right PIN for the user who was assigned the phone number 14255551219. When we re-ran the command using the correct PIN number, then everything worked just fine.

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.