Reportilize 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 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 are yet to obtain one for your Add-In.
INSTALLATION COMPONENTS
The following installation components are required to ensure full functionality of the FYB Reportilize:
- FYB Reportilize Web Application - this is a server-side installation
INSTALLING FYB REPORTILIZE
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\Server Name$
If using a dedicated windows service account, you will be required to enter the details as DOMAIN\username.
INSTALLATION
If upgrading from v4.0.18 and below of Reportilize all previous dashboards MUST be exported and re-imported back into v4.0.23 or above of Reportilize for successful reporting.
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
infoTo check to make sure that the SDK has been attached to the hosting bundle, open Command Prompt and type dotnet --info
The FYB Reportilize MSI will:
- Deploy the installation files.
- Setup the application pool and application in IIS
- Setup the temporary folder
- Configure the FYB Reportilize as specified by the user
To install the FYB Reportilize Application, follow these steps:
-
Run command prompt as an administrator and launch the Reportilize-23x.msi installer
-
Click on the Next button

-
On the Web Application Settings screen, select a site to host the application
NoteThe virtual directory name must remain as Reportilize. It cannot be renamed.
IIS DirectoryThe application must be installed under the dedicated site as an application. It cannot be installed at the site level.
-
Click on the Next button
-
On the Application Pool Settings screen, enter the domain, username, and password for the application pool identity
Using Local AccountsIf there is a requirement to use a local account, leave the domain for the application pool empty.
-
Click on the Next button

-
On the Configuration Settings screen, enter the dataset ID, workgroup server, license path, temporary folder path and document store name
Important!The workgroup server must always be set to local.

FUNCTIONALITY DESCRIPTION Dataset ID The ID of the Content Manager dataset FYB Reporter will be connected to. Workgroup Server Name The workgroup server name of the Content Manager dataset Reportilize will be connected to. Workgroup Server URL The workgroup server URL of the Content Manager dataset Reportilize will be connected to. License Path The path to a valid license. Temp Path The temperature path used for the application. Logs will be stored here. Document Store Name The name of your main document store in Content Manager. For example, Main Document Store -
Click on the Next button
-
If your environment is configured to only allow OpenID authentication (e.g. Azure AD or ADFS) for your Content Manager, you will receive the following message:
-
Click OK to navigate to the Open Id settings screen and enter the required values.

NAME DESCRIPTION Client Id The Client/App Id of the Open Id application used to secure Content Manager. For ADFS authentication, this will be the username of the Confidential Client app. Client Secret The Client/App Id of the Open Id application used to secure Content Manager. For ADFS authentication, this will be the password of the Confidential Client app. Trusted User The Network Login value of the Content Manager Confidential Client app location. For ADFS authentication, this will be the username of the Confidential Client app. NoteA designated CM Location is required to be nominated as the Trusted User. The CM Location will require the following permissions:
- Record Update Permissions
- Create Records
- Modify Records
- Update Document
- Modify Record Additional Field Values
- Miscellaneous
- Can Save Searches
- Record Update Permissions
-
Open ID Settings (Optional) allow for authentication into Reportilize. The values of the required fields can be found in the respective Open ID guides.

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 Locations Manager URL -
If you are enabling the Maintenance Dashboards then tick Set Up Maintenance Dashboards and input the maintenance password. If not then leave this un-ticked and proceed with clicking the Next button
NoteOnly FYB Support members have access to the maintenance dashboards.

-
On the Report Configuration Settings screen enter the following settings:

FUNCTIONALITY DESCRIPTION Document Store Path The path to the Content Manager Document Store (Including the dataset ID folder). This path can be a file share path if the Document Store is installed on a different server to Content Manager. Soft Deleter Group (URI) The URI of the location Group used to Soft Delete Records. If this is not used, enter 0. Legacy Folder (URI) The URI of your legacy folder record type. If this is not used, enter 0 Server Local Data Path The path to where Content Manager writes its log files. (Example: C:\Micro Focus Content Manager\ServerLocalData\TRIM\Log). Template RecType (URI) The URI of the Record Type that all Reportilize templates will be stored as in Content Manager. (i.e., Document Record Type) infoThe Soft Deleter Group and Legacy Folder fields are utilised only as part of the FYB Maintenance. If the maintenance was not set up in the previous window, these values are set to 0.
-
On the Email Configuration Settings enter the send to, from address, mail host and mail port

FUNCTIONALITY DESCRIPTION Event Monitoring Contacts The email address that receives the email notifications for any event failures that occur within Content Manager such as blockages. To set multiple people as a contact place a ';' between each email address. From Address The email address that sends the email notifications. Mail Host The mailing host system that sends the email notifications. Mail Port The SMTP mailing protocol port to the Mail Host License Contacts The emails addresses of people to be contacted when the FYB Reporter license is expiring. Multiple email addresses can be used by placing ';' between each email address -
On the Custom Setup screen select the install location

-
Click on the Next button
-
From the Confirm Installation window click on the Install button
-
The installation will commence

-
Once the installation is complete click on the Finish button

COMMAND-LINE ARGUMENTS (OPTIONAL)
The following command-line arguments can be passed to the MSI if required.
| 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. 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 |
| 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 |
| DOC_STORE | Sets the document store name from Content Manager |
| DOCSTOREPATH | Sets the document store path from Content Manager. This path can be a file share path if the Document Store is installed on a different server to Content Manager. |
| SOFTDELETE | Sets the URI of the Soft Delete Group location |
| LEGACYFOLDER | Sets the URI of the Legacy Folder Record Type |
| LOCALDATAPATH | Sets the server local data path |
| TEMPLATE_URI | Sets URI of the template record type |
| EVENT_CONTACTS | Sets the event monitoring contacts |
| FROM_ADDRESS | Sets the email address all notification is sent from |
| MAIL_HOST | Sets the mail host for all email notifications |
| MAIL_PORT | Sets the mail port |
| LIC_CONTACTS | Sets the license expiring contacts |
CONFIGURATION
-
After the installation process is complete, the following two folders will require modified permissions:
- C:\Program Files\FYB Pty Ltd\Reportilize\App_Data\
- C:\Program Files\FYB Pty Ltd\Reportilize\ClientApp\build\Images
-
Navigate to these two folders and right click > properties > security tab and ensure Users have Read, Write and Modify permissions

-
In IIS from the Features View go to Authentication .
If authentication for Reportilize is using Open ID ensure that Anonymous Authentication is the ONLY authentication type enabled

Otherwise Reportilize authentication is set to Windows Authentication
5. Click on Application Pools
-
Within the application pool listing screen, right click on Reportilize application pool and select Advanced Settings option from the drop-down menu

-
Within the Advanced Settings window, set the following:
SETTING VALUE Idle Time-out Action Suspend Idle Time-out Action (Minutes) 0 Start Mode Always Running 
-
Within the application's basic settings, check the Enable Preload checkbox and click on the OK button

-
Complete an app pool restart to allow for the changes to initialize
UNINSTALLING FYB REPORTILIZE
To uninstall FYB Reportilize please follow the steps below:
-
Navigate to control panel
-
Click on uninstall a program option
-
Locate FYB Reportilize in the list of Programs and feature
-
Right click on FYB Reportilize and click on the Uninstall button
-
If a warning Prompt appears, click on the Continue button
-
The uninstallation process will commence
-
Open IIS once the uninstallation process is completed
-
Locate Reportilize in IIS, right click and click on the Remove button

