: Getting started
Focus
Focus

Getting started

Table of Contents

Getting started

To get a VSatellite connected to your Next-Gen Trust Security account, you'll need to download and run a binary setup utility on a Linux server within your target network.

Prerequisites

Before you install a VSatellite, carefully review these important prerequisites:
  • You'll need root privileges
    You'll need permission to run commands with root privileges. The following options are available:
    • Use sudo
      If the sudo command is available on your target Linux machine, you can use it to install VSatellite.Alternative privilege elevation utilities, such as dzdo, are not supported and may result in installation failure.
    • Use a root shell
      If you are already logged in as the root user, you do not need the sudo command.In this case, you can omit sudo wherever it appears with vsatctl in the documentation.
    Why are root privileges required?The vsatctl install command installs k3s in /usr/local/bin, which is owned by the root user.
    If you are installing VSatellite on RHEL, Oracle, or Rocky Linux, the vsatctl install command installs the k3s-selinux RPM package. Installing RPM packages requires root privileges.
    Other vsatctl subcommands connect to the VSatellite cluster and require access to credentials stored in /etc/rancher/k3s/k3s.yaml. This file is accessible only to the root user.
  • If you plan to install on Red Hat Enterprise Linux (RHEL), carefully review these special considerations.
  • If you plan to use a proxy, note that TLS MITM is not supported as a proxy mechanism.
  • The target computer where you plan to install VSatellites must not have any existing Kubernetes distributions installed or running. If present, uninstall them first to avoid conflicts during the VSatellite installation.
  • Allowlist FQDNs rather than IP addresses to ensure connectivity between VSatellites and Next-Gen Trust Security. Learn more.
  • Ensure that your target machine meets all system requirements.