docs-v2/content/influxdb/v1/tools/influxd/backup.md

35 lines
2.3 KiB
Markdown

---
title: influxd backup
description: >
The `influxd backup` command restores backup data and metadata from an InfluxDB backup directory.
menu:
influxdb_v1:
name: influxd backup
weight: 10
parent: influxd
alt_links:
v2: /influxdb/v2/reference/cli/influx/backup/
---
The `influxd backup` command crates a backup copy of specified InfluxDB OSS database(s) and saves the files in an Enterprise-compatible format to PATH (directory where backups are saved).
## Usage
```
influxd backup [flags] PATH
```
## Flags {.no-shorthand}
| Flag | Description |
|:-------------- |:------------------------------------------------------------------------------------------------------------------------------------------------ |
| `-portable` | Generate backup files in a portable format that can be restored to InfluxDB OSS or InfluxDB Enterprise. Use unless the legacy backup is required. |
| `-host` | InfluxDB OSS host to back up from. Optional. Defaults to 127.0.0.1:8088. |
| `-db` | InfluxDB OSS database name to back up. Optional. If not specified, all databases are backed up when using `-portable`. |
| `-rp` | Retention policy to use for the backup. Optional. If not specified, all retention policies are used by default. |
| `-shard` | The identifier of the shard to back up. Optional. If specified, `-rp` is required. |
| `-start` | Include all points starting with specified timestamp (RFC3339 format). Not compatible with `-since`. |
| `-end` | Exclude all points after timestamp (RFC3339 format). Not compatible with `-since`. |
| `-since` | Create an incremental backup of all points after the timestamp (RFC3339 format). Optional. Recommend using `-start` instead. |
| `-skip-errors` | Continue backing up the remaining shards when the current shard fails to backup. |