Thursday, August 09, 2007 by Niels Hartvig

Douglas Robar have created some excellent and detailed "umbraco books" on how to install umbraco 3 on Vista and umbraco 2.1 on XP. Douglass is by the way the creator of both ImageGen and XSLT Search, two fantastic add-ons to umbraco and he's even available for hire!

If you need to install v3 on XP, you can combine information from the two books. Kasper Ulvedal is working on a book on installing v3 on XP, but that's work-in-progress and not completed yet (we need a way to mark a book "in-progress" to ensure that people don't get confused about empty or semi-empty books).

If you need to upgrade v2.x or a pre-release version of v3 this is the process:

  1. BACKUP files + db(seriosuly)
  2. If you've installed any packages that has own create dialogs (like the RSS module), make sure to keep a copy of /umbraco/config/ui.xml nearby
  3. Unzip the downloaded release file v3xxx.zip
  4. Copy /bin, /config, /install, /python, /scripts /umbraco and /umbraco_client from the zip into your v2/rc1 installation (yes, to overwrite)
  5. Update web.config and the new /config/*.config with the settings from your old /config/*.xml files if you've changed those (Make sure that you base the web.config on the new one and just copy your changes. The new one includes lots of important references!)
  6. Copy the ui.xml back in place if you had that changed
  7. Go to your website and the upgrade process should begin automatically

3 comment(s) for “Documentation on installing or upgrading umbraco”

  1. danni Says:

    the docs is very useful but somehow i need a printable version of them -- or even better, the pdf file, for offline reading.

  2. Hartvig Says:

    Casey actually made this during CodeGarden 07. I've added a print link now using Casey's excellent work :-)

    /n

  3. Glenn De Backer Says:

    You also forget the part to copy site.py to the root folder. Otherwise the python support will not work !

Leave comment:

Comments are disabled for older posts