4a1fa67f26
I apologize in advance for the rather long PR, but unfortunately there is not an easy way to break this up into smaller chunks. This separates the agent configuration into smaller, more consumable pieces just like the job specification.
58 lines
1.7 KiB
Plaintext
58 lines
1.7 KiB
Plaintext
---
|
|
layout: "docs"
|
|
page_title: "Commands: client-config"
|
|
sidebar_current: "docs-commands-client-config"
|
|
description: >
|
|
The client-config command is used to view or modify client configuration.
|
|
---
|
|
|
|
# Command: client-config
|
|
|
|
The `client-config` command is used to view or modify client configuration
|
|
details. This command only works on client nodes, and can be used to update
|
|
the running client configurations it supports.
|
|
|
|
## Usage
|
|
|
|
```
|
|
nomad client-config [options]
|
|
```
|
|
|
|
The arguments behave differently depending on the flags given. See each flag's
|
|
description below for specific usage information and requirements.
|
|
|
|
## General Options
|
|
|
|
<%= partial "docs/commands/_general_options" %>
|
|
|
|
## Client Config Options
|
|
|
|
* `-servers`: List the client's known servers. Client nodes do not participate
|
|
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
|
|
using the [`servers`](/docs/agent/configuration/client.html#servers)
|
|
configuration option in the client block.
|
|
|
|
* `-update-servers`: Updates the client's server list using the provided
|
|
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
|
|
this flag without any server addresses. If you do _not_ specify a port for each
|
|
server address, the default port `4647` will be used.
|
|
|
|
## Examples
|
|
|
|
Query the currently known servers:
|
|
|
|
```
|
|
$ nomad client-config -servers
|
|
server1:4647
|
|
server2:4647
|
|
```
|
|
|
|
Update the list of servers:
|
|
|
|
```
|
|
$ nomad client-config -update-servers server1:4647 server2:4647 server3:4647 server4
|
|
```
|