DocUMove Installation Guide
DISCLAIMER
Any advice FYB provides 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.
LICENSE DETAILS
Please contact FYB for a valid license if you have yet to obtain one for your Add-in.
INSTALLATION COMPONENTS
The following installation components are required to ensure full functionality of the FYB DocUMove:
- FYB DocUMove web application - This is a server-side installation.
INSTALLING FYB DOCUMOVE
LICENSE
-
Create a folder to house the license file (.lic) on the IIS 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.
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 10 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
The documove MSI will:
- Deploy the installation files
- Set up the application pool and application in IIS
- Set up the temp folder
- Configure the application settings as specified by the user
Installation can be completed by running the MSI or using command-line arguments to prefill most data.
To install DocUMove, follow these steps:
-
Run the command prompt as an administrator and launch the DocUMove 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
RecommendationWe recommend that DocUMove be installed under an HTTPS site with a valid SSL certificate.
-
On the Application Pool Settings screen, enter the domain, username, and password for the Application Pool identity
Windows AuthenticationIf you are using Windows Authentication, then these fields must be filled in. Do Not enable the Use Default Application Pool Identity checkbox.
Application Pool IdentityIf you are enabling the Use Default Application Pool Identity checkbox, ensure the account has write access to the Registry, as this is required for updating the Authentication Settings.
To update the permissions, navigate to Computer\HKEY_LOCAL_MACHINE\SOFTWARE\FYB\DocUMoveService in the Registry after DocUMove is installed.

-
On the Configuration Settings screen, enter the required settings (please refer to the table below for configuration settings details)

FIELD DESCRIPTION Database Id Content Manager two-character dataset identifier CM Service API URL The Content Manager Service API URL Domain The Host URL that DocUMove will be installed under (e.g. https://example.com.au) License Path Local path to DocUMove license file Temp Path Local temporary directory used by the application to cache content manager documents. Please include the trailing slash, for example: C:\FYB Add-Ins\DocUMove\ -
Select your preferred Open ID Provider

OPTION DESCRIPTION Microsoft Configures DocUMove to use EntraID. This option is selected by Default None Choose this option if you would not like to use Open ID to secure DocUMove, using Windows Authentication instead. Leave all other fields on this screen blank and proceed to Step 8 NoteIf None is selected, the IIS authentication for the Content Manager Service API must be set to Basic Authentication. No other authentication method can be set.
-
Complete the Entra ID Settings screen using the values gathered as part of the respective Open ID guides. These can be found within the VALUES REQUIRED FOR INSTALLATION header of the respective Open ID guide.

FIELD DESCRIPTION Content Manager Entra Client ID The Client ID of the Entra application used to secure DocUMove Tenant ID The Tenant ID of the Entra application used to secure DocUMove Authority URL The Authority URL of the Entra application in the format https://login.microsoftonline.com/\{Tenant Id} Redirect URL The DocUMove URL. This value must be in all lowercase App Id URI The App Id URI of the Entra application used to secure DocUMove -
On the Email Settings screen, enter the required settings

NAME DESCRIPTION License Contacts The email addresses of users who will receive an email notification when the DocUMove license is due to expire. Emails are separated by a semi-colon ';' From Address The email address that all email notifications will be sent from Mail Host The mailing host to send notifications Mail Port The mail port to send notifications SMTP username (optional) The username used to authenticate with your SMTP server SMTP password (optional) The password used to authenticate with your SMTP server -
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
Use "" around values that contain special characters (non-alphanumeric characters)
| ARGUMENT | PURPOSE |
|---|---|
| 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 |
| WEB_APP_POOL_IDENTITY_PWD | Sets the App Pool password for the account running the application pool |
| DBID | Sets the Database ID that connects to the given Content Manager dataset |
| WORKGROUP_SERVER | Sets the Content Manager Workgroup Server name |
| WORKGROUP_SERVER_URL | Sets the Content Manager Workgroup Server URL |
| LICENSE_PATH | Path to the license file |
| TEMP_PATH | Temporary data directory for the application |
| CLIENT_ID | The Client ID of the Entra application used to secure DocUMove |
| TENANT_ID | The Tenant ID of the Entra application used to secure DocUMove |
| AUTHORITY_URL | The Authority URL of the Entra application in the format https://login.microsoftonline.com/\{Tenant Id} |
| REDIRECT_URL | The DocUMove URL. This value must be in all lowercase |
| APP_ID_URI | The App ID URI of the Entra application used to secure DocUMove |
| LIC_CONTACTS | The email addresses of users who will receive an email notification when the DocUMove license is due to expire. Emails are separated by a semi-colon ';' |
| FROM_ADDRESS | The email address that all email notifications will be sent from |
| MAIL_HOST | The mailing host to send notifications |
| MAIL_PORT | The mail port to send notifications |
| SMTP_USERNAME | The username used to authenticate with your SMTP server |
| SMTP_PASSWORD | The password used to authenticate with your SMTP server |
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, go to Authentication

-
Ensure the relevant Authentication option is enabled, based on the Open ID Provider selected during the install
- If Microsoft was chosen as the OpenId Provider, ensure only Anonymous Authentication is enabled.
- If None was chosen as the OpenId Provider, ensure only Windows Authentication is enabled.
NoteIf None is selected during the DocUMove install, the IIS authentication for the Content Manager Service API must be set to Basic Authentication. No other authentication method can be set.
UPDATING THE CONTENT MANAGER SERVICE API CONFIG
When using Windows Authentication, the hptrim.The config file for the Content Manager Service API needs to be updated.
-
Navigate to the install directory of the CM Service API. (e.g. C:\Program Files\Micro Focus\Content Manager\Service_API)
-
Open the hptrim.config file as an Administrator

-
Add the following to the hptrim element: requireAntiForgeryToken="false"

-
Within the hptrim element, add ignorePropertyErrors = "true"
OPENID AUTH CONFIGURATION
-
Create a new authentication element between the workgroupServer and fileTypes elements (if not already present) and add allowAnonymous="false" slidingSessionMinutes="60"
-
Create a new openIdConnect element within the authentication element (if not already present) and add the below block inserting the relevant details from your app registration
<add
name="documove"
clientID="\{\{appID\}\}"
issuerURI="https://login.microsoftonline.com/\{\{tenantID\}\}/v2.0/.well-known/openid-configuration"
identityClaims="email upn preferred_username oid"
appIdURI="\{\{appIdURI\}\}"
/>

For environments where multiple applications are looking to access the Service API using OpenID Authentication, you can add multiple objects within the openIDConnect element.
Below is an example of how this would be configured:

- Save the changes.
WINDOWS/BASIC AUTH CONFIGURATION
- Add the following to the hptrim element: trustedToImpersonate="service account domain\\service account username" Replace service account domain and service account username with the Domain and Username of the Service Account used for DocUMove.
- Save the changes.
UNINSTALLING THE FYB DOCUMOVE
To uninstall the DocUMove manually, please follow the steps below:
-
Run the command prompt as an administrator and launch the DocUMove MSI
-
Click Next

-
Click Remove

-
Click Remove

-
Click Finish once the uninstallation process has completed

