Software Version
For every release of the HxGN NetWorks Web Services product family, a base suite of automated tests and a set of manual workflow tests are performed before the release is made available to customers. The scope of testing depends on the nature of the release. Major releases with architectural changes undergo the most thorough certification.
With every product release, care is taken to minimize the effect on existing configuration and customization that is used at customer sites. When new configurable functionality is introduced, defaults are set (whenever possible) to maintain previous behavior. Configuration wizards are provided to guide administrators through configuration decisions.
Regarding customization, backward compatibility with the previous version's API is maintained so that existing custom code runs after product upgrades. In the few cases where backward compatibility is not possible because of technological constraints, effects and recommended resolutions are documented in the HxGN NetWorks Web Services and HxGN NetWorks Core | Portal Release Notes.
Mixing HxGN NetWorks Web Services and HxGN NetWorks Core Versions
Enterprise production deployments of HxGN NetWorks Core and HxGN NetWorks Web Services often involve hundreds, or even thousands, of users running several different client applications (for example, desktop, web, mobile). Upgrading all users simultaneously to a new HxGN NetWorks Core version can be challenging for a company’s IT organization and business operations. When new versions of HxGN NetWorks Core and HxGN NetWorks Web Services are made available, compatibility of client applications with previous maintenance releases of the same release version and, when possible, previous release versions is maintained. This allows flexibility in making upgrade roll-out plans for client users.
The utmost effort is applied to have newer versions compatible with lower versions of other HxGN NetWorks Core client applications. Version compatibility is not always possible due to factors such as adoption of new technologies or architectures. If mixed-version compatibility is not possible, users are informed in the HxGN NetWorks Web Services and HxGN NetWorks Core | Portal Release Notes delivered with the product and posted to the Support (https://smartcommunity.hexagonppm.com/s/) page when the new software is made publicly available.
- In general, software from a quarterly update runs alongside other components of the system that remain at the base major release version.
- Any new functionality available in a new release might not function in a mixed-version environment.
The following sections provide specifics of mixed-version compatibility support with various combinations of HxGN NetWorks Core and HxGN NetWorks Web Services products and releases.
The term database in these sections refers to the metadata structure, as well as the database packages and procedures.
If you upgrade the database, the administrative users must operate with that same version of software to use metadata or to use API functions provided in the release.
If you do not upgrade the database, new software that relies on the new metadata does not operate.
HxGN NetWorks Core Database Versions Compatible with HxGN NetWorks Web Services 11.01.2501
HxGN NetWorks Web Services 11.01.2501 requires the HxGN NetWorks Core database to be upgraded to version 11.01.2201 or newer. This requires a 11.01.2201 or newer version of HxGN NetWorks Core | Admin. The data model HxGN NetWorks Web Services add-ons must be upgraded to version 11.01.2501. For details on partial upgrade, see HxGN NetWorks Web Services Administrator's Guide – Technical Documentation – Installation.
It is not necessary to upgrade other HxGN NetWorks Core client seats to 11.01.2501. For details on mixing HxGN NetWorks Core versions, see HxGN NetWorks Core Database-Software Version Compatibility.
The following table describes which HxGN NetWorks Core database versions are compatible with HxGN NetWorks Web Services 11.01.2501.
| HxGN NetWorks Core Database Version | HxGN NetWorks Web Services 11.01.2501 |
|---|---|
| 11.01.2501 | Compatible |
| Versions 11.01.2201 to 11.01.2402 | Compatible, not all functionality guaranteed to work |
| Versions prior to 11.01.2201 | Not compatible, but viable |
HxGN NetWorks Web Services | Admin Versions Compatible with HxGN NetWorks Web Services 11.01.2501
HxGN NetWorks Web Services | Admin and HxGN NetWorks Web Services must be the same version.
HxGN NetWorks Core | Portal Versions Compatible with HxGN NetWorks Web Services 11.01.2501
You can run older versions of Portal (01.03.1902 and higher) against newer versions of HxGN NetWorks Web Services (02.00.1812 and higher). You cannot run newer versions of Portal (02.00.1812 and higher) against older versions of HxGN NetWorks Web Services (lower than 02.00.1812).
Legend Builder Script Compatibility
In general, scripts created from the versions of Legend Builder listed in the table below are compatible with HxGN NetWorks Web Services version 11.01.2501 and can be applied to database version 11.01.2501.
| Legend Builder Version | Database Version |
|---|---|
| HxGN NetWorks Web Services 11.01.2501 | 11.01.2501 |
| HxGN NetWorks Web Services 11.01.2402 | 11.01.2402 |
| HxGN NetWorks Web Services 11.01.2401 | 11.01.2401 |
| HxGN NetWorks Web Services 11.01.2302 | 11.01.2302 |
| HxGN NetWorks Web Services 11.01.2301 | 11.01.2301 |
| HxGN NetWorks Web Services 11.01.2202 | 11.01.2202 |
| HxGN NetWorks Web Services 11.01.2201 | 11.01.2201 |
| HxGN NetWorks Web Services 02.00.2112 | 10.04.2112 |
| HxGN NetWorks Web Services 02.00.2106 | 10.04.2106 |
| Intergraph NetWorks 02.00.2012 | 10.04.2012 |
| Intergraph NetWorks 02.00.2006 | 10.04.2006 |
| Intergraph NetWorks 02.00.2003 | 10.04.2003 |
| Intergraph NetWorks 02.00.1912 | 10.04.1912 |
| Intergraph NetWorks 02.00.1909 | 10.04.1909 |
| Intergraph NetWorks 02.00.1906 | 10.04.1906 |
| Intergraph NetWorks 01.03.1908 | 10.03.1905 |
| Intergraph NetWorks 01.03.1902 | 10.03.1902 |