This article applies to the following products:
- Messageware ActiveSend
SUMMARY
Messageware ActiveSend can be set up for automated deployment, making it easier for organizations to configure and deploy the software. This article outlines the configuration needed to set up automated deployment for ActiveSend with Office365 mailboxes.
Configuring the ActiveSend Deployment
To configure ActiveSend deployment:
- Edit the activeSendDeployment.xml file configuration as needed
- Create .dep binary configuration file from the .xml using the ActiveSend_du.exe.
The ActiveSend deployment package can be downloaded from the following link:
http://w3.messageware.com/download/support/Updates/Messageware_Deployment_Tools/ActiveSend/ActiveSend_Deployment.zip
The link contains:
- activeSendDeployment.xml file
- ActiveSend_du.exe
- ActiveSend Deployment documents.
The ActiveSend installation file would be provided to you by a member of our sales team. Extract the files and save them to a known location
Deployment file configuration steps:
- Follow the steps below to configure automated deployment for ActiveSend:
- Note: All XML content is case sensitive
Step 1: Edit the .xml deployment file
Edit the activeSendDeployment.xml file with notepad. (In notepad select view > select Status bar, line numbers will now be visible)
- Line 16: <nickname> <value>
- Value by default is "My Mail". Nickname is a description to be used for the user to identify the mailbox
- Line 17: <nickname> <editable>
- By setting the editable value to "false", the end-user will not be able to modify the nickname that is specified by the administrator
-
- Line 20: <autoPopulate>
- If the user's AD login (UPN) format is the same as OWA credentials, then account details can be auto-populated with ActiveSend.
- Examples:
- Valid: myname@mycompany.com
- Invalid: domain\myname
- The value must be set to "true". ActiveSend will automatically use the logged-on user credentials to access the mailbox
-
- Line 26: <autoPopulateUserLogonFormat>
- Value must be set to "Upn"
- "Upn" format: username@domain.com
-
- Line 37: <useOffice365>
- Value must be set to "true"
- By setting this, users will be able to use an office 365 mailbox account
-
- Note: The other 3 entries must be left as default, do not modify these 3 items below:
- <fullOffice365User> true
- <isSeamlessSSO> false
- <editable> true
- Line 47: <owaUrl>
- Only modify if your organization has a unique/custom URL, otherwise, leave as defaults
- Line 48: <graphUrl>
- Only modify if your organization has a unique/custom URL, otherwise, leave as defaults
- Graph URL is the endpoint to the Graph API, this is REST API to modify user's account and the mailbox
- Note: The other 2 entries must be left as default, do not modify these 2 items below:
- <appId>
- <authority>
Step 2: Convert the .xml deployment file to .dep binary deployment file
- Run ActiveSend_du.exe with elevated permission (right-click > run as administrator)
- "Input deployment XML file" - enter the full path and filename to the activeSendDeployment.xml file
- "Output folder" - enter the full path to the directory to store the as.dep binary deployment file
- Click "Create deployment file"
-
Step 3: Silent install ActiveSend with the new as.dep file
- Open command prompt with elevated permission (right-click command prompt > run as administrator)
- Change directory to the ActiveSend .msi installer (Messageware_ActiveSend_<version number>.msi)
- Run the command: msiexec /i <msi installer name> /qn POLICY=c:\<filePath>\as.dep
- /i
- installs the product
- /qn
- no user interface is displayed (silent installation switch)
- /i
Step 4: Verify Install
- Navigate to the control panel and verify that ActiveSend is installed
- It will be like this
- You can now test ActiveSend functionality by doing any of the following:
- Upload file into a new email message by right-clicking on files in Windows Explorer or the desktop and selecting Send To → Mail Recipient.
- Send files from within an application, such as Microsoft Word or Excel, by clicking File → Share → Email