View on GitHub

docs

AgileXRM Documentation

Home –> AgileXRM System Requirements

AgileXRM System Requirements

Introduction

This document describes the supported system requirements for installing the components of the product suite. The following components are included in the product suite:

Requirements are kept in line with Dynamics 365 CE (CRM) System Requirements as described here:

https://docs.microsoft.com/en-us/dynamics365/customerengagement/on-premises/deploy/system-requirements-required-technologies

AgileXRM supports Microsoft Common Data Service (CDS) of Power Platform as well as any Apps built on top of Dyn365/CDS like Microsoft Project Online.

AgileXRM currently does not support Dynamics 365 for Operations or Finance.

Deployment Options

These are the different Deplyment Options that are supported:

# AgileXRM Installed in: Dynamics 356 CE / CDS Online Dynamics 365 CE/CRM installed in Azure VM Dynamics 365 CE/CRM installed in non-Azure VM Dynamics 365 CE/CRM installed in client On-Premise
A Public Cloud (Shared) Y N N N
B Public Cloud (Dedicated) Y Y (*) (*)
C Client Azure VMs
(Managed by AgileXRM)
Y Y (*) (*)
D Client Azure VMs
(Managed by client)
Y Y (*) (*)
E Client Cloud non-Azure VMs (*) (*) Y (*)
F Client On-Premises (*) (*) (*) Y

(*) : Not-Recommended but consult for these combinations, as it maybe supported under certain circumstances.

Deployment Options A and B

AgileXRM in Public Cloud (A-Shared)

This is a tenant in a multi-tenant shared AgileXRM Online pool. One AgileXRM tenant can support any number of Dynamics 365 CE Online organizations and/or Power Platform Common Data Service (CDS) Environments, as long as these are in the same Azure Region. It is possible to connect to client’s on-premise systems via Azure AD Application Proxy.

Figure 1. Public Cloud (Shared)

AgileXRM in Public Cloud (B-Dedicated)

This is a single tenant in a dedicated AgileXRM Online environment. Nothing is shared with any other client. This can support any number of Dynamics 365 CE organizations (both installed or Online) and/or Power Platform Common Data Service (CDS) Environments, as long as these are in the same Azure Region. It is possible to connect to client’s on-premise systems via Azure AD Application Proxy.

Figure 2. Public Cloud (Dedicated)

Server Requirements for Deployment Options C, D, E and F

AgileXRM is very flexible in that it can be installed on one single server for smaller deployments or distributed in a HA cluster for large deployments. The components easily scale out. The information here applies to both physical machines as well as virtual machines. VMs can also be in public Cloud like Azure or other IaaS providers supported by Microsoft. For further information on Virtual Machine support, please see Support for Virtualization Technologies further below.

AgileXRM in Client Azure VM (Options C and D)

This is when AgileXRM is installed in client’s Azure subscription. There is an option that AgileXRM manages the environment as a Managed Service or the client maintains the environment themselves. This can support any number of Dynamics 365 CE organizations and/or Power Platform Common Data Service (CDS) Environments, as long as these are in the same Azure Region. It is possible to connect to client’s on-premise systems via Azure AD Application Proxy.

Figure 3. AgileXRM in Client Azure VMs

AgileXRM Server Requirements

This section provides detailed information about the specific optimal system requirements for an AgileXRM server, where all server components are installed in one server:

Feature Requirements
vCPUs 4
Memory (RAM) 8 GB RAM
Hard Disk 20 GB (RAID 1 or 5) SSD
Network 1 Gb or higher

In Azure VM Size terminology:

AgileXRM Server Installation Prerequisites

In all AgileXRM Servers (64-bit only):

  1. Create a Domain User to be used as a service account (i.e. non-expiring password).
    This user will also be used during the installation process, so it should be allowed to logon to the Windows Server, including via RDP.
    • Add this user to Local Administrator group on the server
    • Create a mailbox for the service account
    • Logon to the server with this user and complete the rest of the tasks with this user
  2. Turn off things that interfere with the installation (all can be turned back on after the installation):
    • Turn off Windows Firewall
    • Turn off AntiVirus
    • Disable UAC and reboot
  3. Decide which ports are going to be used.
    Normally these ports are used:
    • AgileDialogs & ProcessManager: 443 (https) or 8888 (http)
    • WCF Service: 444 (https) or 13487 (http)
    • REST API: 443 (https) or 13490 (http)
    • Admin Portal: 443 (https) or 13491 (http)
  4. Decide which host headers are going to be used.
    Something like this: [can change agilexrm for other word)]
    • AgileDialogs / ProcessManager: agilexrm.contoso.com
    • REST API & WCF Service: agilexrmapi.contoso.com or agilexrm.api.contoso.com
    • Admin Portal: agilexrmportal.contoso.com or agilexrm.portal.contoso.com
  5. If SSL is required then have a valid SSL Certificate available that covers the chosen host headers
  6. Have .NET Framework 4.7.2 or higher enabled/installed
  7. Create the following empty DBs in SQL Server:
    • APDB
    • APMasterPortalDB
    • APTenantPortalDB
    • APArchiveDB
    • Grant db_owner privilege to service account user in all DBs
  8. Provide access to SMTP server for the service account to send emails
  9. Install Chrome or Edge (Chromium version)
  10. Copy AgileXRM Installer ZIP file onto the server

System Requirements for Envision Process Modeler

This section provides detailed information about the specific system requirements for the Envision component of.

Feature Requirements
Processor (CPU) Follow recommendations for your Visio version
Memory (RAM) 1 GB RAM
Hard Disk 500 MB (plus an additional 150+ MB for Microsoft Visio)

Supported Microsoft Products

Operating Systems

Database

NOTE: Support for Azure SQL is on the Roadmap.
SSD disks are highly recommended for Production environments.

Dynamics 365 Customer Engagement / Power Platform Common Data Service (CDS)

NOTE: CRM On-Premise Workgroup Edition is not supported.

SharePoint

Visio

IMPORTANT: The option .NET Programmability Support should be selected when installing Visio.

.NET Framework

Supported Browsers

Support for Virtualization Technologies

AgileXRM is committed to fully supporting running on virtualization technologies. AgileXRM supports both physical server machines as well as virtual machines. AgileXRM recommends Windows Server® Hyper-V™, however other Microsoft and non-Microsoft virtualization products are also supported as discussed in the link below:

http://www.windowsservercatalog.com/results.aspx?&bCatID=1521&cpID=0&avc=0