diff --git a/platform/hosting/self-managed/bare-metal.mdx b/platform/hosting/self-managed/bare-metal.mdx index fb1e573fb..878686dfa 100644 --- a/platform/hosting/self-managed/bare-metal.mdx +++ b/platform/hosting/self-managed/bare-metal.mdx @@ -17,20 +17,23 @@ Before you start deploying W&B, refer to the [reference architecture](/platform/ ## MySQL database -W&B does not recommend using MySQL 5.7. If you are using MySQL 5.7, migrate to MySQL 8 for best compatibility with latest versions of W&B Server. The W&B Server currently only supports `MySQL 8` versions `8.0.28` and above. +MySQL v8.0.x is required, v8.0.32 or newer; v8.0.44 or newer is recommended. +Aurora MySQL 3.x are supported, must be v3.05.2 or newer. -Satisfy the conditions below if you run W&B Server MySQL 8.0 or when you upgrade from MySQL 5.7 to 8.0: +Configure MySQL with these settings: ``` binlog_format = 'ROW' +binlog_row_image = 'MINIMAL' +innodb_flush_log_at_trx_commit = 1 innodb_online_alter_log_max_size = 268435456 +max_prepared_stmt_count = 1048576 +sort_buffer_size = '67108864' sync_binlog = 1 -innodb_flush_log_at_trx_commit = 1 -binlog_row_image = 'MINIMAL' ``` -Due to some changes in the way that MySQL 8.0 handles `sort_buffer_size`, you might need to update the `sort_buffer_size` parameter from its default value of `262144`. The recommendation is to set the value to `67108864` (64MiB) to ensure that MySQL works efficiently with W&B. MySQL supports this configuration starting with v8.0.28. +These settings have been validated by W&B. ### Database considerations diff --git a/platform/hosting/self-managed/ref-arch.mdx b/platform/hosting/self-managed/ref-arch.mdx index b8b0df30a..7f3400f5a 100644 --- a/platform/hosting/self-managed/ref-arch.mdx +++ b/platform/hosting/self-managed/ref-arch.mdx @@ -76,7 +76,7 @@ W&B requires object storage with pre-signed URL and CORS support, deployed in on | Software | Minimum version | | ------------ | -------------------------------------------- | | Kubernetes | v1.29 | -| MySQL | v8.0.x releases, must be v8.0.28 or newer| +| MySQL | v8.0.x is required, v8.0.32 or newer; v8.0.44 or newer is recommended.
Aurora MySQL 3.x releases, must be v3.05.2 or newer | | Redis | v7.x | ### Networking