• Release History
  • Documentation
  • Back to www.mscrm-addons.com
  • Release History
  • Documentation
  • Back to www.mscrm-addons.com
home/Knowledge Base/AttachmentExtractor (AE)/Installing the AttachmentExtractor Service on Your Own Azure Virtual Machine

Installing the AttachmentExtractor Service on Your Own Azure Virtual Machine

449 views 0 Updated on July 25, 2022

This articles outlines how to deploy Attachment Extractor Service on your own virtual machine. 

Go to the Microsoft Azure site to purchase your Virtual Machine:  https://azure.microsoft.com/en-us/pricing/calculator/

Recommended Virtual Machine Sizing

 

  • Region: Select same Region where your Dynamics 365 environment is hosted
  • Operating System: Select “Windows”
  • Type: Select “(OS Only)”
  • Tier:  Select “Standard”
  • Instance: Select “D2s v4: 2vCPUs, 8GB RAM, 0GB Temporary Storage……”

Please note:  The additional “Managed Disks” and “Storage Transactions” options are not required. No additional software should be needed:

1. Managed Disks: 

2. Storage Transactions:

Virtual Machine Pre-Requisites if Building Your Own Virtual Machine

  • If building your own Virtual Machine vs purchasing a new Azure Virtual Machine and given the option, we recommend installing Windows Server 2019.
  • Other compatible server operating systems include: Windows Server 2016 and Windows Server 2012
  • It is recommended for best performance that the Virtual Machine for your AttachmentExtractor Service be located in the same datacenter your Dynamics 365-instance itself is located (i.e., inside the same network and physically close as possible).
  • No other software is required (For Server 2012 .Net 4.6.2 installation is required).

AttachmentExtractor Installation

The AttachmentExtractor Installation consists of two main parts:

  • Server Install: Installation of AttachmentExtractor Service and import of AttachmentExtractor Managed Solutions into the Dynamics 365 environment.

AttachmentExtractor Installation and configuration is covered in our Installation Guide:

AttachmentExtractor Installation GuideEN1/16/2018904.21 KBDownload
AttachmentExtractor Server ReadmeEN10/2/2018102.50 KBDownload
AttachmentExtractor User GuideEN8/21/20191.27 MBDownload

Virtual Machine Architecture and Security for AttachmentExtractor

When installing AttachmentExtractor on your own hosted Virtual Machine, mscrm-addons.com does not have any direct access to your hosted Virtual Machine or other systems (i.e., Dynamics 365, SharePoint, etc.).

Scheme Diagram and Process Flow

This article outlines how the Cloud service structure for AttachmentExtractor works. AttachmentExtractor will retrieve attachments from a Dynamics 365 instance, move them to an alternative storage location and deliver them back to Dynamics 365 upon user request.

As you can see the figure below shows the Data Flow of AttachmentExtractor in the Cloud.  You have the option of using our hosted Azure cloud to host this service, or installing the AttachmentExtractor Service on your own hosted Virtual Machine:


Figure: Data flow of AttachmentExtractor in the Cloud

Setup:

The AttachmentExtractor Service should be hosted in the same datacenter the Dynamics 365 environment is hosted to ensure high performance. 

Data flow: 

  • Document Extraction: Based on configuration, the AttachmentExtractor-service checks for new documents in notes or e-mail attachments every X seconds and moves them to the alternative storage (SharePoint or Azure Blob Storage). At the same time, a 2nd query starts working towards historic entries.
  • If an attachment is found, the service moves the file to the corresponding storage location and replaces the reference inside Dynamics 365.
    Please note: For users, navigation and access inside Dynamics 365 is unchanged.
    ​

Data flow on Retrieval:

AttachmentExtractor now features a new Plugin which streams the actual attachments instead of the SharePoint link on every file access.


Figure 1: CRM Default

With older AttachmentExtractor versions, the attachment was moved to SharePoint and replaced with a link in CRM. When users or programs tried to access the attachments, they were only able to get a link file that pointed to the same new save location. 


Figure 3: New versions 2017.8 onwards of CRM and AttachmentExtractor

Security:
All communication between the Dynamics 365 organization and the AttachmentExtractor service is done using the Dynamics 365 web-services and thus is secured communication using https and authenticated likewise to Dynamics 365 itself supporting Server2Server authentication or access via Office 365 credentials. Attachments never get stored on the Service engine.

Please note: When using our hosted AttachmentExtractor Service, we recommend using Server2Server authentication to communicate from the cloud-service to Dynamics 365 to eliminate the need to store login credentials locally on the Virtual Machine.  This is a good practice when self-hosting the AttachmentExtractor service as well.

IMPORTANT:
Customers with security concerns regarding our document generation services are eligible to install AttachmentExtractor either on their own Azure Virtual Machine or on local hardware. Please note that for performance reasons an installation in the Virtual Machine is recommended.

For Dynamics 365 Online customers the document generation service will be hosted in our Azure account. To ensure high performance it will be located in the same datacenter the Dynamics 365-instance itself is located. The installation can be done directly from our website http://www.mscrm-addons.com.

That’s it! We appreciate your feedback! Please share your thoughts by sending an email to support@mscrm-addons.com. 

Was this helpful?

Yes  No
Related Articles
  • How to control access to the AttachmentExtractor Config
  • What is “Bandwidth per month”
  • Datacenter Locations
  • Replace Microsoft Labs Attachment Management
  • Extract Emails within Queues in Dynamics 365
  • How to control access to the DocumentsCorePack configuration
Leave A Comment Cancel reply

You must be logged in to post a comment.

Latest Articles
  • How to share the Connection of the DocumentsCorePack Connector
  • How to update the metadata in the DocumentsCorePack Template Designer
  • Working with Product Properties in DocumentsCorePack
  • How to work with the Relationship Manager
  • Using virtual tables in DocumentsCorePack
Popular Articles
  • Where do I find the Unique Organization name in Microsoft Dynamics 365?
  • DocumentsCorePack Template Designer – Getting Started
  • mscrm-addons.com Application Access for Dynamics 365 (App Access) – DocumentsCorePack
  • DocumentsCorePack Online Service Configuration
  • Step-by-Step: How to configure a One-Click-Action
Top Rated Articles
  • IMPORTANT information for Dynamics 365 online customers using DocumentsCorePack and/or AttachmentExtractor
  • How to activate the DocumentsCorePack connector for PowerApps & Microsoft Flow
  • Step-by-Step: How to configure a One-Click-Action
  • Online Services: Required Application Permissions
  • Where do I find the Unique Organization name in Microsoft Dynamics 365?
Categories
  • *News and General Infos* 51
  • Webinars 35
  • Template Designer(DCP 179
  • DocumentsCorePack(DCP 192
  • TelephoneIntegration (TI 65
  • AttachmentExtractor (AE 62
  • PowerSearch (PS 48
  • ActivityTools (AT 59
  • SmartBar (SB 53
  • GroupCalendar (GC 46
Our Vision

“We see it as our purpose to provide products that simplify and speed up our customers’ Microsoft Dynamics 365 experience.”

Knowledgebase
LogIn
mscrm-addons.com
  • Products
  • Online Shop
  • Downloads
  • My Account
About Us
  • About Us
  • Case Studies
  • Newsletter
  • Partner Program
  • Contact
Support
  • Support
  • Terms & Conditions
  • Documentation
  • Webinars
  • Legal Documents
  • Impressum
  • © 2022 www.mscrm-addons.com. All Rights Reserved.