Difference between revisions of "Installation"

From GreenVulcano Wiki
Jump to: navigation, search
Line 5: Line 5:
 
# 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="wikitable"
+
{| class="note"
 
|-
 
|-
−
| align="left" | [[File:GVConsolePinguin.jpg]] || 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.1.0.zip
 
unzip GvEnterprise3.1.0.zip
 
|}
 
|}
Line 13: Line 13:
  
  
−
{| class="wikitable"
+
{| 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.
Line 32: Line 32:
 
Follow the examples below to configure properly the environment variables.
 
Follow the examples below to configure properly the environment variables.
  
−
{| class="wikitable"
+
{| class="note"
 
|-
 
|-
−
| align="left" | [[File:GVConsolePinguin.jpg]] || 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:
+
| [[File:linux.png]]
 +
| 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<br/>
 
export JBOSS_HOME = /home/gvuser/GvEnterprise3.1.0/GvServer/jboss-4.2.3.GA<br/>
Line 44: Line 45:
  
  
−
{| class="wikitable"
+
{| class="note"
 
|-
 
|-
−
| align="left" | [[File:GVConsoleWindowsIcon.jpg]] || 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:
+
| [[File:windows.png]]
 +
| 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<br/>
 
set JBOSS_HOME = C:\GvEnterprise3.1.0\GvServer\jboss-4.2.3.GA<br/>
Line 61: Line 63:
 
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="wikitable" style="margin: 1em auto 1em auto;"
+
{| class="gvtable"
 
! scope="col" | Parameter   
 
! scope="col" | Parameter   
 
! scope="col" | Description  
 
! scope="col" | Description  

Revision as of 18:30, 24 January 2012

This section describes the GreenVulcano® ESB installation steps.

Copy the file

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

unzip GvEnterprise3.1.0.zip


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. Create the JBOSS_HOME environment variable and set it with the absolute path installation of JBoss;
  2. Create the GV_HOME environment variable and set it with the absolute path where GreenVulcano® ESB has been installed;
  3. Create the GV_SERVER environment variable and set it with the absolute path where is the JBoss server of GreenVulcano® ESB;
  4. 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.

Linux.png 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
export GV_HOME = /home/gvuser/GvEnterprise3.1.0/GvServer/GreenV
export GV_SERVER = $JBOSS_HOME/server/GreenV
export JAVA_HOME = /usr/lib/jvm/java-6-sun


Windows.png 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
set GV_HOME = C:\GvEnterprise3.1.0\GvServer\GreenV
set GV_SERVER = %JBOSS_HOME\server\GreenV
set JAVA_HOME = C:\SDK\jdk


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
Retrieved from "https://gvwiki.greenvulcano.com/gvwiki/index.php?title=Installation&oldid=951"