geronimo-scm mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From pmcma...@apache.org
Subject svn commit: r547285 - in /geronimo/sandbox/j2g: ./ doc/ plugins/org.apache.geronimo.j2g.resources.mail/test-apps/mail/ plugins/org.apache.geronimo.j2g.resources.security/test-apps/security/ src/main/assembly/
Date Thu, 14 Jun 2007 15:39:21 GMT
Author: pmcmahan
Date: Thu Jun 14 08:39:20 2007
New Revision: 547285

URL: http://svn.apache.org/viewvc?view=rev&rev=547285
Log:
GERONIMO-3159 improve J2G documentation.  Patch submitted by Erik Craig.

Added:
    geronimo/sandbox/j2g/doc/readme.txt
Removed:
    geronimo/sandbox/j2g/doc/J2G-Article.doc
Modified:
    geronimo/sandbox/j2g/plugins/org.apache.geronimo.j2g.resources.mail/test-apps/mail/mail-geronimo-plan.xml
    geronimo/sandbox/j2g/plugins/org.apache.geronimo.j2g.resources.security/test-apps/security/security-geronimo-plan.xml
    geronimo/sandbox/j2g/readme.txt
    geronimo/sandbox/j2g/src/main/assembly/bin.xml

Added: geronimo/sandbox/j2g/doc/readme.txt
URL: http://svn.apache.org/viewvc/geronimo/sandbox/j2g/doc/readme.txt?view=auto&rev=547285
==============================================================================
--- geronimo/sandbox/j2g/doc/readme.txt (added)
+++ geronimo/sandbox/j2g/doc/readme.txt Thu Jun 14 08:39:20 2007
@@ -0,0 +1,81 @@
+/**
+ *  Licensed to the Apache Software Foundation (ASF) under one or more
+ *  contributor license agreements.  See the NOTICE file distributed with
+ *  this work for additional information regarding copyright ownership.
+ *  The ASF licenses this file to You under the Apache License, Version 2.0
+ *  (the "License"); you may not use this file except in compliance with
+ *  the License.  You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ *  Unless required by applicable law or agreed to in writing, software
+ *  distributed under the License is distributed on an "AS IS" BASIS,
+ *  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ *  See the License for the specific language governing permissions and
+ *  limitations under the License.
+ */
+==================================
+J2G-Migration Package
+==================================
+Note: Please visit http://cwiki.apache.org/confluence/display/GMOxDOC11/J2G+Migration+Tool
for more thorough documentation
+
+JBoss to Geronimo (J2G) is a tool set built as command line Eclipse SDK plug-ins 
+designed to assist in migrating the sources of an application written for the JBoss 
+application server or written for Java 2 Enterprise Edition (J2EE) to the Apache 
+Geronimo platform.
+
+==================================
+Dependencies
+==================================
+The J2G tool set requires at least the following application versions
+(these are the versions J2G is known to work on)
+
+    * Sun JDK 5.0+ (J2SE 1.5)
+    * Eclipse SDK 3.3M7 with JDT Core Plug-in
+    * Apache Geronimo 1.1.1
+    * Application written for JBoss 3.2 and up or J2EE 1.2 and up.
+
+==================================
+Environment Variables
+==================================
+The tools in J2G require that the following environment variables be set to the proper 
+locations:
+
+    * JAVA_HOME (Location of the JDK)
+    * ECLIPSE_HOME (Location of the Eclipse SDK)
+    * WORKSPACE (Location for a temporary eclipse workspace)
+
+==================================
+1. Configurator
+==================================
+To run this component, navigate to bin, and run j2g-configure
+
+This will automatically copy the contents of the ./plugins directory to ECLIPSE_HOME/plugins,

+as well as make changes (or create, if necessary) to ECLIPSE_HOME/configuration/config.ini.
+
+==================================
+2. Source Identification Tool
+==================================
+This tool parses through source code (.java and .jsp files) recursively in directories 
+passed to it as command line arguments. While doing this, it replaces any JBoss classes 
+and dependencies for which there are Geronimo equivalents. If there is no equivalent, it

+will alert the user of this issue which must be resolved either through manual creation 
+of a replacement class or rewriting the segment of code dependent on the JBoss class.
+
+ - Usage: jsrc2g -src <APPLICATION>\src -web <APPLICATION>\web -geronimo <GERONIMO_HOME>
+
+==================================
+3. Descriptors Conversion Tool
+==================================
+This tool converts JBoss specific deployment descriptors and J2EE standard deployment 
+descriptors (if necessary) to their Geronimo equivalents.
+
+ - Usage: jdesc2g <APPLICATION>
+
+==================================
+4. Resource Conversion Tool
+==================================
+This tool converts JBoss specific resources, such as Java Messaging Services (JMS) Queues,

+JMS Topics, Java Database Connectivity (JDBC) data sources to their Geronimo equivalents.
+
+ - Usage: jres2g <APPLICATION>

Modified: geronimo/sandbox/j2g/plugins/org.apache.geronimo.j2g.resources.mail/test-apps/mail/mail-geronimo-plan.xml
URL: http://svn.apache.org/viewvc/geronimo/sandbox/j2g/plugins/org.apache.geronimo.j2g.resources.mail/test-apps/mail/mail-geronimo-plan.xml?view=diff&rev=547285&r1=547284&r2=547285
==============================================================================
--- geronimo/sandbox/j2g/plugins/org.apache.geronimo.j2g.resources.mail/test-apps/mail/mail-geronimo-plan.xml
(original)
+++ geronimo/sandbox/j2g/plugins/org.apache.geronimo.j2g.resources.mail/test-apps/mail/mail-geronimo-plan.xml
Thu Jun 14 08:39:20 2007
@@ -1,23 +1,23 @@
-<?xml version="1.0" encoding="UTF-8"?>
-
-<module xmlns="http://geronimo.apache.org/xml/ns/deployment-1.1">
-  <environment>
-    <moduleId>
-      <groupId>j2g</groupId>
-      <artifactId>Mail</artifactId>
-      <version>1.0</version>
-      <type>car</type>
-    </moduleId>
-    <dependencies>
-      <dependency>
-        <groupId>geronimo</groupId>
-        <artifactId>javamail</artifactId>
-        <version>1.1</version>
-        <type>car</type>
-      </dependency>
-    </dependencies>
-  </environment>
-  <gbean name="mailSession" class="org.apache.geronimo.mail.MailGBean">
+<?xml version="1.0" encoding="UTF-8"?>
+
+<module xmlns="http://geronimo.apache.org/xml/ns/deployment-1.1">
+  <environment>
+    <moduleId>
+      <groupId>j2g</groupId>
+      <artifactId>Mail</artifactId>
+      <version>1.0</version>
+      <type>car</type>
+    </moduleId>
+    <dependencies>
+      <dependency>
+        <groupId>geronimo</groupId>
+        <artifactId>javamail</artifactId>
+        <version>1.1</version>
+        <type>car</type>
+      </dependency>
+    </dependencies>
+  </environment>
+  <gbean name="mailSession" class="org.apache.geronimo.mail.MailGBean">
     <attribute name="properties"><![CDATA[
 mail.store.protocol=pop3
 mail.transport.protocol=smtp
@@ -25,6 +25,6 @@
 mail.pop3.host=pop3.nosuchhost.nosuchdomain.com
 mail.smtp.host=smtp.nosuchhost.nosuchdomain.com
 mail.from=nobody@nosuchhost.nosuchdomain.com
-mail.debug=false]]></attribute>
-  </gbean>
-</module>
+mail.debug=false]]></attribute>
+  </gbean>
+</module>

Modified: geronimo/sandbox/j2g/plugins/org.apache.geronimo.j2g.resources.security/test-apps/security/security-geronimo-plan.xml
URL: http://svn.apache.org/viewvc/geronimo/sandbox/j2g/plugins/org.apache.geronimo.j2g.resources.security/test-apps/security/security-geronimo-plan.xml?view=diff&rev=547285&r1=547284&r2=547285
==============================================================================
--- geronimo/sandbox/j2g/plugins/org.apache.geronimo.j2g.resources.security/test-apps/security/security-geronimo-plan.xml
(original)
+++ geronimo/sandbox/j2g/plugins/org.apache.geronimo.j2g.resources.security/test-apps/security/security-geronimo-plan.xml
Thu Jun 14 08:39:20 2007
@@ -28,7 +28,7 @@
         <log:login-module control-flag="REQUIRED" server-side="true" wrap-principals="false">
           <log:login-domain-name>jbossmq</log:login-domain-name>
           <log:login-module-class>org.apache.geronimo.security.realm.providers.SQLLoginModule</log:login-module-class>
-          <log:option name="dataSourceName">java:/DefaultDS/Test</log:option>
+          <log:option name="dataSourceName">DefaultDS/Test</log:option>
           <log:option name="userSelect">SELECT PASSWD FROM JMS_USERS WHERE USERID=?</log:option>
           <log:option name="groupSelect">SELECT ROLEID, 'Roles' FROM JMS_ROLES WHERE
USERID=?</log:option>
         </log:login-module>

Modified: geronimo/sandbox/j2g/readme.txt
URL: http://svn.apache.org/viewvc/geronimo/sandbox/j2g/readme.txt?view=diff&rev=547285&r1=547284&r2=547285
==============================================================================
--- geronimo/sandbox/j2g/readme.txt (original)
+++ geronimo/sandbox/j2g/readme.txt Thu Jun 14 08:39:20 2007
@@ -24,15 +24,5 @@
 
 The binary assembly will be located in the target directory.
 
-For usage information consult the documentation J2G-Migration-v2-UG.doc which
-resides in the JIRA mentioned below.
-
--- 3/19/2007
-While importing J2G into Apache SVN some of the MS word files in the doc
-directory were not imported because of their "Confidential" footer.  Those
-documents can be retrieved from the zip file attached to the JIRA at:
-  
-    https://issues.apache.org/jira/browse/GERONIMO-2743
-
-The IP clearance information is available at
-http://incubator.apache.org/ip-clearance/geronimo-2743-ibm-covalent-j2g.html
\ No newline at end of file
+For additional building information, visit http://cwiki.apache.org/confluence/display/GMOxDOC11/J2G+Migration+Tool
+For usage information consult the documentation doc/readme.txt

Modified: geronimo/sandbox/j2g/src/main/assembly/bin.xml
URL: http://svn.apache.org/viewvc/geronimo/sandbox/j2g/src/main/assembly/bin.xml?view=diff&rev=547285&r1=547284&r2=547285
==============================================================================
--- geronimo/sandbox/j2g/src/main/assembly/bin.xml (original)
+++ geronimo/sandbox/j2g/src/main/assembly/bin.xml Thu Jun 14 08:39:20 2007
@@ -49,5 +49,9 @@
             <directory>src/main/resources</directory>
             <outputDirectory>/</outputDirectory>
         </fileSet>
+        <fileSet>
+            <directory>documentation</directory>
+            <outputDirectory>/</outputDirectory>
+        </fileSet>
     </fileSets>
 </assembly>



Mime
View raw message