From bbed5a736a4648f5f6cfc2cd2da5cf734a7f8e97 Mon Sep 17 00:00:00 2001 From: Scott Anderson Date: Wed, 23 Jan 2019 16:38:25 -0700 Subject: [PATCH 1/2] restructed the getting started page, resolves #29 --- content/v2.0/get-started/_index.md | 205 +++++++++++++++++++++++++++- content/v2.0/get-started/install.md | 28 ---- content/v2.0/get-started/setup.md | 76 ----------- 3 files changed, 202 insertions(+), 107 deletions(-) delete mode 100644 content/v2.0/get-started/install.md delete mode 100644 content/v2.0/get-started/setup.md diff --git a/content/v2.0/get-started/_index.md b/content/v2.0/get-started/_index.md index 8605d9afd..15b1904b1 100644 --- a/content/v2.0/get-started/_index.md +++ b/content/v2.0/get-started/_index.md @@ -1,12 +1,211 @@ --- title: Get started with InfluxDB -description: Simple steps for downloading, installing, and setting up InfluxDB. +description: Download, install, and setup InfluxDB, creating a default organization, user, and bucket. menu: v2_0: name: Get started weight: 1 --- -The following guide you through downloading, installing, and setting up InfluxDB. +Get started with InfluxDB v2.0 by downloading InfluxDB, installing the necessary +executables, and running the the initial setup process. -{{< children >}} +{{< tabs-wrapper >}} +{{% tabs %}} +[macOS](#) +[Linux](#) +[Docker](#) +{{% /tabs %}} + + +{{% tab-content %}} +### Download and install InfluxDB v2.0 alpha +Download InfluxDB v2.0 alpha for macOS. + +InfluxDB v2.0 alpha (macOS) + +### Place the executables in your $PATH +Unzip the download package and place the `influx` and `influxd` executables in your system `$PATH`. + +```sh +# Example +cp ~/Downloads/influxdb_2.0.0-alpha.1_darwin_amd64/{influx,influxd} /usr/local/bin/ +``` + +### Networking ports +By default, InfluxDB uses TCP port `9999` for client-server communication over InfluxDB’s HTTP API. + +## Start InfluxDB +Start InfluxDB by running the `influxd` daemon: + +```bash +influxd +``` + +_See the [`influxd` documentation](/v2.0/reference/cli/influxd) for information about +available flags and options._ + +{{% note %}} +#### InfluxDB "phone home" +By default, InfluxDB sends telemetry data back to InfluxData. +The [InfluxData telemetry](https://www.influxdata.com/telemetry) page provides +information about what data is collected and how it is used. + +Top opt-out of sending telemetry data back to InfluxData, include the +`--reporting-disabled` flag when starting `influxd`. + +```bash +influxd --reporting-disabled +``` +{{% /note %}} + +{{% /tab-content %}} + + + +{{% tab-content %}} +### Download and install InfluxDB v2.0 alpha +Download InfluxDB v2.0 alpha package appropriate for your chipset. + +InfluxDB v2.0 alpha (amd64) +InfluxDB v2.0 alpha (arm) + +### Place the executables in your $PATH +Unzip the download package and place the `influx` and `influxd` executables in your system `$PATH`. + +```sh +# Example +cp /path/to/{influx,influxd} /usr/local/bin/ +``` + +### Networking ports +By default, InfluxDB uses TCP port `9999` for client-server communication over InfluxDB’s HTTP API. + +## Start InfluxDB +Start InfluxDB by running the `influxd` daemon: + +```bash +influxd +``` + +_See the [`influxd` documentation](/v2.0/reference/cli/influxd) for information about +available flags and options._ + +{{% note %}} +#### InfluxDB "phone home" +By default, InfluxDB sends telemetry data back to InfluxData. +The [InfluxData telemetry](https://www.influxdata.com/telemetry) page provides +information about what data is collected and how it is used. + +Top opt-out of sending telemetry data back to InfluxData, include the +`--reporting-disabled` flag when starting `influxd`. + +```bash +influxd --reporting-disabled +``` +{{% /note %}} + +{{% /tab-content %}} + + + +{{% tab-content %}} +### Download and run InfluxDB v2.0 alpha +Use `docker run` to download and run the InfluxDB v2.0 alpha Docker image. +Expose port `9999`, which InfluxDB uses for client-server communication over its HTTP API. + +```sh +docker run --name influxdb -p 9999:9999 quay.io/influxdb/influxdb:2.0.0-alpha +``` + +{{% note %}} +#### InfluxDB "phone home" +By default, InfluxDB sends telemetry data back to InfluxData. +The [InfluxData telemetry](https://www.influxdata.com/telemetry) page provides +information about what data is collected and how it is used. + +Top opt-out of sending telemetry data back to InfluxData, include the +`--reporting-disabled` flag when starting the InfluxDB container. + +```bash +docker run -it -p 9999:9999 quay.io/influxdb/influxdb:2.0.0-alpha --reporting-disabled +``` +{{% /note %}} + +### Console into the InfluxDB Container (Optional) +To use the `influx` command line interface console into the `influxdb` Docker container: + +```bash +docker exec -it influxdb /bin/bash +``` + +{{% /tab-content %}} + + +{{< /tabs-wrapper >}} + +## Setup InfluxDB +The initial setup process for InfluxDB walks through creating a default organization, +user, and bucket. +The setup process is available in both the InfluxDB user interface (UI) and in +the `influx` command line interface (CLI). + +{{< tabs-wrapper >}} +{{% tabs %}} +[UI Setup](#) +[CLI Setup](#) +{{% /tabs %}} + + +{{% tab-content %}} +### Set up InfluxDB through the UI + +1. With `influxd` running, visit [localhost:9999](http://localhost:9999). +2. Click **Get Started** + +#### Set up your initial user + +1. Enter a **Username** for your initial user. +2. Enter a **Password** and **Confirm Password** for your user. +3. Enter your initial **Organization Name**. +4. Enter your initial **Bucket Name**. +5. Click **Continue**. + +InfluxDB is now initialized with a primary user, organization, and bucket. +You are ready to [collect data](/v2.0/collect-data). + +{{% /tab-content %}} + + + +{{% tab-content %}} +### Set up InfluxDB through the influx CLI +Begin the InfluxDB setup process via the `influx` CLI by running: + +```bash +influx setup +``` + +1. Enter a **primary username**. +2. Enter a **password** for your user. +3. **Confirm your password** by entering it again. +4. Enter a name for your **primary organization**. +5. Enter a name for your **primary bucket**. +6. Enter a **retention period** (in hours) for your primary bucket. + Enter nothing for an infinite retention period. +7. Confirm the details for your primary user, organization, and bucket. + +InfluxDB is now initialized with a primary user, organization, and bucket. +You are ready to [collect data](/v2.0/collect-data). + +{{% /tab-content %}} + +{{< /tabs-wrapper >}} + +{{% note %}} +### Bug Reports and Feedback +Thank you for being willing to help test InfluxDB v2.0 alpha! +Feedback and bug reports are welcome and encouraged both for InfluxDB and this documentation. + +[Submit feedback in the InfluxData Community](https://community.influxdata.com/c/influxdb2) +{{% /note %}} diff --git a/content/v2.0/get-started/install.md b/content/v2.0/get-started/install.md deleted file mode 100644 index 209372bc3..000000000 --- a/content/v2.0/get-started/install.md +++ /dev/null @@ -1,28 +0,0 @@ ---- -title: Install InfluxDB v2.0 -seotitle: Download and install InfluxDB v2.0 -description: > - Visit the InfluxData downloads page to download InfluxDB v2.0. - Add the influx and influxd binaries to your system $PATH. -menu: - v2_0: - name: Install InfluxDB - parent: Get started - weight: 1 ---- - -### Download InfluxDB v2.0 -Visit [InfluxData Downloads page](https://portal.influxdata.com/downloads/) and -download the InfluxDB v2.0 package appropriate for your operating system. - -Download InfluxDB - -### Place the executables in your $PATH -Place the `influx` and `influxd` executables in your system `$PATH`. - -### Networking ports -By default, InfluxDB uses TCP port `9999` for client-server communication over InfluxDB’s HTTP API. - - diff --git a/content/v2.0/get-started/setup.md b/content/v2.0/get-started/setup.md deleted file mode 100644 index 1ff10c5b9..000000000 --- a/content/v2.0/get-started/setup.md +++ /dev/null @@ -1,76 +0,0 @@ ---- -title: Set up InfluxDB -seotitle: Run the initial InfluxDB setup process -description: The initial setup process for walks through creating a default organization, user, and bucket. -menu: - v2_0: - name: Set up InfluxDB - parent: Get started - weight: 2 ---- - -The initial setup process for InfluxDB walks through creating a default organization, -user, and bucket. -The setup process is available in both the InfluxDB user interface (UI) and in -the `influx` command line interface (CLI). - -## Start the influxd daemon -In order to setup InfluxDB via the UI or the CLI, first start the `influxd` daemon by running: - -```bash -influxd -``` - -_See the [`influxd` documentation](/v2.0/reference/cli/influxd) for information about -available flags and options._ - -{{% note %}} -#### InfluxDB "phone-home" -By default, InfluxDB sends telemetry data back to InfluxData. -The [InfluxData telemetry](https://www.influxdata.com/telemetry) page provides -information about what data is collected and how it is used. - -Top opt-out of sending telemetry data back to InfluxData, include the -`--reporting-disabled` flag when starting `influxd`. - -```bash -influxd --reporting-disabled -``` -{{% /note %}} - - -## Set up InfluxDB through the UI - -1. With `influxd` running, visit [localhost:9999](http://localhost:9999). -2. Click **Get Started** - -### Set up your initial user - -1. Enter a **Username** for your initial user. -2. Enter a **Password** and **Confirm Password** for your user. -3. Enter your initial **Organization Name**. -4. Enter your initial **Bucket Name**. -5. Click **Continue**. - -InfluxDB is now initialized with a primary user, organization, and bucket. -You are ready to [collect data](#). - - -## Set up InfluxDB through the influx CLI -Begin the InfluxDB setup process via the `influx` CLI by running: - -```bash -influx setup -``` - -1. Enter a **primary username**. -2. Enter a **password** for your user. -3. **Confirm your password** by entering it again. -4. Enter a name for your **primary organization**. -5. Enter a name for your **primary bucket**. -6. Enter a **retention period** (in hours) for your primary bucket. - Enter nothing for an infinite retention period. -7. Confirm the details for your primary user, organization, and bucket. - -InfluxDB is now initialized with a primary user, organization, and bucket. -You are ready to [collect data](#). From 50884fcc713f47eb470e7268e21fec12d0eb4fab Mon Sep 17 00:00:00 2001 From: Scott Anderson Date: Wed, 23 Jan 2019 16:50:34 -0700 Subject: [PATCH 2/2] minor updates to the get started doc --- content/v2.0/{get-started/_index.md => _get-started.md} | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) rename content/v2.0/{get-started/_index.md => _get-started.md} (96%) diff --git a/content/v2.0/get-started/_index.md b/content/v2.0/_get-started.md similarity index 96% rename from content/v2.0/get-started/_index.md rename to content/v2.0/_get-started.md index 15b1904b1..e46cb70b3 100644 --- a/content/v2.0/get-started/_index.md +++ b/content/v2.0/_get-started.md @@ -128,12 +128,12 @@ Top opt-out of sending telemetry data back to InfluxData, include the `--reporting-disabled` flag when starting the InfluxDB container. ```bash -docker run -it -p 9999:9999 quay.io/influxdb/influxdb:2.0.0-alpha --reporting-disabled +docker run -p 9999:9999 quay.io/influxdb/influxdb:2.0.0-alpha --reporting-disabled ``` {{% /note %}} ### Console into the InfluxDB Container (Optional) -To use the `influx` command line interface console into the `influxdb` Docker container: +To use the `influx` command line interface, console into the `influxdb` Docker container: ```bash docker exec -it influxdb /bin/bash @@ -160,7 +160,7 @@ the `influx` command line interface (CLI). {{% tab-content %}} ### Set up InfluxDB through the UI -1. With `influxd` running, visit [localhost:9999](http://localhost:9999). +1. With InfluxDB running, visit [localhost:9999](http://localhost:9999). 2. Click **Get Started** #### Set up your initial user