/
AGRIS 24.0.0 Installation Instructions

AGRIS Customer Documentation

AGRIS 24.0.0 Installation Instructions

Feb 12, 2025

← Back to Technical Info page

Table of Contents





Change Log

Version

Type

Change Description

Version

Type

Change Description

24.0.0

General

Document created for the instructions to install AGRIS Version 24.0.0

For Agris 24.0.0 please note: It may be best to use the Edge browser as the Chrome browser may block the links.

Introduction

Purpose

The Installation Instructions assist you in performing new software installations of the AGRIS System Version 24.0.0 software. Also use these instructions to upgrade AGRIS System Version 9.5.0 to this new version.
For information regarding running AGRIS on Microsoft SQL Server, please refer to the documentation here: AGRIS on Microsoft SQL Server

IMPORTANT:  Before upgrading your system to this version of AGRIS, read Appendix H – Tips, Known Issues, and Best Practices

IMPORTANT: Installing or upgrading AGRIS requires up to two (2) system restarts on all server and client machines, as detailed below.  Please take this into consideration when planning your installation or upgrade.

1.  A system restart after completing the .NET Framework installation program (this installation program will only run if the computer does not yet have the required version of the .NET Framework)

2.  A system restart after completing the AGRIS installation program

Summary of Major System Requirements - Added and Removed

The following table summarizes the major hardware (HW) and software (SW) requirements changes relating to the maintenance and support of AGRIS 24.0.0 (compared to the previous release of AGRIS).

Requirement

Added

Removed

Requirement

Added

Removed

HW-Hard-Drive

No changes.

No changes.

HW-RAM

No changes.*

No changes.

HW-CPU

No changes.

No changes.

SW – AGRIS Dataset Conversions

No changes.

No changes.

SW-Database Engine

No changes.

No changes.

SW-Database File Format

No changes.

No changes.

SW-Operating System

No changes.

No changes.

SW-Application Software

No changes.

No changes.

SW-Report Component

No changes.

No changes.

SW- Terminal Server

No changes.

No changes.

*The installation utility checks for at least 512MB of RAM and quits if this amount is not met.

Upgrading From Previous Versions of AGRIS

Note:If you are upgrading from AGRIS Version 9.4.6.x or earlier, please contact Greenstone Technical Support (800-366-2474). Conversions from V9.4.6.x or earlier are not supported in this upgrade.

New as of V9.6.0.0: Retained Settings During Upgrade

The upgrade process in AGRIS retains certain settings from the previous version of AGRIS (such as the settings in the Agris.ini, the Installation Type, the Distribution Folder path, and the COM+ user credentials). During an upgrade installation, the installation process will skip the windows in the Installation Wizard for the retained settings since it already has that information.
If you do not want to retain your settings from the previous version of AGRIS, you can manually uninstall the previous version of AGRIS in Add/Remove Programs or the Program Manager prior to starting the AGRIS installation.

New as of V9.6.0.0: Relocation of the AGRIS startup executable

The following message will appear when upgrading from a version previous to 9.6.0.0. Please read the message carefully. Click the No button to exit the installation process. Click the Yes button to proceed with the installation process.

Removing the prior version of AGRIS

When performing upgrades, the following messages may appear. Click Yes to remove the older version of AGRIS during the upgrade.


The Remove AGRIS Message

The Remove AGRIS Client? Message

The Remove AGRIS Server Components Message

The Remove Previous Version Window
Note: The following screen may appear when removing the previous AGRIS Server components. Click Yes to remove the existing COM+ applications.

The Remove AGRIS Specific MTS Packages Message

RetailWise Customers

RetailWise customers cannot upgrade directly to this version of AGRIS and must coordinate their upgrade to Store Manager ES and AGRIS 24.0.0 with the Sales Team (800-393-0075). The AGRIS Integration Platform (AIP) for RetailWise, which is translates data between RetailWise and AGRIS, is not supported in AGRIS 9.5.0.7 and higher. Note that customers already running Store Manager ES are not impacted by this and are able to upgrade to AGRIS 24.0.0.

Tips for Minimizing Downtime During the Installation

Multiple client installations can run simultaneously.

  1.  

    1. From a client machine, browse out to the UNC path of the Agrisdist folder

    2. Please refer to Appendix A for help on determining your Agrisdist UNC path.

    3. Perform at least the first dataset conversions on the server.


Known Installation Issues

  1. When uninstalling AGRIS, a message may appear indicating "An error occurred while trying to uninstall AGRIS. It may have already been uninstalled. Would you like to remove AGRIS from the Program and Features list?"

Resolution: Click the No button on this message to proceed with the uninstall.

Actian PSQL/Zen SQL Database File Format Conversion

Upgrading from Previous Actian PSQL/Zen Versions

AGRIS requires you to pre-install Actian PSQL/Zen to manage dataset operations. Please follow the instructions HERE

System Requirements

Please:

  •  

    • Consult the System Requirements document before continuing to install AGRIS.

    • Verify that all computers meet or exceed the minimum system requirements.

    • Where this document refers to "Actian PSQL/Zen", be sure that you are using a supported version of Actian PSQL/Zen for this version of AGRIS.

Technical Support

Greenstone provides support to all subscribing users of the AGRIS System Version 24.0.0. You can contact our Technical Assistance Center in the following ways:
Email:  Mysupport@culturatech.com
Phone:  (800) 366-2474
Mail:  3820 Mansell Road, Suite 375. Alpharetta, GA 30022
Website:  http://www.greenstonesystems.com/
Knowledge Base https://culturatech.atlassian.net/wiki/spaces/ACD

AGRIS Auto-Update

As a result of many requests for improving the software update process, AGRIS includes a utility for updating AGRIS client computers. This feature, called the AGRIS Auto-Update, assumes the AGRIS users/clients are running AGRIS V9.5.0.27 or greater, any updates made to the Component Server are automatically detected by the system.

Requirements

  •  

    • You must install the AGRIS System on a separate machine usually referred to as the component server. This type of configuration is usually referred to as a Network Configuration.

    • You must install the AGRIS Auto-Update utility via a UNC (Universal Naming Convention) path:

Example: \\servername\sharename\path

  •  

    • All users must have Administrator privileges for their local computers.

    • This feature is not supported on Terminal or Citrix Servers.

    • This feature is not supported on Standalone installations.

Description

When you launch AGRIS from a client machine, AGRIS compares its local version to the Component Server version. If an update is detected, it automatically prepares the update application and prompts you to decide whether or not to update the system:


The AGRIS System Update Window

  1.  

    1.  

      1. Launch AGRIS from your Desktop. The installation wizard automatically launches the appropriate update from a network share.

      2. When the update is complete, you can launch AGRIS without further interruption.

Note: Depending on the state of the system, you may need to restart your workstation following the update.

Procedure

Note: AGRIS requires that you specify network locations using UNC paths.

  1.  

    1.  

      1. Create a network share (Example: \\servername\apps\AGRISDIST). All users need Read permissions to this share.

      2. The network administrator should save all the installation files to this share.

      3. If an update is available (update.exe), it should be copied to the same folder that contains the setup.exe, which was created in the previous step.

      4. Install AGRIS Version 24.0.0 or later on all AGRIS servers, for example, component servers, database servers, etc. Also, apply updates, if they exist, for example, update.exe.

      5. Install AGRIS Version 24.0.0 or later on all your AGRIS workstations. The AGRIS clients are now ready to detect updates from your servers. When you receive an update from AGRIS, you only have to update your Component Server(s) and application server(s). If you have not specifically set up a Component Server(s), then we assume the database server is the Component Server.



AGRIS 24.0.0 Network Installation

Installation Checklist

Print this checklist to assist you in installing AGRIS 24.0.0.

Step #

Section

Step



Step #

Section

Step



1.

Sec 2.2

Verify your workstations and servers meet or exceed the system requirements and check their compatibility with current hardware requirements.

2.

Sec 2.3

Install any outstanding Windows Service Packs (if necessary).

3.

–

Install a supported version of Actian PSQL/Zen Server on the database server(s) using the instructions available HERE

4.

–

Install a supported version of Actian PSQL/Zen Client on any AGRIS client workstations, including Citrix or Terminal Servers using the instructions available HERE

5.

Sec 2.5

Set up a padmin user account.

6.

Sec 2.7

Create a COM+ Services user account.

7.

Sec 2.8

Set up network COM+ access on the AGRIS Server.

8.

Sec 2.10

Set up the AGRIS directory structure and permissions.

9.

Sec 2.14

IMPORTANT! Back up your datasets.

10.

–

Stop the Actian PSQL/Zen services on the AGRIS server.

11.

Sec 3

Manually install AGRIS Server on the database server.

12.

Sec 4

Manually install AGRIS Server on any Citrix Servers/Terminal Servers.

13.

Sec 5

Manually install AGRIS Client on all your workstations.

14.

Sec 2.17

Download and manually install the latest AGRIS Service Pack on the database server and on any Citrix Servers/Terminal Servers.

15.

Sec 1.9

Use the Auto-Update feature to apply the latest service pack to all client workstations.

  16.

      –

Configure the Cultura AGRIS SYS License Service.  Refer to the instructions on this page.



17.

–

Launch AGRIS from a client workstation to create the datasets folder and first database.

18.

Sec 10

Update the licenses file and the extended options

19.

Sec 7

Install any standalone units that use oneWeigh.

20.

Sec 2.16

If necessary, set up Auto Blender configurations to include AGRIS User information.

Verify System Requirements

Please consult the AGRIS Version 24.0.0 System Requirements document before proceeding with the install. Please verify that all computers meet or exceed the minimum system requirements.
Note: The AGRIS installation will fail if minimum system requirements are not met.

Active Directory-Integrated Domain Name Service (DNS)

Active Directory-Integrated DNS is a critical piece of the infrastructure, required for the successful operation of AGRIS. The steps below are provided as a reference for installing and configuring DNS correctly:

  1.  

    1. Install and configure DNS on the local Domain Controller (Active Directory is required on this server).

    2. Setup forwarders within DNS (if configuring for internet access).

    3. Configure the AGRIS database server, as well as all client computers, to use the local DNS server(s).

To set up DNS forwarders on the server:

  1.  

    1. Click on Start >> Programs >> Administrative Tools >> DNS.

    2. Right-click the server and select Properties.

    3. Click the Forwarders tab.

    4. Click the Enable Forwarders option to enable the field allow the IP addresses to be entered.

    5. Enter the primary DNS server (provided by the internet service provider) and click Add.

    6. Enter the secondary DNS server (provided by the internet service provider) and click Add.

    7. Click Apply >> OK.

    8. Close the DNS window.

Setting up the padmin User Account

You must set up a local user account on the Actian PSQL/Zen database server.


Note: The padmin username and password are hard coded in the AGRIS application. As of the release of AGRIS V9.4.1, users can alter the padmin username and password.


The default username and password for the Actian PSQL/Zen Administrator account is not documented for security reasons. Please contact our Technical Assistance Center (800-366-2474) for this information. Once AGRIS is open:

  1. Click Customize Menu.

  2. Click Database Security Configuration to display the message: New User and Password must exist on database server and the user must be a member of the local Administrators Group.

  3. Contact our Technical Assistance Center (800-366-2474) for an access code to enter in the Database Security Configuration window.

  4. Type the access code in the Access Code field.

  5. Press Enter or Click OK to display the User Name and Password window.

  6. Enter the username and password for the Actian PSQL/Zen Administrator account.

  7. Click Save.

  8. Exit AGRIS.

When starting AGRIS for the first time, you may encounter some errors, caused by the system not knowing the padmin username and password you have set up. If this occurs:

  1. Go to Start >> Settings >> Control Panel.

  2. Open Administrative Tools.

  3. Open Computer Management.

  4. Browse to Local Users and Groups and expand.

  5. Click Users.

  6. Click Action >> New User or right-click Users and select New User.

  7. Type a username (Typically padmin). The Full name and Description are optional.

  8. Type a password.

  9. Check the following options:

    • User cannot change password

    • Password never expires

  10. Click Create, and then Close.

✦✦✦

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.