There are plenty of articles that outline the migration process for taking a Standard Edition installation of Lync to Enterprise Edition, but what I’ve not seen covered off is a check-list of things to look out for BEFORE you kill the old SE.
The obvious things are checking you’ve:
- swung DNS
- updated the Edge (hosts file?)
- moved the file share
- made sure ISA/TMG is pointing your external traffic to the new FE pool (or HLB if you have one)
- updated the Gateways to also point to (and accept traffic from) the new FE
- re-run the Exchange integration script (Exchange 2010: %Program Files%\Microsoft\Exchange Server\V14\Scripts\exchucutil.ps1)
There are still a few commandlets you need to run to ensure the old SE is ‘clean’. The process here is essentially the same as when migrating from OCS to Lync, and covered off fairly comprehensively in the document Migrating from Office Communications Server 2007 R2 to Lync Server 2010.
Here’s a collection of commands to run, extracted from the above, with some additions from a Lync beta migration document and a few of my own embellishments. If the first command in any group doesn’t respond clean, then issue the following command to move.
Scrape the following into a text document on your FE, and find/replace (^H) the EE & FE pool names with your own before then pasting each command in turn into the Shell:
Conference Directories
Get-CsConferenceDirectory | Where-Object {$_.ServiceID -match "<SE-FQDN>"}
Move-CsConferenceDirectory -Identity <Numeric identity of conference directory> -TargetPool <EE-PoolFQDN>
Common Area Phones
Get-CsCommonAreaPhone -Filter {RegistrarPool –eq "<SE-FQDN>"} Get-CsCommonAreaPhone -Filter {RegistrarPool –eq "<SE-FQDN>"} | Move-CsCommonAreaPhone -Target <EE-PoolFQDN>Get-CsCommonAreaPhone | Where-Object {$_.RegistrarPool -eq "<SE-FQDN>"} Get-CsCommonAreaPhone | Where-Object {$_.RegistrarPool -eq "<SE-FQDN>"} | Move-CsCommonAreaPhone -Target <EE-PoolFQDN>
Analog Phones
Get-CsAnalogDevice -Filter {RegistrarPool –eq "<SE-FQDN>"} Get-CsAnalogDevice -Filter {RegistrarPool –eq "<SE-FQDN>"} | Move-CsAnalogDevice -Target <EE-PoolFQDN>Get-CsAnalogDevice | Where-Object {$_.RegistrarPool -eq "<SE-FQDN>"} Get-CsAnalogDevice | Where-Object {$_.RegistrarPool -eq "<SE-FQDN>"} | Move-CsAnalogDevice -Target <EE-PoolFQDN>
Dial Plans
Get-CsDialPlan -id service:registrar:<SE-FQDN>
You might not care for an old pool-scoped dial plan on the SE server, but make sure you don’t need to replicate the functionality on the EE pool.
Don’t be freaked if this reports a mess of red – the key takeaway here is if it says what you’ve asked for doesn’t exist:
Get-CsDialPlan : Cannot find "DialPlan" "Registrar:<FQDN>" because it does not exist.
Users
Get-CsUser -Filter {RegistrarPool -eq "<SE-FQDN>"}Get-CsUser | Where-Object {$_.RegistrarPool -eq "<SE-FQDN>"}
Response Groups
Get-CsRgsConfiguration service:ApplicationServer:<SE-FQDN> Get-CsRgsWorkflow service:ApplicationServer:<SE-FQDN> Get-CsRgsQueue service:ApplicationServer:<SE-FQDN> Get-CsRgsAgentGroup service:ApplicationServer:<SE-FQDN> Get-CsRgsHolidaySet service:ApplicationServer:<SE-FQDN> Get-CsRgsHoursOfBusiness service:ApplicationServer:<SE-FQDN>
Migrating Response Groups used to be a hassle, requiring the use of special scripts from the ResKit. These days the cmdlets are inbuilt.
As with the Dial Plan above, red here is good news (for a change):
Get-CsRgsConfiguration : Cannot bind parameter 'Identity' to the target. Exception setting "Identity": "The application "RGS" is not installed on pool "<FQDN>"."
And in case you’ve found an “obvious” shortcut in Move-CsRgsConfiguration, I refer you to this spoiler from the party-poopers at TechNet:
“The Move-CsRgsConfiguration cmdlet is only for migrating from Office Communications Server 2007 R2 or Lync Server 2010 to Skype for Business Server 2015; you cannot use this cmdlet to migrate from one instance of Skype for Business Server 2015 to a new instance of Skype for Business Server 2015. That type of migration can only be done by using the new Import-CsRgsConfiguration and Export-CsRgsConfiguration cmdlets.”
So; down to business.
To backup:
Export-CsRgsConfiguration -Source "service:ApplicationServer:<SE-FQDN>" -FileName "C:\RgsExportSource.zip" -RemoveExportedConfiguration
(Note that the above has DELETED your now-previously-working RGS config, so you don’t want to be doing this during operating hours!)
To import into the new EE:
Import-CsRgsConfiguration -Destination "service:ApplicationServer:<EE-PoolFQDN>" -FileName "C:\RgsExportSource.zip" -OverwriteOwner -ReplaceExistingRgsSettings
Reference. Note that at the time of writing (July 2015) there are some bugs in the examples on the TechNet page. I’ve corrected the syntax in this post.
Unassigned Numbers
Get-CsUnassignedNumber | ? { $_.AnnouncementServerFqdn -eq "<SE-FQDN>" }
Call Park Orbits
Get-CsCallParkOrbit | ? { $_.CallParkServerFqdn -eq "<SE-FQDN>" }
Call Park MOH
Don’t forget to extract any customised MOH for Call Park. There’s a formal process to find it, but it’s cumbersome. This is much quicker and more practical:
CD <SE file share> DIR *.wma /s
Audio-Conferencing Access Numbers
Get-CsDialInConferencingAccessNumber | where {$_.Pool -eq "<SE-FQDN>"}
These you’ll move with:
Move-CsApplicationEndpoint -Identity <SIP URI revealed above> -Target <EE-PoolFQDN>
Exchange UM Contacts
Get-CsExUmContact -Filter {RegistrarPool -eq "<SE-FQDN>"}
Get-CsExUmContact -Filter {RegistrarPool -eq "<SE-FQDN>"} | Move-CsExUmContact -Target <EE-PoolFQDN>
And Finally
… and just to be sure you (and I) haven’t missed anything, take one final sweep through the Control Panel and make sure no other pool-related configurations remain – or that those that do you’re OK with leaving behind. (As you’ve already moved the users they’ll be referencing the new pool-scoped policies you might have created on the new EE FE, or otherwise they’ll be now following the attributes from the Global scope. This could result in a change of user experience, and possibly some fault complaints).
Revision History
27th July 2015: Added more info, updated RGS migration process from ResKit app to cmdlets.
