Difference between revisions of "Installation"
| Line 2: | Line 2: | ||
'''Copy the file''' | '''Copy the file''' | ||
| − | |||
# Unzip the file ''GvEnterprise3.1.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. | # Unzip the file ''GvEnterprise3.1.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" | {| class="note" | ||
|- | |- | ||
| Line 10: | Line 8: | ||
unzip GvEnterprise3.1.0.zip | unzip GvEnterprise3.1.0.zip | ||
|} | |} | ||
| − | |||
| − | |||
| − | |||
{| class="note" | {| 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. | | 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''' | '''Environment configuration''' | ||
Before using {{GVESB}} is necessary to set some environment variables. | Before using {{GVESB}} is necessary to set some environment variables. | ||
| − | |||
# Create the JBOSS_HOME environment variable and set it with the absolute path installation of JBoss; | # Create the JBOSS_HOME environment variable and set it with the absolute path installation of JBoss; | ||
# Create the GV_HOME environment variable and set it with the absolute path where {{GVESB}} has been installed; | # Create the GV_HOME environment variable and set it with the absolute path where {{GVESB}} has been installed; | ||
# Create the GV_SERVER environment variable and set it with the absolute path where is the JBoss server of {{GVESB}}; | # Create the GV_SERVER environment variable and set it with the absolute path where is the JBoss server of {{GVESB}}; | ||
# Create the JAVA_HOME environment variable and set it with the absolute path where JDK is installed. | # Create the JAVA_HOME environment variable and set it with the absolute path where JDK is installed. | ||
| − | |||
Follow the examples below to configure properly the environment variables. | Follow the examples below to configure properly the environment variables. | ||
| − | |||
{| class="note" | {| class="note" | ||
|- | |- | ||
| Line 42: | Line 32: | ||
export JAVA_HOME = /usr/lib/jvm/java-6-sun | export JAVA_HOME = /usr/lib/jvm/java-6-sun | ||
|} | |} | ||
| − | |||
| − | |||
{| class="note" | {| class="note" | ||
| Line 55: | Line 43: | ||
set JAVA_HOME = C:\SDK\jdk<br/> | set JAVA_HOME = C:\SDK\jdk<br/> | ||
|} | |} | ||
| − | |||
| − | |||
'''Boot Parameters''' | '''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: | 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" | {| class="gvtable" | ||
| − | ! | + | ! Parameter |
| − | ! | + | ! Description |
|- | |- | ||
| − | | JBOSS_HOME | + | | JBOSS_HOME |
| + | | JBoss installation Absolute path | ||
|- | |- | ||
| − | | GV_HOME | + | | GV_HOME |
| + | | {{GVESB}} installation Absolute path | ||
|- | |- | ||
| − | | GV_SERVER | + | | GV_SERVER |
| + | | {{GVESB}} JBoss server Absolute path | ||
|- | |- | ||
| − | | JAVA_OPTS | + | | JAVA_OPTS |
| + | | Java Virtual Machine options: <br/>Eg: JAVA_OPTS = "-Xmx512M-Xms512M" | ||
|- | |- | ||
| − | | JBOSS_BIND_ADDRESS | + | | JBOSS_BIND_ADDRESS |
| + | | Network address on which the JBoss server will be listen.<br/> set = 0.0.0.0 for listening on all interfaces | ||
|- | |- | ||
| − | | JBOSS_SERVER_HOSTNAME | + | | JBOSS_SERVER_HOSTNAME |
| + | | JBoss server Hostname | ||
|- | |- | ||
| − | | PREFER_IP_V4_STACK | + | | PREFER_IP_V4_STACK |
| + | | Uses mapping for the IPv4 addresses | ||
|- | |- | ||
| − | | CONFIGURATION_SERVER_NAME | + | | CONFIGURATION_SERVER_NAME |
| + | | Name of the server imposed to ''default'' | ||
|} | |} | ||
Revision as of 18:33, 24 January 2012
This section describes the GreenVulcano® ESB installation steps.
Copy the file
- Unzip the file GvEnterprise3.1.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.
 |
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.1.0.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.
- Create the JBOSS_HOME environment variable and set it with the absolute path installation of JBoss;
- Create the GV_HOME environment variable and set it with the absolute path where GreenVulcano® ESB has been installed;
- Create the GV_SERVER environment variable and set it with the absolute path where is the JBoss server of GreenVulcano® ESB;
- Create the JAVA_HOME environment variable and set it 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 files start_GreenV.sh and stop_GreenV.sh presents in the GvEnterprise3.1.0/GvServer/jboss-4.2.3.GA/server/GreenV/bin path for the decompressed file, setting variables values as follows:
export JBOSS_HOME = /home/gvuser/GvEnterprise3.1.0/GvServer/jboss-4.2.3.GA |
|
|
In case of Microsoft Windows operating systems, edit the file start_GreenV.cmd present in GvEnterprise3.0.0/GvServer/jboss-4.2.2.GA/server/GreenV/bin path relative to the decompressed file, setting the variables values as follows:
set JBOSS_HOME = C:\GvEnterprise3.1.0\GvServer\jboss-4.2.3.GA |
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 GreenVulcano® ESB start. A list of these variables is present bellow:
| Parameter | Description |
|---|---|
| JBOSS_HOME | JBoss installation Absolute path |
| GV_HOME | GreenVulcano® ESB installation Absolute path |
| GV_SERVER | GreenVulcano® ESB JBoss server Absolute path |
| JAVA_OPTS | Java Virtual Machine options: Eg: JAVA_OPTS = "-Xmx512M-Xms512M" |
| JBOSS_BIND_ADDRESS | Network address on which the JBoss server will be listen. set = 0.0.0.0 for listening on all interfaces |
| JBOSS_SERVER_HOSTNAME | JBoss server Hostname |
| PREFER_IP_V4_STACK | Uses mapping for the IPv4 addresses |
| CONFIGURATION_SERVER_NAME | Name of the server imposed to default |
