Difference between revisions of "Installation"

From GreenVulcano Wiki
Jump to: navigation, search
 
(5 intermediate revisions by 2 users not shown)
Line 1: Line 1:
This section describes the {{GVESB}} installation steps.
+
This section describes how to install {{GVESB}} using the new GreenVulcano Universal Installer or the manual installation process.
  
'''Copy the file'''
+
Installation packages can be found [https://sourceforge.net/projects/greenvulcanoesb/files/GreenVulcano%20ESB/3.4 here].
# 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.
 
{| class="note"
 
|-
 
| 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'''
+
'''Install using GreenVulcano Universal Installer'''
 +
# Unzip the file ''Installer_GvServer-<version>.Final'' 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.
 +
# Run the GreenVulcano Universal Installer: [[Installer Overview]]
  
Before using {{GVESB}} is necessary to set some environment variables.
 
# Configure the JBOSS_HOME environment variable with the absolute path installation of JBoss;
 
# Configure the GV_HOME environment variable with the absolute path where {{GVESB}} has been installed;
 
# 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.
+
'''Manual installation process'''
{| class="note"
+
# Unzip the file ''GvServer-<version>.Final-Full'' 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.
|-
+
# Setup your {{GVESB}} : [[Manual Installation]]
| [[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
 
|-
 
|}
 

Latest revision as of 14:41, 21 June 2021

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

Installation packages can be found here.

Install using GreenVulcano Universal Installer

  1. Unzip the file Installer_GvServer-<version>.Final 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 GvServer-<version>.Final-Full 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