EAP Build Installation

Added by Vadim Gurov, last edited by Jura Gorohovsky on Jan 27, 2010  (view change)

EAP Build Overview

Every EAP build of YouTrack is distributed as a youtrack-xx.jar and a youtrack-xx.war file.

Run YouTrack as a Standalone Process

Execute youtrack-xx.jar using command:

java -Xmx256m -jar youtrack-xx.jar <port>

Where port is an optional http port number. We recommend that you increase default Java heap size to at least 256mb, and continue increasing it as your database grows.
If you want to run youtrack-xx.jar as service under a Linux machine, follow these guidelines (thanks to Alexey Efimov for providing them).

Install and Run under Apache Tomcat

youtrack-xx.war can be deployed into any J2EE server, such as Apache Tomcat 6+, Mortbay Jetty, JBoss, Caucho Resin.
Installing and running YouTrack is very simple, and the procedure is generally common for all J2EE servers. The following guidelines apply to Apache Tomcat.

  1. Put downloaded file youtrack-xx.war into the $TOMCAT_HOME$/webapps directory.
  2. Start Apache Tomcat.
  3. In your browser, go to URL http://localhost:8080/youtrack-xx. You should be automatically logged as root/root on first run. Make sure to change the default credentials later on.
  4. Complete the setup screen. Enter the following license data:
    License user name: EAP User
    License key:
    e0cfa67999ac596a80a196c65b1ce062dbf0e7369bd630811f9525f2879bea0bb5a0a776c254d6abd030cf2a0acc424824a1fb8e2898faa7c394aa966d007efeccc5f26871ef40d5fce3d804fa24831316a6ae7d53cf77568ff15a77957d3968262977e4915ca4e4a5a1799196de9a19159f507fd0c98ac2dcdff994f02c4b3
    License expiration date: Feb 26, 2010
  1. The administration screen displays next.
  2. To change the root password, open your profile and click Change password.
  3. Before creating issues, create a new project.
  4. Press on logo in the top left corner and get to the welcome screen. You have successfully completed YouTrack installation.

Database

YouTrack uses its own in-process database. By default, data files are saved to ${user.home}/teamsysdata directory.
To change this default location, modify the web.xml file located inside the youtrack-xx.war:/WEB-INF/ directory:

<web-app>
  <display-name>YouTrack</display-name>
  <servlet>
    <servlet-name>MainServlet</servlet-name>
    <servlet-class>jetbrains.charisma.main.ServletImpl</servlet-class>
    <init-param>
      <param-name>database.location</param-name>
      <param-value>${user.home}/teamsysdata</param-value>
    </init-param>
    ...
  </servlet>
...
</web-app>

Labels

 
(None)