[Vicaya-user] JAVA RUNTIME HOWTO Vicaya 0.1.4

[Alexander E G. <lx...@po...>]

Hej again,

Casual users (non developers) are likely to have troubles running
Vicaya without the JRE's. I hope this helps.

Alex

--
CCC7 D19D D107 F079 2F3D BF97 8443 DB5A 6DB8 9CE1
--

=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
JAVA RUNTIME HOWTO
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D



What

Vicaya 0.1.4 has been released **without** including the Java Runtime
Environments (JRE's). This is a work-around.



Why

The JRE's have been removed because of some complications with the IBM
JRE on Linux. Vicaya will not run without a JRE, so if you experience
difficulties starting Vicaya 0.1.4, listen up:



How

Set the VICAYA_JAVA environment variable to point to a working JRE or
SDK (similar to the JAVA_HOME variable). Note that this is not the
java executable but the directory containing the bin/java executable.



How - Mac OS X

Mac OS X 10.3+ includes a framework similar to JRE 1.4 or JRE 1.5. The
start.sh and splash.sh scripts consider the extant frameworks. This
has not been tested. I'm eager to help, but have little knowledge in
this area.



How - Linux/Unix

Set the VICAYA_JAVA variable to your JRE. If you are running from the
command prompt, you can do a one time set such as:

export VICAYA_JAVA=3D/usr/lib/java
sh splash.sh

Or set the variable in your login profile (.bashrc .bash_profile etc).
Note that some shells may use setenv rather than export). I'm happy to
help with any Linux troubles, but I assume you know what you are doing



How - Windows

You likely already have a Java JRE or SDK installed on your machine,
otherwise, you may install one (if you do not know how, perhaps you
might consider waiting for a more stable release of Vicaya such as 0.2
or even 1.0). Here are some typical locations (expect variation on
your machine):

C:\j2sdk1.4.2_10
C:\Program Files\Java\j2re1.4.2_10
C:\Program Files\Java\jre1.5.0_06

Once you have located a JRE (or SDK), you may set your VICAYA_JAVA variable=
.
 1. Right click on "My Computer"
  2. Select "Properties" from the dropdown list
 3. Select the "Advanced" tab (top)
 4. Select the "Environment Variables" button (bottom)
 5. Select "New" under "System variables" (or Edit if you've done this befo=
re)

 6. Variable name:

VICAYA_JAVA

 7. Variable value:
       (( the path location of your JRE such as: ))

C:\Program Files\Java\jre1.5.0_06

 8. Click on "OK" in the "System Variable" window.
 9. Click on "OK" in the "Environment Variables" window.
10. Click on "OK" in the "System Properties" window.
11. Close all shell, terminal, command prompt windows.
12. Restart Vicaya
    (reopen a command prompt or
     double click the start.bat or splash.bat script)



Background

Vicaya has gone through many iterations. As such there are artifacts
of previous methodologies which while strange, have been tested and
work. The start scripts, and more specifically the determination of an
appropriate JRE, are a good example of this.

The start or splash script will configure several variables:
VICAYA_CONTENT, VICAYA_SERVER, VICAYA_ENDPORT, VICAYA_JAVA, and
others. VICAYA_JAVA is set based on the architecture of the machine
running Vicaya (your machine). The start script will search for an
appropriate JRE in the jre directory (for example, the Windows JRE is
located at vicaya/jre/win/x86/j2re1.4.2_10). Failing that, it will
seek help from the JAVA_HOME system variable. Failing that, Vicaya
will not start.

Vicaya 0.1.4 does not have the JRE's in vicaya/jre as mentioned above
(Why). Most users do indeed have a JRE on their machine. However, most
users do not have the SDK and will not likely have the JAVA_HOME
variable set.