fix: add a few missing DEB/RPM instructions for license activation; shell source is for quick install (#6652)

* fix: add a few missing DEB/RPM instructions for license activation

* fix: sourcing shell config only needed with quick installs

* chore: address review feedback from Jason
pull/6656/head
Jamie Strandboge 2025-12-18 17:05:34 -06:00 committed by GitHub
parent 50397f2dc4
commit 56bdda83aa
No known key found for this signature in database
GPG Key ID: B5690EEEBB952194
2 changed files with 14 additions and 13 deletions

View File

@ -117,9 +117,9 @@ The license file is a JWT file that contains the license information.
To skip the email prompt when starting the server, you can provide your email
address using one of the following methods:
- Use the [`--license-email`](/influxdb3/enterprise/reference/config-options/#license-email) option with the `influxdb3 serve` command
- Set the `INFLUXDB3_ENTERPRISE_LICENSE_EMAIL` environment variable
- Set the [`license-email`](/influxdb3/enterprise/reference/config-options/#license-email) option in the `/etc/influxdb3/influxdb3-enterprise.conf` file (DEB/RPM installs)
- **CLI option:** Use the [`--license-email`](/influxdb3/enterprise/reference/cli/influxdb3/serve/) option with the `influxdb3 serve` command
- **Environment variable:** Set the `INFLUXDB3_ENTERPRISE_LICENSE_EMAIL` environment variable
- **TOML config (DEB/RPM-only):** Set the [`license-email`](/influxdb3/enterprise/reference/config-options/#license-email) option in the [`/etc/influxdb3/influxdb3-enterprise.conf` file](/influxdb3/enterprise/install/#toml-configuration-linux) for a DEB or RPM install
If the server finds a valid license file in your object store, it ignores the
license email option.
@ -133,8 +133,9 @@ address with the license server.
To use your existing license--for example, if you deleted your license
file--provide your email address using one of the following methods:
- Use the [`--license-email`](/influxdb3/enterprise/reference/cli/influxdb3/serve/) option with the `influxdb3 serve` command
- Set the `INFLUXDB3_ENTERPRISE_LICENSE_EMAIL` environment variable
- **CLI option:** Use the [`--license-email`](/influxdb3/enterprise/reference/cli/influxdb3/serve/) option with the `influxdb3 serve` command
- **Environment variable:** Set the `INFLUXDB3_ENTERPRISE_LICENSE_EMAIL` environment variable
- **TOML config (DEB/RPM-only):** Set the [`license-email`](/influxdb3/enterprise/reference/config-options/#license-email) option in the [`/etc/influxdb3/influxdb3-enterprise.conf` file](/influxdb3/enterprise/install/#toml-configuration-linux) for a DEB or RPM install
InfluxDB validates your email address with the license server and uses your
existing license if it's still valid.
@ -163,16 +164,16 @@ existing license if it's still valid.
2. When starting the {{< product-name >}} server, provide the license file
path using one of the following methods:
- Use the [`--license-file`](/influxdb3/enterprise/reference/config-options/#license-file)
option with the `influxdb3 serve` command
- Set the `INFLUXDB3_ENTERPRISE_LICENSE_FILE` environment variable.
- **CLI option:** Use the [`--license-file`](/influxdb3/enterprise/reference/config-options/#license-file) option with the `influxdb3 serve` command
- **Environment variable:** Set the `INFLUXDB3_ENTERPRISE_LICENSE_FILE` environment variable.
- **TOML config (DEB/RPM-only):** Set the [`license-file`](/influxdb3/enterprise/reference/config-options/#license-file) option in the [`/etc/influxdb3/influxdb3-enterprise.conf` file](/influxdb3/enterprise/install/#toml-configuration-linux) for a DEB or RPM install
### License detection
{{% product-name %}} checks for a license file in the following order:
1. The license file path provided with the [`--license-file`](/influxdb3/enterprise/reference/config-options/#license-file) option
1. The license file path provided with the [`--license-file`](/influxdb3/enterprise/reference/config-options/#license-file) command line option or [`license-file`](/influxdb3/enterprise/reference/config-options/#license-file) TOML option (DEB/RPM installs)
2. The license file path provided with the `INFLUXDB3_ENTERPRISE_LICENSE_FILE`
environment variable
3. The default license path:
@ -185,10 +186,10 @@ existing license if it's still valid.
```
/<OBJECT_STORE>/<CLUSTER_ID>/trial_or_home_license
```
5. The license email provided with the [`--license-email`](/influxdb3/enterprise/reference/config-options/#license-email) option
5. The license email provided with the [`--license-email`](/influxdb3/enterprise/reference/config-options/#license-email) command line option or [`license-email`](/influxdb3/enterprise/reference/config-options/#license-email) TOML option (DEB/RPM installs)
6. The license email provided with the `INFLUXDB3_ENTERPRISE_LICENSE_EMAIL`
environment variable
7. If no license is found, the server won't start
7. If no license is found, the server won't start
### Start the server with your license email

View File

@ -261,7 +261,7 @@ that it installed successfully:
influxdb3 --version
```
If your system doesn't locate `influxdb3`, then `source` the configuration file (for example, .bashrc, .zshrc) for your shell--for example:
If your system can't locate `influxdb3` following a [quick install](#quick-install-for-linux-and-macos), `source` the configuration file (for example, `.bashrc`, `.zshrc`) for your shell--for example:
<!--pytest.mark.skip-->
```zsh