Troubleshooting


Troubleshooting SharePoint Alerts

A common theme running through the SharePoint newsgroups is the frustration of troubleshooting SharePoint Alerts such as when they stop working altogether or work intermittently.

I am trying to organise a comprehensive step-by-step troubleshooting guide that should help solve the most common problems. Its a work in progress so if you know of anything that should be added then let me know by adding a comment.

Please Note – this guide is for the Out of the Box (OOTB) alerts in SharePoint, not Pentalogic’s Reminder software (though some parts apply to both). Contact us directly for support for Reminder.


Troubleshooting Flowchart

Troubleshooting Flowchart



Flowchart in text form

The first step is to ensure you understand the difference between Confirmation Emails and Alert Emails.

Are you getting any emails?

Which best describes your symptoms?

Further Reading






PivotPoint

Reminder

Planner

17 Responses to “Troubleshooting”

  1. Tom Hockman says:

    What about the SharePoint cache that resides on each front-end server in the farm? I have read about the cache being stuck that can require stopping the timer server, manual deletion of xml files, and reset of the cache.ini file to a value of ‘1′. The cache is located in the Documents and Settings\All Users\Application Data\Microrsoft\SharePoint\GUID\ folder structure.

    Clearing out the XML files on all servers and resetting the cache.ini to 1 has helped in a couple of cases, but not all cases where alerts were not working across the farm.

    Does anyone know the role of the SharePoint cache with alerts and why it might be important to clear it out?

    Thanks.

    Tom

  2. Awesome little website guys. This is exactly the kind of material my user base can use – easy to understand for end user, just enough tech talk for the IT guys to sort out.

    Keep it up!! End user material is rare as hens teeth!!

  3. Angela French says:

    Can anyone tell me if configurations to enable alerts and email only has to be done once for a site? I ask because I just launched a site to production that three workflows. One of these workflows does NOT send emails on the production site. Neither does that library send out alerts. The other workflows and alerts on this site work fine. Everything workes fine on development.

  4. Ryan says:

    @Angela – the outgoing email settings are set at the web application level (SharePoint server > web applications > site collections > sites > sub-sites)

  5. Hayden W Essess says:

    It should also be noted that the front end servers AND back end SQL server all need to be able to relay through your mail server. The alerts actually come from the SQL server, whereas the subscription notifications seem to come from the FE box(es).

  6. Ryan says:

    @Hayden – its not as simple as the alerts always coming from the SQL server, these jobs can be spread across any server in the farm.

    Its a point I’ve tried to make with the “Ensure you understand the difference between confirmation emails and alert emails” step at the top of the flowchart but does no harm to repeat the point, thanks!

    http://sharepointalert.info/2009/11/troubleshooting-sharepoint-email-primer/

  7. Gina says:

    Thanks Ryan, your post is really helpful to me.

    Specially diagram was very explanatory and complete to understand how things are working.

    Keep up the good work.
    Gina

  8. Amey Mulay says:

    The diagram is what is the best part which explains it all. Thanks a million.

  9. JFD says:

    I’m looking for a strategy or method to limit the amount of information contained in an alert. The alerts we see contain all of the information contained in the submitted record – I don’t want that sent via email (unsecure). How do I generate an alert that just provides a link to the list without the record details?

  10. Yves says:

    I don’t receive any message when i create the alert from http://www.website.com but if i create it on the localserver http://localserver
    it works fine!

    thanx for the reply and this overview! rarely you find something so clearly as this…

    Thanx

    yves

  11. Ryan says:

    @JFD – If you want to modify the email alert messages then you’ve got 3 options.

    1) Make your own alert templates – but the problem with this is they are web application wide so any changes you make will effect all alerts coming from that web app for that particular list type

    2) Implement an INotifyAlertHandler - need some fairly serious development resource to make this work

    3) Use a 3rd party product such as – blatant plug – our Reminder web part which allows you to easily customise the email message on a per list basis and much more beside!

    http://www.pentalogic.net/sharepoint-products/reminder

  12. Ryan says:

    @Yves – are your alternate access mappings (AAM) setup correctly?

  13. kamala says:

    Hi Everybody,
    Well we r using Project server 2007 in our PMo and configured personal settings to set the email alerts, but the thing is that we are receiving emails each time when we publish the project to the server.We r geeting an email each time with summay of tasks that 100 % complted and even due tasks saying that these particular tasks are updated.Can any one has faced such problem are any one has that idea to stop generating those emails.Please let me know.Thanks.

  14. Raghavendra A J says:

    Hi All,

    Few days back I had an issue with the alerts, wherein my team is not getting alerted whenever there is a change in the lists. I had resolved this issue by deleting one of the aborted timerjob (Upgrade timer job) and later all my team members got a chain of alert mails ( all the mails which were not delivered).
    Following is the problem I’m facing now:
    As per the alert setting, a mail will sent to the nominees whenever there is a change in the list. Now all my team is getting morethan 1 alert mail for a single change??????
    Few people will get 2, few will get 11 and so on.. all the services and timerjobs are working properly.
    Can anyone please help me to resolve this issue.

    Thanks in advance,
    Raghav A J

  15. Raghavendra A J says:

    Hi All,

    Finally I found a soln for the problem I faced. What a silly mistake I have done!! he he…I have a set too many alerts for the users for that list. But whenever I navigate through the ‘Action->Alertme->view y existing alert on thi site’, it was not showing anything, but When I lookin the user alerts page, I mean ‘Siteaction->site settings->odify all site setting’ under site adinistration click ‘useralerts’. i’m able to see morethan 1 alerts set multiple times for the list. I selected the unwanted alerts and deleted…..now its working fine!!!!

    Thanks,
    Raghav A J

Leave a Reply