From 30d3c0bb147c6d3f4aabd8f90d438fc260c7cb8b Mon Sep 17 00:00:00 2001 From: way zheng Date: Thu, 8 Jan 2026 14:20:10 -0800 Subject: [PATCH 1/4] updating wordings --- docs/guides/operator-guide-aws-marketplace.md | 13 +++++-------- docs/guides/operator-guide-azure-enclave.md | 6 +++--- .../operator-private-gcp-confidential-space.md | 6 +++--- 3 files changed, 11 insertions(+), 14 deletions(-) diff --git a/docs/guides/operator-guide-aws-marketplace.md b/docs/guides/operator-guide-aws-marketplace.md index 9cc92a4c0..1ba6a33f9 100644 --- a/docs/guides/operator-guide-aws-marketplace.md +++ b/docs/guides/operator-guide-aws-marketplace.md @@ -5,14 +5,11 @@ pagination_label: UID2 Private Operator for AWS Integration Guide description: Integration information for Private Operator in AWS. hide_table_of_contents: false sidebar_position: 17 -displayed_sidebar: docs --- import Link from '@docusaurus/Link'; -import SnptUpgradePolicy from '../snippets/_snpt-private-operator-upgrade-policy.mdx'; -import SnptPreparingEmailsAndPhoneNumbers from '../snippets/_snpt-preparing-emails-and-phone-numbers.mdx'; -import SnptAttestFailure from '../snippets/_snpt-private-operator-attest-failure.mdx'; -import SnptRotatingTheKeys from '../snippets/_snpt-private-operator-rotating-the-keys.mdx'; +import UpgradePolicy from '../snippets/_private-operator-upgrade-policy.mdx'; +import AttestFailure from '../snippets/_private-operator-attest-failure.mdx'; # UID2 Private Operator for AWS Integration Guide @@ -379,7 +376,7 @@ Error codes for Private Operator issues are applicable only to release v5.49.7 a ### Startup Errors -The following errors occur during operator startup: +The following errors might occur during operator startup: | Error Code | Issue | Steps to Resolve | | :--- | :--- | :--- | @@ -392,11 +389,11 @@ The following errors occur during operator startup: ### Runtime Errors -The following errors occur during operator runtime: +The following errors might occur during operator runtime: | Error Code | Issue | How to Identify in Logs | Steps to Resolve | | :--- | :--- | :--- | :--- | -| E12 | Data Download Failure | Look for log messages containing `"E12: Data Download Failure"` along with `"Failed to load"` errors from `RotatingStoreVerticle`. These will include HTTP status codes (e.g., `"HTTP response code 403"`) or exception types (e.g., `"exception: IOException"`). | Check the HTTP status code or exception in the error message:
**404 errors** - Verify operator key is valid for the environment.
**403 errors** - Verify operator key and credentials are correct.
**Timeout errors** - Verify network connectivity, check firewall/security group settings allow outbound HTTPS (port 443), and ensure UID2 service endpoints are accessible.
**500/503 errors** - Temporary UID2 service issue, retry or contact UID2 support if persistent. | +| E12 | Data Download Failure | Look for log messages containing `E12: Data Download Failure` or `Failed to load` errors from `RotatingStoreVerticle`. These messages include HTTP status codes (for example, `HTTP response code 403`) or exception types (for example, `exception: IOException`). | Check the HTTP status code or exception in the error message and resolve accordingly:
**404 errors**: Verify that the operator key is valid for the environment.
**403 errors**: Verify that the operator key and credentials are correct.
**Timeout errors**: Verify network connectivity, check that firewall/security group settings allow outbound HTTPS (port 443), and ensure that the UID2 service endpoints are accessible.
**500/503 errors**: This code indicates a temporary UID2 service issue. Retry, and if the error persists contact UID2 support. | ## Technical Support diff --git a/docs/guides/operator-guide-azure-enclave.md b/docs/guides/operator-guide-azure-enclave.md index d6a8faacc..f228cd4b1 100644 --- a/docs/guides/operator-guide-azure-enclave.md +++ b/docs/guides/operator-guide-azure-enclave.md @@ -357,7 +357,7 @@ Error codes for Private Operator issues are applicable only to release v5.49.7 a ### Startup Errors -The following errors occur during operator startup: +The following errors might occur during operator startup: | Error Code | Issue | Steps to Resolve | | :--- | :--- | :--- | @@ -370,8 +370,8 @@ The following errors occur during operator startup: ### Runtime Errors -The following errors occur during operator runtime: +The following errors might occur during operator runtime: | Error Code | Issue | How to Identify in Logs | Steps to Resolve | | :--- | :--- | :--- | :--- | -| E12 | Data Download Failure | Look for log messages containing `"E12: Data Download Failure"` along with `"Failed to load"` errors from `RotatingStoreVerticle`. These will include HTTP status codes (e.g., `"HTTP response code 403"`) or exception types (e.g., `"exception: IOException"`). | Check the HTTP status code or exception in the error message:
**404 errors** - Verify operator key is valid for the environment.
**403 errors** - Verify operator key and credentials are correct.
**Timeout errors** - Verify network connectivity, check NSG/firewall rules allow outbound HTTPS (port 443), and ensure UID2 service endpoints are accessible.
**500/503 errors** - Temporary UID2 service issue, retry or contact UID2 support if persistent. | \ No newline at end of file +| E12 | Data Download Failure | Look for log messages containing `E12: Data Download Failure` or `Failed to load` errors from `RotatingStoreVerticle`. These messages include HTTP status codes (for example, `HTTP response code 403`) or exception types (for example, `exception: IOException`). | Check the HTTP status code or exception in the error message and resolve accordingly:
**404 errors**: Verify that the operator key is valid for the environment.
**403 errors**: Verify that the operator key and credentials are correct.
**Timeout errors**: Verify network connectivity, check that NSG/firewall rules allow outbound HTTPS (port 443), and ensure that the UID2 service endpoints are accessible.
**500/503 errors**: This code indicates a temporary UID2 service issue. Retry, and if the error persists contact UID2 support. | \ No newline at end of file diff --git a/docs/guides/operator-private-gcp-confidential-space.md b/docs/guides/operator-private-gcp-confidential-space.md index 95221c485..a48012dc1 100644 --- a/docs/guides/operator-private-gcp-confidential-space.md +++ b/docs/guides/operator-private-gcp-confidential-space.md @@ -553,7 +553,7 @@ Error codes for Private Operator issues are applicable only to release v5.49.7 a ### Startup Errors -The following errors occur during operator startup: +The following errors might occur during operator startup: | Error Code | Issue | Steps to Resolve | | :--- | :--- | :--- | @@ -566,8 +566,8 @@ The following errors occur during operator startup: ### Runtime Errors -The following errors occur during operator runtime: +The following errors might occur during operator runtime: | Error Code | Issue | How to Identify in Logs | Steps to Resolve | | :--- | :--- | :--- | :--- | -| E12 | Data Download Failure | Look for log messages containing `"E12: Data Download Failure"` along with `"Failed to load"` errors from `RotatingStoreVerticle`. These will include HTTP status codes (e.g., `"HTTP response code 403"`) or exception types (e.g., `"exception: IOException"`). | Check the HTTP status code or exception in the error message:
**404 errors** - Verify operator key is valid for the environment.
**403 errors** - Verify operator key and credentials are correct.
**Timeout errors** - Verify network connectivity, check VPC firewall rules allow outbound HTTPS (port 443), and ensure UID2 service endpoints are accessible.
**500/503 errors** - Temporary UID2 service issue, retry or contact UID2 support if persistent. | +| E12 | Data Download Failure | Look for log messages containing `E12: Data Download Failure` or `Failed to load` errors from `RotatingStoreVerticle`. These messages include HTTP status codes (for example, `HTTP response code 403`) or exception types (for example, `exception: IOException`). | Check the HTTP status code or exception in the error message and resolve accordingly:
**404 errors**: Verify that the operator key is valid for the environment.
**403 errors**: Verify that the operator key and credentials are correct.
**Timeout errors**: Verify network connectivity, check that VPC firewall rules allow outbound HTTPS (port 443), and ensure that the UID2 service endpoints are accessible.
**500/503 errors**: This code indicates a temporary UID2 service issue. Retry, and if the error persists contact UID2 support. | From 33da0b60e971e23f7d219c856639e97d601af1f7 Mon Sep 17 00:00:00 2001 From: way zheng Date: Thu, 8 Jan 2026 14:24:04 -0800 Subject: [PATCH 2/4] revert some changes --- docs/guides/operator-guide-aws-marketplace.md | 7 +++++-- 1 file changed, 5 insertions(+), 2 deletions(-) diff --git a/docs/guides/operator-guide-aws-marketplace.md b/docs/guides/operator-guide-aws-marketplace.md index 1ba6a33f9..79aacbb0b 100644 --- a/docs/guides/operator-guide-aws-marketplace.md +++ b/docs/guides/operator-guide-aws-marketplace.md @@ -5,11 +5,14 @@ pagination_label: UID2 Private Operator for AWS Integration Guide description: Integration information for Private Operator in AWS. hide_table_of_contents: false sidebar_position: 17 +displayed_sidebar: docs --- import Link from '@docusaurus/Link'; -import UpgradePolicy from '../snippets/_private-operator-upgrade-policy.mdx'; -import AttestFailure from '../snippets/_private-operator-attest-failure.mdx'; +import SnptUpgradePolicy from '../snippets/_snpt-private-operator-upgrade-policy.mdx'; +import SnptPreparingEmailsAndPhoneNumbers from '../snippets/_snpt-preparing-emails-and-phone-numbers.mdx'; +import SnptAttestFailure from '../snippets/_snpt-private-operator-attest-failure.mdx'; +import SnptRotatingTheKeys from '../snippets/_snpt-private-operator-rotating-the-keys.mdx'; # UID2 Private Operator for AWS Integration Guide From 996a1e6aed8607632a9c1a90f79c0e29839bd69d Mon Sep 17 00:00:00 2001 From: way zheng Date: Thu, 8 Jan 2026 14:52:16 -0800 Subject: [PATCH 3/4] use snippet for repetitive contents --- docs/guides/operator-guide-aws-marketplace.md | 5 ++--- docs/guides/operator-guide-azure-enclave.md | 5 ++--- docs/guides/operator-private-gcp-confidential-space.md | 5 ++--- 3 files changed, 6 insertions(+), 9 deletions(-) diff --git a/docs/guides/operator-guide-aws-marketplace.md b/docs/guides/operator-guide-aws-marketplace.md index 79aacbb0b..9a4f87955 100644 --- a/docs/guides/operator-guide-aws-marketplace.md +++ b/docs/guides/operator-guide-aws-marketplace.md @@ -13,6 +13,7 @@ import SnptUpgradePolicy from '../snippets/_snpt-private-operator-upgrade-policy import SnptPreparingEmailsAndPhoneNumbers from '../snippets/_snpt-preparing-emails-and-phone-numbers.mdx'; import SnptAttestFailure from '../snippets/_snpt-private-operator-attest-failure.mdx'; import SnptRotatingTheKeys from '../snippets/_snpt-private-operator-rotating-the-keys.mdx'; +import SnptRuntimeErrors from '../snippets/_snpt-private-operator-runtime-errors.mdx'; # UID2 Private Operator for AWS Integration Guide @@ -394,9 +395,7 @@ The following errors might occur during operator startup: The following errors might occur during operator runtime: -| Error Code | Issue | How to Identify in Logs | Steps to Resolve | -| :--- | :--- | :--- | :--- | -| E12 | Data Download Failure | Look for log messages containing `E12: Data Download Failure` or `Failed to load` errors from `RotatingStoreVerticle`. These messages include HTTP status codes (for example, `HTTP response code 403`) or exception types (for example, `exception: IOException`). | Check the HTTP status code or exception in the error message and resolve accordingly:
**404 errors**: Verify that the operator key is valid for the environment.
**403 errors**: Verify that the operator key and credentials are correct.
**Timeout errors**: Verify network connectivity, check that firewall/security group settings allow outbound HTTPS (port 443), and ensure that the UID2 service endpoints are accessible.
**500/503 errors**: This code indicates a temporary UID2 service issue. Retry, and if the error persists contact UID2 support. | + ## Technical Support diff --git a/docs/guides/operator-guide-azure-enclave.md b/docs/guides/operator-guide-azure-enclave.md index f228cd4b1..38c198f31 100644 --- a/docs/guides/operator-guide-azure-enclave.md +++ b/docs/guides/operator-guide-azure-enclave.md @@ -13,6 +13,7 @@ import SnptUpgradePolicy from '../snippets/_snpt-private-operator-upgrade-policy import SnptPreparingEmailsAndPhoneNumbers from '../snippets/_snpt-preparing-emails-and-phone-numbers.mdx'; import SnptAttestFailure from '../snippets/_snpt-private-operator-attest-failure.mdx'; import SnptRotatingTheKeys from '../snippets/_snpt-private-operator-rotating-the-keys.mdx'; +import SnptRuntimeErrors from '../snippets/_snpt-private-operator-runtime-errors.mdx'; # UID2 Private Operator for Azure Integration Guide @@ -372,6 +373,4 @@ The following errors might occur during operator startup: The following errors might occur during operator runtime: -| Error Code | Issue | How to Identify in Logs | Steps to Resolve | -| :--- | :--- | :--- | :--- | -| E12 | Data Download Failure | Look for log messages containing `E12: Data Download Failure` or `Failed to load` errors from `RotatingStoreVerticle`. These messages include HTTP status codes (for example, `HTTP response code 403`) or exception types (for example, `exception: IOException`). | Check the HTTP status code or exception in the error message and resolve accordingly:
**404 errors**: Verify that the operator key is valid for the environment.
**403 errors**: Verify that the operator key and credentials are correct.
**Timeout errors**: Verify network connectivity, check that NSG/firewall rules allow outbound HTTPS (port 443), and ensure that the UID2 service endpoints are accessible.
**500/503 errors**: This code indicates a temporary UID2 service issue. Retry, and if the error persists contact UID2 support. | \ No newline at end of file + \ No newline at end of file diff --git a/docs/guides/operator-private-gcp-confidential-space.md b/docs/guides/operator-private-gcp-confidential-space.md index a48012dc1..259dd3746 100644 --- a/docs/guides/operator-private-gcp-confidential-space.md +++ b/docs/guides/operator-private-gcp-confidential-space.md @@ -13,6 +13,7 @@ import SnptUpgradePolicy from '../snippets/_snpt-private-operator-upgrade-policy import SnptPreparingEmailsAndPhoneNumbers from '../snippets/_snpt-preparing-emails-and-phone-numbers.mdx'; import SnptAttestFailure from '../snippets/_snpt-private-operator-attest-failure.mdx'; import SnptRotatingTheKeys from '../snippets/_snpt-private-operator-rotating-the-keys.mdx'; +import SnptRuntimeErrors from '../snippets/_snpt-private-operator-runtime-errors.mdx'; # UID2 Private Operator for GCP Integration Guide @@ -568,6 +569,4 @@ The following errors might occur during operator startup: The following errors might occur during operator runtime: -| Error Code | Issue | How to Identify in Logs | Steps to Resolve | -| :--- | :--- | :--- | :--- | -| E12 | Data Download Failure | Look for log messages containing `E12: Data Download Failure` or `Failed to load` errors from `RotatingStoreVerticle`. These messages include HTTP status codes (for example, `HTTP response code 403`) or exception types (for example, `exception: IOException`). | Check the HTTP status code or exception in the error message and resolve accordingly:
**404 errors**: Verify that the operator key is valid for the environment.
**403 errors**: Verify that the operator key and credentials are correct.
**Timeout errors**: Verify network connectivity, check that VPC firewall rules allow outbound HTTPS (port 443), and ensure that the UID2 service endpoints are accessible.
**500/503 errors**: This code indicates a temporary UID2 service issue. Retry, and if the error persists contact UID2 support. | + From 4f753ee63d9fcb3032eb36c922332908790a081c Mon Sep 17 00:00:00 2001 From: way zheng Date: Thu, 8 Jan 2026 14:54:33 -0800 Subject: [PATCH 4/4] Add runtime errors snippet for private operator docs --- docs/snippets/_snpt-private-operator-runtime-errors.mdx | 4 ++++ 1 file changed, 4 insertions(+) create mode 100644 docs/snippets/_snpt-private-operator-runtime-errors.mdx diff --git a/docs/snippets/_snpt-private-operator-runtime-errors.mdx b/docs/snippets/_snpt-private-operator-runtime-errors.mdx new file mode 100644 index 000000000..3dbcf69ec --- /dev/null +++ b/docs/snippets/_snpt-private-operator-runtime-errors.mdx @@ -0,0 +1,4 @@ +| Error Code | Issue | How to Identify in Logs | Steps to Resolve | +| :--- | :--- | :--- | :--- | +| E12 | Data Download Failure | Look for log messages containing `E12: Data Download Failure` or `Failed to load` errors from `RotatingStoreVerticle`. These messages include HTTP status codes (for example, `HTTP response code 403`) or exception types (for example, `exception: IOException`). | Check the HTTP status code or exception in the error message and resolve accordingly:
**404 errors**: Verify that the operator key is valid for the environment.
**403 errors**: Verify that the operator key and credentials are correct.
**Timeout errors**: Verify network connectivity, check that firewall/security group settings allow outbound HTTPS (port 443), and ensure that the UID2 service endpoints are accessible.
**500/503 errors**: This code indicates a temporary UID2 service issue. Retry, and if the error persists contact UID2 support. | +