You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@myfaces.apache.org by bo...@apache.org on 2013/04/15 20:55:06 UTC

svn commit: r1468183 - /myfaces/site/publish/tobago/faq.html

Author: bommel
Date: Mon Apr 15 18:55:06 2013
New Revision: 1468183

URL: http://svn.apache.org/r1468183
Log:
moved liberty websphere plugin to own profile

Modified:
    myfaces/site/publish/tobago/faq.html

Modified: myfaces/site/publish/tobago/faq.html
URL: http://svn.apache.org/viewvc/myfaces/site/publish/tobago/faq.html?rev=1468183&r1=1468182&r2=1468183&view=diff
==============================================================================
--- myfaces/site/publish/tobago/faq.html (original)
+++ myfaces/site/publish/tobago/faq.html Mon Apr 15 18:55:06 2013
@@ -15,7 +15,7 @@
 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN" "http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd">
 <html xmlns="http://www.w3.org/1999/xhtml">
   <head>
-    <title>Frequently Asked Questions</title>
+    <title>Tobago - Frequently Asked Questions</title>
     <link rel="stylesheet" type="text/css" media="all" href="./css/maven-base.css"/>
     <link rel="stylesheet" type="text/css" media="all" href="./css/maven-theme.css"/>
     <link rel="stylesheet" type="text/css" media="print" href="./css/print.css"/>
@@ -121,7 +121,7 @@
           </li>
               
     <li class="none">
-                    <a href="migration-1.6.html">Migration to 1.6 (beta)</a>
+                    <a href="migration-2.0.html">Migration to 2.0 (alpha)</a>
           </li>
               
     <li class="none">
@@ -241,7 +241,7 @@
       </a></li><li><a href="#tobagoRI">Does Tobago run with the Sun reference implementation (RI)?</a></li><li><a href="#tobagofacelets">Does Tobago supports Facelets?</a></li><li><a href="#tobagomyfaces_extension">Can I mix Tobago and MyFaces extensions in the same web application?
       </a></li><li><a href="#tobagolayout">How do I use GridLayout in Tobago?</a></li><li><a href="#tobagofileupload">How do I configure file upload in Tobago?</a></li><li><a href="#tobagoform">Do I need a form tag in a normal Tobago page?</a></li><li><a href="#tobagobrowser">Which web browsers are currently supported by Tobago?</a></li><li><a href="#tobagoowntheme">How do I create my own theme?</a></li><li><a href="#tobagocustommarkup">How do I use and extend the markup attribute?</a></li><li><a href="#tobagocontainer">In which containers was Tobago tested?</a></li><li><a href="#tilessitemesh">Can Tobago replace Tiles? Can I ignore Tiles and Sitemesh in
         favor of Tobago?
-      </a></li><li><a href="#maven-mirror">How to configure a maven mirror?</a></li><li><a href="#offline-build">How do I configure an offline build?</a></li><li><a href="#checkstyle">How do I perform a local checkstyle check?</a></li><li><a href="#max-path">Why my Subversion checkout fails on Windows?</a></li><li><a href="#selenium">How can I run the Selenium tests?</a></li></ol></div><dl><dt><a name="howto">Where can I find documentation or HowTos for using Tobago?</a></dt><dd>
+      </a></li><li><a href="#maven-mirror">How to configure a maven mirror?</a></li><li><a href="#offline-build">How do I configure an offline build?</a></li><li><a href="#checkstyle">How do I perform a local checkstyle check?</a></li><li><a href="#max-path">Why my Subversion checkout fails on Windows?</a></li><li><a href="#selenium">How can I run the Selenium tests?</a></li><li><a href="#liberty">How can I run the Tobago demo with WebSphere Liberty Profile (WLP) from Maven?</a></li></ol></div><dl><dt><a name="howto">Where can I find documentation or HowTos for using Tobago?</a></dt><dd>
         <p>
           Please, see
        </p>
@@ -453,6 +453,90 @@ mvn selenium:start-server</pre></div>
           Sometimes there is a problem with Firefox. You may try to use a different version, or an installation without
           plugins.
        </p>
+      <p align="right"><a href="#top">[top]</a></p><hr /></dd><dt><a name="liberty">How can I run the Tobago demo with WebSphere Liberty Profile (WLP) from Maven?</a></dt><dd>
+        <p>
+          <b>Please use at least Tobago 2.0 for this guidance (in this version the pom.xml files are prepared).</b>
+       </p>
+        <p>
+          You will need to do the following steps for preparation:
+       </p>
+        <ul>
+          <li>Download the server like:
+            <div class="source"><pre>wlp-developers-runtime-8.5.next.beta.jar</pre></div>
+            from
+            <a class="externalLink" href="https://www.ibm.com/developerworks/mydeveloperworks/blogs/wasdev/entry/download?lang=en">IBM</a>
+            (Todo: check if this is the correct version)
+         </li>
+          <li>
+            Unpack the server anywhere in you file system, e.g. like this
+            <div class="source"><pre>mkdir /opt/wlp-developers-runtime-8.5.next.beta
+cd /opt/wlp-developers-runtime-8.5.next.beta
+java -jar ~/Downloads/wlp-developers-runtime-8.5.next.beta.jar
+           </pre></div>
+         </li>
+          <li>
+            Adding some features to the wlp/templates/servers/defaultServer/server.xml
+            <div class="source"><pre>&lt;feature&gt;cdi-1.0&lt;/feature&gt;
+&lt;feature&gt;servlet-3.0&lt;/feature&gt;
+&lt;feature&gt;jsf-2.0&lt;/feature&gt;</pre></div>
+         </li>
+          <li>
+            Adding your server home to a property in the settings.xml of Maven
+            <div class="source"><pre>&lt;wlp.directory&gt;/opt/wlp-developers-runtime-8.5.next.beta&lt;/wlp.directory&gt;</pre></div>
+         </li>
+       </ul>
+        <p>
+          After these steps you can start/stop the server and deploy an built artifact.
+          For these steps, you need to be in a Tobago example directory.
+          </p><div class="source"><pre>cd tobago-examples/tobago-example-demo</pre></div>
+       
+        <ul>
+          <li>
+            Start the server
+            <div class="source"><pre>mvn -Pliberty liberty:start-server</pre></div>
+         </li>
+          <li>
+            Build an artifact (you need the &quot;provided&quot; property, because JSF and OWB comes from the server)
+            <div class="source"><pre>mvn package -Djsf=provided</pre></div>
+         </li>
+          <li>
+            Deploy an artifact
+            <div class="source"><pre>mvn -Pliberty liberty:deploy</pre></div>
+         </li>
+          <li>
+            You will find the web application under this URL
+            <div class="source"><pre>http://localhost:9080/tobago-example-demo/</pre></div>
+         </li>
+          <li>
+            Redeploy an artifact: The same as deploy.
+         </li>
+          <li>
+            Stop the server
+            <div class="source"><pre>mvn -Pliberty liberty:stop-server</pre></div>
+         </li>
+       </ul>
+        <p>
+          The server starts very fast and is simple to use (very different from the full WebSphere installation).
+          The log files you will find here:
+          </p><div class="source"><pre>cd /opt/wlp-developers-8.5.next.beta/wlp/usr/servers/tobago/logs/</pre></div>
+          Sometime you may need to the clean the server, in particular when you are changing JAR dependencies.
+          For doing that
+       
+        <ul>
+          <li>
+            Stop the server
+         </li>
+          <li>
+            Remove the whole concrete server installation
+            <div class="source"><pre>rm -r /opt/wlp-developers-8.5.next.beta/wlp/usr/servers/tobago</pre></div>
+         </li>
+          <li>
+            Start the server
+         </li>
+          <li>
+            Deploy again
+         </li>
+       </ul>
       <p align="right"><a href="#top">[top]</a></p></dd></dl>
       </div>
     </div>