From 8bbfbc61be357bd7da6a9e4a10806c3a3c8ecd4e Mon Sep 17 00:00:00 2001
From: owensmallwood <owen.smallwood@grafana.com>
Date: Mon, 23 Sep 2024 08:25:19 -0600
Subject: [PATCH] Unified Storage: Adds a few readme updates from issues I ran
 into with local dev (#93553)

adds a few readme updates from issues I ran into with local dev
---
 pkg/services/apiserver/README.md |  2 +-
 pkg/storage/unified/README.md    | 19 +++++++++++++++++++
 2 files changed, 20 insertions(+), 1 deletion(-)

diff --git a/pkg/services/apiserver/README.md b/pkg/services/apiserver/README.md
index 4a3949a7d25..f85e39fe880 100644
--- a/pkg/services/apiserver/README.md
+++ b/pkg/services/apiserver/README.md
@@ -66,7 +66,7 @@ grafanaAPIServerEnsureKubectlAccess = true
 kubernetesPlaylists = true
 
 [unified_storage.playlists.playlist.grafana.app]
-DualWriterMode = 2
+dualWriterMode = 2
 ```
 
 This will create a development kubeconfig and start a parallel ssl listener.  It can be registered by
diff --git a/pkg/storage/unified/README.md b/pkg/storage/unified/README.md
index 8fbf4110610..0a85e12b786 100644
--- a/pkg/storage/unified/README.md
+++ b/pkg/storage/unified/README.md
@@ -32,8 +32,20 @@ kubernetesPlaylists = true
 [grafana-apiserver]
 ; use unified storage for k8s apiserver
 storage_type = unified
+
+# Dualwriter modes
+# 0: disabled (default mode)
+# 1: read from legacy, write to legacy, write to unified best-effort
+# 2: read from legacy, write to both
+# 3: read from unified, write to both
+# 4: read from unified, write to unified
+# 5: read from unified, write to unified, ignore background sync state
+[unified_storage.playlists.playlist.grafana.app]
+dualWriterMode = 0
 ```
 
+**Note**: When using the Dualwriter, Watch will only work with mode 5.
+
 ### Folders: baseline configuration
 
 NOTE: allowing folders to be backed by Unified Storage is under development and so are these instructions. 
@@ -221,6 +233,13 @@ make run
 
 #### Start GRPC storage-server
 
+Make sure you have the gRPC address in the `[grafana-apiserver]` section of your config file:
+```ini
+[grafana-apiserver]
+; your gRPC server address
+address = localhost:10000
+```
+
 This currently only works with a separate database configuration (see previous section).
 
 Start the storage-server with: