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
- 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 |
 |
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.
- Configure the JBOSS_HOME environment variable with the absolute path installation of JBoss;
- Configure the GV_HOME environment variable with the absolute path where GreenVulcano® ESB has been installed;
- Configure the GV_SERVER environment variable with the absolute path where is the JBoss server of GreenVulcano® ESB;
- 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 |
|
|
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 |
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:
|
