/
AGRIS 20.2.0 Installation Instructions

AGRIS Customer Documentation

AGRIS 20.2.0 Installation Instructions

Sep 04, 2020

Click here to go back to the Technical Info page

Table of Contents

 

 

Change Log

Version

Type

Change Description

20.2.0

General

Document created for the instructions to install AGRIS Version 20.2.0

Introduction

Purpose

The Installation Instructions assist you in performing new software installations of the AGRIS System Version 20.2.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 AGRIS 20.2.0, 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

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

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

Actian® Zen™ v14 SP1 (Build 14.10.035)

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 AGRIS 20.2.0 and must coordinate their upgrade to Store Manager ES and AGRIS 20.2.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 20.2.0.

Tips for Minimizing Downtime During the Installation

Multiple client installations can run simultaneously.

    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.

Pervasive SQL Database File Format Conversion

Upgrading from Previous PSQL Versions

AGRIS requires you to pre-install Pervasive® PSQL™ to manage dataset operations. Please follow the instructions at  
https://culturana.force.com/s/article/ka036000000oLocAAE/AGRIS-Installing-Actian-PSQL-v12-SP1-and-Update-3?r=1

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 "Pervasive® PSQL™", be sure that you are using a supported version of Pervasive® PSQL™ for this version of AGRIS.

Technical Support

Greenstone provides support to all subscribing users of the AGRIS System Version 20.2.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://culturana.force.com/s/login

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. 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. 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 20.2.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 20.2.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 20.2.0 Network Installation

Installation Checklist

Print this checklist to assist you in installing AGRIS 20.2.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 Pervasive® PSQL™ Server on the database server(s) using the instructions available at https://culturana.force.com/s/article/ka036000000oLocAAE/AGRIS-Installing-Actian-PSQL-v12-SP1-and-Update-3?r=1

4.

–

Install a supported version of Pervasive® PSQL™ Client on any AGRIS client workstations, including Citrix or Terminal Servers using the instructions available at https://culturana.force.com/s/article/ka036000000oLocAAE/AGRIS-Installing-Actian-PSQL-v12-SP1-and-Update-3?r=1

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 Pervasive® PSQL™ 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.

–

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

17.

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 20.2.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. 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. 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 Pervasive 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 Pervasive 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 Pervasive 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.

  11. Right-click the user created in step 7 and click Properties

  12. Click the Member Of Tab and click Add... and type Administrators then click Check Names followed by OK

  13. Click OK again

  14. Close Computer Management, Administrative Tools and Control Panel.

Assigning Log on Rights

If the AGRIS server is also a Domain Controller, then the padmin user account must be a domain user instead of a local user and made a member of the Builtin Administrators group. 

Creating a COM+ Services User Account

This user account is used to start the COM+ services. This account needs administrative permissions to the server that the COM+ components are running on.

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

  2. Open Administrative Tools.

  3. Open Active Directory Users and Computers.

  4. Click Users.

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

  6. Type a username. (Typically services) The Full name and Description are optional.

  7. Type a password.

  8. Check the following options:

    • User cannot change password

    • Password never expires

  9. Click Create, and then Close.

  10. Click the new user account.

  11. Choose Action >> Properties or right-click the user and select Properties.

  12. Click the Member Of tab.

  13. Click Add.

  14. Browse to and select Administrators.

  15. Click Add.

  16. Click OK to add this user to the group.

  17. Click OK to finish working with this user account.

  18. Close Active Directory Users and Computers.

Setting up Network COM+ Access

✦✦✦

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.