Tuesday 9 April 2013

Configuring Outgoing Email on SharePoint 2010 – Part 2


Creating a New Receive Connector

Note that the Send Connector was created under the Hub Transport settings of theOrganization Configuration. Receive Connectors, on the other hand, fall under the Hub Transport settings of the Server Configuration. Go there now and, in the right-hand panel, click New Receive Connection
 create new receive connector
Give it a name and choose the intended use for that connector (e.g. Custom). Click Next.
Leave the Local Network settings as is. Click Next.
receive connector local network settings
When you’re already in the Remote Network Settings window, select a range of IP addresses in the list box to change it. Basically, a single item is a range of IP addresses of servers from which mail will be received.
 new receive connector remote network settings
You’ll need to enter the IP address of the SMTP server (the SharePoint Server in this case) for the Start Address, as well as an End Address in case you have additional servers in play.
remote servers - IP address range
Click OK. Then click Next.
In the next window, click New to commence creation of the new connector.
new connector
When the process completes, click Finish.
finish new receive connector
You’ll then see your newly created Receive Connector. Right-click on it and select Properties.
Once inside the SharePoint Outgoing Properties window, navigate to the Permission Groups tab and check Anonymous users. Click OK.
SharePoint outgoing properties window
With that, your Receive Connector will now be ready to go.
Next, we’ll show you how to configure your outgoing email settings from Central Administration.

Configuring Outgoing Email settings from Central Administration

Go to a client system and launch SharePoint Central Administration from there. Navigate toSystem Settings > Configure outgoing e-mail settings.
configure outgoing email settings
In the set of text fields and drop-down list on the right, enter/select the following settings:
  • Outbound SMTP server:
Enter the FQDN of the Exchange server.
  • From address:
At this point, you may enter the administrator’s address.
  • Reply-to address:
You may enter the admin’s address here as well.
  • Character set:
Select your desired character set.
Click OK when done.
outgoing email settings

Testing the Outgoing Email feature - Creating and Managing an Alert

You’re now ready to try out the Outgoing Email feature. To give it a test run, let’s create your first alert. Go to your SharePoint site and select a list item. Next, navigate to the List tab and click Alert Me. Finally, click Set alert on this list.
SharePoint site
In that list’s New Alert window, set the following configurations:
  • Alert Title
Enter a suitable title for the alert
  • Send Alerts To
Enter the user names or e-mail addresses of the people whom you would like to send alerts to. Include yourself just so you can verify if things go as expected.
  • Delivery Method
Specify a delivery method. In this case, it’s just going to be e-mail.
configuring new alert 1
  • Change Type
Specify the type of changes you want to be alerted to. At this point, just select All changes.
  • Send Alerts for These Changes
Specify whether to filter alerts based on specific criteria. At this point, just select Anything changes.
  • When to Send Alerts
Specify how frequently you want to be alerted. At this point, just select Send notification immediately.
configuring new alert 2
Click OK when done.
If you followed all those settings we suggested, you’ll be able to receive your first alert after you click the OK button. You can view the contents of the alert through Outlook.
first alert received
You can then make changes to all your existing alerts by clicking the Alert Me button again and selecting Manage My Alerts.
Manage my alerts
In the succeeding screen, you’ll see all your existing Alerts. You can make changes to an alert by simply clicking on it.
existing alerts
To see the alerts feature in action one more time, let’s create a new item under the list which you activated an alert on. Navigate to the list in question and click Add new item.
add new item to a list
This item is just for testing purposes, so just fill in the necessary settings as you wish.
new item
Again, right after you click Save, you’ll receive an email in Outlook alerting you of the newly created item.
alert email
As you can see, by configuring SharePoint for Outgoing Email, you’ll be able to receive alerts, which can be very useful in tracking changes in lists, libraries, and documents.

Configuring Outgoing Email for Web applications

There’s one more benefit we’d like to mention that’s still a result of configuring SharePoint for Incoming/Outgoing email. Go back to Central Administration and navigate to Application Management > Manage web applications.
manage web applications
If you select any of those web applications you have there and then click General Settings >Outgoing E-mail,
outgoing email for web applications
you’ll be able configure outgoing e-mail for that web application.
web application outgoing email settings
Notice that these are exactly the same configurations we encountered when we first configured our Outgoing E-mail settings. Notice also that the values you originally entered are taken as the default. You may change them to suit the specific outgoing email requirements of this web application. Click OK when you’re done.

Configuring Incoming and Outgoing Email on SharePoint 2010 – Part 1


Enabling SMTP in SharePoint

Go to your SharePoint server and open the Server Manager. Next, click the Features node and then click the Add Features link.
Server Manager
This will launch the Add Features Wizard. In the Features list, scroll down until you find the item named SMTP Server. Click that.
Sharepoint add features
A dialog box will then pop-up, asking you whether you want to add role services and features required for the installation of the SMTP Server. Click the Add Required Role Services button.
add role services and features required for smtp server
In the succeeding screens, just click the Next buttons until you reach the one that saysConfirm Installation Selections, at which you’re supposed to click Install.
Select Features
Web Server IIS
Select Role Services
confirm installation instructions
Barring any unforeseen hitches, you should reach the Installation Results screen with all items marked as Installation succeeded. If you did, click the Close button.
installation results

Configuring SMTP using the IIS 6.0 Manager

For you to be able to configure that SMTP service, the Internet Information Services (IIS) 6.0 Management Tools (a.k.a. IIS 6.0 Manager) should be installed on your Windows 2008 R2 Server. To see if they’re already there, navigate to Start > All Programs > Administrative Tools.
IIS 6 Manager
If it hasn’t been installed yet, then just go to the Server Manager, click the Roles node, scroll down that large Roles pane on the right until you see the link called Add Role Services, and click that link.
server manager add role services
In the Add Role Services window, scroll down the list of Role services until you reach the IIS 6 Management Compatibility items. Check the relevant items as shown on the screenshot below and proceed with the installation. Notice that the items are grayed. That’s because, in our system, the IIS 6.0 Management tools have already been installed. We just wanted to show you where to go should you discover that those tools haven’t been installed yet.
select role services
With the IIS 6.0 Manager already installed, you can already configure the SMTP service. Launch the IIS 6.0 Manager (we showed you where to find it earlier) and navigate to SMTP Virtual Server #1.
IIS 6 Manager SMTP
Right-click on SMPT Virtual Server #1 and, in the context menu that appears, selectProperties. This should bring up the SMTP Virtual Server #1 Properties window.
Most of the settings here may be left to their default values. However, you may click those tabs and change the property settings you find there to suit the needs of your organization. For instance, in the General tab, you may want to check Enable logging if you want to perform some troubleshooting.
IIS 6 Manager SMTP General tab
After closing the SMTP Virtual Server #1 Properties window, select the Domains item that you see under SMTP Virtual Server #1. Next, right-click on the domain name of the SMTP virtual server found in the right panel and select Properties.
IIS 6 Manager SMTP Domains
Select your desired location for the Drop directory. Of course, you may accept the default location if you want. Click OK when done.
IIS 6 Manager SMTP drop directory
You’re done with configuring the SMTP service. The next part is to ensure that the service will start automatically. To do that, go to Start > All Programs > Administrative Tools >Services.
Services
Once the Services window is up, scroll down until you see the item named Simple Male Transfer Protocol (SMTP). Normally, its Startup Type will be set to Manual.
smtp startup type manual
To change that to Automatic, double-click on the item in question to bring up its correspondingProperties window.  Expand the drop-down list box beside the Startup type property and select Automatic. Click Apply, then OK.
setting smtp startup type automatic
That practically covers what you have to do as with regards to SMTP configurations on your SharePoint server. The next step is to configure SMTP settings on the Exchange Server side.
Configuring SMTP on Exchange Server
Go to your Exchange Server and open up your Exchange Management Console. In the screenshot below, you’ll notice that, in our set up, we already created mailboxes for all our users. We’re going to assume you’ve also done that at your end.
Exchange Management Console mailboxes
The first thing to do here is to create a Send Connector. Navigate to the Organization Configuration on the left panel, select Hub Transport, and click the Send Connectors tab. Next, go to the Actions panel on the right and click New Send Connector.
exchange management console - new send connector
This will bring up the New Send Connector Introduction screen. Give the send connector a name, e.g. SharePoint 2010 Incoming, and specify its intended use, e.g. Internal. When done, click Next.
new send connector - introduction
In the Address Space window, you’ll then be asked to specify the address space to which the connector will route mail. First, click the Add button.
add address space
Next, enter the address of the server that’s handling your SMTP service into the Address field. In this case, that server is your SharePoint server, so enter its address there. Click OK.
address of server handling smtp service
That will add the address space to the list in the Address Space window. Click Next.
added address space
When you’re in the Network Settings window, you’ll notice the “Use domain name system...” option is grayed out. That’s because we’ve set the email to be sent “internally”. Hence, mail will be routed through a set of smart hosts. If instead we had set the emails to be sent out over the Internet, then the first option would not have been grayed out.
To add a smart host, click the Add button.
 New Send Connector - Network Settings
When you start adding a smart host, you’ll be required to enter the IP address of the server that’s hosting your SMTP service. Again, this server is no other than your SharePoint server. But instead of entering the FQDN like you did earlier, which is given as the second option, it’s recommended that you enter the numeric IP address. This will give you a better chance of connecting in case certain connectivity problems occur in the future.
smart host ip address
After clicking OK, you’ll see the IP address added to the list of smart hosts. Click Next.
new send connector - network settings smart host
In the succeeding window named Configure smart host authentication settings, just leave the option to None and click Next.
configure smart host authentication settings
When you’re in the Source Server window, make sure your Hub Transport server is on that list. In a typical Exchange installation, which is what we have, a single Exchange server is set to handle all three roles (i.e., Mailbox, Client Access, and Hub Transport). So if you find your Exchange server there, chances are, you’re good to go. Click Next.
new send connector source server
Finally, you’ll be shown a summary of your new Send Connector configurations. Click New.
summary of new send connector configurations
This will create the new send connector. Once creation is complete, click Finish.
new send connector complete
new send connector

Configuring Active Directory to allow contacts to show up in the Outlook Address book

At this point, you will need to go to your Domain Controller and make some changes to Active Directory to allow contacts to be created within an organizational unit so that they show up in the Outlook Address Book after they are created.
Go to your Domain Controller and open the Active Directory Users and Computers.
Active Directory Users and Computers
First, create an Organizational Unit as shown.
Organizational Unit
Give the Organizational Unit a name (e.g. Sp Contacts), then click OK.
new organizational unit
Next, change the permissions of that Organizational Unit by right-clicking it and selectingDelegate Control.
delegate control of organizational unit
When the welcome screen of the Delegation of Control Wizard appears, click Next.
delegation of control wizard
You will want to delegate control to the account that controls the SharePoint Central administration application pool, which, in this case, is the SP Admin account. Click the Addbutton.
delegation of control wizard users or groups
Enter spadmin in the text field labeled “Enter the object names to select”, then click OK.
select users computers or groups
In the next screen, select its corresponding item and click Next.
delegation of control wizard spadmin
You’ll then be asked whether you want to delegate a set of common tasks or create a custom task to delegate. Select the second option and click Next.
create custom task to delegate
When asked to indicate the scope of the task you want to delegate, select “This folder, existing objects in this folder, and creation of new objects in this folder.” Click Next.
scope of tasks you want to delegate
In selecting the permissions you want to delegate, first check General and Creation/deletion of specific child objects. Then, in the Permissions list, check Create All Child Objects andDelete All Child Objects. Click Next.
select permissions you want to delegate
If all goes well, you will have reached the end of the Delegation of Control wizard. If so, clickFinish.
complete delegation of control wizard
One last thing you need to do within Active Directory is to enable the SP Admin account with the Delete Subtree permission. To do that, go to the View menu and select Advanced Features.
active directory advanced features
This will show more items on the right-hand panel. Right-click on the SharePoint contacts organizational unit you created earlier and select Properties.
organizational unit properties
In the properties window, navigate to the Security tab and click the Advanced button.
 properties security advanced
In the Advanced Security Settings window, select the SPADMIN account.
advanced security settings
This is where you will then find the Delete subtree permission. Check its Allow checkbox.
delete subtree
Click OK to close that window, then click the OK button of each window you encounter until you’re back to the Active Directory Users and Computers window.
Active Directory Users and Computers
With that, you’re done setting what needs to be set in Active Directory so that your contacts will show up in your Outlook address book. The final step is to do an IIS reset on your SharePoint server.
Go back now to the SharePoint server. Right-click on the PowerShell quick-launch icon then click Run as Administrator.
power shell run as admin
When the dialog window appears, click Yes.
user account control
In the PowerShell, type in iisreset to start the reset process. Wait until the reset completes, then close the window.
iisreset
Although you’re already done with this phase, the next few steps will still be performed in the SharePoint server environment, so keep it open.

Configuring Incoming Email Settings in Central Administration

You’re now ready to configure incoming email settings from inside Central Administration. To begin, launch the SharePoint Central Administration.
sharepoint central administration
Once inside the Central Administration, go to the left side of the screen and click System Settings.
central administration window
Under E-Mail and Text Messages (SMS), click Configure incoming e-mail settings.
configuring incoming email settings
On the right-hand side of the screen, you’ll see a bunch of option buttons, text fields, and checkboxes that will allow you to specify certain configuration settings. Apply the following settings:
  • Enable sites on this server to receive e-mail?
Select Yes
  • Settings mode:
Select Automatic
  • Use the SharePoint Directory Management Service to create distribution groups and contacts?
Select Yes
 Central Administration 1
  • Active Directory container where new distribution groups and contacts will be created:
Enter the name of the container using this format:
OU=[ContainerName], DC=[domain], DC=[com],
wherein ContainerName is the name of the Organizational Unit you created earlier, domain is the second-level domain, and com is the top-level domain.
For example: OU=SP Contacts, DC=carvedrockfitness, DC=com
  • SMTP mail server for incoming mail:
This is usually filled in automatically, so just check if it is correct.
  • Accept messages from authenticated users only?
Select No
  • Allow creation of distribution groups from SharePoint sites?
Select No. One offshoot of selecting this option is that you won’t need the approval settings that follow. This is why you’ll then see the check boxes being grayed out.
Central Administration 2
  • E-mail server display address:
Leave as is.
  • Select Accept mail from all e-mail servers
When you’re done with all these, click OK.
Central Administration 3
With the configurations you just did, certain changes are expected to automatically take effect on the Drop folder. Thus, you can verify whether the configuration process all went well by checking the Drop folder to see whether those changes did in fact take effect.
To do that, navigate to Start > Computer > C: > inetpub > mailroot. There you’ll find the drop folder.
drop folder
Right-click on the Drop folder and select Properties.
drop folder properties
When the Drop Properties window appears, navigate to the Security tab. Scroll down the list of Group or user names and see if the items “WSS_ADMIN_WPG...” and “WSS_WPG...are present. If they are, then you’re good to go.
drop properties
Configurations to add a library as a contact under your organizational unit
Before you can go to the main process of checking whether your SharePoint incoming email feature is working, you’ll need to perform just a few more configuration steps. Go now to a client system, open a Web browser and navigate to your SharePoint site.
Next, go to the Libraries section and click a link to a library (we assume you already have some in there). In our example, the library we’re about to open is called Recipes.
sharepoint site
To change the settings of that library, go to the Library tab and click Library Settings.
library settings
Go to the Communications section and click the link named Incoming e-mail settings.
Communications incoming e-mail settings
On the right-hand side of the screen, you’ll see another bunch of option buttons and text fields that will allow you to specify configuration settings for this library. Apply the following settings:
  • Allow this document library to receive e-mail?
Select Yes.
  • E-mail address:
Assign a name for the e-mail address.
  • Group attachments in folders?
Select an option that’s best suited for you.
  • Overwrite files with the same name?
Select No.
incoming email settings
  • Save original e-mail?
Select Yes.
  • Save meeting invitations?
Select No.
  • E-mail security policy:
At this point, just select Accept e-mail messages from any sender. However, in a real-world scenario, you might want to choose the first option.
incoming email settings 2
When you’re done with all those settings, click OK. After that, the library whose settings you just configured will automatically be added as a contact under the Organizational Unit created earlier. This is now a result of all those numerous steps you went through.

Go now to Active Directory Users and Computers and navigate to the Organizational Unit in question (‘SP Contacts’, in our case). You should see the library there now.
newly added contacts in Active Directory OU
You’ll also see that contact in Exchange Server. Go to Exchange Server now, launch theExchange Management Console, and navigate to Recipient Configuration > Mail Contact. You should see the library contact there as well.
 library mail contact in exchange
Testing if the SharePoint Incoming Email feature actually works
It’s finally payback time. You’re finally ready to perform a basic test on the feature you’ve taken so long to configure.
Get back to your client system, launch Microsoft Outlook, and create a New email.
create a new email in MS Outlook
In the To: field, enter the email address of the library that was newly added as a contact. Enter a subject, put some text into the body, attach a file, and send.
creating an email
If you go back to the SharePoint site and open the library, you should be able to see both the email and the attached file. If they’re there, then heave a sigh of relief. This means, you have just accomplished what you have set out to do in the first part of this tutorial, and that is to configure SharePoint for Incoming Email.
checking the email in the SharePoint library