From f5d5d89723e08e29ea0d52b961e126b103b3e06e Mon Sep 17 00:00:00 2001 From: "Alexey A. Leonov" Date: Thu, 3 Apr 2025 08:47:33 +0700 Subject: [PATCH 1/2] added Object Mount FAQs --- app/(docs)/object-mount/faq/_meta.json | 1 + app/(docs)/object-mount/faq/page.md | 26 ++++++++++++++++++++++++++ 2 files changed, 27 insertions(+) create mode 100644 app/(docs)/object-mount/faq/_meta.json create mode 100644 app/(docs)/object-mount/faq/page.md diff --git a/app/(docs)/object-mount/faq/_meta.json b/app/(docs)/object-mount/faq/_meta.json new file mode 100644 index 000000000..234885777 --- /dev/null +++ b/app/(docs)/object-mount/faq/_meta.json @@ -0,0 +1 @@ +{"title": "User Guides", "weight": 5} \ No newline at end of file diff --git a/app/(docs)/object-mount/faq/page.md b/app/(docs)/object-mount/faq/page.md new file mode 100644 index 000000000..693dcc895 --- /dev/null +++ b/app/(docs)/object-mount/faq/page.md @@ -0,0 +1,26 @@ +--- +title: FAQs +docId: dd27e33c-7804-4e15-bdc5-941f9a1a7e12 +metadata: + title: Frequently Asked Questions + description: + Comprehensive resource to various FAQs covering topics related to Object Mount. +--- +# What S3 permissions are recommended to mount a bucket with Object Mount? +Short answer, for a generic cloud: read, write, list permissions inside the bucket intended to be mounted. + +# Does full permissions are required to achieve a maximum performance of Object Mount? +The maximum performance comes from cunoFS's ability to prefetch data based on how we handle certain file types. It is not dependent on being able to write the POSIX-metadata file. With read-only permissions to a bucket, cunoFS will still achieve a maximum performance - but it will not be able to update any POSIX-related metadata associated with the original files. + +# Why my read-only credentials doesn't work with POSIX enabled in Object Mount? +The POSIX mode needs to write a hidden file at the root of the bucket that tracks all the POSIX permissions, etc. This is why the read-only use case works so long as you mount the bucket without POSIX enabled. + +# How to mount all buckets with Object Mount? +In order for Object Mount to "see" the bucket to be mounted when adding new credentials into cunoFS, the AWS equivalent of ListAllMyBuckets is required. In the absence of ListAllMyBuckets, you can specify what bucket to mount by manually pairing the bucket. + +# Where can I see logs of Object Mount on Windows? +Logs are available at `C:\Users\(your username)\AppData\Local\cunoFS\cunofs.log` - the default logging level is "error" so changing this to “access,trace" will provide much more verbose logs to better understand what is going on. + +# Where can I see logs of Object Mount on macOS? +For MacOS the logs are located at: +`/Users/[username]/Library/Application Support/cunoFS/cunoFS.log` \ No newline at end of file From 1558a94203f451b0d55625c5b9617a21a5bf67c7 Mon Sep 17 00:00:00 2001 From: "Alexey A. Leonov" Date: Thu, 3 Apr 2025 08:50:33 +0700 Subject: [PATCH 2/2] reduced headers level --- app/(docs)/object-mount/faq/page.md | 12 ++++++------ 1 file changed, 6 insertions(+), 6 deletions(-) diff --git a/app/(docs)/object-mount/faq/page.md b/app/(docs)/object-mount/faq/page.md index 693dcc895..4dd814bf6 100644 --- a/app/(docs)/object-mount/faq/page.md +++ b/app/(docs)/object-mount/faq/page.md @@ -6,21 +6,21 @@ metadata: description: Comprehensive resource to various FAQs covering topics related to Object Mount. --- -# What S3 permissions are recommended to mount a bucket with Object Mount? +## What S3 permissions are recommended to mount a bucket with Object Mount? Short answer, for a generic cloud: read, write, list permissions inside the bucket intended to be mounted. -# Does full permissions are required to achieve a maximum performance of Object Mount? +## Does full permissions are required to achieve a maximum performance of Object Mount? The maximum performance comes from cunoFS's ability to prefetch data based on how we handle certain file types. It is not dependent on being able to write the POSIX-metadata file. With read-only permissions to a bucket, cunoFS will still achieve a maximum performance - but it will not be able to update any POSIX-related metadata associated with the original files. -# Why my read-only credentials doesn't work with POSIX enabled in Object Mount? +## Why my read-only credentials doesn't work with POSIX enabled in Object Mount? The POSIX mode needs to write a hidden file at the root of the bucket that tracks all the POSIX permissions, etc. This is why the read-only use case works so long as you mount the bucket without POSIX enabled. -# How to mount all buckets with Object Mount? +## How to mount all buckets with Object Mount? In order for Object Mount to "see" the bucket to be mounted when adding new credentials into cunoFS, the AWS equivalent of ListAllMyBuckets is required. In the absence of ListAllMyBuckets, you can specify what bucket to mount by manually pairing the bucket. -# Where can I see logs of Object Mount on Windows? +## Where can I see logs of Object Mount on Windows? Logs are available at `C:\Users\(your username)\AppData\Local\cunoFS\cunofs.log` - the default logging level is "error" so changing this to “access,trace" will provide much more verbose logs to better understand what is going on. -# Where can I see logs of Object Mount on macOS? +## Where can I see logs of Object Mount on macOS? For MacOS the logs are located at: `/Users/[username]/Library/Application Support/cunoFS/cunoFS.log` \ No newline at end of file