DeploymentPro Guide

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 (personal storage table) files to the reconfigured email profile. However, DeploymentPro does not set the users’ default email signatures for new messages, replies, and forwards.

Contents:

Prerequisites

Complete these prerequisites before you get started with DeploymentPro:

  1. Create the customer in MSPComplete (if you have not already created one in your MigrationWiz project). Read the View, add, and edit your customers article for more information.
  2. Create the Destination endpoint in MSPComplete (if one has not already been created). Read the View, add, and edit customer endpoints article for more information. The Destination endpoint requires admin credentials to be entered so you can select the endpoint from the endpoint drop-down menu.
  3. Review the system requirements for DMA and for DeploymentPro. See What are the system requirements for DeploymentPro? and Introduction to Device Management for more information.
  4. Install DMA on the customer’s computers for the users who will need their Outlook email profiles reconfigured. For more information, refer to these DMA installation articles:

Important notes:

  • Windows 7+ required for successful installation. Per recent Microsoft update, all computers must also support TLS (transport layer security)1.2.
  • DeploymentPro will not work when two-factor or multi-factor authentication is in place. It is recommend that you disable this during profile configuration.
  • ADFS (active directory federated services) is supported using Basic Authentication and Legacy Authentication turned on. A claim rule is needed for Basic Authentication. All authentication requests are set to come from the client machines. 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, ensure that the users who will need their Outlook email profiles configured by DeploymentPro are listed in MSPComplete with a successful (Success or Timed Out) agent status.

Complete these steps to confirm the users running DMA:

  1. Select the appropriate workgroup, then click All Customers in the left navigation pane.
  2. Click the name of the customer for which you want to view users.
  3. Click the Users tab.
  4. Scroll through the list of users to identify users listed with a successful, unknown, or failed agent status, or with a .local, .corp, .internal, or other private network address.
    • Success means the user is logged in and the DMA is communicating with our servers.
    • Timed Out means that the user has been logged in and DMA was communicating with our servers, but the user has been logged off for more than 4 hours.
    • Failed means that the DMA was not able to be installed. Usually, there is a security program or policy blocking the agent installation.
    • Not Installed means the DMA installer has not been run or this is a duplicate user entry.  Duplicates happen when the agent is installed but is not able to match the user profile with the email address in the Users List.
    • Users with a status of Failed or Not Installed 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 (GPO), you can try re-installing it with an email instead, in case those users are not using domain-joined computers. You can also try performing a few troubleshooting steps as outlined in Troubleshoot connectivity between DMA and MSPComplete.

Note: When you go to the DeploymentPro page you will only see the users that have DMA installed successfully (Success or Timed Out status). These are the only users that will have their profiles configured. 

If you notice that the users showing up in DeploymentPro are under a different email address than what you have licensed, this is because DMA determines the email address for the user when it checks in.  When this occurs, you will sometimes see that the users are not licensed in DeploymentPro even though they are showing as having a UMB license applied when you look at the users in MSPComplete or in your project.  If this happens, please reach out to our Support team with the name of the Customer and a list of the affected users. Our support team will assist with getting the licenses set up so that you can schedule the users.

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.  

Note: DeploymentPro is currently supported only for Office 365. If using DeploymentPro with Exchange (either On-Premises or Hosted) as a Destination, a Proof of Concept should be run first. For more information, see What Destination systems are supported by DeploymentPro?

Complete these steps to configure the DeploymentPro project:

  1. Select the appropriate workgroup, and then click the products icon (icon_waffle.png) in the top navigation bar.
  2. Click DeploymentPro in the list of products.
  3. Click the name of the customer for which you want to configure a DeploymentPro project.
  4. 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. If the DeploymentPro module has not yet been set up, the set up screen will load for configuration of the module.

Configuring DeploymentPro

When setting up DeploymentPro, you will have several options that can be used.  These are explained below:

Destination Domain Name: Enter the customer’s email domain.

Select Destination Endpoint: Select the Office 365 Destination endpoint. This endpoint must have Admin credentials entered.

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:
     Users must know their currently 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. 

Upload Logo: Click Upload Logo to upload your company’s logo for use in the DeploymentPro wizard that runs on users’ computers. For more information see What are acceptable specifications for the logo used by DeploymentPro?

Message: Enter a message to display a customized note in the DeploymentPro wizard that runs on users’ computers.

Schedule Users

After the DeploymentPro project is configured, we recommend that you schedule the users as soon as possible even if the email cutover (MX record cutover) won't happen immediately. Read the Troubleshoot DeploymentPro article for more information.

Complete these steps to schedule the DeploymentPro module:

  1. Select the appropriate workgroup, and then click All Customers in the left navigation pane.
  2. Click the name of the customer you wish to schedule.
  3. Click the Manage button in the top right corner of the page, then select Device Management.
  4. Click DeploymentPro in the left navigation pane.
  5. Add a checkmark next to the email addresses for which you want to run the DeploymentPro module, then click Schedule Cutover.
    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.
  6. 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, select a date far in the future (i.e., a few months later than the expected cutover date). When you do this, also set a reminder 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.
  7. Click Schedule Cutover.
    Note: To run the DeploymentPro module, you must either have DeploymentPro licenses available on your account or have applied User Migration Bundle licenses to each user. Refer to View, purchase, and edit subscriptions and Apply User Migration Bundle licenses to the Customer's Users for more information. Standalone DeploymentPro licenses are consumed automatically when an unlicensed user is scheduled.

After DeploymentPro is scheduled, and before the scheduled start date/time, the email addresses should be in the "Scheduled" phase on the DeploymentPro page. When the scheduled start date/time is reached, the email addresses will be in the "Running" phase. If some of the email addresses listed don't progress to the "Running" phase, you may need to perform some troubleshooting actions to get them to the appropriate phase. Read Troubleshoot DeploymentPro for more information.


Note: Scheduled time is based on the local time of the machine that is scheduling the request.

Next steps

  • Perform the mailbox migration. Follow the steps in the appropriate 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. Read End user experience when DeploymentPro reconfigures their Outlook profile for more information.
Was this article helpful?
3 out of 5 found this helpful