FluentPro Help Center

What do you need help with?

    Sorry, we didn't find any relevant articles for you.

    Send us your queries using the form below and we will get back to you with a solution.


    How to install G.A. Suite On-Premises

    This article describes the process of G.A. Suite On-Premises installation.

    Before the deployment process starts, please review Governance and Administration Suite On-Premises Deployment Prerequisites:

    Description 

    1. Governance and Administration Suite On-Premises prerequisites 

    1.1 Firewall ports should be opened: 

    • SQL 1433 
    • HTPS 443 
    • Backgroundtasks 9000 where backgroundtasks module running 
    • PushServicePort 8734 on JobScheduller machine 
    • Ports range from 9002 to 9202 on Workers machine

    1.2 Certificates: 

    • Encryption Certificate – Applied to the GA Suite Servers Web, App and SQL Servers 
    • SSL Certificate – Applied to Web Server Only "NAME = Corresponding DNS Record"

    1.3 ASP.NET 4.7.1: 

    https://www.microsoft.com/en-us/download/details.aspx?id=56116

    1.4 Accounts for database: 

    • fbo-sql-admin – create databases, manage logins 
    • fbo-db-user – database owner on G.A. Suite databases, used in modules 
    • Service account – run AppPool and modules

    1.5 SQL requirements: 

    SQL Server and Windows Authentication mode should be enabled (if Web, App and SQL Servers not in the same Active Directory domain) 

     The following databases will be created automatically during installation process:

    • Main database (fbo_sys_main) – root database in G.A. Suite for storing URLs to data centers webs. Data centers listed in "DataCenter" table 
    • DataCenter database (fbo_dc) – connection info 
    • Customer database (fbo) – customers settings

    1.6 IIS requirements: 

    Common HTTP Components  

    • Default Document  
    • HTTP Errors  
    • Static Content  

    Health and Diagnostic  

    • HTTP Logging  

    Performance  

    • Static Content Compression  

    Security  

    • Request Filtering 
    • Windows Authentication 

    Application Development  

    • NET Extensibility 4.5 
    • ASP.NET 4.7.2.  
    • ISAPI Extensions  
    • ISAPI Filters 


    If you are sure that you have everything from the list above, please proceed to the next steps. 

    We will review the following topics:

    • Preconditions
    • App Installation
    • Worker Installation 
    • Web Installation

    Preconditions:

    The best scenario is when on-premise environment where G.A. Suite will be installed consists of four virtual machines:

    • gas-app -prem. This virtual machine will be used to install app section. App section consists of Job Scheduler, Backup Scheduler, File System Manager, Background Task.
    • gas-worker-prem. This virtual machine will be used to install Queuing. One Project Professional queue and two SharePoint queues are installed by default.
    • gas-web-prem. This virtual machine will be used to install G.A. Suite web part.
      Please note: IIS is required to be deployed and started on this virtual machine.
    • gas-sql-prem. MS SQL database will be deployed on this virtual machine and we will review this case as an example, however, MS SQL can be installed on a local machine, if required. Azure or Amazon databases can be used as well.

    We are describing the best possible scenario, but it is not obligatory. G.A. Suite on-premises can be installed on two or one virtual machine as well. 

    The user who will be installing G.A. Suite on-premises on these environments should have local admin permissions for these environments. If you do not have the required permissions, please, contact your System Administrator. 

    If you would like to use Microsoft authentication, it is required to register an app in Azure in advance. For this purpose perform the following: 

    1. Navigate to https://portal.azure.com and select App registrations.
    2. Click New registration and Provide app name.
    3. Set the "Accounts in this organizational directory only" option and click register.

    After the app is generated, open this app and perform the following:

    • Navigate to Certificate & secrets and generate a new Client secret and save it.
    • Navigate to Authentication and add callback URLs, the URLs are the following:
      • https://{HostName}/Ms-Login
      • https://{HostName}/Account/ExternalLoginCallback
      • https://{HostName}/Admin/Account/ExternalLoginCallback

    There are two versions of set up file that can be sent by FluentPro Team for downloading and installation of G.A. Suite on-premises:

    1. FluentPro.PremiseGasSetup_<Version>. zip – this version includes only a setup file. App, Queuing and Web packages are stored on FluentPro side and will be downloaded in the process of installation. 

    2. FluentPro.PremiseGasSetup_Full_<Version>. zip – this version includes App, Queuing and Web packages.

    As you select the required setup file and receive it from FluentPro Team, you can start the installation process. 

    App installation

    1. Paste FluentPro.PremiseGasSetup.zip to Local Disk C:\Temp folder as an example and extract all files from it. 

    2. Select FluentPro.Fbo.Setup.exe file and run it. 

    3. If G.A. Suite was already installed on the machine, the following window will appear. Select Install/Update option and click Next. 

    Install/Update - option is used to install a new instance of G.A.Suite or Update it to the newest version.
    Uninstall apps – option is used to delete G.A. Suite instance from the environment.

    If G.A. Suite is installed for the first time, you will get to the Requirements page. Make sure you have the required .NET Framework version installed and click Next. 

    4. Accept the terms in the Agreement and click Next.

    5. Select Configure App radio button. Job Scheduler, Backup Scheduler, File System Manager and Background Tasks will be selected for installation. Click Next to proceed.

    Please note: If you are installing G.A. Suite on-premises on one virtual machine, please select Custom Configuration and check all the check-boxes on the right.
    All installation process, in this case, will not be divided into separate stages: app, worker, and web installation will be completed all together and the installation process will need to be launched once. However, the best practice is to install G.A. Suite on-premise on several separate virtual machines (four is the best scenario).

    6. On the next screen it is possible to select or edit the installation path. Click the download button to download the necessary packages.

    Please note: Download button will not be displayed when FluentPro.PremiseGasSetup_Full set up file version is used for installation.

    7. Packages are downloaded and stored in the Packages folder.

    8. Click Next to proceed.

    Database configuration

    It is possible to use an on-premise SQL server or servers from the cloud (Amazon or MS Azure). Amazon AWS is used in our case. SQL account and Windows account will be verified during installation. 

    There are two ways to configure a database:

    1. To provide SQL server name and credentials for Database Authentication and Provision Database account. 

    2. Use Existing Databases. 

    This option allows using an existing database. In this case, provide the following information: 

    • Main db name;
    • DataCenter db;
    • Customer db.

    Press Validate DB connection button.

    Click Next to proceed.

    The required database settings are configured now and databases will be created during the process of further installation.

    Data encryption settings

    There are three options available for selection, select the required one:

    1. None - all data is not encrypted in the database.
    2. Certificate - passwords are encrypted by certificate.
      Please Note: The certificate must be installed on the virtual machine to select this option.

    Click Next to proceed. 

    PWA registration in the setup wizard

    On the next step provide your PWA URL, Login, and Password. 

    Make sure that the account has administrator rights on the PWA. The account used should be a member of the PWA Administrators group and Site Collection Administrator. 

    License file may be added to this step. Use the “…” button to upload the license file if you need to use offline licensing.

    Click Next to proceed. 

    Customer Data Configuration

    On this step provide the following information:

    • Company Name;
    • First Name; 
    • Last Name;
    • In the Login field provide the login to G.A.Suite On-Premises. Use the popup tip for more information:
      ms: {Account Name} – for Microsoft authentication
      wd: {Account Name} – for Windows authentication
    • Email: provide your corporate email. 

    Click Next to proceed. 

    Modules settings

    In this section, the information about ports that are used for communications between modules and workers is provided. 

    All Ports are preinstalled by setup wizards. The “Open firewall ports” checkbox creates inbound rules for these ports on the virtual machine. 

    Click Next to proceed. 

    Storage configuration

    Three storage types are available for setup storage:

    • Amazon S3 bucket;
    • Windows Storage;
    •  Azure Storage.

    This storage will be used for backups, logs, etc. 

    To find more information about the 'Use an IAM role granted access' option, please refer to this article.

    To find more information about the 'Use AES256 Server Side Encryption' option, please refer to this article.

    This setting will be shown in the Storage Settings of the G.A. Suite application. 

    Configuration settings in Datacenter 

    This setting is responsible for email notifications. It sends email notifications about successful/not successful backups, restores, copies, etc.

    If SMTP credentials differ from the ones you are using to install G.A. Suite, check the 'Use specific SMTP credentials' checkbox and provide the required credentials.

    Click Install to proceed. 

    Installation

    Allow the wizard some time for the installation process to be completed. 

    It is possible to review all installation log files by scrolling down. 


    Please note: All Installation logs are stored in the Logs folder of the installation folder.

    Click Next to proceed. 

    As the installation process is completed, a summary for the configuration and installation of the selected items will be displayed. 

    Click Finish to complete. 

    G.A. Suite on-premises application is installed.

    As a result, the services will be running and inbound rules will be created.

    Worker Installation 

    The user who will be installing workers should have local admin permissions for the environment. If you do not have the required permissions, please, contact your System Administrator. 

    If you are installing G.A. Suite on several virtual machines, the best practice is to copy the following file: install.info from gas-app-prem and paste it into the same folder on the virtual machine where Worker will be installed. This file includes information that you have already provided while configuring databases during App installation. If you use this file during Worker installation, it will reduce time for installation and skip several steps (e.g. database configuration).

    1. Run FluentPro.Fbo.Setup application.

    Accept the terms in the agreement and click the Next button.

    2. Select configure Worker option.

    3. Click Next and provide the path for the installation folder. Click Next to proceed. 

    4. During Worker installation as you get to the Database step, it is required to provide the databases that were created while installing App. Check the 'Use existing database' check-box and provide the required information. Click Next to proceed. 

    Modules settings

    Modules Min\Max Port values are pre-installed. These values should be the same as App ports.

    If the 'Open firewall ports' checkbox is checked inbound rules will be added to the firewall for the specified ports.

    Provide Windows account to log on for Queueing modules. It should be in the following format: viacom\username

    It is possible to change the Temp folder for Queuing modules if needed.

    Click Next. 

    Configuration settings in Datacenter are the same as for app installation and do not need to be changed.

    Click Install. 

    Allow the wizard some time for the installation process. 

    It is possible to review all installation log files by scrolling down.

    Please note: All Installation logs are stored in the Logs folder of the installation folder.


    Click Next and review the summary. 

    Click the Finish button.

    Two shortcuts will appear on the desktop. 

    Firewall contains inbound rules for Queuing Processor_ProjectPro and Queuing Processor_SharePoint.

    Task Scheduler contains an item that runs queuing using Power Shell script.

    The script is located in C:\Program Files\FluentPro Software\G.A.Suite\Sctipts Start-Modules.ps1.

    Web Installation

    The user who will be performing web installing should have local admin permissions for the environment. If you do not have the required permissions, please, contact your System Administrator. 

    If you are installing G.A. Suite on several virtual machines, the best practice is to copy the following file: install.info from gas-app-prem and paste it into the same folder on the virtual machine where Web will be installed. This file includes information that you have already provided while configuring databases during App installation. If you use this file during Web installation, it will reduce time for installation and skip several steps (e.g. database configuration).

    1. Run FluentPro.Fbo.Setup application.

    2. Accept the terms in the agreement and click Next button.

    3. Select Configure Web Server. Click Next to proceed. 

    4. Click Download to download the required package. 

    5. Select the installation path. Click Next to proceed.

    6. During Web installation as you get to the Database step, it is required to provide the databases that were created while installing App. Check the 'Use existing database' check-box and provide the required information. Click Next to proceed. 

    Data encryption settings are also configured, just click Next to proceed.

    Web site configuration

    This page allows to set the following information:

    • Host name
    • Protocol (http/https)
      Please note: to select https option it is required to have SSL certificate.

    The 'Enable Windows Authentication' checkbox allows you to use your domain name to log in to G.A. Suite.

    'G.A.Suite Administrator Credentials': this account is used to log in to the G.A. Suite admin site as a global administrator. 

    'Microsoft App Settings': use Ms App Id and Ms App Password. 

    Click Install to proceed. 

    It is possible to review all installation log files by scrolling down.

    Please note

    All Installation logs are saved in the Logs folder of the installation folder.

    There is a summary about configure and install selected items.

    Now you can check your IIS Manager. The site is deployed and started.

    Open the browser and provide your host name.

    Log in to G.A. Suite using the Microsoft option. 

    Click Finish to complete the installation process. 

    Congratulations! G.A. Suite is deployed and launched successfully!

    If you have any questions or any difficulties during the installation process, you are always welcome to contact our support team at support@fluentpro.com, providing them the log files that are stored in the Logs folder of the installation folder. 

    Was this article helpful?

    Table of contents

      Still can't find what you're looking for?

      Contact Support
      Back To Top