Post Installation

From GreenVulcano Wiki
Revision as of 10:30, 27 January 2012 by Anonymous (talk)
Jump to: navigation, search

After Installation and configuration previously described, make sure that, in case of *nix systems, the user with which GreenVulcano® ESB will be executed has permission for the following scripts:

$GV_SERVER/bin/start_GreenV.sh
$GV_SERVER/bin/stop_GreenV.sh
$JBOSS_HOME/bin/run.sh
$JBOSS_HOME/bin/shutdown.sh

Finalizing the installation

If you have chosen to perform the installation by downloading the GreenVulcano® ESB Package that does not include JBoss, you need to change some files with steps described below:

Info.png The jboss-service.xml is present in the following location:
$GV_SERVER/conf

The variable gv.app.home defined in the script start indicates the home directory of the product.

Add the following lines to the file jboss-service.xml:

<classpath codebase="file://${gv.app.home}/application/gvlib" archives="*"/>
<classpath codebase="file://${gv.app.home}/application/lib" archives="*"/>

before

<classpath codebase="${jboss.server.lib.url:lib}" archives="*"/>

Change in the same file the URLs value for the mbean:

 name: jboss.deployment: type = DeploymentScanner, flavor = URL

adding the following string separated by a comma:

 file://${gv.app.home}/application/deploy/

For example:

<mbean code="org.jboss.deployment.scanner.URLDeploymentScanner" name="jboss.deployment:type=DeploymentScanner,flavor=URL">
....
  <attribute name="URLs">deploy/,file:${gv.app.home}/application/deploy/</attribute>
....
</mbean>

Modify the file login-config.xml as follow:

Info.png The file login-config.xml is present in the following path:
$GV_SERVER/conf
<application-policy name="gvesb">
  <authentication>
    <login-module code="org.jboss.security.auth.spi.UsersRolesLoginModule" flag="required">
      <module-option name="usersProperties">gvesb-users.properties</module-option>
      <module-option name="rolesProperties">gvesb-roles.properties</module-option>
    </login-module>
  </authentication>
</application-policy>
Info.png The third part configurable components, in order to be integrated with GreenVulcano® ESB,
can be copied in the following directory:
$GV_HOME/application/deploy

When the installation procedure described above is finished, the file system will be structured as follow:

$GV_HOME/
application/
deploy/: contains the application components (ejb, war, ear) and the configuration files of the resources of the application server (JBoss).
gvlib/ : contains the GreenVulcano® ESB specific libraries (jar files).
lib/  : contains the GreenVulcano® ESB support libraries.
BIRTReportEngine/
doc/
extra/  : contains the configuration files to enable logging, statistics and savepoints of databases
licenses/ : contains the libraries used by the GreenVulcano® ESB license
reference/: contains the PDF files that are the GreenVulcano® ESB reference guides and XSD files that describe the internal structure of some GreenVulcano® ESB XML
dtds/  : contains the dtds used by GV Console® / VulCon® to validate the GreenVulcano® ESB configuration
gvconsole/: contains the GV Console® work files and the configurations back-up
etc/
lock/
gvdte/  : contains the maps of transformation used by the GreenVulcano® ESB DTE (Data Transformation Engine).
datasource/
bin/  : contains the maps of binary transformation (binary transformations <-> XML)
xsl/  : XSL transformations
xsd/  : are inserted the XSD file used to validate the input / output transformations
log/  : contains the log files of the various GreenVulcano® ESB components, differentiated by the component name and day. In this directory are generated the dumps of input / output services performed by GV Console®
webservices/
modules/  : contains the MAR files that describe the extra modules for AXIS services
services/ : contains the AAR files that describe the WebService published by GreenVulcano® ESB
xmlconfig/: contains the GreenVulcano® ESB configuration XML files and the license enabling the adapters for the Enterprise version.
js/  : contains the JavaScript files used to create pre-configured execution contexts
wsdl/  : contains the WSDL files of the WebService published and invoked by GreenVulcano® ESB
xsds/  : contains the XSD files used in the WSDL service published by GreenVulcano® ESB and the operations of XML documents validation.
$JBOSS_HOME/
bin/
client/
docs/
lib/
server/
GreenV/ --> alias $GV_SERVER
bin/
conf/
deploy
lib/