...
Version | Type | Change Description |
---|---|---|
2324.0.0 | General | Document created for the instructions to install AGRIS Version 2324.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 2324.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
...
The following table summarizes the major hardware (HW) and software (SW) requirements changes relating to the maintenance and support of AGRIS 2324.0.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 | No changes. | No changes. |
SW-Database File Format | No changes. | No changes. |
SW-Operating System | No changes. | Windows Server® 2012 R2No changes. |
SW-Application Software | No changes. | No changes. |
SW-Report Component | No changes. | No changes. |
SW- Terminal Server | No changes. | No changes. |
...
RetailWise customers cannot upgrade directly to AGRIS 23.0.0 this version of AGRIS and must coordinate their upgrade to Store Manager ES and AGRIS 2324.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 2324.0.0.
Tips for Minimizing Downtime During the Installation
...
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 Pervasive® PSQL™ Actian PSQL/Zen 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=1instructions 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 "Pervasive® PSQL™Actian PSQL/Zen", be sure that you are using a supported version of Pervasive® PSQL™ Actian PSQL/Zen for this version of AGRIS.
...
Greenstone provides support to all subscribing users of the AGRIS System Version 2324.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://culturanaculturatech.forceatlassian.comnet/wiki/sspaces/loginACD
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.
...
- Create a network share (Example: \\servername\apps\AGRISDIST). All users need Read permissions to this share.
- The network administrator should save all the installation files to this share.
- 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.
- Install AGRIS Version 2324.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.
- Install AGRIS Version 2324.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 2324.0.0.
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™ Actian PSQL/Zen 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 workstationsHERE | |
4. | – | Install a supported version of Actian PSQL/Zen 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 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 Pervasive® PSQL™ 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. | |
...
Please consult the AGRIS Version 2324.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.
...
You must set up a local user account on the Pervasive 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 Pervasive 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:
- Click Customize Menu.
- 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.
- Contact our Technical Assistance Center (800-366-2474) for an access code to enter in the Database Security Configuration window.
- Type the access code in the Access Code field.
- Press Enter or Click OK to display the User Name and Password window.
- Enter the username and password for the Pervasive Actian PSQL/Zen Administrator account.
- Click Save.
- Exit AGRIS.
...
- Stop the Auto Blender services.
- If you have not already done so, convert your first dataset to AGRIS 2324.0.0.
- From the AGRIS Main Menu, select AGY >> General Setup >> Automated Controls to display the Automated Blender Setup window.
The Automated Blender Setup Window - For each Auto Blender:
- Click the button to the right of the Auto Blender field to select an automated blender from the list.
- Click the button to the right of the AGRIS User field to select a user from the list. Be sure to select an AGRIS user with password permissions set to Never Expire.
- Click Apply to apply the changes.
- When you finish assigning users, click OK to close the Automated Blender Setup window.
- Restart the Auto Blender services.
Downloading the AGRIS
...
24.0.0 Installation Program
- From Do this procedure from the console of the server or standalone unit, click Start >> Run…
- Type https://culturana.force.com/ >> click OK. (NOTE: It may be best to use the Edge or Internet Explorer browser as the Chrome browser may block the links).
- Log on to the website
- If you are not already signed up for a user account, you can click the "Register" link to sign up. Account applications are reviewed and approved within 8 business hours.
- Click search for the AGRIS 23.0.0 is Available Article and the Download setup.exe link for AGRIS 23.0.0.
- Click Save when the "Do you want to run or save this file?" message displays.
- On the left side of the window, click Desktop, and then click Save on the bottom, right side to download the update (which may take a few minutes).
- WARNING: Due to enhanced security features in Windows, please ensure that the installer is unblocked prior to installation using the
- Download the setup.exe using one of the following methods. Note that the download can take several minutes depending on your internet download speed
Method | Description | |
---|---|---|
In AGRIS | Go to Help > About and click the Get Latest Version button to save the install file to the \Datasets\Downloads\Installs folder. Additional information on this method is HERE | |
FTP | Or download and save the Software Update file to your desktop. | Download the setup.exe → |
WARNING: Due to enhanced security features in Windows, please ensure that the installer is unblocked prior to installation using the following steps:
- Right-click on the downloaded installation file and click Properties
- At the bottom of the General tab, look for a button that says "Unblock"
- If the button exists, click Unblock and then click OK
- If the button does not exist, click Cancel
Anchor | ||||
---|---|---|---|---|
|
Anchor | ||||
---|---|---|---|---|
|
Anchor | ||||
---|---|---|---|---|
|
...
Install components in the following order:
AGRIS
...
24.0.0 Server Installation
This section describes how to install the AGRIS System Version 2324.0.0 software in the supported configurations listed in the AGRIS System Requirements document. It assumes that all hardware and supporting software requirements are in place and operational.
The following prerequisites must be satisfied:
...
Citrix Server/Terminal Server Installation
Anchor | ||||
---|---|---|---|---|
|
Anchor | ||||
---|---|---|---|---|
|
Anchor | ||||
---|---|---|---|---|
|
Anchor | ||||
---|---|---|---|---|
|
...
24.0.0 Citrix Server/Terminal Server Installation checklist
Install components in the following order based on the application server software being used:
Citrix Server | Windows Server Terminal Services |
---|---|
Latest Windows Service Pack | No Service Pack |
Install Terminal Services | Install Terminal Services |
Install MetaFrame XP/Presentation Server or Citrix XenApp 6.5.0 | |
Pervasive® PSQL™ 32Actian PSQL/Zen 32-bit ClientPervasive® PSQL™ 32 | Actian PSQL/Zen 32-bit Client |
AGRIS Server | AGRIS Server |
Anchor | ||||
---|---|---|---|---|
|
Anchor | ||||
---|---|---|---|---|
|
Anchor | ||||
---|---|---|---|---|
|
...
24.0.0 Server on Citrix Server/Terminal Server
- Log all users out of the Citrix/Terminal Server(s) and prevent additional users from logging on while installing AGRIS.
- Close all other applications and restart the server.
- Install a supported version of Pervasive® PSQL™ of Actian PSQL/Zen using the instructions available on the AGRIS Customer Portal site:
https://culturana.force.com/s/article/ka036000000oLocAAE/AGRIS-Installing-Actian-PSQL-v12-SP1-and-Update-3?r=1 * = NOTE: It may be best to use the Edge or Internet Explorer browser as the Chrome browser may block the above links. - Complete section 3.2 to install AGRIS.
- Manually set the AGRIS data path - see Section 13.1HERE
- Complete section 3.2 to install AGRIS.
- Manually set the AGRIS data path - see Section 13.1 for additional information.
- Save the AGRIS data path and restart the server.
...
Install components in the following order based on the workstation operating system:
...
Windows 10 | Windows 11 | |
---|---|---|
Pervasive® PSQL™ 32Actian PSQL/Zen 32-bit ClientPervasive® PSQL™ 32 | Actian PSQL/Zen 32-bit Client | Pervasive® PSQL™ 32-bit Client |
AGRIS Client | AGRIS Client | AGRIS Client |
Anchor | ||||
---|---|---|---|---|
|
Anchor | ||||
---|---|---|---|---|
|
Anchor | ||||
---|---|---|---|---|
|
Anchor | ||||
---|---|---|---|---|
|
Anchor | ||||
---|---|---|---|---|
|
Anchor | ||||
---|---|---|---|---|
|
...
24.0.0 Client Installation Procedure
IMPORTANT: Before installing the AGRIS Client, install a supported version of Pervasive® PSQL™ Actian PSQL/Zen on the client workstation using the instructions available at; at
https://culturana.force.com/s/article/ka036000000oLocAAE/AGRIS-Installing-Actian-PSQL-v12-SP1-and-Update-3?r=1 HERE
- Installing the .NET Framework:
- For Windows 8.1 and Windows 10 and Windows 11, part of the.NET Framework must be installed through the Programs and Features:
- Click Start and type "Programs and Features", then click on the Programs and Features.
- Click on the Turn Windows Features on or off link.
- Checkmark the .NET Framework 3.5 (includes .NET 2.0 and 3.0) checkbox
- Click OK to start the installation
- Once the installation is complete, click Close
- Close the Programs and Features
- Proceed with the next step in the AGRIS installation.
- For all other supported client operating systems, there are no extra steps for the .NET Framework.
- For Windows 8.1 and Windows 10 and Windows 11, part of the.NET Framework must be installed through the Programs and Features:
Open the Agrisdist network share created in section 2.10,Anchor ClientNextStep ClientNextStep - Open the Setup.exe:
- Right-click the Setup.exe and choose Run as Administrator. If there is a User Account Control message, click Allow.
...
Install components in the following order:
Pervasive® PSQL™ 32Actian PSQL/Zen 32-bit Client |
Create a COM+ Services User Account |
AGRIS Server |
...
Anchor | ||||
---|---|---|---|---|
|
Install the Pervasive Actian Zen Client Engine in accordance with the instructions available at
https://culturana.force.com/s/article/ka036000000oLocAAE/AGRIS-Installing-Actian-PSQL-v12-SP1-and-Update-3?r=1 HERE
Install the AGRIS Server in accordance with the instructions contained in section Server Installation.
Install the AGRIS Client in accordance with the instructions contained in section Client Installation.
...
Install components in the following order based on the workstation operating system:
Windows 8.1Windows 10 | Windows 11 | ||
---|---|---|---|
Pervasive® PSQL™ Workgroup | Pervasive® PSQL™ Workgroup | Pervasive® PSQL™ WorkgroupActian PSQL/Zen Workgroup | Actian PSQL/Zen Workgroup |
AGRIS Standalone | AGRIS Standalone | AGRIS Standalone |
Anchor | ||||
---|---|---|---|---|
|
...
24.0.0 Standalone Installation
- Installing the .NET Framework:
- For Windows 8.1 and Windows 10 and Windows 11, part of the.NET Framework must be installed through the Programs and Features:
- Click Start and type "Programs and Features", then click on the Programs and Features.
- Click on the Turn Windows Features on or off link.
- Checkmark the .NET Framework 3.5 (includes .NET 2.0 and 3.0) checkbox
- Click OK to start the installation
- Once the installation is complete, click Close
- Close the Programs and Features
- Proceed with the next step in the AGRIS installation.
- For all other supported standalone operating systems, there are no extra steps for the .NET Framework.
- For Windows 8.1 and Windows 10 and Windows 11, part of the.NET Framework must be installed through the Programs and Features:
...
- The final step in the installation process takes place in a command window. Do not manually close this window. When complete, this command window will automatically close and the computer will restart.
The Command Window
Configuring the Cultura AGRIS SYS License Service
Depending on your configuration and installation type, you may need to configure the Cultura AGRIS SYS License Service. Refer to the instructions on this page.
Anchor | ||||
---|---|---|---|---|
|
...
If you are converting from earlier versions of the AGRIS Business System to Version 2324.0.0, this is a simple process.
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.
Anchor | ||||
---|---|---|---|---|
|
Anchor | ||||
---|---|---|---|---|
|
Anchor | ||||
---|---|---|---|---|
|
...
24.0.0
- Launch AGRIS 2324.0.0 and the Select Dataset screen will appear.
- Choose the desired dataset and click Select.
- A window appears describing that a dataset conversion is required.
...
Use the licensing setup to set the number of user licenses for each purchased package. The licensing setup for the AGRIS Business System is located in the main system menu under Help. Use this process along with the licensing diskette that accompanies the AGRIS 2324.0.0 installation CD. Load the licensing diskette during installation or if any package licenses are upgraded.
Note:Program module icons are not present until the package is licensed for use. An access code is required during this procedure, so perform this procedure during hours when the Technical Assistance Center (800-366-2474) is available. Tell them that you are performing the license update procedure and need an access code.
...
Note: Extended options control access to selected package menu options. Upgrading to AGRIS 2324.0.0 requires application of initial extended option settings from the license file. All extended options are considered "off" until this process is complete. Skipping this process will block access to package menu options controlled by extended options.
...
If the current dataset has already been converted to AGRIS 2324.0.0 and this is the first time Extended Option System Default Settings have been updated, then elect to update the current dataset with the System Default Settings. Once Extended Option System Default Settings are set, they will be automatically applied to a dataset during conversion to AGRIS 2324.0.0, or when a package is initialized in a dataset.
...
- The Target command, above, shows an example of allowing the shortcut to point to an alternate agris.ini file. This is accomplished by including the "/I" parameter, followed by the drive letter and full directory path, then the name of the agris.ini file. You can also use this new parameter within a .BAT file from DOS when launching the main AGRIS menu (SysMenu.exe). You can set up multiple desktop shortcuts or batch files and use the command line parameter to access the alternate agris.ini files. The contents of the alternate agris.ini file allow access to multiple sets of "dataset" directory and "userprog" directories with one installation of the Version 2324.0.0 system.
- Add the current .ini file location and current SUPPORT and USERPROG path settings. Since you can access multiple INI files, the System Information Report was enhanced to show the currently active Userprog, Support and Data paths, and the currently active agris.ini file.
...
If your datasets require reformatting as part of the upgrade to AGRIS 2324.0.0, a new validation utility now allows you to scan these datasets for errors before converting them.
When starting a Dataset Conversion during the upgrade to Version 2324.0.0, the Select Dataset window will appear.
...
Note: If the Btrieve 8020 error still occurs, uninstall Pervasive Actian PSQL/Zen, then reinstall it.
Anchor | ||||
---|---|---|---|---|
|
Anchor | ||||
---|---|---|---|---|
|
...
The following is a list of tips, known issues, and best practices for installing or upgrading to more recent Microsoft operating systems, Pervasive® PSQL™Actian PSQL/Zen, and AGRIS 2324.0.0.
Anchor | ||||
---|---|---|---|---|
|
Anchor | ||||
---|---|---|---|---|
|
Anchor | ||||
---|---|---|---|---|
|
...
Actian PSQL/Zen
If you are upgrading from Pervasive PSQL v8.X, uninstall that version of PSQL before installing a version supported by the new version of AGRIS. | |
If you already use Pervasive Back-up Agent™, you must purchase Back-up Agent 2.0 for use with Pervasive® PSQL™ v11 or v12. See the Pervasive web site for details. | |
NOTE: The Create File Version and the Limit Segment Size settings discussed in this section are applied automatically as part of the AGRIS install when you allow the system to apply optimization changes towards the end of the installation routine. The information below is provided for reference only. | |
When converting datasets with split files (files that have split to .^01 or more on the files), there is a possibility of overloading the Transaction Log file size allocation for files in that dataset. Uncheck the Limit Segment Size to 2GB option in the Pervasive® PSQL™ Pervasive/Zen Control Center Workstation Properties window. |
...
RetailWise customers cannot upgrade directly to this version of AGRIS and must coordinate their upgrade to Store Manager ES and this version of AGRIS 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 this version of AGRIS. | |
If upgrading to Pervasive® PSQL™ to Actian PSQL/Zen v10 or greater, instead of uninstalling the previous version and installing the new version: | |
If the .db file format is incompatible or corrupt, you may receive a *Btrieve 46 error (access to file denied). This error could also affect any of the *.db files in the C:\Retailwise\Vertical folder. |
...
You cannot apply an Auto Update to a Windows Server machine. All Service Pack installations must be carried out manually, while logged in as an Administrator. | |
If you need to set up an ODBC connection for Junge® Automated Blenders in a 64-bit environment, you will need to open the ODBC setup via C:\Windows\SysWOW64\odbcad32.exe. The ODBC setup that opens through the Windows Control Panel (C:\Windows\System32\odbcad32.exe) has only one option (SQL Server). | |
Changing the color scheme from the Windows Server 2008 basic color scheme to either the Standard or Classic color scheme may cause some disabled AgroGuide fields to appear as though they are available. |
Dataset Conversions
Start all conversions on the Database server. | |
The Database Conversion utility creates a log entry for the conversion of each package in the dataset. | |
On workstations where both AGRIS and Fuel Connect™ are installed, you must stop the Fuel Connect service before upgrading AGRIS. | |
When transferring data between datasets using either the DTR process or Imports, ensure that both datasets are already converted to AGRIS 23.0.0 before starting the transfer process. | |
When validating datasets prior to conversion, a File not Found or Package not Found entry may appear in the error log. While this does not prevent the conversion process from running, you may need to rebuild some dataset files following the conversion. If necessary, call the Technical Assistance Center (800-366-2474) for further assistance. | |
If you receive an Auto Blender Log cannot create session message, it indicates that an invalid login attempt occurred for an auto blender. | |
AgroGuide Data Scrub: This conversion automatically corrects any Farm, Field, or Crop Zone codes that end with characters other than 0-9, a-z or A-Z. | |
Changing the color scheme from the Windows Server 2008 basic color scheme to either the Standard or Classic color scheme may cause some disabled AgroGuide fields to appear as though they are available. |
Dataset Conversions
Optimization Settings
There are three areas covered by the Optimization Settings:
Recommended Settings for
PervasiveActian PSQL/Zen
Clicking Yes on the Optimization Settings prompt will apply the recommended settings for AGRIS for the Pervasive the Actian PSQL/Zen installation on the local machine. There are recommended settings for the Client, Server, and Workgroup installation types
Clicking No on the Optimization Settings prompt will not apply the recommended settings; your Pervasive your Actian PSQL/Zen settings will remain the same.
...
Configuring the File Close Delay setting for Actian Zen v15™
For AGRIS version 2324.0.0, using Actian Zen v15™ requires the “File Close Delay” setting to be set to zero. This needs to be set on any machines running the Server or Workgroup version of Actian Zen v15™. The AGRIS installation will automatically set this to zero. If you need to set this value manually, follow these steps:
...
Page Tree | ||||||
---|---|---|---|---|---|---|
|
This bulletin contains proprietary and confidential information owned by Cultura Technologies, LLC and which is subject to laws, regulations, and treaties and the provisions of your Cultura Technologies, LLC license agreement. Any copying, dissemination, or use of this bulletin or its contents without prior written consent from Cultura Technologies, LLC is expressly prohibited.