Chat now with support
Chat with Support

Integration for Notes 20.13 - User Guide - BTCal

Section 1: Introduction Section 2: Features and Advantages Section 3: Scope Section 4: Recommended Installer Prerequisites Section 5: Pre-installation Requirements Section 6: Configure the Domino Environment Section 7: Configure Integration for Notes BTCal in Exchange or Office 365 Section 8: Licenses Section 9: Installing Integration for Notes Section 10: Create and Configure Domino Databases Section 11: Modify the Notes.ini File Section 12: Re-start BTCal Domino server to bring it online Section 13: Verification Section 14: On-going Administration Appendix A: ZApp Appendix B: Configure GRIP Appendix C: On the Fly Encryption and Decryption Appendix D: Disable Encrypted Message Routing Appendix E: High Availability/Redundancy Mail and Calendar Routing for Foreign Domains Appendix F: Notes.ini Parameter Descriptions Appendix G: Notes.ini Parameter Values Appendix H: Considerations for Domino SMTP Domain Exposure Appendix I: Processing Repeating Meetings Appendix J: Deployment Quick Reference Appendix K: Customizable Non Delivery Report (NDR) Reason Codes Appendix L: Cross Platform Delegation Appendix M: BT Stats Database

Section 7: Configure Integration for Notes BTCal in Exchange or Office 365

The last step before installing BTCal, involves configuring Exchange to send messages from Exchange to Domino. For detailed instructions on the necessary changes, click on or scroll to the environment that matches your own:

7.1 Office 365 (O365)

7.2 On-Premises Exchange

 

7.1 Office 365 (O365)

7.1    Office 365 (O365)

The administrator performing the configuration must have access to the following:

  • The Exchange Management Console or the Exchange Azure Management Console (depending upon the environment)

  • The customer tenant with an administrative level tenant account

 


Unless otherwise specified in this document, default configuration values are used.

Perform the following steps from the O365 client tenant interface:

  1. Log into the customer’s O365 tenant. Go to the Exchange Administration section - https://login.microsoftonline.com/

  2. Navigate to the Mail Flow section in the Exchange Online Administration Center (Admin Center)

 

If using PowerShell, execute the following commands to connect to O365:

PowerShell

$Cred = Get-Credential “admin@tenant.onmicrosoft.com

$Session = New-PSSession -ConfigurationName Microsoft.Exchange -ConnectionUri https://ps.outlook.com/powershell/ -Credential $Cred -Authentication Basic

–AllowRedirection 

Import-PSSession $Session 

Import-Module msonline

Connect-MsolService -Credential $Cred

 

7.1.1 Create a New Remote Domain

Create a new Remote domain to define message transfer settings between O365 and domains outside the internal Exchange organization.


It is advised to create a new remote domain, apart from the default "*", to allow for specific mail format parameters with domino SMTP while not disturbing internet mail formatting.

Create a new Remote Domain with the following settings:

Field

Value

Name

domino.domain.com

Domain Name (as specified in the pre-install reqs)

domino.domain.com

Be sure to allow internal out of office replies.

User Rich Text Format

Never

If using PowerShell to create a new Remote Domain, from the Windows PowerShell console using the Azure PowerShell Module, execute the following two PowerShell commands:

PowerShell

New-RemoteDomain -Name domino.btm.com -DomainName domino.btm.com Set-RemoteDomain –Identity domino.btm.com -AllowedOOFType InternalLegacy -DeliveryReportEnabled $true –IsInternal $true –TrustedMailInboundEnabled $true -TNEFEnabled $false

 

7.1.2 Create a New Accepted Domain

If you are using the tenant.onmicrosoft.com domain for routing Domino to O365 mail, skip to the next step.

Accepted domains are the SMTP name spaces (also known as address spaces) configured in an O365 organization to receive email messages.

To create a new Accepted domain, follow these steps:

  1. Log into the Windows Coexistence Server and open the Office 365 Admin Center

  2. In the Office 365 Admin Center, in the left pane, click Organization Configuration/Hub Transport, and then click the Accepted Domains tab

  3. If the exch.contoso.com domain does not exist, in the right pane, click the New Accepted Domain option

  4. If it does not exist, specify the following details in the new window:

    • In the Name field, enter the other domain name and add a comment that represents Domino Users; for example, Exchange Sub-Domain (Inbound from Domino)

    • Accepted Domain: Specify the domain name. For example: exch.contoso.com

      The new accepted domain should now appear for incoming traffic from Domino that will be delivered to the new Exchange users. This accepted domain was set up to be authoritative for the domain. This domain will accept email addressed to the exch.contoso.com domain and deliver to Exchange users with a matching Proxy Address.

If using PowerShell to create a new Accepted Domain, from the Windows PowerShell console using the Azure PowerShell Module, execute the Powershell commands shown below; click New when complete.

PowerShell

New-AcceptedDomain -DomainName exch.<CustomerSMTPDomain> -DomainType Authoritative -Name exch.<CustomerSMTPDomain>

 

7.1.3    Create a Send Connector

Create and configure a send connector from Exchange to Domino. This connector defines the path to route the Domino mail from O365 for AD objects where the user’s mailbox is still in Domino.


This is one area in the coexistence process that can vary from customer to customer depending on what other type of routing they will be doing from O365, such as to internet or to other domains.

  1. Open the O365 Admin Center

  2. Navigate to the Send Connectors, and then select New Send Connector

  3. Configure the new Send Connector with the following settings:

Field

Value

From

Office 365

To

<Your organization’s mail server>

Name

“ToDomino”

What do you want to do after the connector is saved?

  • Turn On

  • Retain Internal Exchange Email Headers

When do you want to use this connector?

Only when email messages are sent to these domains

Click the plus sign (+) and add the Remote Domain Names (e.g. <Domino.domain.com>)

How do you want to route email messages?

<Enter the IP or DNS as defined in the Administrator Pre-Install Checklist>

How should Office 365 connect to your server(s)?

  • Be sure that Always Use TLS is unchecked.

Validate Connector

Enter a valid Domino SMTP address

Save and Close

 

Now that the SMTP Send Connector has been successfully created, O365 can connect to the Domino Coexistence server for contacts in O365 that don’t have a mailbox. Keep in mind that a mail-enabled object or mail-enabled contact with a target address of domino.domain.com will be required to route mail.

 

 

7.1.4 Create a Receive Connector

Create and configure the Receive Connector in the Office 365 Admin Center. A Receive Connector must be configured to allow messages from Domino to enter the Exchange Server 2007 environment.

  1. Start the Office 365 Admin Center for Domino from the Start menu as illustrated below

  2. Select Hub Transport from Server Configuration in the left pane, and then click New Receive Connector

  3. Similar to the Send Connector configuration, configure these two items as follows:

    • In the Name field, enter hub server name and add a comment that this is a connection to Domino users; for example: Receive from Domino

    • Leave the Intended use field as Custom

  4. Accept the defaults. This will allow O365 to listen on all IP addresses assigned to it

  5. Specify the IP address of the Domino Coexistence Server, but first delete the range and add the address

    Be sure to check the IP address of the Domino Coexistence Server before specifying it.

  6. Click Next to receive a summary of your receive connector setup

  7. Click Next again

  8. Click New to create the connector

  9. Click Finish

  10. The next step will be to configure the security and permissions for using this connector; right-click on the Receive from Domino connector that was just created and select Properties

  11. Select the Authentication tab. Deselect Transport Layer Security (TLS) and select Externally Secured

  12. Select the Permission Groups tab and select the following permission groups. These will be set for Domino connections

  13. Select Apply

  14. Click OK to save the receive connector security settings. This will complete the connector setup

 

If using PowerShell to create a new Receive Connector, from the Windows PowerShell console, execute the following Powershell commands:

PowerShell

New-ReceiveConnector -Name 'Inbound from Domino' -Usage Custom -Bindings 0.0.0.0:25 -RemoteIPRanges <IP Address of Domino COEX servers (i.e. 10.1.1.1,10.1.1.2)> -PermissionGroups AnonymousUsers,ExchangeServers,ExchangeLegacyServers,Partners

-AuthMechanism ExternalAuthoritative -LiveCredentialEnabled $False

This concludes all the settings required for routing SMTP mail to and from the O365 environment with the Domino Coexistence server. If an on-premises Exchange server is not being configured, skip to the License Key section.

7.2 On-Premises Exchange

7.2    On-Premises Exchange

This section will cover namespace design, shared namespace, and configuring SMTP connectors in Exchange. Depending on the namespace or address book design you use, SMTP connectivity is configured differently, and has slightly different prerequisites. This section will focus strictly on Binary Tree’s best practices and most common scenarios for clients. In the real world, there may be slight differences to this configuration.

The following assumptions have been made about and applied to configuring BTCal in on-premises Exchange:

  • The person performing the configuration has access to the Exchange admin center and Exchange Management Shell

  • The account used to perform the configuration is a member of the Organization Management role group

  • Unless specifically described in this document, any default configuration values will be used

7.2.1 Create a New Remote Domain

Create a new Remote domain to define message transfer settings between Exchange and domains outside the internal Exchange organization.


It is advised to create a new remote domain, apart from the default "*", to allow for specific mail format parameters with domino SMTP while not disturbing internet mail formatting.

A new Remote Domain can only be added via PowerShell. Within the Exchange admin center, there is no option to add a new Remote Domain.

From the Exchange Management Shell console, execute the following two PowerShell commands:

PowerShell

New-RemoteDomain -Name domino.<CustomerSMTPDomain> -DomainName domino.<CustomerSMTPDomain>

Set-RemoteDomain –Identity domino.<CustomerSMTPDomain>) -AllowedOOFType InternalLegacy -DeliveryReportEnabled $true –IsInternal $true

–TrustedMailInboundEnabled $true  -TrustMailOutboundEnabled $true

-TNEFEnabled $false

 

7.2.2 Create a New Accepted Domain

Accepted domains are the SMTP name spaces (also known as address spaces) configured in an Exchange organization to receive email messages.

To create a new Accepted domain, follow these steps:

  1. Log into the Windows Coexistence Server, open Internet Explorer and navigate to the Exchange admin center

  2. On the left-hand side of the Exchange admin center, click mail flow in the Navigation Pane

  3. Click accepted domains

  4. If the exch.contoso.com domain does not exist, the plus sign icon to add a new Accepted domain

  5. In the Accepted Domain – Internet Explorer window that opens, fill out the form as follows:

Field Name

Description

Recommended Value

Name

Enter the other domain name here, with a comment that this represents Domino Users

Ex: ”Exchange Sub-Domain (Inbound from Domino)”

Accepted Domain

Specify the domain name

Ex: “exch.contoso.com”

 

  1. Click the Save button

 

The new accepted domain should now appear for incoming traffic from Domino that will be delivered to the new Exchange users. This accepted domain was set up to be authoritative for the domain. This domain will accept email addressed to the exch.contoso.com domain and deliver to Exchange users with a matching Proxy Address.

If using PowerShell to create a new Accepted Domain, from the Exchange Management Shell console, execute the Powershell commands shown below. Click New when complete.

PowerShell

New-AcceptedDomain -DomainName exchange.<CustomerSMTPDomain>

-DomainType Authoritative -Name exchange.<CustomerSMTPDomain>

 

 

 

7.2.3    Email Address Policy

If using the Shared/Sub-domain namespace design, mailboxes in Exchange Server need to have an email address added in the Exchange domain. Rather than manually updating each user, an Email Address Policy can be created to perform this task.

  1. Click email address policies

  2. Click the plus sign to add a new email address policy

  3. In the Email Address Policy – Internet Explorer window that opens, fill out the form as follows:

 


If you’ve already implemented Directory Sync Pro for Notes, you can skip this step.

  1. In the Policy name textbox, enter a name for the policy that is easy to recognize, e.g. “Exchange Users”

  2. Under the Email address format heading, click the plus sign (+)

     

  3. In the Email Address Format – Webpage Dialog window that opens, enter the recommended values as follows:

    1. Select the Select an accepted domain radio button and choose the Accepted Domain that was created in the steps above; you do not need to specify a custom domain name for the email address

    2. Select the alias@contoso.com radio button from the list of email address formats

    3. Click the Save button

  4. You will then be returned to the Email Address Policy – Internet Explorer window

  5. Under the Run this policy in this sequence with other policies field, select 2 from the drop-down menu

  6. Next, under the Specify the types of recipients this email address policy will apply to field, select the Only the following recipient types radio button and check the following boxes:

  7. There is no need to click the add a rule button; leave as is

  8. Click save

After applying immediately, a summary of the address policies to be created will be displayed. A green check mark displays when completed successfully.

The default address policies that will get stamped on each Exchange user as they are provisioned have successfully been created. The default address policies will ensure that proper namespace and aliases are created in Exchange for mail routing purposes.

If using PowerShell, execute the following commands to create a new email address policy:

PowerShell

New-EmailAddressPolicy -Name "Exchange Users" -IncludedRecipients MailboxUsers,Resources,MailGroups -EnabledEmailAddressTemplates "smtp:%m@exch.btm.com","smtp:%m@exch.btm-lab.com","SMTP:%m@btm.com" Update-EmailAddressPolicy -Identity "Exchange Users"

 

7.2.4    Create a Send Connector

Create and configure a send connector from Exchange to Domino. This connector defines the path to route mail that Exchange does not a have a mailbox for, which will be your Domino contacts.


This is one area in the coexistence process that can vary from customer to customer depending on what other type of routing they will be doing from Exchange, such as to internet or to other domains.

  1. Click send connectors

  2. Click the plus sign (+) to add a new send connector

  3. In the Send Connector – Internet Explorer window that opens, fill out the form as follows:

    1. In the Name field, enter the “other” Domain name with a comment that represents a connection to Domino users (e.g. “Outbound to Domino”)

    2. In the Type field, click the Custom radio button

  4. Click next

  5. Fill out the next form as follows:

    1. Under Network Settings, select the Route mail through smart hosts radio button

    2. Click the plus sign (+) to add a Smart Host

    3. In the Network Settings – Webpage Dialog box that appears, type the fully qualified domain name (FQDN) or IPv4 address (e.g. “myhost.constoso.com” or “192.168.3.2”)

    4. Click save

    5. Leave the Use the external DNS lookup settings on servers with transport roles checkbox unchecked

    6. Click next

  6. Fill out the Configure smart host authentication form as follows:

    1. Under Smart host authentication, be sure that the None radio button is selected

    2. Click next

  7. On the following screen, under Address Space, click the plus sign (+) and fill out the form as follows:

    1. In the Type field, enter SMTP

    2. In the Full Qualified Domain name (FQDN) field, enter the remote domain that you created earlier

    3. In the Cost field, enter 1

    4. Click save

  8. Leave Scoped send connector unchecked

  9. Click next

  10. On the A send connector sends mail from a list of servers… screen, fill out the form as follows:

    1. Under Source Server click the plus sign (+) and fill out the form as follows:

    2. In the Select a Server – Internet Window, select the option with the Hub Transport role.

    3. Click the add -> button

    4. Click ok

  11. Click Finish

Now that the SMTP Send Connector has successfully been created, the Exchange server can connect to the Domino coexistence server and deliver SMTP mail to Domino users.

If using PowerShell to create a new Send Connector, from the Exchange Management Shell console, execute the following Powershell commands:

PowerShell

New-SendConnector -Name ‘Outbound to Domino’ -Usage ‘Custom’ -AddressSpaces domino.<CustomerSMTPDomain>,domino.<CustomerSMTPDomain> -IsScopedConnector $false -DNSRoutingEnabled $false -SmartHosts <IP Address of Domino COEX servers (i.e. 10.1.1.1,10.1.1.2)> -SourceTransportServers BTM-Exch2016

 

7.2.5    Create a Receive Connector

Create and configure the Receive Connector in the Exchange Management Console. A Receive Connector must be configured to allow messages from Domino to enter the Exchange Server 2007 environment.

  1. Click receive connectors

  2. In the Select server field dropdown menu, select your Hub Transport server

  3. Click the plus sign (+) to add a new receive connector

  4. In the This wizard will create a Receive connector window, fill out the form as follows:

    1. In the Name field, enter a name with a comment that represents a connection to Domino users (e.g. “Inbound from Domino”)

    2. The Server field will auto-populate; leave as is

    3. Under Role, click the Hub Transport radio button

    4. Under Type, click the Custom radio button

    5. Click next

  5. Under Network adapter bindings, click the plus sign (+) and fill out the form as follows:

    1. Under Address, click the All available IPv4 addresses radio button

    2. Under Port, enter 25 in the text box

    3. Click save

  6. Click next

  7. In the A receive connector can accept mail… window, under Remote network settings, click the plus sign (+)

    1. In the Remote Address Settings – Webpage Dialog window, you have the option to add a Domino Coexistence Server IP address, otherwise just click save

    2. Click save

  8. Click finish

  9. Once the receive connector has been created, reopen/edit it by selecting the receive connector and clicking the edit icon. In the window that appears, do the following:

    1. Click security

    2. Make sure External secured (for example, with IPsec) is checked

    3. Under Permission groups, check:

      • Exchange servers

      • Legacy Exchange servers

      • Partners

      • Anonymous users

  1. Click save

This concludes all the settings required for routing SMTP mail to and from the Exchange server environment to the Domino Coexistence server. The next step is to set up the Domino SMTP settings.

If using PowerShell to create a new Receive Connector, from the Exchange Management Shell console, execute the following Powershell commands:

PowerShell

New-ReceiveConnector -Name 'Inbound from Domino' -Usage Custom -Bindings 0.0.0.0:25 -RemoteIPRanges <IP Address of Domino COEX servers>(ie 10.1.1.1,10.1.1.2) -PermissionGroups AnonymousUsers,ExchangeServers,ExchangeLegacyServers,Partners -AuthMechanism ExternalAuthoritative -LiveCredentialEnabled $False

Section 8: Licenses

Three types of licenses for BTCal are offered: a fully functional, but expiring, trial license; a full standard license; a standard license with ZApp support. When a trial license expires, the product shuts down and stops working. A standard license (with or without ZApp), however, includes software assurance which allows you to upgrade to any versions of BTCal that become available while the license is valid. When the license expires, BTCal will continue working, but you will need to purchase a new license to upgrade to any new versions.

To apply a license:

  1. Copy the license file to the Domino server.

  2. Use the following command on the Domino console:

    • tell btcal install license <full path to license file>


BTCal should be installed and configured with the BTPROCESSDOMAIN Notes.ini value prior to applying a license.

Additional details about each license type can be found below:

  • A trial license – Expires in 30 days; when a trial license expires, BTCal will shut down and no longer function

  • A regular/standard license – Expires after a set time after license creation; license “timer” starts on the date the license is generated rather than the purchased date;

  • A regular license which includes support for ZApp – Expires after a set time after generation (set by Quest). When a regular license expires, BTCal will continue to operate normally, and ZApp (if licensed) will remain enabled.

If a license will expire, license expiration warnings will be shown on the Domino console and will be emailed to the BTCal administrator (configured during BTCal installation) at the following intervals: 90/30/3/2/1 days left before expiration.

 

Related Documents

The document was helpful.

Select Rating

I easily found the information I needed.

Select Rating