4,610
edits
Changes
m
When Gramps opens a tree, it locks the tree, preventing If you or anyone else opening it at ''could'' open the same time. A second copy Family Tree in two instances of Gramps will be able to open another family treeat once, but the tree already open will appear with the lock icon, indicating you cannot open it. Closing the tree in the first copy of Gramps will make it available to is likely your data would be opened in damaged as the second copytwo overwrite each other's work.
If you could open the same Family Tree in two Gramps at once, it is likely your data would be damaged====See also:====* [[Gramps_5.1_Wiki_Manual_-_Command_Line#Force_unlock_option|Command Line:Force unlock option]]
See also:* [[Gramps_5.1_Wiki_Manual_-_Command_Line#Force_unlock_option|Command Line:Force unlock option]]{{-man warn|Be careful Breaking Locks!|Only do this if you are sure no other copy of Gramps is using the selected Family Tree.}}
In the unlikely event that Gramps crashes, the family tree will be left in a locked state (indicated by a lock icon in the {{man label|Status}} colum next to To unlock the Family Trees name)Tree during startup
To unlock * If the [[Gramps_5.1_Wiki_Manual_-_Settings#Family_Tree|Family TreePreferences]] have been set to open a tree automatically on startup, then you will see the '''Error parsing arguments''' dialog which remarks that the '''Database is locked'''. Click on the {{man button|Close}} button then choose {{man menu|Manage Family trees...}} from the {{man menu|Family Trees}} menu. * Otherwise, the {{man label|Family Tree Manager}} will appear automatically as Gramps starts.
* If Gramps has been set to open a tree automatically [[File:Break-the-lock-on startup, then you will see -the 'Database is locked' dialogue-database-Dialog-example-50.png|thumb|right|450px|Fig. {{#var:chapter}}. Click {{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Break the lock on the "Sample" database? - Dialog - example ]]Choose the locked family tree and then click the {{man button|CloseLoad Family Tree}} button . The '''Break the lock on the '[Family Tree name]' database?''' dialog will be shown.
[[File:ErrorParsingArguments-dialog-DatabaseIsLocked-example-50.png|thumb|right|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Database is locked - Error parsing arguments - dialog - example]]{{-}}* Otherwise Click the {{man labelbutton|Family Tree ManagerBreak lock}} will appear. Choose the locked family tree button and then click the {{man buttonlabel|Load Family TreeTrees (Manager)}} button. The {{man label|Break window should show that the lock on the "[Family Tree name]" database?}} dialog will be shownicon has gone.
[[File:Break-the-lock-on-the-database-Dialog-example-50.png|thumb|right|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Break the lock on the "Sample" database? - Dialog - example ]] {{-}}* {{man menu|Only do this if you are sure no other copy of Gramps is using the selected Family Tree.}} Click the {{man button|Break lock}} button and the {{man label|Family Trees (Manager)}} window should show that the lock icon has gone.* Choose the previously locked family tree and then click the {{man button|Load Family Tree}} button to continue your work.
→Unlocking a Family Tree
== Unlocking a Family Tree ==
[[File:FamilyTreesManager-Dialog-ShowingLocked-Sample-50.png|thumb|right|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Family Trees (Manager) - Dialog - Showing Locked "Sample" Family Tree]]
Gramps is a single-user database application and identifies Tree database files as busy with a [[File:22x22-gramps-lock.png]]'lock' when in use. As Gramps opens a tree, it drops a <code>lock</code> file (which lists the username and domain) in the tree's subfolder in the <code>grampsdb</code> folder of the [[Gramps_5.1_Wiki_Manual_-_User_Directory|User Directory]]. Gramps refuses to let you (or anyone else) open that Tree at the same time. A second instance of Gramps will be able to open another family tree, but any tree that is already open will appear with the lock icon in the Status column of the Manage Family Trees dialog. Closing the tree in the first copy of Gramps deletes the lock file and will make the tree available to be opened in the second instance.
=== Break the lock on the "Family Tree name" database? dialog ===
[[File:ErrorParsingArguments-dialog-DatabaseIsLocked-example-50.png|thumb|right|346px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}}Error parsing arguments - dialog - Database is locked example]]
In the unlikely event that Gramps crashes, the family tree will be left in a locked state (indicated by a [[File:22x22-gramps-lock.png]]lock icon in the {{man label|Status}} column next to the Family Tree name)
{{-}}
{{-}}