User Tools

Site Tools


fs_clean_reinstall
Advertisement

Doing a Clean Reinstall

A Clean Reinstall implies more than just removing the installed viewer and then reinstalling it. Doing that leaves behind all the data files and therefore rarely fixes anything. A Clean Reinstall, therefore, also includes locating and deleting all your settings and cache files.

There are times when you may wish to do a clean reinstall of Firestorm - or a support team member might request it, as part of a trouble shooting procedure.

Updating from an Earlier Version of Firestorm

When updating from an older version of Firestorm, you should always do a clean reinstall as described below. However, you can make use of the backup/restore feature to create a backup copy of your settings, before wiping them all.

Then after having logging in for the first time with the new version, you can restore your old settings, and then just tweak any that have been added.

As Part of Problem Solving

There are times when you may wish to do a clean reinstall as an attempt to solve an issue you are having. In such cases, it is suggested that you backup your settings first, then do the full clean reinstall as described below.

Before restoring settings, however, you should see whether you issue reproduces on all default settings. If it does not, then very likely it was a “bad” setting that caused the problem, so it is best not to restore old settings, but to set them manually.

Windows

Uninstall Any/All Copies of Firestorm

Remove Application

Ideally, use the Programs & Features Control Panel [Vista, Win7, Win8], or Add/Remove Programs Control Panel [XP] to remove Firestorm, or simply delete the entire installation folder. For 32-bit Firestorm, this is typically located at: C:\Program Files\Firestorm for 32-bit or C:\Program Files(X86)\Firestorm for 64-bit Windows systems. For 64-bit Firestorm, this will be C:\Program Files\Firestorm on 64-bit Windows (it cannot run on 32-bit Windows). You will be left with the folder in the Start menu, however, which is why it is preferable to uninstall as previously described.

Delete Settings

Firestorm settings can become corrupt, particularly if you recently crashed; the files may not save completely, so important information can become “scrambled”. For this reason, wiping your settings, while “painful”, may be necessary. Here is how:

  • Use the file manager (Windows Explorer) to locate the settings folder. In its default location, the folder is hidden on most OSs. To find it, you will need to show hidden folders. Now you need to locate the settings folder:
Firestorm 32-bit
Windows XPC:\Documents and Settings\[USERNAME]\Application Data\Firestorm
Windows Vista, 7, or 8C:\Users\[USERNAME]\AppData\Roaming\Firestorm
Firestorm 64-bit
Windows XPC:\Documents and Settings\[USERNAME]\Application Data\Firestorm_x64
Windows Vista, 7, or 8C:\Users\[USERNAME]\AppData\Roaming\Firestorm_x64

NOTE: If you wish to preserve your chat logs and/or contact sets or teleport history, then you will need to make a backup copy of them before deleting the contents of the folder just named.
The folder contains one or more folders in turn, each one named after your SL user name(s). Inside each of these folders, locate the chat log files. These will have the names of your groups and the people with whom you have had conversations. The contact sets file is named settings_friends_groups.xml. Teleport history is named teleport_history.txt.Select the chat log files, and the contact sets file (settings_friends_groups.xml), if you wish, and copy them to a location you can easily locate later, like a temporary folder on your deskstop. After this, you can erase the entire contents of the Firestorm folder.
Then proceed as described below, install (or reinstall) the viewer, and run it once to have it recreate the default files. Once you have logged out again, you can copy the chat logs and contact sets file back where they were.

Delete Cache

Firestorm 32-bit
Windows XPSL: C:\Documents and Settings\[USERNAME]\Local Settings\Application Data\Firestorm
OpenSim: C:\Documents and Settings\[USERNAME]\Local Settings\Application Data\FirestormOS
Windows Vista, 7 and 8SL: C:\Users\[USERNAME]\AppData\Local\Firestorm
OpenSIM: C:\Users\[USERNAME]\AppData\Local\FirestormOS
Mac~/Library/Caches/Firestorm 1)
linux~/.firestorm/cache
Firestorm 64-bit
Windows Vista, 7 and 8C:\Users\[USERNAME]\AppData\Local\FirestormOS_x64
linux~/.firestorm_x64/cache

Clear Custom Cache

If you have created a cache for Firestorm outside of the Firestorm folder, then delete everything inside it now, and remember to reset that location after next login.

  • To preserve things like saved chat logs, rename the Firestorm folder - for example, append the current date to the name, such as: Firestorm-12Jan2014

If you do not need to save chat logs, then simply delete the entire folder named Firestorm and everything inside it.

Now skip down to Reinstall below.

\\


Mac

Uninstall Any/All Copies of Firestorm

Remove Application

Navigate to Applications and trash the Firestorm App.

Delete Settings

  • If you're using OSX 10.7 Lion or 10.8 Mountain Lion, you will need to show hidden folders to find the Library.
  • Go to User/Library/Application Support and delete the Firestorm folder. 2)

NOTE: If you wish to preserve your chat logs and/or contact sets, then you will need to make a backup copy of them before deleting the contents of the folder just named.
The folder contains one or more folders in turn, each one named after your SL user name(s). Inside each of these folders, locate the chat log files. These will have the names of your groups and the people with whom you have had conversations. The contact sets file is named settings_friends_groups.xml. Select the chat log files, and the contact sets file (settings_friends_groups.xml), if you wish, and copy them to a location you can easily locate later, like a temporary folder on your deskstop. After this, you can erase the entire contents of the Firestorm folder.
Then proceed as described below, install (or reinstall) the viewer, and run it once to have it recreate the default files. Once you have logged out again, you can copy the chat logs and contact sets file back where they were.

Delete Cache

  • Go to User/Library/Caches, and again delete the Firestorm folder. 3)

Clear Custom Cache

If you have created a cache for Firestorm outside of the Firestorm folder, then delete everything inside it now, and remember to reset that location after next login.

  • To preserve things like saved chat logs, rename the Firestorm folder - for example, append the current date to the name, such as: Firestorm-12Jan2011

If you do not need to save chat logs, then simply delete the entire folder named Firestorm and everything inside it.

Now skip down to Reinstall below.

linux

Uninstall Any/All Copies of Firestorm

Remove Application

The Firestorm install directory will be wherever you extracted the download archive to. Typically this will be in your home directory somewhere, such as ~/Apps/Firestorm/. Delete this directory and everything inside it.

Delete Settings

  • Delete the directory ~/.firestorm (Firestorm 32-bit) or ~/.firesotmr_x64 (Firestorm 64-bit)
    If you can't see this folder, you will need to show hidden folders.

NOTE: If you wish to preserve your chat logs and/or contact sets or teleport history, then you will need to make a backup copy of them before deleting the contents of the folder just named.
The folder contains one or more folders in turn, each one named after your SL user name(s). Inside each of these folders, locate the chat log files. These will have the names of your groups and the people with whom you have had conversations. The contact sets file is named settings_friends_groups.xml. Select the chat log files, and the contact sets file (settings_friends_groups.xml), if you wish, and copy them to a location you can easily locate later, like a temporary folder on your deskstop. After this, you can erase the entire contents of the Firestorm folder.
Then proceed as described below, install (or reinstall) the viewer, and run it once to have it recreate the default files. Once you have logged out again, you can copy the chat logs and contact sets file back where they were.

Delete Cache

The cache directory is typically located inside ~/.firestorm, so if you have not changed its location, it will have been deleted with the step above.

Clear Custom Cache

If you have created a cache for Firestorm outside of the Firestorm folder, then delete everything inside it now, and remember to reset that location after next login.

  • To preserve things like saved chat logs, rename the Firestorm folder - for example, append the current date to the name, such as: Firestorm-12Jan2011
  • If you do not need to save chat logs, then simply delete the entire folder named Firestorm and everything inside it.

Continue reading Reinstall below.

Reinstall

Having done all those steps, you may now reinstall Firestorm. Once you have, you will need to repopulate your inventory:

  • Log back into SL, to a quiet region (try Hippo Hollow, Aich or Hatton). On your inventory window, click “Recent”.
  • Wait for your inventory to repopulate fully. The process may be sped up, if needed, by typing random letters into the search bar.
  • While inventory repopulates, do not teleport anywhere, and do not attempt to access anything in your inventory. Talk to people or surf the web.
  • Watch as it repopulates. As long as you can see (Fetched…) at the top of the inventory window, it is still loading.
  • Once inventory has repopulated, log out of SL once more.
  • If you opted to keep chat logs, you may copy them over at this point. Look in the old dated Firestorm folder you renamed in the “Delete Settings” section above; you will see one or more folders with your avatar name(s). Inside each of these you will find your chat logs - unless you changed the default location, in which case they will be wherever you saved them. Copy over only the logs; do not copy any XML files, with the optional exception of your contact sets file (settings_friends_groups.xml). (If your OS does not show file extensions like XML, copy only files that have avatar names or SecondLife group names, as well as the one called “settings_friends_groups”; the rest are old settings files and can be discarded.) Once you have done that, you may delete the old folder.
  • Log back in into SL.
1) Fast way: Switch to Finder (desktop), hit Cmd-N to open a new finder window, then Cmd-Shift-G for Go to folder. Copy/paste this ~/Library/Caches/Firestorm/ (including the tilde~)
2) Fast way: Switch to Finder (desktop), hit Cmd-N to open a new finder window, then Cmd-Shift-G for Go to folder.
Copy/paste this ~/Library/Application Support/Firestorm/ (including the tilde~)
3) Fast way:
Switch to Finder (desktop), hit Cmd-N to open a new finder window, then Cmd-Shift-G for Go to folder.
Copy/paste this ~/Library/Caches/Firestorm/ (including the tilde~)
fs_clean_reinstall.txt · Last modified: 2014/04/13 09:01 by sunset_faulkes