Update netdata integration docs.

en_US/integrations/0-integration.netdata.freebsd.md

@@ -4,8 +4,8 @@
 
 !!! attention
 
-    * This tutorial is tested on FreeBSD 11.x. If you need to run netdata on
+    * This tutorial is tested on FreeBSD 11.x. For CentOS, Debian, Ubuntu,
-      CentOS, Debian, Ubuntu, please check this tutorial instead:
+      please check this tutorial instead:
       [Integrate netdata on Linux](./integration.netdata.linux.html).
     * netdata is an optional component since iRedMail-0.9.8.
 
@@ -266,13 +266,36 @@ server {
 }
 ```
 
-* Create new file `/usr/local/etc/nginx/netdata.users` and an account used to access
+* Create new file `/usr/local/etc/nginx/netdata.users` used for basic http auth:
-  netdata. NOTE: Please replace `<password>` below by a real, strong password.
 
 ```
 touch /usr/local/etc/nginx/netdata.users
+```
+
+* Run command below to generate a SSHA password hash. NOTE: Please replace
+  `<password>` below by a real, strong password.
+
+```
 doveadm pw -s SSHA -p '<password>'
 ```
 
-* Now restart nginx service and access url `https://your-server/netdata/`
+The password looks like this `{SSHA}Tama1midwSV6XWTlonR6n6sNM8yuEPvv`.
-  (please replace `your-server` by the real domain name).
+
+* Now open `/usr/local/etc/nginx/netdata.users` with your faviourite text
+  editor, add a line like below to create an account used to access netdata.
+  The format is `<username>:<password>`.
+
+```
+postmaster@domain.com:{SSHA}Tama1midwSV6XWTlonR6n6sNM8yuEPvv
+```
+
+* Restart nginx service.
+
+Now open a web browser and access url `https://your-server/netdata/` (please
+replace `your-server` by the real domain name), it will ask you to input
+username and password for authentication, please use the account we just added
+in file `/usr/local/etc/nginx/netdata.users` to login.
+
+This is what you see after successfully logged in:
+
+![](./images/netdata/system-overview.png){: width="900px" }

en_US/integrations/0-integration.netdata.linux.md

@@ -337,13 +337,36 @@ server {
 }
 ```
 
-* Create new file `/etc/nginx/netdata.users` and an account used to access
+* Create new file `/etc/nginx/netdata.users` used for basic http auth:
-  netdata. NOTE: Please replace `<password>` below by a real, strong password.
 
 ```
 touch /etc/nginx/netdata.users
+```
+
+* Run command below to generate a SSHA password hash. NOTE: Please replace
+  `<password>` below by a real, strong password.
+
+```
 doveadm pw -s SSHA -p '<password>'
 ```
 
-* Now restart nginx service and access url `https://your-server/netdata/`
+The password looks like this `{SSHA}Tama1midwSV6XWTlonR6n6sNM8yuEPvv`.
-  (please replace `your-server` by the real domain name).
+
+* Now open `/etc/nginx/netdata.users` with your faviourite text
+  editor, add a line like below to create an account used to access netdata.
+  The format is `<username>:<password>`.
+
+```
+postmaster@domain.com:{SSHA}Tama1midwSV6XWTlonR6n6sNM8yuEPvv
+```
+
+* Restart nginx service.
+
+Now open a web browser and access url `https://your-server/netdata/` (please
+replace `your-server` by the real domain name), it will ask you to input
+username and password for authentication, please use the account we just added
+in file `/etc/nginx/netdata.users` to login.
+
+This is what you see after successfully logged in:
+
+![](./images/netdata/system-overview.png){: width="900px" }

html/integration.netdata.freebsd.html

@@ -36,8 +36,8 @@
 <div class="admonition attention">
 <p class="admonition-title">Attention</p>
 <ul>
-<li>This tutorial is tested on FreeBSD 11.x. If you need to run netdata on
+<li>This tutorial is tested on FreeBSD 11.x. For CentOS, Debian, Ubuntu,
-  CentOS, Debian, Ubuntu, please check this tutorial instead:
+  please check this tutorial instead:
   <a href="./integration.netdata.linux.html">Integrate netdata on Linux</a>.</li>
 <li>netdata is an optional component since iRedMail-0.9.8.</li>
 </ul>
@@ -293,17 +293,36 @@ location ~ /netdata/(?&lt;ndpath&gt;.*) {
 </code></pre>
 
 <ul>
-<li>Create new file <code>/usr/local/etc/nginx/netdata.users</code> and an account used to access
+<li>Create new file <code>/usr/local/etc/nginx/netdata.users</code> used for basic http auth:</li>
-  netdata. NOTE: Please replace <code>&lt;password&gt;</code> below by a real, strong password.</li>
 </ul>
 <pre><code>touch /usr/local/etc/nginx/netdata.users
-doveadm pw -s SSHA -p '&lt;password&gt;'
 </code></pre>
 
 <ul>
-<li>Now restart nginx service and access url <code>https://your-server/netdata/</code>
+<li>Run command below to generate a SSHA password hash. NOTE: Please replace
-  (please replace <code>your-server</code> by the real domain name).</li>
+  <code>&lt;password&gt;</code> below by a real, strong password.</li>
-</ul><div class="footer">
+</ul>
+<pre><code>doveadm pw -s SSHA -p '&lt;password&gt;'
+</code></pre>
+
+<p>The password looks like this <code>{SSHA}Tama1midwSV6XWTlonR6n6sNM8yuEPvv</code>.</p>
+<ul>
+<li>Now open <code>/usr/local/etc/nginx/netdata.users</code> with your faviourite text
+  editor, add a line like below to create an account used to access netdata.
+  The format is <code>&lt;username&gt;:&lt;password&gt;</code>.</li>
+</ul>
+<pre><code>postmaster@domain.com:{SSHA}Tama1midwSV6XWTlonR6n6sNM8yuEPvv
+</code></pre>
+
+<ul>
+<li>Restart nginx service.</li>
+</ul>
+<p>Now open a web browser and access url <code>https://your-server/netdata/</code> (please
+replace <code>your-server</code> by the real domain name), it will ask you to input
+username and password for authentication, please use the account we just added
+in file <code>/usr/local/etc/nginx/netdata.users</code> to login.</p>
+<p>This is what you see after successfully logged in:</p>
+<p><img alt="" src="./images/netdata/system-overview.png" width="900px" /></p><div class="footer">
     <p style="text-align: center; color: grey;">All documents are available in <a href="https://bitbucket.org/zhb/iredmail-docs/src">BitBucket repository</a>, and published under <a href="http://creativecommons.org/licenses/by-nd/3.0/us/" target="_blank">Creative Commons</a> license. You can <a href="https://bitbucket.org/zhb/iredmail-docs/get/tip.tar.bz2">download the latest version</a> for offline reading. If you found something wrong, please do <a href="https://www.iredmail.org/contact.html">contact us</a> to fix it.</p>
 </div>
 <!-- Global site tag (gtag.js) - Google Analytics -->

html/integration.netdata.linux.html

@@ -356,17 +356,36 @@ location ~ /netdata/(?<ndpath>.*) {
 </code></pre>
 
 <ul>
-<li>Create new file <code>/etc/nginx/netdata.users</code> and an account used to access
+<li>Create new file <code>/etc/nginx/netdata.users</code> used for basic http auth:</li>
-  netdata. NOTE: Please replace <code>&lt;password&gt;</code> below by a real, strong password.</li>
 </ul>
 <pre><code>touch /etc/nginx/netdata.users
-doveadm pw -s SSHA -p '&lt;password&gt;'
 </code></pre>
 
 <ul>
-<li>Now restart nginx service and access url <code>https://your-server/netdata/</code>
+<li>Run command below to generate a SSHA password hash. NOTE: Please replace
-  (please replace <code>your-server</code> by the real domain name).</li>
+  <code>&lt;password&gt;</code> below by a real, strong password.</li>
-</ul><div class="footer">
+</ul>
+<pre><code>doveadm pw -s SSHA -p '&lt;password&gt;'
+</code></pre>
+
+<p>The password looks like this <code>{SSHA}Tama1midwSV6XWTlonR6n6sNM8yuEPvv</code>.</p>
+<ul>
+<li>Now open <code>/etc/nginx/netdata.users</code> with your faviourite text
+  editor, add a line like below to create an account used to access netdata.
+  The format is <code>&lt;username&gt;:&lt;password&gt;</code>.</li>
+</ul>
+<pre><code>postmaster@domain.com:{SSHA}Tama1midwSV6XWTlonR6n6sNM8yuEPvv
+</code></pre>
+
+<ul>
+<li>Restart nginx service.</li>
+</ul>
+<p>Now open a web browser and access url <code>https://your-server/netdata/</code> (please
+replace <code>your-server</code> by the real domain name), it will ask you to input
+username and password for authentication, please use the account we just added
+in file <code>/etc/nginx/netdata.users</code> to login.</p>
+<p>This is what you see after successfully logged in:</p>
+<p><img alt="" src="./images/netdata/system-overview.png" width="900px" /></p><div class="footer">
     <p style="text-align: center; color: grey;">All documents are available in <a href="https://bitbucket.org/zhb/iredmail-docs/src">BitBucket repository</a>, and published under <a href="http://creativecommons.org/licenses/by-nd/3.0/us/" target="_blank">Creative Commons</a> license. You can <a href="https://bitbucket.org/zhb/iredmail-docs/get/tip.tar.bz2">download the latest version</a> for offline reading. If you found something wrong, please do <a href="https://www.iredmail.org/contact.html">contact us</a> to fix it.</p>
 </div>
 <!-- Global site tag (gtag.js) - Google Analytics -->