xlawrence 2005/01/26 20:48:13 CET
Modified files:
. README.txt
Log:
Added troubleshooting section
Revision Changes Path
1.8 +39 -2 uwcal_JSR168/README.txt
http://jahia.mine.nu:8080/cgi-bin/cvsweb.cgi/uwcal_JSR168/README.txt.diff?r1=1.7&r2=1.8&f=h
Index: README.txt
===================================================================
RCS file: /home/cvs/repository/uwcal_JSR168/README.txt,v
retrieving revision 1.7
retrieving revision 1.8
diff -u -r1.7 -r1.8
--- README.txt 14 Jan 2005 14:36:45 -0000 1.7
+++ README.txt 26 Jan 2005 19:48:13 -0000 1.8
@@ -97,34 +97,52 @@
================================================================================
1) Install sync4j 2.2 (or above), Tomcat 5.0.* and Jetspeed-2.
+
2) Install the sync4j syncAdmin tool.
+
3) From the syncAdmin tool, create 2 new users 'caluser' and 'caladmin', 2
new
devices 'SynchTest1' and 'SynchTest2', and add a new Principal
'caluser/SynchTest1'.
+
4) Customize 'project.properties' so it reflects your system (change tomcat
install direcrory and sync4j sync server install directory).
+
5) > maven quickStart (to build and deploy the software)
+
6) go to the sycn4j syncServer installation directory and install the 2 .s4j
modules by updating the install.properties file
(modules-to-install=calModuleOutlook,calModule) and running the install
- script.
+ script. Once installed, use the SyncAdmin tool to create 2 new SyncSource
+ instances. The instance of CalendarSyncSource should have an URI =
calServer
+ and the instance of CalendarSyncSourceOutlook should have an URI =
+ calServerOutlook.
+
7) > maven server.jms (start the JORAM JMS server)
+
8) > maven server.jms.config (create necessary JMS ressources on the JMS
server)
+
9) Start the database server(s) (for sync4j, uwCal and jetspeed-2)
+
10) Create the database for the calServer application (go to calClient/conf
to
get the Hibernate properties and schema that will tell you how to create
the
db (schema.ddl))
+
11) start tomcat FROM the sync4j sync server root directory
+
12) > maven calClient
+
13) > maven synchClient
+
14) From the synchClient, create a new .ics empty file, and edit the
communication settings:
sync server url: http://localhost:8080/sync4j/sync
userName : caluser
passWord : <the one you chose in step 3>
deviceID : SynchTest1
+
15) From the uwCal quickStart directory, type: ant synchtest.initdb to create
the uwCal DB.
+
16) Press the Synchronize button and check the content of the .ics file you
created at step 14.
@@ -133,7 +151,26 @@
================================================================================
-5. Links
+5. TroubleShooting
+================================================================================
+
+If the synchClient program starts spitting out Exceptions like this:
+
+java.lang.NullPointerException
+ at sync4j.syncclient.spdm.NodeImpl.getValue(NodeImpl.java:118)
+ at
sync4j.syncclient.spds.SyncManager.updateLastAnchor(SyncManager.java:2119)
+ at sync4j.syncclient.spds.SyncManager.sync(SyncManager.java:633)
+ at
org.jahia.suite.calendar.syncClients.SyncClient.sync(SyncClient.java:275)
+ at
org.jahia.suite.calendar.syncClients.SyncClientFrame.run(SyncClientFrame.java:705)
+ at java.lang.Thread.run(Thread.java:534)
+
+Try deleting the CVS directory in
"uwcal_JSR168/syncClient/conf/sync4j/spds/sources"
+
+This problem is related to Sync4j and their implementation of the
SyncManager.
+
+
+================================================================================
+6. Links
================================================================================
Maven: http://maven.apache.org/
