Contents
- Overview
- Solution
- How to Reproduce (AFP-first)
- Temporary Mitigation (If You Cannot Upgrade)
- Validation Checklist
- Frequently Asked Questions
Overview
In Xinet Server v2025.8.5, SMB clients may not properly interoperate with items (files/folders) whose names contain accented characters when those items are created on the same volume via AFP. The reported behavior is that the accented-name file or folder becomes invisible (or not manageable) when the volume is mounted via SMB, and renaming the item to remove accents makes it visible again.
This was reported as a regression versus Xinet Server v2025.5.16. A complete fix was delivered in Xinet Server v2026.02.27 (compatible with Portal v2025.12.19) and was confirmed resolved after upgrade and retesting.
Solution
1) Confirm you are seeing the same symptom
This issue typically presents as SMB/AFP interoperability problems for accented filenames. Common reported symptoms include:
- “With Xinet 2025.8.5, the display of files and folders whose names contain accented characters in SMB volumes is not allowed.”
- “Mount the same volume in SMB, and you will find that the file (or folder) is invisible.”
- Renaming the item to remove accented characters makes it visible/usable in SMB.
- In Xinet 2025.12.19, files were reported as fixed, but folders were still problematic from SMB (example: “The folder whose name has accented characters can only be deleted from an AFP … volume.”).
2) Check affected and fixed versions
- Reported affected (regression): Xinet Server 2025.8.5 (vs 2025.5.16)
- Partial improvement reported: 2025.12.19 (files OK; folders still problematic from SMB in customer testing)
- Fix confirmed by customer: Xinet Server 2026.02.27 (used with Portal 2025.12.19)
3) Recommended resolution: Upgrade to the fixed Server release
-
Upgrade Xinet Server to v2026.02.27.
- This fix was delivered as a Server release.
- The fixed Server release was confirmed compatible with Portal v2025.12.19.
- After upgrading, retest using the AFP-first reproduction steps (create via AFP first, then validate via SMB).
- Validate that accented-name files are visible and manageable via SMB.
- Validate that accented-name folders are manageable via SMB (including delete/rename as required by your workflow).
Additional context (investigation findings)
- Attempts that created/uploaded accented filenames via the Xinet Portal and then checked visibility via SMB did not reproduce the issue (files remained visible).
- A key requirement to reproduce the reported behavior was creating the item on the volume via AFP first, then checking from SMB.
- Reproduction attempts may be limited by test-environment availability and AFP testing constraints (for example, AFP connectivity failures or lack of macOS client availability).
- The issue was handled as an internal defect/regression; an intermediate release (2025.12.19) improved file handling but did not fully resolve folder operations from SMB in customer testing, prompting further engineering escalation and the final fix in 2026.02.27.
How to Reproduce (Key Detail: AFP-First)
To reproduce the issue as reported, the item must be created on the volume via AFP first:
- From a macOS desktop, copy a file or folder with accented characters in the name to an AFP volume.
- Mount the same volume via SMB.
- Check whether the file/folder is missing (invisible) in SMB, or whether SMB operations (notably on folders) fail.
- Rename the file/folder to remove accented characters and re-check visibility/behavior in SMB.
Note: Creating the file via the Xinet Portal and then checking via SMB may not trigger the same AFP/SMB interoperability path and may not reproduce the issue.
Temporary Mitigation (If You Cannot Upgrade)
If upgrading immediately is not possible, a mitigation observed in the field was to disable specific SMB modules:
- Disable SMB modules
xinetnamespaceandxinetfilehandlin. -
Observed behavior:
- With these modules active: accented-name items created via AFP may be not visible in SMB.
- With these modules inactive: accented-name items created via AFP may become visible in SMB.
Important: Test this mitigation in a non-production environment first. Module changes can impact SMB behavior and features.
Validation Checklist
After applying the fix (or mitigation), confirm the following:
- A file with accented characters created via AFP is visible via:
- Xinet Portal
- SMB client browsing
- A folder with accented characters created via AFP is visible via SMB and supports required operations (browse/rename/delete).
- If your workflow depends on AFP, verify AFP connectivity from the macOS versions used in production (AFP support and behavior can vary by client OS/version).
Frequently Asked Questions
- 1. How do I know if I’m hitting this exact issue?
- You’ll observe behavior like: “Mount the same volume in SMB, and you will find that the file (or folder) is invisible,” specifically when the item (file/folder) was first copied to the volume via AFP and its name contains accented characters. Renaming the item to remove accents makes it appear/work in SMB.
- 2. Which versions contain the confirmed fix?
- The fix was confirmed after upgrading to Xinet Server 2026.02.27 (with Portal 2025.12.19). An earlier release (2025.12.19) was reported to fix files but still left a folder-management issue from SMB in customer testing.
- 3. Why couldn’t the issue be reproduced by uploading a file in the Portal and checking SMB?
- The reported reproduction requires the file/folder to be created on the volume via AFP first. Creating the item via Portal and then checking SMB may not trigger the same AFP/SMB interoperability path.
- 4. Is there a workaround if I can’t upgrade immediately?
- A temporary mitigation is to disable the SMB modules
xinetnamespaceandxinetfilehandlin, which was observed to restore SMB visibility for accented-name items created via AFP. Test this carefully outside production because module changes may impact SMB functionality. - 5. How should I verify the fix after upgrading?
- Create both (1) a file and (2) a folder with accented characters in the name via AFP on the target volume, then mount the same volume via SMB and confirm visibility and required operations (including folder deletion/rename if that was impacted).
Priyanka Bhotika
Comments