If you use these install instructions, please cite: Graham G.M. Alvare, Natalie K. Björklund, John Schellenberg, Richard Sparling, Brian Fristensky; Koala: Overlaying Local Gene Expression Data on BioCyc Pathway Diagrams

Install Koala

  1. Download Koala




  2. Import koala.sql into your database server

  3. Copy the files under koala-biocyc to your pathway tools user home directory (by default this is /Users/Your username/ptools-local/html - and change all references of localhost/koala and localhost%2Fkoala (the url-encoded version of localhost/koala - %2F is a '/' character) to your web server's address for koala

  4. Create or alter your ptools-init.dat file to contain the line:

    WWW-Html-Root-Dir /Users/Your username/ptools-local/html+/Users/Your username/pathway-tools/aic-export/htdocs

    Where /Users/Your username/ptools-local/html is the path of your Pathway Tools user HTML directory, and /Users/Your username/pathway-tools/aic-export/htdocs is the path of your Pathway Tools installation HTDOCS directory.

  5. Copy the contents of Koala-apache into your Apache web server's htdocs directory (/Library/WebServer/Documents) and alter the globals.php to use your database connection information

  6. Ensure your PHP version has MySQL and SSL enabled, and ensure that Apache supports .htaccess files

  7. Run the following command on the command line to generate a .htpasswd file for password protecting Koala. The .htpasswd file will reside in the same directory as the other Apache files, for alternate password protection, please see Apache documentation on .htaccess files)
    htpasswd -bc /Library/WebServer/Documents/.htpasswd username password

  8. You are now ready to start your Pathway Tools web server. Please see the following page for detailed instructions.

  9. Open firefox and follow the screenshots below to verify the installation