From caf701aef44e28b4e394f2a70e5db5d94725490c Mon Sep 17 00:00:00 2001 From: Jeff Rowley <117940561+JefferoNW@users.noreply.github.com> Date: Wed, 26 Nov 2025 16:02:04 -0800 Subject: [PATCH 1/2] Instructions to submit logs --- .../object-mount/faq/troubleshooting/page.md | 60 ++++++++++++++++--- 1 file changed, 51 insertions(+), 9 deletions(-) diff --git a/app/(docs)/object-mount/faq/troubleshooting/page.md b/app/(docs)/object-mount/faq/troubleshooting/page.md index 6e93da690..76724a392 100644 --- a/app/(docs)/object-mount/faq/troubleshooting/page.md +++ b/app/(docs)/object-mount/faq/troubleshooting/page.md @@ -11,7 +11,7 @@ metadata: # Troubleshooting Guide -This guide covers common issues encountered when using **Object Mount**, along with clear steps to resolve them. If you're stuck, this is a good first place to check before reaching out to support. +This guide covers common issues encountered when using **Object Mount**, along with clear steps to resolve them. If you’re stuck, this is a good first place to check before reaching out to support. --- @@ -21,12 +21,12 @@ This guide covers common issues encountered when using **Object Mount**, along w - Incorrect credentials - No accessible buckets -- macFUSE or WinFsp not installed or authorised +- macFUSE or WinFsp not installed or authorized - POSIX mode enabled without write access **What to check:** -- Verify your licence is active (`About` tab) +- Verify your license is active (`About` tab) - Re-import your credentials and confirm bucket visibility - Ensure dependencies are installed: - **macOS**: [macFUSE](https://osxfuse.github.io/) @@ -64,7 +64,7 @@ Some S3-compatible providers require custom regions, endpoints, or flags. - Enable **data cache** and **metadata cache** in Preferences - Set `CUNO_OPTIONS = -filePrefetch` -- Increase S3 connection pool (e.g. 150–200 for 1Gbps+) +- Increase S3 connection pool (e.g. 150-200 for 1Gbps+) - Avoid using POSIX mode unless required - Place cache directories on an internal SSD @@ -72,7 +72,7 @@ Some S3-compatible providers require custom regions, endpoints, or flags. ## “Leave Files in Place” Doesn’t Work in Creative App -Some NLE Applications may try to verify write access or expect native macOS behaviour. +Some NLE Applications may try to verify write access or expect native macOS behavior. **Check:** @@ -100,16 +100,58 @@ By default, logging is set to `error` only. ## Files Are Stalling on Paste -If files are stuck during paste, and you're on **Windows**: +If files are stuck during paste, and you’re on **Windows**: - Try using the **Fast Paste Here** right-click option -- This bypasses Windows shell copy and uses Object Mount’s optimised transfer logic +- This bypasses Windows shell copy and uses Object Mount’s optimized transfer logic --- ## Still Not Working? -Reach out via our [help desk](https://supportdcs.storj.io/hc/en-us/requests/new) and include: +If you still need assistance in resolving your issue, follow the steps below to enable detailed logging and send the log files to the Storj Help Desk. + +For macOS and Windows environments: + +1. Run Object Mount, choose the **Settings** tab, and scroll down to **Advanced Settings**: + + - Change the “Object Mount log level” to `Trace`. + - Set “Filesystem debug logging” to `On`. + - Click the **Apply** button. + + ![](https://link.us1.storjshare.io/raw/jua7rls6hkx5556qfcmhrqed2tfa/docs/images/om-docs/om-enable-trace-logs-01.jpg) + +2. Choose the **About** Tab: + + - Click **Report Issue**. + - Enter a **Title**. + - Enter details and/or **Steps to Reproduce** the issue. + - Ensure that **Include my system information** is checked. + - Click the **Continue** button. + + ![](https://link.us1.storjshare.io/raw/jua7rls6hkx5556qfcmhrqed2tfa/docs/images/om-docs/om-enable-trace-logs-02.jpg) + +3. Save the Issue Report: + + - Name your `.zip` file. + - Click **Save** to store a `.zip` file on your local drive. + + ![](https://link.us1.storjshare.io/raw/jua7rls6hkx5556qfcmhrqed2tfa/docs/images/om-docs/om-enable-trace-logs-03.jpg) + +4. Attach the `.zip` file and send the report: + + - Click the **Submit Via Email** button: + + ![](https://link.us1.storjshare.io/raw/jua7rls6hkx5556qfcmhrqed2tfa/docs/images/om-docs/om-enable-trace-logs-04.jpg) + + - Your default Email application will load with content preloaded. + - **IMPORTANT**: You must _manually_ attach the `.zip` file to the email! + + ![](https://link.us1.storjshare.io/raw/jua7rls6hkx5556qfcmhrqed2tfa/docs/images/om-docs/om-enable-trace-logs-05.jpg) + + - _Once attached_, click to **Send** the message to the Storj Object Mount support team. + +Alternatively you can open a [support ticket](https://supportdcs.storj.io/hc/en-us/requests/new) and include: - OS and Object Mount version - Cloud provider and bucket name @@ -130,4 +172,4 @@ Here are a few current limitations to be aware of: --- -Let us know if you’d like to contribute improvements or suggest workarounds — we're always refining based on real-world feedback. +Let us know if you’d like to contribute improvements or suggest workarounds — we’re always refining based on real-world feedback. From c917e7ffdad2edf5b747115d5507ee9f8085cf37 Mon Sep 17 00:00:00 2001 From: "Jeff Rowley (Github)" <117940561+JefferoNW@users.noreply.github.com> Date: Mon, 1 Dec 2025 10:24:48 -0800 Subject: [PATCH 2/2] Update support team reference in troubleshooting guide --- app/(docs)/object-mount/faq/troubleshooting/page.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/app/(docs)/object-mount/faq/troubleshooting/page.md b/app/(docs)/object-mount/faq/troubleshooting/page.md index 76724a392..6673a49cb 100644 --- a/app/(docs)/object-mount/faq/troubleshooting/page.md +++ b/app/(docs)/object-mount/faq/troubleshooting/page.md @@ -109,7 +109,7 @@ If files are stuck during paste, and you’re on **Windows**: ## Still Not Working? -If you still need assistance in resolving your issue, follow the steps below to enable detailed logging and send the log files to the Storj Help Desk. +If you still need assistance in resolving your issue, follow the steps below to enable detailed logging and send the log files to the Storj Support team. For macOS and Windows environments: