From 356bfc38d5d16b4b2ea7a2658c8c5f4c8a062352 Mon Sep 17 00:00:00 2001 From: Scott Anderson Date: Fri, 6 Jun 2025 07:16:54 -0600 Subject: [PATCH] WIP restructuring monolith getting started --- content/influxdb3/core/get-started/setup.md | 20 +++ .../enterprise/get-started/multi-server.md | 4 +- .../influxdb3/enterprise/get-started/setup.md | 20 +++ .../shared/influxdb3-get-started/_index.md | 17 ++- content/shared/influxdb3-get-started/setup.md | 123 +++++------------- 5 files changed, 87 insertions(+), 97 deletions(-) create mode 100644 content/influxdb3/core/get-started/setup.md create mode 100644 content/influxdb3/enterprise/get-started/setup.md diff --git a/content/influxdb3/core/get-started/setup.md b/content/influxdb3/core/get-started/setup.md new file mode 100644 index 000000000..8c39838ce --- /dev/null +++ b/content/influxdb3/core/get-started/setup.md @@ -0,0 +1,20 @@ +--- +title: Set up InfluxDB 3 Core +description: > + .... +menu: + influxdb3_core: + name: Set up Core + parent: Get started +weight: 3 +related: + - /influxdb3/core/install/ + - /influxdb3/core/admin/tokens/ + - /influxdb3/core/reference/config-options/ +source: /shared/influxdb3-get-started/setup.md +--- + + diff --git a/content/influxdb3/enterprise/get-started/multi-server.md b/content/influxdb3/enterprise/get-started/multi-server.md index 42ca6ef0b..62061aaaf 100644 --- a/content/influxdb3/enterprise/get-started/multi-server.md +++ b/content/influxdb3/enterprise/get-started/multi-server.md @@ -3,8 +3,8 @@ title: Use a multi-server setup seotitle: Use a multi-server InfluxDB 3 Enterprise setup menu: influxdb3_enterprise: - - name: Multi-server - - parent: Get started + name: Multi-server + parent: Get started weight: 4 influxdb3/enterprise/tags: [cluster, multi-node, multi-server] --- diff --git a/content/influxdb3/enterprise/get-started/setup.md b/content/influxdb3/enterprise/get-started/setup.md new file mode 100644 index 000000000..6a4469bb0 --- /dev/null +++ b/content/influxdb3/enterprise/get-started/setup.md @@ -0,0 +1,20 @@ +--- +title: Set up InfluxDB 3 Enterprise +description: > + .... +menu: + influxdb3_enterprise: + name: Set up Enterprise + parent: Get started +weight: 3 +related: + - /influxdb3/enterprise/install/ + - /influxdb3/enterprise/admin/tokens/ + - /influxdb3/enterprise/reference/config-options/ +source: /shared/influxdb3-get-started/setup.md +--- + + diff --git a/content/shared/influxdb3-get-started/_index.md b/content/shared/influxdb3-get-started/_index.md index 4190eb78e..ace43721e 100644 --- a/content/shared/influxdb3-get-started/_index.md +++ b/content/shared/influxdb3-get-started/_index.md @@ -66,10 +66,19 @@ This tutorial covers many of the recommended tools. {{< /caption >}} +{{< show-in "core" >}} +{{< page-nav next="/influxdb3/core/get-started/setup/" nextText="Set up InfluxDB 3 Core" >}} +{{< /show-in >}} +{{< show-in "enterprise" >}} +{{< page-nav next="/influxdb3/enterprise/get-started/setup/" nextText="Set up InfluxDB 3 Enterprise" >}} +{{< /show-in >}} - - + + diff --git a/content/shared/influxdb3-get-started/setup.md b/content/shared/influxdb3-get-started/setup.md index 9d857e51a..43b9d2bb0 100644 --- a/content/shared/influxdb3-get-started/setup.md +++ b/content/shared/influxdb3-get-started/setup.md @@ -1,25 +1,22 @@ -### Install and startup +## Install {{% product-name %}} {{% product-name %}} runs on **Linux**, **macOS**, and **Windows**. - -{{% show-in "enterprise" %}} -{{% tabs-wrapper %}} -{{% tabs %}} -[Linux or macOS](#linux-or-macos) -[Windows](#windows) -[Docker](#docker) -{{% /tabs %}} -{{% tab-content %}} - -To get started quickly, download and run the install script--for example, using [curl](https://curl.se/download.html): +If using **Linux** or **macOS**, you can download and use the {{% product-name %}} +quick installer using [curl](https://curl.se/download.html): ```bash curl -O https://www.influxdata.com/d/install_influxdb3.sh \ -&& sh install_influxdb3.sh enterprise +&& sh install_influxdb3.sh {{% show-in "enterprise" %}}enterprise{{% /show-in %}} ``` -Or, download and install [build artifacts](/influxdb3/enterprise/install/#download-influxdb-3-enterprise-binaries): +For detailed installation instructions, including for Windows and Docker, +see [Install {{% product-name %}}](/influxdb3/version/install/). + +You can also download and install [{{% product-name %}} build artifacts](/influxdb3/enterprise/install/#download-influxdb-3-enterprise-binaries) directly: + +{{< expand-wrapper >}} +{{% expand "Linux binaries" %}} - [Linux | AMD64 (x86_64) | GNU](https://dl.influxdata.com/influxdb/releases/influxdb3-{{< product-key >}}-{{< latest-patch >}}_linux_amd64.tar.gz) • @@ -27,6 +24,10 @@ Or, download and install [build artifacts](/influxdb3/enterprise/install/#downlo - [Linux | ARM64 (AArch64) | GNU](https://dl.influxdata.com/influxdb/releases/influxdb3-{{< product-key >}}-{{< latest-patch >}}_linux_arm64.tar.gz) • [sha256](https://dl.influxdata.com/influxdb/releases/influxdb3-{{< product-key >}}-{{< latest-patch >}}_linux_arm64.tar.gz.sha256) + +{{% /expand %}} +{{% expand "macOS binaries" %}} + - [macOS | Silicon (ARM64)](https://dl.influxdata.com/influxdb/releases/influxdb3-{{< product-key >}}-{{< latest-patch >}}_darwin_arm64.tar.gz) • [sha256](https://dl.influxdata.com/influxdb/releases/influxdb3-{{< product-key >}}-{{< latest-patch >}}_darwin_arm64.tar.gz.sha256) @@ -34,17 +35,15 @@ Or, download and install [build artifacts](/influxdb3/enterprise/install/#downlo > [!Note] > macOS Intel builds are coming soon. - -{{% /tab-content %}} -{{% tab-content %}} - -Download and install the {{% product-name %}} [Windows (AMD64, x86_64) binary](https://dl.influxdata.com/influxdb/releases/influxdb3-{{< product-key >}}-{{< latest-patch >}}-windows_amd64.zip) +{{% /expand %}} +{{% expand "Windows binaries" %}} + +- [Windows (AMD64, x86_64) binary](https://dl.influxdata.com/influxdb/releases/influxdb3-{{< product-key >}}-{{< latest-patch >}}-windows_amd64.zip) • [sha256](https://dl.influxdata.com/influxdb/releases/influxdb3-{{< product-key >}}-{{< latest-patch >}}-windows_amd64.zip.sha256) - -{{% /tab-content %}} -{{% tab-content %}} - + +{{% /expand %}} +{{% expand "Docker image" %}} The [`influxdb:3-enterprise` image](https://hub.docker.com/_/influxdb/tags?tag=3-core&name=3-enterprise) is available for x86_64 (AMD64) and ARM64 architectures. @@ -55,74 +54,13 @@ Pull the image: ```bash docker pull influxdb:3-enterprise ``` +{{% /expand %}} +{{< /expand-wrapper >}} - -{{% /tab-content %}} -{{% /tabs-wrapper %}} -{{% /show-in %}} +### Verify the installation -{{% show-in "core" %}} -{{% tabs-wrapper %}} -{{% tabs %}} -[Linux or macOS](#linux-or-macos) -[Windows](#windows) -[Docker](#docker) -{{% /tabs %}} -{{% tab-content %}} - -To get started quickly, download and run the install script--for example, using [curl](https://curl.se/download.html): - - -```bash -curl -O https://www.influxdata.com/d/install_influxdb3.sh \ -&& sh install_influxdb3.sh -``` -Or, download and install [build artifacts](/influxdb3/core/install/#download-influxdb-3-core-binaries): - -- [Linux | AMD64 (x86_64) | GNU](https://dl.influxdata.com/influxdb/releases/influxdb3-{{< product-key >}}-{{< latest-patch >}}_linux_amd64.tar.gz) - • - [sha256](https://dl.influxdata.com/influxdb/releases/influxdb3-{{< product-key >}}-{{< latest-patch >}}_linux_amd64.tar.gz.sha256) -- [Linux | ARM64 (AArch64) | GNU](https://dl.influxdata.com/influxdb/releases/influxdb3-{{< product-key >}}-{{< latest-patch >}}_linux_arm64.tar.gz) - • - [sha256](https://dl.influxdata.com/influxdb/releases/influxdb3-{{< product-key >}}-{{< latest-patch >}}_linux_arm64.tar.gz.sha256) -- [macOS | Silicon (ARM64)](https://dl.influxdata.com/influxdb/releases/influxdb3-{{< product-key >}}-{{< latest-patch >}}_darwin_arm64.tar.gz) - • - [sha256](https://dl.influxdata.com/influxdb/releases/influxdb3-{{< product-key >}}-{{< latest-patch >}}_darwin_arm64.tar.gz.sha256) - -> [!Note] -> macOS Intel builds are coming soon. - - -{{% /tab-content %}} -{{% tab-content %}} - -Download and install the {{% product-name %}} [Windows (AMD64, x86_64) binary](https://dl.influxdata.com/influxdb/releases/influxdb3-{{< product-key >}}-{{< latest-patch >}}-windows_amd64.zip) - • -[sha256](https://dl.influxdata.com/influxdb/releases/influxdb3-{{< product-key >}}-{{< latest-patch >}}-windows_amd64.zip.sha256) - -{{% /tab-content %}} -{{% tab-content %}} - -The [`influxdb:3-core` image](https://hub.docker.com/_/influxdb/tags?tag=3-core&name=3-core) -is available for x86_64 (AMD64) and ARM64 architectures. - -Pull the image: - - -```bash -docker pull influxdb:3-core -``` - - -{{% /tab-content %}} -{{% /tabs-wrapper %}} -{{% /show-in %}} - -_Build artifacts and images update with every merge into the {{% product-name %}} `main` branch._ - -#### Verify the install - -After you have installed {{% product-name %}}, enter the following command to verify that it completed successfully: +After installing {{% product-name %}}, enter the following command to verify +that it installed successfully: ```bash influxdb3 --version @@ -135,10 +73,11 @@ If your system doesn't locate `influxdb3`, then `source` the configuration file source ~/.zshrc ``` +## Start InfluxDB -#### Start InfluxDB - -To start your InfluxDB instance, use the `influxdb3 serve` command and provide the following: +Use the [`influxdb3 serve` command](/influxdb3/version/reference/cli/influxdb3/serve/) +to start {{% product-name %}}. +Provide the following: - `--object-store`: Specifies the type of object store to use. InfluxDB supports the following: local file system (`file`), `memory`,