2015-09-25 19:00:14 +00:00
|
|
|
---
|
2020-02-06 23:45:31 +00:00
|
|
|
layout: docs
|
|
|
|
|
page_title: 'Commands: node config'
|
|
|
|
|
description: |
|
2018-03-22 17:56:06 +00:00
|
|
|
The node config command is used to view or modify client configuration.
|
2015-09-25 19:00:14 +00:00
|
|
|
---
|
|
|
|
|
|
2018-03-22 17:56:06 +00:00
|
|
|
# Command: node config
|
2015-09-25 19:00:14 +00:00
|
|
|
|
2018-03-22 17:56:06 +00:00
|
|
|
The `node config` command is used to view or modify client configuration
|
2015-09-25 19:00:14 +00:00
|
|
|
details. This command only works on client nodes, and can be used to update
|
|
|
|
|
the running client configurations it supports.
|
|
|
|
|
|
|
|
|
|
## Usage
|
|
|
|
|
|
2019-10-22 13:44:00 +00:00
|
|
|
```plaintext
|
2018-03-22 17:56:06 +00:00
|
|
|
nomad node config [options]
|
2015-09-25 19:00:14 +00:00
|
|
|
```
|
|
|
|
|
|
|
|
|
|
The arguments behave differently depending on the flags given. See each flag's
|
|
|
|
|
description below for specific usage information and requirements.
|
|
|
|
|
|
|
|
|
|
## General Options
|
|
|
|
|
|
2020-11-19 18:02:48 +00:00
|
|
|
@include 'general_options_no_namespace.mdx'
|
2015-09-25 19:00:14 +00:00
|
|
|
|
2018-03-22 17:56:06 +00:00
|
|
|
## Node Config Options
|
2015-09-25 19:00:14 +00:00
|
|
|
|
2019-10-22 13:44:00 +00:00
|
|
|
- `-servers`: List the client's known servers. Client nodes do not participate
|
2015-09-25 19:00:14 +00:00
|
|
|
in the gossip pool, and instead register with these servers periodically over
|
|
|
|
|
the network. The initial value of this list may come from configuration files
|
2019-10-22 13:44:00 +00:00
|
|
|
using the [`servers`] configuration option in the client block.
|
2015-09-25 19:00:14 +00:00
|
|
|
|
2020-11-19 21:38:08 +00:00
|
|
|
If ACLs are enabled, this option requires a token with the 'agent:read'
|
|
|
|
|
capability.
|
|
|
|
|
|
2019-10-22 13:44:00 +00:00
|
|
|
- `-update-servers`: Updates the client's server list using the provided
|
2015-09-25 19:00:14 +00:00
|
|
|
arguments. Multiple server addresses may be passed using multiple arguments.
|
|
|
|
|
When updating the servers list, you must specify ALL of the server nodes you
|
|
|
|
|
wish to configure. The set is updated atomically. It is an error to specify
|
2016-01-29 05:16:02 +00:00
|
|
|
this flag without any server addresses. If you do _not_ specify a port for each
|
|
|
|
|
server address, the default port `4647` will be used.
|
2015-09-25 19:00:14 +00:00
|
|
|
|
2020-11-19 21:38:08 +00:00
|
|
|
If ACLs are enabled, this option requires a token with the 'agent:write'
|
|
|
|
|
capability.
|
|
|
|
|
|
2015-09-25 19:00:14 +00:00
|
|
|
## Examples
|
|
|
|
|
|
|
|
|
|
Query the currently known servers:
|
|
|
|
|
|
2020-05-18 20:53:06 +00:00
|
|
|
```shell-session
|
|
|
|
|
$ nomad node config -servers
|
2015-09-25 19:00:14 +00:00
|
|
|
server1:4647
|
|
|
|
|
server2:4647
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
Update the list of servers:
|
|
|
|
|
|
2020-05-18 20:53:06 +00:00
|
|
|
```shell-session
|
|
|
|
|
$ nomad node config -update-servers server1:4647 server2:4647 server3:4647 server4
|
2020-05-01 20:02:21 +00:00
|
|
|
|
2015-09-25 19:00:14 +00:00
|
|
|
```
|
2019-10-22 13:44:00 +00:00
|
|
|
|
2023-01-25 17:31:14 +00:00
|
|
|
[`servers`]: /nomad/docs/configuration/client#servers
|
