diff --git a/guides/common/assembly_synchronizing-content-between-servers.adoc b/guides/common/assembly_synchronizing-content-between-servers.adoc index 5fe2b5e8fa0..8a42ad76f81 100644 --- a/guides/common/assembly_synchronizing-content-between-servers.adoc +++ b/guides/common/assembly_synchronizing-content-between-servers.adoc @@ -8,6 +8,8 @@ include::modules/proc_using-upstream-server-to-sync-content-view-versions.adoc[l include::modules/proc_synchronizing-a-single-repository.adoc[leveloffset=+2] +include::modules/proc_generating-metadata-and-listing-files-for-syncable-exports.adoc[leveloffset=+2] + include::modules/proc_synchronizing-a-custom-repository.adoc[leveloffset=+1] include::modules/proc_exporting-the-library-environment.adoc[leveloffset=+1] diff --git a/guides/common/modules/proc_generating-metadata-and-listing-files-for-syncable-exports.adoc b/guides/common/modules/proc_generating-metadata-and-listing-files-for-syncable-exports.adoc new file mode 100644 index 00000000000..b78e922f4f5 --- /dev/null +++ b/guides/common/modules/proc_generating-metadata-and-listing-files-for-syncable-exports.adoc @@ -0,0 +1,27 @@ +[id="generating-metadata-and-listing-files-for-syncable-exports"] += Generating metadata and listing files for syncable exports + +When exporting content in a syncable format, metadata and listing files are generated automatically. +However, you must manually trigger the generation of these files in the following circumstances: + +* When a non-root user is doing the export. +* When the `--async` flag has been passed, for root or non-root user. +* When using the {Project} API or Ansible modules to do the exports. + +.Prerequisites +* The syncable export directory is accessible on disk. + +.Procedure +. Generate metadata for a syncable export: ++ +[options="nowrap" subs="+quotes"] +---- +$ hammer content-export generate-metadata --path=/path/to/syncable/export +---- + +. Generate listing files for a syncable export directory: ++ +[options="nowrap" subs="+quotes"] +---- +$ hammer content-export generate-listing --path=/path/to/syncable/export +----