Notice: This Knowledge Base article pertains specifically to the DeploymentPro for UserActivation product, and not to the DeploymentPro product that is part of MSPComplete.
What is the process for installing DeploymentPro for UserActivation from a shared location?
When installing the DeploymentPro for UserActivation Agent from a shared network location, the process is defined by four phases: Admin Download, End User Install, Monitoring, and Outlook Configuration.
Admin Download / Install:
In order to prepare for running DeploymentPro for UserActivation from a shared network location, the admin should complete the following steps:
Download Bootstrap.exe from the UserActivation website. It can also be downloaded here.
Open up the command prompt, navigate to the location that was downloaded via the Bootstrap.exe, and run bootstrap.exe /preinstall. This will download both the x86 and x64 versions of DeploymentPro for UserActivation and will open Windows Explorer to show the result.
Copy all content to a shared location that all users can access.
End User Install:
The install phase begins with the email to the end user. UserActivation will send an email to every user who has DeploymentPro for UserActivation as a feature of their profile. This email contains a unique authentication code.
Also Included in the email template is the option to insert a shared drive location that the users can be instructed to install the Bootstrap.exe from. Simply replace the [Link] in the email template with the location of the Bootstrap.exe on the shared location.
When the Bootstrap.exe file is run, it will launch a command window that will complete the following:
- Check to see if the user meets the minimum system requirements to run DeploymentPro for UserActivation.
- If the user's computer does not meet minimum system requirements, the installer will stop and display an error.
- If the user's computer does meet the requirements the installer will continue to run.
The download normally takes two to five minutes but, depending on bandwidth speed, it can take longer. The Bootstrap.exe has a timeout function that will stop the download and show an error after one hour.
Once the download completes, there will be a notification in the system tray, and UserActivation will display a dialog box asking for the authentication code that was provided in the user's email.
- Note: This window can be closed by clicking the red X but can be re-opened by clicking on the icon in the system tray. The process will not continue until the user inputs a valid authentication code.
Once the install is completed, users immediately enter the monitoring phase. During this phase, there will be a process running in the background called Guardian. This Guardian process communicates with our UserActivation servers to receive instructions on what actions it should take, and doesn't do anything to the end user's computer until the DNS cutover has been processed. Once the DNS cutover has been processed, our UserActivation servers signal down to the Guardian processes to create and configure the new mail profile for Office 365.
Monitor the Project Dashboard to see who has completed the install successfully.
Once the Guardian receives the signal from the UserActivation servers that the DNS records have been cutover, it launches the OutlookConfigurator.exe file. This will launch the DeploymentPro Wizard, which will guide the user through the configuration process below.
The first page of the wizard provides instructions to the end user to make sure they complete the entire wizard so that they do not lose access to their email.
The second page of the wizard is the Password page where users will either create a new password for Office 365 or use an existing password.
The third page of the wizard displays the status of the configuration.
- If the configuration succeeds, they will move to the final confirmation page.
If the automatic configuration fails, the DeploymentPro agent will provide the settings that the user will need in order to configure Outlook manually as well as links to our Knowledge Base articles with detailed, step-by-step instructions to manually create a new Outlook profile.
The last page of the wizard is the confirmation page. This page shows that we have successfully configured a new profile, and instructs the user to restart Outlook.
Once DeploymentPro is complete, the Guardian process will stop running once we confirm that the configuration has completed successfully.