Skip to main content

Link Redirector Installation Guide

Raise a support ticket

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.

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​

The FYB Link Redirector MSI will:

  • Deploy the installation files.
  • Setup the application pool and application in IIS
  • Setup the temporary folder
  • Configure the FYB Link Redirector as specified by the user

To install the FYB Link Redirector Application, follow these steps:

  1. Run command prompt as an administrator and launch the linkredirector-10x.msi installer

  2. Click the Next button

    image.png

  3. On the Web Application Settings screen, select a site to host the application

  4. Click the Next button

    image.png  

  5. On the Application Pool Settings screen, enter the domain, username, and password for the application pool identity

  6. Click the Next button

    image.png

  7. On the Configuration Settings screen, enter the source and destination dataset ID, source and destination workgroup server, and temporary folder path.

    image.png

    FUNCTIONALITYDESCRIPTION
    Dataset IDThe ID of the dataset the application will be connected to.
    Workgroup ServerThe workgroup server the application will be connected to.
    Temp PathThe temporary path used for the application. Logs will be stored here.

|Link Generator URL | The Link Generator API URL in the format http(s)://servername/LinkGeneratorAPI/record/ |

  1. Click Next

  2. On the Custom Setup screen select the install location

    image.png

  3. Click the Next button

  4. From the Confirm Installation window click the Install button

    image.png  

  5. The installation will commence

    image.png

  6. Once the installation is complete click the Finish button

    image.png

COMMAND-LINE ARGUMENTS (OPTIONAL)​

The following command-line arguments can be passed to the MSI if required.

ARGUMENTPURPOSE
WEB_APP_POOL_IDENTITY_DOMAINSets the App Pool domain for the application pool
WEB_APP_POOL_IDENTITY_NAMESets 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_PWDSets the App Pool password for the account running the application pool. Use "" around the username if there are any special characters
DBIDSets the Source Database ID that connects to the dataset to run the application
WORKGROUP_SERVERSets the Source Workgroup Server Name that connects to the dataset to run the application
TEMP_PATHSets the temporary path that connects to the application
LINK_GEN_URLSets the Link Generator API url

CONFIGURATION​

IIS CONFIGURATION​

  1. In IIS from the Features View go to Authentication and ensure that Windows Authentication and ASP.NET Impersonation are enabled

    image.png image.png  

  2. Click on the Application Settings and update the following settings

    image.png

    NAMEFUNCTIONALITY
    SharePoint URL Field URIThe URI of the SharePoint URL additional field
    Enable RedirectSet to true for instant redirect to Content Manager. Set to false for Document Display information on the web page
  3. Complete an app pool restart to allow for the changes to initialize

CONTENT MANAGER CONFIGURATION​

The following additional fields need to be created and attached to all record types you wish to redirect to.

NAMETYPEMAX LENGTHATTACHED TO
SharePoint URLString500Documents

To uninstall FYB Link Redirector please follow the steps below:

  1. Navigate to control panel

    image.png

  2. Click on uninstall a program

    image.png

  3. Locate FYB Link Redirector in the list of Programs and feature

  4. Right click it and click on the Uninstall button

  5. If a warning prompt appears, click on the Continue button

  6. The uninstallation process will commence

  7. Open IIS once the uninstallation process is completed

  8. Locate LinkRedirector in IIS, right click and click the Remove button

    image.png