You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@ofbiz.apache.org by jl...@apache.org on 2019/08/29 07:42:35 UTC
svn commit: r1866057 - in /ofbiz/tools: demo-backup/README.md
wiki-files/demos/README.md.html
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 'exit' 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>