From 7e1f7f4cdc0c5f24c75adcee139b3420a8584b09 Mon Sep 17 00:00:00 2001 From: devonh Date: Fri, 26 Apr 2024 18:12:17 +0000 Subject: deploy: 0fd6b269d32340c367a67ee34b963c32da080697 --- develop/print.html | 24 ++++++++++++------------ 1 file changed, 12 insertions(+), 12 deletions(-) (limited to 'develop/print.html') diff --git a/develop/print.html b/develop/print.html index 9f127d63d7..7c967bcb21 100644 --- a/develop/print.html +++ b/develop/print.html @@ -408,9 +408,9 @@ or not to report usage statistics (hostname, Synapse version, uptime, total users, etc.) to the developers via the --report-stats argument.

This command will generate you a config file that you can then customise, but it will also generate a set of keys for you. These keys will allow your homeserver to -identify itself to other homeserver, so don't lose or delete them. It would be +identify itself to other homeservers, so don't lose or delete them. It would be wise to back them up somewhere safe. (If, for whatever reason, you do need to -change your homeserver's keys, you may find that other homeserver have the +change your homeserver's keys, you may find that other homeservers have the old key cached. If you update the signing key, you should change the name of the key in the <server name>.signing.key file (the second word) to something different. See the spec for more information on key management).

@@ -780,7 +780,7 @@ can read more about that Porting from SQLite

Overview

The script synapse_port_db allows porting an existing synapse server -backed by SQLite to using PostgreSQL. This is done in as a two phase +backed by SQLite to using PostgreSQL. This is done as a two phase process:

  1. Copy the existing SQLite database to a separate location and run @@ -9771,9 +9771,9 @@ will be used to break the search term into words. (See the
  2. If unavailable, then runs of ASCII characters, numbers, underscores, and hyphens are considered words.
    3. -

    The queries for PostgreSQL and SQLite are detailed below, by their overall goal +

    The queries for PostgreSQL and SQLite are detailed below, but their overall goal is to find matching users, preferring users who are "real" (e.g. not bots, -not deactivated). It is assumed that real users will have an display name and +not deactivated). It is assumed that real users will have a display name and avatar set.

    PostgreSQL

    The above words are then transformed into two queries:

    @@ -9858,8 +9858,8 @@ though it will always hide it from clients.

    delete the last message in a room. It will, however, hide it from clients.

    Server configuration

    -

    Support for this feature can be enabled and configured by adding a the -retention in the Synapse configuration file (see +

    Support for this feature can be enabled and configured by adding the +retention option in the Synapse configuration file (see configuration manual).

    To enable support for message retention policies, set the setting enabled in this section to true.

    @@ -9909,7 +9909,7 @@ which policy's max_lifetime is lower or equal to 3 days. policy's max_lifetime is greater than a week.

    Note that this example is tailored to show different configurations and -features slightly more jobs than it's probably necessary (in practice, a +features slightly more jobs than is probably necessary (in practice, a server admin would probably consider it better to replace the two last jobs with one that runs once a day and handles rooms which policy's max_lifetime is greater than 3 days).

    @@ -11849,7 +11849,7 @@ after setting this option in the shared configuration!

    This style of configuration supersedes the legacy synapse.app.appservice worker application type.

    Push Notifications

    -

    You can designate generic worker to sending push notifications to +

    You can designate generic workers to send push notifications to a push gateway such as sygnal and email.

    This will stop the main process sending push notifications.

    @@ -12240,7 +12240,7 @@ run against the database.

    total_duration_ms how long the background process has been running, not including time spent sleeping. average_items_per_ms how many items are processed per millisecond based on an exponential average.

    Enabled

    -

    This API allow pausing background updates.

    +

    This API allows pausing background updates.

    Background updates should not be paused for significant periods of time, as this can affect the performance of Synapse.

    Note: This won't persist over restarts.

    @@ -13067,7 +13067,7 @@ the Ma }

    Edit Room Membership API

    -

    This API allows an administrator to join an user account with a given user_id +

    This API allows an administrator to join a user account with a given user_id to a room with a given room_id_or_alias. You can only modify the membership of local users. The server administrator must be in the room and have permission to invite users.

    @@ -16480,7 +16480,7 @@ variable. The default is 0.5, which can be decreased to reduce RAM usage in memory constrained environments, or increased if performance starts to degrade.

    However, degraded performance due to a low cache factor, common on -machines with slow disks, often leads to explosions in memory use due +machines with slow disks, often leads to explosions in memory use due to backlogged requests. In this case, reducing the cache factor will make things worse. Instead, try increasing it drastically. 2.0 is a good starting value.

    -- cgit 1.4.1