Skip to content

Commit 91dc44d

Browse files
Remove mentions of sozuctl
1 parent 3727f14 commit 91dc44d

File tree

13 files changed

+32
-37
lines changed

13 files changed

+32
-37
lines changed

CONTRIBUTING.md

Lines changed: 2 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -18,11 +18,10 @@ The proxy is designed to have a minimal core that you drive through external too
1818
There are 4 Rust crates in the repository:
1919

2020
- `lib` is the event loop handling network communication and parsing. Workers are small wrappers around this
21-
- `bin` is the main executable, providing a master/workers multiprocess architecture and exposing a unix socket to receive configuration changes
21+
- `bin` is the main executable, providing a master/workers multiprocess architecture and exposing a unix socket to receive configuration changes. It also contains the command line.
2222
- `command` is a library wrapping the communication protocol of the unix socket. You'd typically use it to make tools to drive the proxy
23-
- `ctl` is the `sozuctl` command line application provided with the proxy, to interact with it at runtime
2423

25-
The easiest way to contribute would be to work on `sozuctl` or on external tools
24+
The easiest way to contribute would be to work on the command line (`cli.rs`) or on external tools
2625
using the `command` library. `lib` can be complex since you need familiarity with
2726
the event loop handling, but the parsers and protocol are well separated. `bin` is
2827
mostly plumbing to handle command line options, handle workers and dispatching

README.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -21,7 +21,7 @@ To get started check out our [documentation](./doc/README.md) !
2121

2222
Copyright (C) 2015-2021 Geoffroy Couprie, Clément Delafargue and Clever Cloud
2323

24-
### sozu-lib, sozu and sozuctl
24+
### sozu-lib, sozu
2525

2626
This program is free software: you can redistribute it and/or modify it under
2727
the terms of the GNU Affero General Public License as published by the Free

bin/config.toml

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@
44

55
# path to a file sozu can use to load an initial configuration state for its
66
# routing. You can generate this file from sozu's current routing by running
7-
# the command `sozuctl state save -f state.json`
7+
# the command `sozu state save -f state.json`
88
# this must be RELATIVE to config.toml
99
# saved_state = "./state.json"
1010

@@ -87,7 +87,7 @@ max_connections = 500
8787
# defaults to 16393 (minimum size for HTTP/2 is a 16384 bytes frame + 9 bytes of header
8888
buffer_size = 16393
8989

90-
# how much time (in milliseconds) sozuctl will wait for a command to complete.
90+
# how much time (in milliseconds) sozu command line will wait for a command to complete.
9191
# Defaults to 1000 milliseconds
9292
# ctl_command_timeout = 1000
9393

@@ -127,8 +127,8 @@ buffer_size = 16393
127127
activate_listeners = true
128128

129129
# various statistics can be sent to a server that supports the statsd protocol
130-
# You can see those statistics with sozuctl, like this: `sozuctl metrics` or
131-
# `sozuctl metrics --json` for machine consumption
130+
# You can see those statistics with the command line, like this: `sozu metrics get` or
131+
# `sozu metrics get --json` for machine consumption
132132
#
133133
#[metrics]
134134
# address = "127.0.0.1:8125"

bin/src/cli.rs

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -92,7 +92,7 @@ pub enum SubCmd {
9292
max_command_buffer_size: Option<usize>,
9393
},
9494

95-
// sozuctl commands
95+
// sozu command line
9696
#[clap(name = "shutdown", about = "shuts down the proxy")]
9797
Shutdown {
9898
#[clap(long = "hard", help = "do not wait for connections to finish")]

doc/configure.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -22,7 +22,7 @@ Parameters in the global section allow you to define the global settings shared
2222
| `log_level` | possible values are | `debug`, `trace`, `error`, `warn`, `info`|
2323
| `log_target` | possible values are | `stdout, tcp or udp address` |
2424
| `log_access_target` | possible values are (if activated, sends access logs to a separate target) | `stdout`, `tcp` or `udp address` |
25-
| `command_socket` | path to the unix socket command (see sozuctl for more information) | |
25+
| `command_socket` | path to the unix socket command | |
2626
| `command_buffer_size` | size, in bytes, of the buffer used by the main process to handle commands. | |
2727
| `max_command_buffer_size` | maximum size of the buffer used by the main process to handle commands. | |
2828
| `worker_count` | number of workers | |
@@ -32,7 +32,7 @@ Parameters in the global section allow you to define the global settings shared
3232
| `max_buffers` | maximum number of buffers use to proxying | |
3333
| `min_buffers` | minimum number of buffers preallocated for proxying | |
3434
| `buffer_size` | size, in bytes, of requests buffer use by the workers | |
35-
| `ctl_command_timeout` | maximum time sozuctl will wait for a command to complete | |
35+
| `ctl_command_timeout` | maximum time the command line will wait for a command to complete | |
3636
| `pid_file_path` | stores the pid in a specific file location | |
3737
| `front_timeout` | maximum time of inactivity for a front socket | |
3838
| `connect_timeout` | maximum time of inactivity for a request to connect | |

doc/debugging_strategies.md

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@ Sozu provides logs and metrics allowing detection of most production issues.
44

55
## Gathering information
66

7-
### Dumping the state through sozuctl
7+
### Dumping the state through sozu command line
88

99
It is useful to gather information on the configuration state in a production system.
1010
Here are some commands you can use to take a snapshot of the current state:
@@ -39,7 +39,7 @@ unless you set the compilation features `logs-debug` and `logs-trace`.
3939

4040
Various metrics are generated while sozu is running. They can be accessed in two ways:
4141

42-
* through `sozuctl metrics`, which will display metrics for the main process and workers. Counters are refreshed between each call
42+
* through `sozu metrics get`, which will display metrics for the main process and workers. Counters are refreshed between each call
4343
* by UDP, following the statsd protocol (optionally with support for InfluxDB's tags)
4444

4545
Here is how you can set up metrics with statsd in the configuration file:
@@ -232,13 +232,13 @@ Normal traffic (`sozu.http.requests`) drops while 404 (`sozu.http.404.errors`) a
232232
Check the configuration state with;
233233

234234
```bash
235-
sozuctl -c /etc/config.toml query clusters
235+
sozu -c /etc/config.toml query clusters
236236
```
237237

238238
And, for the complete configuration for a specific cluster id:
239239

240240
```bash
241-
sozuctl -c /etc/config.toml query clusters -i cluster_id
241+
sozu -c /etc/config.toml query clusters -i cluster_id
242242
```
243243

244244
### Backend server unavailable

doc/getting_started.md

Lines changed: 1 addition & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -9,15 +9,11 @@ After you did that, `Rust` should be fully installed.
99

1010
## Setting up Sōzu
1111

12-
### Required dependencies
13-
14-
- libssl-dev
15-
1612
### Install
1713

1814
`sozu` is published on [crates.io][cr].
1915

20-
To install them, you only have to do `cargo install sozu sozuctl`.
16+
To install them, you only have to do `cargo install sozu`.
2117

2218
They will be built and available in the `~/.cargo/bin` folder.
2319

doc/how_to_use.md

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -4,11 +4,11 @@
44
55
## Run it
66

7-
If you used the `cargo install` way, `sozu` and `sozuctl` are already in your `$PATH`.
7+
If you used the `cargo install` way, `sozu` is already in your `$PATH`.
88

99
`sozu start -c <path/to/your/config.toml>`
1010

11-
However, if you built the project from source, `sozu` and `sozuctl` are placed in the `target` directory.
11+
However, if you built the project from source, `sozu` is placed in the `target` directory.
1212

1313
`./target/release/sozu start -c <path/to/your/config.toml>`
1414

@@ -66,9 +66,9 @@ If `/my/custom/config.toml` is the path and name of your custom configuration fi
6666

6767
`docker run -v /my/custom:/etc/sozu sozu`
6868

69-
### Using sozuctl with the docker container
69+
### Using sozu command line with the docker container
7070

71-
To use `sozuctl` CLI from the host with the docker container you have to bind `/run/sozu` with the host by using a docker volume:
71+
To use `sozu` CLI from the host with the docker container you have to bind `/run/sozu` with the host by using a docker volume:
7272

7373
`docker run -v /run/sozu:/run/sozu sozu`
7474

doc/managing_workers.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -7,7 +7,7 @@ How do we solve this challenge? Unix sockets and channels.
77

88
## Architecture
99

10-
`sozuctl` sends commands on a unix socket.
10+
`sozu` command line sends commands on a unix socket.
1111
In the `command::start_server()` function of the main process,
1212
there is a thread running in the background where a unix listener accepts new
1313
connection and spawns client loops.

doc/recipes.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -30,7 +30,7 @@ Wants=network-online.target
3030
3131
[Service]
3232
ExecStart=/usr/bin/sozu start --config /etc/sozu/config.toml
33-
ExecReload=/usr/bin/sozuctl --config /etc/sozu/config.toml reload
33+
ExecReload=/usr/bin/sozu --config /etc/sozu/config.toml reload
3434
Restart=on-failure
3535
User=sozu
3636
AmbientCapabilities=CAP_NET_BIND_SERVICE

0 commit comments

Comments
 (0)