[DOCS-12438] Docs for TOOLS-1817: Add 'preserveUUIDs' flag to restore collections with existing UUIDS Created: 07/Feb/19  Updated: 13/Nov/23  Resolved: 13/Dec/19

Status: Closed
Project: Documentation
Component/s: manual, Server
Affects Version/s: None
Fix Version/s: 4.0.0-rc0, 3.7.10, Server_Docs_20231030, Server_Docs_20231106, Server_Docs_20231105, Server_Docs_20231113

Type: Task Priority: Major - P3
Reporter: Kay Kim (Inactive) Assignee: Unassigned
Resolution: Fixed Votes: 0
Labels: None
Remaining Estimate: Not Specified
Time Spent: Not Specified
Original Estimate: Not Specified

Issue Links:
Documented
documents TOOLS-1817 Add 'preserveUUIDs' flag to restore c... Closed
Duplicate
is duplicated by DOCS-12437 Docs for TOOLS-1862: Revise UUID supp... Closed
Participants:
Days since reply: 4 years, 8 weeks, 5 days ago
Epic Link: DOCSP-1769

 Description   

Description

Description:

When we define a new flag for restoring existing UUIDs, it will need to be added to the docs.

Engineering Ticket Description:

In MongoDB 3.6, collections can be created in two ways:

  • using create, they are assigned a new UUID
  • using applyOps, they can be created with a pre-existing UUID (details TBD)

However, creating with a UUID will require special permissions. We need to create a command line flag to opt into reusing existing UUIDs when restoring and to use the appropriate mechanism if set. The implications of doing so or not doing so will need to be documented.

Update: from TOOLS-1862 epic, the desired behavior is as follows:

  • Add a --preserveUUIDs flag
  • With --preserveUUIDs, have the following behaviors:
    • Require the --drop flag or abort
    • Require collection metadata to contain UUID info or abort
    • Require the destination to be in FCV 3.6 or abort (MUST check both ways that FCV could appear)
    • Create collections with the desired UUID with a synthesized applyOps command
      • Follow procedure in SERVER-31906 for creating admin.system.version with a given UUID
    • Apply oplog without removing UUIDs

Scope of changes

Impact to Other Docs

MVP (Work and Date)

Resources (Scope or Design Docs, Invision, etc.)



 Comments   
Comment by Githook User [ 13/Dec/19 ]

Author:

{'name': 'Kay Kim', 'email': 'kay.kim@10gen.com', 'username': 'kay-kim'}

Message: DOCS-12438: mongorestore --preserveUUID
Branch: v4.0
https://github.com/mongodb/docs/commit/9486f4bca4c9701d0e4c604d6b122d30cf097fc2

Comment by Githook User [ 13/Dec/19 ]

Author:

{'name': 'Kay Kim', 'email': 'kay.kim@10gen.com', 'username': 'kay-kim'}

Message: DOCS-12438: mongorestore --preserveUUID
Branch: master
https://github.com/mongodb/docs/commit/01314955a7de4f058e516d75ab26640b80f73035

Generated at Thu Feb 08 08:05:15 UTC 2024 using Jira 9.7.1#970001-sha1:2222b88b221c4928ef0de3161136cc90c8356a66.