CM2WebShare 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-premises or in the cloud systems will be general advice only. This means that the advice is of a general nature and will not consider 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 needed prior to going ahead with any deployment, setup, or configuration for external access.
LICENSE DETAILS
Please contact FYB for a valid license if you are yet to obtain one for your Connector.
INSTALLATION COMPONENTS
The following installation components are needed to ensure full functionality of the FYB CM2WebShare:
- FYB CM2WebShare Web Application - This is a server-side installation
- FYB CM Launcher - This is a client-side installation
INSTALLING FYB CM2WEBSHARE WEB APPLICATION
LICENSE
- Create a folder to house the license file (.lic) on the IIS Server
- Place the license file in this folder. You 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
INSTALLATION
Before running the MSI ensure that all prerequisites are complete. Including deploying the .NET 8 SDK and Hosting Bundle.
To deploy the Net Core SDK and Hosting Bundle to the server, follow these steps:
-
Install the latest .NET 8 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 8 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

To install the CM2WebShare, follow these steps:
-
Run command prompt as an administrator and launch the CM2WebShare-xxx.msi
-
Click on the Next Button

-
On the Web Application Settings screen, select a Site to host the application and enter a name for the Virtual Directory
-
Click on the Next button
NoteWe recommend CM2WebShare is installed under an HTTPS protected site.
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, enter the domain, username, and password for the Application Pool identity.
-
Click on the Next button
External ExposureIf you are planning to make CM2WebShare externally accessible, it is strongly recommended that you use a dedicated account or the "Default Application Pool Identity", to restrict the applications access to your server and Content Manager environment.
FYB assumes no responsibility for misuse or unintended access where recommendations have not been followed.
-
On the Configuration Settings screen enter the required settings. Please refer to the table below for configuration settings details.

NAME DESCRIPTION Dataset ID The two alphanumeric character dataset identifier Workgroup Server Name The workgroup server name used for the dataset connection. Connection can be made using either the workgroup server name or workgroup server URL. Workgroup Server URL The workgroup server URL used for the dataset connection. Connection can be made using either the workgroup server name or workgroup server URL License Path The path to your license file including the .lic file Temp Path A temporary location to store data for the application -
Open ID Settings (Optional). The values of the required fields can be found in the respective Open ID guides. These can be found within the VALUES REQUIRED FOR INSTALLATION header of the respective Open ID guide.

NAME DESCRIPTION Open ID Provider Choose an Open ID Provider or select none. Client ID The Client ID of the selected Open ID provider Authority URL The Authority URL of the Open ID provider Redirect URL The CM2Webshare URL -
On the Email Configuration Settings screen enter the required settings. Please refer to the table below for configuration settings details.

NAME DESCRIPTION License Contacts The list of email addresses that will receive a notification when the CM2WebShare License is about to expire. From Address The email address that all emails are sent from. Mail Host The email host system that will send all email notifications. Mail Port The Simple Mail Transfer Protocol port that will assist the host mail system send all emails. -
On the Custom Setup screen select the install location and click on the Next button

-
From the Confirm Installation window click on the Install button

-
The installation process will commence
-
Once the installation is complete click on the Finish button

COMMAND LINE ARGUMENTS (OPTIONAL)
The follow command line arguments can be passed to the MSI if required.
| ARGUMENT | PURPOSE |
|---|---|
| DBID | Sets the Database ID that connects to Content Manager dataset to run the application |
| WORKGROUP_SERVER | Sets the Workgroup Server Name that connects to Content Manager dataset to run the application |
| WORKGROUP_SERVER_URL | Sets the Workgroup Server URL that connects to Content Manager dataset to run the application |
| LICENSE_PATH | Sets the license that connects to the application |
| TEMP_PATH | Sets the temporary path that connects to the application |
| WEB_APP_POOL_IDENTITY_DOMAIN | Sets the App Pool domain for the application pool |
| WEB_APP_POOL_IDENTITY_NAME | Sets the App Pool username for the account running the application pool. Use "" around the username if there are any special characters |
| WEB_APP_POOL_IDENTITY_PWD | Sets the App Pool password for the account running the application pool. Use "" around the username if there are any special characters |
| LIC_CONTACTS | Sets the email address of who will be contacted regarding the expiring license |
| FROM_ADDRESS | Sets the email address all emails are sent from |
| MAIL_HOST | Sets the mail host |
| MAIL_PORT | Sets the mail port |
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 button and ensure that only Windows Authentication is enabled if you are not using Open ID Authenticaion
ImportantIf you are using Open ID Authentication, ensure only Anonymous Authentication is enabled
-
Right click the application in IIS and select the explore option

-
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
-
Within the application pool listing screen, right click on Folder Template Creator application pool and select the Advanced Settings option from the drop-down menu

-
Within the Advanced Settings window, set Start Mode to AlwaysRunning, Idle Time-out Action to Suspend and Idle Time-out Action (minutes) to 0

-
Click on the OK button
-
Select the CM2WebShare application in IIS and navigate to its Advanced Settings

-
Set Preload Enabled to True and click on the OK button

HTTPS SITES
If CM2WebShare is being installed under a HTTPS site then the following must be completed.
By default, CM2WebShare is set up to connect to a http site. To set up the application for HTTPS connection, please complete the following:
-
Right click the application in IIS and select the explore option

-
Click on the Client App > Build

-
Right Click > Edit the Index.html file

-
Update the Content Security Policy from http to https
-
Save the file.
EMBEDDING CM2WEBSHARE
To allow for a site to embed CM2WebShare:
-
Navigate to the CM2WebShare's install directory and open the web.config file as an Administrator in the text editor of your choice

-
Locate the Content-Security-Policy line highlighted below

-
After 'self', add 'data:' followed by the domain of the site that CM2WebShare is installed under and the domain(s) of the sites that CM2WebShare will be embedded in (separated by a space)

-
Save your changes and complete an App Pool stop/start
NoteSome sites require the protocol to be explicitly stated within the Content-Security-Policy, if you are encountering issues embedding CM2WebShare after configuring the above, please try including the protocol ("http://" or "https://") for each site.
INSTALLING THE CM LAUNCHER
The FYB CM Launcher needs to be installed on each users’ machine. The CM Launcher is required by CM2WebShare to perform native functions on the user’s machine such as to open a record for editing and viewing. It is specifically needed for the following link functionality:
- View Document
- Edit Document
- Download PDF Rendition
If you are not using any of the above features in your CM2WebShare tables then you do not need to install CM Launcher
Please refer to the CMLauncher Installation Guide to install CM Launcher.
