Notice: This Knowledge Base article pertains specifically to the new version of DeploymentPro that is in the MSPComplete portal, and not to the DeploymentPro for UserActivation product.
BitTitan DeploymentPro is a module of Device Management and the Device Management Agent (DMA) that remotely configures Outlook email profiles after you perform a mailbox migration to Microsoft Office 365.
DeploymentPro configures Outlook email profiles to the new Destination server, and moves users’ AutoComplete, email signatures, and PST files to the reconfigured email profile. However, DeploymentPro does not set the users’ default email signatures for new messages, replies, and forwards.
Contents of this guide:
- Confirm that the customer’s users are successfully running DMA
- Configure the DeploymentPro project
- Run the DeploymentPro module
- Next steps
Complete these prerequisites before you get started with DeploymentPro:
- Create the customer in MSPComplete.
For more information: Read the View, add, and edit your customers
- Create the source and destination endpoints in MSPComplete.
For more information: Read the View, add, and edit customer endpoints
- Review the system requirements for DMA and for DeploymentPro.
For more information: Read the What are the system requirements for DeploymentPro? article and the Introduction to Device Management article.
- Install DMA on the customer’s computers for the users who will need their Outlook email profiles reconfigured.
For more information: Read the DMA installation articles listed below:
Important: With respect to HTTP authentication, DeploymentPro supports only "Basic" authentication. For more information, see Understanding HTTP Authentication.
Confirm that the user’s computers are successfully running DMA
After DMA is installed on the user's computers, you must ensure that the users who will need their Outlook email profiles configured by DeploymentPro are listed in MSPComplete with a successful () agent status.
Complete these steps to confirm the users running DMA:
- Select the appropriate workgroup, and then click All Customers in the left navigation pane.
- Click the name of the customer for which you want to view users.
- Click the Users tab.
- Scroll through the list of users to identify users who are listed with a successful agent status, an unknown or failed agent status, or with a .local, .corp, .internal, or other private network address.
- Users who are listed with a successful () agent status will have their Outlook email profiles reconfigured by DeploymentPro.
- Users who are listed with an unknown () or failed () agent status will not have their Outlook email profiles reconfigured by DeploymentPro.
- If these users need to have their Outlook email profiles reconfigured by DeploymentPro, then you need to install DMA to those users' computers. If you have already tried to install DMA to those users' computers, then try to reinstall it using an alternate method. For example, if you previously tried to install DMA using a Group Policy Object, you might try re-installing it with an email instead, in case those users are not using domain-joined computers. You might also want to try performing a few troubleshooting steps as outlined in the Troubleshoot connectivity between DMA and MSPComplete article.
- Users who are listed with a .local, .corp, .internal, or other private network address will not have their Outlook email profiles reconfigured by DeploymentPro.
- This happens for users who don’t have an email address defined in their Active Directory properties.
- To ensure DeploymentPro reconfigures these users’ Outlook email profiles, click the ellipsis next to the user, and then click Edit. Modify the user’s private network address to their correct email address and click Save.
Configure the DeploymentPro project
After the users running DMA have been confirmed, it’s time to configure the DeploymentPro project under the Device Management section of MSPComplete.
Complete these steps to configure the DeploymentPro project:
- Select the appropriate workgroup, and then click the products icon () in the top navigation bar.
- Click DeploymentPro in the list of products.
- Click the name of the customer for which you want to configure a DeploymentPro project.
- Enter the following information into the DeploymentPro Module Configuration form:
Enter the customer’s email domain.
Select the Office 365 Destination endpoint.
The Autodiscover URL auto-populates based on the destination endpoint selected.
Certificate Principal Name
The Certificate Principal Name auto-populates based on the destination endpoint selected.
Expired or Temporary Password Settings
Choose the password setting that applies to your customer’s environment:
- Choose Enable users with temporary or expired passwords to set their own passwords if your customer uses Office 365 to manage user accounts and password policies. With this setting selected, the DeploymentPro wizard that runs on the customer’s computers will prompt users to enter a new password when their password is expired or set to temporary. DeploymentPro automatically updates Office 365 with the password that Users enter. Important: The Users must know their current expired or temporary password.
- Choose Do not allow users to set their own passwords if your customer manages their user accounts and password policies using ADFS. With this option selected, all user password resets are managed by the company’s IT department.
Click Upload Logo to upload your company’s logo for use in the DeploymentPro wizard that runs on users’ computers.
Enter a message to display a customized note in the DeploymentPro wizard that runs on users’ computers.
For more information: Read the End user experience when DeploymentPro reconfigures their Outlook profile article to see what the customer’s users will experience when the DeploymentPro module runs.
- Click Save and Continue.
The DeploymentPro page is refreshed to list the email addresses for the customer’s users who are successfully running DMA and who are ready to run the DeploymentPro module.
Run the DeploymentPro module
After the DeploymentPro project is configured, we recommend that you run the DeploymentPro module as soon as possible even if the email cutover (MX record cutover) won't happen for some time. When you run the DeploymentPro module, you define the date and time in which the DeploymentPro wizard will run on user computers and DMA immediately downloads the DeploymentPro module to user computers, even if the wizard isn’t scheduled to run for some time. Run the DeploymentPro module right away to give yourself enough time to troubleshoot connectivity issues that might happen when DMA tries to download the DeploymentPro module to user computers. Read the Troubleshoot DeploymentPro article for more information.
Complete these steps to run the DeploymentPro module:
- Select the appropriate workgroup, and then click All Customers in the left navigation pane.
- Click the name of the customer for which you want to run the DeploymentPro module.
- Click the Manage button in the top right corner of the page, and then select Device Management.
- Click DeploymentPro in the left navigation pane.
- Add a checkmark next to the email addresses for which you want to run the DeploymentPro module, and then click Run Module.
Note: We recommend running a proof of concept on a few test accounts. Read the Test DeploymentPro with a couple of users article for more information.
- In the Select a Date field, select a date and time for the DeploymentPro wizard to run on user computers. This date and time should happen soon after the email cutover (MX record cutover) date and time.
Note: If you haven’t identified the email cutover date, then select a date far in the future (i.e., a few months later than the expected cutover date). When you do this, you should also set a reminder for yourself to return to the DeploymentPro page and reschedule the date and time for the DeploymentPro wizard once you've identified the exact date and time for the email cutover.
- Click Run Module.
Note: To run the DeploymentPro module, you must apply subscriptions to each user, or purchase standalone DeploymentPro licenses for each user. Refer to the View, purchase, and edit subscriptions article or the View and purchase licenses article for more information about subscriptions and licenses.
The email addresses selected to run the module will gradually progress to the “Running” phase in the DeploymentPro page. This means that DMA has successfully installed the DeploymentPro module (Outlook Configurator) on the customer’s computers. However, the DeploymentPro wizard that configures users’ Outlook email profiles will not run until the date and time that you defined. If some of the email addresses listed don't progress to the "Running" phase, then you may need to perform some troubleshooting actions to get them to the appropriate phase. Read the Troubleshoot DeploymentPro article for more information.
- Perform the mailbox migration.
For more information: Follow the steps in the migration guide for your customer’s source and destination.
- Soon after the email cutover date and time, the DeploymentPro wizard will guide the customer’s users through the configuration of their Outlook email profiles. As users complete the DeploymentPro wizard, their email addresses will progress to the “Completed” phase on the DeploymentPro page.
For more information: Read the End user experience when DeploymentPro reconfigures their Outlook profile