chore(influxdb3-cli): Describe required params, mode can be a list, troubleshooting

Author: jstirnaman

content/influxdb3/core/reference/cli/influxdb3/serve.md

@@ -20,6 +20,7 @@ The `influxdb3 serve` command starts the {{< product-name >}} server.
 ```bash
 influxdb3 serve [OPTIONS] --node-id <HOST_IDENTIFIER_PREFIX>
 ```
+`--node-id` is a unique string that identifies your InfluxDB server instance
 
 ## Options
 
@@ -101,7 +102,13 @@ influxdb3 serve [OPTIONS] --node-id <HOST_IDENTIFIER_PREFIX>
 
 You can use environment variables to define most `influxdb3 serve` options.
 For more information, see
-[Configuration options](/influxdb3/core/reference/config-options/).
+[Configuration options](/influxdb3/enterprise/reference/config-options/).
+
+## Key Requirements
+
+- **node-id**: Must be unique for any hosts sharing the same object store configuration
+- **object-store**: Determines where time series data is stored
+- **data-dir**: Specifies the path for local file storage, required with `--object-store file`
 
 ## Examples
 
@@ -150,3 +157,14 @@ LOG_FILTER=debug influxdb3 serve \
 ```
 
 {{% /code-placeholders %}}
+
+
+## Troubleshooting
+
+### Common Issues
+
+- **Error: "Failed to connect to object store"**  
+  Verify your `--object-store` setting and ensure all required parameters for that storage type are provided.
+
+- **Permission errors when using S3, Google Cloud, or Azure storage**  
+  Check that your authentication credentials are correct and have sufficient permissions.

content/influxdb3/enterprise/reference/cli/influxdb3/serve.md

@@ -7,6 +7,8 @@ menu:
     parent: influxdb3
     name: influxdb3 serve
 weight: 300
+related:
+  - /influxdb3/enterprise/reference/config-options/
 ---
 
 The `influxdb3 serve` command starts the {{< product-name >}} server.
@@ -21,6 +23,14 @@ influxdb3 serve [OPTIONS] \
  --cluster-id <CLUSTER_IDENTIFIER_PREFIX>
 ```
 
+Required parameters:
+
+- `--node-id`: a unique string that identifies your InfluxDB server instance
+- `--cluster-id`: a unique string that identifies your InfluxDB cluster
+- The `--cluster-id` value must be different from any `--node-id` values in your cluster
+- Example format: `--node-id influx-server-1 --cluster-id sensors-cluster`
+- Both identifiers should be alphanumeric strings with optional hyphens
+
 ## Options
 
 | Option           |                                                      | Description                                                                                                                     |
@@ -113,6 +123,13 @@ You can use environment variables to define most `influxdb3 serve` options.
 For more information, see
 [Configuration options](/influxdb3/enterprise/reference/config-options/).
 
+## Key Requirements
+
+- **node-id**: Must be unique for any hosts sharing the same object store configuration
+- **cluster-id**: Must be unique and different from any node-id in your cluster
+- **object-store**: Determines where time series data is stored
+- **data-dir**: Specifies the path for local file storage, required with `--object-store file`
+
 ## Examples
 
 - [Run the InfluxDB 3 server](#run-the-influxdb-3-server)
@@ -193,3 +210,17 @@ LOG_FILTER=debug influxdb3 serve \
 ```
 
 {{% /code-placeholders %}}
+
+
+## Troubleshooting
+
+### Common Issues
+
+- **Error: "cluster-id cannot match any node-id in the cluster"**  
+  Ensure your `--cluster-id` value is different from all `--node-id` values in your cluster.
+
+- **Error: "Failed to connect to object store"**  
+  Verify your `--object-store` setting and ensure all required parameters for that storage type are provided.
+
+- **Permission errors when using S3, Google Cloud, or Azure storage**  
+  Check that your authentication credentials are correct and have sufficient permissions.

content/influxdb3/enterprise/reference/config-options.md

@@ -213,11 +213,13 @@ Sets the mode to start the server in.
 
 This option supports the following values:
 
-- `all` _(default)_
-- `ingest`
-- `query`
-- `compact`
-- `process`
+- `all` _(default)_: Enables all server modes
+- `ingest`: Enables only data ingest capabilities
+- `query`: Enables only query capabilities
+- `compact`: Enables only compaction processes
+- `process`: Enables only data processing capabilities
+
+You can specify multiple modes using a comma-delimited list (for example, `ingest,query`).
 
 **Default:** `all`
 
@@ -980,9 +982,6 @@ Defines the interval at which each replica specified in the
 - [compaction-cleanup-wait](#compaction-cleanup-wait)
 - [gen1-duration](#gen1-duration)
 
-
-
-
 #### compaction-row-limit
 
 Specifies the soft limit for the number of rows per file that the compactor