[cvs] [Wiki] changed: SyncMLProblemReport

[Jan Schneider]

jan  Fri, 30 Oct 2009 05:12:06 -0400

Modified page: http://wiki.horde.org/SyncMLProblemReport
New Revision:  2.0
Change log:  Move some stuff from SyncHowTo here

@@ -5,12 +5,26 @@
  # Test preparations:
   # Make sure you have a recent (stable or CVS) version of the  
framework and the relevant Horde applications involved. If using CVS  
code, make sure that you have actually installed the current framework  
(using the install-packages script in the framework directory).
   # Make sure there's a directory {{/tmp/sync/}}, writeable by the  
webserver ({{chown wwwrun /tmp/sync}}). Clean this directory before  
starting the sync: {{rm /tmp/sync/*}}
   # Turn on logging of PHP errors to a file: make sure you have an  
{{error_log}} entry in {{php.ini}} as described in the SyncHowTo FAQ  
section.
+ # Set log level to PEAR_LOG_DEBUG in Administration -> Setup ->  
Horde -> Logging.
  # Run a synchronization session; perform the actions you intend to  
do and that do not work.
  # Report the problems to the mailing list. Please include the following:
   # What version of Horde and !SyncML are you using //("I'm using a  
CVS version from three days ago")//
   # Did any PHP errors occur during your test? //("No PHP errors  
showed up in the PHP error log")//
- # And finally: include the contents of the {{/tmp/sync/}} log files  
in your post. If no such files have been created, report that.
+ # And finally: include the contents of the {{/tmp/sync/}} log files  
in your post. If no such files have been created, report that. Be  
careful, the log files might contain user names and passwords.

+The log files might contain binary files with .wbxml file extensions.  
We now use our own WBXML libary in the XML_WBXML package. The WBXML  
data gets directly passed and processed, no XML is produced. If  
possible you should provide the decoded XML files when sending a  
problem report. To see the XML data, you can manually decode it. You  
need to install the WBXML utilities for that. This package contains  
the programs {{wbxml2xml}} and {{xml2wbxml}} to convert XML files to  
WBXML and back.

+To install them on Debian:
+<code>
+apt-get install libwbxml2-utils
+</code>
+
+The WBXML Library (aka libwbxml) contains a library and its  
associated tools to parse, encode and handle WBXML documents.
+(The WBXML format is a binary representation of XML, defined by the  
WAP Forum, and used to reduce bandwidth in mobile communications.)
+
+You can decode the data like this:
+<code>
+for a in *.wbxml; do wbxml2xml -m 1 -i 4 -o `basename $a  
.wbxml`_conv.xml $a; done 2>/dev/null
+</code>