Kapitel 4. Tools und Tipps

Prozedur 4.1. Installation und Ausführung von Tattletale zum Auffinden von Applikationsabhängigkeiten

1. Abschnitt 4.1.4, »Download und Installation von Tattletale«
2. Abschnitt 4.1.5, »Erstellen und Prüfen des Tattletale Berichts«

Prozedur 4.2. Download und Installation von Tattletale

1. Laden Sie sich die Tattletale Version 1.2.0.Beta2 oder neuer unter http://sourceforge.net/projects/jboss/files/JBoss%20Tattletale.
2. Entpacken Sie die Datei im Verzeichnis Ihrer Wahl.
3. Bearbeiten Sie die TATTLETALE_HOME/jboss-tattletale.properties-Datei wie folgt:
   1. Fügen Sie der profiles-Property ee6 und as7 hinzu.

      profiles=java5, java6, ee6, as7

      Copy to Clipboard Toggle word wrap
   2. Entfernen Sie die Kommentierung aus den scan- und reports-Properties.

1. Erstellen Sie mitteldes des folgenden Befehls einen Tattletale Bericht: java -jar TATTLETALE_HOME/tattletale.jar APPLICATION_ARCHIVE OUTPUT_DIRECTORY
   Zum Beispiel: java -jar tattletale-1.2.0.Beta2/tattletale.jar ~/applications/jboss-seam-booking.ear ~/output-results/
2. Öffnen Sie in einem Browser die OUTPUT_DIRECTORY/index.html-Datei und klicken Sie auf "JBoss AS 7" unter dem "Reports"-Abschnitt.
   1. Die linke Spalte listet die von der Applikation verwendeten Archive. Klicken Sie auf das ARCHIVE_NAME-Link um weitere Informationen zu dem Archiv zu erhalten, so etwa zum Speicherort, Manifestinformationen und Klassen, die es enthält.
   2. Das jboss-deployment-structure.xml-Link in der rechten Spalte zeigt wie die Modulabhängigkeit für das in der linlken Spalte genannte Archiv festgelegt wird. Klicken Sie auf dieses Link um zu sehen, wie die Informationen zum Deployment-Abhängigkeitsmodul für dieses Archiv definiert werden.

Prozedur 4.3. Installation und Ausführung des IronJacamar Migrationstools

1. Abschnitt 4.1.7, »Download und Installation des IronJacamar Migrationstools«
2. Abschnitt 4.1.8, »Verwenden Sie das IronJacamar Migrationstool für die Konvertierung einer Datenquellen-Konfigurationsdatei «
3. Abschnitt 4.1.9, »Verwenden Sie das IronJacamar Migrationstool für die Konvertierung einer Ressourcenadapter-Konfigurationsdatei «

1. Laden Sie die neuste Ausgabe von IronJacamar hier herunter: http://www.ironjacamar.org/download.html
2. Entpacken Sie die heruntergeladene Datei im Verzeichnis Ihrer Wahl.
3. Finden Sie das Converter-Skript in der IronJacamar_Distribution.

   • Das Linux-Skript befindet sich hier: IRONJACAMAR_HOME/doc/as/converter.sh
   • Die Windows Batch-Datei befindet sich hier: IRONJACAMAR_HOME/doc/as/converter.bat

Prozedur 4.4. Konvertierung einer Datenquellen-Konfigurationsdatei

1. Öffnen Sie eine Befehlszeile und navigieren Sie zum IRONJACAMAR_HOME/doc/as/-Verzeichnis.
2. Führen Sie das Converter-Skript durch Eingabe des folgenden Befehls aus:

   • Für Linux: ./converter.sh -ds SOURCE_FILE TARGET_FILE
   • Für Microsoft Windows: ./converter.bat -ds SOURCE_FILETARGET_FILE
   Die SOURCE_FILE ist die Datenquelle -ds.xml-Datei aus der vorherigen Release. Die TARGET_FILE enthält die neue Konfiguration.
   Um zum Beispiel die sich im aktuellen Verzeichnis befindende jboss-seam-booking-ds.xml-Datenquellen-Konfigurationsdatei zu konvertieren, würden Sie folgendes eingeben:

   • Für Linux: ./converter.sh -ds jboss-seam-booking-ds.xml new-datasource-config.xml
   • Für Microsoft Windows: ./converter.bat -ds jboss-seam-booking-ds.xml new-datasource-config.xml
   Beachten Sie, dass der Parameter für die Datenquellenkonversion -ds lautet.
3. Kopieren Sie das <datasource>-Element aus der Zieldatei und fügen Sie es unter dem <subsystem xmlns="urn:jboss:domain:datasources:1.1"><datasources>-Element in die Serverkonfigurationsdatei ein.

   Wichtig

   Sie müssen den Server stoppen, ehe Sie die Server Konfigurations-Datei bearbeiten, damit Ihre Änderungen bei einem Server-Neustart als dauerhaft erstellt werden.

   • Falls Sie mit einer Managed Domain arbeiten, so kopieren Sie die XML in die EAP_HOME/domain/configuration/domain.xml-Datei.
   • Falls Sie mit einem Standalone Server arbeiten, kopieren Sie die XML in die EAP_HOME/standalone/configuration/standalone.xml-Datei.
4. Bearbeiten Sie die generierte XML in der neuen Konfigurationsdatei.
   Hier ist ein Beispiel der jboss-seam-booking-ds.xml Datenquellen-Konfigurationsdatei für das Seam 2.2 Booking-Beispiel, das mit der JBoss EAP 5.x geliefert wurde:

   <?xml version="1.0" encoding="UTF-8"?>
   <datasources>
     <local-tx-datasource>
       <jndi-name>bookingDatasource</jndi-name>
       <connection-url>jdbc:hsqldb:.</connection-url>
       <driver-class>org.hsqldb.jdbcDriver</driver-class>
       <user-name>sa</user-name>
       <password></password>
     </local-tx-datasource>
   </datasources>

   Copy to Clipboard Toggle word wrap

   Nachfolgend sehen Sie die Konfigurationsdatei, die durch Ausführung des Converter-Skripts generiert wurde. Die generierte Datei enthält ein <driver-class>-Element. Die bevorzugte Weise der Definition der Treiberklasse bei der JBoss EAP 6 ist mittels eines <driver>-Elements. Hier ist die resultierende XML in der JBoss EAP 6 Konfigurationsdatei mit Änderungen, um das <driver-class>-Element auszukommentieren und das entsprechende <driver>-Element hinzuzufügen:

   <subsystem xmlns="urn:jboss:domain:datasources:1.1">
     <datasources>
       <datasource enabled="true" jndi-name="java:jboss/datasources/bookingDatasource" jta="true"
               pool-name="bookingDatasource" use-ccm="true" use-java-context="true">
         <connection-url>jdbc:hsqldb:.</connection-url>
         <!-- Comment out the following driver-class element 
              since it is not the preferred way to define this.
              <driver-class>org.hsqldb.jdbcDriver</driver-class>     -->
         <!-- Specify the driver, which is defined later in the datasource  -->
         <driver>h2<driver>
         <transaction-isolation>TRANSACTION_NONE</transaction-isolation>
         <pool>
           <prefill>false</prefill>
           <use-strict-min>false</use-strict-min>
           <flush-strategy>FailingConnectionOnly</flush-strategy>
         </pool>
         <security>
           <user-name>sa</user-name>
           <password/>
         </security>
         <validation>
           <validate-on-match>false</validate-on-match>
           <background-validation>false</background-validation>
           <use-fast-fail>false</use-fast-fail>
         </validation>
         <timeout/>
         <statement>
           <track-statements>false</track-statements>
         </statement>
       </datasource>
       <drivers>
         <!-- The following driver element was not in the 
        XML target file. It was created manually. -->
         <driver name="h2" module="com.h2database.h2">
           <xa-datasource-class>org.h2.jdbcx.JdbcDataSource</xa-datasource-class>
           </driver>
         </drivers>
     </datasources>
   </subsystem>
   

   Copy to Clipboard Toggle word wrap

1. Öffnen Sie eine Befehlszeile und navigieren Sie zum IRONJACAMAR_HOME/docs/as/-Verzeichnis.
2. Führen Sie das Converter-Skript durch Eingabe des folgenden Befehls aus:

   • Für Linux: ./converter.sh -ra SOURCE_FILE TARGET_FILE
   • Für Microsoft Windows: ./converter.bat -ra SOURCE_FILE TARGET_FILE
   Die SOURCE_FILE ist die Ressourcenadapter -ds.xml-Datei der vorherigen Release. Die TARGET_FILE enthält die neue Konfiguration.
   Um zum Beispiel die mttestadapter-ds.xml-Ressourcenadapter-Konfigurationsdatei im aktuellen Verzeichnis zu konvertieren, würden Sie folgendes eingeben:

   • Für Linux: ./converter.sh -ra mttestadapter-ds.xml new-adapter-config.xml
   • Für Microsoft Windows: ./converter.bat -ra mttestadapter-ds.xml new-adapter-config.xml
   Beachten Sie, dass der Parameter für die Konvertierung des Ressourcenadapters -ra ist.
3. Kopieren Sie das gesamte <resource-adapters>-Element aus der Zieldatei und fügen Sie es in der Serverkonfigurationsdatei unter dem <subsystem xmlns="urn:jboss:domain:resource-adapters:1.1">-Element ein.

   Wichtig

   Sie müssen den Server stoppen, ehe Sie die Server Konfigurations-Datei bearbeiten, damit Ihre Änderungen bei einem Server-Neustart als dauerhaft erstellt werden.

   • Falls Sie mit einer Managed Domain arbeiten, so kopieren Sie die XML in die EAP_HOME/domain/configuration/domain.xml-Datei.
   • Falls Sie mit einem Standalone Server arbeiten, kopieren Sie die XML in die EAP_HOME/standalone/configuration/standalone.xml-Datei.
4. Bearbeiten Sie die generierte XML in der neuen Konfigurationsdatei.
   Nachfolgend sehen Sie ein Beispiel für die mttestadapter-ds.xml-Ressourcenadapter-Konfigurationsdatei aus der JBoss EAP 5.x TestSuite:

   <?xml version="1.0" encoding="UTF-8"?>
     <!-- ==================================================================== -->
     <!-- ConnectionManager setup for jboss test adapter                       -->
     <!-- Build jmx-api (build/build.sh all) and view for config documentation -->
     <!-- ==================================================================== -->
   <connection-factories>
     <tx-connection-factory>
       <jndi-name>JBossTestCF</jndi-name>
       <xa-transaction/>
       <rar-name>jbosstestadapter.rar</rar-name>
       <connection-definition>javax.resource.cci.ConnectionFactory</connection-definition>
       <config-property name="IntegerProperty" type="java.lang.Integer">2</config-property>
       <config-property name="BooleanProperty" type="java.lang.Boolean">false</config-property>
       <config-property name="DoubleProperty" type="java.lang.Double">5.5</config-property>
       <config-property name="UrlProperty" type="java.net.URL">http://www.jboss.org</config-property>
       <config-property name="sleepInStart" type="long">200</config-property>
       <config-property name="sleepInStop" type="long">200</config-property>
     </tx-connection-factory>
     <tx-connection-factory>
       <jndi-name>JBossTestCF2</jndi-name>
       <xa-transaction/>
       <rar-name>jbosstestadapter.rar</rar-name>
       <connection-definition>javax.resource.cci.ConnectionFactory</connection-definition>
       <config-property name="IntegerProperty" type="java.lang.Integer">2</config-property>
       <config-property name="BooleanProperty" type="java.lang.Boolean">false</config-property>
       <config-property name="DoubleProperty" type="java.lang.Double">5.5</config-property>
       <config-property name="UrlProperty" type="java.net.URL">http://www.jboss.org</config-property>
       <config-property name="sleepInStart" type="long">200</config-property>
       <config-property name="sleepInStop" type="long">200</config-property>
     </tx-connection-factory>
     <tx-connection-factory>
       <jndi-name>JBossTestCFByTx</jndi-name>
       <xa-transaction/>
       <track-connection-by-tx>true</track-connection-by-tx>
       <rar-name>jbosstestadapter.rar</rar-name>
       <connection-definition>javax.resource.cci.ConnectionFactory</connection-definition>
       <config-property name="IntegerProperty" type="java.lang.Integer">2</config-property>
       <config-property name="BooleanProperty" type="java.lang.Boolean">false</config-property>
       <config-property name="DoubleProperty" type="java.lang.Double">5.5</config-property>
       <config-property name="UrlProperty" type="java.net.URL">http://www.jboss.org</config-property>
       <config-property name="sleepInStart" type="long">200</config-property>
       <config-property name="sleepInStop" type="long">200</config-property>
     </tx-connection-factory>
   </connection-factories>

   Copy to Clipboard Toggle word wrap

   Nachfolgend sehen Sie die Konfigurationsdatei, die durch Ausführung des Converter-Skripts generiert wurde. Ersetzen Sie den Wert des class-name Attributs "FIXME_MCF_CLASS_NAME" in der generierten XML durch den korrekten Klassennamen der gemanagten Connection-Factory, in diesem Fall "org.jboss.test.jca.adapter.TestManagedConnectionFactory". Hier ist die resultierende XML in der JBoss EAP 6 Konfigurationsdatei mit Änderungen am <class-name>-Elementwert:

   <subsystem xmlns="urn:jboss:domain:resource-adapters:1.1">
     <resource-adapters>
       <resource-adapter>
         <archive>jbosstestadapter.rar</archive>
         <transaction-support>XATransaction</transaction-support>
         <connection-definitions>
     <!-- Replace the "FIXME_MCF_CLASS_NAME" class-name value with the correct class name
     <connection-definition class-name="FIXME_MCF_CLASS_NAME" enabled="true"
       jndi-name="java:jboss/JBossTestCF" pool-name="JBossTestCF" 
       use-ccm="true" use-java-context="true"> -->
     <connection-definition 
       class-name="org.jboss.test.jca.adapter.TestManagedConnectionFactory" 
       enabled="true"
       jndi-name="java:jboss/JBossTestCF" pool-name="JBossTestCF" 
       use-ccm="true" use-java-context="true">
       <config-property name="IntegerProperty">2</config-property>
       <config-property name="sleepInStart">200</config-property>
       <config-property name="sleepInStop">200</config-property>
       <config-property name="BooleanProperty">false</config-property>
       <config-property name="UrlProperty">http://www.jboss.org</config-property>
       <config-property name="DoubleProperty">5.5</config-property>
       <pool>
         <prefill>false</prefill>
         <use-strict-min>false</use-strict-min>
         <flush-strategy>FailingConnectionOnly</flush-strategy>
       </pool>
       <security>
         <application/>
       </security>
       <timeout/>
       <validation>
         <background-validation>false</background-validation>
         <use-fast-fail>false</use-fast-fail>
       </validation>
     </connection-definition>
         </connection-definitions>
       </resource-adapter>
       <resource-adapter>
         <archive>jbosstestadapter.rar</archive>
         <transaction-support>XATransaction</transaction-support>
         <connection-definitions>
     <!-- Replace the "FIXME_MCF_CLASS_NAME" class-name value with the correct class name
      <connection-definition class-name="FIXME_MCF_CLASS_NAME" enabled="true"
       jndi-name="java:jboss/JBossTestCF2" pool-name="JBossTestCF2" 
       use-ccm="true" use-java-context="true"> -->
     <connection-definition 
       class-name="org.jboss.test.jca.adapter.TestManagedConnectionFactory" 
       enabled="true"
       jndi-name="java:jboss/JBossTestCF2" pool-name="JBossTestCF2" 
       use-ccm="true" use-java-context="true">
       <config-property name="IntegerProperty">2</config-property>
       <config-property name="sleepInStart">200</config-property>
       <config-property name="sleepInStop">200</config-property>
       <config-property name="BooleanProperty">false</config-property>
       <config-property name="UrlProperty">http://www.jboss.org</config-property>
       <config-property name="DoubleProperty">5.5</config-property>
       <pool>
         <prefill>false</prefill>
         <use-strict-min>false</use-strict-min>
         <flush-strategy>FailingConnectionOnly</flush-strategy>
       </pool>
       <security>
         <application/>
       </security>
       <timeout/>
       <validation>
         <background-validation>false</background-validation>
         <use-fast-fail>false</use-fast-fail>
       </validation>
     </connection-definition>
         </connection-definitions>
       </resource-adapter>
       <resource-adapter>
         <archive>jbosstestadapter.rar</archive>
         <transaction-support>XATransaction</transaction-support>
         <connection-definitions>
     <!-- Replace the "FIXME_MCF_CLASS_NAME" class-name value with the correct class name
     <connection-definition class-name="FIXME_MCF_CLASS_NAME" enabled="true"
        jndi-name="java:jboss/JBossTestCFByTx" pool-name="JBossTestCFByTx" 
        use-ccm="true" use-java-context="true"> -->
     <connection-definition 
       class-name="org.jboss.test.jca.adapter.TestManagedConnectionFactory" 
       enabled="true"
       jndi-name="java:jboss/JBossTestCFByTx" pool-name="JBossTestCFByTx" 
       use-ccm="true" use-java-context="true">
       <config-property name="IntegerProperty">2</config-property>
       <config-property name="sleepInStart">200</config-property>
       <config-property name="sleepInStop">200</config-property>
       <config-property name="BooleanProperty">false</config-property>
       <config-property name="UrlProperty">http://www.jboss.org</config-property>
       <config-property name="DoubleProperty">5.5</config-property>
       <pool>
         <prefill>false</prefill>
         <use-strict-min>false</use-strict-min>
         <flush-strategy>FailingConnectionOnly</flush-strategy>
       </pool>
       <security>
         <application/>
       </security>
       <timeout/>
       <validation>
         <background-validation>false</background-validation>
         <use-fast-fail>false</use-fast-fail>
       </validation>
     </connection-definition>
         </connection-definitions>
       </resource-adapter>
     </resource-adapters>
   </subsystem>
   

   Copy to Clipboard Toggle word wrap