GreenVulcano Wiki - User contributions [en]

Installation

2013-03-10T22:11:19Z

N.decarlo:

This section describes how install {{GVESB}} using the new GreenVulcano Universal Installer or the manual installation process.

'''Install using GreenVulcano Universal Installer'''
# Unzip the file ''Installer_GvServer-3.3.0.Final'' archive in any directory on the server where you plan to install the software. To avoid potential problems the installation path MUST NOT contain spaces.
# Run the GreenVulcano Universal Installer: [[Installer Overview]]

'''Manual installation process'''
# Unzip the file ''GvServer-3.3.0.Final-Full'' archive in any directory on the server where you plan to install the software. To avoid potential problems the installation path MUST NOT contain spaces.
# Setup your {{GVESB}} : [[Manual Installation]]

Manual Installation

2013-03-10T22:11:02Z

N.decarlo:

This section describes the {{GVESB}} 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.
{| class="note"
|-
| 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:
extract GvServer-3.3.0.Final-Full
|}
{| 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.
|}

'''Environment configuration'''

Before using {{GVESB}} 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 {{GVESB}} has been installed;
# Configure the GV_SERVER environment variable with the absolute path where is the JBoss server of {{GVESB}};
# Configure the JAVA_HOME environment variable with the absolute path where JDK is installed.

Follow the examples below to configure properly the environment variables.
{| class="note"
|-
| [[File:linux.png]]
| 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
|}

{| class="note"
|-
| [[File:windows.png]]
| 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 {{GVESB}} start. A list of these variables is present bellow:
{| class="gvtable"
! 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
| {{GVESB}} options. -Dgv.app.home=$GV_HOME -Dit.greenvulcano.util.xpath.search.XPathAPIFactory.cfgFileXPath=GVCore.xml<nowiki>|</nowiki>/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
|-
|}

{| class="note"
|-
| [[File:linux.png]]
| In case of *nix systems, the user with which {{GVESB}} 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
|}

Installing on UNIX Systems

2013-03-10T22:09:01Z

N.decarlo:

Before starting the installation procedure, review the topics in this section to determine that your system meets the basic requirements
and that you have the prerequisite software installed. 

The following is a list of prerequisites for installing {{GVESB}} on UNIX systems. 

''Supported platforms for UNIX Systems''

{| class="gvtable"
! Platform
! Notes
! Disk Space MB
|-
| IBM AIX 5.3 AIX 6.1 AIX 7.1
| IBM (POWER PPC64)
| 213
|-
| Red Hat Red Hat Enterprise Linux 4.x Red Hat Enterprise Linux 5.x Red Hat Enterprise Linux 6.x
| Also includes all Linux distributions that are materially equivalent to the supported Red Hat Enterprise Linux versions.
| 213
|-
| HP HP-UX 11i
| HP-UX 11i v2/11.23 on IA-64/Itanium
| 213
|-
| Solaris Solaris 8 Solaris 9 Solaris 10
| SPARC and x86-64 (only Solaris 10)
| 213
|-
|}

'''Oracle Java 1.6.0 must be installed on system before you start the installation of {{GVESB}}'''

Before you can install {{GVESB}} the Oracle JDK 1.6.0 must be installed on your system. 
The GreenVulcano Universal Installer is a java based application and needs the Oracle JDK 1.6.0 to be executed.

'''Installer Account'''

The GreenVulcanoUniversallInstaller doesn't require to run with administrative privileges. 

'''Installing {{GVESB}} on UNIX Systems'''

If you are installing for the first time, you can specify the installation directory where {{GVESB}} will be installed. 
On UNIX Systems, the default installation directory is the user home directory with which the installer is executed. 

With the new GreenVulcano Universal Installer is possible to install multiple {{GVESB}} sharing the same JBoss 5.1.0 GA application server. 

If you want to use your own JBoss 5.1.0 GA installation you can choose ''"Custom Installation"'' and deselect the ''"JBoss AS 5.1.0.GA"'' package. 

The installer will creates one instance under server directory of your JBoss 5.1.0 GA installation for each {{GVESB}} installation. 

On UNIX Systems you can install by using .

* [[Install using GUI Mode]]
* [[Install using Console Mode]]

Installing on Microsoft Windows

2013-03-10T22:07:12Z

N.decarlo:

Before starting the installation procedure, review the topics in this section to determine that your system meets the basic requirements
and that you have the prerequisite software installed. 

The following is a list of prerequisites for installing {{GVESB}} on Microsoft Windows systems. 

''Supported platforms for Microsoft Windows''

{| class="gvtable"
! Platform
! Service Pack/Edition
! Disk Space MB
|-
| Microsoft Windows 2003
| Service Pack 1 (x86 & x86-64)
| 213
|-
| Microsoft Windows XP
| Service Pack 3 (x86 & x86-64)
| 213
|-
| Microsoft Windows 7
| Service Pack 1 (x86 & x86-64)
| 213
|-
| Microsoft Windows 2003
| R2 (x86 & x86-64)
| 213
|-
| Microsoft Windows 2008
| R2 (x86 & x86-64)
| 213
|-
|}

'''Oracle Java 1.6.0 must be installed on system before you start the installation of {{GVESB}}'''

Before you can install {{GVESB}} the Oracle JDK 1.6.0 must be installed on your system. 
The GreenVulcano Universal Installer is a java based application and needs the Oracle JDK 1.6.0 to be executed.

'''Installer Account'''

You must have administrator privileges for the machine on which {{GVESB}} is installed. 
If you do not have administrator privileges, you must then log out of the system and log in as a user with the required privileges, or request your
system administrator to assign the privileges to your account. 

'''Installing {{GVESB}} on Microsoft Windows'''

If you are installing for the first time, you can specify the installation directory where {{GVESB}} will be installed. 
On Microsoft Windows, the default installation directory is ''C:\Program File''. 

With the new GreenVulcano Universal Installer is possible to install multiple {{GVESB}} sharing the same JBoss 5.1.0 GA application server. 

If you want to use your own JBoss 5.1.0 GA installation you can choose ''"Custom Installation"'' and deselect the ''"JBoss AS 5.1.0.GA"'' package. 

The installer will creates one instance under server directory of your JBoss 5.1.0 GA installation for each {{GVESB}} installation. 

On Microsoft Windows you can install only by using GUI mode.

* [[Install using GUI Mode]]

Installation

2013-03-10T22:06:14Z

N.decarlo:

This section describes how install {{GVESB}} using the new GreenVulcano Universal Installer or the manual installation process.

'''Install using GreenVulcano Universal Installer'''
# Unzip the file ''Installer_GvServer-3.3.0.Final'' archive in any directory on the server where you plan to install the software. To avoid potential problems the installation path MUST NOT contain spaces.
# Run the GreenVulcano Universal Installer: [[Installer Overview]]

'''Manual installation process'''
# Unzip the file ''GvServer-3.3.0.Final-Full.zip'' archive in any directory on the server where you plan to install the software. To avoid potential problems the installation path MUST NOT contain spaces.
# Setup your {{GVESB}} : [[Manual Installation]]

Install using Console Mode

2012-05-28T10:03:34Z

N.decarlo:

The Console Mode enable platforms where graphic environment is not available to install {{GVESB}}. 

It is available just for *nix platform running:
GreenVulcanoUniversalInstaller.bin -console

'''Available Installation Options'''

The available installation options are shown on [[Installer Overview]] page. 

If you need some help on how to use the installer you can simply run:
GreenVulcanoUniversalInstaller.bin -help

All the available options will be shown.

To install {{GVESB}} in Console Mode:
# Open the physical media or download the {{GVESB}} package.
# Extract the {{GVESB}} archive file to a temporary directory.
# Navigate to the temporary directory.
# Run GreenVulcanoUniversalInstaller with -console option. The Welcome screen displays.
# Digit 1 to continue. The License Agreement screen appears. After reading through the license text, digit 1 to ''"accept the terms of the license agreement"''. Digit 1 to continue.
# The Installation Type screen displays. Choose ''"Complete Installation"'' by typing 0 or ''"Custom Installation"'' typing 1 then click 1 to continue.
# The Installation Target Path selection screen displays. Choose your target installation path (INSTALL_PATH) then digit 1.
# If you choose ''"Custom Installation"'' as Installation Type the Select Installation Packages screen displays. You can choose to deselect ''"JBoss AS 5.1.0.GA"'' package if you already have your own installation and you want to use it to deploy {{GVESB}} typing 0 otherwise press Enter. Digit 1 to continue.
# The jBoss Configuration screen display. You should now specify the following parameters for your JBoss instance, pressing Enter you accept the default between bracket:
##'''JBoss Installation Path:''' where JBoss AS 5.1.0.GA must be installed or where it is installed in case you choose ''"Custom Installation"'' and deselect ''"JBoss AS 5.1.0.GA"'' package.
##'''Server Name:''' The name of the server that will be deployed under server/ directory; default is ''"GreenV"''. If you are installing another server in the INSTALL_PATH where there are other servers be sure that its name will differs from the others.
##'''Server Address:''' The server address on which the ''"Server Name"'' will listen on.; default ''"0.0.0.0"'' means all available addresses.
##'''JBoss Port Configuration:''' The portset that will be used by the server; ''"ports-default"'' means the standard ports, for instance HTTP port is 8080. You can choose different portset to be sure that those ports are available on your system typing the respective number then press Enter:
### ports-default: The standard ports, for instance HTTP port is 8080.
### ports-01: The standard ports incremented by 100. For example, HTTP is on 8180.
### ports-02: The standard ports incremented by 200. For example, HTTP is on 8280.
### ports-03: The standard ports incremented by 300. For example, HTTP is on 8380.
##'''Username:''' The username for GV Console administration; default is ''"admin"''.
##'''Password:''' The username password; please note that passwords must contains at least (1) upper case letter, (1) lower case letter, (1) number or special character and must be at least (8) characters in length.
#Digit 1 to continue.
#If you choose ''"Custom Installation"'' as Installation Type the Process Panel screen display. The installer check for your JBoss 5.1.0 GA version for compatibility reason. If it is compatible a confirmation message will display. Digit 1 to continue.
#The installation process will now start copying files on your system.
#The Post Processing screen display. The installer configures the startup scripts and GV Console properties files with parameters defined at point 9.
#The Post Installation Summary screen display. The installation is successfully completed. Some useful information are displayed like:
##'''[[Post Installation]] Requirement'''
##'''[[Starting]] {{GVESB}}'''
##'''[[Uninstall]] {{GVESB}}'''
##'''[[Support]]'''
#Press Enter to go through such information.
#Installation finished.

Install using GUI Mode

2012-05-28T10:02:24Z

N.decarlo:

To install {{GVESB}} in GUI mode:
# Open the physical media or download the {{GVESB}} package.
# Extract the {{GVESB}} archive file to a temporary directory.
# Navigate to the temporary directory.
# Run GreenVulcanoUniversalInstaller. The Welcome screen displays.
# Click Next. The License Agreement screen appears. After reading through the license text, click ''"I accept the terms of the license agreement"'' and then click Next.
# The Installation Type screen displays. Choose ''"Complete Installation"'' or ''"Custom Installation"'' then click Next.
# The Installation Target Path selection screen displays. Choose your target installation path (INSTALL_PATH) then click Next.
# If you choose ''"Custom Installation"'' as Installation Type the Select Installation Packages screen displays. You can choose to deselect ''"JBoss AS 5.1.0.GA"'' package if you already have your own installation and you want to use it to deploy {{GVESB}}. Click Next.
# The jBoss Configuration screen display. You should now specify the following parameters for your JBoss instance:
##'''JBoss Installation Path:''' where JBoss AS 5.1.0.GA must be installed or where it is installed in case you choose ''"Custom Installation"'' and deselect ''"JBoss AS 5.1.0.GA"'' package.
##'''Server Name:''' The name of the server that will be deployed under server/ directory; default is ''"GreenV"''. If you are installing another server in the INSTALL_PATH where there are other servers be sure that its name will differs from the others.
##'''Server Address:''' The server address on which the ''"Server Name"'' will listen on.; default ''"0.0.0.0"'' means all available addresses.
##'''JBoss Port Configuration:''' The portset that will be used by the server; ''"ports-default"'' means the standard ports, for instance HTTP port is 8080. You can choose different portset to be sure that those ports are available on your system:
### ports-default: The standard ports, for instance HTTP port is 8080.
### ports-01: The standard ports incremented by 100. For example, HTTP is on 8180.
### ports-02: The standard ports incremented by 200. For example, HTTP is on 8280.
### ports-03: The standard ports incremented by 300. For example, HTTP is on 8380.
##'''Username:''' The username for GV Console administration; default is ''"admin"''.
##'''Password:''' The username password; please note that passwords must contains at least (1) upper case letter, (1) lower case letter, (1) number or special character and must be at least (8) characters in length.
#Click Next. If you choose ''"Custom Installation"'' as Installation Type the Summary Installation screen display. Click Next.
#If you choose ''"Custom Installation"'' as Installation Type the Process Panell screen display. The installer check for your JBoss 5.1.0 GA version for compatibility reason. If it is compatible a confirmation message will display. Click Next.
#The installation process will now start copying files on your system. Click Next when finish.
#The Post Processing screen display. The installer configures the startup scripts and GV Console properties files with parameters defined at point 9. Click Next.
#The Post Installation Summary screen display. The installation is successfully completed. Some useful information are displayed like:
##'''[[Post Installation]] Requirement'''; only *nix platforms
##'''[[Starting]] {{GVESB}}'''
##'''[[Uninstall]] {{GVESB}}'''
##'''[[Support]]'''
#Click Next. Installation finished. Click Done to complete installation.

Support

2012-05-28T10:01:48Z

N.decarlo: Created page with "It is possible to contact {{GVESB}} support sending an email to [mailto:support@greenvulcano.com ''support@greenvulcano.com''] containing the details of: * Version of the Java v..."

It is possible to contact {{GVESB}} support sending an email to [mailto:support@greenvulcano.com ''support@greenvulcano.com''] containing the details of:

* Version of the Java virtual machine used
* Operating System
* Short description of the hardware architecture

User can eventually attach the log files presents in the directories ''$GV_HOME/log'' and ''$GV_SERVER/log''. See also the forum available at http://www.greenvulcano.com/forum/ where it is possible to find any information of a technical nature as well as requesting help from the ''community'' creating a ''thread/post'' with the problem description.

Starting

2012-05-28T09:56:42Z

N.decarlo:

Once the [[Installation]] and configuration steps are finished, before start {{GVESB}} the [[HSQLDB support database]] must be started by executing the following script:
:$GV_HOME/hsqldb/bin

{| class="note"
|-
|[[File:linux.png]]
| In case of *nix operating systems, the startup script is ''start_DB.sh ''. Remember to NEVER run the startup script as ''root'', but with the user choosen for installation, and so the owner of the $GV_HOME directory.
|}

{| class="note"
|-
| [[File:windows.png]]
| In case of Windows operating system the startup script is ''start_DB.cmd ''.
|}

To verify the correct start of HSQLDB engine you can check the log file.

Once the [[HSQLDB support database]] is running you can start {{GVESB}} executing the script under
:$GV_HOME/bin

{| class="note"
|-
|[[File:linux.png]]
| In case of *nix operating systems, the startup script is ''gvstart.sh'' (start_GreenV.sh in case of [[Manual Installation]]). Remember to NEVER run the startup script as ''root'', but with the user choosen for installation, and so the owner of the $GV_HOME directory.
|}

{| class="note"
|-
| [[File:windows.png]]
| In case of Windows operating system the startup script is ''gvstart.cmd'' (start_GreenV.cmd in case of [[Manual Installation]]).
|}

To verify the correct start of {{GVESB}}, connect to {{L_GVCONSOLE}} and check if your browser accesses the related login page.

:URL - http://<Server Address>:<Port>/gvconsole
:user - User configured during installation process.
:password - Password configured during installation process.

In case of [[Manual Installation]] you can access to the gvconsole as follow:

:URL - http://localhost:8080/gvconsole
:user - gvesb
:password - gvesb

System administrators will find it convenient to configure {{GVESB}} start and stop along with that of the server. In this case, the {{GVESB}} start and stop scripts can be taken, or called by the system start and stop scripts.

Installation

2012-05-28T09:47:40Z

N.decarlo:

This section describes how install {{GVESB}} using the new GreenVulcano Universal Installer or the manual installation process.

'''Install using GreenVulcano Universal Installer'''
# Unzip the file ''GvEnterprise3.2.0'' archive in any directory on the server where you plan to install the software. To avoid potential problems the installation path MUST NOT contain spaces.
# Run the GreenVulcano Universal Installer: [[Installer Overview]]

'''Manual installation process'''
# Unzip the file ''GvEnterprise3.2.0'' archive in any directory on the server where you plan to install the software. To avoid potential problems the installation path MUST NOT contain spaces.
# Setup your {{GVESB}} : [[Manual Installation]]

Installing on Microsoft Windows

2012-05-28T09:27:01Z

N.decarlo:

Before starting the installation procedure, review the topics in this section to determine that your system meets the basic requirements
and that you have the prerequisite software installed. 

The following is a list of prerequisites for installing {{GVESB}} on Microsoft Windows systems. 

''Supported platforms for Microsoft Windows''

{| class="gvtable"
! Platform
! Service Pack/Edition
! Disk Space MB
|-
| Microsoft Windows 2003
| Service Pack 1 (x86 & x86-64)
| 221
|-
| Microsoft Windows XP
| Service Pack 3 (x86 & x86-64)
| 221
|-
| Microsoft Windows 7
| Service Pack 1 (x86 & x86-64)
| 221
|-
| Microsoft Windows 2003
| R2 (x86 & x86-64)
| 221
|-
| Microsoft Windows 2008
| R2 (x86 & x86-64)
| 221
|-
|}

'''Oracle Java 1.6.0 must be installed on system before you start the installation of {{GVESB}}'''

Before you can install {{GVESB}} the Oracle JDK 1.6.0 must be installed on your system. 
The GreenVulcano Universal Installer is a java based application and needs the Oracle JDK 1.6.0 to be executed.

'''Installer Account'''

You must have administrator privileges for the machine on which {{GVESB}} is installed. 
If you do not have administrator privileges, you must then log out of the system and log in as a user with the required privileges, or request your
system administrator to assign the privileges to your account. 

'''Installing {{GVESB}} on Microsoft Windows'''

If you are installing for the first time, you can specify the installation directory where {{GVESB}} will be installed. 
On Microsoft Windows, the default installation directory is ''C:\Program File''. 

With the new GreenVulcano Universal Installer is possible to install multiple {{GVESB}} sharing the same JBoss 5.1.0 GA application server. 

If you want to use your own JBoss 5.1.0 GA installation you can choose ''"Custom Installation"'' and deselect the ''"JBoss AS 5.1.0.GA"'' package. 

The installer will creates one instance under server directory of your JBoss 5.1.0 GA installation for each {{GVESB}} installation. 

On Microsoft Windows you can install only by using GUI mode.

* [[Install using GUI Mode]]

Installing on UNIX Systems

2012-05-28T09:26:24Z

N.decarlo:

Before starting the installation procedure, review the topics in this section to determine that your system meets the basic requirements
and that you have the prerequisite software installed. 

The following is a list of prerequisites for installing {{GVESB}} on UNIX systems. 

''Supported platforms for UNIX Systems''

{| class="gvtable"
! Platform
! Notes
! Disk Space MB
|-
| IBM AIX 5.3 AIX 6.1 AIX 7.1
| IBM (POWER PPC64)
| 236
|-
| Red Hat Red Hat Enterprise Linux 4.x Red Hat Enterprise Linux 5.x Red Hat Enterprise Linux 6.x
| Also includes all Linux distributions that are materially equivalent to the supported Red Hat Enterprise Linux versions.
| 236
|-
| HP HP-UX 11i
| HP-UX 11i v2/11.23 on IA-64/Itanium
| 236
|-
| Solaris Solaris 8 Solaris 9 Solaris 10
| SPARC and x86-64 (only Solaris 10)
| 236
|-
|}

'''Oracle Java 1.6.0 must be installed on system before you start the installation of {{GVESB}}'''

Before you can install {{GVESB}} the Oracle JDK 1.6.0 must be installed on your system. 
The GreenVulcano Universal Installer is a java based application and needs the Oracle JDK 1.6.0 to be executed.

'''Installer Account'''

The GreenVulcanoUniversallInstaller doesn't require to run with administrative privileges. 

'''Installing {{GVESB}} on UNIX Systems'''

If you are installing for the first time, you can specify the installation directory where {{GVESB}} will be installed. 
On UNIX Systems, the default installation directory is the user home directory with which the installer is executed. 

With the new GreenVulcano Universal Installer is possible to install multiple {{GVESB}} sharing the same JBoss 5.1.0 GA application server. 

If you want to use your own JBoss 5.1.0 GA installation you can choose ''"Custom Installation"'' and deselect the ''"JBoss AS 5.1.0.GA"'' package. 

The installer will creates one instance under server directory of your JBoss 5.1.0 GA installation for each {{GVESB}} installation. 

On UNIX Systems you can install by using .

* [[Install using GUI Mode]]
* [[Install using Console Mode]]

Installing on Microsoft Windows

2012-05-28T09:20:41Z

N.decarlo:

Before starting the installation procedure, review the topics in this section to determine that your system meets the basic requirements
and that you have the prerequisite software installed. 

The following is a list of prerequisites for installing {{GVESB}} on Microsoft Windows systems. 

''Supported platforms for Microsoft Windows''

{| class="gvtable"
! Platform
! Service Pack/Edition
! Disk Space MB
|-
| Microsoft Windows 2003
| Service Pack 1 (x86 & x86-64)
| 236
|-
| Microsoft Windows XP
| Service Pack 3 (x86 & x86-64)
| 236
|-
| Microsoft Windows 7
| Service Pack 1 (x86 & x86-64)
| 236
|-
| Microsoft Windows 2003
| R2 (x86 & x86-64)
| 236
|-
| Microsoft Windows 2008
| R2 (x86 & x86-64)
| 236
|-
|}

'''Oracle Java 1.6.0 must be installed on system before you start the installation of {{GVESB}}'''

Before you can install {{GVESB}} the Oracle JDK 1.6.0 must be installed on your system. 
The GreenVulcano Universal Installer is a java based application and needs the Oracle JDK 1.6.0 to be executed.

'''Installer Account'''

You must have administrator privileges for the machine on which {{GVESB}} is installed. 
If you do not have administrator privileges, you must then log out of the system and log in as a user with the required privileges, or request your
system administrator to assign the privileges to your account. 

'''Installing {{GVESB}} on Microsoft Windows'''

If you are installing for the first time, you can specify the installation directory where {{GVESB}} will be installed. 
On Microsoft Windows, the default installation directory is ''C:\Program File''. 

With the new GreenVulcano Universal Installer is possible to install multiple {{GVESB}} sharing the same JBoss 5.1.0 GA application server. 

If you want to use your own JBoss 5.1.0 GA installation you can choose ''"Custom Installation"'' and deselect the ''"JBoss AS 5.1.0.GA"'' package. 

The installer will creates one instance under server directory of your JBoss 5.1.0 GA installation for each {{GVESB}} installation. 

On Microsoft Windows you can install only by using GUI mode.

* [[Install using GUI Mode]]

Install using Console Mode

2012-03-27T22:05:12Z

N.decarlo:

The Console Mode enable platforms where graphic environment is not available to install {{GVESB}}. 

It is available just for *nix platform running:
GreenVulcanoUniversalInstaller.bin -console

'''Available Installation Options'''

The available installation options are shown on [[Installer Overview]] page. 

If you need some help on how to use the installer you can simply run:
GreenVulcanoUniversalInstaller.bin -help

All the available options will be shown.

To install {{GVESB}} in Console Mode:
# Open the physical media or download the {{GVESB}} package.
# Extract the {{GVESB}} archive file to a temporary directory.
# Navigate to the temporary directory.
# Run GreenVulcanoUniversalInstaller with -console option. The Welcome screen displays.
# Digit 1 to continue. The License Agreement screen appears. After reading through the license text, digit 1 to ''"accept the terms of the license agreement"''. Digit 1 to continue.
# The Installation Type screen displays. Choose ''"Complete Installation"'' by typing 0 or ''"Custom Installation"'' typing 1 then click 1 to continue.
# The Installation Target Path selection screen displays. Choose your target installation path (INSTALL_PATH) then digit 1.
# If you choose ''"Custom Installation"'' as Installation Type the Select Installation Packages screen displays. You can choose to deselect ''"JBoss AS 5.1.0.GA"'' package if you already have your own installation and you want to use it to deploy {{GVESB}} typing 0 otherwise press Enter. Digit 1 to continue.
# The jBoss Configuration screen display. You should now specify the following parameters for your JBoss instance, pressing Enter you accept the default between bracket:
##'''JBoss Installation Path:''' where JBoss AS 5.1.0.GA must be installed or where it is installed in case you choose ''"Custom Installation"'' and deselect ''"JBoss AS 5.1.0.GA"'' package.
##'''Server Name:''' The name of the server that will be deployed under server/ directory; default is ''"GreenV"''. If you are installing another server in the INSTALL_PATH where there are other servers be sure that its name will differs from the others.
##'''Server Address:''' The server address on which the ''"Server Name"'' will listen on.; default ''"0.0.0.0"'' means all available addresses.
##'''JBoss Port Configuration:''' The portset that will be used by the server; ''"ports-default"'' means the standard ports, for instance HTTP port is 8080. You can choose different portset to be sure that those ports are available on your system typing the respective number then press Enter:
### ports-default: The standard ports, for instance HTTP port is 8080.
### ports-01: The standard ports incremented by 100. For example, HTTP is on 8180.
### ports-02: The standard ports incremented by 200. For example, HTTP is on 8280.
### ports-03: The standard ports incremented by 300. For example, HTTP is on 8380.
##'''Username:''' The username for GV Console administration; default is ''"admin"''.
##'''Password:''' The username password; please note that passwords must contains at least (1) upper case letter, (1) lower case letter, (1) number or special character and must be at least (8) characters in length.
#Digit 1 to continue.
#If you choose ''"Custom Installation"'' as Installation Type the Process Panel screen display. The installer check for your JBoss 5.1.0 GA version for compatibility reason. If it is compatible a confirmation message will display. Digit 1 to continue.
#The installation process will now start copying files on your system.
#The Post Processing screen display. The installer configures the startup scripts and GV Console properties files with parameters defined at point 9.
#The Post Installation Summary screen display. The installation is successfully completed. Some useful information are displayed like:
##'''[[Post Installation]] Requirement'''
##'''[[Starting]] {{GVESB}}'''
##'''[[Uninstall]] {{GVESB}}'''
##'''Support'''
#Press Enter to go through such information.
#Installation finished.

Uninstall

2012-03-27T22:04:15Z

N.decarlo: moved Unistall to Uninstall

To uninstall your {{GVESB}} you can simply navigate through the Uninstaller directory located under your GV_HOME path and invoke: 
''java -jar GreenVulcano_Uninstaller.jar'' 

In case you have multiple GV_HOME on your system in the same INSTALL_PATH that sharing the same JBoss 5.1.0 GA installation please leave the ''"Force deletion of"'' checkbox unselected. 

Please note: The ''"Force deletion of"'' checkbox if selected will remove all the files and directories under your INSTALL_PATH. 

''If you have been installed {{GVESB}} using the [[Manual Installation]] method you can simply remove the GV_HOME directory and JBOSS_HOME directory if you want remove jboss as well.''

Unistall

2012-03-27T22:04:15Z

N.decarlo: moved Unistall to Uninstall

#REDIRECT [[Uninstall]]

Install using GUI Mode

2012-03-27T22:03:45Z

N.decarlo:

To install {{GVESB}} in GUI mode:
# Open the physical media or download the {{GVESB}} package.
# Extract the {{GVESB}} archive file to a temporary directory.
# Navigate to the temporary directory.
# Run GreenVulcanoUniversalInstaller. The Welcome screen displays.
# Click Next. The License Agreement screen appears. After reading through the license text, click ''"I accept the terms of the license agreement"'' and then click Next.
# The Installation Type screen displays. Choose ''"Complete Installation"'' or ''"Custom Installation"'' then click Next.
# The Installation Target Path selection screen displays. Choose your target installation path (INSTALL_PATH) then click Next.
# If you choose ''"Custom Installation"'' as Installation Type the Select Installation Packages screen displays. You can choose to deselect ''"JBoss AS 5.1.0.GA"'' package if you already have your own installation and you want to use it to deploy {{GVESB}}. Click Next.
# The jBoss Configuration screen display. You should now specify the following parameters for your JBoss instance:
##'''JBoss Installation Path:''' where JBoss AS 5.1.0.GA must be installed or where it is installed in case you choose ''"Custom Installation"'' and deselect ''"JBoss AS 5.1.0.GA"'' package.
##'''Server Name:''' The name of the server that will be deployed under server/ directory; default is ''"GreenV"''. If you are installing another server in the INSTALL_PATH where there are other servers be sure that its name will differs from the others.
##'''Server Address:''' The server address on which the ''"Server Name"'' will listen on.; default ''"0.0.0.0"'' means all available addresses.
##'''JBoss Port Configuration:''' The portset that will be used by the server; ''"ports-default"'' means the standard ports, for instance HTTP port is 8080. You can choose different portset to be sure that those ports are available on your system:
### ports-default: The standard ports, for instance HTTP port is 8080.
### ports-01: The standard ports incremented by 100. For example, HTTP is on 8180.
### ports-02: The standard ports incremented by 200. For example, HTTP is on 8280.
### ports-03: The standard ports incremented by 300. For example, HTTP is on 8380.
##'''Username:''' The username for GV Console administration; default is ''"admin"''.
##'''Password:''' The username password; please note that passwords must contains at least (1) upper case letter, (1) lower case letter, (1) number or special character and must be at least (8) characters in length.
#Click Next. If you choose ''"Custom Installation"'' as Installation Type the Summary Installation screen display. Click Next.
#If you choose ''"Custom Installation"'' as Installation Type the Process Panell screen display. The installer check for your JBoss 5.1.0 GA version for compatibility reason. If it is compatible a confirmation message will display. Click Next.
#The installation process will now start copying files on your system. Click Next when finish.
#The Post Processing screen display. The installer configures the startup scripts and GV Console properties files with parameters defined at point 9. Click Next.
#The Post Installation Summary screen display. The installation is successfully completed. Some useful information are displayed like:
##'''[[Post Installation]] Requirement'''; only *nix platforms
##'''[[Starting]] {{GVESB}}'''
##'''[[Uninstall]] {{GVESB}}'''
##'''Support'''
#Click Next. Installation finished. Click Done to complete installation.

Uninstall

2012-03-27T22:02:23Z

N.decarlo:

Uninstall

2012-03-27T22:01:48Z

N.decarlo:

To uninstall your {{GVESB}} you can simply navigate through the Uninstaller directory located under your GV_HOME path and invoke: 
''java -jar GreenVulcano_Uninstaller.jar'' 

In case you have multiple GV_HOME on your system in the same INSTALL_PATH that sharing the same JBoss 5.1.0 GA installation please leave the ''"Force deletion of"'' checkbox unselected. 

Please note: The ''"Force deletion of"'' checkbox if selected will remove all the files and directories under your INSTALL_PATH. 

''If you have been installed {{GVESB}} using the [[Manual Installation]] Method you can simply remove the GV_HOME directory and JBOSS_HOME directory if you want remove jboss as well.''

Uninstall

2012-03-27T22:01:23Z

N.decarlo:

To uninstall your {{GVESB}} you can simply navigate through the Uninstaller directory located under your GV_HOME path and invoke: 
''java -jar GreenVulcano_Uninstaller.jar'' 

In case you have multiple GV_HOME on your system in the same INSTALL_PATH that sharing the same JBoss 5.1.0 GA installation please leave the ''"Force deletion of"'' checkbox unselected. 

Please note: The ''"Force deletion of"'' checkbox if selected will remove all the files and directories under your INSTALL_PATH.

''If you have been installed {{GVESB}} using the [[Manual Installation]] Method you can simply remove the GV_HOME directory and JBOSS_HOME directory if you want remove jboss as well.''

Uninstall

2012-03-27T22:00:53Z

N.decarlo: Created page with "To uninstall your {{GVESB}} you can simply navigate through the Uninstaller directory located under your GV_HOME path and invoke: ''java -jar GreenVulcano_Uninstaller.jar'..."

To uninstall your {{GVESB}} you can simply navigate through the Uninstaller directory located under your GV_HOME path and invoke: 
''java -jar GreenVulcano_Uninstaller.jar'' 

In case you have multiple GV_HOME on your system in the same INSTALL_PATH that sharing the same JBoss 5.1.0 GA installation please leave the ''"Force deletion of"'' checkbox unselected. 

Please note: The ''"Force deletion of"'' checkbox if selected will remove all the files and directories under your INSTALL_PATH.

''If you have been installed {{GVESB}} without using the [[Manual Installation]] Method you can simply remove the GV_HOME directory and JBOSS_HOME directory if you want remove jboss as well.''

Install using GUI Mode

2012-03-27T21:55:49Z

N.decarlo:

To install {{GVESB}} in GUI mode:
# Open the physical media or download the {{GVESB}} package.
# Extract the {{GVESB}} archive file to a temporary directory.
# Navigate to the temporary directory.
# Run GreenVulcanoUniversalInstaller. The Welcome screen displays.
# Click Next. The License Agreement screen appears. After reading through the license text, click ''"I accept the terms of the license agreement"'' and then click Next.
# The Installation Type screen displays. Choose ''"Complete Installation"'' or ''"Custom Installation"'' then click Next.
# The Installation Target Path selection screen displays. Choose your target installation path (INSTALL_PATH) then click Next.
# If you choose ''"Custom Installation"'' as Installation Type the Select Installation Packages screen displays. You can choose to deselect ''"JBoss AS 5.1.0.GA"'' package if you already have your own installation and you want to use it to deploy {{GVESB}}. Click Next.
# The jBoss Configuration screen display. You should now specify the following parameters for your JBoss instance:
##'''JBoss Installation Path:''' where JBoss AS 5.1.0.GA must be installed or where it is installed in case you choose ''"Custom Installation"'' and deselect ''"JBoss AS 5.1.0.GA"'' package.
##'''Server Name:''' The name of the server that will be deployed under server/ directory; default is ''"GreenV"''. If you are installing another server in the INSTALL_PATH where there are other servers be sure that its name will differs from the others.
##'''Server Address:''' The server address on which the ''"Server Name"'' will listen on.; default ''"0.0.0.0"'' means all available addresses.
##'''JBoss Port Configuration:''' The portset that will be used by the server; ''"ports-default"'' means the standard ports, for instance HTTP port is 8080. You can choose different portset to be sure that those ports are available on your system:
### ports-default: The standard ports, for instance HTTP port is 8080.
### ports-01: The standard ports incremented by 100. For example, HTTP is on 8180.
### ports-02: The standard ports incremented by 200. For example, HTTP is on 8280.
### ports-03: The standard ports incremented by 300. For example, HTTP is on 8380.
##'''Username:''' The username for GV Console administration; default is ''"admin"''.
##'''Password:''' The username password; please note that passwords must contains at least (1) upper case letter, (1) lower case letter, (1) number or special character and must be at least (8) characters in length.
#Click Next. If you choose ''"Custom Installation"'' as Installation Type the Summary Installation screen display. Click Next.
#If you choose ''"Custom Installation"'' as Installation Type the Process Panell screen display. The installer check for your JBoss 5.1.0 GA version for compatibility reason. If it is compatible a confirmation message will display. Click Next.
#The installation process will now start copying files on your system. Click Next when finish.
#The Post Processing screen display. The installer configures the startup scripts and GV Console properties files with parameters defined at point 9. Click Next.
#The Post Installation Summary screen display. The installation is successfully completed. Some useful information are displayed like:
##'''[[Post Installation]] Requirement'''; only *nix platforms
##'''[[Starting]] {{GVESB}}'''
##'''Uninstall {{GVESB}}'''
##'''Support'''
#Click Next. Installation finished. Click Done to complete installation.

Installing on UNIX Systems

2012-03-27T21:50:52Z

N.decarlo:

Before starting the installation procedure, review the topics in this section to determine that your system meets the basic requirements
and that you have the prerequisite software installed. 

The following is a list of prerequisites for installing {{GVESB}} on UNIX systems. 

''Supported platforms for UNIX Systems''

{| class="gvtable"
! Platform
! Notes
! Disk Space MB
|-
| IBM AIX 5.3 AIX 6.1 AIX 7.1
| IBM (POWER PPC64)
| 232
|-
| Red Hat Red Hat Enterprise Linux 4.x Red Hat Enterprise Linux 5.x Red Hat Enterprise Linux 6.x
| Also includes all Linux distributions that are materially equivalent to the supported Red Hat Enterprise Linux versions.
| 232
|-
| HP HP-UX 11i
| HP-UX 11i v2/11.23 on IA-64/Itanium
| 232
|-
| Solaris Solaris 8 Solaris 9 Solaris 10
| SPARC and x86-64 (only Solaris 10)
| 232
|-
|}

'''Oracle Java 1.6.0 must be installed on system before you start the installation of {{GVESB}}'''

Before you can install {{GVESB}} the Oracle JDK 1.6.0 must be installed on your system. 
The GreenVulcano Universal Installer is a java based application and needs the Oracle JDK 1.6.0 to be executed.

'''Installer Account'''

The GreenVulcanoUniversallInstaller doesn't require to run with administrative privileges. 

'''Installing {{GVESB}} on UNIX Systems'''

If you are installing for the first time, you can specify the installation directory where {{GVESB}} will be installed. 
On UNIX Systems, the default installation directory is the user home directory with which the installer is executed. 

With the new GreenVulcano Universal Installer is possible to install multiple {{GVESB}} sharing the same JBoss 5.1.0 GA application server. 

If you want to use your own JBoss 5.1.0 GA installation you can choose ''"Custom Installation"'' and deselect the ''"JBoss AS 5.1.0.GA"'' package. 

The installer will creates one instance under server directory of your JBoss 5.1.0 GA installation for each {{GVESB}} installation. 

On UNIX Systems you can install by using .

* [[Install using GUI Mode]]
* [[Install using Console Mode]]

Installing on UNIX Systems

2012-03-27T21:50:24Z

N.decarlo:

Before starting the installation procedure, review the topics in this section to determine that your system meets the basic requirements
and that you have the prerequisite software installed. 

The following is a list of prerequisites for installing {{GVESB}} on UNIX systems. 

''Supported platforms for UNIX Systems''

{| class="gvtable"
! Platform
! Notes
! Disk Space MB
|-
| IBM AIX 5.3 AIX 6.1 AIX 7.1
| IBM (POWER PPC64)
| 232
|-
| Red Hat Red Hat Enterprise Linux 4.x Red Hat Enterprise Linux 5.x Red Hat Enterprise Linux 6.x
| Also includes all Linux distributions that are materially equivalent to the supported Red Hat Enterprise Linux versions.
| 232
|-
| HP HP-UX 11i
| SPARC and x86-64 (only Solaris 10)
| 232
|-
| Solaris Solaris 8 Solaris 9 Solaris 10
| HP-UX 11i v2/11.23 on IA-64/Itanium
| 232
|-
|}

'''Oracle Java 1.6.0 must be installed on system before you start the installation of {{GVESB}}'''

Before you can install {{GVESB}} the Oracle JDK 1.6.0 must be installed on your system. 
The GreenVulcano Universal Installer is a java based application and needs the Oracle JDK 1.6.0 to be executed.

'''Installer Account'''

The GreenVulcanoUniversallInstaller doesn't require to run with administrative privileges. 

'''Installing {{GVESB}} on UNIX Systems'''

If you are installing for the first time, you can specify the installation directory where {{GVESB}} will be installed. 
On UNIX Systems, the default installation directory is the user home directory with which the installer is executed. 

With the new GreenVulcano Universal Installer is possible to install multiple {{GVESB}} sharing the same JBoss 5.1.0 GA application server. 

If you want to use your own JBoss 5.1.0 GA installation you can choose ''"Custom Installation"'' and deselect the ''"JBoss AS 5.1.0.GA"'' package. 

The installer will creates one instance under server directory of your JBoss 5.1.0 GA installation for each {{GVESB}} installation. 

On UNIX Systems you can install by using .

* [[Install using GUI Mode]]
* [[Install using Console Mode]]

Installer Overview

2012-03-27T21:49:03Z

N.decarlo:

The installer allows you to run in two different modes:

# GUI mode
# Console mode

'''GUI mode'''

In GUI mode, the installer presents a wizard that allows you to make your choices about product configuration and component selection. 
When you start the installer by simply execute it, GUI mode is used.

'''Console mode'''

Console mode allows you to run the installer from a command line. 
It is useful on system where a graphic environment is not available.

'''Required and Optional Third Party Components'''

Depending on the tasks you wish to perform, you must install one or more other third party components.

''Required and Optional Components''

{| class="gvtable"
! Component
! Purpose
|-
| Oracle JDK 1.6.0 or higher
| Required. Oracle JDK 1.6.0 is required to start the GreenVulcano Universal Installer.
|-
| JBoss 5.1.0 GA
| Optional. JBoss 5.1.0 GA Application Server is part of the installation process but you can choose to not install it using your already existing installtion. Please note that different versions are not supported and the installer will exit.
|-
|}

'''GreenVulcano Universal Installer'''

{{GVESB}} is based on GreenVulcano Universal Installer 1.0.0 which supports multiple GV_HOME installation on a system and will have a screen asking whether to use a new or an existing JBoss 5.1.0 GA installation. 
When installing {{GVESB}}, you should always use the same JBoss 5.1.0 GA installation simply choosing "Custom Installation" deselecting the "JBoss AS 5.1.0.GA" package and selecting your JBOSS_HOME when asked. 

'''Available Installation Options'''

Running the GreenVulcano Universal Installer the following options are available for certain platforms in both Console and GUI mode:

{| class="gvtable"
! Platform
! Options
! Purpose
|-
| Linux x86
| -java-home -console 
| JRE directory which point to desired bin/java executable. Run the installer in console mode.
|-
| Linux x86-64
| -java-home -console 
| JRE directory which point to desired bin/java executable. Run the installer in console mode.
|-
| Solaris (SPARC) (64-bit)
| -java-home -console 
| JRE directory which point to desired bin/java executable. Run the installer in console mode.
|-
| Solaris (x86-64)
| -java-home -console 
| JRE directory which point to desired bin/java executable. Run the installer in console mode.
|-
| IBM AIX (PPC64)
| -java-home -console 
| JRE directory which point to desired bin/java executable. Run the installer in console mode.
|-
| Microsoft Windows (all)
| no options
| The installer is available only in GUI mode without specifying any options.
|-
|}

* [[Installing on Microsoft Windows]]
* [[Installing on UNIX Systems]]

'''Uninstalling GreenVulcano ESB'''

To uninstall your {{GVESB}} you can simply navigate through the Uninstaller directory located under your GV_HOME path and invoke: 
''java -jar GreenVulcano_Uninstaller.jar'' 

In case you have multiple GV_HOME on your system in the same INSTALL_PATH that sharing the same JBoss 5.1.0 GA installation please leave the ''"Force deletion of"'' checkbox unselected. 

Please note: The ''"Force deletion of"'' checkbox if selected will remove all the files and directories under your INSTALL_PATH.

Installer Overview

2012-03-27T21:47:30Z

N.decarlo:

The installer allows you to run in two different modes:

# GUI mode
# Console mode

'''GUI mode'''

In GUI mode, the installer presents a wizard that allows you to make your choices about product configuration and component selection. 
When you start the installer by simply execute it, GUI mode is used.

'''Console mode'''

Console mode allows you to run the installer from a command line. 
It is useful on system where a graphic environment is not available.

'''Required and Optional Third Party Components'''

Depending on the tasks you wish to perform, you must install one or more other third party components.

''Required and Optional Components''

{| class="gvtable"
! Component
! Purpose
|-
| Oracle JDK 1.6.0 or higher
| Required. Oracle JDK 1.6.0 is required to start the GreenVulcano Universal Installer.
|-
| JBoss 5.1.0 GA
| Optional. JBoss 5.1.0 GA Application Server is part of the installation process but you can choose to not install it using your already existing installtion. Please note that different versions are not supported and the installer will exit.
|-
|}

'''GreenVulcano Universal Installer'''

{{GVESB}} is based on GreenVulcano Universal Installer 1.0.0 which supports multiple GV_HOME installation on a system and will have a screen asking whether to use a new or an existing JBoss 5.1.0 GA installation. 
When installing {{GVESB}}, you should always use the same JBoss 5.1.0 GA installation simply choosing "Custom Installation" deselecting the "JBoss AS 5.1.0.GA" package and selecting your JBOSS_HOME when asked. 

'''Available Installation Options'''

Running the GreenVulcano Universal Installer the following options are available for certain platforms in both Console and GUI mode:

{| class="gvtable"
! Platform
! Options
! Purpose
|-
| Linux x86
| -java-home -console 
| JRE directory which point to desired bin/java executable. Run the installer in console mode.
|-
| Linux x86-64
| -java-home -console 
| JRE directory which point to desired bin/java executable. Run the installer in console mode.
|-
| Solaris (SPARC) (64-bit)
| -java-home -console 
| JRE directory which point to desired bin/java executable. Run the installer in console mode.
|-
| Solaris (x86-64)
| -java-home -console 
| JRE directory which point to desired bin/java executable. Run the installer in console mode.
|-
| IBM AIX (PPC64)
| -java-home -console 
| JRE directory which point to desired bin/java executable. Run the installer in console mode.
|-
| Microsoft Windows (all)
| no options
| The installer is available only in GUI mode without specifying any options.
|-
|}

* [[Installing on Microsoft Windows]]
* [[Installing on UNIX Sistems]]

'''Uninstalling GreenVulcano ESB'''

To uninstall your {{GVESB}} you can simply navigate through the Uninstaller directory located under your GV_HOME path and invoke: 
''java -jar GreenVulcano_Uninstaller.jar'' 

In case you have multiple GV_HOME on your system in the same INSTALL_PATH that sharing the same JBoss 5.1.0 GA installation please leave the ''"Force deletion of"'' checkbox unselected. 

Please note: The ''"Force deletion of"'' checkbox if selected will remove all the files and directories under your INSTALL_PATH.

Installer Overview

2012-03-27T21:47:09Z

N.decarlo:

The installer allows you to run in two different modes:

# GUI mode
# Console mode

'''GUI mode'''

In GUI mode, the installer presents a wizard that allows you to make your choices about product configuration and component selection. 
When you start the installer by simply execute it, GUI mode is used.

'''Console mode'''

Console mode allows you to run the installer from a command line. 
It is useful on system where a graphic environment is not available.

'''Required and Optional Third Party Components'''

Depending on the tasks you wish to perform, you must install one or more other third party components.

''Required and Optional Components''

{| class="gvtable"
! Component
! Purpose
|-
| Oracle JDK 1.6.0 or higher
| Required. Oracle JDK 1.6.0 is required to start the GreenVulcano Universal Installer.
|-
| JBoss 5.1.0 GA
| Optional. JBoss 5.1.0 GA Application Server is part of the installation process but you can choose to not install it using your already existing installtion. Please note that different versions are not supported and the installer will exit.
|-
|}

'''GreenVulcano Universal Installer'''

{{GVESB}} is based on GreenVulcano Universal Installer 1.0.0 which supports multiple GV_HOME installation on a system and will have a screen asking whether to use a new or an existing JBoss 5.1.0 GA installation. 
When installing {{GVESB}}, you should always use the same JBoss 5.1.0 GA installation simply choosing "Custom Installation" deselecting the "JBoss AS 5.1.0.GA" package and selecting your JBOSS_HOME when asked. 

'''Available Installation Options'''

Running the GreenVulcano Universal Installer the following options are available for certain platforms in both Console and GUI mode:

{| class="gvtable"
! Platform
! Options
! Purpose
|-
| Linux x86
| -java-home -console 
| JRE directory which point to desired bin/java executable. Run the installer in console mode.
|-
| Linux x86-64
| -java-home -console 
| JRE directory which point to desired bin/java executable. Run the installer in console mode.
|-
| Solaris (SPARC) (64-bit)
| -java-home -console 
| JRE directory which point to desired bin/java executable. Run the installer in console mode.
|-
| Solaris (x86-64)
| -java-home -console 
| JRE directory which point to desired bin/java executable. Run the installer in console mode.
|-
| IBM AIX (PPC64)
| -java-home -console 
| JRE directory which point to desired bin/java executable. Run the installer in console mode.
|-
| Microsoft Windows (all)
| no options
| The installer is available only in GUI mode without specifying any options.
|-
|}

* [[Installing on Microsoft Windows]]
* [[Installing on UNIX Sistems]]

'''Uninstalling GreenVulcano ESB'''

To uninstall your {{GVESB}} you can simply navigate through the Uninstaller directory located under your GV_HOME path and invoke: 
''java -jar GreenVulcano_Uninstaller.jar'' 

In case you have multiple GV_HOME on your system in the same INSTALL_PATH that sharing the same JBoss 5.1.0 GA installation please leave the ''"Force deletion of"'' checkbox unselected. 

Please note: The ''"Force deletion of"'' checkbox if selected will remove all the files and directories under your INSTALL_PATH.

Manual Installation

2012-03-27T21:38:52Z

N.decarlo: moved Installing on Other Systems to Manual Installation

This section describes the {{GVESB}} installation steps on systems unsupported by the GreenVulcanoUniversalInstaller or when you are unable to run it.

'''Copy the file'''
# 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.
{| class="note"
|-
| 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.2.0.other.zip
|}
{| 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.
|}

'''Environment configuration'''

Before using {{GVESB}} 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 {{GVESB}} has been installed;
# Configure the GV_SERVER environment variable with the absolute path where is the JBoss server of {{GVESB}};
# Configure the JAVA_HOME environment variable with the absolute path where JDK is installed.

Follow the examples below to configure properly the environment variables.
{| class="note"
|-
| [[File:linux.png]]
| In case of *nix operating systems, edit the file ''env_GreenV.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
|}

{| class="note"
|-
| [[File:windows.png]]
| In case of Microsoft Windows operating systems, edit the file ''env_GreenV.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 ''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"
! 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
| {{GVESB}} options. -Dgv.app.home=$GV_HOME -Dit.greenvulcano.util.xpath.search.XPathAPIFactory.cfgFileXPath=GVCore.xml<nowiki>|</nowiki>/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
|-
|}

Installing on Other Systems

2012-03-27T21:38:52Z

N.decarlo: moved Installing on Other Systems to Manual Installation

#REDIRECT [[Manual Installation]]

Manual Installation

2012-03-27T21:36:13Z

N.decarlo:

This section describes the {{GVESB}} installation steps on systems unsupported by the GreenVulcanoUniversalInstaller or when you are unable to run it.

'''Copy the file'''
# 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.
{| class="note"
|-
| 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.2.0.other.zip
|}
{| 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.
|}

'''Environment configuration'''

Before using {{GVESB}} 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 {{GVESB}} has been installed;
# Configure the GV_SERVER environment variable with the absolute path where is the JBoss server of {{GVESB}};
# Configure the JAVA_HOME environment variable with the absolute path where JDK is installed.

Follow the examples below to configure properly the environment variables.
{| class="note"
|-
| [[File:linux.png]]
| In case of *nix operating systems, edit the file ''env_GreenV.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
|}

{| class="note"
|-
| [[File:windows.png]]
| In case of Microsoft Windows operating systems, edit the file ''env_GreenV.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 ''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"
! 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
| {{GVESB}} options. -Dgv.app.home=$GV_HOME -Dit.greenvulcano.util.xpath.search.XPathAPIFactory.cfgFileXPath=GVCore.xml<nowiki>|</nowiki>/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
|-
|}

Manual Installation

2012-03-27T21:30:43Z

N.decarlo: Created page with "This section describes the {{GVESB}} installation steps. '''Copy the file''' # Unzip the file ''GvEnterprise3.2.0.zip'' in any directory on the server where you plan to install ..."

This section describes the {{GVESB}} installation steps.

'''Copy the file'''
# Unzip the file ''GvEnterprise3.2.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"
|-
| 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.2.0.zip
|}
{| 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.
|}

'''Environment configuration'''

Before using {{GVESB}} 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 {{GVESB}} has been installed;
# Configure the GV_SERVER environment variable with the absolute path where is the JBoss server of {{GVESB}};
# Configure the JAVA_HOME environment variable with the absolute path where JDK is installed.

Follow the examples below to configure properly the environment variables.
{| class="note"
|-
| [[File:linux.png]]
| In case of *nix operating systems, edit the file ''env_GreenV.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
|}

{| class="note"
|-
| [[File:windows.png]]
| In case of Microsoft Windows operating systems, edit the file ''env_GreenV.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 ''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"
! 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
| {{GVESB}} options. -Dgv.app.home=$GV_HOME -Dit.greenvulcano.util.xpath.search.XPathAPIFactory.cfgFileXPath=GVCore.xml<nowiki>|</nowiki>/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
|-
|}

Installing on UNIX Systems

2012-03-27T21:24:50Z

N.decarlo:

Before starting the installation procedure, review the topics in this section to determine that your system meets the basic requirements
and that you have the prerequisite software installed. 

The following is a list of prerequisites for installing {{GVESB}} on UNIX systems. 

''Supported platforms for UNIX Systems''

{| class="gvtable"
! Platform
! Notes
! Disk Space MB
|-
| IBM AIX 5.3 AIX 6.1 AIX 7.1
| IBM (POWER PPC64)
| 232
|-
| Red Hat Red Hat Enterprise Linux 4.x Red Hat Enterprise Linux 5.x Red Hat Enterprise Linux 6.x
| Also includes all Linux distributions that are materially equivalent to the supported Red Hat Enterprise Linux versions.
| 232
|-
| Solaris Solaris 8 Solaris 9 Solaris 10
| SPARC and x86-64 (only Solaris 10)
| 232
|-
|}

'''Oracle Java 1.6.0 must be installed on system before you start the installation of {{GVESB}}'''

Before you can install {{GVESB}} the Oracle JDK 1.6.0 must be installed on your system. 
The GreenVulcano Universal Installer is a java based application and needs the Oracle JDK 1.6.0 to be executed.

'''Installer Account'''

The GreenVulcanoUniversallInstaller doesn't require to run with administrative privileges. 

'''Installing {{GVESB}} on UNIX Systems'''

If you are installing for the first time, you can specify the installation directory where {{GVESB}} will be installed. 
On UNIX Systems, the default installation directory is the user home directory with which the installer is executed. 

With the new GreenVulcano Universal Installer is possible to install multiple {{GVESB}} sharing the same JBoss 5.1.0 GA application server. 

If you want to use your own JBoss 5.1.0 GA installation you can choose ''"Custom Installation"'' and deselect the ''"JBoss AS 5.1.0.GA"'' package. 

The installer will creates one instance under server directory of your JBoss 5.1.0 GA installation for each {{GVESB}} installation. 

On UNIX Systems you can install by using .

* [[Install using GUI Mode]]
* [[Install using Console Mode]]

Installing on UNIX Systems

2012-03-27T21:18:32Z

N.decarlo:

Before starting the installation procedure, review the topics in this section to determine that your system meets the basic requirements
and that you have the prerequisite software installed. 

The following is a list of prerequisites for installing {{GVESB}} on UNIX systems. 

''Supported platforms for UNIX Systems''

{| class="gvtable"
! Platform
! Notes
! Disk Space MB
|-
| IBM AIX 5.3 AIX 6.1 AIX 7.1
| IBM (POWER PPC64)
| 232
|-
| Red Hat Red Hat Enterprise Linux 4.x Red Hat Enterprise Linux 5.x Red Hat Enterprise Linux 6.x
| Also includes all Linux distributions that are materially equivalent to the supported Red Hat Enterprise Linux versions.
| 232
|-
| Solaris Solaris 8 Solaris 9 Solaris 10
| SPARC and x86-64 (only Solaris 10)
| 232
|-
|}

'''Oracle Java 1.6.0 must be installed on system before you start the installation of {{GVESB}}'''

Before you can install {{GVESB}} the Oracle JDK 1.6.0 must be installed on your system. 
The GreenVulcano Universal Installer is a java based application and needs the Oracle JDK 1.6.0 to be executed.

'''Installer Account'''

You must have administrator privileges for the machine on which {{GVESB}} is installed. 
If you do not have administrator privileges, you must then log out of the system and log in as a user with the required privileges, or request your
system administrator to assign the privileges to your account. 

'''Installing {{GVESB}} on Microsoft Windows'''

If you are installing for the first time, you can specify the installation directory where {{GVESB}} will be installed. 
On Microsoft Windows, the default installation directory is ''C:\Program File''. 

With the new GreenVulcano Universal Installer is possible to install multiple {{GVESB}} sharing the same JBoss 5.1.0 GA application server. 

If you want to use your own JBoss 5.1.0 GA installation you can choose ''"Custom Installation"'' and deselect the ''"JBoss AS 5.1.0.GA"'' package. 

The installer will creates one instance under server directory of your JBoss 5.1.0 GA installation for each {{GVESB}} installation. 

On Microsoft Windows you can install only by using GUI mode.

* [[Install using GUI Mode]]

Installing on UNIX Systems

2012-03-27T21:16:42Z

N.decarlo:

Before starting the installation procedure, review the topics in this section to determine that your system meets the basic requirements
and that you have the prerequisite software installed. 

The following is a list of prerequisites for installing {{GVESB}} on UNIX systems. 

''Supported platforms for UNIX Systems''

{| class="gvtable"
! Platform
! Notes
! Disk Space MB
|-
| IBM AIX 5.3 AIX 6.1 AIX 7.1
| IBM (POWER PPC64)
| 232
|-
| Red Hat Red Hat Enterprise Linux 4.x Red Hat Enterprise Linux 5.x Red Hat Enterprise Linux 6.x
| Also includes all Linux distributions that are materially equivalent to the supported Red Hat Enterprise Linux versions.
| 232
|-
| Microsoft Windows 7
| Service Pack 1 (x86 & x86-64)
| 233
|-
| Microsoft Windows 2003
| R2 (x86 & x86-64)
| 233
|-
| Microsoft Windows 2008
| R2 (x86 & x86-64)
| 233
|-
|}

'''Oracle Java 1.6.0 must be installed on system before you start the installation of {{GVESB}}'''

Before you can install {{GVESB}} the Oracle JDK 1.6.0 must be installed on your system. 
The GreenVulcano Universal Installer is a java based application and needs the Oracle JDK 1.6.0 to be executed.

'''Installer Account'''

You must have administrator privileges for the machine on which {{GVESB}} is installed. 
If you do not have administrator privileges, you must then log out of the system and log in as a user with the required privileges, or request your
system administrator to assign the privileges to your account. 

'''Installing {{GVESB}} on Microsoft Windows'''

If you are installing for the first time, you can specify the installation directory where {{GVESB}} will be installed. 
On Microsoft Windows, the default installation directory is ''C:\Program File''. 

With the new GreenVulcano Universal Installer is possible to install multiple {{GVESB}} sharing the same JBoss 5.1.0 GA application server. 

If you want to use your own JBoss 5.1.0 GA installation you can choose ''"Custom Installation"'' and deselect the ''"JBoss AS 5.1.0.GA"'' package. 

The installer will creates one instance under server directory of your JBoss 5.1.0 GA installation for each {{GVESB}} installation. 

On Microsoft Windows you can install only by using GUI mode.

* [[Install using GUI Mode]]

Installing on UNIX Systems

2012-03-27T21:13:04Z

N.decarlo:

Before starting the installation procedure, review the topics in this section to determine that your system meets the basic requirements
and that you have the prerequisite software installed. 

The following is a list of prerequisites for installing {{GVESB}} on UNIX systems. 

''Supported platforms for UNIX Systems''

{| class="gvtable"
! Platform
! Notes
! Disk Space MB
|-
| IBM AIX 5.3
| Service Pack 1 (x86 & x86-64)
| 233
|-
| Microsoft Windows XP
| Service Pack 3 (x86 & x86-64)
| 233
|-
| Microsoft Windows 7
| Service Pack 1 (x86 & x86-64)
| 233
|-
| Microsoft Windows 2003
| R2 (x86 & x86-64)
| 233
|-
| Microsoft Windows 2008
| R2 (x86 & x86-64)
| 233
|-
|}

'''Oracle Java 1.6.0 must be installed on system before you start the installation of {{GVESB}}'''

Before you can install {{GVESB}} the Oracle JDK 1.6.0 must be installed on your system. 
The GreenVulcano Universal Installer is a java based application and needs the Oracle JDK 1.6.0 to be executed.

'''Installer Account'''

You must have administrator privileges for the machine on which {{GVESB}} is installed. 
If you do not have administrator privileges, you must then log out of the system and log in as a user with the required privileges, or request your
system administrator to assign the privileges to your account. 

'''Installing {{GVESB}} on Microsoft Windows'''

If you are installing for the first time, you can specify the installation directory where {{GVESB}} will be installed. 
On Microsoft Windows, the default installation directory is ''C:\Program File''. 

With the new GreenVulcano Universal Installer is possible to install multiple {{GVESB}} sharing the same JBoss 5.1.0 GA application server. 

If you want to use your own JBoss 5.1.0 GA installation you can choose ''"Custom Installation"'' and deselect the ''"JBoss AS 5.1.0.GA"'' package. 

The installer will creates one instance under server directory of your JBoss 5.1.0 GA installation for each {{GVESB}} installation. 

On Microsoft Windows you can install only by using GUI mode.

* [[Install using GUI Mode]]

Installing on UNIX Systems

2012-03-27T21:09:37Z

N.decarlo: Created page with "Before starting the installation procedure, review the topics in this section to determine that your system meets the basic requirements and that you have the prerequisite softw..."

Before starting the installation procedure, review the topics in this section to determine that your system meets the basic requirements
and that you have the prerequisite software installed. 

The following is a list of prerequisites for installing {{GVESB}} on Microsoft Windows systems. 

''Supported platforms for Microsoft Windows''

{| class="gvtable"
! Platform
! Service Pack/Edition
! Disk Space MB
|-
| Microsoft Windows 2003
| Service Pack 1 (x86 & x86-64)
| 233
|-
| Microsoft Windows XP
| Service Pack 3 (x86 & x86-64)
| 233
|-
| Microsoft Windows 7
| Service Pack 1 (x86 & x86-64)
| 233
|-
| Microsoft Windows 2003
| R2 (x86 & x86-64)
| 233
|-
| Microsoft Windows 2008
| R2 (x86 & x86-64)
| 233
|-
|}

'''Oracle Java 1.6.0 must be installed on system before you start the installation of {{GVESB}}'''

Before you can install {{GVESB}} the Oracle JDK 1.6.0 must be installed on your system. 
The GreenVulcano Universal Installer is a java based application and needs the Oracle JDK 1.6.0 to be executed.

'''Installer Account'''

You must have administrator privileges for the machine on which {{GVESB}} is installed. 
If you do not have administrator privileges, you must then log out of the system and log in as a user with the required privileges, or request your
system administrator to assign the privileges to your account. 

'''Installing {{GVESB}} on Microsoft Windows'''

If you are installing for the first time, you can specify the installation directory where {{GVESB}} will be installed. 
On Microsoft Windows, the default installation directory is ''C:\Program File''. 

With the new GreenVulcano Universal Installer is possible to install multiple {{GVESB}} sharing the same JBoss 5.1.0 GA application server. 

If you want to use your own JBoss 5.1.0 GA installation you can choose ''"Custom Installation"'' and deselect the ''"JBoss AS 5.1.0.GA"'' package. 

The installer will creates one instance under server directory of your JBoss 5.1.0 GA installation for each {{GVESB}} installation. 

On Microsoft Windows you can install only by using GUI mode.

* [[Install using GUI Mode]]

Installing on Microsoft Windows

2012-03-27T21:06:10Z

N.decarlo:

Before starting the installation procedure, review the topics in this section to determine that your system meets the basic requirements
and that you have the prerequisite software installed. 

The following is a list of prerequisites for installing {{GVESB}} on Microsoft Windows systems. 

''Supported platforms for Microsoft Windows''

{| class="gvtable"
! Platform
! Service Pack/Edition
! Disk Space MB
|-
| Microsoft Windows 2003
| Service Pack 1 (x86 & x86-64)
| 233
|-
| Microsoft Windows XP
| Service Pack 3 (x86 & x86-64)
| 233
|-
| Microsoft Windows 7
| Service Pack 1 (x86 & x86-64)
| 233
|-
| Microsoft Windows 2003
| R2 (x86 & x86-64)
| 233
|-
| Microsoft Windows 2008
| R2 (x86 & x86-64)
| 233
|-
|}

'''Oracle Java 1.6.0 must be installed on system before you start the installation of {{GVESB}}'''

Before you can install {{GVESB}} the Oracle JDK 1.6.0 must be installed on your system. 
The GreenVulcano Universal Installer is a java based application and needs the Oracle JDK 1.6.0 to be executed.

'''Installer Account'''

You must have administrator privileges for the machine on which {{GVESB}} is installed. 
If you do not have administrator privileges, you must then log out of the system and log in as a user with the required privileges, or request your
system administrator to assign the privileges to your account. 

'''Installing {{GVESB}} on Microsoft Windows'''

If you are installing for the first time, you can specify the installation directory where {{GVESB}} will be installed. 
On Microsoft Windows, the default installation directory is ''C:\Program File''. 

With the new GreenVulcano Universal Installer is possible to install multiple {{GVESB}} sharing the same JBoss 5.1.0 GA application server. 

If you want to use your own JBoss 5.1.0 GA installation you can choose ''"Custom Installation"'' and deselect the ''"JBoss AS 5.1.0.GA"'' package. 

The installer will creates one instance under server directory of your JBoss 5.1.0 GA installation for each {{GVESB}} installation. 

On Microsoft Windows you can install only by using GUI mode.

* [[Install using GUI Mode]]

Install using Console Mode

2012-02-23T17:07:20Z

N.decarlo:

The Console Mode enable platforms where graphic environment is not available to install {{GVESB}}. 

It is available just for *nix platform running:
GreenVulcanoUniversalInstaller.bin -console

'''Available Installation Options'''

The available installation options are shown on [[Installer Overview]] page. 

If you need some help on how to use the installer you can simply run:
GreenVulcanoUniversalInstaller.bin -help

All the available options will be shown.

To install {{GVESB}} in Console Mode:
# Open the physical media or download the {{GVESB}} package.
# Extract the {{GVESB}} archive file to a temporary directory.
# Navigate to the temporary directory.
# Run GreenVulcanoUniversalInstaller with -console option. The Welcome screen displays.
# Digit 1 to continue. The License Agreement screen appears. After reading through the license text, digit 1 to ''"accept the terms of the license agreement"''. Digit 1 to continue.
# The Installation Type screen displays. Choose ''"Complete Installation"'' by typing 0 or ''"Custom Installation"'' typing 1 then click 1 to continue.
# The Installation Target Path selection screen displays. Choose your target installation path (INSTALL_PATH) then digit 1.
# If you choose ''"Custom Installation"'' as Installation Type the Select Installation Packages screen displays. You can choose to deselect ''"JBoss AS 5.1.0.GA"'' package if you already have your own installation and you want to use it to deploy {{GVESB}} typing 0 otherwise press Enter. Digit 1 to continue.
# The jBoss Configuration screen display. You should now specify the following parameters for your JBoss instance, pressing Enter you accept the default between bracket:
##'''JBoss Installation Path:''' where JBoss AS 5.1.0.GA must be installed or where it is installed in case you choose ''"Custom Installation"'' and deselect ''"JBoss AS 5.1.0.GA"'' package.
##'''Server Name:''' The name of the server that will be deployed under server/ directory; default is ''"GreenV"''. If you are installing another server in the INSTALL_PATH where there are other servers be sure that its name will differs from the others.
##'''Server Address:''' The server address on which the ''"Server Name"'' will listen on.; default ''"0.0.0.0"'' means all available addresses.
##'''JBoss Port Configuration:''' The portset that will be used by the server; ''"ports-default"'' means the standard ports, for instance HTTP port is 8080. You can choose different portset to be sure that those ports are available on your system typing the respective number then press Enter:
### ports-default: The standard ports, for instance HTTP port is 8080.
### ports-01: The standard ports incremented by 100. For example, HTTP is on 8180.
### ports-02: The standard ports incremented by 200. For example, HTTP is on 8280.
### ports-03: The standard ports incremented by 300. For example, HTTP is on 8380.
##'''Username:''' The username for GV Console administration; default is ''"admin"''.
##'''Password:''' The username password; please note that passwords must contains at least (1) upper case letter, (1) lower case letter, (1) number or special character and must be at least (8) characters in length.
#Digit 1 to continue.
#If you choose ''"Custom Installation"'' as Installation Type the Process Panel screen display. The installer check for your JBoss 5.1.0 GA version for compatibility reason. If it is compatible a confirmation message will display. Digit 1 to continue.
#The installation process will now start copying files on your system.
#The Post Processing screen display. The installer configures the startup scripts and GV Console properties files with parameters defined at point 9.
#The Post Installation Summary screen display. The installation is successfully completed. Some useful information are displayed like:
##'''Post Installation Requirement'''
##'''Starting {{GVESB}}'''
##'''Uninstall {{GVESB}}'''
##'''Support'''
#Press Enter to go through such information.
#Installation finished.

Install using Console Mode

2012-02-23T16:55:40Z

N.decarlo:

The Console Mode enable platforms where graphic environment is not available to install {{GVESB}}. 

It is available just for *nix platform running:
GreenVulcanoUniversalInstaller.bin -console

'''Available Installation Options'''

The available installation options are shown on [[Installer Overview]] page. 

If you need some help on how to use the installer you can simply run:
GreenVulcanoUniversalInstaller.bin -help

All the available options will be shown.

To install {{GVESB}} in Console Mode:
# Open the physical media or download the {{GVESB}} package.
# Extract the {{GVESB}} archive file to a temporary directory.
# Navigate to the temporary directory.
# Run GreenVulcanoUniversalInstaller with -console option. The Welcome screen displays.
# Digit 1 to continue. The License Agreement screen appears. After reading through the license text, digit 1 to ''"accept the terms of the license agreement"''. Digit 1 to accept the license.
# The Installation Type screen displays. Choose ''"Complete Installation"'' by typing 0 or ''"Custom Installation"'' typing 1 then click 1 to continue.
# The Installation Target Path selection screen displays. Choose your target installation path (INSTALL_PATH) then click Next.
# If you choose ''"Custom Installation"'' as Installation Type the Select Installation Packages screen displays. You can choose to deselect ''"JBoss AS 5.1.0.GA"'' package if you already have your own installation and you want to use it to deploy {{GVESB}}. Click Next.
# The jBoss Configuration screen display. You should now specify the following parameters for your JBoss instance:
##'''JBoss Installation Path:''' where JBoss AS 5.1.0.GA must be installed or where it is installed in case you choose ''"Custom Installation"'' and deselect ''"JBoss AS 5.1.0.GA"'' package.
##'''Server Name:''' The name of the server that will be deployed under server/ directory; default is ''"GreenV"''. If you are installing another server in the INSTALL_PATH where there are other servers be sure that its name will differs from the others.
##'''Server Address:''' The server address on which the ''"Server Name"'' will listen on.; default ''"0.0.0.0"'' means all available addresses.
##'''JBoss Port Configuration:''' The portset that will be used by the server; ''"ports-default"'' means the standard ports, for instance HTTP port is 8080. You can choose different portset to be sure that those ports are available on your system:
### ports-default: The standard ports, for instance HTTP port is 8080.
### ports-01: The standard ports incremented by 100. For example, HTTP is on 8180.
### ports-02: The standard ports incremented by 200. For example, HTTP is on 8280.
### ports-03: The standard ports incremented by 300. For example, HTTP is on 8380.
##'''Username:''' The username for GV Console administration; default is ''"admin"''.
##'''Password:''' The username password; please note that passwords must contains at least (1) upper case letter, (1) lower case letter, (1) number or special character and must be at least (8) characters in length.
#Click Next. If you choose ''"Custom Installation"'' as Installation Type the Summary Installation screen display. Click Next.
#If you choose ''"Custom Installation"'' as Installation Type the Process Panell screen display. The installer check for your JBoss 5.1.0 GA version for compatibility reason. If it is compatible a confirmation message will display. Click Next.
#The installation process will now start copying files on your system. Click Next when finish.
#The Post Processing screen display. The installer configures the startup scripts and GV Console properties files with parameters defined at point 9. Click Next.
#The Post Installation Summary screen display. The installation is successfully completed. Some useful information are displayed like:
##'''Post Installation Requirement'''; only *nix platforms
##'''Starting {{GVESB}}'''
##'''Uninstall {{GVESB}}'''
##'''Support'''
#Click Next. Installation finished. Click Done to complete installation.

Install using Console Mode

2012-02-23T16:51:29Z

N.decarlo:

The Console Mode enable platforms where graphic environment is not available to install {{GVESB}}. 

It is available just for *nix platform running:
GreenVulcanoUniversalInstaller.bin -console

'''Available Installation Options'''

The available installation options are shown on [[Installer Overview]] page. 

If you need some help on how to use the installer you can simply run:
GreenVulcanoUniversalInstaller.bin -help

All the available options will be shown.

To install {{GVESB}} in GUI mode:
# Open the physical media or download the {{GVESB}} package.
# Extract the {{GVESB}} archive file to a temporary directory.
# Navigate to the temporary directory.
# Run GreenVulcanoUniversalInstaller. The Welcome screen displays.
# Click Next. The License Agreement screen appears. After reading through the license text, click ''"I accept the terms of the license agreement"'' and then click Next.
# The Installation Type screen displays. Choose ''"Complete Installation"'' or ''"Custom Installation"'' then click Next.
# The Installation Target Path selection screen displays. Choose your target installation path (INSTALL_PATH) then click Next.
# If you choose ''"Custom Installation"'' as Installation Type the Select Installation Packages screen displays. You can choose to deselect ''"JBoss AS 5.1.0.GA"'' package if you already have your own installation and you want to use it to deploy {{GVESB}}. Click Next.
# The jBoss Configuration screen display. You should now specify the following parameters for your JBoss instance:
##'''JBoss Installation Path:''' where JBoss AS 5.1.0.GA must be installed or where it is installed in case you choose ''"Custom Installation"'' and deselect ''"JBoss AS 5.1.0.GA"'' package.
##'''Server Name:''' The name of the server that will be deployed under server/ directory; default is ''"GreenV"''. If you are installing another server in the INSTALL_PATH where there are other servers be sure that its name will differs from the others.
##'''Server Address:''' The server address on which the ''"Server Name"'' will listen on.; default ''"0.0.0.0"'' means all available addresses.
##'''JBoss Port Configuration:''' The portset that will be used by the server; ''"ports-default"'' means the standard ports, for instance HTTP port is 8080. You can choose different portset to be sure that those ports are available on your system:
### ports-default: The standard ports, for instance HTTP port is 8080.
### ports-01: The standard ports incremented by 100. For example, HTTP is on 8180.
### ports-02: The standard ports incremented by 200. For example, HTTP is on 8280.
### ports-03: The standard ports incremented by 300. For example, HTTP is on 8380.
##'''Username:''' The username for GV Console administration; default is ''"admin"''.
##'''Password:''' The username password; please note that passwords must contains at least (1) upper case letter, (1) lower case letter, (1) number or special character and must be at least (8) characters in length.
#Click Next. If you choose ''"Custom Installation"'' as Installation Type the Summary Installation screen display. Click Next.
#If you choose ''"Custom Installation"'' as Installation Type the Process Panell screen display. The installer check for your JBoss 5.1.0 GA version for compatibility reason. If it is compatible a confirmation message will display. Click Next.
#The installation process will now start copying files on your system. Click Next when finish.
#The Post Processing screen display. The installer configures the startup scripts and GV Console properties files with parameters defined at point 9. Click Next.
#The Post Installation Summary screen display. The installation is successfully completed. Some useful information are displayed like:
##'''Post Installation Requirement'''; only *nix platforms
##'''Starting {{GVESB}}'''
##'''Uninstall {{GVESB}}'''
##'''Support'''
#Click Next. Installation finished. Click Done to complete installation.

Install using Console Mode

2012-02-23T16:49:51Z

N.decarlo:

The Console Mode enable platforms where graphic environment is not available to install {{GVESB}}. 

It is available just for *nix platform running:
GreenVulcanoUniversalInstaller -console

'''Available Installation Options'''

The available installation options are shown on [[Installer Overview]] page.

To install {{GVESB}} in GUI mode:
# Open the physical media or download the {{GVESB}} package.
# Extract the {{GVESB}} archive file to a temporary directory.
# Navigate to the temporary directory.
# Run GreenVulcanoUniversalInstaller. The Welcome screen displays.
# Click Next. The License Agreement screen appears. After reading through the license text, click ''"I accept the terms of the license agreement"'' and then click Next.
# The Installation Type screen displays. Choose ''"Complete Installation"'' or ''"Custom Installation"'' then click Next.
# The Installation Target Path selection screen displays. Choose your target installation path (INSTALL_PATH) then click Next.
# If you choose ''"Custom Installation"'' as Installation Type the Select Installation Packages screen displays. You can choose to deselect ''"JBoss AS 5.1.0.GA"'' package if you already have your own installation and you want to use it to deploy {{GVESB}}. Click Next.
# The jBoss Configuration screen display. You should now specify the following parameters for your JBoss instance:
##'''JBoss Installation Path:''' where JBoss AS 5.1.0.GA must be installed or where it is installed in case you choose ''"Custom Installation"'' and deselect ''"JBoss AS 5.1.0.GA"'' package.
##'''Server Name:''' The name of the server that will be deployed under server/ directory; default is ''"GreenV"''. If you are installing another server in the INSTALL_PATH where there are other servers be sure that its name will differs from the others.
##'''Server Address:''' The server address on which the ''"Server Name"'' will listen on.; default ''"0.0.0.0"'' means all available addresses.
##'''JBoss Port Configuration:''' The portset that will be used by the server; ''"ports-default"'' means the standard ports, for instance HTTP port is 8080. You can choose different portset to be sure that those ports are available on your system:
### ports-default: The standard ports, for instance HTTP port is 8080.
### ports-01: The standard ports incremented by 100. For example, HTTP is on 8180.
### ports-02: The standard ports incremented by 200. For example, HTTP is on 8280.
### ports-03: The standard ports incremented by 300. For example, HTTP is on 8380.
##'''Username:''' The username for GV Console administration; default is ''"admin"''.
##'''Password:''' The username password; please note that passwords must contains at least (1) upper case letter, (1) lower case letter, (1) number or special character and must be at least (8) characters in length.
#Click Next. If you choose ''"Custom Installation"'' as Installation Type the Summary Installation screen display. Click Next.
#If you choose ''"Custom Installation"'' as Installation Type the Process Panell screen display. The installer check for your JBoss 5.1.0 GA version for compatibility reason. If it is compatible a confirmation message will display. Click Next.
#The installation process will now start copying files on your system. Click Next when finish.
#The Post Processing screen display. The installer configures the startup scripts and GV Console properties files with parameters defined at point 9. Click Next.
#The Post Installation Summary screen display. The installation is successfully completed. Some useful information are displayed like:
##'''Post Installation Requirement'''; only *nix platforms
##'''Starting {{GVESB}}'''
##'''Uninstall {{GVESB}}'''
##'''Support'''
#Click Next. Installation finished. Click Done to complete installation.

Installer Overview

2012-02-23T16:48:08Z

N.decarlo:

The installer allows you to run in different mode:

# GUI mode
# Console mode

'''GUI mode'''

In GUI mode, the installer presents a wizard that allows you to make your choices about product configuration and component selection. 
When you start the installer by simply execute it, GUI mode is used.

'''Console mode'''

Console mode allows you to run the installer from a command line. 
It is useful on system where a graphic environment is not available.

'''Required and Optional Third Party Components'''

Depending on the tasks you wish to perform, you must install one or more other third party components.

''Required and Optional Components''

{| class="gvtable"
! Component
! Purpose
|-
| Oracle JDK 1.6.0 or higher
| Required. Oracle JDK 1.6.0 is required to start the GreenVulcano Universal Installer.
|-
| JBoss 5.1.0 GA
| Optional. JBoss 5.1.0 GA Application Server is part of the installation process but you can choose to not install it using your already existing installtion. Please note that different versions are not supported and the installer will exit.
|-
|}

'''GreenVulcano Universal Installer'''

{{GVESB}} is based on GreenVulcano Universal Installer 1.0.0 which supports multiple GV_HOME installation on a system and will have a screen asking whether to use a new or an existing JBoss 5.1.0 GA installation. 
When installing {{GVESB}}, you should always use the same JBoss 5.1.0 GA installation simply choosing "Custom Installation" deselecting the "JBoss AS 5.1.0.GA" package and selecting your JBOSS_HOME when asked. 

'''Available Installation Options'''

Running the GreenVulcano Universal Installer the following options are available for certain platforms in both Console and GUI mode:

{| class="gvtable"
! Platform
! Options
! Purpose
|-
| Linux x86
| -java-home -console 
| JRE directory which point to desired bin/java executable. Run the installer in console mode.
|-
| Linux x86-64
| -java-home -console 
| JRE directory which point to desired bin/java executable. Run the installer in console mode.
|-
| Solaris (SPARC) (64-bit)
| -java-home -console 
| JRE directory which point to desired bin/java executable. Run the installer in console mode.
|-
| Solaris (x86-64)
| -java-home -console 
| JRE directory which point to desired bin/java executable. Run the installer in console mode.
|-
| IBM AIX (PPC64)
| -java-home -console 
| JRE directory which point to desired bin/java executable. Run the installer in console mode.
|-
| Microsoft Windows (all)
| no options
| The installer is available only in GUI mode without specifying any options.
|-
|}

'''Uninstalling GreenVulcano ESB'''

To uninstall your {{GVESB}} you can simply navigate through the Uninstaller directory located under your GV_HOME path and invoke: 
''java -jar GreenVulcano_Uninstaller.jar'' 

In case you have multiple GV_HOME on your system in the same INSTALL_PATH that sharing the same JBoss 5.1.0 GA installation please leave the ''"Force deletion of"'' checkbox unselected. 

Please note: The ''"Force deletion of"'' checkbox if selected will remove all the files and directories under your INSTALL_PATH.

Installer Overview

2012-02-23T16:43:59Z

N.decarlo:

The installer allows you to run in different mode:

# GUI mode
# Console mode

'''GUI mode'''

In GUI mode, the installer presents a wizard that allows you to make your choices about product configuration and component selection. 
When you start the installer by simply execute it, GUI mode is used.

'''Console mode'''

Console mode allows you to run the installer from a command line. 
It is useful on system where a graphic environment is not available.

'''Required and Optional Third Party Components'''

Depending on the tasks you wish to perform, you must install one or more other third party components.

''Required and Optional Components''

{| class="gvtable"
! Component
! Purpose
|-
| Oracle JDK 1.6.0 or higher
| Required. Oracle JDK 1.6.0 is required to start the GreenVulcano Universal Installer.
|-
| JBoss 5.1.0 GA
| Optional. JBoss 5.1.0 GA Application Server is part of the installation process but you can choose to not install it using your already existing installtion. Please note that different versions are not supported and the installer will exit.
|-
|}

'''GreenVulcano Universal Installer'''

{{GVESB}} is based on GreenVulcano Universal Installer 1.0.0 which supports multiple GV_HOME installation on a system and will have a screen asking whether to use a new or an existing JBoss 5.1.0 GA installation. 
When installing {{GVESB}}, you should always use the same JBoss 5.1.0 GA installation simply choosing "Custom Installation" deselecting the "JBoss AS 5.1.0.GA" package and selecting your JBOSS_HOME when asked. 

'''Available Installation Options'''

Running the GreenVulcano Universal Installer the following options are available for certain platforms in both Console and GUI mode:

{| class="gvtable"
! Platform
! Options
! Purpose
|-
| Linux x86
| Service Pack 1 (x86 & x86-64)
| 233
|-
| Linux x86-64
| Service Pack 3 (x86 & x86-64)
| 233
|-
| Solaris (SPARC) (64-bit)
| Service Pack 1 (x86 & x86-64)
| 233
|-
| Solaris (x86-64)
| R2 (x86 & x86-64)
| 233
|-
| IBM AIX (PPC64)
| R2 (x86 & x86-64)
| 233
|-
|}

'''Uninstalling GreenVulcano ESB'''

To uninstall your {{GVESB}} you can simply navigate through the Uninstaller directory located under your GV_HOME path and invoke: 
''java -jar GreenVulcano_Uninstaller.jar'' 

In case you have multiple GV_HOME on your system in the same INSTALL_PATH that sharing the same JBoss 5.1.0 GA installation please leave the ''"Force deletion of"'' checkbox unselected. 

Please note: The ''"Force deletion of"'' checkbox if selected will remove all the files and directories under your INSTALL_PATH.

Install using Console Mode

2012-02-23T16:40:54Z

N.decarlo:

The Console Mode enable platforms where graphic environment is not available to install {{GVESB}}. 

It is available just for *nix platform running:
GreenVulcanoUniversalInstaller -console

'''Available Installation Options'''

To install {{GVESB}} in GUI mode:
# Open the physical media or download the {{GVESB}} package.
# Extract the {{GVESB}} archive file to a temporary directory.
# Navigate to the temporary directory.
# Run GreenVulcanoUniversalInstaller. The Welcome screen displays.
# Click Next. The License Agreement screen appears. After reading through the license text, click ''"I accept the terms of the license agreement"'' and then click Next.
# The Installation Type screen displays. Choose ''"Complete Installation"'' or ''"Custom Installation"'' then click Next.
# The Installation Target Path selection screen displays. Choose your target installation path (INSTALL_PATH) then click Next.
# If you choose ''"Custom Installation"'' as Installation Type the Select Installation Packages screen displays. You can choose to deselect ''"JBoss AS 5.1.0.GA"'' package if you already have your own installation and you want to use it to deploy {{GVESB}}. Click Next.
# The jBoss Configuration screen display. You should now specify the following parameters for your JBoss instance:
##'''JBoss Installation Path:''' where JBoss AS 5.1.0.GA must be installed or where it is installed in case you choose ''"Custom Installation"'' and deselect ''"JBoss AS 5.1.0.GA"'' package.
##'''Server Name:''' The name of the server that will be deployed under server/ directory; default is ''"GreenV"''. If you are installing another server in the INSTALL_PATH where there are other servers be sure that its name will differs from the others.
##'''Server Address:''' The server address on which the ''"Server Name"'' will listen on.; default ''"0.0.0.0"'' means all available addresses.
##'''JBoss Port Configuration:''' The portset that will be used by the server; ''"ports-default"'' means the standard ports, for instance HTTP port is 8080. You can choose different portset to be sure that those ports are available on your system:
### ports-default: The standard ports, for instance HTTP port is 8080.
### ports-01: The standard ports incremented by 100. For example, HTTP is on 8180.
### ports-02: The standard ports incremented by 200. For example, HTTP is on 8280.
### ports-03: The standard ports incremented by 300. For example, HTTP is on 8380.
##'''Username:''' The username for GV Console administration; default is ''"admin"''.
##'''Password:''' The username password; please note that passwords must contains at least (1) upper case letter, (1) lower case letter, (1) number or special character and must be at least (8) characters in length.
#Click Next. If you choose ''"Custom Installation"'' as Installation Type the Summary Installation screen display. Click Next.
#If you choose ''"Custom Installation"'' as Installation Type the Process Panell screen display. The installer check for your JBoss 5.1.0 GA version for compatibility reason. If it is compatible a confirmation message will display. Click Next.
#The installation process will now start copying files on your system. Click Next when finish.
#The Post Processing screen display. The installer configures the startup scripts and GV Console properties files with parameters defined at point 9. Click Next.
#The Post Installation Summary screen display. The installation is successfully completed. Some useful information are displayed like:
##'''Post Installation Requirement'''; only *nix platforms
##'''Starting {{GVESB}}'''
##'''Uninstall {{GVESB}}'''
##'''Support'''
#Click Next. Installation finished. Click Done to complete installation.

Install using Console Mode

2012-02-23T16:32:09Z

N.decarlo: Created page with "To install {{GVESB}} in GUI mode: # Open the physical media or download the {{GVESB}} package. # Extract the {{GVESB}} archive file to a temporary directory. # Navigate to the te..."

To install {{GVESB}} in GUI mode:
# Open the physical media or download the {{GVESB}} package.
# Extract the {{GVESB}} archive file to a temporary directory.
# Navigate to the temporary directory.
# Run GreenVulcanoUniversalInstaller. The Welcome screen displays.
# Click Next. The License Agreement screen appears. After reading through the license text, click ''"I accept the terms of the license agreement"'' and then click Next.
# The Installation Type screen displays. Choose ''"Complete Installation"'' or ''"Custom Installation"'' then click Next.
# The Installation Target Path selection screen displays. Choose your target installation path (INSTALL_PATH) then click Next.
# If you choose ''"Custom Installation"'' as Installation Type the Select Installation Packages screen displays. You can choose to deselect ''"JBoss AS 5.1.0.GA"'' package if you already have your own installation and you want to use it to deploy {{GVESB}}. Click Next.
# The jBoss Configuration screen display. You should now specify the following parameters for your JBoss instance:
##'''JBoss Installation Path:''' where JBoss AS 5.1.0.GA must be installed or where it is installed in case you choose ''"Custom Installation"'' and deselect ''"JBoss AS 5.1.0.GA"'' package.
##'''Server Name:''' The name of the server that will be deployed under server/ directory; default is ''"GreenV"''. If you are installing another server in the INSTALL_PATH where there are other servers be sure that its name will differs from the others.
##'''Server Address:''' The server address on which the ''"Server Name"'' will listen on.; default ''"0.0.0.0"'' means all available addresses.
##'''JBoss Port Configuration:''' The portset that will be used by the server; ''"ports-default"'' means the standard ports, for instance HTTP port is 8080. You can choose different portset to be sure that those ports are available on your system:
### ports-default: The standard ports, for instance HTTP port is 8080.
### ports-01: The standard ports incremented by 100. For example, HTTP is on 8180.
### ports-02: The standard ports incremented by 200. For example, HTTP is on 8280.
### ports-03: The standard ports incremented by 300. For example, HTTP is on 8380.
##'''Username:''' The username for GV Console administration; default is ''"admin"''.
##'''Password:''' The username password; please note that passwords must contains at least (1) upper case letter, (1) lower case letter, (1) number or special character and must be at least (8) characters in length.
#Click Next. If you choose ''"Custom Installation"'' as Installation Type the Summary Installation screen display. Click Next.
#If you choose ''"Custom Installation"'' as Installation Type the Process Panell screen display. The installer check for your JBoss 5.1.0 GA version for compatibility reason. If it is compatible a confirmation message will display. Click Next.
#The installation process will now start copying files on your system. Click Next when finish.
#The Post Processing screen display. The installer configures the startup scripts and GV Console properties files with parameters defined at point 9. Click Next.
#The Post Installation Summary screen display. The installation is successfully completed. Some useful information are displayed like:
##'''Post Installation Requirement'''; only *nix platforms
##'''Starting {{GVESB}}'''
##'''Uninstall {{GVESB}}'''
##'''Support'''
#Click Next. Installation finished. Click Done to complete installation.

Install using GUI Mode

2012-02-23T16:27:27Z

N.decarlo:

To install {{GVESB}} in GUI mode:
# Open the physical media or download the {{GVESB}} package.
# Extract the {{GVESB}} archive file to a temporary directory.
# Navigate to the temporary directory.
# Run GreenVulcanoUniversalInstaller. The Welcome screen displays.
# Click Next. The License Agreement screen appears. After reading through the license text, click ''"I accept the terms of the license agreement"'' and then click Next.
# The Installation Type screen displays. Choose ''"Complete Installation"'' or ''"Custom Installation"'' then click Next.
# The Installation Target Path selection screen displays. Choose your target installation path (INSTALL_PATH) then click Next.
# If you choose ''"Custom Installation"'' as Installation Type the Select Installation Packages screen displays. You can choose to deselect ''"JBoss AS 5.1.0.GA"'' package if you already have your own installation and you want to use it to deploy {{GVESB}}. Click Next.
# The jBoss Configuration screen display. You should now specify the following parameters for your JBoss instance:
##'''JBoss Installation Path:''' where JBoss AS 5.1.0.GA must be installed or where it is installed in case you choose ''"Custom Installation"'' and deselect ''"JBoss AS 5.1.0.GA"'' package.
##'''Server Name:''' The name of the server that will be deployed under server/ directory; default is ''"GreenV"''. If you are installing another server in the INSTALL_PATH where there are other servers be sure that its name will differs from the others.
##'''Server Address:''' The server address on which the ''"Server Name"'' will listen on.; default ''"0.0.0.0"'' means all available addresses.
##'''JBoss Port Configuration:''' The portset that will be used by the server; ''"ports-default"'' means the standard ports, for instance HTTP port is 8080. You can choose different portset to be sure that those ports are available on your system:
### ports-default: The standard ports, for instance HTTP port is 8080.
### ports-01: The standard ports incremented by 100. For example, HTTP is on 8180.
### ports-02: The standard ports incremented by 200. For example, HTTP is on 8280.
### ports-03: The standard ports incremented by 300. For example, HTTP is on 8380.
##'''Username:''' The username for GV Console administration; default is ''"admin"''.
##'''Password:''' The username password; please note that passwords must contains at least (1) upper case letter, (1) lower case letter, (1) number or special character and must be at least (8) characters in length.
#Click Next. If you choose ''"Custom Installation"'' as Installation Type the Summary Installation screen display. Click Next.
#If you choose ''"Custom Installation"'' as Installation Type the Process Panell screen display. The installer check for your JBoss 5.1.0 GA version for compatibility reason. If it is compatible a confirmation message will display. Click Next.
#The installation process will now start copying files on your system. Click Next when finish.
#The Post Processing screen display. The installer configures the startup scripts and GV Console properties files with parameters defined at point 9. Click Next.
#The Post Installation Summary screen display. The installation is successfully completed. Some useful information are displayed like:
##'''Post Installation Requirement'''; only *nix platforms
##'''Starting {{GVESB}}'''
##'''Uninstall {{GVESB}}'''
##'''Support'''
#Click Next. Installation finished. Click Done to complete installation.

Install using GUI Mode

2012-02-23T16:22:34Z

N.decarlo:

To install {{GVESB}} in GUI mode:
# Open the physical media or download the {{GVESB}} package.
# Extract the {{GVESB}} archive file to a temporary directory.
# Navigate to the temporary directory.
# Run GreenVulcanoUniversalInstaller. The Welcome screen displays.
# Click Next. The License Agreement screen appears. After reading through the license text, click ''"I accept the terms of the license agreement"'' and then click Next.
# The Installation Type screen displays. Choose ''"Complete Installation"'' or ''"Custom Installation"'' then click Next.
# The Installation Target Path selection screen displays. Choose your target installation path (INSTALL_PATH) then click Next.
# If you choose ''"Custom Installation"'' as Installation Type the Select Installation Packages screen displays. You can choose to deselect ''"JBoss AS 5.1.0.GA"'' package if you already have your own installation and you want to use it to deploy {{GVESB}}. Click Next.
# The jBoss Configuration screen display. You should now specify the following parameters for your JBoss instance:
##'''JBoss Installation Path:''' where JBoss AS 5.1.0.GA must be installed or where it is installed in case you choose ''"Custom Installation"'' and deselect ''"JBoss AS 5.1.0.GA"'' package.
##'''Server Name:''' The name of the server that will be deployed under server/ directory; default is ''"GreenV"''. If you are installing another server in the INSTALL_PATH where there are other servers be sure that its name will differs from the others.
##'''Server Address:''' The server address on which the ''"Server Name"'' will listen on.; default ''"0.0.0.0"'' means all available addresses.
##'''JBoss Port Configuration:''' The portset that will be used by the server; ''"ports-default"'' means the standard ports, for instance HTTP port is 8080. You can choose different portset to be sure that those ports are available on your system:
### ports-01: The standard ports incremented by 100. For example, HTTP is on 8180.
### ports-02: The standard ports incremented by 200. For example, HTTP is on 8280.
### ports-03: The standard ports incremented by 300. For example, HTTP is on 8380.
##'''Username:''' The username for GV Console administration; default is ''"admin"''.
##'''Password:''' The username password; please note that passwords must contains at least (1) upper case letter, (1) lower case letter, (1) number or special character and must be at least (8) characters in length.
#Click Next. If you choose ''"Custom Installation"'' as Installation Type the Summary Installation screen display. Click Next.
#If you choose ''"Custom Installation"'' as Installation Type the Process Panell screen display. The installer check for your JBoss 5.1.0 GA version for compatibility reason. If it is compatible a confirmation message will display. Click Next.
#The installation process will now start copying files on your system. Click Next when finish.
#The Post Processing screen display. The installer configures the startup scripts and GV Console properties files with parameters defined at point 9. Click Next.
#The Post Installation Summary screen display. The installation is successfully completed. Some useful information are displayed like:
##'''Post Installation Requirement'''; only *nix platforms
##'''Starting {{GVESB}}'''
##'''Uninstall {{GVESB}}'''
##'''Support'''
#Click Next. Installation finished. Click Done to complete installation.

Install using GUI Mode

2012-02-23T16:21:47Z

N.decarlo:

To install {{GVESB}} in GUI mode:
# Open the physical media or download the {{GVESB}} package.
# Extract the {{GVESB}} archive file to a temporary directory.
# Navigate to the temporary directory.
# Run GreenVulcanoUniversalInstaller. The Welcome screen displays.
# Click Next. The License Agreement screen appears. After reading through the license text, click ''"I accept the terms of the license agreement"'' and then click Next.
# The Installation Type screen displays. Choose ''"Complete Installation"'' or ''"Custom Installation"'' then click Next.
# The Installation Target Path selection screen displays. Choose your target installation path (INSTALL_PATH) then click Next.
# If you choose ''"Custom Installation"'' as Installation Type the Select Installation Packages screen displays. You can choose to deselect ''"JBoss AS 5.1.0.GA"'' package if you already have your own installation and you want to use it to deploy {{GVESB}}. Click Next.
# The jBoss Configuration screen display. You should now specify the following parameters for your JBoss instance:
##'''JBoss Installation Path:''' where JBoss AS 5.1.0.GA must be installed or where it is installed in case you choose ''"Custom Installation"'' and deselect ''"JBoss AS 5.1.0.GA"'' package.
##'''Server Name:''' The name of the server that will be deployed under server/ directory; default is ''"GreenV"''. If you are installing another server in the INSTALL_PATH where there are other servers be sure that its name will differs from the others.
##'''Server Address:''' The server address on which the ''"Server Name"'' will listen on.; default ''"0.0.0.0"'' means all available addresses.
##'''JBoss Port Configuration:''' The portset that will be used by the server; ''"ports-default"'' means the standard ports, for instance HTTP port is 8080. You can choose different portset to be sure that those ports are available on your system:
### ports-01: The standard ports incremented by 100. For example, HTTP is on 8180.
### ports-02: The standard ports incremented by 200. For example, HTTP is on 8280.
### ports-03: The standard ports incremented by 300. For example, HTTP is on 8380.
##'''Username:''' The username for GV Console administration; default is ''"admin"''.
##'''Password:''' The username password; please note that passwords must contains at least (1) upper case letter, (1) lower case letter, (1) number or special character and must be at least (8) characters in length.
#Click Next. If you choose ''"Custom Installation"'' as Installation Type the Summary Installation screen display. Click Next.
#If you choose ''"Custom Installation"'' as Installation Type the Process Panell screen display. The installer check for your JBoss 5.1.0 GA version for compatibility reason. If it is compatible a confirmation message will display. Click Next.
#The installation process will now start copying files on your system. Click Next when finish.
#The Post Processing screen display. The installer configures the startup scripts and GV Console properties files with parameters defined at point 9. Click Next.
#The Post Installation Summary screen display. The installation is successfully completed. Some useful information are displayed like:
##'''Post Installation Requirement'''; only *nix platforms
##'''Starting {{GVESB}}'''
##'''Uninstall {{GVESB}}'''
##'''Support'''
#Click Next. Installation finished.

Install using GUI Mode

2012-02-23T16:12:53Z

N.decarlo:

To install {{GVESB}} in GUI mode:
# Open the physical media or download the {{GVESB}} package.
# Extract the {{GVESB}} archive file to a temporary directory.
# Navigate to the temporary directory.
# Run GreenVulcanoUniversalInstaller. The Welcome screen displays.
# Click Next. The License Agreement screen appears. After reading through the license text, click ''"I accept the terms of the license agreement"'' and then click Next.
# The Installation Type screen displays. Choose ''"Complete Installation"'' or ''"Custom Installation"'' then click Next.
# The Installation Target Path selection screen displays. Choose your target installation path (INSTALL_PATH) then click Next.
# If you choose ''"Custom Installation"'' as Installation Type the Select Installation Packages screen displays. You can choose to deselect ''"JBoss AS 5.1.0.GA"'' package if you already have your own installation and you want to use it to deploy {{GVESB}}. Click Next.
# The jBoss Configuration screen display. You should now specify the following parameters for your JBoss instance:
##'''JBoss Installation Path:''' where JBoss AS 5.1.0.GA must be installed or where it is installed in case you choose ''"Custom Installation"'' and deselect ''"JBoss AS 5.1.0.GA"'' package.
##'''Server Name:''' The name of the server that will be deployed under server/ directory; default is ''"GreenV"''. If you are installing another server in the INSTALL_PATH where there are other servers be sure that its name will differs from the others.
##'''Server Address:''' The server address on which the ''"Server Name"'' will listen on.; default ''"0.0.0.0"'' means all available addresses.
##'''JBoss Port Configuration:''' The portset that will be used by the server; ''"ports-default"'' means the standard ports, for instance HTTP port is 8080. You can choose different portset to be sure that those ports are available on your system:
### ports-01: The standard ports incremented by 100. For example, HTTP is on 8180.
### ports-02: The standard ports incremented by 200. For example, HTTP is on 8280.
### ports-03: The standard ports incremented by 300. For example, HTTP is on 8380.
##'''Username:''' The username for GV Console administration; default is ''"admin"''.
##'''Password:''' The username password; please note that passwords must contains at least (1) upper case letter, (1) lower case letter, (1) number or special character and must be at least (8) characters in length.
#Click Next. If you choose ''"Custom Installation"'' as Installation Type the Summary Installation screen display. Click Next.
#If you choose ''"Custom Installation"'' as Installation Type the Process Panell screen display. The installer check for your JBoss 5.1.0 GA version for compatibility reason. If it is compatible a confirmation message will display. Click Next.

Install using GUI Mode

2012-02-23T16:03:01Z

N.decarlo: