Title: Running CayenneModeler

	

<P>Follow the instructions below appropriate for the type of OS and Cayenne distribution that you have:</P>

<H3><A name="RunningCayenneModeler-MacOSX"></A>Mac OS X</H3>

<P>CayenneModeler.app comes as a part of the Mac distribution and is located at the root of the disk image.</P>

<H3><A name="RunningCayenneModeler-WindowsOS"></A>Windows OS</H3>

<P>Windows distribution of Cayenne contains <TT>CayenneModeler.exe</TT> file in the <TT>bin</TT> directory. To start the Modeler doubleclick this file. Note that you still need a JDK version 1.4 or newer installed to be able to run the Modeler.</P>

<H3><A name="RunningCayenneModeler-CrossPlatformModeler%28LinuxoranyotherOS%29"></A>Cross Platform Modeler (Linux or any other OS)</H3>

<P>CayenneModeler is a regular Java application that can be run on JDK 1.4 or newer. It can be started in two different ways:</P>

<P>1. By running <TT>cayenne-modeler.jar</TT>:</P>

<DIV class="preformatted panel" style="border-width: 1px;"><DIV class="preformattedContent panelContent">
<PRE>cd [cayenne_distro_dir]/lib/modeler
java -jar cayenne-modeler.jar</PRE>
</DIV></DIV>

<P>2. Or by executing a startup script. </P>

<P>To use one of the scripts, first set the following environment variables:</P>

<UL>
	<LI><TT>JAVA_HOME</TT> - should point to your JSDK 1.4 installation. It may already exist in the environment.</LI>
	<LI><TT>CAYENNE_HOME</TT> (optional) - should point to the directory where your unpacked Cayenne (a directory named like <TT>cayenne&#45;[release-suffix]</TT>). If <TT>CAYENNE_HOME</TT> is undefined, scripts will still work in most environments, guessing the right distribution location.</LI>
</UL>


<P>And then run the scripts:</P>

<P>Windows:</P>

<DIV class="preformatted panel" style="border-width: 1px;"><DIV class="preformattedContent panelContent">
<PRE>%CAYENNE_HOME%\bin\modeler.bat</PRE>
</DIV></DIV>

<P>UNIX:</P>

<DIV class="preformatted panel" style="border-width: 1px;"><DIV class="preformattedContent panelContent">
<PRE>$CAYENNE_HOME/bin/modeler.sh</PRE>
</DIV></DIV>