mirror of
https://github.com/matrix-org/dendrite
synced 2024-12-13 06:42:46 +00:00
Updated instructions and references to monolith to their new names (#2994)
Currently, the documentation makes use of the old names for the binary and configuration files. This updates the documentation so that users can follow the guide without issues again. These changes don't require any go unit tests because it does not modify any golang code. Signed-off-by: `Robin Westerik <gh@westerik.me>`
This commit is contained in:
parent
6b1c9eafa9
commit
7cde99a7a7
9 changed files with 18 additions and 18 deletions
|
@ -71,10 +71,10 @@ $ ./bin/generate-keys --tls-cert server.crt --tls-key server.key
|
||||||
|
|
||||||
# Copy and modify the config file - you'll need to set a server name and paths to the keys
|
# Copy and modify the config file - you'll need to set a server name and paths to the keys
|
||||||
# at the very least, along with setting up the database connection strings.
|
# at the very least, along with setting up the database connection strings.
|
||||||
$ cp dendrite-sample.monolith.yaml dendrite.yaml
|
$ cp dendrite-sample.yaml dendrite.yaml
|
||||||
|
|
||||||
# Build and run the server:
|
# Build and run the server:
|
||||||
$ ./bin/dendrite-monolith-server --tls-cert server.crt --tls-key server.key --config dendrite.yaml
|
$ ./bin/dendrite --tls-cert server.crt --tls-key server.key --config dendrite.yaml
|
||||||
|
|
||||||
# Create an user account (add -admin for an admin user).
|
# Create an user account (add -admin for an admin user).
|
||||||
# Specify the localpart only, e.g. 'alice' for '@alice:domain.com'
|
# Specify the localpart only, e.g. 'alice' for '@alice:domain.com'
|
||||||
|
|
|
@ -9,7 +9,7 @@ import (
|
||||||
)
|
)
|
||||||
|
|
||||||
// This is an instrumented main, used when running integration tests (sytest) with code coverage.
|
// This is an instrumented main, used when running integration tests (sytest) with code coverage.
|
||||||
// Compile: go test -c -race -cover -covermode=atomic -o monolith.debug -coverpkg "github.com/matrix-org/..." ./cmd/dendrite-monolith-server
|
// Compile: go test -c -race -cover -covermode=atomic -o monolith.debug -coverpkg "github.com/matrix-org/..." ./cmd/dendrite
|
||||||
// Run the monolith: ./monolith.debug -test.coverprofile=/somewhere/to/dump/integrationcover.out DEVEL --config dendrite.yaml
|
// Run the monolith: ./monolith.debug -test.coverprofile=/somewhere/to/dump/integrationcover.out DEVEL --config dendrite.yaml
|
||||||
// Generate HTML with coverage: go tool cover -html=/somewhere/where/there/is/integrationcover.out -o cover.html
|
// Generate HTML with coverage: go tool cover -html=/somewhere/where/there/is/integrationcover.out -o cover.html
|
||||||
// Source: https://dzone.com/articles/measuring-integration-test-coverage-rate-in-pouchc
|
// Source: https://dzone.com/articles/measuring-integration-test-coverage-rate-in-pouchc
|
||||||
|
|
|
@ -15,7 +15,7 @@ Dendrite contains an embedded profiler called `pprof`, which is a part of the st
|
||||||
To enable the profiler, start Dendrite with the `PPROFLISTEN` environment variable. This variable specifies which address and port to listen on, e.g.
|
To enable the profiler, start Dendrite with the `PPROFLISTEN` environment variable. This variable specifies which address and port to listen on, e.g.
|
||||||
|
|
||||||
```
|
```
|
||||||
PPROFLISTEN=localhost:65432 ./bin/dendrite-monolith-server ...
|
PPROFLISTEN=localhost:65432 ./bin/dendrite ...
|
||||||
```
|
```
|
||||||
|
|
||||||
If pprof has been enabled successfully, a log line at startup will show that pprof is listening:
|
If pprof has been enabled successfully, a log line at startup will show that pprof is listening:
|
||||||
|
|
|
@ -14,8 +14,8 @@ index 8f0e209c..ad057e52 100644
|
||||||
|
|
||||||
$output->diag( "Starting monolith server" );
|
$output->diag( "Starting monolith server" );
|
||||||
my @command = (
|
my @command = (
|
||||||
- $self->{bindir} . '/dendrite-monolith-server',
|
- $self->{bindir} . '/dendrite',
|
||||||
+ $self->{bindir} . '/dendrite-monolith-server', '--test.coverprofile=' . $self->{hs_dir} . '/integrationcover.log', "DEVEL",
|
+ $self->{bindir} . '/dendrite', '--test.coverprofile=' . $self->{hs_dir} . '/integrationcover.log', "DEVEL",
|
||||||
'--config', $self->{paths}{config},
|
'--config', $self->{paths}{config},
|
||||||
'--http-bind-address', $self->{bind_host} . ':' . $self->unsecure_port,
|
'--http-bind-address', $self->{bind_host} . ':' . $self->unsecure_port,
|
||||||
'--https-bind-address', $self->{bind_host} . ':' . $self->secure_port,
|
'--https-bind-address', $self->{bind_host} . ':' . $self->secure_port,
|
||||||
|
@ -27,9 +27,9 @@ index f009332b..7ea79869 100755
|
||||||
echo >&2 "--- Building dendrite from source"
|
echo >&2 "--- Building dendrite from source"
|
||||||
cd /src
|
cd /src
|
||||||
mkdir -p $GOBIN
|
mkdir -p $GOBIN
|
||||||
-go install -v ./cmd/dendrite-monolith-server
|
-go install -v ./cmd/dendrite
|
||||||
+# go install -v ./cmd/dendrite-monolith-server
|
+# go install -v ./cmd/dendrite
|
||||||
+go test -c -cover -covermode=atomic -o $GOBIN/dendrite-monolith-server -coverpkg "github.com/matrix-org/..." ./cmd/dendrite-monolith-server
|
+go test -c -cover -covermode=atomic -o $GOBIN/dendrite -coverpkg "github.com/matrix-org/..." ./cmd/dendrite
|
||||||
go install -v ./cmd/generate-keys
|
go install -v ./cmd/generate-keys
|
||||||
cd -
|
cd -
|
||||||
```
|
```
|
||||||
|
|
|
@ -49,7 +49,7 @@ tracing:
|
||||||
then run the monolith server:
|
then run the monolith server:
|
||||||
|
|
||||||
```
|
```
|
||||||
./dendrite-monolith-server --tls-cert server.crt --tls-key server.key --config dendrite.yaml
|
./dendrite --tls-cert server.crt --tls-key server.key --config dendrite.yaml
|
||||||
```
|
```
|
||||||
|
|
||||||
## Checking traces
|
## Checking traces
|
||||||
|
|
|
@ -28,11 +28,11 @@ The resulting binaries will be placed in the `bin` subfolder.
|
||||||
You can install the Dendrite monolith binary into `$GOPATH/bin` by using `go install`:
|
You can install the Dendrite monolith binary into `$GOPATH/bin` by using `go install`:
|
||||||
|
|
||||||
```sh
|
```sh
|
||||||
go install ./cmd/dendrite-monolith-server
|
go install ./cmd/dendrite
|
||||||
```
|
```
|
||||||
|
|
||||||
Alternatively, you can specify a custom path for the binary to be written to using `go build`:
|
Alternatively, you can specify a custom path for the binary to be written to using `go build`:
|
||||||
|
|
||||||
```sh
|
```sh
|
||||||
go build -o /usr/local/bin/ ./cmd/dendrite-monolith-server
|
go build -o /usr/local/bin/ ./cmd/dendrite
|
||||||
```
|
```
|
||||||
|
|
|
@ -11,11 +11,11 @@ permalink: /installation/install/monolith
|
||||||
You can install the Dendrite monolith binary into `$GOPATH/bin` by using `go install`:
|
You can install the Dendrite monolith binary into `$GOPATH/bin` by using `go install`:
|
||||||
|
|
||||||
```sh
|
```sh
|
||||||
go install ./cmd/dendrite-monolith-server
|
go install ./cmd/dendrite
|
||||||
```
|
```
|
||||||
|
|
||||||
Alternatively, you can specify a custom path for the binary to be written to using `go build`:
|
Alternatively, you can specify a custom path for the binary to be written to using `go build`:
|
||||||
|
|
||||||
```sh
|
```sh
|
||||||
go build -o /usr/local/bin/ ./cmd/dendrite-monolith-server
|
go build -o /usr/local/bin/ ./cmd/dendrite
|
||||||
```
|
```
|
||||||
|
|
|
@ -9,10 +9,10 @@ permalink: /installation/start/monolith
|
||||||
# Starting the monolith
|
# Starting the monolith
|
||||||
|
|
||||||
Once you have completed all of the preparation and installation steps,
|
Once you have completed all of the preparation and installation steps,
|
||||||
you can start your Dendrite monolith deployment by starting the `dendrite-monolith-server`:
|
you can start your Dendrite monolith deployment by starting `dendrite`:
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
./dendrite-monolith-server -config /path/to/dendrite.yaml
|
./dendrite -config /path/to/dendrite.yaml
|
||||||
```
|
```
|
||||||
|
|
||||||
By default, Dendrite will listen HTTP on port 8008. If you want to change the addresses
|
By default, Dendrite will listen HTTP on port 8008. If you want to change the addresses
|
||||||
|
@ -20,7 +20,7 @@ or ports that Dendrite listens on, you can use the `-http-bind-address` and
|
||||||
`-https-bind-address` command line arguments:
|
`-https-bind-address` command line arguments:
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
./dendrite-monolith-server -config /path/to/dendrite.yaml \
|
./dendrite -config /path/to/dendrite.yaml \
|
||||||
-http-bind-address 1.2.3.4:12345 \
|
-http-bind-address 1.2.3.4:12345 \
|
||||||
-https-bind-address 1.2.3.4:54321
|
-https-bind-address 1.2.3.4:54321
|
||||||
```
|
```
|
||||||
|
|
|
@ -11,7 +11,7 @@ Type=simple
|
||||||
User=dendrite
|
User=dendrite
|
||||||
Group=dendrite
|
Group=dendrite
|
||||||
WorkingDirectory=/opt/dendrite/
|
WorkingDirectory=/opt/dendrite/
|
||||||
ExecStart=/opt/dendrite/bin/dendrite-monolith-server
|
ExecStart=/opt/dendrite/bin/dendrite
|
||||||
Restart=always
|
Restart=always
|
||||||
LimitNOFILE=65535
|
LimitNOFILE=65535
|
||||||
|
|
||||||
|
|
Loading…
Reference in a new issue