SID-02150: Upgrade Twiki 4.1.2 to 6.x
Status: |
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: |
7 years 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:
- 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
- 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?
/tg
--
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?
/tg
--
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
Peter,
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
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.