Response Group agents worden niet verwijderd uit de dbo.Agent tabel

Warning: the procedure described in this blog are used as a workaround for an issue. Incorrect changes in the database may cause mailfunctioning of the Response Groups.

In Lync 2010 it’s possible to add users to a group which can be used by the Response Groups. In some scenarios it might be necessary to remove and directly add an agent. This can be the case if a SIP address of a user needs to be changed.

Removing the agent is normally not an issue but adding it directly is. In almost every case the following error will be displayed:

Windows Powershell returned the following errors: Cannot insert duplicate key row in object dbo.Agents with unique index IX_Agents_UserSid.
The statement has been terminated.

This error will tell you that it can’t add the agent because there is an existing entry in the agent table which is used by the Response Groups.

Normally you will have to wait a few minutes before you can add the user again. But this week I experienced that after 3 hours the agent still can’t be added to the group. In the event log nothing strange was being logged. On TechNet you will not find many information how the Response Groups really perform this action. But in some cases it looks like the Response Group will be resetted after making a change and it only resets the Response Group if it is idle.

Because I couldn’t add the user after 3 hours it became quiet irritating. As you may know Lync is using SQL databases. The agents of a Response Group are added to the rgsconfig database. This database can be found on the SQl server which also hosts the CMS.

Within this database you will find a table called dbo.Agents. When you will open this table you will see an overview of the agents which are member of the groups.

Perform the following steps to remove an agent from this table:

  • Right click on the dbo.Agents table and select the option Edit Top 200 rows
  • Search for the user and remove the specific record

By removing the record it will be possible to add the agent to the group again.

The issue is described in this KB article of Microsoft:

http://support.microsoft.com/kb/2393943

Waarschuwing: de procedure die hierin beschreven wordt is een workaround voor een issue verkeerde aanpassingen in de database kan ernstige gevolgen hebben voor het functioneren van de Response Groups.

In Lync 2010 is het mogelijk gebruikers lid te maken van groepen t.b.v. Response Groups. Nou kan het weleens voorkomen dat een gebruiker uit deze groep verwijderd moet worden en daarna direct weer toegevoegd moet worden. Dit kan bijvoorbeeld voorkomen als een SIP adres wordt gewijzigd.

Het verwijderen is over het algemeen geen probleem maar het daarna direct weer toevoegen van een gebruiker wel. In veel gevallen zal de volgende melding getoond worden:

Windows Powershell returned the following errors: Cannot insert duplicate key row in object dbo.Agents with unique index IX_Agents_UserSid.
The statement has been terminated.

Met deze foutmelding wordt aangegeven dat de agent nog niet is verwijderd uit de agents tabel die gebruikt wordt door de Response Groups.

Normaliter is het binnen enkele minuten mogelijk om de gebruiker weer toe te voegen. Echter had ik afgelopen week een klant waar dit niet het geval was. Zelfs na 3 uur wachten was de wijziging nog niet doorgevoerd. In de event logs waren geen meldingen terug te zien die duiden op mogelijke problemen. Op TechNet is weinig te vinden over hoe dit proces nou echt daadwerkelijk werkt. Echter aangezien een wijziging in een groep de Response Group weleens lijkt te resetten is het zeer waarschijnlijk dat hij wacht tot er geen calls meer naar de response groep zijn.

Omdat dit echter na 3 uur nogsteeds niet uitgevoerd kon worden werd dit toch wel erg vervelend. Zoals je misschien wel weet maakt Lync gebruik van SQL databases. De agents voor een Response Group worden weggeschreven in de database rgsconfig. Deze database is terug te vinden op de SQL server waar ook de CMS actief is.

In deze database is een tabel aanwezig met de naam dbo.Agents. Wanneer je deze opent zal er een overzicht worden getoond van de agents die lid zijn van de groepen.

Voer de volgende stappen uit om de agent te verwijderen uit de tabel:

  • Klik met de rechter muisknop op dbo.Agents en selecteer de optieEdit Top 200 rows
  • Zoek in het overzicht de gebruiker op en verwijder het record

Door het record te verwijderen van de betreffende agent is het hierna weer mogelijk om de agent opnieuw toe te voegen.

Het probleem wordt beschreven in onderstaand Microsoft KB artikel:

http://support.microsoft.com/kb/2393943

Free subscription



You may also like...

2 Responses

  1. Paul Voller schreef:

    Thank you Johan

    I tried this only today and managed to get a user back into the correct response group. I also chided the engineer who edited her SIP address in the first place! No need to edit SIP addresses really, as they’re almost invisible to users within Lync.

    One thing to note: the Lync Server Response Group service needs to be restarted after making this change as otherwise it doesn’t accept incoming calls.

    Paul

  2. Absials schreef:

    Thanks John for your post.
    I was just playing with the Response Groups through Power-shell when I got such error. The scenario was I removed an Agent from a group and tried to add this agent again to the same group.
    So, I was just wondering if there is any way to forcefully remove the agent through any command without a delay…?

Geef een reactie

Het e-mailadres wordt niet gepubliceerd. Vereiste velden zijn gemarkeerd met *

Deze website gebruikt Akismet om spam te verminderen. Bekijk hoe je reactie-gegevens worden verwerkt.