Survey
* Your assessment is very important for improving the workof artificial intelligence, which forms the content of this project
* Your assessment is very important for improving the workof artificial intelligence, which forms the content of this project
ACME G E T T I N G S TA R T E D G U I D E INSTALLING AND STARTING ON WINDOWS VERSION 1.0 Getting Started Guide – Installing and starting (v. 1.0, July 2014) 1 TABLE OF CONTENTS 1. 2. Introduction ................................................................................................................................................2 Development environment(on Microsoft Windows) ..................................................................................3 Installing and Configuring MySQL ...............................................................................................................3 JBoss Application Server configuration .........................................................................................................3 Eclipse configuration......................................................................................................................................7 Eclipse IDE for java EE Developers .........................................................................................................7 Vaadin Plug-in for eclipse ..........................................................................................................................7 3. The ACME Project: SVN sharing wizard ..................................................................................................8 Getting Started Guide – Installing and starting (v. 1.0, July 2014) 1 1 . I N T R O D U C T I O N This tutorial shows you step by step how to install and configure on Windows platform all components needed to run aCME system and how to download the aCME project from SVN repository hosted on SourceForge. Getting Started Guide – Installing and starting (v. 1.0, July 2014) 2 2 . D E V E L O P M E N T E N V I R O N M E N T ( O N M I C R O S O F T W I N D O W S ) We describe all components to download and install to setting the environment for aCME system You need the following software and resources: Software or Resource Version Required Java Development kit Sun JDK 1.6.0_x Eclipse IDE for Java EE Developers Juno Service Release 2, windows Vaadin Plug-in for Eclipse Version 2.1.1.201302181316 MySQL Installer 5.6.12 ,, A database server MySQL Connector/J (official JDBC driver for MySQL) JBoss Application server 6.1.0 Final INSTALLING A ND CONFIGURING MYSQL - Download the MySQL Installer 5.6.12 from http://dev.mysql.com/downloads/installer/#downloads Hint: Choosing a Setup Type: Full - Download MySQL Connector/J (official JDBC driver for MySQL) http://dev.mysql.com/downloads/connector/j/ Hint: Extract “mysql-connector-java-5.1.25” in your favorite folder (“acmeProject” use in this guide) JBOSS APPLICATION SERVER CONFIGURATION Installation guide: Download Jboss Application Server 7.2 ( Version 6.1.0 Final ) Getting Started Guide – Installing and starting (v. 1.0, July 2014) 3 http://www.jboss.org/jbossas/downloads/ Hint: Extract “jboss-eap-6.1” in your favorite folder Server configuration: install MySQL into JBoss Open folder: jboss-eap-6.1 > modules > system > layers > base > com Create subdirectory structure: “MySQLdatabase > mysql > main”. Copy mysql-connector-java-5.1.25.jar from folder “mysql-connector-java-5.1.25” in “main” folder and create file “module.xml”. File: module.xml <module xmlns="urn:jboss:module:1.1" name="com.MySQLdatabase.mysql"> <properties> <property name="jboss.api" value="unsupported"/> </properties> <resources> <resource-root path="mysql-connector-java-5.1.25-bin.jar"/> </resources> <dependencies> <module name="javax.api"/> <module name="javax.transaction.api"/> <module name="javax.servlet.api" optional="true"/> </dependencies> </module> Getting Started Guide – Installing and starting (v. 1.0, July 2014) 4 Configure file “standalone-osgi.xml” in jboss-eap-6.1 > standalone > configuration folder - Open standalone-osgi.xml and insert the following code between the tags <datasources> </datasources>: <datasource jta="false" jndi-name="java:jboss/datasources/MySQLDS" pool-name="MySQLDS" enabled="true" use-java-context="true"> <connection-url>jdbc:mysql://localhost:3306/</connection-url> <driver>mysql</driver> <new-connection-sql>create schema IF NOT EXISTS acme</new-connection-sql> <security> <user-name>root</user-name> <password>root</password> </security> </datasource> Hint: The strings selected in yellow, depend on the choices made during the installation of MySQL - Insert the following code between the tags <drivers> </drivers>: <driver name="mysql" module="com.MySQLdatabase.mysql"> <xa-datasource-class>com.mysql.jdbc.jdbc2.optional.MysqlXADataSource</xa-datasource-class> </driver> Getting Started Guide – Installing and starting (v. 1.0, July 2014) 5 - Insert the following code between the tags <capabilities> </capabilities>: <capability name="org.jboss.as.jpa"/> <capability name="org.hibernate"/> <capability name="org.jboss.as.ejb3"/> STARTING AND STOPPING JBOSS AS - Before you begin Before running JBoss Application Server you will need to make sure that the environment variable points to your installed Java SDK. Getting Started Guide – Installing and starting (v. 1.0, July 2014) 6 Before running JBoss Application Server, you will need to make sure that the environment variable points to your installed Java SDK, else set JAVA_HOME - Starting JBoss Application Server from the command line Into the directory of your installation and execute this command: - standalone.bat -server-config=standalone-osgi.xml or equivalent: standalone.bat -c standalone-osgi.xml If you want to stop the server press CTRL+C ECLIPSE CONFIGURATIO N ECLIPSE IDE FOR JAVA EE DEVELOPERS Tools for Java developers creating Java EE and Web applications, including a Java IDE, tools for Java EE, JPA, JSF, Mylyn, EGit and others: - Download Eclipse Java EE Ide for Web Developers (Version: Juno Service Release 2) VAADIN PLUG-IN FOR ECLIPSE - Install Vaadin Plug-in for eclipse (Version 2.1.1.201302181316) Getting Started Guide – Installing and starting (v. 1.0, July 2014) 7 Vaadin Plug-in for Eclipse helps you to create and maintain Vaadin projects, widgetsets, widgets and more. - An Eclipse Team Provider plug-in support for Subversion within Eclipse, add Subclipse to Eclipse: download Subclipse 1.8.20 from Eclipse Marketplace 3 . T H E A C M E P R O J E C T: S V N S H A R I N G W I Z A R D To share the new project, select it in your workbench, select “Team>Share Project...” , a wizard will drive to several steps: - At first, select a repository type (i.e: SVN) - Define the location and protocol required to connect with an existing SVN repository: https://svn.code.sf.net/p/acme-groupware/code-0 Select the name of the folder in the SVN repository (trunk...) after editing a comment, the wizard has all the information necessary to share your project with SVN repository. Getting Started Guide – Installing and starting (v. 1.0, July 2014) 8