From fa2497f0c63855545b68b29b53d35b17406bf6f2 Mon Sep 17 00:00:00 2001
From: Marko Gronroos <magi@vaadin.com>
Date: Thu, 17 Mar 2016 15:58:58 +0200
Subject: Reorganized the Getting Started chapter to separate installation and
 project creation chapters. #19639

Change-Id: I4aab29b8b9ab23091903016e9cc91850c4ca3b93
---
 documentation/installing/installing-idea.asciidoc | 54 +++++++++++++++++++++++
 1 file changed, 54 insertions(+)
 create mode 100644 documentation/installing/installing-idea.asciidoc

(limited to 'documentation/installing/installing-idea.asciidoc')

diff --git a/documentation/installing/installing-idea.asciidoc b/documentation/installing/installing-idea.asciidoc
new file mode 100644
index 0000000000..95779dab55
--- /dev/null
+++ b/documentation/installing/installing-idea.asciidoc
@@ -0,0 +1,54 @@
+---
+title: Installing IntelliJ IDEA
+order: 120
+layout: page
+---
+
+[[intalling.idea]]
+= Installing and Configuring IntelliJ IDEA
+
+With IntelliJ IDEA, you have two choices: use the commercial Ultimate Edition or the free Community Edition.
+In the following, we cover the installation and configuration of them both.
+
+The Ultimate Edition::
+The Ultimate Edition includes built-in support for creating Vaadin applications and running or debugging them in an integrated application server.
+
+Community Edition::
+You can create a Vaadin application most easily with a Maven archetype and deploy it to a server using a Maven run/debug configuration.
+
+You can get the both editions from the website at https://www.jetbrains.com/idea/[jetbrains.com/idea].
+
+[[installing.idea.ultimate]]
+== Installing the Ultimate Edition
+
+Follow the installation instructions given at the website.
+
+[[installing.idea.ultimate.server]]
+=== Configuring an Application Server
+
+To run a Vaadin application during development in the Ultimate Edition of IntelliJ IDEA, you first need to install and configure an application server that is integrated with the IDE.
+The edition includes integration with many commonly used application servers.
+
+In the following, we configure Apache Tomcat:
+
+. Download and extract Tomcat installation package to a local directory, as
+instructed in <<installing-server#installing.server.tomcat, "Installing Apache Tomcat">>.
+
+. Select "Configure > Settings".
+
+. Select "IDE Settings > Application Servers".
+
+. Click [guibutton]#+# and select [guilabel]#Tomcat Server# to add a Tomcat server, or any of the other supported servers.
+A WebSocket-enabled server, such as Glassfish or TomEE, is required for server push.
+
+. In the Tomcat Server dialog, specify the home directory for the server.
++
+image::img/idea-server-1.png[]
++
+Click [guibutton]#OK#.
+
+. Review the application server settings page to check that it is OK.
++
+image::img/idea-server-2.png[]
++
+Then, click [guibutton]#OK#.
-- 
cgit v1.2.3

