Difference between revisions of "Post Installation"

From GreenVulcano Wiki
Jump to: navigation, search
(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 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 following script:
+
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_SERVER/bin/start_GreenV.sh<br/>
+
: $GV_HOME/bin/env_scripts.sh<br/>
: $GV_SERVER/bin/stop_GreenV.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="wikitable" style="margin: 1em auto 1em auto;"
 
 
|-
 
|-
| [[File:helpIcon.jpeg]] || The jboss-service.xml is present in the following location:  
+
| [[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">
: <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>
 
before
 
before
 +
<syntaxhighlight lang="XML">
 +
<classpath codebase="${jboss.server.lib.url}" archives="*"/>
 +
<classpath codebase="${jboss.common.lib.url}" archives="*"/>
 +
</syntaxhighlight>
  
: <classpath codebase="${jboss.server.lib.url:lib}" archives="*"/>
+
Change in the file the ''bootstrap/profile.xml'' the configuration of the ''mbean'' ''BootstrapProfileFactory'' as follows:
 
+
{| class="note"
 
+
|-
Change in the same file the URLs value for the ''mbean'':
+
| [[File:info.png]]
 
+
| The file ''profile.xml'' is present in the following path:
: name: jboss.deployment: type = DeploymentScanner, flavor = URL
+
:$GV_SERVER/conf/bootstrap
 
+
|}
adding the following string separated by a comma:
+
<syntaxhighlight lang="XML">
 
+
<bean name="BootstrapProfileFactory" class="org.jboss.system.server.profileservice.repository.StaticProfileFactory">
: file://${gv.app.home}/application/deploy/
+
      <property name="bindingsURI">${jboss.server.home.url}conf/bindingservice.beans</property>
 
+
      <property name="bootstrapURI">${jboss.server.home.url}conf/jboss-service.xml</property>
For example:
+
      <property name="deployersURI">${jboss.server.home.url}deployers</property>
 
+
      <property name="applicationURIs">
: <mbean code="org.jboss.deployment.scanner.URLDeploymentScanner" name="jboss.deployment:type=DeploymentScanner,flavor=URL">
+
        <list elementClass="java.net.URI">
: . . . . .
+
            <value>${jboss.server.home.url}deploy</value>
::<attribute name="URLs">deploy/,file:${gv.app.home}/application/deploy/</attribute>
+
            <!-- GreenVulcano ESB deployment directory -->
::. . . . .
+
            <value>file://${gv.app.home}/application/deploy</value>
:</mbean>
+
        </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 follow:
+
{| class="note"
 
 
{| class="wikitable" style="margin: 1em auto 1em auto;"
 
 
|-
 
|-
| [[File:helpIcon.jpeg]] || The file ''login-config.xml'' is present in the following path  
+
| [[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
 
|}
 
|}
  
  
:<application-policy name="gvesb">
+
<syntaxhighlight lang="XML">
::<authentication>
+
<application-policy name="gvesb">
:::<login-module code="org.jboss.security.auth.spi.UsersRolesLoginModule" flag="required">
+
    <authentication>
::::<module-option name="usersProperties">gvesb-users.properties</module-option>
+
        <login-module code="org.jboss.security.auth.spi.UsersRolesLoginModule"
::::<module-option name="rolesProperties">gvesb-roles.properties</module-option>
+
                      flag="required">
:::</login-module>
+
            <module-option name="usersProperties">gvesb-users.properties</module-option>
::</authentication>
+
            <module-option name="rolesProperties">gvesb-roles.properties</module-option>
:</application-policy>
+
        </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="wikitable" style="margin: 1em auto 1em auto;"
 
 
|-
 
|-
| [[File:helpIcon.jpeg]] || The third part configurable components, in order to be integrated with {{GVESB}}, <br/>can be copied in the following directory:  
+
| [[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.
  
When the installation procedure described above is finished, the file system will be structured as follow:
+
::'''$JBOSS_HOME/'''
 
+
:::'''bin/'''
::$GV_HOME/
+
:::'''client/'''
:::application/
+
:::'''common/'''
::::deploy/
+
:::'''docs/'''
::::gvlib/
+
:::'''lib/'''
::::lib/
+
:::'''server/'''
:::BIRTReportEngine/
+
::::'''GreenV/''' --> alias '''$GV_SERVER'''
:::doc/
+
:::::'''conf/'''
:::dtds/
+
:::::'''deploy/'''
:::gvconsole/
+
:::::'''lib/'''
::::etc/
+
:::::'''log/''' : JBoss server log directory
::::lock/
 
:::gvdte/
 
:::log/
 
:::webservices/
 
:::xmlconfig/
 
::$JBOSS_HOME/
 
:::bin/
 
:::client/
 
:::docs/
 
:::lib/
 
:::server/
 
::::GreenV/ --> alias $GV_SERVER
 
:::::bin/
 
:::::conf/
 
:::::deploy
 
:::::lib/
 

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:

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 follows:

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 follows:

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 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
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/
log/ : JBoss server log directory