Installation"

From Documentation
Line 3: Line 3:
  
 
== Prerequisite ==
 
== Prerequisite ==
 +
There are three pieces of software that you need to download and install in order to use ZK Studio.
 +
 +
=== Java SE Development Kit (JDK) ===
 +
Java version 5 or 6 is required in order to run Eclipse, you can download either of them by following the links below:
 +
 +
JDK 6:
 +
:[http://java.sun.com/javase/downloads/index.jsp http://java.sun.com/javase/downloads/index.jsp]
 +
 +
JDK 5:
 +
:[http://java.sun.com/javase/downloads/index_jdk5.jsp http://java.sun.com/javase/downloads/index_jdk5.jsp]
 +
 +
select which "'''''Java SE Development Kit (JDK)'''''" you want to download, please do '''not''' select the JRE.
 +
 +
 +
Installation Instructions:
 +
 +
:[http://java.sun.com/javase/6/webnotes/install/index.html http://java.sun.com/javase/6/webnotes/install/index.html]
 +
 +
:[http://java.sun.com/j2se/1.5.0/install.html http://java.sun.com/j2se/1.5.0/install.html]
 +
 +
<br/>
 +
 +
=== Eclipse IDE for Java EE Developers ===
 +
ZK-Studio is an Eclipse Plug-in, therefore you must install Eclipse. We recommend using the '''''''Eclipse IDE for Java EE Developers''''''' package, currently '''v3.5(Galileo)'''
 +
 +
:[http://www.eclipse.org/downloads/packages/eclipse-ide-java-ee-developers/galileor http://www.eclipse.org/downloads/packages/eclipse-ide-java-ee-developers/galileor]
 +
 +
and '''v3.4(Ganymede)''':
 +
 +
:[http://www.eclipse.org/downloads/packages/eclipse-ide-java-ee-developers/ganymedesr1 http://www.eclipse.org/downloads/packages/eclipse-ide-java-ee-developers/ganymedesr1]
 +
 +
 +
'''Install:'''
 +
 +
Extract "eclipse" from the downloaded zip file to a location of your choice. To make sure Eclipse can run on your system, execute '''eclipse.exe''' (in windows) or '''eclipse''' (in unix ). You can locate these files in your extracted eclipse folder.
 +
 +
We recommend setting Eclipse's default JRE to JDK, please refer to the Setup/Preferences section in [http://www.eclipse.org/webtools/community/tutorials/BuildJ2EEWebApp/BuildJ2EEWebApp.html '''''WTP Tutorials – Building and Running a Web Application'''''].
 +
 +
'''Tips:'''
 +
:1. We recommend modifying some parameters in the configuration file eclipse.ini which will result in performance gain, please refer [http://www.eclipsezone.com/eclipse/forums/t61618.html here] and [http://blog.xam.dk/archives/68-Eclipse-and-memory-settings.html here].
 +
 +
:2. We also recommend using the Java Development Kit (JDK) as the default JRE for Eclipse IDE, please follow [[Setting_Default_JRE_In_Eclipse#Setup_Default_JRE_as_JDK | these instructions]] to make the JDK the default JRE.
 +
 +
 +
<br/>
 +
 +
=== Application servers ===
 +
Before developing web applications in Java using the ZK Ajax Framework, you need to install an application server. Apache Tomcat is one of the most popular Web containers. Tomcat versions 5.5 and 6 are supported and can be downloaded at the following link [http://tomcat.apache.org/ http://tomcat.apache.org/].
 +
 +
'''Install:'''
 +
 +
Download the zip file of Tomcat distribution and extract it to a proper location (with no illegal characters or space in the path). Tomcat requires configuration before it can be used with Eclipse, this process is described in the following link 「[[Studio_userguide#Running_the_ZUL_File | Running the ZUL File]]」.
 +
 +
'''Tips:'''
 +
 +
If you not only want to develop Web Applications, but also need to deploy them on Apache Tomcat, links to the official installation instructions for directly running Apache Tomcat in your environment are provided below:
 +
 +
v6.x:
 +
 +
:[http://tomcat.apache.org/tomcat-6.0-doc/setup.html http://tomcat.apache.org/tomcat-6.0-doc/setup.html]
 +
 +
v5.5:
 +
 +
:[http://tomcat.apache.org/tomcat-5.5-doc/setup.html http://tomcat.apache.org/tomcat-5.5-doc/setup.html]
 +
 
== Installation Guide ==
 
== Installation Guide ==
 
== Activate ZK Studio ==
 
== Activate ZK Studio ==

Revision as of 04:20, 3 December 2010

Support Version (Eclispe, ZK)

Eclipse 3.5, Eclipse 3.6, RAD, MyEclipse

Prerequisite

There are three pieces of software that you need to download and install in order to use ZK Studio.

Java SE Development Kit (JDK)

Java version 5 or 6 is required in order to run Eclipse, you can download either of them by following the links below:

JDK 6:

http://java.sun.com/javase/downloads/index.jsp

JDK 5:

http://java.sun.com/javase/downloads/index_jdk5.jsp

select which "Java SE Development Kit (JDK)" you want to download, please do not select the JRE.


Installation Instructions:

http://java.sun.com/javase/6/webnotes/install/index.html
http://java.sun.com/j2se/1.5.0/install.html


Eclipse IDE for Java EE Developers

ZK-Studio is an Eclipse Plug-in, therefore you must install Eclipse. We recommend using the ''Eclipse IDE for Java EE Developers'' package, currently v3.5(Galileo)

http://www.eclipse.org/downloads/packages/eclipse-ide-java-ee-developers/galileor

and v3.4(Ganymede):

http://www.eclipse.org/downloads/packages/eclipse-ide-java-ee-developers/ganymedesr1


Install:

Extract "eclipse" from the downloaded zip file to a location of your choice. To make sure Eclipse can run on your system, execute eclipse.exe (in windows) or eclipse (in unix ). You can locate these files in your extracted eclipse folder.

We recommend setting Eclipse's default JRE to JDK, please refer to the Setup/Preferences section in WTP Tutorials – Building and Running a Web Application.

Tips:

1. We recommend modifying some parameters in the configuration file eclipse.ini which will result in performance gain, please refer here and here.
2. We also recommend using the Java Development Kit (JDK) as the default JRE for Eclipse IDE, please follow these instructions to make the JDK the default JRE.



Application servers

Before developing web applications in Java using the ZK Ajax Framework, you need to install an application server. Apache Tomcat is one of the most popular Web containers. Tomcat versions 5.5 and 6 are supported and can be downloaded at the following link http://tomcat.apache.org/.

Install:

Download the zip file of Tomcat distribution and extract it to a proper location (with no illegal characters or space in the path). Tomcat requires configuration before it can be used with Eclipse, this process is described in the following link 「 Running the ZUL File」.

Tips:

If you not only want to develop Web Applications, but also need to deploy them on Apache Tomcat, links to the official installation instructions for directly running Apache Tomcat in your environment are provided below:

v6.x:

http://tomcat.apache.org/tomcat-6.0-doc/setup.html

v5.5:

http://tomcat.apache.org/tomcat-5.5-doc/setup.html

Installation Guide

Activate ZK Studio