Sample Apache2 site-file

From SynchroEdit

Sample Apache2 site-file

As of SynchroEdit client version 0.3 and above, the server has to be able to handle Perl CGI execution. The PHP requirement is as of version 0.3 removed from the solution.

This is a sample Apache2 site file (which in most sane linux distros resides in /etc/apache2/sites-available – if someone could fill this out with details on distros which handle this differently, that'd be nice):

<VirtualHost *>
     ServerName synchro.mydomain.com
     ServerAdmin webmaster@mydomain.com

     DocumentRoot /location/of/client/files/

     <Directory />
             Options FollowSymLinks
             AllowOverride None
     </Directory>
     <Directory /location/of/client/files/>
             Options Indexes FollowSymLinks MultiViews ExecCGI
             AddHandler cgi-script .cgi
             AllowOverride None
             Order allow,deny
             allow from all
     </Directory>

     ScriptAlias /cgi-bin/ /usr/lib/cgi-bin/

     ErrorLog /var/log/apache2/synchroedit-error.log

     # Possible values include: debug, info, notice, warn, error, crit,
     # alert, emerg.
     LogLevel warn

     CustomLog /var/log/apache2/synchroedit-access.log combined
     ServerSignature On
</VirtualHost>

Remember to restart Apache after modifying the site file.

You can test this by going to http://synchro.mydomain.com/handshake.cgi. You should get something along the lines of:

   HAVE SID1 3600 GDAY:AUTH:DWIN:ACLR: 
   END

You should not get something like:

#!/bin/perl
[code stuff]

If you get something like this, then your web server is set up correctly, but your SynchroEdit server is not responding on the given port:

 Socket creation failed at /var/www/apache2-default/dev/handshake.cgi line 35.

If you get an "Internal Server Error (5xx)", it usually means you need to change the permissions (chmod +x) for *.cgi in the client directory: