Phenotype installation is easy, as long as all system requirements are present:

Get the current version from Sourceforge, unpack it and point your webroot to the directory htdocs¹⁾ within (!) the just downloaded package.

Make sure your webserver has write access to xyz/htdocs, xyz/_phenotype/application, xyz/_phenotype/cache and xyz/_phenotype/temp. Then start the Installer and follow the directions on screen.

If you’re using windows and are novice to web application development, we suggest using XAMPP for a start. The XAMPP installer will install all necessary components (Apache, MySQL, PHP) for you. Usally default configuration is appropriate, you just have to additionally enable mod_rewrite (look for a file called httpd.conf). If you’re using Linux or Mac we expect you to know what you’re doing … .

Just watch this video showing a typical linux installation.

Internal Server Error

If you get an Internal Server Error after installation, your webserver probably does not understand the mod_rewrite directives in the .htaccess file.

500 Internal Server Error

Most likely the DB is missing tables/fields or PT_DEBUG is set to 0 and you’re not logged on.

You can’t see any images

Most likely wrong path setup.

Warnings and Error messages all over the screen

Most likely wrong file permissions.

Phenotype installs one superuser for you. Your are strongly encouraged to give any superuser a strong password and not leave it to the defaults.

A superuser is necessary for developing Phenotype applications since it enables access to the configuration mode (and with that full access to all files on your web server!).

For security reasons you cannot assign the right of beeing a superuser via backend. If you want an additional user to be superuser, you must locate it’s record in the mysql table user and change the value of the field usr_su to 1.

Back to Documentation Overview...