PSyncHelp
From Wikipedia
Contents |
Installation
The transport protocol of the synchronisation mechanism
The synchronization uses SOAP (see spec) to transport the information. For PHP 5 this comes builtin out of the box and with PHP >= 5.0.3 it's stable enough to work with PSync. We recommend to use the latest stable PHP5 version. To use PHP 4, a software SOAP service has to be installed, and for PHProjekt that is SOAP. The PHP Licence which is used for the PEAR SOAP does not allow PHProjekt to integrate it so we are not able to deliver a bundled version. Please see the "Server Installation" part of this text for further help installing SOAP on your server.
Client Installation
To install PSync, download client_psyncXXX.exe from [1] and save it any place. The executable does not need any further installation, everything is already builtin, just like Putty.
Server Installation Using PHP 5 > 5.0.3 Please make sure that ext/soap is enabled. For PHP on Windows, simply add extension=php_soap.dll to your php.ini file. For PHP on Unix/Linux, please compile it with --enable-soap. Most PHP installations have SOAP activated. If there is no way of getting the SOAP extension to work you can use the PHP4 way instead.
PHP 4 or PHP 5 < 5.0.3 does not offer a (working) builtin SOAP support, and needs PEAR SOAP ([2]) installed for that matter.
To install pear, please do the following:
- create a directory "pear" in your phprojekt directory
- change the permissions of this directory to be writable for the webserver
- download the file from [3] and save it as "go-pear.php" to the pear directory
- point the browser to http://yourdomain.tld/your_phprojekt_path/pear/go-pear.php and follow the installation steps
- install the SOAP package there
Configuration
Start the Sync by clicking the executable. Enter the URL of your PHProjekt installation, for example http://mydomain.com/phprojekt/. Enter your username and password as well.
If your PHProjekt is protected with an additional htaccess password protection, please enter the values for HTTP Authentication at "HTTP Auth" and activate the checkbox "Use HTTP Basic Authentication".
Activate the items you want to synchronize. If you want to synchronize your private appointments, contacts, notes and todos as well, activate the checkbox "include private".
If everything works fine for you, and you want to have deleted items in phprojekt deleted in outlook as well, activate "delete discarded items".
SOAP Error / content types: text/html vs "text/xml"
This error happens when pear / soap is not properly installed. Please recheck your installation according to the hints above. You don't need to send any bug report, just install a working version of pear soap including all needed packages.
Trouble Shooting
We are glad if you can help us to eleminate bugs in Psync and PHProjekt. There are several little helpers for debugging purposes in Psync and PHProjekt. So if you encounter a bug, please
- activate the checkbox "Debug". you'll get a lot of annoying popup windows telling you what actually happens. please note the popup just before the error happens
- activate debugging on the server side. that is done in the file sync/soap/config.php and set the debug level to maximal debugging define('APP_DEBUG_LEVEL', 1+2+4+8+16+32+128); . Please make sure that php can write into the sync/soap directory, since the file psync_error_log is written there.
- Synchronize and wait for the bug to happen
- submit a bug report at [4] with the logfile attached
pSync.NET
pSync.NET is a rewrite based on Microsoft.NET Framework 1.1. It's on alpha stage at the moment and there is no public release at the moment.
