Addes/changed migration howto

2 files changed, 216 insertions, 3 deletions

diff --git a/bin/Migration-HowTo.txt b/bin/Migration-HowTo.txt
index 4425cf0..2212004 100644
--- a/bin/Migration-HowTo.txt
+++ b/bin/Migration-HowTo.txt
@@ -1,208 +1,218 @@
 
 Migration HowTo Outlook 200X -> KDE 
 
-Version 1.0.3
+Version 1.0.4
 The latest version of this file can be downloaded from
 http://sourceforge.net/projects/kdepimpi/
 Please choose there package/project/file:
 general Files for KDE/Pim
 MigrationHowTo_OL2KDE
 MigrationHowTo_OL2KDE.txt.zip
 
 
-This HowTo describes the process of migrating data ( contact and calendar data ) from Outlook 200X to the PIM programs of the KDE-Desktop-Environment.
+This HowTo describes the process of migrating data ( contact and calendar data ) from Outlook 98/200X (TM) to the PIM programs of the KDE-Desktop-Environment. 
+We will call Outlook as OL in this document.
 The PIM programs are KAdddressbook and KOrganizer, which may be used embedded in the Kontact PIM management framework.
-This HowTo describes version 1.9.3a of the migration tools.
+This HowTo describes version 1.9.5b of the migration tools.
 The migration tools are the platform independent versions of KAdddressbook and KOrganizer: KAdddressbook/Pi and KOrganizer/Pi.
+If you want to migrate emails, you can do that via an IMAP server.
+A Kolab server is an IMAP server.
+A HowTo how to migrate emails and contact and calendar data to a Kolab server using the Toltec (TM) Outlook(TM)  plugin is available as well.
+You can found it on
+http://sourceforge.net/projects/kdepimpi/
+Please choose there package/project/file:
+general Files for KDE/Pim
+MigrationHowTo_OL2KDE
+MigrationHowTo_OL2Kolab.txt.zip
 
 Content:
 
 1) How to start
 2) How to import pst files in Outlook
 3) Where to get the migration tools
 4) How to install the migration tools
 5) How to get the contact data out of Outlook200X
 6) How to get the calendar data out of Outlook200X
 7) How to import your contact data into Kontact
 8) How to import your calendar data into Kontact
 
 APPENDIX A) Problems and solutions when reading contact data
 APPENDIX B) Problems and solutions when reading calendar data
 
 ****************************************
 1) How to start
 ****************************************
 
 For the migration we need the actual Outlook 200X data, which Outlook stores in *.pst files.
 Then we need an installed version of Outlook 200X to access these  *.pst files.
 When we have an Outllook 200X running with all data accessable, we need the migration tools.
 
 If you have no Outlook200X installed please install the Outlook version, you need to a import your *.pst files.
 If you have an Outlook200X installed with no contact/calendar data available, and you have some  *.pst files please continue with: 2) How to import pst files in Outlook.
 If you have a running Outlook200X already with contact/calendar data available, please continue with: 3) Where to get the migration tools.
 
 
 ****************************************
 2) How to import pst files in Outlook
 ****************************************
 
 To open a local *.pst file in Outlook2003, choose menu:
 File - Open - Outlook Data File ...
 Now the data included in this file is shown 
 as folders of a newly added root folder in the Outlook folder view.
 This root folder is probably not accessable from
 the migration tools via OLE. 
 To access data stored in one of the subfolders,
 copy this subfolder to a root folder, 
 which can be accessed from the migration tools via OLE.
 (To know, which folder can be accessed, just perform 5.) or 6.) until
 you get the Oulook import dialog!)
 
 To copy it, right click on that subfolder and choose
 Copy "<subfoldername>"...
 in the popup menu.
 
 ****************************************
 3) Where to get the migration tools
 ****************************************
 
 The data migration is is performed with the Windows versions of KAdddressbook/Pi and KOrganizer/Pi.
 Pi stands for platform-independend - platform-independend because the same program is available for different platforms, like Windows, Linux desktop and Sharp-Zaurus PDA.
 Note: The Linux desktop versions of KOrganizer/Pi and KOrganizer/KDE-desktop are two different programs! You cannot use  KOrganizer/Pi together with, or embedded in, the KDE-desktop environment. The same is valid for KAdddressbook/Pi.
 
 The programs you need for the migration are: 
 a) KAdddressbook/Pi executeable + 2dlls + icons
 b) KOrganizer/Pi executeable + icons
 c) The Qt3 library qt-mt331.dll and the MSVC library msvcr71.dll and the MSVC library mfc71u.dll
 You can download all of them at:
 
 http://sourceforge.net/projects/kdepimpi/
 
 Download of a) and b)
 Please choose there package/project with name KDE/Pim
 (Direct link: http://sourceforge.net/project/showfiles.php?group_id=104103&package_id=112604 )
 Choose there the topmost latest version and the files
 kapixxx-exe.zip
 kopixxx-exe.zip
 The latest version is currently ( 2004-09-15 ) 1.9.5b.
 Such that the files to download are
 kapi195b-exe.zip
 kopi195b-exe.zip
 
 To download c)
 Please choose there package/project/file:
 general Files for KDE/Pim
 Needed Windows Dlls
 kdepimdll.zip
 
 (Direct link: http://sourceforge.net/project/showfiles.php?group_id=104103&package_id=122438&release_id=256700 )
 Choose there the file:
 kdepimdll.zip
 
 Now you have downloaded the files
 
 kapi195b-exe.zip
 kopi195b-exe.zip
 kdepimdll.zip
 
 and we can continue to install the files, which is simply unzipping them.
 
 
 ****************************************
 4) How to install the migration tools
 ****************************************
 
 You have downloaded the files
  
 kapi195b-exe.zip
 kopi195b-exe.zip
 kdepimdll.zip
 
 Unzip these files.
 Now choose an arbitrary installation directory, where to copy all the needed files together.
 You should have now the following files and the directory "kdepim" in the same directory:
 kopi.exe  
 kapi.exe  
 microkabc_dir.dll  
 microkabc_file.dll   
 msvcr71.dll
 mfc71u.dll
 qt-mt331.dll  
 ReadMich.txt
 kdepim (directory)
 
 The directory "kdepim" should contain subdirectories 
 kaddressbook  
 korganizer
 which itself contain some subdirectories with icons and help text.
 
 Now the migration tools are ready for use.
 
 
 NOTE AND HINT for performing migration on many workstations:
 Just burn the content of the installation dir on a CD.
 Then you can put the CD in every workstation and execute the migration tools from that CD directly.
 
 
 *************************************************************
 5) How to get the contact data out of Outlook200X
 *************************************************************
 
 Note: When accessing Outlook to read the data, it should not be possible, that there is any data lost in Outlook, because the progam accesses Outlook only Read-Only.
 
 You have the file
 kapi.exe  
 and the other needed files accessable on your workstation.
 
 Getting the contact data
 
 Please start kapi.exe.
 Choose menu:
 File - Import - Import from Outlook...
 You will get a dialog which shows all "Personal Folders" of Outlook.
 Choose the Contact Folder(s) you want to import and select them with a hook.
 (All other folder but the contact containing folders are shown, but disabled).
 (If the data you want to import is not stored in one of the shown folders,
 please read step 2.) and click on "close" ).
 Click the "import" button.
 Now Outlook asks you to allow access to the contact data.
 Select "Allow access" amd click "Yes" in this dialog.
 Now the importing is performed and KA/Pi will show a progress bar.
 After importing, KA/Pi shows a dialog, how much contacts are imported.
 If you press a second time "import" , already imported contacts are not imported again.
 After importing you can choose another "Contact Folder" to import or close the import dialog.
 Please close the import dialog.
 Now you see the imported contacts in KA/Pi on the left in the list view.
 Please verify, that the import was correct.
 About problems of mapping particular Outlook-data-fields to KAdressbook-data-fields see Appendix A).
 
 Choose menu:
 File - Save
 and close KA/Pi.
 Now you should have the contact data in the file std.vcf in your home directory in the path
 (YOURHOMEDIR)\kdepim\apps\kabc\std.vcf
 
 Copy that file to a moveable disk or memory stick or just copy it via network to the destination.
 Import that file into KAddressbook/Kontact via Import - Import vcard.
 Details about importing you can read at: 7) How to import your contact data into Kontact
 
 Now you have your Outlook200X contact data on the KDE desktop available and you are done with the migration of contacts.
 
 *************************************************************
 6) How to get the calendar data out of Outlook200X
 *************************************************************
 
 Note: When accessing Outlook to read the data, it should not be possible, that there is any data lost in Outlook, because the progam accesses Outlook only Read-Only.
 
 You have the file
 kopi.exe  
 and the other needed files accessable on your workstation.
 
 Getting the calendar data
 
 NOTE: Before extracting the calendar data, it is recommended to extract the contact data first.
 If you extract the contact data first, the identity (UID) of attendees of a meeting can be mapped correctly in the newly created appointments, such that you can access the attendee contact data later directly from KOrganizer.
 
 Please start kopi.exe.
 
 You will see a dialog, that you started KO/Pi for the first time and that the timezone configuration will be shown now. Confirm with "Ok".
diff --git a/bin/Migration-HowToOL2Kolab.txt b/bin/Migration-HowToOL2Kolab.txt
new file mode 100644
index 0000000..335997e
--- a/dev/null
+++ b/bin/Migration-HowToOL2Kolab.txt
@@ -0,0 +1,203 @@
+Version 1.0.0
+The latest version of this file can be downloaded from
+http://sourceforge.net/projects/kdepimpi/
+Please choose there package/project/file:
+general Files for KDE/Pim
+MigrationHowTo_OL2KDE
+MigrationHowTo_OL2Kolab.txt.zip
+
+
+This HowTo describes the process of migrating data 
+( emails, contacts and calendar data ) 
+from Outlook 98/200X (TM) to a Kolab server.
+We will call Outlook as OL in this document.
+You will need an IMAP server for migrating emails.
+The Kolab server is an IMAP server.
+We will describe how the PIM data  ( contact and calendar data )
+of OL can be migrated using the Toltec (TM) connector.
+Migration of the OL contact and calendar data to KDE 
+(and using the Kolab server from KDE with the KDE Groupware client Kontact) 
+can be done without using the Toltec Outlook connector. 
+It can be done by using migration tools.
+You can found the HowTo using the migration tools on
+http://sourceforge.net/projects/kdepimpi/
+Please choose there package/project/file:
+general Files for KDE/Pim
+MigrationHowTo_OL2KDE
+MigrationHowTo_OL2KDE.txt.zip
+
+Content:
+
+1) How to start
+2) How to import pst files in Outlook
+3) Choose the migration strategie
+4) How to copy the contact data in OL to the Kolab server.
+5) How to copy the calendar data in OL to the Kolab server.
+6) How to copy the email in OL to the Kolab server.
+
+****************************************
+1) How to start
+****************************************
+
+For the migration we need the actual OL data, which Outlook stores in *.pst files.
+Then we need an installed version of OL to access these  *.pst files.
+
+We assume, that we have an OL version installed that manages emails, contacts and calendar data.
+
+If you have no OL installed please install the Outlook version, you need to a import your *.pst files.
+If you have an OL installed with no email/contact/calendar data available, and you have some  *.pst files please continue with: 2) How to import pst files in Outlook.
+If you have a running Outlook200X already with contact/calendar data available, 
+please continue with: 3) Choose the migration strategie.
+
+****************************************
+2) How to import pst files in Outlook
+****************************************
+
+To open a local *.pst file in Outlook2003, choose menu:
+File - Open - Outlook Data File ...
+Now the data included in this file is shown 
+as folders of a newly added root folder in the Outlook folder view.
+This root folder is probably not accessable from
+the migration tools via OLE. 
+To access data stored in one of the subfolders,
+copy this subfolder to a root folder, 
+which can be accessed from the migration tools via OLE.
+(To know, which folder can be accessed, just perform 5.) or 6.) until
+you get the Oulook import dialog!)
+
+To copy it, right click on that subfolder and choose
+Copy "<subfoldername>"...
+in the popup menu.
+
+****************************************
+3) Choose the migration strategie
+****************************************
+
+We assume, that we have an OL version installed that manages emails, contact and calendar data.
+
+The goal is it to get the emails, contacts and calendar data of OL on a Kolab server.
+
+After having the data on the Kolab server, we have two choices:
+
+(A) Accessing the server from KDE with the KDE-Kolab Client Kontact. 
+(B) Accessing the server from Windows XP Outlook 2003 with Toltec Connector.
+
+Such that do have two strategies for the migration:
+
+        (i) 
+        Use the Toltec Connector for migrating the contact 
+        and calendar data. 
+        Moving the email in OL to the Kolab server.
+
+        This can be used for (A) and (B).
+        Doing this for (A)  might involve installing 
+        the Toltec Connector on the source platform
+        syncing everything freshly on the Kolab Server and then
+        just continue using the KDE client on the new data.
+
+        (ii) 
+        Use the migration tools for migrating the contact 
+        and calendar data.
+        Moving the email in OL to the Kolab server.
+
+        Doing this for (A), there is no need to install the
+        Toltec Connector on the source platform.
+
+
+
+   ***  Choosing  (A) and (ii)
+
+If you choose (A) and (ii), please read 
+6) How to copy the email in OL to the Kolab server.
+You can found the HowTo using the migration tools on
+http://sourceforge.net/projects/kdepimpi/
+Please choose there package/project/file:
+general Files for KDE/Pim
+MigrationHowTo_OL2KDE
+MigrationHowTo_OL2KDE.txt.zip
+
+    *** Choosing (B) and (i) or 
+                 (A) and (i)
+
+If you choose (B) and (i) or if you choose (A) and (i),
+please upgrade to QL XP and install the 
+Toltec Connector. After that, please read
+4) How to copy the contact data in OL to the Kolab server.
+5) How to copy the calendar data in OL to the Kolab server.
+6) How to copy the email in OL to the Kolab server.
+
+
+************************************************************
+4) How to copy the contact data in OL to the Kolab server.
+************************************************************
+
+We assume that you have the Toltec Connector installed and that 
+you have configured it to access the Kolab server.
+
+Select the contacts you want to copy.
+If you want to select all contacts of a folder,
+select the topleft entry, scroll to the right, 
+hold the SHIFT key down and click on the rightbottom entry.
+Now all contact of the folder should be selected.
+Now choose  
+Menu: Edit - Copy to folder.
+Choose your destination folder in the Toltec Connector folder and click OK.
+
+After that, sync your Toltec Connector folder with the server.
+
+
+************************************************************
+5) How to copy the calendar data in OL to the Kolab server.
+************************************************************
+
+We assume that you have the Toltec Connector installed and that 
+you have configured it to access the Kolab server.
+Select the calendar folder you want to copy to the server.
+Right click on it - a popup menu pops up.
+Choose "Advanced find" in this menu.
+An  "Advanced find" dialog pops up. Fill out nothing in this dialog, 
+click on the button "Find now".
+As the search result, you will get all entries of that folder.
+Select now the calendar data, you want to copy.
+If you want to select all calendar data of this folder,
+select the topmost entry, scroll to the bottom, 
+hold the SHIFT key down and click on the bottom entry.
+Now all contact of the folder should be selected.
+Now choose in the "Advanced find" dialog the
+Menu: Edit - Copy to folder.
+Choose your destination folder in the Toltec Connector folder and click OK.
+
+After that, sync your Toltec Connector folder with the server.
+
+
+************************************************************
+6) How to copy the email in OL to the Kolab server.
+************************************************************
+
+Note:
+There is no need to have the Toltec Connector installed to move/copy 
+mails with Outlook to an IMAP server.
+
+We assume that there is already the IMAP account on the Kolab server
+configured in OL.
+You will see there a folder Inbox. (And maybe other folders).
+These folder may contain the subfolders "Calendar", "Tasks", "Journal" and Notes.
+These folders are used by the Kolab Groupware client,
+DO NOT COPY ordinary emails to this folders!
+
+If you do not want to copy your emails in the "Inbox", 
+please create another folder on the server.
+
+Now select your folder with the emails, you want to copy.
+
+Select there the emails, you want to copy.
+If you want to select all emails of this folder,
+select the topmost entry, scroll to the bottom, 
+hold the SHIFT key down and click on the bottom entry.
+Now all emails of the folder should be selected.
+Now choose the
+Menu: Edit - Copy to folder.
+Choose your destination folder in the IMAP Kolab server account and click on OK.
+After that, sync your IMAP Kolab server account with the server.
+
+