Author: mcaspers Date: 2011-01-11 22:15:31 -0500 (Tue, 11 Jan 2011) New Revision: 28110 Added: trunk/documentation/guides/MigrationGuide/en-US/images/switchworkspace.png trunk/documentation/guides/MigrationGuide/en-US/migration.xml.old Modified: trunk/documentation/guides/MigrationGuide/en-US/Author_Group.xml trunk/documentation/guides/MigrationGuide/en-US/Book_Info.xml trunk/documentation/guides/MigrationGuide/en-US/Migration_Guide.ent trunk/documentation/guides/MigrationGuide/en-US/Migration_Guide.xml trunk/documentation/guides/MigrationGuide/en-US/Revision_History.xml trunk/documentation/guides/MigrationGuide/en-US/introduction.xml trunk/documentation/guides/MigrationGuide/en-US/migration.xml Log: Updated for migration from 3.0x to 4.0 Modified: trunk/documentation/guides/MigrationGuide/en-US/Author_Group.xml =================================================================== --- trunk/documentation/guides/MigrationGuide/en-US/Author_Group.xml 2011-01-12 03:13:33 UTC (rev 28109) +++ trunk/documentation/guides/MigrationGuide/en-US/Author_Group.xml 2011-01-12 03:15:31 UTC (rev 28110) @@ -1,4 +1,10 @@ <?xml version='1.0' encoding='utf-8' ?> <!DOCTYPE Book PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [ ]> -<authorgroup><author><firstname>JBoss Tools Team</firstname></author></authorgroup> +<authorgroup> + <author> + <firstname>Matthew</firstname> + <surname>Casperson</surname> + <email&gt;mcaspers(a)redhat.com&lt;/email&gt; + </author> +</authorgroup> Modified: trunk/documentation/guides/MigrationGuide/en-US/Book_Info.xml =================================================================== --- trunk/documentation/guides/MigrationGuide/en-US/Book_Info.xml 2011-01-12 03:13:33 UTC (rev 28109) +++ trunk/documentation/guides/MigrationGuide/en-US/Book_Info.xml 2011-01-12 03:15:31 UTC (rev 28110) @@ -3,7 +3,7 @@ ]> <bookinfo> <title>Migration Guide</title> - <subtitle>JBoss Developer Studio 2.1 to 3.0.</subtitle> + <subtitle>JBoss Developer Studio 3.0x to 4.0.</subtitle> <productname>JBoss Developer Studio</productname> <productnumber>4.0</productnumber> <edition>4.0.0</edition> Modified: trunk/documentation/guides/MigrationGuide/en-US/Migration_Guide.ent =================================================================== --- trunk/documentation/guides/MigrationGuide/en-US/Migration_Guide.ent 2011-01-12 03:13:33 UTC (rev 28109) +++ trunk/documentation/guides/MigrationGuide/en-US/Migration_Guide.ent 2011-01-12 03:15:31 UTC (rev 28110) @@ -1,4 +1,4 @@ <!ENTITY PRODUCT "JBoss"> <!ENTITY BOOKID "Migration_Guide"> -<!ENTITY YEAR "2010"> +<!ENTITY YEAR "2011"> <!ENTITY HOLDER "Red Hat"> Modified: trunk/documentation/guides/MigrationGuide/en-US/Migration_Guide.xml =================================================================== --- trunk/documentation/guides/MigrationGuide/en-US/Migration_Guide.xml 2011-01-12 03:13:33 UTC (rev 28109) +++ trunk/documentation/guides/MigrationGuide/en-US/Migration_Guide.xml 2011-01-12 03:15:31 UTC (rev 28110) @@ -6,6 +6,6 @@ <xi:include href="Preface.xml" xmlns:xi="http://www.w3.org/2001/XInclude"></xi:include> <xi:include href="introduction.xml" xmlns:xi="http://www.w3.org/2001/XInclude"></xi:include> <xi:include href="migration.xml" xmlns:xi="http://www.w3.org/2001/XInclude"></xi:include> -<xi:include href="issues.xml" xmlns:xi="http://www.w3.org/2001/XInclude"></xi:include> +<!--<xi:include href="issues.xml" xmlns:xi="http://www.w3.org/2001/XInclude"></xi:include&g... <xi:include href="Revision_History.xml" xmlns:xi="http://www.w3.org/2001/XInclude"></xi:include> </book> Modified: trunk/documentation/guides/MigrationGuide/en-US/Revision_History.xml =================================================================== --- trunk/documentation/guides/MigrationGuide/en-US/Revision_History.xml 2011-01-12 03:13:33 UTC (rev 28109) +++ trunk/documentation/guides/MigrationGuide/en-US/Revision_History.xml 2011-01-12 03:15:31 UTC (rev 28110) @@ -2,31 +2,51 @@ <!DOCTYPE Book PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [ ]> <appendix> - <title>Revision History</title> - <simpara> - <revhistory> - <revision> - <revnumber>1</revnumber><date>Wed Jun 09 2010</date> - <author> - <firstname>JBoss Tools</firstname><surname>Documentation Team&lt;/surname&gt;&lt;email&gt;irooskov(a)redhat.com&lt;/email&gt; - </author> - <revdescription> - <simplelist> - <member>General updates</member> - </simplelist> - </revdescription> - </revision> - <revision> - <revnumber>0</revnumber><date>Fri Nov 20 2009</date> - <author> - <firstname&gt;Isaac&lt;/firstname&gt;&lt;surname&gt;Rooskov&lt;/surname&gt;&lt;email&gt;irooskov(a)redhat.com&lt;/email&gt; - </author> - <revdescription> - <simplelist> - <member>Initial creation of book by publican</member> - </simplelist> - </revdescription> - </revision> - </revhistory> - </simpara> + <title>Revision History</title> + <simpara> + <revhistory> + <revision> + <revnumber>2</revnumber> + <date>Wed Jan 12 2011</date> + <author> + <firstname>Matthew</firstname> + <surname>Casperson</surname> + <email&gt;mcaspers(a)redhat.com&lt;/email&gt; + </author> + <revdescription> + <simplelist> + <member>Rewrote documentation for JBDS 3.0x to 4.0 update procedure</member> + </simplelist> + </revdescription> + </revision> + <revision> + <revnumber>1</revnumber> + <date>Wed Jun 09 2010</date> + <author> + <firstname>JBoss Tools</firstname> + <surname>Documentation Team</surname> + <email&gt;irooskov(a)redhat.com&lt;/email&gt; + </author> + <revdescription> + <simplelist> + <member>General updates</member> + </simplelist> + </revdescription> + </revision> + <revision> + <revnumber>0</revnumber> + <date>Fri Nov 20 2009</date> + <author> + <firstname>Isaac</firstname> + <surname>Rooskov</surname> + <email&gt;irooskov(a)redhat.com&lt;/email&gt; + </author> + <revdescription> + <simplelist> + <member>Initial creation of book by publican</member> + </simplelist> + </revdescription> + </revision> + </revhistory> + </simpara> </appendix> Added: trunk/documentation/guides/MigrationGuide/en-US/images/switchworkspace.png =================================================================== (Binary files differ) Property changes on: trunk/documentation/guides/MigrationGuide/en-US/images/switchworkspace.png ___________________________________________________________________ Name: svn:mime-type + application/octet-stream Modified: trunk/documentation/guides/MigrationGuide/en-US/introduction.xml =================================================================== --- trunk/documentation/guides/MigrationGuide/en-US/introduction.xml 2011-01-12 03:13:33 UTC (rev 28109) +++ trunk/documentation/guides/MigrationGuide/en-US/introduction.xml 2011-01-12 03:15:31 UTC (rev 28110) @@ -1,27 +1,25 @@ <?xml version="1.0" encoding="UTF-8"?> <chapter id="introduction" xreflabel="introduction"> - <?dbhtml filename="introduction.html"?> - <chapterinfo> - <keywordset> - <keyword>JBoss Developer Studio</keyword> - <keyword>JBDS</keyword> - <keyword>Exadel Studio Pro</keyword> - </keywordset> - </chapterinfo> + <?dbhtml filename="introduction.html"?> + <chapterinfo> + <keywordset> + <keyword>JBoss Developer Studio</keyword> + <keyword>JBDS</keyword> + <keyword>Exadel Studio Pro</keyword> + </keywordset> + </chapterinfo> - <title>Introduction </title> - <para>This document is intended to help you to easily migrate from 2.1 to 3.0.0 - <property>JBoss Developer Studio</property>. - It also describes some popular issues that can appear while the process of migration, - as well as the methods of their solving. </para> - + <title>Introduction </title> + <para> + This document is intended to help you to easily migrate from 3.0x to 4.0 <property>JBoss Developer Studio</property>. It also describes some popular issues that can appear while the process of migration, as well as the methods of their solving. + </para> - <section> - <title>Other relevant resources on the topic</title> - <para>All JBoss Developer Studio release documentation you can find at <ulink url="http://www.redhat.com/docs/en-US/JBoss_Developer_Studio/"&... in the corresponding release directory.</para> - <para>For more information about JBoss Developer Studio please visit + <section> + <title>Other relevant resources on the topic</title> + <para>All JBoss Developer Studio release documentation you can find at <ulink url="http://www.redhat.com/docs/en-US/JBoss_Developer_Studio/"&... in the corresponding release directory.</para> + <para>For more information about JBoss Developer Studio please visit <ulink url="http://www.jboss.com/products/devstudio/">http://www.jb... - <para>If your problem is not described in the guide or you have questions or suggestions concerned both the documentation and studio behavior, you are welcome at <ulink url="http://community.jboss.org/en/jbossdevstudio?view=discussions&q... Users forum</ulink>. + <para>If your problem is not described in the guide or you have questions or suggestions concerned both the documentation and studio behavior, you are welcome at <ulink url="http://community.jboss.org/en/jbossdevstudio?view=discussions&q... Users forum</ulink>. </para> - </section> + </section> </chapter> Modified: trunk/documentation/guides/MigrationGuide/en-US/migration.xml =================================================================== --- trunk/documentation/guides/MigrationGuide/en-US/migration.xml 2011-01-12 03:13:33 UTC (rev 28109) +++ trunk/documentation/guides/MigrationGuide/en-US/migration.xml 2011-01-12 03:15:31 UTC (rev 28110) @@ -1,43 +1,55 @@ <?xml version="1.0" encoding="UTF-8"?> -<chapter id="jsf_struts" xreflabel="jsf_struts"> - <?dbhtml filename="jsf_struts.html"?> - <chapterinfo> - <keywordset> - <keyword>JBoss Developer Studio</keyword> - <keyword>JBDS</keyword> - <keyword>Exadel Studio Pro</keyword> - <keyword>Migration</keyword> - </keywordset> - </chapterinfo> - - <title>Migration Process</title> - <para>This chapter describes the JBoss Developer Studio migration from version - 2.1 to 3.0.</para> - <section id="migration"> - <title>How to migrate the JBoss Developer Studio from 2.1 to 3.0</title> - <para></para> - <para>To migrate from 2.1 to 3.0 you have to perform a new install of the JBoss Developer Studio 3.0 and undertake all the steps of the - installation process that is fully described in - <ulink url="http://www.redhat.com/docs/en-US/JBoss_Developer_Studio/3.0/Get... Started with JBoss Developer Studio</ulink> guide.</para> - <figure> - <title>Process of JBDS 3.0 installation </title> - - <mediaobject> - <imageobject> - <imagedata fileref="images/jbds2.png" /> - </imageobject> - </mediaobject> - </figure> - <para>Since JBoss Developer Studio 3.0 uses a new version of Eclipse, an update from within Eclipse cannot be performed as it was when upgrading from JBoss Developer Studio 2.0 to 2.1.</para> - <para>When the installation process is complete you can point to your old workspace directory and continue working with your projects created using previous JBoss Developer Studio versions, or create a new one and import old projects into the new workspace. - </para> - - <note> - <title>Note:</title> - <para>In JBDS 3.0, Linux users no longer need to install the library <filename>libstdc+.so.5</filename>. This library is no longer required and can be removed from the system. - </para> - </note> - </section> +<chapter id="chap-update_site_configuration"> + <?dbhtml filename="update_site_configuration.html"?> + <chapterinfo> + <keywordset> + <keyword>JBoss Developer Studio</keyword> + <keyword>Eclipse</keyword> + <keyword>Java</keyword> + <keyword>JBoss</keyword> + </keywordset> + </chapterinfo> + + <title>Migration Process</title> + + <section id="sect-eclipse-versions"> + <title>JBoss Developer Studio Eclipse Versions</title> + <para> + JBoss Developer Studio (JBDS) 3.0x is based on Eclipse 3.5, while JBDS 4.0 is based on Eclipse 3.6. This prevents a direct upgrade from JBDS 3.0x to 4.0. + </para> + + <para> + Workspaces created with JBDS 3.0x can generally be opened in JBDS 4.0, however this is not guaranteed be the case. Always backup your existing workspaces (see <xref linkend="sect-backup-workspace"/> for more information) before attempting to use them with JBDS 4.0. + </para> + + <note> + <title>Tip</title> + <para> + It is possible to run JBDS 3.0x and 4.0 side by side if they have been installed into separate directories. + </para> + </note> + </section> + + <section id="sect-backup-workspace"> + <title>Back Up Existing Workspaces</title> + <para> + It is recommended that existing workspaces created with JBDS 3.0x are backed up before attempting use them with JBDS 4.0. This can be done by copying the workspace directory to a backup location, or compressing it as an archive. + </para> + <para>To find the location of your workspace directory select <menuchoice><guimenuitem>File</guimenuitem> + <guimenuitem>Switch Workspace</guimenuitem></menuchoice>. The resulting list will show you the location of previously used workspaces. + </para> + + <figure id="figure-switch-workspace"> + <title>Finding Workspace Directories</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/switchworkspace.png" format="PNG"/> + </imageobject> + <textobject> + <para>Workspace Directory List</para> + </textobject> + </mediaobject> + </figure> + </section> - </chapter> Added: trunk/documentation/guides/MigrationGuide/en-US/migration.xml.old =================================================================== --- trunk/documentation/guides/MigrationGuide/en-US/migration.xml.old (rev 0) +++ trunk/documentation/guides/MigrationGuide/en-US/migration.xml.old 2011-01-12 03:15:31 UTC (rev 28110) @@ -0,0 +1,43 @@ +<?xml version="1.0" encoding="UTF-8"?> +<chapter id="jsf_struts" xreflabel="jsf_struts"> + <?dbhtml filename="jsf_struts.html"?> + <chapterinfo> + <keywordset> + <keyword>JBoss Developer Studio</keyword> + <keyword>JBDS</keyword> + <keyword>Exadel Studio Pro</keyword> + <keyword>Migration</keyword> + </keywordset> + </chapterinfo> + + <title>Migration Process</title> + <para>This chapter describes the JBoss Developer Studio migration from version + 2.1 to 3.0.</para> + <section id="migration"> + <title>How to migrate the JBoss Developer Studio from 2.1 to 3.0</title> + <para></para> + <para>To migrate from 2.1 to 3.0 you have to perform a new install of the JBoss Developer Studio 3.0 and undertake all the steps of the + installation process that is fully described in + <ulink url="http://www.redhat.com/docs/en-US/JBoss_Developer_Studio/3.0/Get... Started with JBoss Developer Studio</ulink> guide.</para> + <figure> + <title>Process of JBDS 3.0 installation </title> + + <mediaobject> + <imageobject> + <imagedata fileref="images/jbds2.png" /> + </imageobject> + </mediaobject> + </figure> + <para>Since JBoss Developer Studio 3.0 uses a new version of Eclipse, an update from within Eclipse cannot be performed as it was when upgrading from JBoss Developer Studio 2.0 to 2.1.</para> + <para>When the installation process is complete you can point to your old workspace directory and continue working with your projects created using previous JBoss Developer Studio versions, or create a new one and import old projects into the new workspace. + </para> + + <note> + <title>Note:</title> + <para>In JBDS 3.0, Linux users no longer need to install the library <filename>libstdc+.so.5</filename>. This library is no longer required and can be removed from the system. + </para> + </note> + </section> + + +</chapter>