Difference between revisions of "Manual Installation"

From GreenVulcano Wiki
Jump to: navigation, search
 
(3 intermediate revisions by 2 users not shown)
Line 2: Line 2:
  
 
'''Copy the file'''
 
'''Copy the file'''
# Unzip the file ''GvEnterprise3.2.0.other.zip'' in any directory on the server where you plan to install the software. To avoid potential problems the installation path and the JAVA_HOME MUST NOT contain spaces.
+
# Unzip the file ''GvServer-3.3.0.Final-Full'' in any directory on the server where you plan to install the software. To avoid potential problems the installation path and the JAVA_HOME MUST NOT contain spaces.
 
{| class="note"
 
{| 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:
 
| 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.other.zip
+
extract GvServer-3.3.0.Final-Full.tar.gz<br/>
 +
or<br/>
 +
tar -xvf GvServer-3.3.0.Final-Full.tar.gz
 
|}
 
|}
 
{| class="note"
 
{| class="note"
Line 25: Line 27:
 
|-
 
|-
 
| [[File:linux.png]]
 
| [[File:linux.png]]
| In case of *nix operating systems, edit the file ''env_scripts.sh'' under GvEnterprise3.2.0/GvServer/GreenV/bin and set the  variables values as follows:
+
| In case of *nix operating systems, edit the file ''env_scripts.sh'' under GvEnterprise3.3.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 JBOSS_HOME = /home/gvuser/GvEnterprise3.3.0/GvServer/jboss-5.1.0.GA<br/>
 
export GV_SERVER  = $JBOSS_HOME/server/GreenV<br/>
 
export GV_SERVER  = $JBOSS_HOME/server/GreenV<br/>
export GV_HOME = /home/gvuser/GvEnterprise3.2.0/GvServer/GreenV<br/>
+
export GV_HOME = /home/gvuser/GvEnterprise3.3.0/GvServer/GreenV<br/>
 
export CLASSPATH = $GV_HOME/xmlconfig<br/>
 
export CLASSPATH = $GV_HOME/xmlconfig<br/>
 
export JAVA_HOME = /usr/lib/jvm/java-6-sun
 
export JAVA_HOME = /usr/lib/jvm/java-6-sun
Line 37: Line 39:
 
|-
 
|-
 
| [[File:windows.png]]
 
| [[File:windows.png]]
| In case of Microsoft Windows operating systems, edit the file ''env_scripts.cmd'' under GvEnterprise3.2.0/GvServer/GreenV/bin and set the variables values as follows:
+
| In case of Microsoft Windows operating systems, edit the file ''env_scripts.cmd'' under GvEnterprise3.3.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 JBOSS_HOME = C:\GvEnterprise3.3.0\GvServer\jboss-5.1.0.GA<br/>
 
set GV_SERVER = %JBOSS_HOME\server\GreenV<br/>
 
set GV_SERVER = %JBOSS_HOME\server\GreenV<br/>
set GV_HOME = C:\GvEnterprise3.2.0\GvServer\GreenV<br/>
+
set GV_HOME = C:\GvEnterprise3.3.0\GvServer\GreenV<br/>
 
set CLASSPATH = %GV_HOME%\xmlconfig<br/>
 
set CLASSPATH = %GV_HOME%\xmlconfig<br/>
 
set JAVA_HOME = C:\SDK\jdk<br/>
 
set JAVA_HOME = C:\SDK\jdk<br/>
Line 62: Line 64:
 
| Java Virtual Machine options: <br/>-Xms512M -Xmx1024M -XX:MaxPermSize=256m -XX:+UseConcMarkSweepGC -XX:+CMSClassUnloadingEnabled
 
| Java Virtual Machine options: <br/>-Xms512M -Xmx1024M -XX:MaxPermSize=256m -XX:+UseConcMarkSweepGC -XX:+CMSClassUnloadingEnabled
 
|-
 
|-
 +
|}
 +
 +
 +
{| class="note"
 +
|-
 +
| [[File:linux.png]]
 +
| In case of *nix systems, the user with which {{GVESB}} will be executed must have exec permission for the following scripts:
 +
: $GV_HOME/bin/env_scripts.sh<br/>
 +
: $GV_HOME/bin/gvstart.sh<br/>
 +
: $GV_HOME/bin/gvstop.sh<br/>
 +
: $GV_HOME/hsqldb/bin/start_DB.sh<br/>
 +
: $GV_HOME/hsqldb/stop_DB.sh<br/>
 +
: $JBOSS_HOME/bin/run.sh<br/>
 +
: $JBOSS_HOME/bin/shutdown.sh
 
|}
 
|}

Latest revision as of 20:57, 15 September 2015

This section describes the GreenVulcano® ESB installation steps on systems unsupported by the GreenVulcanoUniversalInstaller or when you are unable to run it.

Copy the file

  1. Unzip the file GvServer-3.3.0.Final-Full in any directory on the server where you plan to install the software. To avoid potential problems the installation path and the JAVA_HOME MUST NOT contain spaces.
Linux.png In case of *nix operating systems, you can choose to create an installation directory for GreenVulcano® ESB 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:

extract GvServer-3.3.0.Final-Full.tar.gz
or
tar -xvf GvServer-3.3.0.Final-Full.tar.gz

Windows.png In case of Windows operating systems, you should unpack the ZIP file to a directory editable by the user, used to run GreenVulcano® ESB. 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 GreenVulcano® ESB is necessary to set some environment variables.

  1. Configure the JBOSS_HOME environment variable with the absolute path installation of JBoss;
  2. Configure the GV_HOME environment variable with the absolute path where GreenVulcano® ESB has been installed;
  3. Configure the GV_SERVER environment variable with the absolute path where is the JBoss server of GreenVulcano® ESB;
  4. Configure the JAVA_HOME environment variable with the absolute path where JDK is installed.

Follow the examples below to configure properly the environment variables.

Linux.png In case of *nix operating systems, edit the file env_scripts.sh under GvEnterprise3.3.0/GvServer/GreenV/bin and set the variables values as follows:

export JBOSS_HOME = /home/gvuser/GvEnterprise3.3.0/GvServer/jboss-5.1.0.GA
export GV_SERVER = $JBOSS_HOME/server/GreenV
export GV_HOME = /home/gvuser/GvEnterprise3.3.0/GvServer/GreenV
export CLASSPATH = $GV_HOME/xmlconfig
export JAVA_HOME = /usr/lib/jvm/java-6-sun

Windows.png In case of Microsoft Windows operating systems, edit the file env_scripts.cmd under GvEnterprise3.3.0/GvServer/GreenV/bin and set the variables values as follows:

set JBOSS_HOME = C:\GvEnterprise3.3.0\GvServer\jboss-5.1.0.GA
set GV_SERVER = %JBOSS_HOME\server\GreenV
set GV_HOME = C:\GvEnterprise3.3.0\GvServer\GreenV
set CLASSPATH = %GV_HOME%\xmlconfig
set JAVA_HOME = C:\SDK\jdk

Boot Parameters

In addition to the above variables, the file gvstart.sh (or gvstart.cmd in Microsoft Windows environments) contains other values for configuring the GreenVulcano® ESB start. A list of these variables is present bellow:

Parameter Description
JB_OPTS JBoss server options.
-Djboss.partition.name=GreenVPartition
-Djboss.service.binding.set=ports-default
-Djboss.bind.address=0.0.0.0
-Dbind.address=localhost
-Djava.net.preferIPv4Stack=true
-Djava.rmi.server.hostname=localhost
GV_OPTS GreenVulcano® ESB options.
-Dgv.app.home=$GV_HOME -Dit.greenvulcano.util.xpath.search.XPathAPIFactory.cfgFileXPath=GVCore.xml|/GVCore/GVXPath/XPath
-Djavax.xml.parsers.DocumentBuilderFactory=org.apache.xerces.jaxp.DocumentBuilderFactoryImpl
-Djavax.xml.transform.TransformerFactory=org.apache.xalan.processor.TransformerFactoryImpl
-Djxl.nogc=true
-Dit.greenvulcano.log.db.JDBCAppender.logState=false
-Dgv.pop.uidcache.manager=it.greenvulcano.gvesb.virtual.pop.uidcache.MemoryUIDCacheManager
-Dit.greenvulcano.util.thread.BaseThread.dumpInstCount=true
-Dit.greenvulcano.util.thread.BaseThread.dumpCreateStack=false
-Dit.greenvulcano.gvesb.identity.IdentityInfo.debug=true
JAVA_OPTS Java Virtual Machine options:
-Xms512M -Xmx1024M -XX:MaxPermSize=256m -XX:+UseConcMarkSweepGC -XX:+CMSClassUnloadingEnabled


Linux.png In case of *nix systems, the user with which GreenVulcano® ESB will be executed must have exec permission for the following scripts:
$GV_HOME/bin/env_scripts.sh
$GV_HOME/bin/gvstart.sh
$GV_HOME/bin/gvstop.sh
$GV_HOME/hsqldb/bin/start_DB.sh
$GV_HOME/hsqldb/stop_DB.sh
$JBOSS_HOME/bin/run.sh
$JBOSS_HOME/bin/shutdown.sh