add steps to download influx CLI
parent
179e9d4a2a
commit
313e220e2f
|
@ -88,6 +88,109 @@ References to the InfluxDB user interface (UI) or localhost:9999 refer to your
|
||||||
{{< cloud-name >}} UI.
|
{{< cloud-name >}} UI.
|
||||||
{{% /cloud %}}
|
{{% /cloud %}}
|
||||||
|
|
||||||
|
### (Optional) Download and install the influx CLI
|
||||||
|
|
||||||
|
You can write, query, and process data through the Cloud user interface (UI) or `influx` CLI. To download and install the `influx` CLI, complete the following steps:
|
||||||
|
|
||||||
|
1. Click the **macOS** or **Linux** button below, and then click the appropriate **influx CLI** button to download the CLI binary.
|
||||||
|
2. Do one of the following:
|
||||||
|
- For **macOS**: [Unpackage the binary](#unpackage-the-influx-binary), and then [(optional) place the binary in your $PATH](#optional-place-the-binary-in-your-path)
|
||||||
|
- For **Linux**: [Place the binary in your $PATH](#place-the-binary-in-your-path)
|
||||||
|
3. If you're downloading on macOS Catalina, complete the steps in [Run influx CLI on macOS Catalina](/v2.0/get-started/#run-influx-cli-on-macos-catalina).
|
||||||
|
4. (Optional) To install `influx` shell completion scripts, see [`influx completion`](/v2.0/reference/cli/influx/completion/#install-completion-scripts).
|
||||||
|
|
||||||
|
{{< tabs-wrapper >}}
|
||||||
|
{{% tabs %}}
|
||||||
|
[macOS](#)
|
||||||
|
[Linux](#)
|
||||||
|
{{% /tabs %}}
|
||||||
|
|
||||||
|
<!-------------------------------- BEGIN macOS -------------------------------->
|
||||||
|
{{% tab-content %}}
|
||||||
|
|
||||||
|
#### Download influx CLI for macOS
|
||||||
|
|
||||||
|
Click the following button to download and install `influx` CLI for macOS.
|
||||||
|
|
||||||
|
<a class="btn download" href="https://dl.influxdata.com/influxdb/releases/influxdb_client_2.0.0-beta.12_darwin_amd64.tar.gz" download>influx CLI (macOS)</a>
|
||||||
|
|
||||||
|
#### Unpackage the influx binary
|
||||||
|
|
||||||
|
To unpackage the downloaded archive, **double click the archive file in Finder**
|
||||||
|
or run the following command in a macOS command prompt application such
|
||||||
|
**Terminal** or **[iTerm2](https://www.iterm2.com/)**:
|
||||||
|
|
||||||
|
```sh
|
||||||
|
# Unpackage contents to the current working directory
|
||||||
|
tar zxvf ~/Downloads/influxdb_client_2.0.0-beta.12_darwin_amd64.tar.gz
|
||||||
|
```
|
||||||
|
|
||||||
|
#### (Optional) Place the binary in your $PATH
|
||||||
|
|
||||||
|
If you choose, you can place `influx` in your `$PATH` or you can
|
||||||
|
prefix the executable with `./` to run in place.
|
||||||
|
|
||||||
|
```sh
|
||||||
|
# (Optional) Copy the influx binary to your $PATH
|
||||||
|
sudo cp influxdb_client_2.0.0-beta.12_darwin_amd64/influx /usr/local/bin/
|
||||||
|
```
|
||||||
|
|
||||||
|
{{% note %}}
|
||||||
|
If you rename the binary, all references to `influx` in this documentation refer to the renamed binary.
|
||||||
|
{{% /note %}}
|
||||||
|
|
||||||
|
{{% warn %}}
|
||||||
|
|
||||||
|
##### Run influx CLI on macOS Catalina
|
||||||
|
|
||||||
|
macOS Catalina requires downloaded binaries to be signed by registered Apple developers.
|
||||||
|
Currently, when you first attempt to run `influx`, macOS prevents it from running.
|
||||||
|
To manually authorize the binary:
|
||||||
|
|
||||||
|
1. Attempt to run the `influx`.
|
||||||
|
2. Open **System Preferences** and click **Security & Privacy**.
|
||||||
|
3. Under the **General** tab, there is a message about `influx` being blocked.
|
||||||
|
Click **Open Anyway**.
|
||||||
|
|
||||||
|
We are in the process of updating our build process to ensure released binaries are signed by InfluxData.
|
||||||
|
{{% /warn %}}
|
||||||
|
|
||||||
|
{{% /tab-content %}}
|
||||||
|
<!--------------------------------- END macOS --------------------------------->
|
||||||
|
|
||||||
|
<!-------------------------------- BEGIN Linux -------------------------------->
|
||||||
|
{{% tab-content %}}
|
||||||
|
|
||||||
|
#### Download influx CLI for Linux
|
||||||
|
|
||||||
|
Click the button to download and install the `influx` CLI appropriate for your chipset.
|
||||||
|
|
||||||
|
<a class="btn download" href="https://dl.influxdata.com/influxdb/releases/influxdb_client_2.0.0-beta.12_linux_amd64.tar.gz" download >influx CLI (amd64)</a>
|
||||||
|
<a class="btn download" href="https://dl.influxdata.com/influxdb/releases/influxdb_client_2.0.0-beta.12_linux_arm64.tar.gz" download >influx CLI (arm)</a>
|
||||||
|
|
||||||
|
#### Place the binary in your $PATH
|
||||||
|
|
||||||
|
Unpackage the downloaded archive and place the `influx` executable in your system `$PATH`.
|
||||||
|
|
||||||
|
_**Note:** The following commands are examples. Adjust the file names, paths, and utilities to your own needs._
|
||||||
|
|
||||||
|
```sh
|
||||||
|
# Unpackage contents to the current working directory
|
||||||
|
tar xvfz influxdb_client_2.0.0-beta.12_linux_amd64.tar.gz
|
||||||
|
|
||||||
|
# Copy the influx and influxd binary to your $PATH
|
||||||
|
sudo cp influxdb_client_2.0.0-beta.12_linux_amd64/influx /usr/local/bin/
|
||||||
|
```
|
||||||
|
|
||||||
|
{{% note %}}
|
||||||
|
If you rename the binary, all references to `influx` in this documentation refer to the renamed binary.
|
||||||
|
{{% /note %}}
|
||||||
|
|
||||||
|
{{% /tab-content %}}
|
||||||
|
<!--------------------------------- END Linux --------------------------------->
|
||||||
|
|
||||||
|
{{< /tabs-wrapper >}}
|
||||||
|
|
||||||
### Sign in
|
### Sign in
|
||||||
|
|
||||||
Sign in to [InfluxDB Cloud 2.0](https://cloud2.influxdata.com) using your email address and password.
|
Sign in to [InfluxDB Cloud 2.0](https://cloud2.influxdata.com) using your email address and password.
|
||||||
|
|
Loading…
Reference in New Issue