netdata/docs/netdata-cloud/netdata-cloud-on-prem/poc-without-k8s.md

Netdata Cloud On-Prem PoC without k8s

These instructions are about installing a light version of Netdata Cloud for clients who do not have a Kubernetes cluster installed. This setup is for demonstration purposes only, as it has no built-in resiliency on failures of any kind.

Prerequisites

• 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. A single endpoint is required. The certificate must be trusted by all entities connecting to this installation.
• AWS ID and License Key - we should have provided this to you, if not contact us: info@netdata.cloud.

To install the whole environment, log in to the designated host and run:

curl https://netdata-cloud-netdata-static-content.s3.amazonaws.com/provision.sh -o provision.sh
chmod +x provision.sh
sudo ./provision.sh install \
      -key-id "" \
      -access-key "" \
      -onprem-license-key "" \
      -onprem-license-subject "" \
      -onprem-url "" \
      -certificate-path "" \
      -private-key-path ""

The script above is responsible for:

1. Prompting the user to provide:

   • -key-id - AWS ECR access key ID.
   • -access-key - AWS ECR Access Key.
   • -onprem-license-key - Netdata Cloud On-Prem license key.
   • -onprem-license-subject - Netdata Cloud On-Prem license subject.
   • -onprem-url - URL for the On-prem (without http(s) protocol).
   • -certificate-path - path to your PEM encoded certificate.
   • -private-key-path - path to your PEM encoded key.

2. Installation will begin. The script will install:

   • Helm
   • Kubectl
   • AWS CLI
   • K3s cluster (single node)

3. The script starts to provision the K3s cluster with gathered data.

After cluster provisioning, the PoC Cloud is ready to be used.

Warning

This script will automatically expose Netdata but also a mailcatcher under <URL from point 1.>/mailcatcher.

Logging-in

Only login by mail can work without further configuration. Every mail this PoC Cloud sends will appear on the mailcatcher, which acts as the SMTP server with a simple GUI to read the mails.

1. Open PoC Cloud in the web browser on the URL you specified
2. Provide an email
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 PoC Cloud. Add your first nodes!

Uninstalling

To uninstall the whole PoC, use the same script that installed it, with the uninstall switch.

cd <script dir>
sudo ./provision.sh uninstall