Manual Installation

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 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.

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: unzip GvEnterprise3.2.0.other.zip

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.

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: export JBOSS_HOME = /home/gvuser/GvEnterprise3.2.0/GvServer/jboss-5.1.0.GA export GV_SERVER = $JBOSS_HOME/server/GreenV export GV_HOME = /home/gvuser/GvEnterprise3.2.0/GvServer/GreenV export CLASSPATH = $GV_HOME/xmlconfig export JAVA_HOME = /usr/lib/jvm/java-6-sun

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: set JBOSS_HOME = C:\GvEnterprise3.2.0\GvServer\jboss-5.1.0.GA set GV_SERVER = %JBOSS_HOME\server\GreenV set GV_HOME = C:\GvEnterprise3.2.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

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