Skip to main content

Page2CM Installation Guide

Raise a support ticket

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

INSTALLATION COMPONENTS​

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

  • FYB Page2CM web application - This is a server-side installation.

INSTALLING FYB PAGE2CM​

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 fybpage2cm MSI will:

  • Deploy the installation files
  • Setup the application pool and application in IIS
  • Setup the temp folder
  • Configure the application settings as specified by the user
Note

If upgrading from a previous version, you do not need to uninstall the previous version of Page2CM. The previous version's configuration settings will be retained after installing the latest version of Page2CM.

To install Page2CM, follow these steps:

  1. Run command prompt as an administrator and launch the Page2CM MSI

  2. Click the Next button

    2021-12-15_9-19-00.png

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

    2021-12-15_9-25-07.png

    Note

    The site the connector is being installed underneath must be https protected and able to communicate with the PageUp SFTP.

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

    2021-12-15_9-38-40.png

  5. On the Configuration Settings screen enter the required settings. Please refer to the table below for configuration settings details

    2021-12-15_9-42-19.png

    NAMEDESCRIPTION
    Dataset IDThe two alphanumeric character dataset identifier, for example: XX
    Workgroup ServerThis must be set to local for CM impersonation to function correctly
    Licence PathThe path to your license file including the .lic file
    Temp PathA location for Page2CM to write and store temp data. Please include the trailing slash, for example: D:\Page2CM\Temp\
  6. On the Custom Setup screen select the install location and click the Next button

    2021-12-15_9-48-31.png

  7. From the Confirm Installation window click the Install button

    2021-12-15_9-49-53.png

  8. The installation process will commence

    2021-12-15_9-53-07.png

  9. Once the installation is complete click the Finish button

    2021-12-15_9-54-05.png

COMMAND-LINE ARGUMENTS​

Note

Use "" around values that contain special characters (non alphanumeric characters)

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
WEB_APP_POOL_IDENTITY_PWDSets the App Pool password for the account running the application pool
DBIDSets the Database ID that connects to the given Content Manager dataset
WORKGROUP_SERVERSets the Content Manager Workgroup Server name
LICENSE_PATHPath to the license file
TEMP_PATHTemporary data directory for the application

CONFIGURATION​

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

2021-12-15_10-00-30.png

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

    2021-12-15_10-01-39.png

  2. Right click the application in IIS and select explore

    app.jpg

  3. Right click the app data folder and select properties

    prop.jpg

  4. Navigate to the security tab and ensure users have read, write and modify permissions

    permiss.jpg

  5. Repeat the same steps above for the Logo folder

    Note

    Ensure that the app pool is set to CLASSIC and not INTEGRATED

UNINSTALLING FYB PAGE2CM​

UNINSTALLATION​

To uninstall the Page2CM manually please follow the steps below:

  1. Navigate to control panel

    image.png

  2. Click on uninstall a program

    image.png

  3. Locate FYB Page2CM in the list of Programs and Features

    2021-12-15_10-10-17.png

  4. Right click on FYB DocUMove and click on the Uninstall button

    2021-12-15_10-13-46.png

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

    image.png

  6. Click the Yes button

    image.png

  7. The uninstallation process will commence

    2021-12-15_10-19-01.png

  8. Open IIS once the uninstallation process is completed

  9. Locate Page2CM within IIS,

  10. Right click and click the Remove button

    2021-12-15_10-21-01.png

  11. When the prompt appears, click on the Yes button

    image.png