Set up InfluxDB Cloud Dedicated
As you get started with this tutorial, do the following to make sure everything you need is in place.
- Request an InfluxDB Cloud Dedicated cluster
- Download, install, and configure the influxctl CLI
- Create a database
- Create a database token
Request an InfluxDB Cloud Dedicated cluster
Contact the InfluxData Sales team to request an InfluxDB Cloud Dedicated cluster. When your cluster is deployed, your InfluxData account representative provides the following:
- An Auth0 login to authenticate access to your cluster
- Your InfluxDB Cloud Dedicated account ID
- Your InfluxDB Cloud Dedicated cluster ID
- Your InfluxDB Cloud Dedicated cluster URL
Download, install, and configure the influxctl CLI
The influxctl
CLI
provides a simple way to manage your InfluxDB Cloud Dedicated cluster from a
command line. It lets you perform administrative tasks such as managing
databases and tokens.
Download the
influxctl
CLI.Contact InfluxData Support for information about downloading and installing the
influxctl
CLI.Create a connection profile and provide your InfluxDB Cloud Dedicated connection credentials. The
influxctl
CLI uses connection profiles to connect to and authenticate with your InfluxDB Cloud Dedicated cluster.To create a connection profile, run
influxctl init
to start an interactive prompt that creates and stores a connection profile.influxctl init
Provide the following required credentials:
- Account ID
- Cluster ID
For more information about
influxctl
profiles, see Configure connection profiles.
Create a database
Use the influxctl database create
command
to create a database. You can use an existing database or create a new one
specifically for this getting started tutorial.
Examples in this getting started tutorial assume a database named “get-started”.
Authenticate with your cluster
The first time you run an influxctl
CLI command, you are directed
to login to Auth0. Once logged in, Auth0 issues a short-lived (1 hour)
management token for the influxctl
CLI that grants administrative access
to your InfluxDB Cloud Dedicated cluster.
Provide the following:
- Database name.
- (Optional) Database retention period as a duration value. If no retention period is specified, the default is infinite.
influxctl database create \
--retention-period 1y \
get-started
Create a database token
Use the influxctl token create
command
to create a database token with read and write permissions for your database.
Provide the following:
- Permission grants
--read-database
: Grants read access to a database--write-database
Grants write access to a database
- Token description
influxctl token create \
--read-database get-started \
--write-database get-started \
"Read/write token for get-started database"
Was this page helpful?
Thank you for your feedback!
Support and feedback
Thank you for being part of our community! We welcome and encourage your feedback and bug reports for InfluxDB and this documentation. To find support, use the following resources:
InfluxDB Cloud and InfluxDB Enterprise customers can contact InfluxData Support.