AGRIS Customer Documentation

AGRIS Agent for Mobile Apps - Install Prerequisites & System Requirements

Infrastructure and Supporting Requirements:

  1. Running AGRIS 22.3 or greater (with the latest Software Update) on Windows Server 2012 R2 or higher along with meeting the other AGRIS System Requirements (22.3.0 or higher).
  2. Install Microsoft .Net framework v 4.8  (https://www.microsoft.com/net/download/dotnet-framework-runtime).  This must be installed on the AGRIS / Component server.  This will require a reboot of the server upon completion. 
  3. Meet the Recommended Hardware and Software Requirements for Installing Microsoft SQL Server 2017 Express
    1. Specified at https://docs.microsoft.com/en-us/sql/sql-server/install/hardware-and-software-requirements-for-installing-sql-server?view=sql-server-2017.  
  4. Install Microsoft SQL Server Express 2017 or higher, which is used for the agent only.  Here is a download link:  https://go.microsoft.com/fwlink/?linkid=853017.  
    1. Allocate not more than 50% of the RAM on the machine to running Microsoft SQL Server 2017 Express.  To do this, click HERE.
  5. Install Microsoft SQL Server 2018 Management Studio (https://docs.microsoft.com/en-us/sql/ssms/download-sql-server-management-studio-ssms?view=sql-server-2017).  This will require a reboot of the server upon completion. 
    1. Confirm SQL Server Management console works by opening the management console. 
      1. There is a known issue if your Management console does not open or stay open.  Click here to learn how to fix when Management console will stay open.
  6. If running AGRIS in production on the PSQL database engine, be on PSQL / Actian Zen version 13 or higher.
  7. If running AGRIS in production with the MS-SQL database engine MSSQL16 or higher:
    1. Have the MS-SQL server on a dedicated server (best practice). 
    2. If the SQL Server also has AGRIS installed (not a best practice): 
      1. Assure that MS-SQL Server 2016 or 2017 is installed OR
      2. Move AGRIS to an Application Server to support the agent.
    3. The agent will be installed on a server where AGRIS is installed.
      1. 10GB of storage for application diagnostics logging  C:\Users\Public\Documents\ 
      2. 2 GB of system ram for agent processing.
  8. Ensure AGRIS User Security is enabled for the dataset you plan to use with Mobile Apps.
  9. Have stable WiFi or cellular data access where the people will use the devices to run the application.

App Requirements (Apple and/or Android devices):

  1. Setup a single email address with a secure password.  The password must have a minimum of 8 characters.  Every user of the application will need this email address and password in order to access the application.
  2. Setup users with accounts for accessing the application from either the Google Play Store or the Apple App Store.

Other Requirements:

  1. Work with Cultura personnel via a tool like ConnectWise to setup with the applicable agent (MS/SQL or PSQL) on the AGRIS server.
  2. Work with Cultura personnel via a tool like ConnectWise to help set up the application for the first user(s).
  3. As of  TLS 1.2 is supported.   Cannot use earlier versions.  

Run the Agent Checklist Utility (see information on AGS-7215 below):

Please send a screenshot of the result to Tracy Curtis (tracy.curtis@culturatech.com).  Each row of the screen should be green in order for you to proceed.


The AGRIS 19.1.0 release has added:  

  • AGRIS Mobile Applications - Agent pre-installation checklist utility ("Agris.Sys.AgentCheck.exe") (AGS-7215)
  • Benefit: Reduce time and effort to install the agent on the AGRIS component server for AGRIS mobile applications!

A new utility verifies that the items below are present before the agent implementation begins:

  1. Installation of .Net Framework 4.7.2 or higher.
  2. Installation of Windows Server 2012 or higher or Windows 10
  3. AGRIS installation as a Component server on the target machine for the agent installation.
  4. License present and enabled for option 12 and or option 13 in NAM license for the applicable AGRIS Sales &/or Warehouse mobile applications.
  5. Working permissions for COM+.
  6. Installation of MSSQL express 2016 or 2017 on the same box.
  7. Installation of the MSSQL 2016 or 2017 Management Studio.


Navigation to Use:

  1. From the AGRIS System Menu, select Utilities > Diagnostics > Agent Pre-Install Utility.*
  2. Enter an AGRIS Dataset, User Id and Password.
  3. Select the Check button and a screen like this will appear.
  4. Capture a screenshot of your screen and email it to the Greenstone person who will be installing your agent (or send it to tracy.curtis@culturatech.com).

*If the menu for the Utility does not appear, go to your \\...Apps\AGRIS\Bin folder and right-click on the file titled "Agris.Sys.AgentCheck.exe" and choose to run it as Administrator.  NOTE: This utility was also made available with AGRIS 18.4.0 Software Update 1 (SU-1).

3820 Mansell Road, Suite 350 ✦ Alpharetta, GA 30022 ✦ www.GreenstoneSystems.com
© 2011 - 2024 Cultura Technologies LLC. All Rights Reserved Worldwide.  Products and company names mentioned herein may be trademarks or registered trademarks of their respective owners.