Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

 

Click here to go back to the Technical Info page

Upgrading from AGRIS 9.5.0.x and higher to 24.0.0

Table of Contents

Table of Contents
minLevel2


...

Anchor
_Toc475064503
_Toc475064503
Must Read – Warnings, Critical Changes, and Install Tips

TIP: Download the install package in advance (see STEP 1) as this can take some time to complete (download is approximately 510MB). There is no impact on users by simply downloading the install package (SETUP.EXE), so users can remain in the system during this step. Users will need to exit AGRIS while AGRIS is installing (Steps 2-4).
TIP: If there are standalone computers to update (e.g., remote oneWeigh workstations), complete Steps 1-4 on those units and perform all steps locally on the standalone machine.
TIP: This document assumes an existing installation of AGRIS 9.5.0.x or higher is already in place and that all machines running AGRIS meet the system requirements of the new release.

Anchor
_Toc475064504
_Toc475064504
Background Information

Since AGRIS installs are cumulative, applying the latest one can help ensure that you are getting the most out of the system. There are 5 major steps associated with the upgrade process. This document will guide you through performing those steps correctly and in the recommended order.

Anchor
_Toc475064505
_Toc475064505
STEP 1. Download the AGRIS 24.0.0 Installer on the AGRIS Database Server

...

  1. Determine if your regular backup and verification processes provide an acceptable level of protection in the event there are issues with the dataset conversion process.
  2. You may desire to manually backup the data immediately prior to installing 24.0.0 by copying the datasets, userprog and support folders via Windows Explorer, or by using an existing backup and verification process.
  3. Note: Recommendations pertaining to backing up AGRIS data may be found HERE.
  4. Note: Additional backup steps for those running AGRIS with MSSQL can be found here: https://culturatech.atlassian.net/wiki/x/2JPFBQ.

...

  1. "Welcome to the InstallShield Wizard for AGRIS Version 24.0.0" > click Next
  2. "AGRIS Setup is performing the requested operations"
  3. "InstallShield Wizard Complete" > click Finish.
  4. "Do you want to apply optimization changes?" > click Yes. Be sure to allow the black screen that appears to close on its own in order to complete the installation.
  5. Please reboot to complete the installation.  Rebooting after the AGRIS installation is mandatory.
  6. Repeat Steps 1-5 for each server that has AGRIS installed.


STEP 4. Configure the Cultura AGRIS SYS License Service

  1. Note that this step is new as of version 22.1.0.  Refer to the instructions on this page.

Anchor
_Toc475064508
_Toc475064508
STEP 5. Convert the Live Dataset(s)

...

  1. Launch AGRIS at the console of the database server and select the live dataset.
  2. A message appears indicating a conversion is required > click Validate to check the integrity of the data prior to conversion. If issues are found and you are asked if you want to rebuild these files, click Yes to allow the validation procedure to automatically perform the rebuild and
    validate again
  3. If there is no ***WARNING!...*** message showing, click OK to begin the conversion.
    1. NOTE: If there is a warning, and you require assistance, determining where it is coming from. Please contact the Technical Assistance Center.
  4. When the dataset conversion is complete, a Login screen will appear (assuming system security is enabled for the dataset).
  5. Login to the dataset to complete the conversion process.
  6. If using the AGRIS Blender Services for AgroGuide, the services will be disabled by default after installing AGRIS.
  7. Click Start > (Settings) > Control Panel > (System and Security) Administrative Tools > Computer Management
  8. On the right-hand side of the window, double-click Services and Applications – Services
  9. Right-click on "Cultura AGY Auto Control Service" and select Properties
  10. Click on the down arrow next to Start-up type, change from Disabled to Automatic (Delayed Start)
  11. Click on the tab that says Log On
  12. Click 'This account' and specify an administrative account and the correct password for the Password and Confirm Password fields.
  13. Click Apply and OK.
  14. Repeat Steps 9-13 for the "Cultura AGY Blender Service."
  15. Right-click on "Cultura AGY Auto Control Service" and select Start
  16. Right-click on "Cultura AGY Blender Service" and select Start

A few points to keep in mind when converting datasets:

...

  1. .NET Framework 3.5:
    1. For Windows 10 or Windows 11, this version of the .NET Framework must be installed manually. It may already be installed on your machine(s), however you need to confirm this before proceeding. Procedure:
      1. Click Start and type "Programs and Features", then click on the Programs and Features.
      2. Click on the Turn Windows Features on or off link.
      3. Checkmark the .NET Framework 3.5 (includes .NET 2.0 and 3.0) checkbox
      4. Click OK to start the installation
      5. Once the installation is complete, click Close
      6. Close the Programs and Features
  2. Double-click on the AGRIS icon on the desktop of the client workstation.
  3. "A new version of the system is now available. 24.0.0. Update now?" > click Yes
  4. If you are upgrading from 9.5.0.X, a window appears describing the change to the location of SYSMENU.EXE ("Important-Before you Install") that was mentioned previously. Please read the message carefully and click Yes.
  5. If prompted to install Microsoft .NET Framework 4.7.2, click Install. You will be prompted to reboot after this.  You can choose to reboot now or later, however rebooting after the .NET Framework installation is mandatory before proceeding with the remainder of the AGRIS installation.  Reboot and then log back in as the same user, and the AGRIS installation will automatically continue.
  6. "A previous version of AGRIS has been found on your system. Removal of the previous version of AGRIS is required. Would you like to uninstall the old version?" > click Yes.
  7. "AGRIS Install process check", click Yes
  8. "Reinstall or Remove this application", ensure that Remove is selected and click Next
  9. "Confirm Uninstall", click OK. Wait while the uninstall takes place. The process can take several minutes.
  10. The first "Error 1905.Module…" appears. This is expected when uninstalling 9.6.0.x or older. Click OK.
  11. The second "Error 1905.Module…" appears. This is expected when uninstalling 9.6.0.x or older. Click OK.
  12. "Maintenance Complete", click Finish
  13. "Welcome to the InstallShield Wizard for AGRIS Version 24.0.0" > click Next
  14. "AGRIS Setup is performing the requested operations"
  15. "InstallShield Wizard Complete" > click Finish.
  16. "Do you want to apply optimization changes?" > click Yes. Be sure to allow the black screen that appears to close on its own in order to complete the installation.
  17. Please reboot to complete the installation.  Rebooting after the AGRIS installation is mandatory.
  18. Repeat Steps 1-17 for all client workstations on the network.

* Windows 7 (no longer supported) units cannot update using this method unless AGRIS 9.5.0.27 or higher is already installed on those units.  To upgrade correctly from AGRIS 9.5.0.26 or previous, it is necessary to browse to the correct SETUP.EXE file, then right-click on SETUP.EXE and choose the "Run as administrator..." option. This manual upgrade method should also be attempted if step 3 doesn't prompt as indicated or any time you prefer not to let it Auto-Update.

...