Forum conversion » History » Revision 36
Revision 35 (Amber Herold, 07/12/2010 11:52 AM) → Revision 36/41 (Amber Herold, 07/15/2010 11:48 AM)
h1. Forum conversion
Notes on porting the Leginon BB to Redmine
# Add Forums
## create new colum for bb forum id
## insert the bb forums
# Add column to redmine message db for bb post id
# Import all posts to current forums (map forum id's), saving bb post id to new column
# enter messages parent ids
# edit posts to put into new forum
# delete unwanted forums
h2. Redmine DB Tables
+Messages+
id board_id parent_id subject content author_id replies_count last_reply_id created_on updated_on locked sticky
+Boards+
id project_id name description position topics_count messages_count last_message_id
+Users+
id login hashed_password firstname lastname mail mail_notification admin status last_login_on language auth_source_id created_on updated_on type identity_url
h2. BB DB Tables
+Notre_forums+
forum_id parent_id left_id right_id forum_parents forum_name forum_desc forum_desc_bitfield forum_desc_options forum_desc_uid forum_link forum_password forum_style forum_image forum_rules forum_rules_link forum_rules_bitfield forum_rules_options forum_rules_uid forum_topics_per_page forum_type forum_status forum_posts forum_topics forum_topics_real forum_last_post_id forum_last_poster_id forum_last_post_subject forum_last_post_time forum_last_poster_name forum_last_poster_colour forum_flags display_subforum_list display_on_index enable_indexing enable_icons enable_prune prune_next prune_days prune_viewed prune_freq
+Notre_posts+
post_id topic_id forum_id poster_id icon_id poster_ip post_time post_approved post_reported enable_bbcode enable_smilies enable_magic_url enable_sig post_username post_subject post_text post_checksum post_attachment bbcode_bitfield bbcode_uid post_postcount post_edit_time post_edit_reason post_edit_user post_edit_count post_edit_locked
+Notre_topics+
topic_id forum_id icon_id topic_attachment topic_approved topic_reported topic_title topic_poster topic_time topic_time_limit topic_views topic_replies topic_replies_real topic_status topic_type topic_first_post_id topic_first_poster_name topic_first_poster_colour topic_last_post_id topic_last_poster_id topic_last_poster_name topic_last_poster_colour topic_last_post_subject topic_last_post_time topic_last_view_time topic_moved_id topic_bumped topic_bumper poll_title poll_start poll_length poll_max_options poll_last_vote poll_vote_change
+Notre_users+
user_id user_type group_id user_permissions user_perm_from user_ip user_regdate username username_clean user_password user_passchg user_pass_convert user_email user_email_hash user_birthday user_lastvisit user_lastmark user_lastpost_time user_lastpage user_last_confirm_key user_last_search user_warnings user_last_warning user_login_attempts user_inactive_reason user_inactive_time user_posts user_lang user_timezone user_dst user_dateformat user_style user_rank user_colour user_new_privmsg user_unread_privmsg user_last_privmsg user_message_rules user_full_folder user_emailtime user_topic_show_days user_topic_sortby_type user_topic_sortby_dir user_post_show_days user_post_sortby_type user_post_sortby_dir user_notify user_notify_pm user_notify_type user_allow_pm user_allow_viewonline user_allow_viewemail user_allow_massemail user_options user_avatar user_avatar_type user_avatar_width user_avatar_height user_sig user_sig_bbcode_uid user_sig_bbcode_bitfield user_from user_icq user_aim user_yim user_msnm user_jabber user_website user_occ user_interests user_actkey user_newpasswd user_form_salt
h2. Conversion tables
h3. Redmine Users
Search for the user to have an existing entry, if not their posts will be assigned to anonymous.
|_.Redmine Entry|_.BB Entry|
|id||
|login|notre_users->username|
|hashed_password||
|firstname||
|lastname||
|mail|notre_users->user_email|
|mail_notification||
|admin||
|status||
|last_login_on||
|language|notre_users->user_lang|
|auth_source_id||
|created_on||
|updated_on||
|type||
|identity_url||
h3. Redmine Boards
We will create these from scratch - Development, Using Leginon, Using Appion, Tomography, Installation, Administration Tools
|_.Redmine Entry|_.BB Entry|
|id||
|project_id|(the leginon id)|
|name|notre_forums->forum_name|
|description|notre_forums->forum_desc|
|position||
|topics_count|notre_forums->forum_topics|
|messages_count|notre_forums->forum_posts|
|last_message_id|After all messages are ported add: notre_forums->forum_last_post_id->Redmine Messages->bb_post_id->id|
|bb_forum_id|notre_forums->forum_id|
h3. Redmine Messages
|_.Redmine Entry|_.BB Entry|
|id||
|board_id|notre_posts->forum_id->Redmine Boards->bb_forum_id->id|
|parent_id|Add these as second step after all posts moved over, notre_posts->topic_id->notre_topics->topic_first_post_id->Redmine Messages->bb_post_id->id|
|subject|notre_posts->post_subject|
|content|notre_posts->post_text (need to get BLOB)|
|author_id|notre_posts->poster_id->notre_users->user_email->Users->mail->Users->id, if does not exist assign to anonymous|
|replies_count|Set all to 0 then check Notre_topics->topic_first_post_id and update that message with notre_topics->topic_replies|
|last_reply_id|Set all to NULL then check notre_topics->topic_first_post_id->Redmine Messages->bb_post_id->id and update that message with notre_topics->topic_last_post_id->Redmine Messages->bb_post_id->id|
|created_on|notre_posts->post_time (may need a conversion)|
|updated_on|notre_posts->post_edit_time (may need a conversion)|
|locked|notre_posts->post_edit_locked|
|sticky|0|
|bb_post_id|notre_posts->post_id|
h2. Commands
h3. Make backups
First backup the tables that we will be modifying:
bq. mysqldump -u amber -p --skip-lock-tables --extended-insert redmine boards > boards-preport.sql
bq. mysqldump -u amber -p --skip-lock-tables --extended-insert redmine messages > messages-preport.sql
h3. Add temporary columns to the boards and messages tables
<pre>
ALTER TABLE boards
ADD bb_post_id int(11);
ALTER TABLE messages
ADD bb_forum_id int(11);
</pre>
h3. Add forums
<pre>
INSERT INTO redmine.boards (project_id, name, description, topics_count, messages_count, bb_forum_id)
SELECT redmine.projects.id, bb2.notre_forums.forum_name, bb2.notre_forums.forum_desc, bb2.notre_forums.forum_topics, bb2.notre_forums.forum_posts, bb2.notre_forums.forum_id
FROM redmine.projects, bb2.notre_forums
WHERE redmine.projects.identifier="leginon"
</pre>
Inserts 9 rows.
h3. Add Messages
<pre>
INSERT INTO redmine.messages (board_id, subject, content, locked, sticky, bb_post_id)
SELECT redmine.boards.id, bb2.notre_posts.post_subject, bb2.notre_posts.post_text, bb2.notre_posts.post_edit_locked, 0, bb2.notre_posts.post_id
FROM bb2.notre_posts, redmine.boards
WHERE bb2.notre_posts.forum_id = redmine.boards.bb_forum_id;
</pre>
inserted 603 rows.
h3. Add parent_id to messages
<pre>
UPDATE redmine.messages AS redMess1, redmine.messages AS redMess2, bb2.notre_topics, bb2.notre_posts
SET redMess1.parent_id=redMess2.id
WHERE redMess1.bb_post_id = bb2.notre_posts.post_id
AND bb2.notre_posts.topic_id = bb2.notre_topics.topic_id
AND bb2.notre_topics.topic_first_post_id = redMess2.bb_post_id
AND redMess1.id != redMess2.id;
</pre>
h3. Add author_id to messages
<pre>
UPDATE redmine.messages, redmine.users, bb2.notre_users, bb2.notre_posts
SET redmine.messages.author_id=redmine.users.id
WHERE redmine.messages.bb_post_id = bb2.notre_posts.post_id
AND bb2.notre_posts.poster_id=bb2.notre_users.user_id
AND bb2.notre_users.user_email = redmine.users.mail;
</pre>
For the messages from people who are not registered in redmine, set the author_id to 2 which is the anonymous user.
<pre>
UPDATE redmine.messages
SET redmine.messages.author_id=2
WHERE redmine.messages.author_id IS NULL;
</pre>
Updates 290 entries.
h3. Add replies_count to messages
<pre>
UPDATE redmine.messages, bb2.notre_topics, bb2.notre_posts
SET redmine.messages.replies_count = bb2.notre_topics.topic_replies
WHERE redmine.messages.parent_id IS NULL
AND redmine.messages.bb_post_id = bb2.notre_posts.post_id
AND bb2.notre_posts.topic_id = bb2.notre_topics.topic_id;
</pre>
h3. Add last_reply_id to messages
<pre>
UPDATE redmine.messages AS redMess1, redmine.messages AS redMess2, bb2.notre_topics, bb2.notre_posts
SET redMess1.last_reply_id = redMess2.id
WHERE redMess1.parent_id IS NULL
AND redMess1.bb_post_id = bb2.notre_posts.post_id
AND bb2.notre_posts.topic_id = bb2.notre_topics.topic_id
AND bb2.notre_topics.topic_last_post_id = redMess2.bb_post_id;
</pre>
h3. Convert Unix timestamps to ISO 8601 and add to messages
http://dev.mysql.com/doc/refman/5.1/en/date-and-time-functions.html#function_from-unixtime
http://aruljohn.com/timestamp2date.html
<pre>
UPDATE redmine.messages, bb2.notre_posts
SET redmine.messages.created_on = FROM_UNIXTIME(bb2.notre_posts.post_time)
WHERE redmine.messages.bb_post_id = bb2.notre_posts.post_id;
</pre>
<pre>
UPDATE redmine.messages, bb2.notre_posts
SET redmine.messages.updated_on = FROM_UNIXTIME(bb2.notre_posts.post_edit_time)
WHERE redmine.messages.bb_post_id = bb2.notre_posts.post_id
AND bb2.notre_posts.post_edit_time != 0;
</pre>
h3. Create a backup of the tables
bq. mysqldump -u amber -p --skip-lock-tables --extended-insert redmine boards > boards-postport.sql
bq. mysqldump -u amber -p --skip-lock-tables --extended-insert redmine messages > messages-postport.sql
h3. Remove the temporary columns
<pre>
ALTER TABLE boards
DROP COLUMN bb_post_id;
ALTER TABLE messages
DROP COLUMN bb_forum_id;
</pre>
h3. For testing content conversion
Get the original content:
<pre>
UPDATE redmine.messages, bb2.notre_posts
SET redmine.messages.content = bb2.notre_posts.post_text
WHERE redmine.messages.bb_post_id = bb2.notre_posts.post_id;
</pre>