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

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

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

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

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