Development Version Setup

Note: The development version of Psych Desktop is cutting/bleeding edge software. You should not use it unless you know what you are doing. You have been warned.

Checking out from subversion

In order to get a copy of psych desktop, you must have Subversion installed.

Our subversion repository is located at: http://psychdesktop.svn.sourceforge.net/svnroot/psychdesktop/

To check out a copy, run this command:

svn co http://svn.psychdesktop.net/trunk/ desktop

For write access:

svn co https://svn.psychdesktop.net/trunk/ desktop

Building

Unless you plan on installing Psych Desktop locally, you should build it. This compresses the javascript that is sent to the client so the desktop will load faster. From a terminal, navigate to the /desktop/dojotoolkit/util/buildscripts/ directory. Then run this command (for windows run build.bat instead of build.sh):

./build.sh profile=desktop action=release copyTests=false

Then, copy all contents of /desktop/dojotoolkit/release/dojo/ to /desktop/dojotoolkit/, and delete the release directory.

Upload files and change permissions

The next step is to upload the files to your server. If you are using a dedicated server, chown the /files/ directory to the web server's user. If you are using shared hosting, chmod the /files/ dir to 666 (read and write permissions for all). chmod /backend/config.php to 666 as well.

Database setup

Psych Desktop supports multiple database servers thanks to the MDB2 engine. In your choosen database server (MySQL, Oracle, etc), setup a database and a user with all permissions to that database. Then, navigate to /install/ in your web browser. Enter in the information as prompted, and then delete the /install/ dir. This is important, as someone may be able to get your database password if you don't. Also, you may want to chmod /backend/config.php to 400 for security purposes.

Alternativly Protecting /install/

You can protect /install/ by copying the ".htaccess" file from /files/ to /install/. Doing this will deny all access to /install/ until you remove the ".htaccess" file. Doing this will allow you to keep /install/ on the server for backup purposes.

Log in for the first time

The desktop is now ready for action. Log in with the username/password you gave in the installer, and your desktop is ready for use.