summaryrefslogtreecommitdiffabout
Unidiff
Diffstat (more/less context) (ignore whitespace changes)
-rw-r--r--bin/kdepim/Zaurus-KDE_syncHowTo.txt45
1 files changed, 44 insertions, 1 deletions
diff --git a/bin/kdepim/Zaurus-KDE_syncHowTo.txt b/bin/kdepim/Zaurus-KDE_syncHowTo.txt
index 90c6237..5aad5da 100644
--- a/bin/kdepim/Zaurus-KDE_syncHowTo.txt
+++ b/bin/kdepim/Zaurus-KDE_syncHowTo.txt
@@ -1,251 +1,294 @@
1 1
2Sync HowTo Zaurus <-> KDE 2Sync HowTo Zaurus <-> KDE
3 3
4NOTE: 4NOTE:
5CURRENTLY ONLY SYNCING OF CALENDAR DATA IS SUPPORTED! 5CURRENTLY ONLY SYNCING OF CALENDAR DATA IS SUPPORTED!
6 6
7This is a 7This is a
8Sync HowTo Zaurus <-> K-Desktop Environment(KDE) 8Sync HowTo Zaurus <-> K-Desktop Environment(KDE)
9using the KDE-Pim/Pi applications 9using the KDE-Pim/Pi applications
10KAddressbook/Pi (KA/Pi) and KOrganizer/Pi (KO/Pi) 10KAddressbook/Pi (KA/Pi) and KOrganizer/Pi (KO/Pi)
11on the Zaurus (Z). 11on the Zaurus (Z).
12 12
13You can now easily sync your Z with the 13You can now easily sync your Z with the
14PIM data of the KDE. 14PIM data of the KDE.
15(addressbook and calendar data). 15(addressbook and calendar data).
16You need to install the desktop versions 16You need to install the desktop versions
17of KA/Pi+KO/Pi on the desktop. 17of KA/Pi+KO/Pi on the desktop.
18You need KDE version 3.3.0 or higher on your desktop. 18You need KDE version 3.3.0 or higher on your desktop.
19You need KA/Pi+KO/Pi version 1.9.11 or higher on the desktop 19You need KA/Pi+KO/Pi version 1.9.11 or higher on the desktop
20and on the Z. 20and on the Z.
21 21
22NOTE: Almost the same procedure will make it possible to 22NOTE: Almost the same procedure will make it possible to
23sync KA/Pi+KO/Pi running on Windows with KDE via network. 23sync KA/Pi+KO/Pi running on Windows with KDE via network.
24 24
25The setup+sync procedure is: 25The setup+sync procedure is:
26 26
270) How the syncing works
271) Installing KA/Pi+KO/Pi on the Z 281) Installing KA/Pi+KO/Pi on the Z
282) Installing desktop version of KA/Pi+KO/Pi on the desktop 292) Installing desktop version of KA/Pi+KO/Pi on the desktop
293) Connection your Z to the desktop via network 303) Connection your Z to the desktop via network
30 (network connection can be set up via USB cable or (W)Lan 31 (network connection can be set up via USB cable or (W)Lan
314) Configuring KA/Pi+KO/Pi on Z for Sync 324) Configuring KA/Pi+KO/Pi on Z for Sync
325) Enable remote sync in KA/Pi+KO/Pi on the desktop 335) Enable remote sync in KA/Pi+KO/Pi on the desktop
336) Sync 346) Sync
34 35
36*****************************************************
370) How the syncing works
38*****************************************************
39
40After setting up everything, the following actions will
41be performed when syncing:
42User enables "remote pi-sync" on desktop.
43User chooses "sync with configured desktop profile" on the Z.
44Z sends sync request via network to configured IP/port/password.
45KO/Pi on desktop detects sync request and syncs with KDE (configurable!).
46A window pops up, that KO/Pi on desktop is in "remote syncing mode".
47If a conflict occurs when syncing KO/PI<->KDE on the desktop,
48automatically the newest entry is choosen.
49(To avoid the need of user interaction)
50KO/Pi on desktop sends synced file to Zaurus.
51KO/Pi on desktop is in "waiting mode" to get synced file back.
52Zaurus is syncing it's own calendar with the received file.
53Here can be some user interaction needed, i.e.
54if the sync profile is configured as
55"ask for every entry on conflict" and a conflict occurs.
56Zaurus sends back synced file to desktop.
57Syncing on Zaurus is complete now.
58KO/Pi on desktop gets back synced file.
59KO/Pi on desktop removes all entries in its own calendar and
60reloads the synced file.
61KO/Pi on desktop syncs with KDE.
62After syncing with KDE is finished, KO/Pi closes
63the "remote syncing mode" window and displays
64a "syncing complete" message in the headline.
65
66The actual syncing KO/Pi on desktop <-> KDE is
67performed by a small command line tool "kdecaldump",
68which writes/reads the complete KDE calendar resources to
69a file/from a file.
70KO/Pi tags changed entries such that an unchanged entry
71is not changed in KDE by kdecaldump. That is important for
72calendar entries in KDE, stored in a "disconnected IMAP" calendar resource.
73
74
75Same way is KA/Pi working.
76
35 77
36***************************************************** 78*****************************************************
371) Installing KA/Pi+KO/Pi on the Z 791) Installing KA/Pi+KO/Pi on the Z
38***************************************************** 80*****************************************************
39 81
40Download latest version of KA/Pi+KO/Pi from 82Download latest version of KA/Pi+KO/Pi from
41http://sourceforge.net/projects/kdepimpi/ 83http://sourceforge.net/projects/kdepimpi/
42Project KDE/Pim. 84Project KDE/Pim.
43Direct link is: 85Direct link is:
44http://sourceforge.net/project/showfiles.php?group_id=104103&package_id=112604 86http://sourceforge.net/project/showfiles.php?group_id=104103&package_id=112604
45Click on the version number to read the release notes/change log. 87Click on the version number to read the release notes/change log.
46Choose there the right precompiled package for your Z: 88Choose there the right precompiled package for your Z:
47For Sharp ROM 89For Sharp ROM
48-File: kdepim_1.x.xx_for_SharpROM.ipk.zip 90-File: kdepim_1.x.xx_for_SharpROM.ipk.zip
49For Open Zaurus ROM: 91For Open Zaurus ROM:
50-File: kdepim_1.x.xx_for_OZ-gcc3xx.ipk.zip 92-File: kdepim_1.x.xx_for_OZ-gcc3xx.ipk.zip
51If unsure, choose: 93If unsure, choose:
52-File: kdepim_1.x.xx_for_SharpROM.ipk.zip 94-File: kdepim_1.x.xx_for_SharpROM.ipk.zip
53 95
54Unzip the file and install the packages as usual on your Z. 96Unzip the file and install the packages as usual on your Z.
55In order to intstall KA/Pi+KO/Pi on your Z, 97In order to intstall KA/Pi+KO/Pi on your Z,
56you need to install the following files: 98you need to install the following files:
57kmicrokdelibs_1.x.xx_arm.ipk 99kmicrokdelibs_1.x.xx_arm.ipk
58kaddressbook_1.x.xx_arm.ipk 100kaddressbook_1.x.xx_arm.ipk
59korganizer_1.x.xx_arm.ipk 101korganizer_1.x.xx_arm.ipk
60 102
61***************************************************** 103*****************************************************
622) Installing desktop version of KA/Pi+KO/Pi on the desktop 1042) Installing desktop version of KA/Pi+KO/Pi on the desktop
63***************************************************** 105*****************************************************
64 106
65Precompiled packages are available for SuSE 9.1. 107Precompiled packages are available for SuSE 9.1.
66Choose on the above download location: 108Choose on the above download location:
67File: KDE-Pim-Pi-1.9.10-SuSE9.1.i586.rpm 109File: KDE-Pim-Pi-1.9.10-SuSE9.1.i586.rpm
68Download file and install it on console with 110Download file and install it on console with
69su 111su
70rpm -ihv KDE-Pim-Pi-1.9.10-SuSE9.1.i586.rpm 112rpm -ihv KDE-Pim-Pi-1.9.10-SuSE9.1.i586.rpm
71 113
72NOTE for users of SuSE 9.1: 114NOTE for users of SuSE 9.1:
73You need KDE version 3.3.0 or higher on your desktop. 115You need KDE version 3.3.0 or higher on your desktop.
74Plese make an online update in SuSE (YAST), then update 116Plese make an online update in SuSE (YAST), then update
75your KDE to version 3.3.0 or higher. 117your KDE to version 3.3.0 or higher.
76You can find links to updated precompiled versions of KDE 118You can find links to updated precompiled versions of KDE
77for SuSE 9.1 on the SusE web site, 119for SuSE 9.1 on the SusE web site,
78a direct link is for example: 120a direct link is for example:
79ftp://ftp.gwdg.de/pub/linux/suse/ftp.suse.com/suse/i386/supplementary/KDE/update_for_9.1 121ftp://ftp.gwdg.de/pub/linux/suse/ftp.suse.com/suse/i386/supplementary/KDE/update_for_9.1
80HOWTO UPDATE KDE: 122HOWTO UPDATE KDE:
81Download there the packages in "base". 123Download there the packages in "base".
82And the needed package for your language in "internationalization". 124And the needed package for your language in "internationalization".
83Put all downloaded files in one "installation" directory. 125Put all downloaded files in one "installation" directory.
84Open console and go to the downloaded "installation" directory. 126Open console and go to the downloaded "installation" directory.
85Do there a 127Do there a
86su 128su
87and then perform a test for the update: 129and then perform a test for the update:
88rpm -Uhv --test *.rpm 130rpm -Uhv --test *.rpm
89 131
90If no dependencies are shown, you can do the actual update with 132If no dependencies are shown, you can do the actual update with
91rpm -Uhv *.rpm 133rpm -Uhv *.rpm
92 134
93If there are missing dependencies, you can resolve them by 135If there are missing dependencies, you can resolve them by
94- download the needed updated KDE package from the 136- download the needed updated KDE package from the
95 "applications" or from the "development" folder on the server. 137 "applications" or from the "development" folder on the server.
96- adding a needed rpm package from the SuSE install DVD 138- adding a needed rpm package from the SuSE install DVD
97- remove the package that has dependencies from your "installation" directory. 139- remove the package that has dependencies from your "installation" directory.
98 140
99Do the 141Do the
100rpm -Uhv --test *.rpm 142rpm -Uhv --test *.rpm
101until you get no dependencies and no errors, then do a 143until you get no dependencies and no errors, then do a
102rpm -Uhv *.rpm 144rpm -Uhv *.rpm
103Run 145Run
104SuSEconfig 146SuSEconfig
105after installing with rpm is finished. 147after installing with rpm is finished.
106Restart KDE. 148Restart KDE.
107 149
108***************************************************** 150*****************************************************
1093) Connection your Z to the desktop via network 1513) Connection your Z to the desktop via network
110 (network connection can be set up via USB cable or (W)Lan 152 (network connection can be set up via USB cable or (W)Lan
111***************************************************** 153*****************************************************
112 154
113a) Connection via network cable/(W)Lan cards 155a) Connection via network cable/(W)Lan cards
114 Connect your desktop to the network. 156 Connect your desktop to the network.
115 Set up networking on the Z. 157 Set up networking on the Z.
116 Make sure, you can ping the desktop from Z. 158 Make sure, you can ping the desktop from Z.
117b) Connection via USB cable:(is working for Z 7x0 and Z5500) 159b) Connection via USB cable:(is working for Z 7x0 and Z5500)
118 (i) Open console on desktop and type 160 (i) Open console on desktop and type
119 su 161 su
120 tail -f /var/log/messages 162 tail -f /var/log/messages
121 (ii) Connect your Z with the USB cable to your desktop 163 (ii) Connect your Z with the USB cable to your desktop
122 You should get as output in the above console 164 You should get as output in the above console
123 something like this: 165 something like this:
124 ("BUG" is the name of the desktop computer!) 166 ("BUG" is the name of the desktop computer!)
125 Oct 26 12:49:37 BUG kernel: usb 2-2: new full speed USB device using address 2 167 Oct 26 12:49:37 BUG kernel: usb 2-2: new full speed USB device using address 2
126 Oct 26 12:49:37 BUG kernel: usb 2-2: Product: SL-C860 168 Oct 26 12:49:37 BUG kernel: usb 2-2: Product: SL-C860
127 Oct 26 12:49:37 BUG kernel: usb 2-2: Manufacturer: Sharp 169 Oct 26 12:49:37 BUG kernel: usb 2-2: Manufacturer: Sharp
128 Oct 26 12:49:37 BUG /etc/hotplug/usb.agent[22659]: need a device for this command 170 Oct 26 12:49:37 BUG /etc/hotplug/usb.agent[22659]: need a device for this command
129 Oct 26 12:49:43 BUG kernel: usb0: register usbnet at usb-0000:00:1d.0-2, Sharp Zaurus, PXA-2xx based 171 Oct 26 12:49:43 BUG kernel: usb0: register usbnet at usb-0000:00:1d.0-2, Sharp Zaurus, PXA-2xx based
130 Oct 26 12:49:43 BUG kernel: usbcore: registered new driver usbnet 172 Oct 26 12:49:43 BUG kernel: usbcore: registered new driver usbnet
131 You see in the 5. line ("BUG kernel: usb0: register"), that usb device usb0 is used. 173 You see in the 5. line ("BUG kernel: usb0: register"), that usb device usb0 is used.
132 (iii) Create a network startup entry in /etc/sysconfig/network 174 (iii) Create a network startup entry in /etc/sysconfig/network
133 Depending of the number X of the used usb device, create a file 175 Depending of the number X of the used usb device, create a file
134 /etc/sysconfig/network/ifcfg-usbX 176 /etc/sysconfig/network/ifcfg-usbX
135 (in our case /etc/sysconfig/network/ifcfg-usb0 ) 177 (in our case /etc/sysconfig/network/ifcfg-usb0 )
136 with the following content: 178 with the following content:
137 # usbX config for Zaurus 179 # usbX config for Zaurus
138 IPADDR='192.168.129.200' 180 IPADDR='192.168.129.200'
139 NETMASK='255.255.255.0' 181 NETMASK='255.255.255.0'
140 NETWORK='192.168.129.0' 182 NETWORK='192.168.129.0'
141 BROADCAST='192.168.129.255' 183 BROADCAST='192.168.129.255'
142 STARTMODE='hotplug' 184 STARTMODE='hotplug'
143 (iv) Disconnect the Z and connect the Z again to the desktop. 185 (iv) Disconnect the Z and connect the Z again to the desktop.
144 Now you should be able to ping the Z from the desktop, try in console on desktop: 186 Now you should be able to ping the Z from the desktop, try in console on desktop:
145 ping 192.168.129.201 187 ping 192.168.129.201
146 Now you should be able to ping the desktop from the Z, try in console on Z: 188 Now you should be able to ping the desktop from the Z, try in console on Z:
147 ping 192.168.129.200 189 ping 192.168.129.200
148 190
149 Now you will get a network connection automatically, 191 Now you will get a network connection automatically,
150 if you connect your Z to the desktop via the USB cable. 192 if you connect your Z to the desktop via the USB cable.
151 193
152 194
153In the following, we assume, that 195In the following, we assume, that
154the desktop has the IP address: 192.168.129.200 196the desktop has the IP address: 192.168.129.200
155and that 197and that
156the Z has the IP address: 192.168.129.201 198the Z has the IP address: 192.168.129.201
157 199
158***************************************************** 200*****************************************************
1594) Configuring KA/Pi+KO/Pi on Z for Sync 2014) Configuring KA/Pi+KO/Pi on Z for Sync
160***************************************************** 202*****************************************************
161 203
162Start KO/Pi on the Z. 204Start KO/Pi on the Z.
163Choose Menu: Synchronize - Configure 205Choose Menu: Synchronize - Configure
164Fill in name for "Local device name:", e.g. "Z760" 206Fill in name for "Local device name:", e.g. "Z760"
165Click on "New profile" 207Click on "New profile"
166Set name of "Profile:", e.g. "BUG". 208Set name of "Profile:", e.g. "BUG".
167(that is the above name of the desktop computer) 209(that is the above name of the desktop computer)
168Choose "Profile kind": Pi-Sync. 210Choose "Profile kind": Pi-Sync.
169Set "Password for remote access", e.g. "xyz" for 211Set "Password for remote access", e.g. "xyz" for
170Calendar and Addressbook. 212Calendar and Addressbook.
171Set Remote IP address to 192.168.129.200 for 213Set Remote IP address to 192.168.129.200 for
172Calendar and Addressbook. 214Calendar and Addressbook.
173(Note: That is the IP address of the desktop!). 215(Note: That is the IP address of the desktop!).
174The "Remote port number" is 9197/9198 for 216The "Remote port number" is 9197/9198 for
175Calendar and Addressbook. 217Calendar and Addressbook.
176You do not have to change the 218You do not have to change the
177"Remote port number" or any other settings. 219"Remote port number" or any other settings.
178Click "OK" button to save your settings. 220Click "OK" button to save your settings.
179 221
180Now you have configured KA/Pi+KO/Pi sync on the Z, 222Now you have configured KA/Pi+KO/Pi sync on the Z,
181no need to configure anything in KA/Pi. 223no need to configure anything in KA/Pi.
182 224
183 225
184***************************************************** 226*****************************************************
1855) Enable remote sync in KA/Pi+KO/Pi on the desktop 2275) Enable remote sync in KA/Pi+KO/Pi on the desktop
186***************************************************** 228*****************************************************
187 229
188Start KO/Pi on the desktop. 230Start KO/Pi on the desktop.
189Do a "test" sync with KDE, choose menu: 231Do a "test" sync with KDE, choose menu:
190Synchronize - KDE_Desktop 232Synchronize - KDE_Desktop
191After syncing, you should have the same data in KDE 233After syncing, you should have the same data in KDE
192and in KO/Pi. 234and in KO/Pi.
193NOTE: 235NOTE:
194The KO/Pi version 1.9.10 had the bug, that on the first 236The KO/Pi version 1.9.10 had the bug, that on the first
195sync with KDE, all data in KDE was deleted. 237sync with KDE, all data in KDE was deleted.
196DO NOT USE VERSION 1.9.10! 238DO NOT USE VERSION 1.9.10!
197 239
198The bevaviour on the first sync is 240The bevaviour on the first sync is
199(in versions >= 1.9.11) 241(in versions >= 1.9.11)
200that no data is deleted, the data in KO/Pi and in 242that no data is deleted, the data in KO/Pi and in
201KDE is merged into one calendar. 243KDE is merged into one calendar.
202 244
203When the first sync was ok, please choose menu: 245When the first sync was ok, please choose menu:
204Synchronize - Enable Pi-sync 246Synchronize - Enable Pi-sync
205Fill in the values for port ("9197" in our examle) 247Fill in the values for port ("9197" in our examle)
206and for the password ( "xyz" in our example) 248and for the password ( "xyz" in our example)
207that you did configure on the Z for that computer. 249that you did configure on the Z for that computer.
208Enable "Automatically start at application start" 250Enable "Automatically start at application start"
209and "Automatically sync with KDE-Desktop when receiving sync request" 251and "Automatically sync with KDE-Desktop when receiving sync request"
210by checking the two boxes. 252by checking the two boxes.
211Close KO/Pi. 253Close KO/Pi.
212 254
213Configure / test KA/Pi on the desktop in the same way. 255Configure / test KA/Pi on the desktop in the same way.
214Fill in the right value for the port (9198 in our examle) 256Fill in the right value for the port (9198 in our examle)
215in KA/Pi! 257in KA/Pi!
216 258
217***************************************************** 259*****************************************************
2186) Sync 2606) Sync
219***************************************************** 261*****************************************************
220 262
221After configuring everything as above, you have to do 263After configuring everything as above, you have to do
222the following, if you want to sync your Zaurus with KDE: 264the following, if you want to sync your Zaurus with KDE:
223(It syncs will all resources in KDE, that are not "readonly"). 265(It syncs will all resources in KDE, that are not "readonly").
224 266
225Start KO/Pi on the desktop. 267Start KO/Pi on the desktop.
268If Kontact or KOrganizer is running, save the calendar!
226Connect the Z with the USB cable to your desktop. 269Connect the Z with the USB cable to your desktop.
227(Or to the local network). 270(Or to the local network).
228Choose on the Z the menu: 271Choose on the Z the menu:
229Syncronize - <your name for the desktop sync profile> 272Syncronize - <your name for the desktop sync profile>
230( that was "BUG" in our example ). 273( that was "BUG" in our example ).
231That's all. 274That's all.
232 275
233Do the same with KA/Pi. 276Do the same with KA/Pi.
234 277
235NOTE: 278NOTE:
236If an appointment/addressee is created on the Z, it is added to the 279If an appointment/addressee is created on the Z, it is added to the
237standard resource in KDE. 280standard resource in KDE.
238 281
239If you have todos with subtodos in your calendar, you will get on 282If you have todos with subtodos in your calendar, you will get on
240every sync (after you restartet KOrganizer or Kontact in KDE) 283every sync (after you restartet KOrganizer or Kontact in KDE)
241the message "xx items changed on local", where 284the message "xx items changed on local", where
242xx is greater or equal to the number of todos. 285xx is greater or equal to the number of todos.
243That behaviour is caused by a bug in KDE. 286That behaviour is caused by a bug in KDE.
244(In KDE, everytime a subtodo is loaded, 287(In KDE, everytime a subtodo is loaded,
245it's "last modified" settings are set to the current time - ouch!) 288it's "last modified" settings are set to the current time - ouch!)
246I hope that bug will be fixed soon. 289I hope I can fix this bug in KDE soon.
247 290
248 291
249 292
250 293
251 294