Best practices for migrating from AtoM 2.6 to Heratio

Discussion
238
Maria Santos
Dec 10, 2025 9:15 AM

We recently migrated our institution from AtoM 2.6 to Heratio. Here are some lessons learned:

  • Always backup your database first
  • Test the migration on a staging server
  • Check custom themes for compatibility
  • Run the data validation tools after migration

Happy to answer questions!

5 Replies

Johan Pieterse Dec 11, 2025 9:00 AM

Great writeup Maria! I'd also recommend running the display:auto-detect command after migration to properly configure the GLAM type facets. Also make sure your Elasticsearch index is rebuilt with search:populate.

Sipho Dlamini Dec 15, 2025 11:00 AM

We had a similar migration. One thing I'd add: if you have custom descriptive standards, make sure to map them properly. The ahgDataMigrationPlugin has a field mapping tool that helps with this.