[[BackLinksMenu]]
= Installation Instructions =

== On all machines ==

Download the zipped files from the Sophie download page and unzip to create the directory ''sophie2-alpha-3''; inside it, you'll find the directory ''sophie2-platform'', where all files are. Sophie Author, Sophie Reader, and Sophie Server share many files; they can all be kept in the same ''sophie2-platform'' directory.

For instructions on running Sophie Server, see the [wiki:ITERATION_11/Release/UserDocumentation/SophieServer/01_WorkingWithSophieServer Sophie Server] page.

== Windows ==

Run the file ''sophie2-alpha-4\sophie2-platform\sophie2_author.bat'' to run Sophie Author.

Run the file ''sophie2-alpha-4\sophie2-platform\sophie2_reader.bat'' to run Sophie Reader.

== Linux ==

Run the file ''sophie2-alpha-4/sophie2-platform/sophie2_author.sh'' to run Sophie Author.

Run the file ''sophie2-alpha-4/sophie2-platform/sophie2_reader.sh'' to run Sophie Reader.

== Mac OS X ==

Older Intel-based Macs (with 32-bit processors) that are not running Snow Leopard (OS 10.6) don't have Java 6 installed. This release is dependent upon Java 6; future releases will solve this incompatibility. However, Sophie 2 can be run on these machines if X11 is installed by installing !SoyLatte, an open source version of Java 6. To run Sophie 2:

 1. Go [http://landonf.bikemonkey.org/static/soylatte/ here] to download !SoyLatte; read the instructions there.[[BR]]
 2. Unzip the !SoyLatte zip file.[[BR]]
 3. Open Terminal and move the !SoyLatte directory to /usr/bin/: ''mv soylatte16-i386-1.0.3 /usr/bin/''.[[BR]]
 4. You may need to add the following to your ''.profile'' file to add SoyLatte to your path and to set the ''JAVA_HOME'' variable:

{{{
export PATH=/usr/local/soylatte16-i386-1.0.3/bin:$PATH;
export PATH=/usr/local/apache-maven-2.1.0/bin:$PATH;
export PATH=/opt/subversion/bin:$PATH;
export JAVA_HOME=/usr/local/soylatte16-i386-1.0.3;
}}}

 5. Unzip the application files by double clicking ''sophie2_author.zip'' and ''sophie2_reader.zip'' in the ''sophie2-alpha-4/sophie-platform'' folder.
 6. Open ''sophie2_author'' to run Sophie Author; open ''sophie2_reader'' to run Sophie Reader.

On newer Macs (with 64-bit processors) or older Macs running Snow Leopard (OS 10.6), Sophie 2 can be run without installing !SoyLatte. To do this, it's necessary to make sure that you're using Java 6. 

 1. Open the application Java Preferences in /Applications/Utilities/Java/ and in the applications subpanel, drag ''Java SE 6'' to the top:

[[Image(source:/trunk/sophie2-platform/doc/userdoc-images/RELEASE_3/OSXJavaPreferences.png)]]

 2. Unzip the application files by double clicking ''sophie2_author.zip'' and ''sophie2_reader.zip'' in the ''sophie2-alpha-4/sophie-platform'' folder.
 3. Open ''sophie2_author'' to run Sophie Author; open ''sophie2_reader'' to run Sophie Reader.

== Sophie Server ==

For instructions on running Sophie Server, see [wiki:ITERATION_11/Release/UserDocumentation/SophieServer/02_AdministeringSophieServer here].