Difference between revisions of "Post Installation"

From GreenVulcano Wiki
Jump to: navigation, search
Line 19: Line 19:
 
Add the following lines to the file ''jboss-service.xml'':
 
Add the following lines to the file ''jboss-service.xml'':
 
<syntaxhighlight lang="XML">
 
<syntaxhighlight lang="XML">
<classpath codebase="file://${gv.app.home}/application/gvlib" archives="*"/>
+
<!-- GreenVulcano ESB library directory -->
<classpath codebase="file://${gv.app.home}/application/lib" archives="*"/>
+
<classpath codebase="${gv.app.home}/application/lib" archives="*"/>
 
</syntaxhighlight>
 
</syntaxhighlight>
 
before
 
before
 
<syntaxhighlight lang="XML">
 
<syntaxhighlight lang="XML">
<classpath codebase="${jboss.server.lib.url:lib}" archives="*"/>
+
<classpath codebase="${jboss.server.lib.url}" archives="*"/>
 +
<classpath codebase="${jboss.common.lib.url}" archives="*"/>
 
</syntaxhighlight>
 
</syntaxhighlight>
  
Change in the same file the URLs value for the ''mbean'':
+
Change in the file the ''bootstrap/profile.xml'' the configuration of the ''mbean'' ''BootstrapProfileFactory'' as follow:
  name: jboss.deployment: type = DeploymentScanner, flavor = URL
+
{| class="note"
 
+
|-
adding the following string separated by a comma:
+
| [[File:info.png]]
  file://${gv.app.home}/application/deploy/
+
| The file ''profile.xml'' is present in the following path:
 
+
:$GV_SERVER/conf/bootstrap
For example:
+
|}
 
<syntaxhighlight lang="XML">
 
<syntaxhighlight lang="XML">
<mbean code="org.jboss.deployment.scanner.URLDeploymentScanner" name="jboss.deployment:type=DeploymentScanner,flavor=URL">
+
<bean name="BootstrapProfileFactory" class="org.jboss.system.server.profileservice.repository.StaticProfileFactory">
....
+
      <property name="bindingsURI">${jboss.server.home.url}conf/bindingservice.beans</property>
  <attribute name="URLs">deploy/,file:${gv.app.home}/application/deploy/</attribute>
+
      <property name="bootstrapURI">${jboss.server.home.url}conf/jboss-service.xml</property>
....
+
      <property name="deployersURI">${jboss.server.home.url}deployers</property>
</mbean>
+
      <property name="applicationURIs">
 +
        <list elementClass="java.net.URI">
 +
            <value>${jboss.server.home.url}deploy</value>
 +
            <!-- GreenVulcano ESB deployment directory -->
 +
            <value>file://${gv.app.home}/application/deploy</value>
 +
        </list>
 +
      </property>
 +
      <property name="attachmentStoreRoot">${jboss.server.data.dir}/attachments</property>
 +
      <property name="profileFactory"><inject bean="ProfileFactory" /></property>
 +
</bean>
 
</syntaxhighlight>
 
</syntaxhighlight>
  
Line 48: Line 58:
 
| The file ''login-config.xml'' is present in the following path:
 
| The file ''login-config.xml'' is present in the following path:
 
:$GV_SERVER/conf
 
:$GV_SERVER/conf
 +
The files ''*.properties'' are present in the following path:
 +
:$GV_HOME/xmlconfig
 +
The ''OdeHsqlDbRealm'' needs a DataSource registered with name ''ds.ode'' usually configured in:
 +
:$GV_HOME/application/deploy/gvesb-db-ds.xml
 
|}
 
|}
 +
  
 
<syntaxhighlight lang="XML">
 
<syntaxhighlight lang="XML">
 
<application-policy name="gvesb">
 
<application-policy name="gvesb">
  <authentication>
+
    <authentication>
    <login-module code="org.jboss.security.auth.spi.UsersRolesLoginModule" flag="required">
+
        <login-module code="org.jboss.security.auth.spi.UsersRolesLoginModule"
      <module-option name="usersProperties">gvesb-users.properties</module-option>
+
                      flag="required">
      <module-option name="rolesProperties">gvesb-roles.properties</module-option>
+
            <module-option name="usersProperties">gvesb-users.properties</module-option>
     </login-module>
+
            <module-option name="rolesProperties">gvesb-roles.properties</module-option>
  </authentication>
+
        </login-module>
 +
     </authentication>
 +
</application-policy>
 +
<application-policy name = "OdeHsqlDbRealm">
 +
    <authentication>
 +
        <login-module code = "org.jboss.resource.security.ConfiguredIdentityLoginModule"
 +
                      flag = "required">
 +
            <module-option name = "principal">ode</module-option>
 +
            <module-option name = "userName">ode</module-option>
 +
            <module-option name = "password">ode</module-option>
 +
            <module-option name = "managedConnectionFactoryName">jboss.jca:service=LocalTxCM,name=ds.ode</module-option>
 +
        </login-module>
 +
    </authentication>
 
</application-policy>
 
</application-policy>
 
</syntaxhighlight>
 
</syntaxhighlight>
Line 69: Line 96:
  
 
When the installation procedure described above is finished, the file system will be structured as follow:
 
When the installation procedure described above is finished, the file system will be structured as follow:
::$GV_HOME/
+
::'''$GV_HOME/'''
:::application/
+
:::'''application/'''
::::deploy/: containing the application components (ejb, war, ear) and the configuration files of the resources of the application server (JBoss).
+
::::'''deploy/''': contains the application components (ejb, war, ear) and the configuration files of the application server (JBoss) resources.
::::lib/  : containing the {{GVESB}} support libraries.
+
::::'''lib/'''   : contains the {{GVESB}} support libraries.
:::BIRTReportEngine/
+
:::'''BIRTReportEngine/''' :contains BIRT report definitions
:::doc/
+
:::'''BpelProcess/''' :contains ODE BPEL prosess definitions
::::extra/    : containing the configuration files to enable logging, statistics and savepoints of databases
+
:::'''doc/'''
::::licenses/ : containing the libraries used by the {{GVESB}} license
+
::::'''extra/'''   : contains the configuration files fragments and DDL scripts to enable logging, statistics and savepoints on various DataBases
::::reference/: containing the PDF files that are the {{GVESB}} reference guides and XSD files that describe the internal structure of some {{GVESB}} XML
+
::::'''licenses/''' : contains the license of the libraries used by {{GVESB}}  
:::dtds/  : containing the dtds used by {{L_GVCONSOLE}} / {{L_VULCON}} to validate the {{GVESB}} configuration
+
::::'''reference/''': contains the PDF files that are the {{GVESB}} configuration reference guides and XSD files that describe the internal structure of some {{GVESB}} XML
:::gvconsole/: containing the {{L_GVCONSOLE}} work files and the configurations back-up
+
:::'''dtds/'''   : contains the dtds used by {{L_GVCONSOLE}}/{{L_VULCON}} to validate the {{GVESB}} configuration
::::etc/
+
:::'''gvconsole/''': contains the {{L_GVCONSOLE}} work files and the configurations back-up
::::lock/
+
::::'''etc/'''
:::gvdte/  : containing the maps of transformation used by the {{GVESB}} DTE (Data Transformation Engine).
+
::::'''lock/'''
::::datasource/
+
:::'''gvdte/''' : contains the transformations maps used by the {{GVESB}} DTE (Data Transformation Engine).
:::::bin/  : containing the maps of binary transformation (binary transformations <-> XML)
+
::::'''datasource/'''
:::::xsl/  : XSL transformations
+
:::::'''bin/''' : contains the maps for binary transformation (binary buffers <-> XML)
:::::xsd/  : are inserted the XSD file used to validate the input / output transformations
+
:::::'''xsl/''' : contains the maps for XSL transformations
:::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}}
+
:::::'''xsd/''' : contains the XSD file used to validate the transformations input/output  
:::webservices/
+
:::'''log/'''   : contains the log files of the various {{GVESB}} subsystems, differentiated by the subsystem name and day. In this directory are generated the dumps of input/output buffers of services invoked by {{L_GVCONSOLE}}
::::modules/  : containing the MAR files that describe the extra modules for AXIS services
+
:::'''Rules/''' : Drools rules definition files
::::services/ : containing the AAR files that describe the WebService published by {{GVESB}}
+
:::'''webservices/'''
:::xmlconfig/: containing the {{GVESB}} configuration XML files and the license enabling the adapters for the Enterprise version.
+
::::'''modules/''' : contains the MAR files that defines the extra modules for AXIS services
::::js/      : containing the JavaScript files used to create pre-configured execution contexts
+
::::'''services/''' : contains the AAR files that defines the WebService published by {{GVESB}}
::::wsdl/    : containing the WSDL files of the WebService published and invoked by {{GVESB}}
+
:::'''xmlconfig/''': contains the {{GVESB}} configuration XML files and the license enabling the adapters for the Enterprise version.
::::xsds/    : containing the XSD files used in the WSDL service published by {{GVESB}} and the operations of XML documents validation.
+
::::'''js/'''     : contains the JavaScript files used to create pre-configured execution contexts
::$JBOSS_HOME/
+
::::'''wsdl/'''   : contains the WSDL files of the WebService published and invoked by {{GVESB}}
:::bin/
+
::::'''xsds/'''   : contains the XSD files used in the WSDL service published by {{GVESB}} and the validation of XML documents.
:::client/
+
 
:::docs/
+
::'''$JBOSS_HOME/'''
:::lib/
+
:::'''bin/'''
:::server/
+
:::'''client/'''
::::GreenV/ --> alias $GV_SERVER
+
:::'''common/'''
:::::conf/
+
:::'''docs/'''
:::::deploy
+
:::'''lib/'''
:::::lib/
+
:::'''server/'''
 +
::::'''GreenV/''' --> alias '''$GV_SERVER'''
 +
:::::'''conf/'''
 +
:::::'''deploy/'''
 +
:::::'''lib/'''
 +
:::::'''lib/''' : JBoss server log directory

Revision as of 09:09, 13 February 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_HOME/bin/start_GreenV.sh
$GV_HOME/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:

<!-- GreenVulcano ESB library directory -->
<classpath codebase="${gv.app.home}/application/lib" archives="*"/>

before

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

Change in the file the bootstrap/profile.xml the configuration of the mbean BootstrapProfileFactory as follow:

Info.png The file profile.xml is present in the following path:
$GV_SERVER/conf/bootstrap
<bean name="BootstrapProfileFactory" class="org.jboss.system.server.profileservice.repository.StaticProfileFactory">
      <property name="bindingsURI">${jboss.server.home.url}conf/bindingservice.beans</property>
      <property name="bootstrapURI">${jboss.server.home.url}conf/jboss-service.xml</property>
      <property name="deployersURI">${jboss.server.home.url}deployers</property>
      <property name="applicationURIs">
         <list elementClass="java.net.URI">
            <value>${jboss.server.home.url}deploy</value>
            <!-- GreenVulcano ESB deployment directory -->
            <value>file://${gv.app.home}/application/deploy</value>
         </list>
      </property>
      <property name="attachmentStoreRoot">${jboss.server.data.dir}/attachments</property>
      <property name="profileFactory"><inject bean="ProfileFactory" /></property>
</bean>

Modify the file login-config.xml as follow:

Info.png The file login-config.xml is present in the following path:
$GV_SERVER/conf

The files *.properties are present in the following path:

$GV_HOME/xmlconfig

The OdeHsqlDbRealm needs a DataSource registered with name ds.ode usually configured in:

$GV_HOME/application/deploy/gvesb-db-ds.xml


<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>
<application-policy name = "OdeHsqlDbRealm">
    <authentication>
        <login-module code = "org.jboss.resource.security.ConfiguredIdentityLoginModule"
                      flag = "required">
            <module-option name = "principal">ode</module-option>
            <module-option name = "userName">ode</module-option>
            <module-option name = "password">ode</module-option>
            <module-option name = "managedConnectionFactoryName">jboss.jca:service=LocalTxCM,name=ds.ode</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 application server (JBoss) resources.
lib/  : contains the GreenVulcano® ESB support libraries.
BIRTReportEngine/ :contains BIRT report definitions
BpelProcess/ :contains ODE BPEL prosess definitions
doc/
extra/  : contains the configuration files fragments and DDL scripts to enable logging, statistics and savepoints on various DataBases
licenses/ : contains the license of the libraries used by GreenVulcano® ESB
reference/: contains the PDF files that are the GreenVulcano® ESB configuration 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 transformations maps used by the GreenVulcano® ESB DTE (Data Transformation Engine).
datasource/
bin/  : contains the maps for binary transformation (binary buffers <-> XML)
xsl/  : contains the maps for XSL transformations
xsd/  : contains the XSD file used to validate the transformations input/output
log/  : contains the log files of the various GreenVulcano® ESB subsystems, differentiated by the subsystem name and day. In this directory are generated the dumps of input/output buffers of services invoked by GV Console®
Rules/ : Drools rules definition files
webservices/
modules/  : contains the MAR files that defines the extra modules for AXIS services
services/ : contains the AAR files that defines 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 validation of XML documents.
$JBOSS_HOME/
bin/
client/
common/
docs/
lib/
server/
GreenV/ --> alias $GV_SERVER
conf/
deploy/
lib/
lib/ : JBoss server log directory