Difference between revisions of "Installation"

From GreenVulcano Wiki
Jump to: navigation, search
Line 1: Line 1:
This section describes the {{GVESB}} installation steps.
+
This section describes how install {{GVESB}} using the new GreenVulcano Universal Installer or the manual installation process.
  
'''Copy the file'''
+
'''Install using GreenVulcano Universal Installer'''
# Unzip the file ''GvEnterprise3.2.0.zip'' in any directory on the server where you plan to install the software. To avoid potential problems the installation path MUST NOT contain spaces.
+
# Unzip the file ''GvEnterprise3.2.0'' archive in any directory on the server where you plan to install the software. To avoid potential problems the installation path MUST NOT contain spaces.
{| class="note"
+
# Run the GreenVulcano Universal Installer: [[Installer Overview]]
|-
 
| align="left" | [[File:linux.png]] || In case of *nix operating systems, you can choose to create an installation directory for {{GVESB}} into the user's home directory (ex. /home/gvuser), or paths established by the System Administrators (ex. /opt). Navigate to the directory chosen for installation and decompress the file with the command:
 
unzip GvEnterprise3.2.0.zip
 
|}
 
{| class="note"
 
|-
 
| align="left" | [[File:windows.png]] || In case of Windows operating systems, you should unpack the ZIP file to a directory editable by the user, used to run {{GVESB}}. It is recommended NOT to use spaces in the directory name. Navigate to the directory chosen for installation and decompress the file using a program compatible with the GNU zip compression format.
 
|}
 
  
'''Environment configuration'''
 
  
Before using {{GVESB}} is necessary to set some environment variables.
+
'''Manual installation process'''
# Configure the JBOSS_HOME environment variable with the absolute path installation of JBoss;
+
# Unzip the file ''GvEnterprise3.2.0'' archive in any directory on the server where you plan to install the software. To avoid potential problems the installation path MUST NOT contain spaces.
# Configure the GV_HOME environment variable with the absolute path where {{GVESB}} has been installed;
+
# Setup your {{GVESB}} : [[Manual Installation]]
# Configure the GV_SERVER environment variable with the absolute path where is the JBoss server of {{GVESB}};
 
# Configure the JAVA_HOME environment variable with the absolute path where JDK is installed.
 
 
 
Follow the examples below to configure properly the environment variables.
 
{| class="note"
 
|-
 
| [[File:linux.png]]
 
| In case of *nix operating systems, edit the file ''env_GreenV.sh'' under GvEnterprise3.2.0/GvServer/GreenV/bin and set the  variables values as follows:
 
 
 
export JBOSS_HOME = /home/gvuser/GvEnterprise3.2.0/GvServer/jboss-5.1.0.GA<br/>
 
export GV_SERVER  = $JBOSS_HOME/server/GreenV<br/>
 
export GV_HOME = /home/gvuser/GvEnterprise3.2.0/GvServer/GreenV<br/>
 
export CLASSPATH = $GV_HOME/xmlconfig<br/>
 
export JAVA_HOME = /usr/lib/jvm/java-6-sun
 
|}
 
 
 
{| class="note"
 
|-
 
| [[File:windows.png]]
 
| In case of Microsoft Windows operating systems, edit the file ''env_GreenV.cmd'' under GvEnterprise3.2.0/GvServer/GreenV/bin and set the variables values as follows:
 
 
 
set JBOSS_HOME = C:\GvEnterprise3.2.0\GvServer\jboss-5.1.0.GA<br/>
 
set GV_SERVER = %JBOSS_HOME\server\GreenV<br/>
 
set GV_HOME = C:\GvEnterprise3.2.0\GvServer\GreenV<br/>
 
set CLASSPATH = %GV_HOME%\xmlconfig<br/>
 
set JAVA_HOME = C:\SDK\jdk<br/>
 
|}
 
 
 
'''Boot Parameters'''
 
 
 
In addition to the above variables, the file ''start_GreenV.sh'' (or ''start_GreenV.cmd'' in Microsoft Windows environments) contains other values for configuring the {{GVESB}} start. A list of these variables is present bellow:
 
{| class="gvtable"
 
! Parameter 
 
! Description
 
|-
 
| JB_OPTS
 
| JBoss server options. <br/>-Djboss.partition.name=GreenVPartition <br/>-Djboss.service.binding.set=ports-default <br/>-Djboss.bind.address=0.0.0.0 <br/>-Dbind.address=localhost <br/>-Djava.net.preferIPv4Stack=true <br/>-Djava.rmi.server.hostname=localhost
 
|-
 
| GV_OPTS
 
| {{GVESB}} options. <br/>-Dgv.app.home=$GV_HOME -Dit.greenvulcano.util.xpath.search.XPathAPIFactory.cfgFileXPath=GVCore.xml<nowiki>|</nowiki>/GVCore/GVXPath/XPath <br/>-Djavax.xml.parsers.DocumentBuilderFactory=org.apache.xerces.jaxp.DocumentBuilderFactoryImpl <br/>-Djavax.xml.transform.TransformerFactory=org.apache.xalan.processor.TransformerFactoryImpl <br/>-Djxl.nogc=true <br/>-Dit.greenvulcano.log.db.JDBCAppender.logState=false <br/>-Dgv.pop.uidcache.manager=it.greenvulcano.gvesb.virtual.pop.uidcache.MemoryUIDCacheManager <br/>-Dit.greenvulcano.util.thread.BaseThread.dumpInstCount=true <br/>-Dit.greenvulcano.util.thread.BaseThread.dumpCreateStack=false <br/>-Dit.greenvulcano.gvesb.identity.IdentityInfo.debug=true
 
|-
 
| JAVA_OPTS
 
| Java Virtual Machine options: <br/>-Xms512M -Xmx1024M -XX:MaxPermSize=256m -XX:+UseConcMarkSweepGC -XX:+CMSClassUnloadingEnabled
 
|-
 
|}
 

Revision as of 09:47, 28 May 2012

This section describes how install GreenVulcano® ESB using the new GreenVulcano Universal Installer or the manual installation process.

Install using GreenVulcano Universal Installer

  1. Unzip the file GvEnterprise3.2.0 archive in any directory on the server where you plan to install the software. To avoid potential problems the installation path MUST NOT contain spaces.
  2. Run the GreenVulcano Universal Installer: Installer Overview


Manual installation process

  1. Unzip the file GvEnterprise3.2.0 archive in any directory on the server where you plan to install the software. To avoid potential problems the installation path MUST NOT contain spaces.
  2. Setup your GreenVulcano® ESB : Manual Installation