Download it - SourceForge

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