Praya Installation
------------------

These instructions are available at
http://praya.sourceforge.net/install.html

Praya Requirements

    * Compliant Java Runtime Environment or Java Development Kit with JFC.
      Examples:
          * Sun's J2SE 1.2
          * Sun's J2SE 1.3
          * Sun's J2SE 1.1 with JFC 1.1.1
          * IBM's Java 1.3
          * IBM's Java 1.1.8 with JFC 1.1.1
      Examples of non-functional Java platforms:
          * Kaffe

Java Web Start

   1. If you haven't already, download Java Web Start from
      http://java.sun.com/cgi-bin/javawebstart-platform.sh
      and then install it.

      Make sure it works by trying out some of the demos at
      http://java.sun.com/products/javawebstart/demos.html

   2. Go to the Praya download page
      http://praya.sourceforge.net/download.html
      and click on "Any Platform" (using java web start).
   3. The Java Web Start splash screen should display for a while.
   4. Java Web Start will then download jar files from
      praya.sourceforge.net if you don't already have them.
   5. If this is the first time that you are using the Web Start
      launcher for praya, a dialog box will appear that looks
      something like this:

      -----------------------------------------------------------------
      | This application is requesting unrestricted access to your    |
      | local machine and network.                                    |
      |                                                               |
      | Do you want to install and run: Praya                         |
      | Signed and distributed by: Praya Build Process                |
      |                                                               |
      | Warning: Failed to verify the authenticity of this            |
      | certificate. No assertions can be made of the origin or       |
      | validity of the code.                                         |
      |                                                               |
      | It is highly recommended not to install and run this code.    |
      |                                                               |
      |                                      [Start] [Details] [Exit] |
      -----------------------------------------------------------------

   6. If you want to use the Java Web Start strategy for launching Praya, go
      ahead and click "Start," in spite of the dire-looking warnings. If you
      would like to donate money toward getting rid of that dire warning box
      (it will take $200 to get a developer certificate from Thawte), please
      contact me, or use the Amazon Honor System

      http://s1.amazon.com/exec/varzea/pay/T1CK3CH9X2S3UO

      to contribute.

   7. After running the program successfully once, you will no longer need to
      download the same jar files again.

Windows 95, 98, NT, 2000

If you already have Java 1.2 or higher installed on your machine:

   1. If you don't already have a program to unpack .zip files,
      download Winzip from

      http://www.winzip.com/

      and install it.

   2. Download the Any Platform (.zip file) from the download page.

      http://praya.sf.net/download.html

   3. Unzip the praya package file that you just downloaded into a
      directory, for example, your desktop.

   4. A folder named praya-x.yy will appear (where x.yy is the version
      number of praya)

   Praya is now installed. To run praya:

   5. Open the praya-x.yy folder
   6. Launch "praya.jar" (it is probably labeled "praya")

If you do not have Java 1.2 or higher installed on your machine, you have a few
choices:

   1. Get a Java Virtual Machine by yourself
         1. Download and install the Java Runtime Environment. This
            can be found at:
            http://www.javasoft.com./j2se/1.3/jre/download-windows.html

         2. Now, follow the directions above, because you already have
            Java 1.2 or higher installed on your machine.

   2. Use a bundled JRE package
         1. If you don't already have a program to unpack .zip files,
            download and install Winzip

            http://www.winzip.com/

         2. Download one of the Windows (bundled with JRE) packages
            from the download page.

            http://praya.sf.net/download.html

            Save it in a directory, for example, on your desktop.
         3. Unzip the praya package file that you just downloaded into
            a directory, for example, your desktop.
         4. A folder named praya-x.yy will appear (where x.yy is the
            version number of praya)

         Praya is now installed. To run praya:

         5. Open the praya-x.yy folder
         6. Launch "praya.bat" (it is probably labeled "praya")

Linux Download

If you already have Java 1.2 or higher installed on your machine, you have a
few choices

   1. Use the rpm version
          * Download the Linux Architecture-Independent RPM from the download
            page.

            http://praya.sf.net/download.html

         1. Open a terminal window
         2. Change into the directory containing the RPM. For instance, if you
            downloaded the RPM into /tmp, execute the following command:

            cd /tmp

         3. Become the super-user
            su
         4. Install the RPM:
            rpm -Uvh praya-*.noarch.rpm
         5. Exit the super-user shell:
            exit
         6. Run the program:
            praya
   2. Use the .tar.gz or .tar.bz2 version
         1. Download the Any platform (.tar.gz file) or Any platform (.tar.bz2
            file) from the download page.

            http://praya.sf.net/download.html
         2. Open a terminal window
         3. Change into the directory containing the RPM. For instance, if you
            downloaded the RPM into /tmp, execute the following command:
            cd /tmp
         4. Unpack the archive:

            .tar.gz command:
            gzip -dc praya-*-java.tar.gz | tar xvf - .tar.bz2 command:
            bzip2 -dc praya-*-java.tar.bz2 | tar xvf -
         5. Run the program:
            java -jar praya-*/praya.jar

If you do not have Java 1.2 or higher installed on your machine:

   1. Open a terminal window
   2. Download JRE 1.3 for Linux (these instructions assume that you get the
      RedHat RPM shell script)

      http://java.sun.com/j2se/1.3/jre/download-linux.html
   3. Change into the directory containing the RPM. For instance, if you
      downloaded the RPM into /tmp, execute the following command:
      cd /tmp
   4. Become the super-user
      su
   5. Install the Java RPM:
      rpm -Uvh j2re-1.3.0-linux.i386.rpm
   6. Go to the download page

      http://praya.sf.net/download.html

      and download the "Linux Architecture-Independent RPM."
   7. Change into the directory containing the RPM. For instance, if you
      downloaded the RPM into /tmp, execute the following command:

      cd /tmp

   8. Install the Praya RPM:
      rpm -Uvh praya-*.noarch.rpm
   9. Exit the super-user shell:
      exit
  10. Run the program:
      env PATH=/usr/java/jre1.3/bin:$PATH praya

Other Java-Enabled Platform Download

   1. Download and install a java runtime for your platform. Sun keeps a list
      of known java ports at

      http://java.sun.com/cgi-bin/java-ports.cgi

      You may want to start there.

   2. Download the Any platform (.tar.gz file) or Any platform (.tar.bz2 file)
      from the download page.

      http://praya.sf.net/download.html

   3. Open a terminal window

   4. Change into the directory containing the RPM. For instance, if you
      downloaded the RPM into /tmp, execute the following command:

      cd /tmp

   5. Unpack the archive:

      .tar.gz command:
      gzip -dc praya-*-java.tar.gz | tar xvf - .tar.bz2 command:
      bzip2 -dc praya-*-java.tar.bz2 | tar xvf -
   6. Run the program:
      java -jar praya-*/praya.jar
