Recovering Settings from Old or Corrupt Preferences

From NeoWiki

(Difference between revisions)
Jump to: navigation, search
Revision as of 04:47, 9 May 2007 (edit)
Sardisson (Talk | contribs)
(Importing NeoOffice 2.0 Preferences to 2.1 Preferences - rename slightly)
← Previous diff
Current revision (23:02, 13 January 2010) (edit) (undo)
Lorinda (Talk | contribs)
(Manually importing NeoOffice 2.2.x Preferences into NeoOffice 3.0.x Preferences - add note about config file issues)
 
(19 intermediate revisions not shown.)
Line 1: Line 1:
-Corrupted preferences files can sometimes cause difficulties with NeoOffice. In these instances, the [[Troubleshooting Tips]] page recommends removing the NeoOffice 2.1 folder from <tt>~/Library/Preferences</tt>. This will solve the problem with corrupted preferences, but trashing the entire folder means that you will lose custom defined autotexts, templates, backups, key commands, menus, etc.+==Manually importing NeoOffice 2.2.x Preferences into NeoOffice 3.0.x Preferences==
 + 
 +Not all preferences are copied from NeoOffice 2.2.x to NeoOffice 3.0.1 when you upgrade. Use the following steps to copy NeoOffice 2.2.x preferences to NeoOffice 3.0.x after upgrading. Because NeoOffice's underlying OpenOffice.org code made incompatible changes to the user preference files between their OpenOffice.org 2.2.x and 3.0.x versions, it may not be possible to copy all preferences from NeoOffice 2.2.x to NeoOffice 3.0.x.
 + 
 +To manually "import" these preferences, do the following:
 + 
 +*Make a copy of the NeoOffice-3.0 folder found in <tt>~/Library/Preferences/</tt>
 +*Do the same with the NeoOffice-2.2 folder in the same location
 +*Move these copies to a safe place (they are your backups in case something goes wrong)
 +*Locate the folders in the (original) NeoOffice-2.2 folder that need to be transferred. See the paths listed in the '''Preferences Locations''' section on this page
 +*Copy the files inside these folders and put them inside the appropriate folders in the NeoOffice-3.0 folder (or replace the contents of the entire folder)
 +*You may want to move one folder at a time, and then start NeoOffice, making sure that things are working correctly before moving another set of preferences.
 + 
 +N.B. This procedure is experimental in nature. It is possible that doing this may, in some cases, create problems in the functioning of NeoOffice. This is why it is imperative to create a backup of the preferences folders before beginning to move things.
 +*One user has found that moving the entire config folder over will prevent NeoOffice from starting. They had success, though, moving only those items they needed. (In their case the toolbar files). See [https://trinity.neooffice.org/modules.php?name=Forums&file=viewtopic&p=58518#58518 this post] for more information.
 + 
 +==Recovering Preferences from a Corrupt preference folder==
 + 
 +Corrupted preferences files can sometimes cause difficulties with NeoOffice. In these instances, the [[Troubleshooting Tips]] page recommends removing the NeoOffice-2.2 and/or NeoOffice-3.0 folder from <tt>~/Library/Preferences</tt>. This will solve the problem with corrupted preferences, but trashing the entire folder means that you will lose custom defined autotexts, templates, backups, key commands, menus, etc.
In order to salvage these items, it is necessary to isolate the corrupted folder in the preferences file. You can do so following this method: In order to salvage these items, it is necessary to isolate the corrupted folder in the preferences file. You can do so following this method:
-# If you have not done so already, move your (corrupted) NeoOffice 2.1 folder from <tt>~/Library/Preferences</tt> to the Desktop.+# If you have not done so already, move your (corrupted) NeoOffice-x.x folder from <tt>~/Library/Preferences</tt> to the Desktop (where ''x.x'' represents the version of NeoOffice you are using).
-# Make a copy (in Finder File>Duplicate) of the NeoOffice 2.1 folder. Keep this is a safe place until the procedure is done. (This gives you a backup in case you make a mistake)+# Make a copy (in Finder, from the {{Menu|File}} menu, choose {{Menu|Duplicate}}) of the NeoOffice-x.x folder. Keep this is a safe place until the procedure is done. (This gives you a backup in case you make a mistake)
-#Select half of the folders in the users folder of the old preferences folder (The one on the desktop) and drag them into the new (uncorrupted) folder (<tt>~/Library/Preferences/NeoOffice 2.1/user</tt>). When it warns that this will replace folders of the same name, click {{button|ok}} +#Select half of the folders in the users folder of the old preferences folder (The one on the desktop) and drag them into the new (uncorrupted) folder (<tt>~/Library/Preferences/NeoOffice-x.x/user</tt>). When it warns that this will replace folders of the same name, click {{button|ok}}
# Restart NeoOffice and check to see if the bug you experienced reappears. Quit NeoOffice. If the problem did not reappear, the first half of the preferences are ok; add the second half of the old preferences back into the current preferences folder, restart NeoOffice, and see if the bug reappears. # Restart NeoOffice and check to see if the bug you experienced reappears. Quit NeoOffice. If the problem did not reappear, the first half of the preferences are ok; add the second half of the old preferences back into the current preferences folder, restart NeoOffice, and see if the bug reappears.
# Once you know which half of the preferences contains the corruption, pull that half (the one with a corruption somewhere) back onto the desktop. Quit NeoOffice. # Once you know which half of the preferences contains the corruption, pull that half (the one with a corruption somewhere) back onto the desktop. Quit NeoOffice.
-# Put one folder of this corrupted half from the desktop into the current preferences file (<tt>~/Library/Preferences/NeoOffice 2.1/user</tt>), restart NeoOffice, and check for the bug. (Be sure to quit NeoOffice between checks)+# Put one folder of this corrupted half from the desktop into the current preferences file (<tt>~/Library/Preferences/NeoOffice-x.x/user</tt>), restart NeoOffice, and check for the bug. (Be sure to quit NeoOffice between checks)
# Repeat this until you find the offending folder # Repeat this until you find the offending folder
#If there doesn't appear to be anything vital to your work in the corrupted folder, you can drag it to the trash. #If there doesn't appear to be anything vital to your work in the corrupted folder, you can drag it to the trash.
#If it is a critical folder (like templates) Continue this process with the files in the folder. #If it is a critical folder (like templates) Continue this process with the files in the folder.
 +
 +Note that if you have set a particular template as a default template, you will have to re-set that template as the default in NeoOffice after you have finished the recovery process.
If you know that there are only a few folders that contain work you don't want to lose (e.g. autotext, templates or backup), you can try just dragging those back in one at a time and see if they create problems, rather than starting with the "half and half" method. If you know that there are only a few folders that contain work you don't want to lose (e.g. autotext, templates or backup), you can try just dragging those back in one at a time and see if they create problems, rather than starting with the "half and half" method.
Line 17: Line 37:
==Preferences Locations== ==Preferences Locations==
-Here are the locations for the preferences data users are most likely to need to save:+Here are the locations for the preferences data users are most likely to need to save. Note: replace NeoOffice-2.2 with NeoOffice-3.0 if using NeoOffice 3.0.x:
-* autotexts in <tt>~/Library/Preferences/NeoOffice 2.1/user/autotext</tt>+* autocorrection in <tt>~/Library/Preferences/NeoOffice-2.2/user/autocorrect</tt>
-* galleries in <tt>~/Library/Preferences/NeoOffice 2.1/user/gallery</tt>+* autotexts in <tt>~/Library/Preferences/NeoOffice-2.2/user/autotext</tt>
-* templates in <tt>~/Library/Preferences/NeoOffice 2.1/user/template</tt>+* backups in <tt>~/Library/Preferences/NeoOffice-2.2/user/backup</tt>
-* backups in <tt>~/Library/Preferences/NeoOffice 2.1/user/backup</tt>+* color palettes in <tt>~/Library/Preferences/NeoOffice-2.2/user/config</tt>
-* autocorrection in <tt>~/Library/Preferences/NeoOffice 2.1/user/autocorrect</tt>+* databases in <tt>~/Library/Preferences/NeoOffice-2.2/user/database</tt>
-* macros in <tt>~/Library/Preferences/NeoOffice 2.1/user/basic/Standard</tt>+* font replacement tables in <tt>~/Library/Preferences/NeoOffice-2.2/user/registry/data/org/openoffice/Office/Common.xcu</tt>
-* databases in <tt>~/Library/Preferences/NeoOffice 2.1/user/database</tt>+* galleries in <tt>~/Library/Preferences/NeoOffice-2.2/user/gallery</tt>
-* writer keyboard shortcuts in <tt>~/Library/Preferences/NeoOffice 2.1/user/config/soffice.cfg/modules/swriter/accelerator/en-US/current.xml</tt>+*keyboard shortcuts for Writer in <tt>~/Library/Preferences/NeoOffice-2.2/user/config/soffice.cfg/modules/swriter/accelerator/en-US/current.xml</tt>
 +**keyboard shortcuts for other modules can be found by boring down through similarly named folders, starting from <tt>~/Library/Preferences/NeoOffice-2.2/user/config/soffice.cfg/modules/</tt>
**If you use a language other than US English, replace <tt>/en-US/ </tt> with the folder name corresponding to your language. **If you use a language other than US English, replace <tt>/en-US/ </tt> with the folder name corresponding to your language.
-**keyboard shortcuts for other modules can be found by boring down through similarly named folders, starting from <tt>~/Library/Preferences/NeoOffice 2.1/user/config/soffice.cfg/modules/</tt>+* labels in <tt>~/Library/Preferences/NeoOffice-2.2/user/registry/data/org/openoffice/office/labels.xcu</tt>
 +* macros in <tt>~/Library/Preferences/NeoOffice-2.2/user/basic/Standard</tt>
 +* templates in <tt>~/Library/Preferences/NeoOffice-2.2/user/template</tt>
 +* toolbars for
 +**Writer: <tt>~/Library/Preferences/NeoOffice-2.2/user/config/soffice.cfg/modules/swriter/toolbar/</tt>
 +**Calc: <tt>~Library/Preferences/NeoOffice 2.2/User/Config/Soffice.cfg/Modules/scalc/toolbar</tt>
 +**Impress: <tt>~Library/Preferences/NeoOffice 2.2/User/Config/Soffice.cfg/Modules/simpress/toolbar</tt>
 +**toolbars for other modules can be found by boring down through similarly named folders, starting from <tt>~/Library/Preferences/NeoOffice-2.2/user/config/soffice.cfg/modules/</tt>, choosing a folder named for a module (<tt>sdraw</tt>, for example) and then opening the toolbar folder in the appropriate module folder.
 +* Additional items and locations are listed in [http://trinity.neooffice.org/modules.php?name=Forums&file=viewtopic&p=52192#52192 this post on trinity]
-It may be possible to copy some Installed extensions by copying over the <tt>~/Library/Preferences/NeoOffice-2.1/user/uno_packages/</tt> folder, but in many cases you are better off re-installing the extension using the Extension Manager within NeoOffice. (The Extension Manager can be accessed from the {{menu|Tools}} menu.)+It may be possible to copy some installed extensions by copying over the <tt>~/Library/Preferences/NeoOffice-2.2/user/uno_packages/</tt> folder, but in most cases you are better off re-installing the extension using the Extension Manager within NeoOffice. (The Extension Manager can be accessed from the {{menu|Tools}} menu.)
Remember that ~ refers to your home folder. Remember that ~ refers to your home folder.
Line 36: Line 65:
If you have added some paths or changed them, you can find the appropriate locations by choosing the {{menu|NeoOffice}} menu then the {{menu|Preferences}} sub-menu, the {{section|NeoOffice}} section and at last the {{prefName|Paths}} item. If you have added some paths or changed them, you can find the appropriate locations by choosing the {{menu|NeoOffice}} menu then the {{menu|Preferences}} sub-menu, the {{section|NeoOffice}} section and at last the {{prefName|Paths}} item.
-==Manually importing NeoOffice 2.0 Preferences into NeoOffice 2.1 Preferences==+==Creating a backup set of preferences==
-Sometimes when users upgrade from NeoOffice 2.0 to NeoOffice 2.1, certain preferences (including autotexts, templates, etc.) don't transfer over. This is apparently due to bugs in the underlying OpenOffice.org code. To manually "import" these preferences, do the following:+
- +
-*Make a copy of the NeoOffice 2.1 folder found in <tt>~/Library/Preferences/</tt>+
-*Do the same with the NeoOffice 2.x folder in the same location+
-*Move these copies to a safe place (they are your backups in case something goes wrong)+
-*Locate the folders in the (original) NeoOffice 2.x folder that need to be transferred. See the paths listed above; just replace NeoOffice 2.1 with NeoOffice 2.x in the path names+
-*Copy the files inside these folders and put them inside the appropriate folders in the NeoOffice 2.1 folder (or replace the entire folder)+
-*You may want to move one folder at a time, and then start NeoOffice, making sure that things are working correctly before moving another set of preferences.+
- +
-N.B. This procedure is experimental in nature. It is possible that doing this may, in some cases, create problems in the functioning of NeoOffice. This is why it is imperative to create a backup of the preferences folders before beginning to move things.+
 +Once you have a working set of preferences, complete with all of your customizations, autotexts, etc., you might want to make a backup copy of the known-good set in case of future corruption. Simply navigate to <tt>~/Library/Preferences/</tt> in the Finder and {{key|ctrl-click}} the '''NeoOffice-2.2''' or the '''NeoOffice-3.0''' folder. Choose {{menu|Create Archive of “NeoOffice-x.x”}} from the Finder context menu. You now have a convenient <tt>.zip</tt> archive of all your preferences, so you can easily return to a known-good state in case of problems at any point in the future.
-{{botlangbarEN|[[Fr:Récupérer les Configurations Personnelles dans un Dossier de Préférences Endommagé|Français]] [[Es:C%c3%b3mo_conservar_y_recuperar_preferencias|Español]]}}+{{botlangbarEN|[[Fr:Récupérer les configurations personnelles dans un dossier de préférences précédent ou endommagé|Français]] [[It:Recuperare_le_impostazioni_quando_le_prefernze_sono_danneggiate|Italiano]] [[Es:C%c3%b3mo_conservar_y_recuperar_preferencias|Español]]}}
[[Category:NeoOffice]][[Category:Tips and Hints]] [[Category:NeoOffice]][[Category:Tips and Hints]]
 +__NOTOC__

Current revision

Manually importing NeoOffice 2.2.x Preferences into NeoOffice 3.0.x Preferences

Not all preferences are copied from NeoOffice 2.2.x to NeoOffice 3.0.1 when you upgrade. Use the following steps to copy NeoOffice 2.2.x preferences to NeoOffice 3.0.x after upgrading. Because NeoOffice's underlying OpenOffice.org code made incompatible changes to the user preference files between their OpenOffice.org 2.2.x and 3.0.x versions, it may not be possible to copy all preferences from NeoOffice 2.2.x to NeoOffice 3.0.x.

To manually "import" these preferences, do the following:

  • Make a copy of the NeoOffice-3.0 folder found in ~/Library/Preferences/
  • Do the same with the NeoOffice-2.2 folder in the same location
  • Move these copies to a safe place (they are your backups in case something goes wrong)
  • Locate the folders in the (original) NeoOffice-2.2 folder that need to be transferred. See the paths listed in the Preferences Locations section on this page
  • Copy the files inside these folders and put them inside the appropriate folders in the NeoOffice-3.0 folder (or replace the contents of the entire folder)
  • You may want to move one folder at a time, and then start NeoOffice, making sure that things are working correctly before moving another set of preferences.

N.B. This procedure is experimental in nature. It is possible that doing this may, in some cases, create problems in the functioning of NeoOffice. This is why it is imperative to create a backup of the preferences folders before beginning to move things.

  • One user has found that moving the entire config folder over will prevent NeoOffice from starting. They had success, though, moving only those items they needed. (In their case the toolbar files). See this post for more information.

Recovering Preferences from a Corrupt preference folder

Corrupted preferences files can sometimes cause difficulties with NeoOffice. In these instances, the Troubleshooting Tips page recommends removing the NeoOffice-2.2 and/or NeoOffice-3.0 folder from ~/Library/Preferences. This will solve the problem with corrupted preferences, but trashing the entire folder means that you will lose custom defined autotexts, templates, backups, key commands, menus, etc.

In order to salvage these items, it is necessary to isolate the corrupted folder in the preferences file. You can do so following this method:

  1. If you have not done so already, move your (corrupted) NeoOffice-x.x folder from ~/Library/Preferences to the Desktop (where x.x represents the version of NeoOffice you are using).
  2. Make a copy (in Finder, from the File menu, choose Duplicate) of the NeoOffice-x.x folder. Keep this is a safe place until the procedure is done. (This gives you a backup in case you make a mistake)
  3. Select half of the folders in the users folder of the old preferences folder (The one on the desktop) and drag them into the new (uncorrupted) folder (~/Library/Preferences/NeoOffice-x.x/user). When it warns that this will replace folders of the same name, click ok
  4. Restart NeoOffice and check to see if the bug you experienced reappears. Quit NeoOffice. If the problem did not reappear, the first half of the preferences are ok; add the second half of the old preferences back into the current preferences folder, restart NeoOffice, and see if the bug reappears.
  5. Once you know which half of the preferences contains the corruption, pull that half (the one with a corruption somewhere) back onto the desktop. Quit NeoOffice.
  6. Put one folder of this corrupted half from the desktop into the current preferences file (~/Library/Preferences/NeoOffice-x.x/user), restart NeoOffice, and check for the bug. (Be sure to quit NeoOffice between checks)
  7. Repeat this until you find the offending folder
  8. If there doesn't appear to be anything vital to your work in the corrupted folder, you can drag it to the trash.
  9. If it is a critical folder (like templates) Continue this process with the files in the folder.

Note that if you have set a particular template as a default template, you will have to re-set that template as the default in NeoOffice after you have finished the recovery process.

If you know that there are only a few folders that contain work you don't want to lose (e.g. autotext, templates or backup), you can try just dragging those back in one at a time and see if they create problems, rather than starting with the "half and half" method.

Preferences Locations

Here are the locations for the preferences data users are most likely to need to save. Note: replace NeoOffice-2.2 with NeoOffice-3.0 if using NeoOffice 3.0.x:

  • autocorrection in ~/Library/Preferences/NeoOffice-2.2/user/autocorrect
  • autotexts in ~/Library/Preferences/NeoOffice-2.2/user/autotext
  • backups in ~/Library/Preferences/NeoOffice-2.2/user/backup
  • color palettes in ~/Library/Preferences/NeoOffice-2.2/user/config
  • databases in ~/Library/Preferences/NeoOffice-2.2/user/database
  • font replacement tables in ~/Library/Preferences/NeoOffice-2.2/user/registry/data/org/openoffice/Office/Common.xcu
  • galleries in ~/Library/Preferences/NeoOffice-2.2/user/gallery
  • keyboard shortcuts for Writer in ~/Library/Preferences/NeoOffice-2.2/user/config/soffice.cfg/modules/swriter/accelerator/en-US/current.xml
    • keyboard shortcuts for other modules can be found by boring down through similarly named folders, starting from ~/Library/Preferences/NeoOffice-2.2/user/config/soffice.cfg/modules/
    • If you use a language other than US English, replace /en-US/ with the folder name corresponding to your language.
  • labels in ~/Library/Preferences/NeoOffice-2.2/user/registry/data/org/openoffice/office/labels.xcu
  • macros in ~/Library/Preferences/NeoOffice-2.2/user/basic/Standard
  • templates in ~/Library/Preferences/NeoOffice-2.2/user/template
  • toolbars for
    • Writer: ~/Library/Preferences/NeoOffice-2.2/user/config/soffice.cfg/modules/swriter/toolbar/
    • Calc: ~Library/Preferences/NeoOffice 2.2/User/Config/Soffice.cfg/Modules/scalc/toolbar
    • Impress: ~Library/Preferences/NeoOffice 2.2/User/Config/Soffice.cfg/Modules/simpress/toolbar
    • toolbars for other modules can be found by boring down through similarly named folders, starting from ~/Library/Preferences/NeoOffice-2.2/user/config/soffice.cfg/modules/, choosing a folder named for a module (sdraw, for example) and then opening the toolbar folder in the appropriate module folder.
  • Additional items and locations are listed in this post on trinity

It may be possible to copy some installed extensions by copying over the ~/Library/Preferences/NeoOffice-2.2/user/uno_packages/ folder, but in most cases you are better off re-installing the extension using the Extension Manager within NeoOffice. (The Extension Manager can be accessed from the Tools menu.)

Remember that ~ refers to your home folder.

If you have added some paths or changed them, you can find the appropriate locations by choosing the NeoOffice menu then the Preferences sub-menu, the NeoOffice section and at last the Paths item.

Creating a backup set of preferences

Once you have a working set of preferences, complete with all of your customizations, autotexts, etc., you might want to make a backup copy of the known-good set in case of future corruption. Simply navigate to ~/Library/Preferences/ in the Finder and ctrl-click the NeoOffice-2.2 or the NeoOffice-3.0 folder. Choose Create Archive of “NeoOffice-x.x” from the Finder context menu. You now have a convenient .zip archive of all your preferences, so you can easily return to a known-good state in case of problems at any point in the future.


This article in other languages: Français Italiano
Personal tools