Difference between revisions of "Post Installation"
(Created page with "After installation and configuration previously described, make sure that, in case of *nix systems, the user with which {{GVESB}} will be executed has permission for the followi...") |
|||
(11 intermediate revisions by 5 users not shown) | |||
Line 1: | Line 1: | ||
− | After | + | After [[Installation]] and configuration previously described, make sure that, in case of *nix systems, the user with which {{GVESB}} will be executed has exec permission for the following scripts: |
− | : $ | + | : $GV_HOME/bin/env_scripts.sh<br/> |
− | : $ | + | : $GV_HOME/bin/gvstart.sh<br/> |
+ | : $GV_HOME/bin/gvstop.sh<br/> | ||
+ | : $GV_HOME/hsqldb/bin/start_DB.sh<br/> | ||
+ | : $GV_HOME/hsqldb/stop_DB.sh<br/> | ||
: $JBOSS_HOME/bin/run.sh<br/> | : $JBOSS_HOME/bin/run.sh<br/> | ||
: $JBOSS_HOME/bin/shutdown.sh | : $JBOSS_HOME/bin/shutdown.sh | ||
− | |||
'''Finalizing the installation''' | '''Finalizing the installation''' | ||
− | |||
If you have chosen to perform the installation by downloading the {{GVESB}} Package that does not include JBoss, you need to change some files with steps described below: | If you have chosen to perform the installation by downloading the {{GVESB}} Package that does not include JBoss, you need to change some files with steps described below: | ||
− | + | {| class="note" | |
− | |||
− | {| class=" | ||
|- | |- | ||
− | | [[File: | + | | [[File:info.png]] |
+ | | The ''jboss-service.xml'' is present in the following location: | ||
: $GV_SERVER/conf | : $GV_SERVER/conf | ||
The variable gv.app.home defined in the script ''start'' indicates the home directory of the product. | 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'': | Add the following lines to the file ''jboss-service.xml'': | ||
− | + | <syntaxhighlight lang="XML"> | |
− | + | <!-- GreenVulcano ESB library directory --> | |
− | + | <classpath codebase="${gv.app.home}/application/lib" archives="*"/> | |
− | + | </syntaxhighlight> | |
before | before | ||
+ | <syntaxhighlight lang="XML"> | ||
+ | <classpath codebase="${jboss.server.lib.url}" archives="*"/> | ||
+ | <classpath codebase="${jboss.common.lib.url}" archives="*"/> | ||
+ | </syntaxhighlight> | ||
− | + | Change in the file the ''bootstrap/profile.xml'' the configuration of the ''mbean'' ''BootstrapProfileFactory'' as follows: | |
− | + | {| class="note" | |
− | + | |- | |
− | Change in the | + | | [[File:info.png]] |
− | + | | The file ''profile.xml'' is present in the following path: | |
− | : | + | :$GV_SERVER/conf/bootstrap |
− | + | |} | |
− | + | <syntaxhighlight lang="XML"> | |
− | + | <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> | ||
+ | </syntaxhighlight> | ||
− | + | Modify the file ''login-config.xml'' as follows: | |
− | Modify the file ''login-config.xml'' as | + | {| class="note" |
− | |||
− | {| class=" | ||
|- | |- | ||
− | | [[File: | + | | [[File:info.png]] |
− | : $GV_SERVER/conf | + | | 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 | ||
|} | |} | ||
− | + | <syntaxhighlight lang="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> | ||
+ | </syntaxhighlight> | ||
− | + | {| class="note" | |
− | {| class=" | ||
|- | |- | ||
− | | [[File: | + | | [[File:info.png]] |
+ | | The third part configurable components, in order to be integrated with {{GVESB}}, <br/>can be copied in the following directory: | ||
: $GV_HOME/application/deploy | : $GV_HOME/application/deploy | ||
|} | |} | ||
+ | When the installation procedure described above is finished, the file system will be structured as follows: | ||
+ | ::'''$GV_HOME/''' | ||
+ | :::'''application/''' | ||
+ | ::::'''deploy/''': contains the application components (ejb, war, ear) and the configuration files of the application server (JBoss) resources. | ||
+ | ::::'''lib/''' : contains the {{GVESB}} 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 {{GVESB}} | ||
+ | ::::'''reference/''': contains the PDF files that are the {{GVESB}} configuration 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 | ||
+ | :::'''gvconsole/''': contains the {{L_GVCONSOLE}} work files and the configurations back-up | ||
+ | ::::'''etc/''' | ||
+ | ::::'''lock/''' | ||
+ | :::'''gvdte/''' : contains the transformations maps used by the {{GVESB}} 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 {{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}} | ||
+ | :::'''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 {{GVESB}} | ||
+ | :::'''xmlconfig/''': contains 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 | ||
+ | ::::'''wsdl/''' : contains 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 validation of XML documents. | ||
− | + | ::'''$JBOSS_HOME/''' | |
− | + | :::'''bin/''' | |
− | ::$ | + | :::'''client/''' |
− | ::: | + | :::'''common/''' |
− | ::: | + | :::'''docs/''' |
− | + | :::'''lib/''' | |
− | + | :::'''server/''' | |
− | + | ::::'''GreenV/''' --> alias '''$GV_SERVER''' | |
− | ::: | + | :::::'''conf/''' |
− | + | :::::'''deploy/''' | |
− | + | :::::'''lib/''' | |
− | + | :::::'''log/''' : JBoss server log directory | |
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | :::docs/ | ||
− | :::lib/ | ||
− | :::server/ | ||
− | ::::GreenV/ --> alias $GV_SERVER | ||
− | ::::: | ||
− | ::::: | ||
− | ::::: | ||
− | ::::: |
Latest revision as of 10:41, 31 July 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 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
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:
The jboss-service.xml is present in the following location:
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 follows:
The file profile.xml is present in the following path:
|
<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 follows:
<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>
The third part configurable components, in order to be integrated with GreenVulcano® ESB, can be copied in the following directory:
|
When the installation procedure described above is finished, the file system will be structured as follows:
- $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
- datasource/
- 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.
- application/
- $GV_HOME/
- $JBOSS_HOME/
- bin/
- client/
- common/
- docs/
- lib/
- server/
- GreenV/ --> alias $GV_SERVER
- conf/
- deploy/
- lib/
- log/ : JBoss server log directory
- GreenV/ --> alias $GV_SERVER
- $JBOSS_HOME/