chef-automate CLI
Automate CLI Commands
chef-automate
A helpful utility to deploy and manage Chef Automate. Docs: https://docs.chef.io/automate/cli_chef_automate/ Patents: https://www.chef.io/patents
Usage
chef-automate COMMAND [flags]
Flags
-d, --debug
Enable debug output (default: false)-h, --help
help for chef-automate (default: false)--no-check-version
Disable version check (default: false)--result-json
Write command result as JSON to PATH
See Also
Manage applications observability features
Chef Automate backup
Chef Automate configuration
Deploy Chef Automate
Manage Chef Automate's external certificate
Gather system diagnostics and logs
Chef Automate iam commands
Info about Automate HA
Chef Automate infrastructure
Initialize default config
Initialize default config for Automate HA
Manage Chef Automate's internal certificate authority
Chef Automate license management
Put Chef Automate into or out of maintenance mode
Migrate from Chef Automate v1
Watch the status of the migration to Chef Automate 2
Perform preflight check
Provision Automate HA infra.
restart deployment services
Set secrets to Automate HA
Retrieve the versions of the individual Chef Automate services
SSH into Automate HA servers
Start Chef Automate
Retrieve Chef Automate status
Stop deployment
Tail Chef Automate logs
Run Automate HA smoke tests
Uninstall Chef Automate
upgrade automate to the latest version
Validate existing infrastructure of Automate HA
Validate existing infrastructure of Automate HA
Show CLI version
Set workspace env for Automate HA.
chef-automate airgap
chef-automate COMMAND [flags]-d, --debug
Enable debug output (default: false)
-h, --help
help for chef-automate (default: false)
--no-check-version
Disable version check (default: false)
--result-json
Write command result as JSON to PATH
See Also
Manage applications observability features
Chef Automate backup
Chef Automate configuration
Deploy Chef Automate
Manage Chef Automate's external certificate
Gather system diagnostics and logs
Chef Automate iam commands
Info about Automate HA
Chef Automate infrastructure
Initialize default config
Initialize default config for Automate HA
Manage Chef Automate's internal certificate authority
Chef Automate license management
Put Chef Automate into or out of maintenance mode
Migrate from Chef Automate v1
Watch the status of the migration to Chef Automate 2
Perform preflight check
Provision Automate HA infra.
restart deployment services
Set secrets to Automate HA
Retrieve the versions of the individual Chef Automate services
SSH into Automate HA servers
Start Chef Automate
Retrieve Chef Automate status
Stop deployment
Tail Chef Automate logs
Run Automate HA smoke tests
Uninstall Chef Automate
upgrade automate to the latest version
Validate existing infrastructure of Automate HA
Validate existing infrastructure of Automate HA
Show CLI version
Set workspace env for Automate HA.
chef-automate airgap
Manage applications observability features
Chef Automate backup
Chef Automate configuration
Deploy Chef Automate
Manage Chef Automate's external certificate
Gather system diagnostics and logs
Chef Automate iam commands
Info about Automate HA
Chef Automate infrastructure
Initialize default config
Initialize default config for Automate HA
Manage Chef Automate's internal certificate authority
Chef Automate license management
Put Chef Automate into or out of maintenance mode
Migrate from Chef Automate v1
Watch the status of the migration to Chef Automate 2
Perform preflight check
Provision Automate HA infra.
restart deployment services
Set secrets to Automate HA
Retrieve the versions of the individual Chef Automate services
SSH into Automate HA servers
Start Chef Automate
Retrieve Chef Automate status
Stop deployment
Tail Chef Automate logs
Run Automate HA smoke tests
Uninstall Chef Automate
upgrade automate to the latest version
Validate existing infrastructure of Automate HA
Validate existing infrastructure of Automate HA
Show CLI version
Set workspace env for Automate HA.
Usage
chef-automate airgap COMMAND [flags]
Flags
-h, --help
help for airgap (default: false)-d, --debug
Enable debug output (default: false)--no-check-version
Disable version check (default: false)--result-json
Write command result as JSON to PATH
See Also
chef-automate airgap bundle
chef-automate airgap COMMAND [flags]-h, --help
help for airgap (default: false)
-d, --debug
Enable debug output (default: false)
--no-check-version
Disable version check (default: false)
--result-json
Write command result as JSON to PATH
See Also
chef-automate airgap bundle
Usage
chef-automate airgap bundle COMMAND [flags]
Flags
-h, --help
help for bundle (default: false)-d, --debug
Enable debug output (default: false)--no-check-version
Disable version check (default: false)--result-json
Write command result as JSON to PATH
See Also
chef-automate airgap bundle create
chef-automate airgap bundle COMMAND [flags]-h, --help
help for bundle (default: false)
-d, --debug
Enable debug output (default: false)
--no-check-version
Disable version check (default: false)
--result-json
Write command result as JSON to PATH
See Also
chef-automate airgap bundle create
Usage
chef-automate airgap bundle create [/path/to/bundle.aib] [flags]
Flags
-c, --channel
Release channel to pull packages from-h, --help
help for create (default: false)-m, --manifest
Path to a release manifest.json-r, --retries
Number of times to retry failed hab package downloads (default: 2)--retry-delay
Number of seconds to wait between retries (exponential backoff is used if not provided)
(default: -1)--version
Chef Automate version to create an airgap bundle for-w, --workspace
Path to workspace storage location where temporary data will be stored
-d, --debug
Enable debug output (default: false)--no-check-version
Disable version check (default: false)--result-json
Write command result as JSON to PATH
See Also
chef-automate airgap bundle info
chef-automate airgap bundle create [/path/to/bundle.aib] [flags]
-c, --channel
Release channel to pull packages from
-h, --help
help for create (default: false)
-m, --manifest
Path to a release manifest.json
-r, --retries
Number of times to retry failed hab package downloads (default: 2)
--retry-delay
Number of seconds to wait between retries (exponential backoff is used if not provided)
(default: -1)
--version
Chef Automate version to create an airgap bundle for
-w, --workspace
Path to workspace storage location where temporary data will be stored
-d, --debug
Enable debug output (default: false)
--no-check-version
Disable version check (default: false)
--result-json
Write command result as JSON to PATH
See Also
chef-automate airgap bundle info
Usage
chef-automate airgap bundle info /path/to/bundle.aib [flags]
Flags
-h, --help
help for info (default: false)--verbose
Output full AIB metadata (default: false)-d, --debug
Enable debug output (default: false)--no-check-version
Disable version check (default: false)--result-json
Write command result as JSON to PATH
See Also
chef-automate applications
chef-automate airgap bundle info /path/to/bundle.aib [flags]-h, --help
help for info (default: false)
--verbose
Output full AIB metadata (default: false)
-d, --debug
Enable debug output (default: false)
--no-check-version
Disable version check (default: false)
--result-json
Write command result as JSON to PATH
See Also
chef-automate applications
Usage
chef-automate applications COMMAND [flags]
Flags
-h, --help
help for applications (default: false)-d, --debug
Enable debug output (default: false)--no-check-version
Disable version check (default: false)--result-json
Write command result as JSON to PATH
See Also
Chef Automate CLI
Remove services from the applications database
Show services in the applications database
chef-automate applications remove-svcs
chef-automate applications COMMAND [flags]-h, --help
help for applications (default: false)
-d, --debug
Enable debug output (default: false)
--no-check-version
Disable version check (default: false)
--result-json
Write command result as JSON to PATH
See Also
Chef Automate CLI
Remove services from the applications database
Show services in the applications database
chef-automate applications remove-svcs
Chef Automate CLI
Remove services from the applications database
Show services in the applications database
Remove services from the applications database. You must fully decommission services by retiring physical hardware, terminating the VM or container, or by using 'hab svc unload', before using the 'remove-svcs' command. Services that are incompletely decommissioned will send a health-check at the appointed time and Automate will re-add them to the services database.
Usage
chef-automate applications remove-svcs [flags]
Flags
--all
Delete all services in the database. This flag must be given if no other filter is given.
(default: false)-a, --application
Select only services where the application name matches the given pattern
-b, --buildstamp
Select only services where the buildstamp matches the given pattern
-c, --channel
Select only services where the subscribed channel matches the given pattern
-D, --disconnected
Select only services that are disconnected (default: false)-e, --environment
Select only services where the application environment matches the given pattern
-g, --group
Select only services where the group name (suffix) matches the given pattern
-h, --help
help for remove-svcs (default: false)-o, --origin
Select only services where the origin matches the given pattern
-n, --service-name
Select only services where the name matches the given pattern
-s, --site
Select only services where the site matches the given pattern
-v, --version
Select only services where the package version matches the given pattern
-y, --yes
Delete the services without a confirmation prompt (default: false)-d, --debug
Enable debug output (default: false)--no-check-version
Disable version check (default: false)--result-json
Write command result as JSON to PATH
See Also
Manage applications observability features
chef-automate applications show-svcs
chef-automate applications remove-svcs [flags]--all
Delete all services in the database. This flag must be given if no other filter is given.
(default: false)
-a, --application
Select only services where the application name matches the given pattern
-b, --buildstamp
Select only services where the buildstamp matches the given pattern
-c, --channel
Select only services where the subscribed channel matches the given pattern
-D, --disconnected
Select only services that are disconnected (default: false)
-e, --environment
Select only services where the application environment matches the given pattern
-g, --group
Select only services where the group name (suffix) matches the given pattern
-h, --help
help for remove-svcs (default: false)
-o, --origin
Select only services where the origin matches the given pattern
-n, --service-name
Select only services where the name matches the given pattern
-s, --site
Select only services where the site matches the given pattern
-v, --version
Select only services where the package version matches the given pattern
-y, --yes
Delete the services without a confirmation prompt (default: false)
-d, --debug
Enable debug output (default: false)
--no-check-version
Disable version check (default: false)
--result-json
Write command result as JSON to PATH
See Also
Manage applications observability features
chef-automate applications show-svcs
Manage applications observability features
Display a list of the habitat services stored in the applications database.
Usage
chef-automate applications show-svcs [flags]
Flags
-a, --application
Select only services where the application name matches the given pattern
-b, --buildstamp
Select only services where the buildstamp matches the given pattern
-c, --channel
Select only services where the subscribed channel matches the given pattern
-D, --disconnected
Select only services that are disconnected (default: false)-e, --environment
Select only services where the application environment matches the given pattern
-g, --group
Select only services where the group name (suffix) matches the given pattern
-h, --help
help for show-svcs (default: false)-o, --origin
Select only services where the origin matches the given pattern
-n, --service-name
Select only services where the name matches the given pattern
-s, --site
Select only services where the site matches the given pattern
-v, --version
Select only services where the package version matches the given pattern
-d, --debug
Enable debug output (default: false)--no-check-version
Disable version check (default: false)--result-json
Write command result as JSON to PATH
See Also
Manage applications observability features
chef-automate backup
chef-automate applications show-svcs [flags]-a, --application
Select only services where the application name matches the given pattern
-b, --buildstamp
Select only services where the buildstamp matches the given pattern
-c, --channel
Select only services where the subscribed channel matches the given pattern
-D, --disconnected
Select only services that are disconnected (default: false)
-e, --environment
Select only services where the application environment matches the given pattern
-g, --group
Select only services where the group name (suffix) matches the given pattern
-h, --help
help for show-svcs (default: false)
-o, --origin
Select only services where the origin matches the given pattern
-n, --service-name
Select only services where the name matches the given pattern
-s, --site
Select only services where the site matches the given pattern
-v, --version
Select only services where the package version matches the given pattern
-d, --debug
Enable debug output (default: false)
--no-check-version
Disable version check (default: false)
--result-json
Write command result as JSON to PATH
See Also
Manage applications observability features
chef-automate backup
Manage applications observability features
Usage
chef-automate backup COMMAND [flags]
Flags
--gcs-credentials-path
The path to the GCP service account json file-h, --help
help for backup (default: false)--no-progress
Don't follow operation progress (default: false)-r, --request-timeout
API request timeout for deployment-service in seconds (default: 20)--s3-access-key
The S3 access key ID--s3-endpoint
The S3 region endpoint URL--s3-secret-key
The S3 secret access key--s3-session-token
The S3 session token when assuming an IAM role-d, --debug
Enable debug output (default: false)--no-check-version
Disable version check (default: false)--result-json
Write command result as JSON to PATH
See Also
Chef Automate CLI
cancel the running backup operation
create a backup of Chef Automate
delete backups of Chef Automate
Ensure the hab user has the required permissions on the given path
Chef Automate shared object integrity
list all Chef Automate backups
restore a Chef Automate backup
show the Chef Automate backup details
show the Chef Automate backup runner status
chef-automate backup cancel
chef-automate backup COMMAND [flags]--gcs-credentials-path
The path to the GCP service account json file
-h, --help
help for backup (default: false)
--no-progress
Don't follow operation progress (default: false)
-r, --request-timeout
API request timeout for deployment-service in seconds (default: 20)
--s3-access-key
The S3 access key ID
--s3-endpoint
The S3 region endpoint URL
--s3-secret-key
The S3 secret access key
--s3-session-token
The S3 session token when assuming an IAM role
-d, --debug
Enable debug output (default: false)
--no-check-version
Disable version check (default: false)
--result-json
Write command result as JSON to PATH
See Also
Chef Automate CLI
cancel the running backup operation
create a backup of Chef Automate
delete backups of Chef Automate
Ensure the hab user has the required permissions on the given path
Chef Automate shared object integrity
list all Chef Automate backups
restore a Chef Automate backup
show the Chef Automate backup details
show the Chef Automate backup runner status
chef-automate backup cancel
Chef Automate CLI
cancel the running backup operation
create a backup of Chef Automate
delete backups of Chef Automate
Ensure the hab user has the required permissions on the given path
Chef Automate shared object integrity
list all Chef Automate backups
restore a Chef Automate backup
show the Chef Automate backup details
show the Chef Automate backup runner status
Cancel the currently running backup create, delete, or restore operation
Usage
chef-automate backup cancel [flags]
Flags
-h, --help
help for cancel (default: false)-t, --wait-timeout
How long to wait for a operation to complete before raising an error
(default: 60)-d, --debug
Enable debug output (default: false)--gcs-credentials-path
The path to the GCP service account json file--no-check-version
Disable version check (default: false)--no-progress
Don't follow operation progress (default: false)-r, --request-timeout
API request timeout for deployment-service in seconds (default: 20)--result-json
Write command result as JSON to PATH--s3-access-key
The S3 access key ID--s3-endpoint
The S3 region endpoint URL--s3-secret-key
The S3 secret access key--s3-session-token
The S3 session token when assuming an IAM role
See Also
Chef Automate backup
chef-automate backup create
chef-automate backup cancel [flags]-h, --help
help for cancel (default: false)
-t, --wait-timeout
How long to wait for a operation to complete before raising an error
(default: 60)
-d, --debug
Enable debug output (default: false)
--gcs-credentials-path
The path to the GCP service account json file
--no-check-version
Disable version check (default: false)
--no-progress
Don't follow operation progress (default: false)
-r, --request-timeout
API request timeout for deployment-service in seconds (default: 20)
--result-json
Write command result as JSON to PATH
--s3-access-key
The S3 access key ID
--s3-endpoint
The S3 region endpoint URL
--s3-secret-key
The S3 secret access key
--s3-session-token
The S3 session token when assuming an IAM role
See Also
Chef Automate backup
chef-automate backup create
Chef Automate backup
Create a backup of Chef Automate
Usage
chef-automate backup create [flags]
Flags
-h, --help
help for create (default: false)-t, --wait-timeout
How long to wait for a operation to complete before raising an error
(default: 7200)-d, --debug
Enable debug output (default: false)--gcs-credentials-path
The path to the GCP service account json file--no-check-version
Disable version check (default: false)--no-progress
Don't follow operation progress (default: false)-r, --request-timeout
API request timeout for deployment-service in seconds (default: 20)--result-json
Write command result as JSON to PATH--s3-access-key
The S3 access key ID--s3-endpoint
The S3 region endpoint URL--s3-secret-key
The S3 secret access key--s3-session-token
The S3 session token when assuming an IAM role
See Also
Chef Automate backup
chef-automate backup delete
chef-automate backup create [flags]-h, --help
help for create (default: false)
-t, --wait-timeout
How long to wait for a operation to complete before raising an error
(default: 7200)
-d, --debug
Enable debug output (default: false)
--gcs-credentials-path
The path to the GCP service account json file
--no-check-version
Disable version check (default: false)
--no-progress
Don't follow operation progress (default: false)
-r, --request-timeout
API request timeout for deployment-service in seconds (default: 20)
--result-json
Write command result as JSON to PATH
--s3-access-key
The S3 access key ID
--s3-endpoint
The S3 region endpoint URL
--s3-secret-key
The S3 secret access key
--s3-session-token
The S3 session token when assuming an IAM role
See Also
Chef Automate backup
chef-automate backup delete
Chef Automate backup
Delete one or many backups of Chef Automate that match the space separated strings of backup IDs
Usage
chef-automate backup delete ID [ID2 IDN...] [flags]
Flags
-h, --help
help for delete (default: false)-t, --wait-timeout
How long to wait for a operation to complete before raising an error
(default: 120)--yes
Agree to all prompts (default: false)-d, --debug
Enable debug output (default: false)--gcs-credentials-path
The path to the GCP service account json file--no-check-version
Disable version check (default: false)--no-progress
Don't follow operation progress (default: false)-r, --request-timeout
API request timeout for deployment-service in seconds (default: 20)--result-json
Write command result as JSON to PATH--s3-access-key
The S3 access key ID--s3-endpoint
The S3 region endpoint URL--s3-secret-key
The S3 secret access key--s3-session-token
The S3 session token when assuming an IAM role
See Also
Chef Automate backup
chef-automate backup fix-repo-permissions
chef-automate backup delete ID [ID2 IDN...] [flags]-h, --help
help for delete (default: false)
-t, --wait-timeout
How long to wait for a operation to complete before raising an error
(default: 120)
--yes
Agree to all prompts (default: false)
-d, --debug
Enable debug output (default: false)
--gcs-credentials-path
The path to the GCP service account json file
--no-check-version
Disable version check (default: false)
--no-progress
Don't follow operation progress (default: false)
-r, --request-timeout
API request timeout for deployment-service in seconds (default: 20)
--result-json
Write command result as JSON to PATH
--s3-access-key
The S3 access key ID
--s3-endpoint
The S3 region endpoint URL
--s3-secret-key
The S3 secret access key
--s3-session-token
The S3 session token when assuming an IAM role
See Also
Chef Automate backup
chef-automate backup fix-repo-permissions
Chef Automate backup
Ensure the hab user has the required permissions on the given path
Usage
chef-automate backup fix-repo-permissions PATH [flags]
Flags
-h, --help
help for fix-repo-permissions (default: false)-d, --debug
Enable debug output (default: false)--gcs-credentials-path
The path to the GCP service account json file--no-check-version
Disable version check (default: false)--no-progress
Don't follow operation progress (default: false)-r, --request-timeout
API request timeout for deployment-service in seconds (default: 20)--result-json
Write command result as JSON to PATH--s3-access-key
The S3 access key ID--s3-endpoint
The S3 region endpoint URL--s3-secret-key
The S3 secret access key--s3-session-token
The S3 session token when assuming an IAM role
See Also
Chef Automate backup
chef-automate backup integrity
chef-automate backup fix-repo-permissions PATH [flags]-h, --help
help for fix-repo-permissions (default: false)
-d, --debug
Enable debug output (default: false)
--gcs-credentials-path
The path to the GCP service account json file
--no-check-version
Disable version check (default: false)
--no-progress
Don't follow operation progress (default: false)
-r, --request-timeout
API request timeout for deployment-service in seconds (default: 20)
--result-json
Write command result as JSON to PATH
--s3-access-key
The S3 access key ID
--s3-endpoint
The S3 region endpoint URL
--s3-secret-key
The S3 secret access key
--s3-session-token
The S3 session token when assuming an IAM role
See Also
Chef Automate backup
chef-automate backup integrity
Chef Automate backup
Usage
chef-automate backup integrity COMMAND [flags]
Flags
-h, --help
help for integrity (default: false)-t, --wait-timeout
How long to wait for a operation to complete before raising an error
(default: 60)-d, --debug
Enable debug output (default: false)--gcs-credentials-path
The path to the GCP service account json file--no-check-version
Disable version check (default: false)--no-progress
Don't follow operation progress (default: false)-r, --request-timeout
API request timeout for deployment-service in seconds (default: 20)--result-json
Write command result as JSON to PATH--s3-access-key
The S3 access key ID--s3-endpoint
The S3 region endpoint URL--s3-secret-key
The S3 secret access key--s3-session-token
The S3 session token when assuming an IAM role
See Also
Chef Automate backup
show the shared object integrity metadata
validate the shared object integrity
chef-automate backup integrity show
chef-automate backup integrity COMMAND [flags]-h, --help
help for integrity (default: false)
-t, --wait-timeout
How long to wait for a operation to complete before raising an error
(default: 60)
-d, --debug
Enable debug output (default: false)
--gcs-credentials-path
The path to the GCP service account json file
--no-check-version
Disable version check (default: false)
--no-progress
Don't follow operation progress (default: false)
-r, --request-timeout
API request timeout for deployment-service in seconds (default: 20)
--result-json
Write command result as JSON to PATH
--s3-access-key
The S3 access key ID
--s3-endpoint
The S3 region endpoint URL
--s3-secret-key
The S3 secret access key
--s3-session-token
The S3 session token when assuming an IAM role
See Also
Chef Automate backup
show the shared object integrity metadata
validate the shared object integrity
chef-automate backup integrity show
Chef Automate backup
show the shared object integrity metadata
validate the shared object integrity
Show the shared object integrity metadata
Usage
chef-automate backup integrity show [flags]
Flags
-h, --help
help for show (default: false)-d, --debug
Enable debug output (default: false)--gcs-credentials-path
The path to the GCP service account json file--no-check-version
Disable version check (default: false)--no-progress
Don't follow operation progress (default: false)-r, --request-timeout
API request timeout for deployment-service in seconds (default: 20)--result-json
Write command result as JSON to PATH--s3-access-key
The S3 access key ID--s3-endpoint
The S3 region endpoint URL--s3-secret-key
The S3 secret access key--s3-session-token
The S3 session token when assuming an IAM role-t, --wait-timeout
How long to wait for a operation to complete before raising an error
(default: 60)
See Also
Chef Automate shared object integrity
chef-automate backup integrity validate
chef-automate backup integrity show [flags]-h, --help
help for show (default: false)
-d, --debug
Enable debug output (default: false)
--gcs-credentials-path
The path to the GCP service account json file
--no-check-version
Disable version check (default: false)
--no-progress
Don't follow operation progress (default: false)
-r, --request-timeout
API request timeout for deployment-service in seconds (default: 20)
--result-json
Write command result as JSON to PATH
--s3-access-key
The S3 access key ID
--s3-endpoint
The S3 region endpoint URL
--s3-secret-key
The S3 secret access key
--s3-session-token
The S3 session token when assuming an IAM role
-t, --wait-timeout
How long to wait for a operation to complete before raising an error
(default: 60)
See Also
Chef Automate shared object integrity
chef-automate backup integrity validate
Chef Automate shared object integrity
Validate the shared object integrity. If one or more snapshot IDs is not given all snapshots will be validated
Usage
chef-automate backup integrity validate [ID IDN] [flags]
Flags
-h, --help
help for validate (default: false)-d, --debug
Enable debug output (default: false)--gcs-credentials-path
The path to the GCP service account json file--no-check-version
Disable version check (default: false)--no-progress
Don't follow operation progress (default: false)-r, --request-timeout
API request timeout for deployment-service in seconds (default: 20)--result-json
Write command result as JSON to PATH--s3-access-key
The S3 access key ID--s3-endpoint
The S3 region endpoint URL--s3-secret-key
The S3 secret access key--s3-session-token
The S3 session token when assuming an IAM role-t, --wait-timeout
How long to wait for a operation to complete before raising an error
(default: 60)
See Also
Chef Automate shared object integrity
chef-automate backup list
chef-automate backup integrity validate [ID IDN] [flags]-h, --help
help for validate (default: false)
-d, --debug
Enable debug output (default: false)
--gcs-credentials-path
The path to the GCP service account json file
--no-check-version
Disable version check (default: false)
--no-progress
Don't follow operation progress (default: false)
-r, --request-timeout
API request timeout for deployment-service in seconds (default: 20)
--result-json
Write command result as JSON to PATH
--s3-access-key
The S3 access key ID
--s3-endpoint
The S3 region endpoint URL
--s3-secret-key
The S3 secret access key
--s3-session-token
The S3 session token when assuming an IAM role
-t, --wait-timeout
How long to wait for a operation to complete before raising an error
(default: 60)
See Also
Chef Automate shared object integrity
chef-automate backup list
Chef Automate shared object integrity
List all Chef Automate backups
Usage
chef-automate backup list [flags]
Flags
-h, --help
help for list (default: false)-t, --wait-timeout
How long to wait for a operation to complete before raising an error
(default: 60)-d, --debug
Enable debug output (default: false)--gcs-credentials-path
The path to the GCP service account json file--no-check-version
Disable version check (default: false)--no-progress
Don't follow operation progress (default: false)-r, --request-timeout
API request timeout for deployment-service in seconds (default: 20)--result-json
Write command result as JSON to PATH--s3-access-key
The S3 access key ID--s3-endpoint
The S3 region endpoint URL--s3-secret-key
The S3 secret access key--s3-session-token
The S3 session token when assuming an IAM role
See Also
Chef Automate backup
chef-automate backup restore
chef-automate backup list [flags]-h, --help
help for list (default: false)
-t, --wait-timeout
How long to wait for a operation to complete before raising an error
(default: 60)
-d, --debug
Enable debug output (default: false)
--gcs-credentials-path
The path to the GCP service account json file
--no-check-version
Disable version check (default: false)
--no-progress
Don't follow operation progress (default: false)
-r, --request-timeout
API request timeout for deployment-service in seconds (default: 20)
--result-json
Write command result as JSON to PATH
--s3-access-key
The S3 access key ID
--s3-endpoint
The S3 region endpoint URL
--s3-secret-key
The S3 secret access key
--s3-session-token
The S3 session token when assuming an IAM role
See Also
Chef Automate backup
chef-automate backup restore
Chef Automate backup
Restore a Chef Automate backup. If no ID or path is given the latest found backup will be restored.
Usage
chef-automate backup restore [ID_OR_PATH] [flags]
Flags
--airgap-bundle
The artifact to use for an air-gapped installation-b, --backup-dir
Directory used for backups (default: /var/opt/chef-automate/backups)-h, --help
help for restore (default: false)--patch-config
Path to patch config if required--sha256
The SHA256 checksum of the backup--skip-preflight
Skip preflight checks when restoring a backup (default: false)-u, --upgrade
Upgrade to the latest package versions when restoring backups
(default: false)-t, --wait-timeout
How long to wait for a operation to complete before raising an error
(default: 7200)--yes
Agree to all prompts (default: false)-d, --debug
Enable debug output (default: false)--gcs-credentials-path
The path to the GCP service account json file--no-check-version
Disable version check (default: false)--no-progress
Don't follow operation progress (default: false)-r, --request-timeout
API request timeout for deployment-service in seconds (default: 20)--result-json
Write command result as JSON to PATH--s3-access-key
The S3 access key ID--s3-endpoint
The S3 region endpoint URL--s3-secret-key
The S3 secret access key--s3-session-token
The S3 session token when assuming an IAM role
See Also
Chef Automate backup
chef-automate backup show
chef-automate backup restore [ID_OR_PATH] [flags]--airgap-bundle
The artifact to use for an air-gapped installation
-b, --backup-dir
Directory used for backups (default: /var/opt/chef-automate/backups)
-h, --help
help for restore (default: false)
--patch-config
Path to patch config if required
--sha256
The SHA256 checksum of the backup
--skip-preflight
Skip preflight checks when restoring a backup (default: false)
-u, --upgrade
Upgrade to the latest package versions when restoring backups
(default: false)
-t, --wait-timeout
How long to wait for a operation to complete before raising an error
(default: 7200)
--yes
Agree to all prompts (default: false)
-d, --debug
Enable debug output (default: false)
--gcs-credentials-path
The path to the GCP service account json file
--no-check-version
Disable version check (default: false)
--no-progress
Don't follow operation progress (default: false)
-r, --request-timeout
API request timeout for deployment-service in seconds (default: 20)
--result-json
Write command result as JSON to PATH
--s3-access-key
The S3 access key ID
--s3-endpoint
The S3 region endpoint URL
--s3-secret-key
The S3 secret access key
--s3-session-token
The S3 session token when assuming an IAM role
See Also
Chef Automate backup
chef-automate backup show
Chef Automate backup
Show the details of a Chef Automate backup
Usage
chef-automate backup show ID [flags]
Flags
-h, --help
help for show (default: false)-t, --wait-timeout
How long to wait for a operation to complete before raising an error
(default: 60)-d, --debug
Enable debug output (default: false)--gcs-credentials-path
The path to the GCP service account json file--no-check-version
Disable version check (default: false)--no-progress
Don't follow operation progress (default: false)-r, --request-timeout
API request timeout for deployment-service in seconds (default: 20)--result-json
Write command result as JSON to PATH--s3-access-key
The S3 access key ID--s3-endpoint
The S3 region endpoint URL--s3-secret-key
The S3 secret access key--s3-session-token
The S3 session token when assuming an IAM role
See Also
Chef Automate backup
chef-automate backup status
chef-automate backup show ID [flags]-h, --help
help for show (default: false)
-t, --wait-timeout
How long to wait for a operation to complete before raising an error
(default: 60)
-d, --debug
Enable debug output (default: false)
--gcs-credentials-path
The path to the GCP service account json file
--no-check-version
Disable version check (default: false)
--no-progress
Don't follow operation progress (default: false)
-r, --request-timeout
API request timeout for deployment-service in seconds (default: 20)
--result-json
Write command result as JSON to PATH
--s3-access-key
The S3 access key ID
--s3-endpoint
The S3 region endpoint URL
--s3-secret-key
The S3 secret access key
--s3-session-token
The S3 session token when assuming an IAM role
See Also
Chef Automate backup
chef-automate backup status
Chef Automate backup
Show the Chef Automate backup runner status
Usage
chef-automate backup status [flags]
Flags
-h, --help
help for status (default: false)-t, --wait-timeout
How long to wait for a operation to complete before raising an error
(default: 60)-d, --debug
Enable debug output (default: false)--gcs-credentials-path
The path to the GCP service account json file--no-check-version
Disable version check (default: false)--no-progress
Don't follow operation progress (default: false)-r, --request-timeout
API request timeout for deployment-service in seconds (default: 20)--result-json
Write command result as JSON to PATH--s3-access-key
The S3 access key ID--s3-endpoint
The S3 region endpoint URL--s3-secret-key
The S3 secret access key--s3-session-token
The S3 session token when assuming an IAM role
See Also
Chef Automate backup
chef-automate config
chef-automate backup status [flags]-h, --help
help for status (default: false)
-t, --wait-timeout
How long to wait for a operation to complete before raising an error
(default: 60)
-d, --debug
Enable debug output (default: false)
--gcs-credentials-path
The path to the GCP service account json file
--no-check-version
Disable version check (default: false)
--no-progress
Don't follow operation progress (default: false)
-r, --request-timeout
API request timeout for deployment-service in seconds (default: 20)
--result-json
Write command result as JSON to PATH
--s3-access-key
The S3 access key ID
--s3-endpoint
The S3 region endpoint URL
--s3-secret-key
The S3 secret access key
--s3-session-token
The S3 session token when assuming an IAM role
See Also
Chef Automate backup
chef-automate config
Chef Automate backup
Usage
chef-automate config COMMAND [flags]
Flags
-h, --help
help for config (default: false)-t, --timeout
Request timeout in seconds (default: 10)-d, --debug
Enable debug output (default: false)--no-check-version
Disable version check (default: false)--result-json
Write command result as JSON to PATH
See Also
Chef Automate CLI
patch the Chef Automate configuration
set the Chef Automate configuration
show the Chef Automate configuration
chef-automate config patch
chef-automate config COMMAND [flags]-h, --help
help for config (default: false)
-t, --timeout
Request timeout in seconds (default: 10)
-d, --debug
Enable debug output (default: false)
--no-check-version
Disable version check (default: false)
--result-json
Write command result as JSON to PATH
See Also
Chef Automate CLI
patch the Chef Automate configuration
set the Chef Automate configuration
show the Chef Automate configuration
chef-automate config patch
Chef Automate CLI
patch the Chef Automate configuration
set the Chef Automate configuration
show the Chef Automate configuration
Apply a partial Chef Automate configuration to the deployment. It will take the partial configuration, merge it with the existing configuration, and apply and required changes.
Usage
chef-automate config patch path/to/config.toml [flags]
Flags
-h, --help
help for patch (default: false)-d, --debug
Enable debug output (default: false)--no-check-version
Disable version check (default: false)--result-json
Write command result as JSON to PATH-t, --timeout
Request timeout in seconds (default: 10)
See Also
Chef Automate configuration
chef-automate config set
chef-automate config patch path/to/config.toml [flags]-h, --help
help for patch (default: false)
-d, --debug
Enable debug output (default: false)
--no-check-version
Disable version check (default: false)
--result-json
Write command result as JSON to PATH
-t, --timeout
Request timeout in seconds (default: 10)
See Also
Chef Automate configuration
chef-automate config set
Chef Automate configuration
Set the Chef Automate configuration for the deployment. It will replace the Chef Automate configuration with the given configuration and apply any required changes.
Usage
chef-automate config set path/to/config.toml [flags]
Flags
-h, --help
help for set (default: false)-d, --debug
Enable debug output (default: false)--no-check-version
Disable version check (default: false)--result-json
Write command result as JSON to PATH-t, --timeout
Request timeout in seconds (default: 10)
See Also
Chef Automate configuration
chef-automate config show
chef-automate config set path/to/config.toml [flags]-h, --help
help for set (default: false)
-d, --debug
Enable debug output (default: false)
--no-check-version
Disable version check (default: false)
--result-json
Write command result as JSON to PATH
-t, --timeout
Request timeout in seconds (default: 10)
See Also
Chef Automate configuration
chef-automate config show
Chef Automate configuration
Show the Chef Automate configuration. When given a filepath, the output will be written to the file instead of printed to STDOUT
Usage
chef-automate config show [/path/to/write/config.toml] [flags]
Flags
-h, --help
help for show (default: false)-o, --overwrite
Overwrite existing config.toml (default: false)-d, --debug
Enable debug output (default: false)--no-check-version
Disable version check (default: false)--result-json
Write command result as JSON to PATH-t, --timeout
Request timeout in seconds (default: 10)
See Also
Chef Automate configuration
chef-automate deploy
chef-automate config show [/path/to/write/config.toml] [flags]
-h, --help
help for show (default: false)
-o, --overwrite
Overwrite existing config.toml (default: false)
-d, --debug
Enable debug output (default: false)
--no-check-version
Disable version check (default: false)
--result-json
Write command result as JSON to PATH
-t, --timeout
Request timeout in seconds (default: 10)
See Also
Chef Automate configuration
chef-automate deploy
Chef Automate configuration
Deploy a new Chef Automate instance using the supplied configuration. - <CONFIG_FILE> must be a valid path to a TOML formatted configuration file
Usage
chef-automate deploy [/path/to/config.toml] [flags]
Flags
--accept-terms-and-mlsa
Agree to the Chef Software Terms of Service and the Master License and Services Agreement
(default: false)--airgap-bundle
Path to an airgap install bundle--certificate
The path to a certificate that should be used for external TLS connections (web and API).
--channel
Release channel to deploy all services from--fqdn
The fully-qualified domain name that Chef Automate can be accessed at. (default: hostname of this machine)
-h, --help
help for deploy (default: false)--private-key
The path to a private key corresponding to the TLS certificate.
--product
Product to deploy (default: [])--skip-preflight
Deploy regardless of pre-flight conditions (default: false)--upgrade-strategy
Upgrade strategy to use for this deployment. (default: at-once)-d, --debug
Enable debug output (default: false)--no-check-version
Disable version check (default: false)--result-json
Write command result as JSON to PATH
See Also
Chef Automate CLI
chef-automate external-cert
chef-automate deploy [/path/to/config.toml] [flags]--accept-terms-and-mlsa
Agree to the Chef Software Terms of Service and the Master License and Services Agreement
(default: false)
--airgap-bundle
Path to an airgap install bundle
--certificate
The path to a certificate that should be used for external TLS connections (web and API).
--channel
Release channel to deploy all services from
--fqdn
The fully-qualified domain name that Chef Automate can be accessed at. (default: hostname of this machine)
-h, --help
help for deploy (default: false)
--private-key
The path to a private key corresponding to the TLS certificate.
--product
Product to deploy (default: [])
--skip-preflight
Deploy regardless of pre-flight conditions (default: false)
--upgrade-strategy
Upgrade strategy to use for this deployment. (default: at-once)
-d, --debug
Enable debug output (default: false)
--no-check-version
Disable version check (default: false)
--result-json
Write command result as JSON to PATH
See Also
Chef Automate CLI
chef-automate external-cert
Chef Automate CLI
Manage Chef Automate's external certificate authority. Used for establishing TLS/SSL communication with automate.
Usage
chef-automate external-cert COMMAND [flags]
Flags
-f, --file
File path to save automate TLS certifcate to.-h, --help
help for external-cert (default: false)-n, --hostname
Hostname for the automate TLS certificate-d, --debug
Enable debug output (default: false)--no-check-version
Disable version check (default: false)--result-json
Write command result as JSON to PATH
See Also
Chef Automate CLI
Show the external TLS/SSL certificates in Automate. Optionally, save the certificates to a file in the specified path.
chef-automate external-cert show
chef-automate external-cert COMMAND [flags]-f, --file
File path to save automate TLS certifcate to.
-h, --help
help for external-cert (default: false)
-n, --hostname
Hostname for the automate TLS certificate
-d, --debug
Enable debug output (default: false)
--no-check-version
Disable version check (default: false)
--result-json
Write command result as JSON to PATH
See Also
Chef Automate CLI
Show the external TLS/SSL certificates in Automate. Optionally, save the certificates to a file in the specified path.
chef-automate external-cert show
Chef Automate CLI
Show the external TLS/SSL certificates in Automate. Optionally, save the certificates to a file in the specified path.
Usage
chef-automate external-cert show [flags]
Flags
-h, --help
help for show (default: false)-d, --debug
Enable debug output (default: false)-f, --file
File path to save automate TLS certifcate to.-n, --hostname
Hostname for the automate TLS certificate--no-check-version
Disable version check (default: false)--result-json
Write command result as JSON to PATH
See Also
Manage Chef Automate's external certificate
chef-automate gather-logs
chef-automate external-cert show [flags]-h, --help
help for show (default: false)
-d, --debug
Enable debug output (default: false)
-f, --file
File path to save automate TLS certifcate to.
-n, --hostname
Hostname for the automate TLS certificate
--no-check-version
Disable version check (default: false)
--result-json
Write command result as JSON to PATH
See Also
Manage Chef Automate's external certificate
chef-automate gather-logs
Manage Chef Automate's external certificate
Collect system diagnostics and logs from Chef Automate and other services
Usage
chef-automate gather-logs [/path/to/log/bundle.tar.gz] [flags]
Flags
-h, --help
help for gather-logs (default: false)-l, --local-fallback
run gather-logs in local fallback mode (default: false)--log-lines
Number of system log lines (journald logs) to collect (0 for all logs)
(default: 500000)-o, --overwrite
Overwrite existing log archive (default: false)-d, --debug
Enable debug output (default: false)--no-check-version
Disable version check (default: false)--result-json
Write command result as JSON to PATH
See Also
Chef Automate CLI
chef-automate iam
chef-automate gather-logs [/path/to/log/bundle.tar.gz] [flags]
-h, --help
help for gather-logs (default: false)
-l, --local-fallback
run gather-logs in local fallback mode (default: false)
--log-lines
Number of system log lines (journald logs) to collect (0 for all logs)
(default: 500000)
-o, --overwrite
Overwrite existing log archive (default: false)
-d, --debug
Enable debug output (default: false)
--no-check-version
Disable version check (default: false)
--result-json
Write command result as JSON to PATH
See Also
Chef Automate CLI
chef-automate iam
Chef Automate CLI
Usage
chef-automate iam COMMAND [flags]
Flags
-h, --help
help for iam (default: false)-d, --debug
Enable debug output (default: false)--no-check-version
Disable version check (default: false)--result-json
Write command result as JSON to PATH
See Also
Chef Automate CLI
Manage and restore default admin access
Manage tokens
Retrieve IAM version in use
chef-automate iam admin-access
chef-automate iam COMMAND [flags]-h, --help
help for iam (default: false)
-d, --debug
Enable debug output (default: false)
--no-check-version
Disable version check (default: false)
--result-json
Write command result as JSON to PATH
See Also
Chef Automate CLI
Manage and restore default admin access
Manage tokens
Retrieve IAM version in use
chef-automate iam admin-access
Chef Automate CLI
Manage and restore default admin access
Manage tokens
Retrieve IAM version in use
Usage
chef-automate iam admin-access COMMAND [flags]
Flags
-h, --help
help for admin-access (default: false)-d, --debug
Enable debug output (default: false)--no-check-version
Disable version check (default: false)--result-json
Write command result as JSON to PATH
See Also
Chef Automate iam commands
Restore the factory default admin user, team, and access
chef-automate iam admin-access restore
chef-automate iam admin-access COMMAND [flags]-h, --help
help for admin-access (default: false)
-d, --debug
Enable debug output (default: false)
--no-check-version
Disable version check (default: false)
--result-json
Write command result as JSON to PATH
See Also
Chef Automate iam commands
Restore the factory default admin user, team, and access
chef-automate iam admin-access restore
Chef Automate iam commands
Restore the factory default admin user, team, and access
Recreate the admin user, admin team, and related admin policy as needed to restore to factory default and update the admin user's password
Usage
chef-automate iam admin-access restore PASSWORD [flags]
Flags
--dry-run
Show what would be updated by this command without performing any changes
(default: false)-h, --help
help for restore (default: false)-d, --debug
Enable debug output (default: false)--no-check-version
Disable version check (default: false)--result-json
Write command result as JSON to PATH
See Also
Manage and restore default admin access
chef-automate iam token
chef-automate iam admin-access restore PASSWORD [flags]--dry-run
Show what would be updated by this command without performing any changes
(default: false)
-h, --help
help for restore (default: false)
-d, --debug
Enable debug output (default: false)
--no-check-version
Disable version check (default: false)
--result-json
Write command result as JSON to PATH
See Also
Manage and restore default admin access
chef-automate iam token
Manage and restore default admin access
Usage
chef-automate iam token COMMAND [flags]
Flags
-h, --help
help for token (default: false)-d, --debug
Enable debug output (default: false)--no-check-version
Disable version check (default: false)--result-json
Write command result as JSON to PATH
See Also
chef-automate iam token create
chef-automate iam token COMMAND [flags]-h, --help
help for token (default: false)
-d, --debug
Enable debug output (default: false)
--no-check-version
Disable version check (default: false)
--result-json
Write command result as JSON to PATH
See Also
chef-automate iam token create
Usage
chef-automate iam token create NAME [flags]
Flags
--admin
Generate a token and add it to the chef-managed admin policy (default: false)-h, --help
help for create (default: false)--id
Specify a custom ID (if omitted, an ID will be generated based on NAME)
-d, --debug
Enable debug output (default: false)--no-check-version
Disable version check (default: false)--result-json
Write command result as JSON to PATH
See Also
Manage tokens
chef-automate iam version
chef-automate iam token create NAME [flags]--admin
Generate a token and add it to the chef-managed admin policy (default: false)
-h, --help
help for create (default: false)
--id
Specify a custom ID (if omitted, an ID will be generated based on NAME)
-d, --debug
Enable debug output (default: false)
--no-check-version
Disable version check (default: false)
--result-json
Write command result as JSON to PATH
See Also
Manage tokens
chef-automate iam version
Manage tokens
Usage
chef-automate iam version [flags]
Flags
-h, --help
help for version (default: false)-d, --debug
Enable debug output (default: false)--no-check-version
Disable version check (default: false)--result-json
Write command result as JSON to PATH
See Also
Chef Automate iam commands
chef-automate info
chef-automate iam version [flags]-h, --help
help for version (default: false)
-d, --debug
Enable debug output (default: false)
--no-check-version
Disable version check (default: false)
--result-json
Write command result as JSON to PATH
See Also
Chef Automate iam commands
chef-automate info
Chef Automate iam commands
Info for Automate HA cluster
Usage
chef-automate info [flags]
Flags
-h, --help
help for info (default: false)-d, --debug
Enable debug output (default: false)--no-check-version
Disable version check (default: false)--result-json
Write command result as JSON to PATH
See Also
Chef Automate CLI
chef-automate infrastructure
chef-automate info [flags]-h, --help
help for info (default: false)
-d, --debug
Enable debug output (default: false)
--no-check-version
Disable version check (default: false)
--result-json
Write command result as JSON to PATH
See Also
Chef Automate CLI
chef-automate infrastructure
Chef Automate CLI
Commands for automation infrastructure management, for data related to chef-client runs and chef-server actions.
Usage
chef-automate infrastructure COMMAND [flags]
Flags
-h, --help
help for infrastructure (default: false)-d, --debug
Enable debug output (default: false)--no-check-version
Disable version check (default: false)--result-json
Write command result as JSON to PATH
See Also
chef-automate infrastructure node-delete
chef-automate infrastructure COMMAND [flags]-h, --help
help for infrastructure (default: false)
-d, --debug
Enable debug output (default: false)
--no-check-version
Disable version check (default: false)
--result-json
Write command result as JSON to PATH
See Also
chef-automate infrastructure node-delete
Usage
chef-automate infrastructure node-delete [uuid] [flags]
Flags
-h, --help
help for node-delete (default: false)-d, --debug
Enable debug output (default: false)--no-check-version
Disable version check (default: false)--result-json
Write command result as JSON to PATH
See Also
Chef Automate infrastructure
chef-automate init-config
chef-automate infrastructure node-delete [uuid] [flags]-h, --help
help for node-delete (default: false)
-d, --debug
Enable debug output (default: false)
--no-check-version
Disable version check (default: false)
--result-json
Write command result as JSON to PATH
See Also
Chef Automate infrastructure
chef-automate init-config
Chef Automate infrastructure
Initialize default configuration and save it to a file.
Usage
chef-automate init-config [flags]
Flags
--certificate
The path to a certificate that should be used for external TLS connections (web and API).
--channel
Release channel to deploy all services from (default: current)--es-mem
The amount of system memory to allocate to Elasticsearch's heap. (default: 25% of system memory)
--file
File path to write the config (default: config.toml)--fqdn
The fully-qualified domain name that Chef Automate can be accessed at. (default: hostname of this machine)
-h, --help
help for init-config (default: false)--private-key
The path to a private key corresponding to the TLS certificate.
--upgrade-strategy
Upgrade strategy to use for this deployment. (default: at-once)-d, --debug
Enable debug output (default: false)--no-check-version
Disable version check (default: false)--result-json
Write command result as JSON to PATH
See Also
Chef Automate CLI
chef-automate init-config-ha
chef-automate init-config [flags]--certificate
The path to a certificate that should be used for external TLS connections (web and API).
--channel
Release channel to deploy all services from (default: current)
--es-mem
The amount of system memory to allocate to Elasticsearch's heap. (default: 25% of system memory)
--file
File path to write the config (default: config.toml)
--fqdn
The fully-qualified domain name that Chef Automate can be accessed at. (default: hostname of this machine)
-h, --help
help for init-config (default: false)
--private-key
The path to a private key corresponding to the TLS certificate.
--upgrade-strategy
Upgrade strategy to use for this deployment. (default: at-once)
-d, --debug
Enable debug output (default: false)
--no-check-version
Disable version check (default: false)
--result-json
Write command result as JSON to PATH
See Also
Chef Automate CLI
chef-automate init-config-ha
Chef Automate CLI
Initialized default configuration for HA and save it to a file.
Usage
chef-automate init-config-ha [flags]
Flags
--file
File path to write the config (default: config.toml)-h, --help
help for init-config-ha (default: false)--path
a2ha hab workspace dir path (default: /hab/a2_deploy_workspace/)-d, --debug
Enable debug output (default: false)--no-check-version
Disable version check (default: false)--result-json
Write command result as JSON to PATH
See Also
Chef Automate CLI
chef-automate internal-ca
chef-automate init-config-ha [flags]--file
File path to write the config (default: config.toml)
-h, --help
help for init-config-ha (default: false)
--path
a2ha hab workspace dir path (default: /hab/a2_deploy_workspace/)
-d, --debug
Enable debug output (default: false)
--no-check-version
Disable version check (default: false)
--result-json
Write command result as JSON to PATH
See Also
Chef Automate CLI
chef-automate internal-ca
Chef Automate CLI
Manage Chef Automate's internal certificate authority. Used for inter-service encryption and authentication.
Usage
chef-automate internal-ca COMMAND [flags]
Flags
-h, --help
help for internal-ca (default: false)-d, --debug
Enable debug output (default: false)--no-check-version
Disable version check (default: false)--result-json
Write command result as JSON to PATH
See Also
Chef Automate CLI
Print information the root certificate for the internal certificate authority
Commands to regenerate certificates issued by the internal certificate authority
chef-automate internal-ca info
chef-automate internal-ca COMMAND [flags]-h, --help
help for internal-ca (default: false)
-d, --debug
Enable debug output (default: false)
--no-check-version
Disable version check (default: false)
--result-json
Write command result as JSON to PATH
See Also
Chef Automate CLI
Print information the root certificate for the internal certificate authority
Commands to regenerate certificates issued by the internal certificate authority
chef-automate internal-ca info
Chef Automate CLI
Print information the root certificate for the internal certificate authority
Commands to regenerate certificates issued by the internal certificate authority
Usage
chef-automate internal-ca info [flags]
Flags
-h, --help
help for info (default: false)-d, --debug
Enable debug output (default: false)--no-check-version
Disable version check (default: false)--result-json
Write command result as JSON to PATH
See Also
Manage Chef Automate's internal certificate authority
chef-automate internal-ca regenerate
chef-automate internal-ca info [flags]-h, --help
help for info (default: false)
-d, --debug
Enable debug output (default: false)
--no-check-version
Disable version check (default: false)
--result-json
Write command result as JSON to PATH
See Also
Manage Chef Automate's internal certificate authority
chef-automate internal-ca regenerate
Manage Chef Automate's internal certificate authority
Usage
chef-automate internal-ca regenerate [flags]
Flags
-h, --help
help for regenerate (default: false)-d, --debug
Enable debug output (default: false)--no-check-version
Disable version check (default: false)--result-json
Write command result as JSON to PATH
See Also
Manage Chef Automate's internal certificate authority
Regenerate the root certificate for the internal certificate authority
chef-automate internal-ca regenerate root
chef-automate internal-ca regenerate [flags]-h, --help
help for regenerate (default: false)
-d, --debug
Enable debug output (default: false)
--no-check-version
Disable version check (default: false)
--result-json
Write command result as JSON to PATH
See Also
Manage Chef Automate's internal certificate authority
Regenerate the root certificate for the internal certificate authority
chef-automate internal-ca regenerate root
Manage Chef Automate's internal certificate authority
Regenerate the root certificate for the internal certificate authority
Usage
chef-automate internal-ca regenerate root [flags]
Flags
-h, --help
help for root (default: false)-d, --debug
Enable debug output (default: false)--no-check-version
Disable version check (default: false)--result-json
Write command result as JSON to PATH
See Also
Commands to regenerate certificates issued by the internal certificate authority
chef-automate license
chef-automate internal-ca regenerate root [flags]-h, --help
help for root (default: false)
-d, --debug
Enable debug output (default: false)
--no-check-version
Disable version check (default: false)
--result-json
Write command result as JSON to PATH
See Also
Commands to regenerate certificates issued by the internal certificate authority
chef-automate license
Commands to regenerate certificates issued by the internal certificate authority
Usage
chef-automate license COMMAND [flags]
Flags
-h, --help
help for license (default: false)-d, --debug
Enable debug output (default: false)--no-check-version
Disable version check (default: false)--result-json
Write command result as JSON to PATH
See Also
Chef Automate CLI
Apply Chef Automate license
Generates the unique count of reported Compliance scans on hourly basis between the time duration
Generates daily Infra Client Run reports for a span of time duration
Generates daily Infra Client Run reports for a span of time duration
Retrieve Chef Automate license status
Generates the unique count of reported Infra Client nodes on hourly basis between the time duration
chef-automate license apply
chef-automate license COMMAND [flags]-h, --help
help for license (default: false)
-d, --debug
Enable debug output (default: false)
--no-check-version
Disable version check (default: false)
--result-json
Write command result as JSON to PATH
See Also
Chef Automate CLI
Apply Chef Automate license
Generates the unique count of reported Compliance scans on hourly basis between the time duration
Generates daily Infra Client Run reports for a span of time duration
Generates daily Infra Client Run reports for a span of time duration
Retrieve Chef Automate license status
Generates the unique count of reported Infra Client nodes on hourly basis between the time duration
chef-automate license apply
Chef Automate CLI
Apply Chef Automate license
Generates the unique count of reported Compliance scans on hourly basis between the time duration
Generates daily Infra Client Run reports for a span of time duration
Generates daily Infra Client Run reports for a span of time duration
Retrieve Chef Automate license status
Generates the unique count of reported Infra Client nodes on hourly basis between the time duration
Apply Chef Automate license token. - <LICENSE> must be valid encoded license string
Usage
chef-automate license apply LICENSE [flags]
Flags
-f, --force
Force set license (default: false)-h, --help
help for apply (default: false)-d, --debug
Enable debug output (default: false)--no-check-version
Disable version check (default: false)--result-json
Write command result as JSON to PATH
See Also
Chef Automate license management
chef-automate license complianceResourceRunCount
chef-automate license apply LICENSE [flags]-f, --force
Force set license (default: false)
-h, --help
help for apply (default: false)
-d, --debug
Enable debug output (default: false)
--no-check-version
Disable version check (default: false)
--result-json
Write command result as JSON to PATH
See Also
Chef Automate license management
chef-automate license complianceResourceRunCount
Chef Automate license management
Usage
chef-automate license complianceResourceRunCount [flags]
Flags
-e, --end_time
end time of the report in yyyy-mm-dd format-n, --es_hostname
hostname of the ES host (default: localhost)-p, --es_port
port of the ES host (default: 10141)-h, --help
help for complianceResourceRunCount (default: false)-s, --start_time
start time of the report in yyyy-mm-dd format-d, --debug
Enable debug output (default: false)--no-check-version
Disable version check (default: false)--result-json
Write command result as JSON to PATH
See Also
Chef Automate license management
chef-automate license complianceResourceRunReport
chef-automate license complianceResourceRunCount [flags]-e, --end_time
end time of the report in yyyy-mm-dd format
-n, --es_hostname
hostname of the ES host (default: localhost)
-p, --es_port
port of the ES host (default: 10141)
-h, --help
help for complianceResourceRunCount (default: false)
-s, --start_time
start time of the report in yyyy-mm-dd format
-d, --debug
Enable debug output (default: false)
--no-check-version
Disable version check (default: false)
--result-json
Write command result as JSON to PATH
See Also
Chef Automate license management
chef-automate license complianceResourceRunReport
Chef Automate license management
Usage
chef-automate license complianceResourceRunReport [flags]
Flags
-e, --end_time
end time of the report in yyyy-mm-dd format-n, --es_hostname
hostname of the ES host (default: localhost)-p, --es_port
port of the ES host (default: 10141)-h, --help
help for complianceResourceRunReport (default: false)-s, --start_time
start time of the report in yyyy-mm-dd format-d, --debug
Enable debug output (default: false)--no-check-version
Disable version check (default: false)--result-json
Write command result as JSON to PATH
See Also
Chef Automate license management
chef-automate license nodeRunReport
chef-automate license complianceResourceRunReport [flags]-e, --end_time
end time of the report in yyyy-mm-dd format
-n, --es_hostname
hostname of the ES host (default: localhost)
-p, --es_port
port of the ES host (default: 10141)
-h, --help
help for complianceResourceRunReport (default: false)
-s, --start_time
start time of the report in yyyy-mm-dd format
-d, --debug
Enable debug output (default: false)
--no-check-version
Disable version check (default: false)
--result-json
Write command result as JSON to PATH
See Also
Chef Automate license management
chef-automate license nodeRunReport
Chef Automate license management
Usage
chef-automate license nodeRunReport [flags]
Flags
-e, --end_time
end time of the report in yyyy-mm-dd format-n, --es_hostname
hostname of the ES host (default: localhost)-p, --es_port
port of the ES host (default: 10141)-h, --help
help for nodeRunReport (default: false)-s, --start_time
start time of the report in yyyy-mm-dd format-d, --debug
Enable debug output (default: false)--no-check-version
Disable version check (default: false)--result-json
Write command result as JSON to PATH
See Also
Chef Automate license management
chef-automate license status
chef-automate license nodeRunReport [flags]-e, --end_time
end time of the report in yyyy-mm-dd format
-n, --es_hostname
hostname of the ES host (default: localhost)
-p, --es_port
port of the ES host (default: 10141)
-h, --help
help for nodeRunReport (default: false)
-s, --start_time
start time of the report in yyyy-mm-dd format
-d, --debug
Enable debug output (default: false)
--no-check-version
Disable version check (default: false)
--result-json
Write command result as JSON to PATH
See Also
Chef Automate license management
chef-automate license status
Chef Automate license management
Usage
chef-automate license status [flags]
Flags
-h, --help
help for status (default: false)-d, --debug
Enable debug output (default: false)--no-check-version
Disable version check (default: false)--result-json
Write command result as JSON to PATH
See Also
Chef Automate license management
chef-automate license uniqNodeRunReport
chef-automate license status [flags]-h, --help
help for status (default: false)
-d, --debug
Enable debug output (default: false)
--no-check-version
Disable version check (default: false)
--result-json
Write command result as JSON to PATH
See Also
Chef Automate license management
chef-automate license uniqNodeRunReport
Chef Automate license management
Usage
chef-automate license uniqNodeRunReport [flags]
Flags
-e, --end_time
end time of the report in yyyy-mm-dd format-n, --es_hostname
hostname of the ES host (default: localhost)-p, --es_port
port of the ES host (default: 10141)-h, --help
help for uniqNodeRunReport (default: false)-s, --start_time
start time of the report in yyyy-mm-dd format-d, --debug
Enable debug output (default: false)--no-check-version
Disable version check (default: false)--result-json
Write command result as JSON to PATH
See Also
Chef Automate license management
chef-automate maintenance
chef-automate license uniqNodeRunReport [flags]-e, --end_time
end time of the report in yyyy-mm-dd format
-n, --es_hostname
hostname of the ES host (default: localhost)
-p, --es_port
port of the ES host (default: 10141)
-h, --help
help for uniqNodeRunReport (default: false)
-s, --start_time
start time of the report in yyyy-mm-dd format
-d, --debug
Enable debug output (default: false)
--no-check-version
Disable version check (default: false)
--result-json
Write command result as JSON to PATH
See Also
Chef Automate license management
chef-automate maintenance
Chef Automate license management
Chef Automate maintenance mode keeps all services running but rejects new connections at the load balancer so that maintenance operations can be performed.
Usage
chef-automate maintenance [on|off] [flags]
Flags
-h, --help
help for maintenance (default: false)-t, --timeout
Request timeout in seconds (default: 10)-d, --debug
Enable debug output (default: false)--no-check-version
Disable version check (default: false)--result-json
Write command result as JSON to PATH
See Also
Chef Automate CLI
chef-automate migrate-from-v1
chef-automate maintenance [on|off] [flags]-h, --help
help for maintenance (default: false)
-t, --timeout
Request timeout in seconds (default: 10)
-d, --debug
Enable debug output (default: false)
--no-check-version
Disable version check (default: false)
--result-json
Write command result as JSON to PATH
See Also
Chef Automate CLI
chef-automate migrate-from-v1
Chef Automate CLI
Migrate an existing Chef Automate v1 deployment to Chef Automate v2. - <CONFIG_FILE> must be a valid path to a TOML formatted configuration file
Usage
chef-automate migrate-from-v1 [/path/to/automate-deploy.toml] [flags]
Flags
--airgap-bundle
Path to an airgap install bundle--channel
Optional channel to use when installing packages from the depot
--chef-server-running
Path to chef-server-running.json (default: /etc/opscode/chef-server-running.json)-c, --config
Path to an automate-deploy.toml-r, --delivery-running
Path to delivery-running.json (default: /etc/delivery/delivery-running.json)-s, --delivery-secrets
Path to delivery-secrets.json (default: /etc/delivery/delivery-secrets.json)--enable-chef-server
Enable integrated Chef Server migration and deployment; only valid for all-in-one topology
(default: false)--file-move-timeout
Optional timeout for moving elasticsearch, compliance, and notifications files during Chef Automate v1 migration (0 to disable timeout)
(default: 0)-h, --help
help for migrate-from-v1 (default: false)--postgres-dump-wait-seconds
Optional timeout for Chef Automate v1 PostgreSQL dump (0 to disable timeout)
(default: 0)--postgres-restore-wait-seconds
Optional timeout for Chef Automate v1 PostgreSQL restore (0 to disable timeout)
(default: 0)--skip-backup
Optionally skip backup of your Chef Automate v1 installation (default = false)
(default: false)--skip-backup-check
Optionally do not check if your Chef Automate v1 installation has backups configured (default = false)
(default: false)--skip-disaster-recovery-check
Optionally do not check if your Chef Automate v1 installation has disaster recovery configured (default = false)
(default: false)--skip-external-es-check
Optionally do not check if your Chef Automate v1 installation has external Elasticsearch configured (default = false)
(default: false)--skip-fips-check
Optionally do not check if your Chef Automate v1 installation has FIPS configured (default = false)
(default: false)--skip-preflight
Deploy regardless of pre-flight conditions (default: false)--skip-saml-check
Optionally do not check if your Chef Automate v1 installation has SAML configured (default = false)
(default: false)--skip-workflow-check
Optionally do not check if your Chef Automate v1 installation has workflow configured (default = false)
(default: false)--upgrade-strategy
Optional upgrade strategy to use when configuring the deployment service
-y, --yes
Do not prompt for confirmation; accept defaults and continue (default: false)-d, --debug
Enable debug output (default: false)--no-check-version
Disable version check (default: false)--result-json
Write command result as JSON to PATH
See Also
chef-automate migrate-from-v1-status
chef-automate migrate-from-v1 [/path/to/automate-deploy.toml] [flags]
--airgap-bundle
Path to an airgap install bundle
--channel
Optional channel to use when installing packages from the depot
--chef-server-running
Path to chef-server-running.json (default: /etc/opscode/chef-server-running.json)
-c, --config
Path to an automate-deploy.toml
-r, --delivery-running
Path to delivery-running.json (default: /etc/delivery/delivery-running.json)
-s, --delivery-secrets
Path to delivery-secrets.json (default: /etc/delivery/delivery-secrets.json)
--enable-chef-server
Enable integrated Chef Server migration and deployment; only valid for all-in-one topology
(default: false)
--file-move-timeout
Optional timeout for moving elasticsearch, compliance, and notifications files during Chef Automate v1 migration (0 to disable timeout)
(default: 0)
-h, --help
help for migrate-from-v1 (default: false)
--postgres-dump-wait-seconds
Optional timeout for Chef Automate v1 PostgreSQL dump (0 to disable timeout)
(default: 0)
--postgres-restore-wait-seconds
Optional timeout for Chef Automate v1 PostgreSQL restore (0 to disable timeout)
(default: 0)
--skip-backup
Optionally skip backup of your Chef Automate v1 installation (default = false)
(default: false)
--skip-backup-check
Optionally do not check if your Chef Automate v1 installation has backups configured (default = false)
(default: false)
--skip-disaster-recovery-check
Optionally do not check if your Chef Automate v1 installation has disaster recovery configured (default = false)
(default: false)
--skip-external-es-check
Optionally do not check if your Chef Automate v1 installation has external Elasticsearch configured (default = false)
(default: false)
--skip-fips-check
Optionally do not check if your Chef Automate v1 installation has FIPS configured (default = false)
(default: false)
--skip-preflight
Deploy regardless of pre-flight conditions (default: false)
--skip-saml-check
Optionally do not check if your Chef Automate v1 installation has SAML configured (default = false)
(default: false)
--skip-workflow-check
Optionally do not check if your Chef Automate v1 installation has workflow configured (default = false)
(default: false)
--upgrade-strategy
Optional upgrade strategy to use when configuring the deployment service
-y, --yes
Do not prompt for confirmation; accept defaults and continue (default: false)
-d, --debug
Enable debug output (default: false)
--no-check-version
Disable version check (default: false)
--result-json
Write command result as JSON to PATH
See Also
chef-automate migrate-from-v1-status
Usage
chef-automate migrate-from-v1-status [flags]
Flags
-h, --help
help for migrate-from-v1-status (default: false)-d, --debug
Enable debug output (default: false)--no-check-version
Disable version check (default: false)--result-json
Write command result as JSON to PATH
See Also
Chef Automate CLI
chef-automate migrate-from-v1 gen-config
chef-automate migrate-from-v1-status [flags]-h, --help
help for migrate-from-v1-status (default: false)
-d, --debug
Enable debug output (default: false)
--no-check-version
Disable version check (default: false)
--result-json
Write command result as JSON to PATH
See Also
Chef Automate CLI
chef-automate migrate-from-v1 gen-config
Chef Automate CLI
Generate a Chef Automate v2 configuration file from Chef Automate v1
Usage
chef-automate migrate-from-v1 gen-config [flags]
Flags
-h, --help
help for gen-config (default: false)-o, --out
Output file (default: ./automate-migrate.toml)--airgap-bundle
Path to an airgap install bundle--channel
Optional channel to use when installing packages from the depot
--chef-server-running
Path to chef-server-running.json (default: /etc/opscode/chef-server-running.json)-c, --config
Path to an automate-deploy.toml-d, --debug
Enable debug output (default: false)-r, --delivery-running
Path to delivery-running.json (default: /etc/delivery/delivery-running.json)-s, --delivery-secrets
Path to delivery-secrets.json (default: /etc/delivery/delivery-secrets.json)--enable-chef-server
Enable integrated Chef Server migration and deployment; only valid for all-in-one topology
(default: false)--file-move-timeout
Optional timeout for moving elasticsearch, compliance, and notifications files during Chef Automate v1 migration (0 to disable timeout)
(default: 0)--no-check-version
Disable version check (default: false)--postgres-dump-wait-seconds
Optional timeout for Chef Automate v1 PostgreSQL dump (0 to disable timeout)
(default: 0)--postgres-restore-wait-seconds
Optional timeout for Chef Automate v1 PostgreSQL restore (0 to disable timeout)
(default: 0)--result-json
Write command result as JSON to PATH--skip-backup
Optionally skip backup of your Chef Automate v1 installation (default = false)
(default: false)--skip-backup-check
Optionally do not check if your Chef Automate v1 installation has backups configured (default = false)
(default: false)--skip-disaster-recovery-check
Optionally do not check if your Chef Automate v1 installation has disaster recovery configured (default = false)
(default: false)--skip-external-es-check
Optionally do not check if your Chef Automate v1 installation has external Elasticsearch configured (default = false)
(default: false)--skip-fips-check
Optionally do not check if your Chef Automate v1 installation has FIPS configured (default = false)
(default: false)--skip-preflight
Deploy regardless of pre-flight conditions (default: false)--skip-saml-check
Optionally do not check if your Chef Automate v1 installation has SAML configured (default = false)
(default: false)--skip-workflow-check
Optionally do not check if your Chef Automate v1 installation has workflow configured (default = false)
(default: false)--upgrade-strategy
Optional upgrade strategy to use when configuring the deployment service
-y, --yes
Do not prompt for confirmation; accept defaults and continue (default: false)
See Also
Migrate from Chef Automate v1
chef-automate preflight-check
chef-automate migrate-from-v1 gen-config [flags]-h, --help
help for gen-config (default: false)
-o, --out
Output file (default: ./automate-migrate.toml)
--airgap-bundle
Path to an airgap install bundle
--channel
Optional channel to use when installing packages from the depot
--chef-server-running
Path to chef-server-running.json (default: /etc/opscode/chef-server-running.json)
-c, --config
Path to an automate-deploy.toml
-d, --debug
Enable debug output (default: false)
-r, --delivery-running
Path to delivery-running.json (default: /etc/delivery/delivery-running.json)
-s, --delivery-secrets
Path to delivery-secrets.json (default: /etc/delivery/delivery-secrets.json)
--enable-chef-server
Enable integrated Chef Server migration and deployment; only valid for all-in-one topology
(default: false)
--file-move-timeout
Optional timeout for moving elasticsearch, compliance, and notifications files during Chef Automate v1 migration (0 to disable timeout)
(default: 0)
--no-check-version
Disable version check (default: false)
--postgres-dump-wait-seconds
Optional timeout for Chef Automate v1 PostgreSQL dump (0 to disable timeout)
(default: 0)
--postgres-restore-wait-seconds
Optional timeout for Chef Automate v1 PostgreSQL restore (0 to disable timeout)
(default: 0)
--result-json
Write command result as JSON to PATH
--skip-backup
Optionally skip backup of your Chef Automate v1 installation (default = false)
(default: false)
--skip-backup-check
Optionally do not check if your Chef Automate v1 installation has backups configured (default = false)
(default: false)
--skip-disaster-recovery-check
Optionally do not check if your Chef Automate v1 installation has disaster recovery configured (default = false)
(default: false)
--skip-external-es-check
Optionally do not check if your Chef Automate v1 installation has external Elasticsearch configured (default = false)
(default: false)
--skip-fips-check
Optionally do not check if your Chef Automate v1 installation has FIPS configured (default = false)
(default: false)
--skip-preflight
Deploy regardless of pre-flight conditions (default: false)
--skip-saml-check
Optionally do not check if your Chef Automate v1 installation has SAML configured (default = false)
(default: false)
--skip-workflow-check
Optionally do not check if your Chef Automate v1 installation has workflow configured (default = false)
(default: false)
--upgrade-strategy
Optional upgrade strategy to use when configuring the deployment service
-y, --yes
Do not prompt for confirmation; accept defaults and continue (default: false)
See Also
Migrate from Chef Automate v1
chef-automate preflight-check
Migrate from Chef Automate v1
Perform preflight check to verify host meets installation criteria.
Usage
chef-automate preflight-check [flags]
Flags
--airgap
Pass this flag when the environment is airgapped (default: false)--config
Optional config file to use-h, --help
help for preflight-check (default: false)-d, --debug
Enable debug output (default: false)--no-check-version
Disable version check (default: false)--result-json
Write command result as JSON to PATH
See Also
Chef Automate CLI
Run preflight checks specific to migrating from Chef Automate v1
chef-automate preflight-check migrate-from-v1
chef-automate preflight-check [flags]--airgap
Pass this flag when the environment is airgapped (default: false)
--config
Optional config file to use
-h, --help
help for preflight-check (default: false)
-d, --debug
Enable debug output (default: false)
--no-check-version
Disable version check (default: false)
--result-json
Write command result as JSON to PATH
See Also
Chef Automate CLI
Run preflight checks specific to migrating from Chef Automate v1
chef-automate preflight-check migrate-from-v1
Chef Automate CLI
Run preflight checks specific to migrating from Chef Automate v1
Usage
chef-automate preflight-check migrate-from-v1 [flags]
Flags
-r, --delivery-running
Path to delivery-running.json (default: /etc/delivery/delivery-running.json)-s, --delivery-secrets
Path to delivery-secrets.json (default: /etc/delivery/delivery-secrets.json)-h, --help
help for migrate-from-v1 (default: false)--skip-backup-check
Optionally do not check if your Chef Automate v1 installation has backups configured (default = false)
(default: false)--skip-disaster-recovery-check
Optionally do not check if your Chef Automate v1 installation has disaster recovery configured (default = false)
(default: false)--skip-external-es-check
Optionally do not check if your Chef Automate v1 installation has external Elasticsearch configured (default = false)
(default: false)--skip-fips-check
Optionally do not check if your Chef Automate v1 installation has FIPS configured (default = false)
(default: false)--skip-saml-check
Optionally do not check if your Chef Automate v1 installation has SAML configured (default = false)
(default: false)--skip-workflow-check
Optionally do not check if your Chef Automate v1 installation has workflow configured (default = false)
(default: false)--airgap
Pass this flag when the environment is airgapped (default: false)--config
Optional config file to use-d, --debug
Enable debug output (default: false)--no-check-version
Disable version check (default: false)--result-json
Write command result as JSON to PATH
See Also
Perform preflight check
chef-automate provision-infra
chef-automate preflight-check migrate-from-v1 [flags]-r, --delivery-running
Path to delivery-running.json (default: /etc/delivery/delivery-running.json)
-s, --delivery-secrets
Path to delivery-secrets.json (default: /etc/delivery/delivery-secrets.json)
-h, --help
help for migrate-from-v1 (default: false)
--skip-backup-check
Optionally do not check if your Chef Automate v1 installation has backups configured (default = false)
(default: false)
--skip-disaster-recovery-check
Optionally do not check if your Chef Automate v1 installation has disaster recovery configured (default = false)
(default: false)
--skip-external-es-check
Optionally do not check if your Chef Automate v1 installation has external Elasticsearch configured (default = false)
(default: false)
--skip-fips-check
Optionally do not check if your Chef Automate v1 installation has FIPS configured (default = false)
(default: false)
--skip-saml-check
Optionally do not check if your Chef Automate v1 installation has SAML configured (default = false)
(default: false)
--skip-workflow-check
Optionally do not check if your Chef Automate v1 installation has workflow configured (default = false)
(default: false)
--airgap
Pass this flag when the environment is airgapped (default: false)
--config
Optional config file to use
-d, --debug
Enable debug output (default: false)
--no-check-version
Disable version check (default: false)
--result-json
Write command result as JSON to PATH
See Also
Perform preflight check
chef-automate provision-infra
Perform preflight check
Provision infra for Automate HA deployment.
Usage
chef-automate provision-infra [flags]
Flags
--airgap-bundle
Path to an airgap install bundle--channel
Release channel to deploy all services from-h, --help
help for provision-infra (default: false)-d, --debug
Enable debug output (default: false)--no-check-version
Disable version check (default: false)--result-json
Write command result as JSON to PATH
See Also
Chef Automate CLI
chef-automate restart-services
chef-automate provision-infra [flags]--airgap-bundle
Path to an airgap install bundle
--channel
Release channel to deploy all services from
-h, --help
help for provision-infra (default: false)
-d, --debug
Enable debug output (default: false)
--no-check-version
Disable version check (default: false)
--result-json
Write command result as JSON to PATH
See Also
Chef Automate CLI
chef-automate restart-services
Chef Automate CLI
Restart services for a deployment
Usage
chef-automate restart-services [flags]
Flags
-h, --help
help for restart-services (default: false)-d, --debug
Enable debug output (default: false)--no-check-version
Disable version check (default: false)--result-json
Write command result as JSON to PATH
See Also
Chef Automate CLI
chef-automate secrets
chef-automate restart-services [flags]-h, --help
help for restart-services (default: false)
-d, --debug
Enable debug output (default: false)
--no-check-version
Disable version check (default: false)
--result-json
Write command result as JSON to PATH
See Also
Chef Automate CLI
chef-automate secrets
Chef Automate CLI
Set secrets for Automate sudo password and admin password in HA mode.
Usage
chef-automate secrets [flags]
Flags
-h, --help
help for secrets (default: false)-d, --debug
Enable debug output (default: false)--no-check-version
Disable version check (default: false)--result-json
Write command result as JSON to PATH
See Also
Chef Automate CLI
chef-automate service-versions
chef-automate secrets [flags]-h, --help
help for secrets (default: false)
-d, --debug
Enable debug output (default: false)
--no-check-version
Disable version check (default: false)
--result-json
Write command result as JSON to PATH
See Also
Chef Automate CLI
chef-automate service-versions
Chef Automate CLI
Retrieve the versions of the individual Chef Automate services
Usage
chef-automate service-versions [flags]
Flags
-h, --help
help for service-versions (default: false)-d, --debug
Enable debug output (default: false)--no-check-version
Disable version check (default: false)--result-json
Write command result as JSON to PATH
See Also
Chef Automate CLI
chef-automate ssh
chef-automate service-versions [flags]-h, --help
help for service-versions (default: false)
-d, --debug
Enable debug output (default: false)
--no-check-version
Disable version check (default: false)
--result-json
Write command result as JSON to PATH
See Also
Chef Automate CLI
chef-automate ssh
Chef Automate CLI
SSH into Automate HA servers
Usage
chef-automate ssh [flags]
Flags
-h, --help
help for ssh (default: false)--hostname
Automate ha server name to ssh-d, --debug
Enable debug output (default: false)--no-check-version
Disable version check (default: false)--result-json
Write command result as JSON to PATH
See Also
Chef Automate CLI
chef-automate start
chef-automate ssh [flags]-h, --help
help for ssh (default: false)
--hostname
Automate ha server name to ssh
-d, --debug
Enable debug output (default: false)
--no-check-version
Disable version check (default: false)
--result-json
Write command result as JSON to PATH
See Also
Chef Automate CLI
chef-automate start
Chef Automate CLI
Usage
chef-automate start [flags]
Flags
-h, --help
help for start (default: false)-d, --debug
Enable debug output (default: false)--no-check-version
Disable version check (default: false)--result-json
Write command result as JSON to PATH
See Also
Chef Automate CLI
chef-automate status
chef-automate start [flags]-h, --help
help for start (default: false)
-d, --debug
Enable debug output (default: false)
--no-check-version
Disable version check (default: false)
--result-json
Write command result as JSON to PATH
See Also
Chef Automate CLI
chef-automate status
Chef Automate CLI
Retrieve Chef Automate status. Includes status of Automate services.
Usage
chef-automate status [flags]
Flags
-h, --help
help for status (default: false)-w, --wait-for-healthy
Wait until the status response is healthy or the timeout is reached
(default: false)-r, --wait-refresh-interval
How many seconds to wait between polling for status updates (default: 2)-t, --wait-timeout
How many seconds to wait for the status to be healthy before returning an error
(default: 600)-d, --debug
Enable debug output (default: false)--no-check-version
Disable version check (default: false)--result-json
Write command result as JSON to PATH
See Also
Chef Automate CLI
chef-automate stop
chef-automate status [flags]-h, --help
help for status (default: false)
-w, --wait-for-healthy
Wait until the status response is healthy or the timeout is reached
(default: false)
-r, --wait-refresh-interval
How many seconds to wait between polling for status updates (default: 2)
-t, --wait-timeout
How many seconds to wait for the status to be healthy before returning an error
(default: 600)
-d, --debug
Enable debug output (default: false)
--no-check-version
Disable version check (default: false)
--result-json
Write command result as JSON to PATH
See Also
Chef Automate CLI
chef-automate stop
Chef Automate CLI
Stop a running deployment of Automate.
Usage
chef-automate stop [flags]
Flags
-h, --help
help for stop (default: false)-d, --debug
Enable debug output (default: false)--no-check-version
Disable version check (default: false)--result-json
Write command result as JSON to PATH
See Also
Chef Automate CLI
chef-automate system-logs
chef-automate stop [flags]-h, --help
help for stop (default: false)
-d, --debug
Enable debug output (default: false)
--no-check-version
Disable version check (default: false)
--result-json
Write command result as JSON to PATH
See Also
Chef Automate CLI
chef-automate system-logs
Chef Automate CLI
Start streaming logs from the Chef Automate server. Ctrl + c to stop.
Usage
chef-automate system-logs [flags]
Flags
-h, --help
help for system-logs (default: false)-d, --debug
Enable debug output (default: false)--no-check-version
Disable version check (default: false)--result-json
Write command result as JSON to PATH
See Also
Chef Automate CLI
chef-automate test
chef-automate system-logs [flags]-h, --help
help for system-logs (default: false)
-d, --debug
Enable debug output (default: false)
--no-check-version
Disable version check (default: false)
--result-json
Write command result as JSON to PATH
See Also
Chef Automate CLI
chef-automate test
Chef Automate CLI
Run smoke test for Automate HA services.
Usage
chef-automate test [flags]
Flags
--full
Automate ha cluster test full (default: false)-h, --help
help for test (default: false)-d, --debug
Enable debug output (default: false)--no-check-version
Disable version check (default: false)--result-json
Write command result as JSON to PATH
See Also
Chef Automate CLI
chef-automate uninstall
chef-automate test [flags]--full
Automate ha cluster test full (default: false)
-h, --help
help for test (default: false)
-d, --debug
Enable debug output (default: false)
--no-check-version
Disable version check (default: false)
--result-json
Write command result as JSON to PATH
See Also
Chef Automate CLI
chef-automate uninstall
Chef Automate CLI
Uninstall Chef Automate, deleting all data and configuration
Usage
chef-automate uninstall [flags]
Flags
-h, --help
help for uninstall (default: false)--preserve-package-cache
Preserve Habitat package cache (useful for faster reinstall) (default: false)--yes
Uninstall Chef Automate and destroy data without confirmation prompt
(default: false)-d, --debug
Enable debug output (default: false)--no-check-version
Disable version check (default: false)--result-json
Write command result as JSON to PATH
See Also
Chef Automate CLI
chef-automate upgrade
chef-automate uninstall [flags]-h, --help
help for uninstall (default: false)
--preserve-package-cache
Preserve Habitat package cache (useful for faster reinstall) (default: false)
--yes
Uninstall Chef Automate and destroy data without confirmation prompt
(default: false)
-d, --debug
Enable debug output (default: false)
--no-check-version
Disable version check (default: false)
--result-json
Write command result as JSON to PATH
See Also
Chef Automate CLI
chef-automate upgrade
Chef Automate CLI
Usage
chef-automate upgrade COMMAND [flags]
Flags
-h, --help
help for upgrade (default: false)-d, --debug
Enable debug output (default: false)--no-check-version
Disable version check (default: false)--result-json
Write command result as JSON to PATH
See Also
Chef Automate CLI
Run an upgrade of Chef Automate
Get upgrade status of Chef Automate
chef-automate upgrade run
chef-automate upgrade COMMAND [flags]-h, --help
help for upgrade (default: false)
-d, --debug
Enable debug output (default: false)
--no-check-version
Disable version check (default: false)
--result-json
Write command result as JSON to PATH
See Also
Chef Automate CLI
Run an upgrade of Chef Automate
Get upgrade status of Chef Automate
chef-automate upgrade run
Chef Automate CLI
Run an upgrade of Chef Automate
Get upgrade status of Chef Automate
Run an upgrade of Chef Automate
Usage
chef-automate upgrade run [flags]
Flags
--airgap-bundle
Path to an airgap install bundle-h, --help
help for run (default: false)--skip-deploy
will only upgrade and not deploy the bundle (default: false)--upgrade-airgap-bundles
Update Chef Automate both frontend and backend version to install
(default: false)--upgrade-backends
Update Chef Automate backends version to install (default: false)--upgrade-frontends
upgrade Chef Automate HA frontends version to install (default: false)--version
The exact Chef Automate version to install-d, --debug
Enable debug output (default: false)--no-check-version
Disable version check (default: false)--result-json
Write command result as JSON to PATH
See Also
upgrade automate to the latest version
chef-automate upgrade status
chef-automate upgrade run [flags]--airgap-bundle
Path to an airgap install bundle
-h, --help
help for run (default: false)
--skip-deploy
will only upgrade and not deploy the bundle (default: false)
--upgrade-airgap-bundles
Update Chef Automate both frontend and backend version to install
(default: false)
--upgrade-backends
Update Chef Automate backends version to install (default: false)
--upgrade-frontends
upgrade Chef Automate HA frontends version to install (default: false)
--version
The exact Chef Automate version to install
-d, --debug
Enable debug output (default: false)
--no-check-version
Disable version check (default: false)
--result-json
Write command result as JSON to PATH
See Also
upgrade automate to the latest version
chef-automate upgrade status
upgrade automate to the latest version
Get upgrade status of Chef Automate
Usage
chef-automate upgrade status [flags]
Flags
-h, --help
help for status (default: false)-d, --debug
Enable debug output (default: false)--no-check-version
Disable version check (default: false)--result-json
Write command result as JSON to PATH
See Also
upgrade automate to the latest version
chef-automate validate-ha-infrastructure
chef-automate upgrade status [flags]-h, --help
help for status (default: false)
-d, --debug
Enable debug output (default: false)
--no-check-version
Disable version check (default: false)
--result-json
Write command result as JSON to PATH
See Also
upgrade automate to the latest version
chef-automate validate-ha-infrastructure
upgrade automate to the latest version
Validate existing infrastructure of automate HA
Usage
chef-automate validate-ha-infrastructure [flags]
Flags
--airgap-bundle
Path to airgap bundle--habitat-bundle
Path to haitat tar bundle-h, --help
help for validate-ha-infrastructure (default: false)-d, --debug
Enable debug output (default: false)--no-check-version
Disable version check (default: false)--result-json
Write command result as JSON to PATH
See Also
Chef Automate CLI
chef-automate version
chef-automate validate-ha-infrastructure [flags]--airgap-bundle
Path to airgap bundle
--habitat-bundle
Path to haitat tar bundle
-h, --help
help for validate-ha-infrastructure (default: false)
-d, --debug
Enable debug output (default: false)
--no-check-version
Disable version check (default: false)
--result-json
Write command result as JSON to PATH
See Also
Chef Automate CLI
chef-automate version
Chef Automate CLI
Show the CLI version.
Usage
chef-automate version [flags]
Flags
--connection-timeout
Most time to wait to connect to service (default: 0s)--endpoint
The endpoint the service is listening on-h, --help
help for version (default: false)-v, --verbose
Show additional version information (default: false)-d, --debug
Enable debug output (default: false)--no-check-version
Disable version check (default: false)--result-json
Write command result as JSON to PATH
See Also
Chef Automate CLI
chef-automate workspace
chef-automate version [flags]--connection-timeout
Most time to wait to connect to service (default: 0s)
--endpoint
The endpoint the service is listening on
-h, --help
help for version (default: false)
-v, --verbose
Show additional version information (default: false)
-d, --debug
Enable debug output (default: false)
--no-check-version
Disable version check (default: false)
--result-json
Write command result as JSON to PATH
See Also
Chef Automate CLI
chef-automate workspace
Chef Automate CLI
Set up Automate HA cluster workspace.
Usage
chef-automate workspace [flags]
Flags
-h, --help
help for workspace (default: false)-d, --debug
Enable debug output (default: false)--no-check-version
Disable version check (default: false)--result-json
Write command result as JSON to PATH
See Also
Chef Automate CLI
Error Codes
chef-automate workspace [flags]-h, --help
help for workspace (default: false)
-d, --debug
Enable debug output (default: false)
--no-check-version
Disable version check (default: false)
--result-json
Write command result as JSON to PATH
See Also
Chef Automate CLI
Error Codes
Chef Automate CLI
If chef-automate encounters an error during execution, it exits with a non-zero
error code. Here’s what our error codes mean:
| Exit Code | Name | Description |
|---|---|---|
| 68 | HabUserAccessError | Unable to access file or directory with the hab user |
| 69 | SnapshotChecksumMismatchError | A file in the snapshot did not have the expected checksum |
| 70 | DatabaseError | An issue occurred with the database |
| 71 | CommandExecutionError | An issue occurred when running an executable command |
| 72 | TraceError | An issue occurred when attempting to trace the request |
| 73 | ProfileError | An issue occurred when attempting to profile the request |
| 74 | HabCommandError | An issue occurred when running a hab command |
| 75 | HabAPIError | An issue occurred when attempting to query the Habitat API |
| 76 | GatherLogsError | Unable to complete log gathering |
| 77 | PackageInstallError | Unable to install the habitat package |
| 78 | TimedOutError | Timed out waiting for the operation to complete |
| 79 | BackupRestoreError | Unable to restore backup |
| 80 | ServiceUnloadError | Unable to unload the habitat service |
| 81 | ServiceStartError | Unable to start the habitat service |
| 82 | AirgapUnpackInstallBundleError | An issue occurred when attempting to unpack the airgap install bundle |
| 83 | AirgapCreateInstallBundleError | An issue occurred when attempting to create the airgap install bundle |
| 84 | DownloadError | An issue occurred when attempting to perform a file download |
| 85 | UninstallError | An issue occurred when attempting to uninstall Chef Automate |
| 86 | BackupError | An issue occurred when creating or restoring a backup |
| 87 | UpgradeError | An issue occurred during the upgrade |
| 88 | MarshalError | Unable to convert or deconvert a textual representation of an internal object |
| 89 | LicenseError | The license is invalid, expired or incomplete |
| 90 | FileAccessError | Unable to access the file or directory |
| 91 | DiagnosticsError | One or more diagnostics checks failed |
| 92 | MustBeRootError | The command must be run as the root user |
| 93 | ConfigError | The configuration is invalid |
| 94 | DeployError | Unable to install, configure and start the service |
| 95 | PreflightError | One or more preflight checks failed |
| 96 | InvalidCommandArgsError | The arguments provided are invalid |
| 97 | UnhealthyStatusError | System status is unhealthy |
| 98 | DeploymentServiceCallError | A request to the deployment-service failed |
| 99 | DeploymentServiceUnreachableError | Unable to make a request to the deployment-service |
| 100 | APIError | An API error occurred during execution |
| 112 | UpdateExecError | An issue occurred when trying to run an auto-updated CLI executable |
| 113 | UnknownError | An unknown issue occurred during execution |
| 114 | APIUnreachableError | Could not connect to Automate API |
| 115 | UnknownError | Failed to upgrade IAM to v2 |
| 116 | UnknownError | Failed to reset IAM state to v1 |
Was this page helpful?