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