The Syncshare Server can only be run with J2SDK/JRE 1.4.x

Recommended Installation on Linux Systems in a production environment

This is the prim and proper way to install the Kizna Server on linux - keeping in mind the
current standards on this operating system.

1. Install java if it is not yet installed.

2. Unzip the syncshare compressed tar file (in a folder of your choice) by typing
tar zxvf syncshare-3.1.tar.gz

3. Now type the following commands
cd kizna3.1/lib
(you will need to have root access for the below commands)
mkdir usr/share/kizna
cp *.jar /usr/share/kizna/
mkdir /var/kizna
(Copies the startup scripts to /var/kizna:)
cd ../bin
cp * /var/kizna

7. cd to the kizna server data-directory
cd /var/kizna

8. create a file called .kizna_password (do not miss the dot in the beginning of filename) containing the admin password :
echo <yourpasswordhere> > .kizna_password

9. Generate the kizna server admin password by typing
java -jar /usr/share/kizna/adminpw.jar < .kizna_password

10. Finally, start kizna server by running the startSyncshare.sh script
(you should still be in the /var/kizna directory)



 Enabling acceptance of connections through firewall (for Apache)
********************************************************************
In order to allow syncshare clients to make connections to the syncshare server from within the firewall,
mod_proxy module needs to be enabled in Apache's httpd.conf.

1. Enable the mod_proxy module in apache’s httpd.conf
(remove the hashes[#] before the LoadModule and AddModule directives for mod_proxy in httpd.conf.
i.e. you should have the following two lines :

LoadModule proxy_module modules/libproxy.so
AddModule mod_proxy.c

2. You need to do enable the <IfModule mod_proxy> section (remove the #)
3. Add the following line in the IfModule mod_proxy section

ProxyPass   /kizna-http http://localhost:8199/kizna-http

4. In the end you must have your mod_proxy section looking like this :
<IfModule mod_proxy.c>
..
ProxyPass /kizna-http http://localhost:8199/kizna-http
..
</IfModule>
# End of proxy directives.

5. Restart apache.

If this worked correctly, then you should be able to access this url : http://kiznaServerUrl/kizna-http
e.g. if Kizna server were to be running in a machine with host name - mysyncshare.org, you would check
the url http://mysyncshare.org/kizna-http

** I had to use http://localhost.localdomain:8199  -- it would not work w/out the port number.
** Also, do NOT have apache already started, this causes all kinds of errors and syncShare would not start.
** When you go to the above address, you see a page telling you syncShare is running, etc.