svn commit: r1866057 - in /ofbiz/tools: demo-backup/README.md wiki-files/demos/README.md.html

Previous Topic Next Topic
 
classic Classic list List threaded Threaded
1 message Options
Reply | Threaded
Open this post in threaded view
|

svn commit: r1866057 - in /ofbiz/tools: demo-backup/README.md wiki-files/demos/README.md.html

jleroux@apache.org
Author: jleroux
Date: Thu Aug 29 07:42:34 2019
New Revision: 1866057

URL: http://svn.apache.org/viewvc?rev=1866057&view=rev
Log:
Updates demos documentation

Modified:
    ofbiz/tools/demo-backup/README.md
    ofbiz/tools/wiki-files/demos/README.md.html

Modified: ofbiz/tools/demo-backup/README.md
URL: http://svn.apache.org/viewvc/ofbiz/tools/demo-backup/README.md?rev=1866057&r1=1866056&r2=1866057&view=diff
==============================================================================
--- ofbiz/tools/demo-backup/README.md (original)
+++ ofbiz/tools/demo-backup/README.md Thu Aug 29 07:42:34 2019
@@ -1,3 +1,4 @@
+# General description
 Three instances of OFBiz run on the OFBiz demo VM3 at https://ofbiz-vm3.apache.org.
 
 * trunk: the trunk version
@@ -18,6 +19,8 @@ https://github.com/apache/infrastructure
 It's currently impossible to directly modify, it's a private Github repo.
 Just create an Infra Jira asking for the wanted change...and be patient ;)
 
+# Actions on demos
+SSH to *ofbiz-vm3.apache.org* server (a VM actualy), then follow the below procedure.
 
 >_Note_: **Only run the ofbiz demos using the 'ofbizDemo' user, never run as root.**
     
@@ -25,9 +28,9 @@ Just create an Infra Jira asking for the
 
     sudo -s -u ofbizDemo -H
 
-    sudo uses OTP*
-    
-    OTP for (One Time Password). You not only need to be registered as a sudoer (ask Infra) but also to use a tool like https://reference.apache.org/committer/otp-md5 to generate the OTP
+    sudo uses OTP (One Time Password).
+    You need to be registered as a sudoer (ask Infra).
+    Then to use a tool like https://reference.apache.org/committer/otp-md5 to generate the OTP
     Then you can start/stop as required.
 
     To check if the demos are being run as the ofbizDemo user:
@@ -39,14 +42,16 @@ Just create an Infra Jira asking for the
 
     Type 'exit' to exit the ofbizDemo user and return to your username.
 
-Also note that the demos are usually updated and started/stopped automatically using the check-svn-update.sh script in this directory, it is run by an ofbizDemo cron job every 24 hours at 3 AM. You should therefore only need to start/stop manually if there is a problem.
+Also note that the demos are usually updated and started/stopped automatically using the check-svn-update.sh script in this directory. It is run by an ofbizDemo cron job every 24 hours at 3 AM. You should therefore only need to start/stop manually if there is a problem.
 
+# Current restriction
 ~~If you want to restart only a single instance you can respectively use
 trunk-manual-nicely.sh
 stable-manual-nicely.sh
 old-manual-nicely.sh~~
-This does not work (at least for instances using Gradle. So currently R13.07 is not affected you can use old-manual.sh).
-See why at https://issues.apache.org/jira/browse/OFBIZ-10287
-So you need to use trunk-manual-nicely.sh for now and restart all instances even if only one is changed.
+This does not work, at least for instances using Gradle (currently trunk and stable, ie R16).
+See why at https://issues.apache.org/jira/browse/OFBIZ-10287 
+Hence currently R13.07 is not affected you can use *old-manual-nicely.sh* when only the old demo has issues.
+And you need for now to use *all-manual-nicely.sh* when trunk or/and stable are affected.
 
 

Modified: ofbiz/tools/wiki-files/demos/README.md.html
URL: http://svn.apache.org/viewvc/ofbiz/tools/wiki-files/demos/README.md.html?rev=1866057&r1=1866056&r2=1866057&view=diff
==============================================================================
--- ofbiz/tools/wiki-files/demos/README.md.html (original)
+++ ofbiz/tools/wiki-files/demos/README.md.html Thu Aug 29 07:42:34 2019
@@ -16,6 +16,7 @@
   <![endif]-->
 </head>
 <body>
+<h1 id="general-description">General description</h1>
 <p>Three instances of OFBiz run on the OFBiz demo VM3 at https://ofbiz-vm3.apache.org.</p>
 <ul>
 <li>trunk: the trunk version</li>
@@ -30,6 +31,8 @@
 <li>https://demo-old.ofbiz.apache.org</li>
 </ul>
 <p>The Puppet configuration is at https://github.com/apache/infrastructure-p6/blob/production/data/nodes/ofbiz-vm3.apache.org.yaml It’s currently impossible to directly modify, it’s a private Github repo. Just create an Infra Jira asking for the wanted change…and be patient ;)</p>
+<h1 id="actions-on-demos">Actions on demos</h1>
+<p>SSH to <em>ofbiz-vm3.apache.org</em> server (a VM actualy), then follow the below procedure.</p>
 <blockquote>
 <p><em>Note</em>: <strong>Only run the ofbiz demos using the ‘ofbizDemo’ user, never run as root.</strong></p>
 </blockquote>
@@ -37,9 +40,9 @@
 
 sudo -s -u ofbizDemo -H
 
-sudo uses OTP*
-
-OTP for (One Time Password). You not only need to be registered as a sudoer (ask Infra) but also to use a tool like https://reference.apache.org/committer/otp-md5 to generate the OTP
+sudo uses OTP (One Time Password).
+You need to be registered as a sudoer (ask Infra).
+Then to use a tool like https://reference.apache.org/committer/otp-md5 to generate the OTP
 Then you can start/stop as required.
 
 To check if the demos are being run as the ofbizDemo user:
@@ -50,7 +53,8 @@ The first column on the left tell you th
 being run as - it should say ofbizDemo (UID).
 
 Type &#39;exit&#39; to exit the ofbizDemo user and return to your username.</code></pre>
-<p>Also note that the demos are usually updated and started/stopped automatically using the check-svn-update.sh script in this directory, it is run by an ofbizDemo cron job every 24 hours at 3 AM. You should therefore only need to start/stop manually if there is a problem.</p>
-<p><del>If you want to restart only a single instance you can respectively use trunk-manual-nicely.sh stable-manual-nicely.sh old-manual-nicely.sh</del> This does not work (at least for instances using Gradle. So currently R13.07 is not affected you can use old-manual.sh). See why at https://issues.apache.org/jira/browse/OFBIZ-10287 So you need to use trunk-manual-nicely.sh for now and restart all instances even if only one is changed.</p>
+<p>Also note that the demos are usually updated and started/stopped automatically using the check-svn-update.sh script in this directory. It is run by an ofbizDemo cron job every 24 hours at 3 AM. You should therefore only need to start/stop manually if there is a problem.</p>
+<h1 id="current-restriction">Current restriction</h1>
+<p><del>If you want to restart only a single instance you can respectively use trunk-manual-nicely.sh stable-manual-nicely.sh old-manual-nicely.sh</del> This does not work, at least for instances using Gradle (currently trunk and stable, ie R16). See why at https://issues.apache.org/jira/browse/OFBIZ-10287 Hence currently R13.07 is not affected you can use <em>old-manual-nicely.sh</em> when only the old demo has issues. And you need for now to use <em>all-manual-nicely.sh</em> when trunk or/and stable are affected.</p>
 </body>
 </html>