Skip to main content

Gravity2CM 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.

LICENSE DETAILS​

Please contact FYB for a valid license if you are yet to obtain one for your Connector.

INSTALLATION COMPONENTS​

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

  • FYB Gravity2CM Web Application - This is a server-side installation

INSTALLING FYB GRAVITY2CM WEB APPLICATION​

LICENSE​

  1. Create a folder to house the license file (.lic) on the IIS Server
  2. Place the license file in this folder. 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​

Installation can be completed by running the MSI or using the command line arguments to prefill in most data (see COMMAND LINE ARGUMENTS section below).

The FYB Gravity2CM 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

To install the Gravity2CM, follow these steps:

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

  2. Click the Next button

    2021-08-31_15-03-46.jpg

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

  4. Click the Next button

    2021-08-31_15-04-00.jpg

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

  6. Click Next

    2021-08-31_15-04-24.jpg

  7. On the Configuration Settings screen enter the required settings

    2021-08-31_15-05-01.jpg

    NAMEDESCRIPTION
    Dataset IDThe two alphanumeric character dataset identifier
    Workgroup ServerThe workgroup server name that Gravity2CM is installed on. This should be set to local
    Temp PathA temp location to store data for the application
  8. On the Custom Setup screen select the install location and click the Next button

    2021-08-31_15-05-21.jpg

  9. From the Confirm Installation window click the Install button

    2021-08-31_15-05-31.jpg

  10. The installation process will commence

    2021-08-31_15-05-40.jpg

  11. Once the installation is complete click the Finish button

    2021-08-31_15-06-01.jpg

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 the Content Manager dataset to run the application
WORKGROUP_SERVERSpecify the Content Manager workgroup server
LICENSE_PATHPath to the license file for the application including the .lic filename
TEMP_PATHSets the temp path for the application data/logging
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

CONFIGURATION​

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

  1. Right click the application in IIS and select explore

    app.jpg

  2. Right click the app data folder and select properties

    prop.jpg

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

    permiss.jpg  

  4. Complete the same steps for the Logo folder

  5. From the Features View go to Authentication

    image.png

  6. Ensure that Windows Authentication and ASP.NET Impersonation are the only authentication types enabled

    image.png

  7. Click on Application Pools

    image.png

  8. Within the application pool listing screen, right-click on Gravity2CM application pool and select Advanced Settings

    2020-09-24_15-35-30.png

  9. Within the Advanced Settings window, set Idle Time-out Action to Suspend and Idle Time-out Action (minutes) to 0 and click the OK button

    image.png

CONTENT MANAGER CONFIGURATION​

The following additional fields need to be set up in Content Manager and attached to the record types used by the application.

FIELD NAMETYPEAPPLIES TO OBJECTSAPPLIES TO
Form IdstringRecordRecord Type used for Form Document
Entry IdstringRecordRecord Type used for Entry Document