Skip to main content

Link Generator 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 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 are yet to obtain one for your Add-in.

INSTALLATION COMPONENTS​

The following installation components are required to ensure full functionality of the FYB Link Generator:

  • FYB Link Generator API allows web links to be generated. This is a server-side installation.
  • FYB Link Generator Add-In allows the interface to be accessed by users and the Admin Console to be accessed by Administrators. This is a server-side configuration.
  • FYB CM Launcher allows desktop links to be generated. This is a client-side installation.
Note

The FYB Link Generator API needs to be installed first.

LICENSE​

  1. Create a folder to house the license file (.lic) on the IIS Server

  2. Place the license file in this folder

    Note

    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​

The fyblinkgeneratorapi MSI will:

  • Deploy the installation files
  • Setup the application pool and application in IIS
  • Setup the temp folder
  • Configure the Link Generator API as specified by the user

To install the Link Generator API, follow these steps:

  1. Run command prompt as an administrator and launch the linkgeneratorapi-xxx.msi

    NOTE

    You must run the linkgeneratorapi-xxx.msi as a user that has permission to validate user credentials

  2. Click on the Next button

    apimsi1.png

  3. On the Web Application Settings screen, select a Site to host the application and enter a name for the Virtual Directory

  4. Click on the Next button

    apimsi2.png

    Note

    You can use an existing virtual directory or create a new one with the installer.

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

  6. Click on the Next button

    image.png

    NAMEDESCRIPTION
    Domain for Application PoolThe domain name for the application pool identity
    Username for Application PoolThe Username for the application pool identity
    Password for Application PoolThe Password for the application pool identity
    Use Default Application Pool IdentityUtilize the default application pool identity
  7. On the Configuration Settings screen, enter the dataset ID, workgroup server, license path and temp path

  8. Click the Next button

    image.png

    Note

    • You can use an existing folder for the Temp Path or create a new one with the installer • The workgroup server name should always be set to local if using the name.

    NAMEDESCRIPTION
    Dataset IDThe two-character dataset identifier
    Workgroup Server NameThe Content Manager Workgroup Server Name used for the connection to the dataset. Database connection can be made using the workgroup server name or URL.
    Workgroup Server URLThe Content Manager Workgroup URL used for the connection to the dataset. Database connection can be made using the workgroup server name or url.
    License PathThe local path of the Link Generator license file, including ".lic"
    Temp PathThe local path of the folder that the Link Generator API is to use for temporary file storage.
    Add Notes to Action ExecutedEnable for notes to be added to a record when link is executed
    Public RestrictionEnable check to ensure only Public records are being displayed by Link Generator
    Public Field URIThe URI of the Public Additional Field (Boolean) in Content Manager
  9. If your environment is configured to only allow OpenId authentication (e.g. Azure AD or ADFS) for your Content Manager, you'll receive the following message:

    image.png

  10. Click OK to navigate to the Open Id settings screen and enter the required values.

    image.png

    Note

    A designated CM Location is required to be nominated as the Trusted User.

    No specific permissions are required to be provided.

    NAMEDESCRIPTION
    Client IdThe 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 SecretThe 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 UserThe Network Login value of the Content Manager Confidential Client app location. For ADFS authentication, this will be the username of the Confidential Client app.
  11. If you require Explicit Windows Authentication, the Authentication Settings screen (Optional) will display. Select the Explicit Authentication checkbox and input the authentication credentials to be used by Link Generator API, then click Next. If not required, Click Next without filling out the credentials.

    image.png

  12. On the Destination Folder screen select the install location and click the Next button

    msi4.png

  13. From the Confirm Installation window click on the Install button

    apimsi6.png

  14. The installation will commence

    apimsi7.png

  15. Once the installation is complete click on the Finish button

    apimsi8.png

COMMAND-LINE ARGUMENTS (OPTIONAL)​

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

ARGUMENTPURPOSE
DBIDSets the Database ID that connects to Content Manager dataset to run the application
WORKGROUP_SERVERSets the Workgroup Server Name that connects to Content Manager dataset to run the application
WORKGROUP_SERVER_URLSets the Workgroup Server URL that connects to Content Manager dataset to run the application
LICENSE_PATHSets the license that connects to the application
TEMP_PATHSets the temp path that connects to the application
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

CONFIGURATION​

  1. After the installation process is complete, you will be able to locate the application installed within the site selected during installation

    image.png

  2. From the Features View go to Authentication and ensure that Windows Authentication and ASP.NET Impersonation are the only authentication types enabled

    image.png

INSTALLATION​

  1. Create an FYB Add-ins folder on the Content Manager workgroup server

    image.png

  2. Right click on the FYB Add-ins folder > Properties > click on the Sharing tab

    image.png

  3. Click on the Advanced Sharing button

    image.png

  4. In the Advanced Sharing window, tick ‘Share this folder’ and remove the space between FYB and Add-ins, then add a ‘$’ sign which will keep the folder hidden

    image.png

  5. Click on the Permissions button

  6. Give Everyone the Full Control permission

    image.png

  7. A Network Path will now be available

  8. Create a subfolder inside the FYB Add-ins folder to house the license file (.lic) on the server.

    Note

    If there is a pre-existing license folder use that instead.

  9. Place the license file in this folder

    Note

    Note down the path to the license file, you will be asked to enter it later during the install.

  10. Run command prompt as an administrator and launch the linkgenerator-xxx-32bit/64bit.msi

  11. Click the Next button

    msi1.png

  12. On the Configuration Settings screen, enter the shared path for the license (including file name), shared path for the temp path and the dataset ID.

  13. Click on the Next button

    2021-11-05_10-57-40.jpg

    NAMEDESCRIPTION
    Dataset IDThe two-character dataset identifier
    Workgroup Server NameThe Content Manager Workgroup Server Name used for the connection to the dataset. Database connection can be made using the workgroup server name or URL.
    Workgroup Server URLThe Content Manager Workgroup URL used for the connection to the dataset. Database connection can be made using the workgroup server name or url.
    License PathThe shared path to your license file, including the ".lic"
    Temp PathThe shared path to the temp path for Link Generator
  14. If your environment is configured to only allow OpenId authentication (e.g. Azure AD or ADFS) for your Content Manager, you'll receive the following message:

    image.png

  15. Click OK to navigate to the Open Id settings screen and enter the required values.

    image.png

    Note

    A designated CM Location is required to be nominated as the Trusted User.

    No specific permissions are required to be provided.

    NAMEDESCRIPTION
    Client IdThe 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 SecretThe 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 UserThe Network Login value of the Content Manager Confidential Client app location. For ADFS authentication, this will be the username of the Confidential Client app.
  16. On the Configuration Settings (Continued) screen, select the default link format, enter URLs for internal, external, and web client links, and set whether or not to use thumbnail icons

  17. Click on the Next button

    2021-05-03_11-25-16.jpg

    NAMEDESCRIPTION
    Default Link FormatSet the default link format to show when Link Generator opens. This can be set to "URL, "HYPERLINK", or "HTML".
    InternalFYB Link Generator API URL configured for internal use
    Example: https://internal/LinkGeneratorAPI/record
    ExternalFYB Link Generator API URL configured for external use if applicable.
    Example: https://external/LinkGeneratorAPI/record
    If externally accessible links are not being used, leave this field empty.
    Web ClientThe Content Manager Web client URL
    Example: https://server/ContentManager?q=uri:
    To disable the Web Client link, leave this field empty
    Thumbnail IconTo display file type icon thumbnails for Word or email hyperlinks, tick the check box.
  18. On the External Link Setup (Optional) screen, enter the Link Name, Folder Path and Record Type URIs

  19. Click on the Next button

    image.png

    NAMEDESCRIPTION
    Link NameSet the name of the External Link to be configured within CM. This will determine the default name of the button used to launch Link Generator
    Example: FYB Link Generator
    Folder PathThe network share path from which Link Generator will be accessed
    Example: \server\fybaddins$\Link Generator\
    Record Type URIsSet the Record Types you would like Link Generator to be available to use on.
  20. On the Destination Folder screen, select the install location, this should be set to the shared FYB Add-ins folder created earlier in this guide

    2021-11-23_9-50-53.jpg

  21. On the Confirm Installation window, click on the Install button

    msi5.png

  22. The installation will commence

    msi6.png

  23. Click on the Finish button

    msi7.png

COMMAND-LINE ARGUMENTS (OPTIONAL)​

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

ARGUMENTPURPOSE
DBIDSets the Database ID that connects to Content Manager dataset to run the application
LICENSE_PATHSets the license that connects to the application
FORMATSet the default link format to show when Link Generator opens. Value selected can be HTML, HYPERLINK or URL
INTERNALURLFYB Link Generator API URL configured for internal use
EXTERNALURLFYB Link Generator API URL configured for external use if applicable
WEBCLIENTURLThe Content Manager Web client URL

CONFIGURATION​

  1. Open Content Manager and click on Tools > Administration > External Links

  2. Right Click, and select New External Link

  3. From the external link type list, select External executable, click OK

  4. Enter the Link Name as FYB Link Generator

  5. Under ‘Folder or Subfolder’, enter the Network Location of the FYB Add-ins\Link Generator folder created earlier in the guide

  6. Under Executable File Name browse to the Link Generator folder and select

    image.png

  7. Check Link supports tagged processing

  8. Under Command line parameters when doing tagged processing enter ^!Urilist^

  9. Check Use tagged command line format for single selection

    image.png

  10. Select the Usage (Record) tab

  11. Tag each of the appropriate record types.

    image.png

  12. Click on the OK button

  13. The Add-In has now been deployed

INSTALLING CM LAUNCHER​

The FYB CM Launcher needs to be installed on each users’ machine. CM Launcher is required by the Link Generator to perform native functions on the user’s machine such as open Content Manager or open a record for editing.

To install the CM Launcher, follow the install guide here

To uninstall FYB Link Generator API using the MSI please follow the steps below:

  1. Launch linkgeneratorapi-xxx.msi.

  2. The Link Generator API uninstallation window should appear, click Next.

    apimsiu1.png

  3. Click on the Remove button

    apimsiu2.png

  4. On the next screen, click on the Remove button

    apimsiu3.png

  5. The application uninstallation process will commence

    apimsiu4.png

  6. Click on the Finish button to remove complete the removal process

    apimsiu5.png

To uninstall FYB Link Generator using the MSI please follow the steps below:

  1. Launch the linkgenerator-xxx-32bit/64bit.msi

  2. The Link Generator uninstallation window should appear, click Next.

    msiu1.png

  3. Click on the Remove button

    msiu2.png

  4. On the next screen, click on the Remove button

    msiu3.png

  5. The application uninstallation process will commence

    msiu4.png

  6. Click on the Finish button to complete the removal process

    msiu5.png

  1. Open Content Manager and click on Tools > Administration > External Links

  2. Right click the FYB Link Generator external link and click on the Remove button

    image.png

  3. The external link will be removed from Content Manager