taosdata
/
TDengine
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
TDengine/docs/en/04-get-started/06-enterprise.md

7.1 KiB
Raw Blame History

sidebar_label title slug
Deploy TDengine Enterprise Get Started with TDengine Enterprise /get-started/deploy-enterprise-edition

Prerequisites

  • Ensure that your servers are running Ubuntu 18.04, CentOS 7.9 or later.
  • Ensure that systemd is installed and enabled on all servers.
  • Confirm the location of all storage media that you want to use for tiered storage.
  • If you want to use S3, obtain the access key and bucket name for the desired S3 instance.
  • If you want to try TDengine Enterprise using Docker, please refer to Get Started with TDengine Using Docker or docker hub.

Prepare Your Environment

The following items are components of TDengine and are installed automatically when you deploy TDengine. By default, these all run on the same machine.

  • taosd: the TDengine server
  • taosc: the TDengine client
  • taosAdapter: the REST API for TDengine
  • taosX: the ETL engine for TDengine, supporting data ingestion and export.
  • taosKeeper: the metrics collector for TDengine
  • taosExplorer: the web interface for TDengine

You may want to install several additional components to support your deployment. These include:

  • TDgpt: the data-analysis platform and AI assistant for TDengine.
  • TDinsight: the monitoring solution for TDengine, based on Grafana.

Install TDengine

This section describes how to install TDengine Enterprise on a bare metal machine. Note that the same instructions also apply to virtual machines.

  1. Transfer the installation package for TDengine Enterprise to the target machine. The installation package is provided along with the delivery of your TDengine Enterprise license. The package name is in the format TDengine-enterprise-<version>-Linux-<arch>.tar.gz.

  2. Decompress the installation package.

    tar xf TDengine-enterprise-<version>-Linux-<arch>.tar.gz

  3. Open the directory created and run the installation script.

    cd TDengine-enterprise-<version>/
./install.sh

  4. Enter a hostname or IP address for the local machine that can be accessed by any applications required to interoperate with TDengine.

  5. Enter the FQDN of the TDengine cluster that you want the local machine to join. If the local machine is intended to be the first node in a new TDengine cluster, leave the field blank and press Enter.

  6. When prompted to enter an email address, leave the field blank and press Enter.

TDengine Enterprise has now been installed.

Important: Do not start TDengine at this time. First proceed with the configuration items below.

Configure TDengine Enterprise

Before starting TDengine, open the /etc/taos/taos.cfg file and configure the following database options:

  1. Logging: Uncomment the logDir parameter and set it to the directory where you want to store TDengine log files.

    For example:

    logDir /data/log/

  2. Tiered Storage: Uncomment the dataDir parameter and specify each mount point that you want to use in tiered storage. Include one dataDir entry for each mount point in the following format:

    dataDir <path> <tier> <primary>

    For example, the following configuration indicates that /var/lib/taos is tier 0 storage and is primary, /var/lib/taos1 is tier 1 storage, and /var/lib/taos2 is tier 2 storage.

    dataDir /var/lib/taos 0 1
dataDir /var/lib/taos1 1 0
dataDir /var/lib/taos2 2 0

    Note that each cluster can have only one primary storage device, and the primary storage device must be on tier 0.

    Then add the following parameters to the configuration file to enable S3 storage:

    s3EndPoint <your-endpoint>
s3AccessKey <secret-id>:<secret-key>
s3BucketName <your-s3-bucket>
s3UploadDelaySec 10
s3MigrateIntervalSec 600
s3MigrateEnabled 1
s3PageCacheSize 1

  3. (Optional) Modify the /etc/taos/taosadapter.toml file as follows to enable SSL on taosAdapter:

    [ssl]
enable = true
certFile = "<your-certificate.crt>"
keyFile = "<your-private-key.pem>"

    Note that the certificate and key files must be in PEM format.

  4. (Optional) If you want to configure global options for the data ingestion task runner, modify the /etc/taos/taosx.toml file accordingly.

Start TDengine

To start all TDengine components, run the start-all.sh command:

sudo ./start-all.sh

You can also start components individually:

sudo systemctl start taosd
sudo systemctl start taosadapter
sudo systemctl start taoskeeper
sudo systemctl start taosx
sudo systemctl start taos-explorer

If you want to stop TDengine, you can run the stop-all.sh command to stop all services or use systemctl stop <component-name> to stop a specified service.

Change the Root Password

When you deploy TDengine, the root user is created. The default password for this user is taosdata. For security purposes, it is recommended that you change this password.

  1. In a web browser, open the taosExplorer interface for TDengine. This interface is located on port 6060 on the hostname or IP address running TDengine.

  2. Enter root as the username and taosdata as the password and click Sign In.

  3. Hover over the T icon in the top right and click Change Password.

  4. Enter your new password. Note the following restrictions:

    1. The password must be between 8 and 16 characters, inclusive.

    2. The password must contain at least three of the following character types: uppercase letters, lowercase letters, digits, and special characters.

    3. The password cannot contain single quotation marks ('), double quotation marks ("), backticks (`), backslashes (\), or spaces.

  5. Click Save Changes.

The root password has been changed. Ensure that you keep this password secure.

Activate Your Enterprise License

  1. In a web browser, open taosExplorer and log in as a TDengine user.

  2. In the main menu on the left, click Management and open the License tab.

  3. Record the Cluster ID, located under Basic Database Parameters, and provide this value to your account manager. A license code will be generated by the TDengine team and delivered to you.

  4. Once you obtain your license code, click Activate License and enter your code.

  5. Click Confirm.

Your license has been activated and you can test enterprise features.

Monitor TDengine

The taosKeeper component collects monitoring metrics for TDengine. This component is installed and enabled automatically when you install TDengine.

To use TDinsight, a Grafana-based monitoring solution, to monitor your TDengine cluster, see Monitoring Your Cluster in the official documentation.