blob: d79c9c2b70eb5a4383a6cd7c5bc3bbbedea67c43 (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
|
# Getting started Getting started with Netdata Cloud On-Prem Light PoC
Due to the high demand we designed very light and easy to install version of netdata for clients who do not have kubernetes cluster installed. Please keep in mind that this is (for now) only designed to be used as a PoC with no built in resiliency on failures of any kind.
Requirements:
- Ubuntu 22.04 (clean installation will work best).
- 10 CPU Cores and 24 GiB of memory.
- Access to shell as a sudo.
- TLS certificate for Netdata Cloud On-Prem PoC. Single endpoint is required. Certificate must be trusted by all entities connecting to the On-Prem installation by any means.
- AWS ID and Key - contact Netdata Product Team - info@netdata.cloud
- License Key - contact Netdata Product Team - info@netdata.cloud
To install whole environment, login to designation host and run:
```shell
curl https://netdata-cloud-netdata-static-content.s3.amazonaws.com/provision.sh
chmod +x provision.sh
sudo ./provision.sh --install
```
What script with does during the installation?
1. Prompts user to provide:
- ID and KEY for accessing the AWS (to pull helm charts and container images)
- License Key
- URL under which Netdata Cloud Onprem PoC is going to function (without protocol like `https://`)
- Path for certificate file (PEM format)
- Path for private key file (PEM format)
2. After getting all of the information installation is starting. Script will install:
1. Helm
2. Kubectl
3. AWS CLI
4. K3s cluster (single node)
3. When all the required software is installed script starts to provision K3s cluster with gathered data.
After cluster provisioning netdata is ready to be used.
##### How to login?
Because this is a PoC with 0 configuration required, only login by mail is able to work. What's more every mail that Netdata Cloud On-Prem is sending will appear on mailcatcher, which acts as the SMTP server with a simple GUI to read the mails. Steps:
1. Open Netdata Cloud On-Prem PoC in the web browser on URL you specified
2. Provide email and use the button to confirm
3. Mailcatcher will catch all the emails so go to `<URL from point 1.>/mailcatcher`. Find yours and click the link.
4. You are now logged into the netdata. Add your first nodes!
##### How to remove Netdata Cloud On-Prem PoC?
To uninstall whole PoC, use the same script that installed it, with the `--uninstall` switch.
```shell
cd <script dir>
sudo ./provision.sh --uninstall
```
#### WARNING
This script will expose automatically expose not only netdata but also a mailcatcher under `<URL from point 1.>/mailcatcher`.
|
