Use DBImpExp to Export Contacts, Not CsUser: Backing Up User Data the Right Way in Lync Server

lync server 2010

We’ve had a few migration-related questions coming in, now that Lync Server 2013 is available.

For the most part it’s questions like, “how do I prep our servers” and “will we need to upgrade SQL Server?” (Hmmm, I should do another post on that.)

But today’s post is a warning. If you want to backup your Lync user data, make sure you use the right tool!

Does the CsUser Cmdlet Export User Data? No

We had a question come in about using the CsUser cmdlet to retrieve user information and contact lists. In other words, would CsUser be all they needed for a backup & restore?

Retrieving user information IS part of CsUser’s functionality…but it won’t help you in a migration scenario.

Why not? Well, let’s explore CsUser a bit and we’ll see.

What does it do? It allows you to access, enable/disable, or move Lync users within Active Directory. These are some of its relevant commands:

You’ll notice I didn’t put down a Backup-CsUser cmdlet.
Because there isn’t one.

If you want to backup Lync users, use DBImpExp

Exporting Lync contacts is the function of DBImpExp.exe. If you haven’t heard of it, it’s a Microsoft utility on the Lync Front End server. Essentially, its purpose is to backup/restore user contact lists and conference ID data.

When used, DBImpExp creates XML files of user data. Handy for backing up or moving to other locations.

To export all contact lists on an Enterprise Edition server, you’d use this format:

dbimpexp.exe /sqlserver:”[SQL Server FQDN Instance]” /hrxmlfile:”[Path where you want to store the XML file]“

To import the same XML file to a new server, the format is:

dbimpexp.exe /import /sqlserver:”[SQL Server FQDN Instance]” /hrxmlfile:”[Same path to the XML file]” /restype:user

Not too complex, right?

Justin Morris has a very easy-to-follow writeup on DBImpExp at his blog: Exporting and Importing Contact Lists in Lync Server 2010

Do NOT miss this step in your Lync migrations! If you do, you’ll have to recreate a lot of user data. And your users won’t be happy with you for losing a bunch of their information!

Cover All Your Backup Bases Before You Migrate

These TechNet articles contain the requirements for Lync Server backup and restoration, as well as which tools to use (including cmdlets):
Backup and Restoration Requirements: Data – TechNet Lync Server 2010
Backup and Restoration Requirements: Tools and Permissions – TechNet Lync Server 2010
As you can see, CsUser is not on this list. But DBImpExp.exe is.

If it’s time to migrate, check that you have everything from these lists BEFORE you move on to the new server!

BLOG NOTE: I might have a short post next week, depending on our holiday schedule. Either way, we won’t have a post the week after that. So I’ll take this time to wish you a Merry Christmas, a Happy New Year, and we hope you enjoy everything about your holiday season.

No Comments

Leave a Reply

Allowed tags: <a href="" title=""> <abbr title=""> <acronym title=""> <b> <blockquote cite=""> <cite> <code> <del datetime=""> <em> <i> <q cite=""> <strike> <strong>



  • Lync Insider Email Updates

    Skip the visit - get Lync Insider posts in your inbox! Emails delivered every Friday.

  • About the Lync Insider Blog

    The Lync Insider is a blog about the technology we use to communicate in business today. Here we talk about Microsoft Lync Server 2013, its predecessor Lync Server 2010, Unified Communications, Voice over IP and related technologies like Exchange Server. Written by Chris W., Tech Writer & SEO Engineer for PlanetMagpie IT Consulting.
  • Categories

  • Archives