<commit_before>---
title: Building oVirt engine
category: draft-documentation
authors: abonas, alonbl, amuller, amureini, apevec, asaf, djorm, dneary, doron, dougsland,
  gwei3, ichristo, jhernand, jumper45, laravot, lhornyak, lpeer, mbetak, mburns, moolit,
  moti, ofrenkel, ovedo, quaid, rmiddle, sgordon, sgtpepper, shireesh, vered, yair
  zaslavsky, ykaul
wiki_category: Draft documentation
wiki_title: Building oVirt engine
wiki_revision_count: 237
wiki_last_updated: 2013-06-25
---

# Building oVirt engine

## Prerequisites

1.  Fedora 14 and up x86-64 OS
2.  Internet connection

## Installing JDK

OpenJDK

      $> sudo yum install -y java-1.6.0-openjdk-devel

*   Verify that javac linked to openjdk-1.6.0's javac properly.

      $> alternatives --display javac

## Installing JBoss AS

Installing RPM

??? missing RPM details ???

Manual installation:

      #> wget http://sourceforge.net/projects/jboss/files/JBoss/JBoss-5.1.0.GA/jboss-5.1.0.GA-jdk6.zip/download
      #> unzip jboss-5.1.0.GA-jdk6.zip
      #> mv jboss-5.1.0.GA /usr/local/jboss-5.1.0.GA

Check that it runs:

        $> /usr/local/jboss-5.1.0.GA/bin/run.sh

Some useful JAVA_OPTS:

      * -Xmx512m - maximum Java heap size of 512m
      * -Xdebug - include debugging
      * Run with -b 0.0.0.0 to have it bind to all IP addresses;
      * Make sure you've nothing bound to port 8080 or 8009

## Installing tools

### Installing git

         yum install -y git

### Installing maven

oVirt engine is using maven version 2.2.x, maven 3.x will not work.
 yum install -y maven2

Add Maven to Path:

      echo "PATH=/usr/share/maven2/bin:$PATH" >> ~/.bashrc

*   Please validate maven path, as it will change on maven3.

##### Maven personal settings

Copy paste the content of the file below into ~/.m2/settings.xml<commit_msg>Added section about JBoss AS Security<commit_after>---
title: Building oVirt engine
category: draft-documentation
authors: abonas, alonbl, amuller, amureini, apevec, asaf, djorm, dneary, doron, dougsland,
  gwei3, ichristo, jhernand, jumper45, laravot, lhornyak, lpeer, mbetak, mburns, moolit,
  moti, ofrenkel, ovedo, quaid, rmiddle, sgordon, sgtpepper, shireesh, vered, yair
  zaslavsky, ykaul
wiki_category: Draft documentation
wiki_title: Building oVirt engine
wiki_revision_count: 237
wiki_last_updated: 2013-06-25
---

# Building oVirt engine

## Prerequisites

1.  Fedora 14 and up x86-64 OS
2.  Internet connection

## Installing JDK

OpenJDK

      $> sudo yum install -y java-1.6.0-openjdk-devel

*   Verify that javac linked to openjdk-1.6.0's javac properly.

      $> alternatives --display javac

## Installing JBoss AS

Installing RPM

??? missing RPM details ???

Manual installation:

      #> wget http://sourceforge.net/projects/jboss/files/JBoss/JBoss-5.1.0.GA/jboss-5.1.0.GA-jdk6.zip/download
      #> unzip jboss-5.1.0.GA-jdk6.zip
      #> mv jboss-5.1.0.GA /usr/local/jboss-5.1.0.GA

Check that it runs:

        $> /usr/local/jboss-5.1.0.GA/bin/run.sh

Some useful JAVA_OPTS:

      * -Xmx512m - maximum Java heap size of 512m
      * -Xdebug - include debugging
      * Run with -b 0.0.0.0 to have it bind to all IP addresses;
      * Make sure you've nothing bound to port 8080 or 8009

### JBoss AS Security

Note that JBoss AS 5.1 does not include security fixes for issues found after it was released. These fixes are rolled into later versions of JBoss AS. By default, JBoss AS permits unauthenticated access to the JMX console. It is important that the JMX console is configured to require authentication. Failure to do so will render the system vulnerable to several known exploits, including the [JBoss Worm](http://community.jboss.org/blogs/mjc/2011/10/20/statement-regarding-security-threat-to-jboss-application-server) that exploits [CVE-2010-0738](https://access.redhat.com/kb/docs/DOC-30741). Please follow [these instructions](http://community.jboss.org/wiki/SecureTheJmxConsole) to secure the JMX console.

## Installing tools

### Installing git

         yum install -y git

### Installing maven

oVirt engine is using maven version 2.2.x, maven 3.x will not work.
 yum install -y maven2

Add Maven to Path:

      echo "PATH=/usr/share/maven2/bin:$PATH" >> ~/.bashrc

*   Please validate maven path, as it will change on maven3.

##### Maven personal settings

Copy paste the content of the file below into ~/.m2/settings.xml
{'fraction_non_alphanumeric': 0.10461397898583828, 'fraction_numerical': 0.03860210141617177, 'mean_word_length': 3.3746253746253747, 'pattern_counts': {'":': 0, '<': 3, '<?xml version=': 0, '>': 19, 'https://': 1, 'lorem ipsum': 0, 'www.': 0, 'xml': 2}, 'pii_count': 2, 'substrings_counts': 0, 'word_list_counts': {'cursed_substrings.json': 2, 'profanity_word_list.json': 0, 'sexual_word_list.json': 0, 'zh_pornsignals.json': 0}}
{'dir': 'git-commits-cleaned', 'id': '4435109', 'n_tokens_mistral': 1841, 'n_tokens_neox': 1674, 'n_words': 480}