Archive Shares are good for using to backup or archive your files. The share creates a one-way sync, which syncs your real files from the Morro Data share to the specified bucket in a supported cloud storage provider.


Select the share by clicking on the Share badge to open the Share Detail panel.




Note: Changes to the Share may require the device to reset services that may interrupt connections to the device. Devices may take a few seconds before they are accessible again.




From this window, you may edit the share's information. The share information is divided into 5 sections:

  • General
  • Permissions
  • Schedule
  • Advanced
  • Analyze

After making any changes, you may click APPLY to save changes without closing the window, or click SAVE to save changes and close the window.


Note: Changes to the Share may require the device to reset services and may interrupt connections to the device. Devices may take a few seconds before they are accessible again.

General

Edit the Name, Comment (optional), and view the Share Type.





Name

Give the pool any name you wish. You may want to choose a name that describes the group of files in the pool such as the function of the files or an organizational unit.


Comment (optional)

Optionally, you can create or edit a comment for the pool.


Share Type

Archive shares cannot change their Share Type.


Folder in Cloud Storage

Folder in the bucket where the Archive share file tree is created.


Server Side Encryption

Encryption option selected for encrypting files in the bucket. Do not change the encryption method or the encryption key. Otherwise, the files in the bucket may no longer be accessible.



Permissions

Manage permissions for the share. 


Choose which type of permissions to set from the navigation menu on the left:

  • User
  • Gateway (CacheDrive)


User Permissions

Set the permissions for users and groups in Morro Data.


Note: For Active Directory Mode, admins must first import users and groups from Active Directory. For Azure AD mode, admins can first import users and groups from Azure AD to set user and group permissions.


Default  Access

The permissions for all users in the system.


Read/WriteUsers can read and write files to the share. Users must be authenticated to access the share. Admins can specify users/groups to a Read Only exclusion list.
Read OnlyUsers can read files from the share. Users must be authenticated to access the share. Admins can specify users/groups to a Read/Write exclusion list.
No AccessUsers cannot see the share. Admins can specify a Read Only and Read/Write exclusion lists.


Allow Guest Access

If Allow Guest Access is enabled, any user will have access to the Share. The default share created by Morro Data has Allow Guest Access enabled.


Exception List

Use exceptions to set Read/Write or Read-Only access for specific users and groups. By default, both users and groups are listed in this section. You may filter the list by name or by type (User, Group or All).


Choose either "Read/Write" or "Read Only" for the grant permission for that user or group. 


In the example above, the share has no Guest Access, which means users  must enter a user name and password to access the share. 


Default Access is set to "No Access", which means only users in the exclusion lists can access the share. 


Exclusion Lists specifies which users have Read/Write or Read Only access to the share.


Read/Write ListUsers in the groups Sales, Sales - East, Sales - West, Executive, Local Admin can read and write files to the share.
Read Only ListUsers in the group Marketing can only read files from the share.


Edit Gateway Permissions

Set which gateway has access to the share. By enabling restricting gateway permissions, you are creating a location based security for access to the shares in your system. 



Source Gateway

Specify the Gateway with Write permissions for the share.


Additional Destinations

Specify which additional gateways will have Read permissions for the share. These gateways may not write to the shares.


Access

The Access column sets whether the gateway has access to the share. 


Prefetch

Check the box for prefetch to have all files copied to the share downloaded to the gateway immediately. When prefetch is enabled, the user does not need to wait for the file to be downloaded from the cloud before it is available.


Schedule

Specify the day and time to perform the sync.  You can choose a day of week and hour of the day to perform the sync.


Set the Sync Schedule

The schedule shows a box for each day of week to perform the sync. Select one or more days to perform the sync.

Choose the hour in the day to perform the sync. The hour of day applies to each day selected.


Select All days of week and hours

Click SELECT ALL to select all boxes.


Clear All days of week and hours

Click CLEAR ALL  to deselect all boxes.


Manually start a Sync job

Click SYNC NOW to perform the sync immediately.


Cancel sync job

Click CANCEL to running or pending job.


Additional Options

The following options extend functionality for the share:

  • Do After
  • Enable API Control
  • Send Job Status

Do After

Choose the share whose job should be run after the job of the current share is completed.

  • Only another Replicate share can be selected.
  • Only a share with the same source gateway can be selected.
  • Two shares cannot choose each other (causing a loop).


Enable API Control

Enable the setting and click APPLY to see the available API endpoint for the share.



For more information about the incoming API, please refer to the article: Incoming API


Send Job Status to Apps

When the Replicate Share job completes, it will send a message to the selected Slack account. For more information on how to set up the Slack account, please refer to the article: Morro Slack App


Advanced

The advanced tab manages the settings for the following sections of the share:

  1. Upload
  2. Samba
  3. Security


Upload


Sync exclusion in Posix ERE

By default Morro Data excludes certain files from upload. To customize which files are uploaded, enable the feature and add a new Posix ERE text. To create the Posix ERE, use the Sync Exclusion List generator. Click on the ? to open the generator page. For more information, please refer to the article: Sync Exclusion List.


Samba


Don't use ea to save streams

Turns off the xattr setting in samba which can improve file performance. Removing xattr disables extended attribute settings which is used in features such as Windows ACL.


Hide share from browsing

Disables share from being searchable by browsing in Explorer or Finder. Users with access permissions can still access the share. Behaves like hidden shares in Windows.


Disable oplocks

Oplocks essentially means that the client is allowed to download and cache a file on its hard drive while making changes; if a second client wants to access the file, the first client receives a break and must synchronize the file back to the server. This can give significant performance gains in some cases; some programs insist on synchronizing the contents of the entire file back to the server for a single change.


Prevent folder rename when used (slower)

Prevents users from renaming folders if another user has a file in the folder or a sub-folder open. This results in a folder lock.


Security


Use the Folder Security to specify access permissions to sub-folders in a share. Click "Edit folder security" to open the Folder Security panel.



Share Folder Owner

Sets the CREATOR_OWNER value for share.


Share Folder Group

Sets the CREATOR_GROUP value for the share.


Access for this Folder

Use this section to set the add or delete users/groups from the ACL permissions list and specify the access permission for users or groups for the share.


The following actions can be performed for the share folder:


ActionDescription
ADDAdd a users or group to the ACL permissions list.
DELETERemove a user or group from the ACL permissions list. Check a user from the list of users and groups in this section and click DELETE.
REVERTSet all the values back to the way they were set before making any changes.
READ WRITEGrants users Read/Write access. Works as full modify privileges.
READ ONLYGrants users Read only access. Users cannot write to the folder or overwrite the files.
NO ACCESSPrevents all access to the files and folders.


To add more users or groups to the Access Control Lists, click ADD. The window to add more users and groups will open.


To add additional users and groups to the Access Controls Lists:


1. Select the users and groups from the "User or Group name" panel.

Use the + next to the item to choose the users or groups from the list of users and groups in the system. The selected users and groups will be moved to the section "User/Group to be added to Permissions"


Search for a specific user or group in the field "User or Group name".


2. Set the Permissions for the users and groups that were added.

Set the Access settings for the Users and Groups from the dropdown list. The valid values are:

  • NO: No Access
  • RW: Read/Write Access (Full control)
  • RO: Read-Only

3. Select from "Add user access permissions for this folder" or "Add user access permission for new folder/file" to choose to which set of permissions the users and groups will be added.


Click ADD to complete the process.


Click SAVE to accept changes.


Note: Changes to the Share may require the device to reset services and may interrupt connections to the device. Devices may take a few seconds before they are accessible again.



DELETE a Share

Click DELETE to permanently delete a share. A pop-up window will appear with a warning message about deleting shares. You will need to type the name of the share into the pop-up window to confirm deletion of the share.


Screen%20Shot%202016-10-10%20at%203.05.30%20PM.png


Without typing the Share name properly, the DELETE button in this window is greyed out and not functional.

Note: Proceed with caution. If you delete a share, all files in the share will be permanently deleted and cannot be recovered.


A gateway must be on-line in order to delete a share. If no gateways are online, the DELETE button will be disabled.

Note: When deleting a share with a large amount of data, it will take time for the system to complete the process. During that time, you may still see the data is available.