Archive Ensembl HomeArchive Ensembl Home
Home > Help & Documentation

Running an Ensembl Website

This section outlines how to go about the day-to-day running of an Ensembl website.

Starting the Ensembl website

  1. Check that MySQL is running. If not, you can start it:
    /data/mysql/bin/mysqld_safe --user=mysqldba &
    You should change the /data/mysql and mysqldba in the command above to the install path and user you chose when you installed MySQL.
  2. Start the web server:
    /usr/local/apache2/bin/httpd -d /usr/local/ensembl
    where /usr/local/ensembl is your server-root.

    Note that it is important that you start MySQL before you start the website. The startup scripts for the site rely on the databases being available, as they compile lists of available data at this point. You should now be able to point a web-browser at your server and see the Ensembl homepage.

    If you have already started the site - and then reconfigured it you will need to delete the config.packed file (and if you change mart configuration martconf.packed and martRegistry.xml files) in the conf directory before restarting.

Stopping the Ensembl website

  1. To stop the web server:
    kill `cat /usr/local/ensembl/logs/HOSTNAME.httpd.pid`
    where /usr/local/ensembl is your server-root, and HOSTNAME is whatever the hostname is of the machine you are running the server on. Note the punctuation marks are backticks and not singlequotes.
  2. To stop MySQL:
    /data/mysql/bin/mysqladmin shutdown

Troubleshooting

The best way of troubleshooting is to watch the Apache error_log and look for exactly what the problem is. You can do this with the command:

$ tail -f logs/error_log

from the server-root. It is often obvious what the error is, especially if it is due to file permissions or a missing Perl module.

If you have email errors turned on, then you will be receiving some additional information via that route. Please contact HelpDesk if you need assistance. Any details of the error, relevant sections from the error_log, etc, will be of help in tracking down your problem.