Drawings2CM Installation Guide
DISCLAIMER
Any advice FYB provide in relation to setting up any FYB App, FYB Add-in, FYB Connector and or advice in relation to opening access to your on-premise or in the cloud systems will be general advice only. This means that the advice is of a general nature and will not take into account your network setup, network infrastructure or any security requirements that you may have or in fact need. It is highly advised that you seek advice from internal or external providers to ensure that they are comfortable with what is required prior to going ahead with any deployment, setup or configuration for external access.
Upgrading from version 1.0.22 will cause a breaking change. To preserve existing settings, a backup of your current version must be taken and existing settings will need to be re-imported via the admin console after installation is complete.
You should complete a full uninstall of the previous version before installing this version. The uninstall steps can be found in the relevant versions installation guide.
LICENSE DETAILS
Please contact FYB for a valid license if you have yet to obtain one for your Connector.
INSTALLATION COMPONENTS
The following installation components are required for Drawings2CM:
- Drawings2CM web application - this is a server-side installation
- Power Automate Flows - required for the workflow engine
AUTHENTICATION
The Drawings2CM application uses Azure AD authentication to validate the user’s credentials. Users will be required to enter their Microsoft 365 login details to sign into the application. The user's Microsoft 365 login will need to be populated on their Content Manager profile so that the authenticated user can connect to Content Manager. This is done using the alternate login field.

INSTALLING THE DRAWINGS2CM WEB APPLICATION
LICENSE
-
Create a folder to house the license file (.lic) on the required web server
-
Place the license file in this folder
NoteYou will be asked to enter this location during the installation.
TRUSTED USER ACCOUNT
- Add the account that will run the application pool as a Trusted User Account in Enterprise Studio. Please refer to your Enterprise Studio help file on adding trusted accounts. If using a system account (application pool identity, network service, etc), you will be required to enter the details as DOMAIN\ServerName$. If using a dedicated Windows service account, you will be required to enter the details as DOMAIN\username.
- The account running the app pool will need to have a valid Content Manager login
INSTALLATION
Before running the MSI ensure that all prerequisites are complete. Including deploying the .NET 10 SDK and Hosting Bundle.
To deploy the Net Core SDK and Hosting Bundle to the server, follow these steps:
-
Install the latest .NET 10 SDK (x64) found here

-
Install the latest ASP.NET Core 8 Runtime Hosting Bundle found here

-
Once both executables have been installed, complete a full server restart to allow for .NET 10 to bind to IIS. If a server restart is not possible an IIS reset can be completed with the following CMDs from an elevated command prompt.
- net stop was /y
- net start w3svc
- iisreset
NoteTo check that the SDK has been attached to the hosting bundle, open Command Prompt and type dotnet --info
Once the above is completed you can run the Drawings2CM MSI which will complete the following:
- Deploy the installation files
- Setup the application pool and application in IIS
- Setup the temp folder
- Configure the Drawings2CM as specified by the user
To install the Drawings2CM web service, follow these steps:
-
Run command prompt as an administrator and launch the drawings2cm-xxx.msi
-
Click on the Next button

-
On the Web Application Settings screen select the HTTPS protected site to host the application. Click Next
NoteThe virtual directory name must remain as Drawings2CM and it cannot be renamed. The virtual directory must match the redirect URI setup for the application on Azure AD.
IIS DirectoryThe application must be installed under the dedicated site as an application. It cannot be installed at the site level

-
On the Application Pool Settings screen (below), enter the domain, username, and password for the Application Pool identity
-
Click Next

-
On the Configuration Settings screen enter the required information. Further details are in the table below
NotePlease refer to the AZURE APP REGISTRATION guide for more information on:
- Application ID
- Redirect URL
- Tenant ID
- Certificate Name

FIELD DESCRIPTION Dataset ID Content Manager two-character dataset identifier Workgroup Server Content Manager workgroup server name. This should generally be set to local Workgroup Server URL Content Manager workgroup server URL. License Path Local path to Drawings2CM license file Temp Path Local temporary directory used by the application to cache content manager documents Redirect URL The URL where Azure will send the authentication payload upon successful authentication. Application ID The application ID for the registered app on AzureAD Tenant ID The organization tenant's unique identifier on AzureAD Certificate Name The friendly name of the nominated certificate (.pfx) installed on the server. -
On the Email Settings screen, enter the following fields

FIELD DESCRIPTION License Contacts Contacts that will receive a notification when the Drawings2CM license is about to expire. Multiple email addresses can be added if separated with a ; From Address The email address that all email notifications are sent from. Mail Host The mail host that is used to send all email notifications. Mail Port The mail port -
On the Custom Setup screen select the install location and click on the Next button

-
Confirm the installation by clicking on the Install button

-
Once the installation is complete click on the Finish button
CONFIGURATION
IIS CONFIGURATION
-
After the installation process is complete, you will be able to locate the application installed within the site selected during installation
-
From the Features View double click on Authentication and ensure that only Anonymous Authentication is enabled

-
Right-click the application in IIS and select explore

-
Right click the app data folder and select properties

-
Navigate to the security tab and ensure users have read, write and modify permissions

-
Click on Application Pools

-
Locate Drawings2CM and click Advanced Settings

-
Under General ensure that Start Mode is set to Always Running

-
Under Process Model ensure that: • Idle Time-out (minutes) is set to 0 • Idle Time-out Action is set to Suspend

-
Click on the OK button
-
Right click on the Drawings2CM app and navigate to Manage Application > Advanced Settings

-
Ensure that Preload Enabled is set to true

CONTENT MANAGER CONFIGURATION
The following additional fields need to be created in Content Manager. Any record type that you wish to use with Drawings2CM will need to have these fields attached.
| Name | Data Format | Description | Record Types |
|---|---|---|---|
| 365ID | String, Maximum Length: 255 | Stores the document's SharePoint Id. Prevents duplication of Sharepoint documents that have been transferred to CM as Records | Document |
| Asset Id | String, Maximum Length: 255 | Used when searching for Drawings Records as well as a field in the CSV file generated by a Transmittal | Document |
| Bay Id | String, Maximum Length: 255 | Used when searching for Drawings Records as well as a field in the CSV file generated by a Transmittal | Document |
| Channel Name | String, Maximum Length: 255 | Used to store the name of the Team Channel that the document was checked out to | Document |
| Drawing Group | String, Lookup Set | Used as a field when generating the transmittal CSV | Document |
| Drawing Location | Location | Used as a field when generating the transmittal CSV | Document |
| Drawing Number | String, Maximum Length: 255 | Used when searching for Drawings Records as well as a field in the CSV file generated by a Transmittal | Document |
| Drawing Status | String, Lookup Set | Used as a field when generating the transmittal CSV | Document |
| Drawing Type | String, Lookup Set | Used when searching for Drawings Records as well as a field in the CSV file generated by a Transmittal | Document |
| Project Id | String, Maximum Length: 255 | Stores the Project Id when creating a Project | Document |
| Team Name | String, Maximum Length: 255 | Used to store the name of the Microsoft Team that the document was checked out to | Document |
DRAWINGS2CM CONFIGURATION
-
Navigate to Drawings2CM in the browser of your choice and click on the Admin button
-
Click on the Misc tab
-
Specify the Record Type to be used for Drawings2CM and fill in the mandatory fields associated with the record type

-
Scroll to the bottom of the page and click on the Save button

INSTALLING CM LAUNCHER
The FYB CMLauncher can be installed if required. It allows users to open documents in AutoCAD from Drawings2CM. CMLauncher needs to be deployed to the user's PC.
Please refer to the CMLauncher Installation Guide for further details.
UNINSTALLING DRAWINGS2CM
To uninstall FYB Drawings2CM manually please follow the steps below:
-
Navigate to the Control Panel
-
Click on Uninstall a program
-
Locate FYB Drawings2CM in the list of Programs and feature
-
Right-click on FYB Drawings2CMM and click on Uninstall

-
If a warning Prompt appears, click on the continue button
-
Click on the Yes button

-
The uninstallation process will commence

-
Open IIS once the uninstallation process is completed
-
Locate Drawings2CM in IIS, right click and click the Remove button

-
When the prompt appears click the “Yes” button

