| Both sides previous revision Previous revision Next revision | Previous revision |
| omv7:omv7_plugins:resetperms [2024/01/27 18:02] – chente | omv7:omv7_plugins:resetperms [2024/04/27 16:54] (current) – [Summary] chente |
|---|
| {{indexmenu_n>8}} | {{indexmenu_n>5}} |
| <html><center><b>Reset Permissions Plugin For OMV7</b></center></html> | <html><center><b>Reset Permissions Plugin For OMV7</b></center></html> |
| |
| |
| ===== Summary ===== | ===== Summary ===== |
| | [[omv7:nas_permissions_omv7|{{ :omv7:omv7_plugins:resetperms7-4.jpg?direct&200|NAS Permissions}}]] |
| [[misc_docs:nas_permissions|{{ :omv6:omv6_plugins:resetperms3.jpg?direct&200|NAS Permissions In OMV}}]] | * Openmediavault-resetperms provides a tool to **modify the permissions of shared folders and all their content at the file system level** from the OMV GUI. The form displays a column with the services associated with each shared folder. |
| * Openmediavault-resetperms provides a tool to **modify the permissions of shared folders and all their content at the file system level** from the OMV GUI. It also shows a **list of shared folders and associated services**. | |
| * Modifying permissions can be useful if your file system comes from another system and you want to reset the permissions of your folders, if you want to remove ACL permissions, or if you want to customize the permissions of each shared folder differently. Or if you simply want to change the permissions of a shared folder that is already created. | * Modifying permissions can be useful if your file system comes from another system and you want to reset the permissions of your folders, if you want to remove ACL permissions, or if you want to customize the permissions of each shared folder differently. Or if you simply want to change the permissions of a shared folder that is already created. |
| * This plugin does not make changes to the permissions applied to the services (Samba, NFS, ...) if not at the file system level. Changes applied at the file system level will take precedence over the permissions configured in your services if they are more restrictive. Once the file system level permissions have been applied through this plug-in, you can further restrict these permissions by configuring each service. You can consult extended information about [[misc_docs:nas_permissions|NAS permissions in OMV]] | * This plugin does not make changes to the permissions applied to the services (Samba, NFS, ...) if not at the file system level. Changes applied at the file system level will take precedence over the permissions configured in your services if they are more restrictive. Once the file system level permissions have been applied through this plug-in, you can further restrict these permissions by configuring each service. You can consult extended information about [[omv7:nas_permissions_omv7|NAS permissions in OMV 7]] |
| * **Changes applied to a shared folder using this plugin will be applied recursively**, that is, they will be applied to the folder and all its subfolders and files equally. | * **Changes applied to a shared folder using this plugin will be applied recursively**, that is, they will be applied to the folder and all its subfolders and files equally. |
| |
| ---- | ---- |
| |
| <html><center>Under <b>Services</b> > <b>Reset Permissions</b> > <b>Reset Permissions</b></center></html> | <html><center>Under <b>Services</b> > <b>Reset perms</b></center></html> |
| \\ | \\ |
| {{ :omv6:omv6_plugins:resetperms1.jpg?direct&600 |Reset Permissions}} | {{ :omv7:omv7_plugins:resetperms1.jpg?direct&1000 |Reset Permissions 1}} |
| |
| ---- | ---- |
| |
| * Go to **Services** > **Reset Permissions** > **Reset Permissions** In the window do the following: | {{ :omv7:omv7_plugins:resetperms2.jpg?direct&600|Reset Permissions 2}} |
| * In **Shared folder** Select the shared folder you want to modify (you can create a new shared folder by pressing the **+** button on the right). | * Go to **Services** > **Reset Perms** In the tab you can see a list of the system's shared folders. To modify the permissions of a folder do the following: |
| * In **Permissions** Choose the permissions you want to apply. | * Select a folder in the list (yellow color). |
| * If you want to reset the permissions of a folder to the standard OMV permissions, set this field with the options: | * Press the **Reset permissions** menu button. A dialog box will open to modify the permissions of the selected folder. In this dialog box do the following: |
| * ''Administrator - read/write, Users - read/write, Others - read-only'' | * In the Permissions field, select the permissions you want to apply to the folder. |
| * If you want to remove the folder's ACL permissions, press the **Clear ACLs** box. This will reset the ACL permissions by recursively removing all ACL permissions for this folder, its subfolders and files. | * If you want to reset the permissions of a folder to the standard OMV permissions, set this field with the options ''Administrator - read/write, Users - read/write, Others - read-only''. |
| * In OMV by default ACL permissions are not used, so if you want to reset the permissions of a folder to the standard OMV permissions select **Clear ACLs** permissions. | * If you want to remove the ACL permissions from the shared folder, click the **Clear ACLs** button. By default, shared folders in OMV do not have ACL permissions. |
| * Press the **Save** button | * Press the **Reset** button. The changes will be applied recursively to all subfolders and files in the shared folder. |
| * Press the **Reset Permissions** button. The chosen permissions will be applied to the shared folder and to all its contents, subfolders and files. | |
| * When you're done, tap **Shared folder** again and select none. If you don't, the folder will be linked to this service, so if you ever want to delete it, you won't be able to until you remove it from the menu. | |
| |
| | \\ |
| | <html><body><table width="100%" border="0"><tr><td colspan="2" style="background-color:#FFB663;height:30px;"><strong><span style="color:#FFFFFF;font-size:110%;">  |
| | Warning |
| | </span></strong></td></tr><tr><td style="background-color:#FFE4A6;height:25px;width:380px;"> |
| | This plugin can break your system if not used properly.<br> |
| | <b>DO NOT CHANGE THE PERMISSIONS OF THE DISK DRIVE WHERE THE OPERATING SYSTEM IS INSTALLED.</b> Doing so could cause you to lose your system and be forced to reinstall.<br> |
| | For the same reason, you should not modify the permissions of the folder where docker is located or the persistent data of any of the containers. |
| | </tr></table></body></html> |
| |
| ---- | ---- |
| === Shared Folder in Use === | === Shared Folder in Use === |
| |
| * Check the status of shared folders, associated services | {{ :omv7:omv7_plugins:resetperms3.jpg?direct&600|Reset Permissions 3}} |
| | The **Services** > **Reset perms** plugin tab displays all shared folders on the system and several columns with useful information. One of them is the **In use by** column. This column is especially useful if you intend to delete a shared folder. |
| ---- | * Delete a shared folder. |
| | * OMV does not allow you to delete a shared folder if it is in use by any service. In the **Storage** > **Shared folders** tab, the icon to delete the folder will be disabled. |
| <html><center> Under <b>Services</b> > <b>Reset Permissions</b> > <b>Shared Folders in Use </b></center></html> | * To delete a shared folder in OMV you must follow the reverse process to the one you followed to create it. That is, you must first delete the services associated with the shared folder. After that the **Delete** button on the corresponding tab will allow you to delete the shared folder. |
| | * Unmount a file system. |
| {{ :omv6:omv6_plugins:resetperms2.jpg?direct&600 |Shared Folders in Use}} | * What was explained above for shared folders applies in the same way to file systems. To delete a file system, you must first delete the shared folders associated with that file system. |
| | * Therefore the process to delete a file system begins by removing the services associated with the shared folders of that file system. After that you can delete those shared folders. And after that the unmount button of the file system will be activated and you can unmount it in the OMV GUI. |
| ---- | |
| | |
| * Go to **Services**> **Reset Permissions**> **Shared Folders in Use** Here you can see a list of your OMV shared folders, next to each of them you can see the services that are currently associated with that shared folder. This is useful if at any time you want to delete a shared folder, since in order to do so, you must first remove the services that point to that shared folder. You just have to consult this list and delete them (or point to another folder) one by one. | |
| \\ | |
| <html><body><table width="100%" border="0"><tr><td colspan="2" style="background-color:#FFB663;height:30px;"><strong><span style="color:#FFFFFF;font-size:110%;">  | |
| Beginners Note | |
| </span></strong></td></tr><tr><td style="background-color:#FFE4A6;height:25px;width:380px;"> | |
| This plugin can break your system if not used properly.<br> | |
| <b>DO NOT CHANGE THE PERMISSIONS OF THE DRIVE WHERE THE OPERATING SYSTEM IS INSTALLED.</b> Doing so could cause you to lose your system and be forced to reinstall. | |
| </tr></table></body></html> | |
| |
| ---- | ---- |