docs.intersystems.com
Home / Release Notes and Upgrade Checklist / General Upgrade Information

Release Notes and Upgrade Checklist
General Upgrade Information
Previous section           Next section
InterSystems: The power behind what matters   
Search:  


This section provides information on upgrading from InterSystems IRIS 2018. to version 2019.1. InterSystems’ ultimate goal is to have a release which can be installed with no, or little, effect on the applications it supports.
Important Considerations
Compatibility
The goal of each release is a smooth upgrade to new and improved functionality with no changes required to existing applications. However, because of error corrections, significant enhancements, or changes to applicable standards, this goal cannot always be met. In this case, InterSystems discloses all identified instances where changes to applications are necessary so that customers can gauge effort required to move to the new release.
You may, after reading the release-specific changes, conclude that none of them affect your application. Even in this case, regardless of how robustly designed and how well implemented your application is, there is no substitute for quality assurance test results that confirm your judgement and demonstrate the application remains unaffected by the upgrade.
Important:
InterSystems recommends that each application be thoroughly tested in the upgraded environment before it is deployed to customers and begins processing live data.
Preview Release
Toward the end of development for each release, InterSystems may make available a preview version of the product to its customers. Notifications of the preview are published on the website and on public blogs. The purpose of this is two-fold:
InterSystems strongly encourages customers to plan on obtaining a preview release and to test their application against it.
Important:
InterSystems does not support upgrading from a preview version.
Unresponsive Systems
One of the goals for preview release is to expose the new release to real-world operating challenges to assure its reliability. Therefore, it is possible, although unlikely, that an unanticipated sequence of events may render InterSystems IRIS unresponsive. In this situation, it is extremely important to gather system diagnostic information while in the hung state for InterSystems to analyze. Should an instance of InterSystems IRIS become unresponsive,
Upgrade Specifics
This section contains specific instructions applicable to this transition.
Classes
InterSystems recommends that customers recompile all their classes contained in each namespace. This will assure that:
Class compiler version utility
To assist customers in determining which class compiler version a class or classes in a namespace have been compiled with, InterSystems provides two assists
Routines
ObjectScript routines do not need to be recompiled after upgrade with the following exception:
Cached Queries
Cached queries are always purged during upgrade. They are recompiled and cached as needed.
Web Services and SOAP
It is not necessary to re-import any Web Service Definition (WSDL) files.
Frozen Plans for SQL Queries
When you upgrade InterSystems IRIS to a new major version, existing Query Plans are automatically frozen. This ensures that a major software upgrade will never degrade the performance of an existing query. For performance-critical queries, you should test if you can achieve improved performance. For details, see Software Version Upgrade Automatically Freezes Plans
in the InterSystems SQL Optimization Guide.


Previous section           Next section
View this book as PDF   |  Download all PDFs
Copyright © 1997-2019 InterSystems Corporation, Cambridge, MA
Content Date/Time: 2019-04-23 13:43:24