Sitesupra Manual: Installing SiteSupra in a hosting mode

Installing SiteSupra in a hosting mode

Starting from version 3.1.42 SiteSupra allows to use 1 SiteSupra engine for many websites (hosting mode). That is particularly important for hosting installations, when bulk SiteSupra update is required. As a result, changes made to 1 SiteSupra engine affect many websites that use that engine.

To install SiteSupra in a hosting mode follow the below instructions.

Create a directory for SiteSupra engine on the server's hard drive. Lets assume it is /www/engine. Extract SiteSupra engine archive into this directory. After extracting the archive you should have structure similar to the one shown below:

root@joule:/www/engine# ls -l
total 128
-rw-rw----    1 www      web          2522 Mar 10 11:43 index.php
drwxr-xr-x    1 www      web          4096 Mar 10 14:50 supra

Create directory /www/yoursite and copy your existing website or SiteSupra demo site (including SiteSupra configuration files). Then open Apache configuration and allow the following symbolic links. You may use either Options FollowSymLinks or Options SymLinksIfOwnerMatch:

<Directory /www>
    Options FollowSymLinks
#    Options SymLinksIfOwnerMatch
</Directory>

Add the below lines to virtual host configuration:

php_admin_flag safe_mode_gid on 
php_admin_value open_basedir /www/engine/:/www/yoursite/

Do not forget to restart Apache.

Go to /www/yoursite and create symbolic links to /www/engine/supra and /www/engine/index.php. Open SiteSupra configuration file (.htsupra) and change supra parameter of $suCONF array to match symbolic link name to /www/engine/supra directory.

Troubleshooting

If SiteSupra doesn't start check if Apache has been restarted or Apache has at least "read" rights to the symbolic links and /www/engine directory.