This page is to document migration and upgrade tips for people upgrading versions of Xandros.

It applies to folks upgrading between 1.x to 2.x, as well as from 2.x to 3.x.

It assumes that prior to the upgrade that the user's previous home directory was preserved as 'username_old', where 'username' is the respective user's home directory name. i.e. user 'bob' will find his new home directory containing his old home directory in 'bob_old'. Including all of the "hidden" files and directories that contain the settings for numerous programs.

All instructions assume your current directory is in the user's "old" home directory unless otherwise stated.

Important: If you are aware of some application settings being customized for a user, and you follow these instructions, and find that the customized settings were not preserved, then you will need to research the configuration files that were customized and restore them from the backup you made.

Important: This assumes you aren't using GNOME applications. If you are, and know what to add to this document, please do so.

1. Initialize the user account

You will need to initialize the user account under the new system.

• Login to the new system as the user.
• If you do not have access to the account, ask the person to login.
• Complete the user "First Time" setup wizard.
• Each user needs to verify (or setup if they are first) the default time zone and add printers.

• IMMEDIATELY logout.
• Do NOT run Mozilla or Open Office or Crossover or ...

2. Login as root on a console

• Press "Alt-F1" to switch to a console screen, and press Enter to get a login prompt.
• Login as root.
• Change directories to the given user (e.g. /home/bob/bob_old).
• Become the user in question using 'su - username' (e.g. 'su - bob')

2. Backup their old home directory

This will save you if you delete something you decide later on you shouldn't have.

• tar cvf - bob_old | gzip -9 >bob_old.tar.gz

3. Things that do not need to be upgraded

The following items do not need to be upgraded as they contain only temporary information from the last login under the old system. Unless you have specific information that something should be preserved, it's OK to delete them.

rm -rf .kde/socket-* .kde/tmp-* .gtkrc-kde .qt .ICEauthority .mcop .mcoprc
rm -rf .fonts.cache-1 .rscp .wmrc .Xauthority .xsession-errors .xsession
# Xandros-specific stuff
rm -rf .XandrosCDBuilderProjects # Only for beta testers or re-installing
rm -rf .XandrosFMHistory .XandrosFMCache

4. Preserve all personal documents

cd My\ Documents ; mv * .??* ../../My\ Documents; cd ..

5. Preserve all Desktop items

Answer 'N' to overwriting anything. In all likelihood, you want to use the new version of the icon.

cd Desktop ; mv -i * .??* ../../Desktop ; cd ..

6. Preserve Mozilla (email and browser settings)

mv .mozilla ..

7. Preserve Crossover Office, WINE, WineX

mv .cxoffice ..

If WineX is installed:

mv .winex ..

If WINE is installed:

mv .wine ..

If you do NOT want to preserve your Crossover installation, and will re-install all applications and their data<b>, you can delete this and start a new one. However, you probably /don't want to do this.