Difference between revisions of "Post Installation"

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

Revision as of 10:31, 27 January 2012

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/: containing the application components (ejb, war, ear) and the configuration files of the resources of the application server (JBoss).
gvlib/ : containing the GreenVulcano® ESB specific libraries (jar files).
lib/  : containing the GreenVulcano® ESB support libraries.
BIRTReportEngine/
doc/
extra/  : containing the configuration files to enable logging, statistics and savepoints of databases
licenses/ : containing the libraries used by the GreenVulcano® ESB license
reference/: containing the PDF files that are the GreenVulcano® ESB reference guides and XSD files that describe the internal structure of some GreenVulcano® ESB XML
dtds/  : containing the dtds used by GV Console® / VulCon® to validate the GreenVulcano® ESB configuration
gvconsole/: containing the GV Console® work files and the configurations back-up
etc/
lock/
gvdte/  : containing the maps of transformation used by the GreenVulcano® ESB DTE (Data Transformation Engine).
datasource/
bin/  : containing 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/  : containing 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/  : containing the MAR files that describe the extra modules for AXIS services
services/ : containing the AAR files that describe the WebService published by GreenVulcano® ESB
xmlconfig/: containing the GreenVulcano® ESB configuration XML files and the license enabling the adapters for the Enterprise version.
js/  : containing the JavaScript files used to create pre-configured execution contexts
wsdl/  : containing the WSDL files of the WebService published and invoked by GreenVulcano® ESB
xsds/  : containing 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/