Hexagon Geospatial


ERDAS APOLLO provides comprehensive data management and delivery which includes organizing geospatial and business data into a centralized library with cloud or on-premise distribution options.
Showing results for 
Search instead for 
Do you mean 

How to upgrade Apollo essential from version 2014 to version 2016

by Technical Evangelist ‎04-28-2017 06:16 AM - edited ‎08-10-2017 12:31 PM (1,761 Views)

Unforuntately there is no direct upgrade path from 2014 to 2016. User's upgrade from 2014 to 2016 will fail due to database compatibility issue.


Line 2286: Error: The upgrading path is not supported from version 4 to version 10. Please contact our support team.
2017-04-07 16:27:22:172 [13412] ERROR com.erdas.iws.config - Current database version(4) does not match the current Apollo Essentials release which requires database version(10).
2017-04-07 16:27:22:173 [13412] ERROR com.erdas.iws.config - Unable to copy database file (QSQLITE) to the backup file (QSQLITE.backup) and a new database is created. Please upgrade the existing database backup if needed.


There are two options:
[1] Install Apollo essential 2016 from scratch, delete the filelist.db, and then generate all services manually again in Apollo essential 2016.

[2] Upgrade Apollo essential in incremental level. Each of the database upgrader can upgrade from the previous version without issues, so if you install each new version of APOLLO Core/Essentials, and perform the upgrade, it should work.
In order to upgrade from 2014.0 to latest 2016.2, you have to follow the following order:

1. 2014.0/2014.1 -> 2015.5
2. 2015.5 -> 2016.2

Basically for users upgrading from v2014.x, they need to update to the v2015.x version first, then from there upgrade to the a later version.  To upgrade to the latest version, the above workflow is recommended, Version 2015.5 should be the intermediate version.


Or user can always follow the complete upgrade path:

1. 2014.1 -> 2015.0
2. 2015.0 -> 2015.3
3. 2015.3 -> 2015.5
4. 2015.5 -> 2016.0
5. 2016.0 -> 2016.2



When installing, you also need to go through the entire installation processing, install the files and run the configuration wizard. The upgrade of the dataset happens during configuration wizard stage. When uninstalling, keep the configuration.

Unfortunately this workflow is not documented in the Apollo essential 2016 user guide.
Here are the installers:





Database Version for Apollo Essential

Serve Version Number Server Name Database Version
2014.0 v14.0.0.90 ERDAS APOLLO Essentials 3
2014.1 v14.0.1.211 ERDAS APOLLO Essentials 4
2015.0 v15.0.0.214 ERDAS APOLLO Essentials 5
2015.3 v15.0.0.353 ERDAS APOLLO Essentials 5
2015.5 v15.0.0.367 ERDAS APOLLO Essentials 5
2016.0 v16.0.0.866 ERDAS APOLLO Core 8
2016.1 v16.0.0.1025 ERDAS APOLLO Core 9
2016.2 v16.0.0.1102 ERDAS APOLLO Core 10


on ‎04-30-2017 04:10 PM

Will this continue going forward?

e.g. will I be able to go from 16 ep02 to 17.x, or will I have to deploy 17.0, then 17.1, 17.2, ... etc?

(Would be quite time consuming uninstalling Apollo Complete then installing Apollo complete for each of the iterations)

by JoeBob
on ‎05-01-2017 08:14 AM



The upgrade from 14 to 15 was a big change in the catalog schema.  I am not sure why the suggest goining from 15.0 to 15.3 then 15.5.  15.5 is cumulative.  I recently installed 15.0 then went straight to 15.5 with no issues.  Then you can go from 15.5 to 16.0 then 16.2.


Their is a minor patch (6.3) this summer and the next major release will b 16.5 and not 17.0

on ‎05-01-2017 02:22 PM

Thanks Joe Bob, Just to clarify while we install complete we are also directly using essentials component for anon access - I think article is refering to essentials config database rather than the seperate full catalog db. Sounds like both went through major changes. Article explains why I lost the essentials config content going direct from 14 to 16 (phew - 'wasn't me'). Just getting to grips what I need to budget for next upgrade (possible number of uninstall/reinstall cycles) and whether can skip major upgrades. e.g. steps from 15.0 to ?16.5? for another client.

by phudson
on ‎08-09-2017 08:06 PM

I believe this issue is only when upgrading a version 4 database (v14.0.1.211)


There is a problem going from 4 to 5

After you get to version 5 (v15.0.0.214) you should be able to upgrade to any version.


Although there is one exception, there appears to be a problem in the v16 EP03 release that has trouble upgrading the database from 5 to 11 but it can be worked around by installing v16.0, 16.1 or 16.2  first.