Installing a LabTrove Instance
This section of the Knowledge Base is currently being worked on!
You might encounter placeholder topics as we continue our work, and the section's structure and content may evolve over time as additional material is incorporated.
LabTrove is developed on the Linux platform Debian, currently Debian "Squeeze" 6. These installation instructions are for Debian, but have also been tested successfully with Ubuntu Server 10.4 LTS, which is based on the same distro as Debian.
There are two options for how to install a Trove:
- As a virtual host so that you have one DNS name per install.
- Onto a path as an alias.
The recommended option is to install the Trove as a virtual host. You might want to choose to install the on a path option if you plan to install multiple Troves on a single DNS name or as part of an existing website. See the instructions in Installing multiple LabTrove instances, for information on how to install your Trove as part of an existing website.
Before you begin installing
There are some steps that you should take to ensure your system is ready before you start installing the components required for LabTrove:
- Ensure that your apt package manager is up to date by running the command: apt-get update
- (Optional) If you are running on a VMware instance:
- Install the VMware Tools by clicking VM -> Install VMware Tools from the VMware Workstation menu.
- If you are not running software RAID, run the following commands to config the RAID admin for LabTrove:
/etc/init.d/mpt-statusd stop
echo RUNDAEMON=no > /etc/default/mpt-statusd
- For security purposes you should disable the root login. To disable the root login you must edit the
/etc/ssh/sshd_config
file, and change thePermitRootLogin
value tono
. - Finally install the Network Time Protocol (NTP) to set the correct time on the system by running the command:
apt-get install ntp
If you want to manually install the Apache Web Server, MySQL database, and other prerequisite software that LabTrove needs, see 'Manually installing prerequisite software' below. Alternatively you can install an all-in-one bundle that includes all the prerequisite software and the LabTrove source code.
If you have not already installed the prerequisite software manually, you must download the all-in-one bundle which provides all the prerequisite libraries and software as a Debian package. To download the Debian package, enter the following commands:
wget http://www.labtrove.org/files/packages/labtrove-deps_2.2.6-11_all.deb
dpkg -i labtrove-deps_2.2.6-11_all.deb
apt-get -f install
Installing the Trove as a virtual host
Complete the following steps to install the Trove as a virtual host:
Create a directory for the Trove in the location you want to install it. For example, if the directory to install the Trove is /home/www/hosts/example.labtrove.org
, then run the following command to create the new folder:
mkdir -p /home/www/hosts/example.labtrove.org
Take a copy of the LabTrove source from the LabTrove website at http://www.labtrove.org/getlabtrove/
Change to the directory where the Trove is installed. For example, if you installed the Trove in the /home/www/hosts/example.labtrove.org directory
, run the command:
cd /home/www/hosts/example.labtrove.org
Manually installing prerequisite software
Installing LabTrove
Installing multiple LabTrove instances
Installing ChemSpider Plugin for LabTrove
Migrating LabTrove from a previous version
Some more content
And some more
Related links: