You are viewing a plain text version of this content. The canonical link for it is here.
Posted to scm@geronimo.apache.org by pm...@apache.org on 2007/06/14 17:39:21 UTC
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/
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>