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 manually 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. 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 or changed.

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.

Before You Begin

As a just-in case measure for any situation, make a backup of your settings. You must be logged into each avatar in order to back up that account's settings.

If you save chat transcripts, they are by default saved in your per-account settings folder (named for your avatar). Before you delete that folder (below), you will need to identify the chat files and move them. See here for steps to relocate your chat transcripts.

Next, go to the steps relevant to your operating system: Windows, Mac or Linux

Windows

Remove Application

Ideally, use the Programs & Features Control Panel [Vista, Win7, Win8], or Add/Remove Programs Control Panel [XP] to remove Firestorm. Alternatively, you can also delete the entire installation folder. For the 32-bit version of Firestorm, this is typically located at:

  • C:\Program Files\Firestorm on 32-bit Windows, or
  • C:\Program Files (x86)\Firestorm on 64-bit Windows.

For the 64-bit version of Firestorm, this will be C:\Program Files\Firestorm (on 64-bit Windows, as 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

REMINDER: If you want to save chat transcripts, make sure you do so before deleting your settings folders.

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:
    (Fast way: Click Start or press the Windows key, then type %appdata%, and then press Enter.)
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
Delete Cache
  • Now you need to locate the cache folder:
    (Fast way: Click Start or press the Windows key, then type %localappdata%, and then press Enter.)
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
Firestorm 64-bit
Windows Vista, 7 and 8C:\Users\[USERNAME]\AppData\Local\FirestormOS_x64
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 installing/reinstalling.

Now skip down to Install/Reinstall below.

Mac

Remove Application

Navigate to Applications and trash the Firestorm App.

Delete Settings

REMINDER: If you want to save chat transcripts, make sure you do so before deleting your settings folders.

  • If you're using OSX 10.7 Lion or later, you will need to show hidden folders to find the Library.
  • Go to User/Library/Application Support and delete the Firestorm and FirestormOS folder.
    ( 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/ (including the tilde~) )
Delete Cache
  • Go to User/Library/Caches, and again delete the Firestorm and FirestormOS folder.
    ( 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/ (including the tilde~) )
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 installing/reinstalling.

Now skip down to Install/Reinstall below.

Linux

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.

If you used the install script as root, look in your /opt directory. You will need to su root or sudo rm to delete the firestorm directory there.

Delete Settings

REMINDER: If you want to save chat transcripts, make sure you do so before deleting your settings folders.

  • Use your preferred file manager and delete the directory ~/.firestorm (Firestorm 32-bit) or ~/.firestorm_x64 (Firestorm 64-bit)
    If you can't see this folder, you will need to show hidden folders.
Delete Custom 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.

If you have created a cache for Firestorm outside of the default Firestorm directory, then delete everything inside it now, and remember to reset that location after installing/reinstalling.

If you make use of the FIRESTORM_USER_DIR environment variable, delete the settings and cache directories in that location.

Continue reading below.

Install/Reinstall

Having done all those steps, you may now install or reinstall Firestorm. Installing Firestorm is done in pretty much the same way as any other application on your computer.

  • Get the installer: For the current release, go to the Downloads page.
    For any previous supported version, fo to the Older Downloads page.
  • Windows: Run the installer. The 32-bit installer will offer you the chance to change the destination directory; the 64-bit installer shows the destination when you click the Options button.
    The installer will create a shortcut icon on the desktop.
  • Mac: Drag the downloaded dmg file to your Applications directory and launch it from there. You can optionally install using normal dmg installation procedures, such as are found here
  • Linux: Extract the tar.bz2 into any directory and run the firestorm script inside that directory to launch it. You can optionally install by running the install script inside that directory. And you can optionally create a desktop launcher. Refer to the README files for more information.
    If installing the 32-bit version of Firestom on a 64-bit version of linux, refer to this page for guidance on required compatibility libraries.
    Some Ubuntu users may need to modify how Nautilus handles scripts.

Once you have the viewer installed or reinstalled, 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 instead.
  • 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 and back in.
  • At this point, if the viewer is performing as it should, you can restore your settings and again relog. You must restore settings for every avatar you log in using this computer.
  • If you opted to keep chat transcripts, you may copy or move them back at this point, or keep them in their new location and define that location to permanently store your transcripts. See here.
  • Log back in to SL once again and confirm that the viewer is still performing as it should, then you can adjust any new or changed settings and then back those up.
fs_clean_reinstall.txt · Last modified: 2014/12/17 09:45 by ansariel.hiller