create new tag
, view all tags

SID-02150: Upgrade Twiki 4.1.2 to 6.x

Status: Asked Asked TWiki version: 4.1.2 Perl version: Perl: v5.8.8
Category: CategoryInstallation Server OS: RHEL 5.11 (Tikanga), Kernel-2.6.18-406.e15 Last update: 1 year ago

New to TWiki. Seasoned UNIX SysAdmin

Our customer wants the server and Twiki updated. This includes RHEL7 and Twiki 6.x There is a LOT of data on there and, of course, the customer wants to retain it all.

A P2V has been made, including a snapshot, so I can wash, rinse, repeat, as needed.

Has anyone moved from such an ancient version of Twikie making the jump to 6? Any documentation out there?

Thank you in advance. /tg

-- Tim Grzechowski - 2016-02-04

Discussion and Answer

Upgrade is documented at TWikiUpgradeGuide. Best to download the latest TWiki VM, and migrate the data. Two options for data migration:

  1. Use BackupRestorePlugin:
    • Install this plugin on the old TWiki-4.1
    • Run backup (if you have a lot of data you might hit the limit of zip)
    • Copy zip file to new VM
    • Restore using plugin GUI

  1. Manual migration:
    • Create a tarball of everything below /var/www/twiki (or wherever TWiki is)
    • Move tarball to temp folder on the new VM
    • Unpack and fix file permissions to be owned by webserver user
    • Move everything from old twiki/data to the new location, except twiki/data/TWiki
    • Move everything from old twiki/pub to the new location, except twiki/pub/TWiki

After that you can do more cleanup on new VM:

  • Install, enable and configure missing plugins used in old TWiki (see TWiki.InstalledPlugins topic in old TWiki)
  • Copy all twiki/data/_default/Web*txt* topics in your TWiki TWiki to all restored webs' data directory (overwrite if needed), except WebHome.*, WebLeftBar.*, WebNotify.*, WebPreferences.*, WebStatistics.*
  • User profile pages have an old format. Either ignore or upgrade. Upgrade can be time consuming
  • A large customer likely uses LDAP for auth; install LdapContrib

-- Peter Thoeny - 2016-02-04

89GB of data. Ugh.

I do not have a twiki/data/_default directory on the old TWiki. Are these file stored elsewhere?


-- Tim Grzechowski - 2016-02-12

Copy from the twiki/data/_default in your new TWiki.

-- Peter Thoeny - 2016-02-13

Do all the "webs" directories under pub/ --including the sub-directories-- need the twiki/data/_default/ files copied to them, or just the root webs?


-- Tim Grzechowski - 2016-02-23

Copy to all webs.

For example if you have a Foo web and a Sub web underneath it, copy twiki/data/_default/WebSearch*txt* (etc) to twiki/data/Foo/ and twiki/data/Foo/Sub/, respectively.

-- Peter Thoeny - 2016-02-26

We have our new TWiki up and running. LDAP is authenticating and we can log in successfully.

However, our TWiki usernames are in the format of "BobSmith" but most users tpye their name as "bob.smith". The period between the first and last name is successfully removed, but TWiki is seeing the username as bobsmith (note: no period) which will not match to the TWiki username.

in our lib/LocalSite.cfg file, the parameter is set to:

$TWiki::cfg{Ldap}{CaseSensitiveGroup} = 0;

How can we make the typed in username match the TWiki username without requiring users to capitalize the first letter of the first/last name.

/tg NOAA.gov

-- Tim Grzechowski - 2016-04-01

If you have {UserMappingManager} set to TWiki::Users::LdapUserMapping you can set these LDAP settings to map from the cn attribute "Bob Smith" to WikiName BobSmith:

{Ldap}{WikiNameAttributes} = 'cn'

{Ldap}{NormalizeWikiNames} = 1

{Ldap}{NormalizeLoginNames} = 0

Alternatively, if you have {UserMappingManager} set to TWiki::Users::TWikiUserMapping you can use the Main.TWikiUsers topic to map from your login name to the WikiName. In this case you need to set {Register}{AllowLoginName} to 1.

-- Peter Thoeny - 2016-04-03

Hi Peter,

I am a co-worker of Tim's.

What you provided above is what we have set. The issue is that when the user is prompted for credentials, they are used to typing in bob.smith as their user name. With the old version of Twiki, their account topic was auto created as BobSmith. With the new version, their login name of bob.smith is mapping to bobsmith. I need bob.smith to auto map to BobSmith.

Does that make sense?

-- Robert Webb - 2016-04-12

How does the cn attribute for Bob Smith look like? If "Bob Smith" you should get "BobSmith".

In terms of creating user profile topics, look into the RequireRegistrationPlugin.

-- Peter Thoeny - 2016-04-13

cn does look like Bob.Smith

After some more digging, I set {LoginManager} to none and it works. If set to ApacheLogin or LdapApacheLogin, the wikiname does not match.

-- Robert Webb - 2016-04-14

Seems resolved? I am closing this question. Please reopen if needed.

-- Peter Thoeny - 2016-04-14


When copying over all the webs from the original source, does that include overwriting the Main web? When I updated, I did not overwrite _default or TWiki, but did overwrite everything else.

-- Robert Webb - 2016-04-29

      Change status to:
ALERT! If you answer a question - or someone answered one of your questions - please remember to edit the page and set the status to answered. The status selector is below the edit box.
Status Asked
Title Upgrade Twiki 4.1.2 to 6.x
SupportCategory CategoryInstallation
TWiki version 4.1.2
Server OS RHEL 5.11 (Tikanga), Kernel-2.6.18-406.e15
Web server Apache/2.2.3
Perl version Perl: v5.8.8
Browser & version

Edit | Attach | Watch | Print version | History: r13 < r12 < r11 < r10 < r9 | Backlinks | Raw View | Raw edit | More topic actions
Topic revision: r13 - 2016-04-29 - RobertWebb
  • Learn about TWiki  
  • Download TWiki
This site is powered by the TWiki collaboration platform Powered by Perl Hosted by OICcam.com Ideas, requests, problems regarding TWiki? Send feedback. Ask community in the support forum.
Copyright © 1999-2017 by the contributing authors. All material on this collaboration platform is the property of the contributing authors.