Installing multiple LabTrove instances
It is possible to install LabTrove in such as way that you can have several separate Troves on a single Web Server on a single machine. You can use the same method to have the Trove available as a section on an existing website. The Trove appears to be located in a sub-directory of the main site.
Follow the instructions in this section to add the Trove to a path.
Setting up the configuration file
You must set up the blog_path property in the Trove configuration file:
- Run the following command to open the Trove configuration file:
- Edit the configuration file to change the $ct_config['blog_path'] to /some-path/ where some-path is the location where you want the Trove to be displayed.
Changing the Apache Web Server configuration
Use the following instructions to add the Trove site to the Apache Web Server configuration:
- Run the following command to open the Apache Web Server configuration file:
nano /etc/apache2/sites-available/example.labtrove.org, where example.labtrove.org is the location of your Trove.
- If you have already set up a single instance with URLs like http://example.labtrove.org/, the file should look something like this:
<VirtualHost *:80> ServerAdmin webmaster@localhost ServerName example.labtrove.org DocumentRoot /home/www/hosts/example.labtrove.org/docs <Directory /> Options FollowSymLinks AllowOverride None </Directory> <Directory /home/www/hosts/example.labtrove.org> Options Indexes FollowSymLinks MultiViews AllowOverride All Order allow,deny allow from all </Directory> </VirtualHost>
If you want to hosts two sites with URLs that look like http://example.labtrove.org/first-site/' and http://example.labtrove.org/second-site/, where the Labtrove docs/ folder for these are at /home/www/hosts/first-site/docs/ and /home/www/hosts/second-site/docs/ you will need change the file to the following. (Changes are highlighted in bold).
<VirtualHost *:80> ServerAdmin webmaster@localhost ServerName example.labtrove.org DocumentRoot /home/www/hosts <Directory /> Options FollowSymLinks AllowOverride None </Directory> Alias /first-site/ /home/www/hosts/first-site/docs/ <Directory /home/www/hosts/first-site/docs> Options Indexes FollowSymLinks MultiViews AllowOverride All Order allow,deny allow from all </Directory> Alias /second-site/ /home/www/hosts/second-site/docs/ <Directory /home/www/hosts/second-site/docs> Options Indexes FollowSymLinks MultiViews AllowOverride All Order allow,deny allow from all </Directory> </VirtualHost>
After reloading Apache, (sudo service apache2 reload), you should have two separate Troves hosted at:
If you try to access just http://example.labtrove.org/ you will most likely get a forbidden page. If you want, you could add a landing page by writing an html page in /home/www/hosts/index.html
What to do next
- Applying patches to a LabTrove instance
- Configuring a LabTrove Instance
- Administering LabTrove
- Troubleshooting a LabTrove instance