Question

What all do I need to do to rename the "Main" web to something else such as "User"?

Environment

-- LynnwoodBrown - 01 Nov 2007

Answer

This is a common request for new installations and is even mentioned in TWikiAdminCookBook. However, the instructions there are out of date and the distributed documentation (such as in ManagingWebs) only says why this is not advised but doesn't tell how to do it properly. This topic is intended to describe the steps to follow and deal with any problems that show up. I'll describe the process I've used but please feel free to correct my mistakes or add anything I've missed.

-- LynnwoodBrown - 01 Nov 2007

Steps to renaming the Main web:

1. Open configure and Main.WebPreferences as you'll need to change settings in both places as close to same time as possible.
2. Rename Main web:
   1. Click on Rename/move/delete web..., at bottom of Main.WebPreferences
   2. Go through the list of references to be modified and de-select the ones that should not be changed.
      • I have found it easiest to deselect all references and then turn back on the ones I know need to change.
      • In general, almost all the references in TWiki web should not be changed as these are referencing the Main web of twiki.org (using the InterWikis format of TWiki:Main.).
      • Most other references should be changed but it's best to look at each one to make sure.
      • Obviously, this is easiest done with a new installation that has very few references to the Main web.
   3. Click the "rename" button.
3. Change references to the Main web in configure interface:
   1. Open configure .
   2. Change {UsersWebName} (under "Store settings" tab).
   3. Change the web reference in {LocalSitePreferences} (under "Miscellaneous settings" tab).

-- LynnwoodBrown - 01 Nov 2007

Thanks Lynnwood! How about updating the docs?

-- PeterThoeny - 02 Nov 2007