Update netdata integration docs.

This commit is contained in:
Zhang Huangbin 2018-02-08 00:14:56 +08:00
parent b463f1fbb5
commit 0049752fe1
5 changed files with 108 additions and 24 deletions

View File

@ -4,8 +4,8 @@
!!! attention
* This tutorial is tested on FreeBSD 11.x. If you need to run netdata on
CentOS, Debian, Ubuntu, please check this tutorial instead:
* This tutorial is tested on FreeBSD 11.x. For CentOS, Debian, Ubuntu,
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
netdata. NOTE: Please replace `<password>` below by a real, strong password.
* Create new file `/usr/local/etc/nginx/netdata.users` used for basic http auth:
```
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/`
(please replace `your-server` by the real domain name).
The password looks like this `{SSHA}Tama1midwSV6XWTlonR6n6sNM8yuEPvv`.
* 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" }

View File

@ -337,13 +337,36 @@ server {
}
```
* Create new file `/etc/nginx/netdata.users` and an account used to access
netdata. NOTE: Please replace `<password>` below by a real, strong password.
* Create new file `/etc/nginx/netdata.users` used for basic http auth:
```
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/`
(please replace `your-server` by the real domain name).
The password looks like this `{SSHA}Tama1midwSV6XWTlonR6n6sNM8yuEPvv`.
* 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" }

Binary file not shown.

After

Width:  |  Height:  |  Size: 450 KiB

View File

@ -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
CentOS, Debian, Ubuntu, please check this tutorial instead:
<li>This tutorial is tested on FreeBSD 11.x. For CentOS, Debian, Ubuntu,
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
netdata. NOTE: Please replace <code>&lt;password&gt;</code> below by a real, strong password.</li>
<li>Create new file <code>/usr/local/etc/nginx/netdata.users</code> used for basic http auth:</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>
(please replace <code>your-server</code> by the real domain name).</li>
</ul><div class="footer">
<li>Run command below to generate a SSHA password hash. NOTE: Please replace
<code>&lt;password&gt;</code> below by a real, strong password.</li>
</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 -->

View File

@ -356,17 +356,36 @@ location ~ /netdata/(?&lt;ndpath&gt;.*) {
</code></pre>
<ul>
<li>Create new file <code>/etc/nginx/netdata.users</code> and an account used to access
netdata. NOTE: Please replace <code>&lt;password&gt;</code> below by a real, strong password.</li>
<li>Create new file <code>/etc/nginx/netdata.users</code> used for basic http auth:</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>
(please replace <code>your-server</code> by the real domain name).</li>
</ul><div class="footer">
<li>Run command below to generate a SSHA password hash. NOTE: Please replace
<code>&lt;password&gt;</code> below by a real, strong password.</li>
</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 -->