{"id":42540,"date":"2026-02-27T09:01:00","date_gmt":"2026-02-27T08:01:00","guid":{"rendered":"https:\/\/www.dbi-services.com\/blog\/?p=42540"},"modified":"2026-02-18T17:27:47","modified_gmt":"2026-02-18T16:27:47","slug":"relocate-trail-files-with-convchk-when-migrating-goldengate-to-the-microservices-architecture","status":"publish","type":"post","link":"https:\/\/www.dbi-services.com\/blog\/relocate-trail-files-with-convchk-when-migrating-goldengate-to-the-microservices-architecture\/","title":{"rendered":"Relocate trail files with convchk when migrating GoldenGate to the Microservices Architecture"},"content":{"rendered":"\n

Depending on the location of your GoldenGate trail files, you might have to use the convchk<\/code> utility to relocate them before migrating to the Microservices Architecture<\/a>. Oracle has the following restrictions<\/a> for using the migration utility:<\/p>\n\n\n\n

\n

Absolute path names for trail files. Classic trail file MUST reside in .\/dirdat<\/code> (or a subdirectory within it). If the trail file reside in another directory, they can be moved to .\/dirdat<\/code> and then modify the checkpoint using the convchk<\/code> utility for the Extract. Then modify the parameter for any Replicat that is affected. See convchk in the Parameters and Functions Reference for Oracle GoldenGate for Oracle GoldenGate 21c.<\/p>\n<\/blockquote>\n\n\n\n

But what exactly does that mean, and what should you do if you fall in the restriction described above ?<\/p>\n\n\n\n

Which setups are supported, and which setups are not<\/h2>\n\n\n\n

Oracle clearly states that trail files directly located in dirdat<\/code> or a subdirectory are supported. But what about other setups ?<\/p>\n\n\n\n

    \n
  • If your trail files are not directly in the same file system but under a link located in .\/dirdat<\/code>, then you will have no problem with the migration utility.<\/li>\n<\/ul>\n\n\n\n
      \n
    • If your trail files are located in a completely other location that doesn’t start with .\/dirdat<\/code>, you will receive the following error when migrating. If you fall under this case, see the chapter about using the convchk<\/code> utility.<\/li>\n<\/ul>\n\n\n\n
      ERROR: Error EXTRACT EXT_MB does not have trail files in the .\/dirdat subdirectory of \/u01\/app\/oracle\/product\/ogg19\/ and cannot be migrated.<\/code><\/pre>\n\n\n\n
      What should you pay attention to ?<\/h2>\n\n\n\n
      Even if your trail files are correctly set with a path relative to dirdat<\/code>, there is something you should note when using the migration utility. Oracle won’t just analyze and copy the trail files<\/strong>. The migration utility will also target all the content within the folders<\/strong> registered in your extracts.<\/p>\n\n\n\n
      If you have a trail file in .\/dirdat\/subfolder<\/code>, make sure you only have trail files that you want to migrate. Other files inside subfolder<\/code> will also be copied, delaying the migration or worse ! Same thing with links, which could lead to infinite references <\/strong>and make the migration crash<\/strong>.<\/p>\n\n\n\n
      Using the convchk<\/code> utility<\/h2>\n\n\n\n
      Using the failing migration example given above, I will try to correct settings for the extract EXT_MB<\/code>, defined with EXTTRAIL \/u02\/ogg\/mb<\/code>, location outside of the supported dirdat<\/code> directory. We will use convchk<\/code>, a binary located within OGG_HOME<\/code> in a Classic Architecture setup. <\/p>\n\n\n\n
      [oracle@vmogg ~]$ \/u01\/app\/oracle\/product\/ogg19\/convchk\nUsage  : convchk <checkpoint_group> <trail_name> (SEQLEN_9D | SEQLEN_6D) [-force]<\/code><\/pre>\n\n\n\n
      Choosing .\/dirdat\/mb<\/code> as the new trail name, here is a complete example on how to relocate trail files with convchk.<\/p>\n\n\n\n
      [oracle@vmogg ogg19]$ .\/convchk ext_mb \/u01\/ogg\/mb TRAILPATH .\/dirdat\/mb\n***********************************************************************\n      Oracle GoldenGate Checkpoint Conversion Utility for Oracle\n      Version 19.1.0.0.4 OGGCORE_19.1.0.0.0_PLATFORMS_191017.1054\n         Linux, x64, 64bit (optimized) on Oct 17 2019 15:31:11\nCopyright (C) 1995, 2019, Oracle and\/or its affiliates. All rights reserved.\n                    Starting at 2025-12-29 14:40:53\n***********************************************************************\nOperating System Version:\nLinux\nVersion #2 SMP Sun Sep 21 08:53:14 PDT 2025, Release 5.15.0-312.187.5.3.el8uek.x86_64\nNode: vmogg\nMachine: x86_64\n                         soft limit   hard limit\nAddress Space Size   :    unlimited    unlimited\nHeap Size            :    unlimited    unlimited\nFile Size            :    unlimited    unlimited\nCPU Time             :    unlimited    unlimited\nProcess id: 18078\nCheckpoint for Extract group EXT_MB has been backedup to \/u01\/app\/oracle\/product\/ogg19\/dirchk\/EXT_MB.cpe.1767019253.bak.\n\nCheckpoint output trail file path \/u01\/ogg\/mb has been updated to a new trail file path .\/dirdat\/mb for the Extract group EXT_MB.\n\nCheckpoint conversion successful for group EXT_MB, trail file \/u01\/ogg\/mb.<\/code><\/pre>\n\n\n\n
      Now, move all trail files to the new location, and edit the extract parameter file so that it points to the dirdat<\/code> folder.<\/p>\n\n\n\n
      # Moving trail files\nmv \/u01\/ogg\/mb* \/u01\/app\/oracle\/product\/ogg19\/dirdat\n\n# Editing parameter file\nGGSCI > edit params ext_mb\nGGSCI > view params ext_mb\n...\nEXTTRAIL .\/dirdat\/mb\n...<\/code><\/pre>\n\n\n\n
      And that’s it ! After restarting the extract, you can view the report to check the new location.<\/p>\n\n\n\n
      GGSCI > view report ext_mb\n...\n2025-12-29 14:44:06  INFO    OGG-01026  Rolling over remote file .\/dirdat\/mb000000000.\n2025-12-29 14:44:06  INFO    OGG-01053  Recovery completed for target file .\/dirdat\/mb000000001, at RBA 1345.<\/code><\/pre>\n\n\n\n
      The extract has been properly moved to a new location supported by the migration utility. You can now stop the extract and proceed with the migration as you would do with any other extract.<\/p>\n","protected":false},"excerpt":{"rendered":"
      Depending on the location of your GoldenGate trail files, you might have to use the convchk utility to relocate them before migrating to the Microservices Architecture. Oracle has the following restrictions for using the migration utility: Absolute path names for trail files. Classic trail file MUST reside in .\/dirdat (or a subdirectory within it). If the trail […]<\/p>\n","protected":false},"author":152,"featured_media":0,"comment_status":"open","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"_acf_changed":false,"footnotes":""},"categories":[3787,59],"tags":[3780,3814,3812,328,3229,2562,3813,1812],"type_dbi":[3783,3815,3740,3231,3786,3816],"class_list":["post-42540","post","type-post","status-publish","format-standard","hentry","category-goldengate","category-oracle","tag-classic","tag-convchk","tag-dirdat","tag-goldengate","tag-microservices","tag-migration-2","tag-trail","tag-utility","type-classic","type-convchk","type-goldengate","type-microservices","type-migration","type-trail-files"],"acf":[],"yoast_head":"\nRelocate trail files with convchk when migrating GoldenGate to the Microservices Architecture - dbi Blog<\/title>\n<meta name=\"description\" content=\"Trail files relocation with the convchk utility when using GoldenGate migration utility to Microservices Architecture\" \/>\n<meta name=\"robots\" content=\"index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1\" \/>\n<link rel=\"canonical\" href=\"https:\/\/www.dbi-services.com\/blog\/relocate-trail-files-with-convchk-when-migrating-goldengate-to-the-microservices-architecture\/\" \/>\n<meta property=\"og:locale\" content=\"en_US\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"Relocate trail files with convchk when migrating GoldenGate to the Microservices Architecture\" \/>\n<meta property=\"og:description\" content=\"Trail files relocation with the convchk utility when using GoldenGate migration utility to Microservices Architecture\" \/>\n<meta property=\"og:url\" content=\"https:\/\/www.dbi-services.com\/blog\/relocate-trail-files-with-convchk-when-migrating-goldengate-to-the-microservices-architecture\/\" \/>\n<meta property=\"og:site_name\" content=\"dbi Blog\" \/>\n<meta property=\"article:published_time\" content=\"2026-02-27T08:01:00+00:00\" \/>\n<meta name=\"author\" content=\"Julien Delattre\" \/>\n<meta name=\"twitter:card\" content=\"summary_large_image\" \/>\n<meta name=\"twitter:label1\" content=\"Written by\" \/>\n\t<meta name=\"twitter:data1\" content=\"Julien Delattre\" \/>\n\t<meta name=\"twitter:label2\" content=\"Est. reading time\" \/>\n\t<meta name=\"twitter:data2\" content=\"2 minutes\" \/>\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\"@context\":\"https:\/\/schema.org\",\"@graph\":[{\"@type\":\"Article\",\"@id\":\"https:\/\/www.dbi-services.com\/blog\/relocate-trail-files-with-convchk-when-migrating-goldengate-to-the-microservices-architecture\/#article\",\"isPartOf\":{\"@id\":\"https:\/\/www.dbi-services.com\/blog\/relocate-trail-files-with-convchk-when-migrating-goldengate-to-the-microservices-architecture\/\"},\"author\":{\"name\":\"Julien Delattre\",\"@id\":\"https:\/\/www.dbi-services.com\/blog\/#\/schema\/person\/764ab019cc9dec42655b4c6b9b8e474e\"},\"headline\":\"Relocate trail files with convchk when migrating GoldenGate to the Microservices Architecture\",\"datePublished\":\"2026-02-27T08:01:00+00:00\",\"mainEntityOfPage\":{\"@id\":\"https:\/\/www.dbi-services.com\/blog\/relocate-trail-files-with-convchk-when-migrating-goldengate-to-the-microservices-architecture\/\"},\"wordCount\":469,\"commentCount\":0,\"keywords\":[\"classic\",\"convchk\",\"dirdat\",\"GoldenGate\",\"microservices\",\"migration\",\"trail\",\"utility\"],\"articleSection\":[\"GoldenGate\",\"Oracle\"],\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"CommentAction\",\"name\":\"Comment\",\"target\":[\"https:\/\/www.dbi-services.com\/blog\/relocate-trail-files-with-convchk-when-migrating-goldengate-to-the-microservices-architecture\/#respond\"]}]},{\"@type\":\"WebPage\",\"@id\":\"https:\/\/www.dbi-services.com\/blog\/relocate-trail-files-with-convchk-when-migrating-goldengate-to-the-microservices-architecture\/\",\"url\":\"https:\/\/www.dbi-services.com\/blog\/relocate-trail-files-with-convchk-when-migrating-goldengate-to-the-microservices-architecture\/\",\"name\":\"Relocate trail files with convchk when migrating GoldenGate to the Microservices Architecture - dbi Blog\",\"isPartOf\":{\"@id\":\"https:\/\/www.dbi-services.com\/blog\/#website\"},\"datePublished\":\"2026-02-27T08:01:00+00:00\",\"author\":{\"@id\":\"https:\/\/www.dbi-services.com\/blog\/#\/schema\/person\/764ab019cc9dec42655b4c6b9b8e474e\"},\"description\":\"Trail files relocation with the convchk utility when using GoldenGate migration utility to Microservices Architecture\",\"breadcrumb\":{\"@id\":\"https:\/\/www.dbi-services.com\/blog\/relocate-trail-files-with-convchk-when-migrating-goldengate-to-the-microservices-architecture\/#breadcrumb\"},\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\/\/www.dbi-services.com\/blog\/relocate-trail-files-with-convchk-when-migrating-goldengate-to-the-microservices-architecture\/\"]}]},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\/\/www.dbi-services.com\/blog\/relocate-trail-files-with-convchk-when-migrating-goldengate-to-the-microservices-architecture\/#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Accueil\",\"item\":\"https:\/\/www.dbi-services.com\/blog\/\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Relocate trail files with convchk when migrating GoldenGate to the Microservices Architecture\"}]},{\"@type\":\"WebSite\",\"@id\":\"https:\/\/www.dbi-services.com\/blog\/#website\",\"url\":\"https:\/\/www.dbi-services.com\/blog\/\",\"name\":\"dbi Blog\",\"description\":\"\",\"potentialAction\":[{\"@type\":\"SearchAction\",\"target\":{\"@type\":\"EntryPoint\",\"urlTemplate\":\"https:\/\/www.dbi-services.com\/blog\/?s={search_term_string}\"},\"query-input\":{\"@type\":\"PropertyValueSpecification\",\"valueRequired\":true,\"valueName\":\"search_term_string\"}}],\"inLanguage\":\"en-US\"},{\"@type\":\"Person\",\"@id\":\"https:\/\/www.dbi-services.com\/blog\/#\/schema\/person\/764ab019cc9dec42655b4c6b9b8e474e\",\"name\":\"Julien Delattre\",\"image\":{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\/\/secure.gravatar.com\/avatar\/a97d00e680bbf237126e24b65281cbcb66cd20bd1ed2d14bf928991b2bf68eb5?s=96&d=mm&r=g\",\"url\":\"https:\/\/secure.gravatar.com\/avatar\/a97d00e680bbf237126e24b65281cbcb66cd20bd1ed2d14bf928991b2bf68eb5?s=96&d=mm&r=g\",\"contentUrl\":\"https:\/\/secure.gravatar.com\/avatar\/a97d00e680bbf237126e24b65281cbcb66cd20bd1ed2d14bf928991b2bf68eb5?s=96&d=mm&r=g\",\"caption\":\"Julien Delattre\"},\"url\":\"https:\/\/www.dbi-services.com\/blog\/author\/juliendelattre\/\"}]}<\/script>\n<!-- \/ Yoast SEO Premium plugin. -->","yoast_head_json":{"title":"Relocate trail files with convchk when migrating GoldenGate to the Microservices Architecture - dbi Blog","description":"Trail files relocation with the convchk utility when using GoldenGate migration utility to Microservices Architecture","robots":{"index":"index","follow":"follow","max-snippet":"max-snippet:-1","max-image-preview":"max-image-preview:large","max-video-preview":"max-video-preview:-1"},"canonical":"https:\/\/www.dbi-services.com\/blog\/relocate-trail-files-with-convchk-when-migrating-goldengate-to-the-microservices-architecture\/","og_locale":"en_US","og_type":"article","og_title":"Relocate trail files with convchk when migrating GoldenGate to the Microservices Architecture","og_description":"Trail files relocation with the convchk utility when using GoldenGate migration utility to Microservices Architecture","og_url":"https:\/\/www.dbi-services.com\/blog\/relocate-trail-files-with-convchk-when-migrating-goldengate-to-the-microservices-architecture\/","og_site_name":"dbi Blog","article_published_time":"2026-02-27T08:01:00+00:00","author":"Julien Delattre","twitter_card":"summary_large_image","twitter_misc":{"Written by":"Julien Delattre","Est. reading time":"2 minutes"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"Article","@id":"https:\/\/www.dbi-services.com\/blog\/relocate-trail-files-with-convchk-when-migrating-goldengate-to-the-microservices-architecture\/#article","isPartOf":{"@id":"https:\/\/www.dbi-services.com\/blog\/relocate-trail-files-with-convchk-when-migrating-goldengate-to-the-microservices-architecture\/"},"author":{"name":"Julien Delattre","@id":"https:\/\/www.dbi-services.com\/blog\/#\/schema\/person\/764ab019cc9dec42655b4c6b9b8e474e"},"headline":"Relocate trail files with convchk when migrating GoldenGate to the Microservices Architecture","datePublished":"2026-02-27T08:01:00+00:00","mainEntityOfPage":{"@id":"https:\/\/www.dbi-services.com\/blog\/relocate-trail-files-with-convchk-when-migrating-goldengate-to-the-microservices-architecture\/"},"wordCount":469,"commentCount":0,"keywords":["classic","convchk","dirdat","GoldenGate","microservices","migration","trail","utility"],"articleSection":["GoldenGate","Oracle"],"inLanguage":"en-US","potentialAction":[{"@type":"CommentAction","name":"Comment","target":["https:\/\/www.dbi-services.com\/blog\/relocate-trail-files-with-convchk-when-migrating-goldengate-to-the-microservices-architecture\/#respond"]}]},{"@type":"WebPage","@id":"https:\/\/www.dbi-services.com\/blog\/relocate-trail-files-with-convchk-when-migrating-goldengate-to-the-microservices-architecture\/","url":"https:\/\/www.dbi-services.com\/blog\/relocate-trail-files-with-convchk-when-migrating-goldengate-to-the-microservices-architecture\/","name":"Relocate trail files with convchk when migrating GoldenGate to the Microservices Architecture - dbi Blog","isPartOf":{"@id":"https:\/\/www.dbi-services.com\/blog\/#website"},"datePublished":"2026-02-27T08:01:00+00:00","author":{"@id":"https:\/\/www.dbi-services.com\/blog\/#\/schema\/person\/764ab019cc9dec42655b4c6b9b8e474e"},"description":"Trail files relocation with the convchk utility when using GoldenGate migration utility to Microservices Architecture","breadcrumb":{"@id":"https:\/\/www.dbi-services.com\/blog\/relocate-trail-files-with-convchk-when-migrating-goldengate-to-the-microservices-architecture\/#breadcrumb"},"inLanguage":"en-US","potentialAction":[{"@type":"ReadAction","target":["https:\/\/www.dbi-services.com\/blog\/relocate-trail-files-with-convchk-when-migrating-goldengate-to-the-microservices-architecture\/"]}]},{"@type":"BreadcrumbList","@id":"https:\/\/www.dbi-services.com\/blog\/relocate-trail-files-with-convchk-when-migrating-goldengate-to-the-microservices-architecture\/#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"Accueil","item":"https:\/\/www.dbi-services.com\/blog\/"},{"@type":"ListItem","position":2,"name":"Relocate trail files with convchk when migrating GoldenGate to the Microservices Architecture"}]},{"@type":"WebSite","@id":"https:\/\/www.dbi-services.com\/blog\/#website","url":"https:\/\/www.dbi-services.com\/blog\/","name":"dbi Blog","description":"","potentialAction":[{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https:\/\/www.dbi-services.com\/blog\/?s={search_term_string}"},"query-input":{"@type":"PropertyValueSpecification","valueRequired":true,"valueName":"search_term_string"}}],"inLanguage":"en-US"},{"@type":"Person","@id":"https:\/\/www.dbi-services.com\/blog\/#\/schema\/person\/764ab019cc9dec42655b4c6b9b8e474e","name":"Julien Delattre","image":{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/secure.gravatar.com\/avatar\/a97d00e680bbf237126e24b65281cbcb66cd20bd1ed2d14bf928991b2bf68eb5?s=96&d=mm&r=g","url":"https:\/\/secure.gravatar.com\/avatar\/a97d00e680bbf237126e24b65281cbcb66cd20bd1ed2d14bf928991b2bf68eb5?s=96&d=mm&r=g","contentUrl":"https:\/\/secure.gravatar.com\/avatar\/a97d00e680bbf237126e24b65281cbcb66cd20bd1ed2d14bf928991b2bf68eb5?s=96&d=mm&r=g","caption":"Julien Delattre"},"url":"https:\/\/www.dbi-services.com\/blog\/author\/juliendelattre\/"}]}},"_links":{"self":[{"href":"https:\/\/www.dbi-services.com\/blog\/wp-json\/wp\/v2\/posts\/42540","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.dbi-services.com\/blog\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/www.dbi-services.com\/blog\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/www.dbi-services.com\/blog\/wp-json\/wp\/v2\/users\/152"}],"replies":[{"embeddable":true,"href":"https:\/\/www.dbi-services.com\/blog\/wp-json\/wp\/v2\/comments?post=42540"}],"version-history":[{"count":12,"href":"https:\/\/www.dbi-services.com\/blog\/wp-json\/wp\/v2\/posts\/42540\/revisions"}],"predecessor-version":[{"id":42991,"href":"https:\/\/www.dbi-services.com\/blog\/wp-json\/wp\/v2\/posts\/42540\/revisions\/42991"}],"wp:attachment":[{"href":"https:\/\/www.dbi-services.com\/blog\/wp-json\/wp\/v2\/media?parent=42540"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.dbi-services.com\/blog\/wp-json\/wp\/v2\/categories?post=42540"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.dbi-services.com\/blog\/wp-json\/wp\/v2\/tags?post=42540"},{"taxonomy":"type","embeddable":true,"href":"https:\/\/www.dbi-services.com\/blog\/wp-json\/wp\/v2\/type_dbi?post=42540"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}