Admin Guide
Search…
File Storage
Configuring the file storage for your domain

Overview

The Files module enables you to have a secure document management system in your company. It helps you organize, share, and keep all your work files across different devices in sync.
MangoApps integrates with 3 external storage solutions - Amazon Simple Storage Service (S3), Storage Area Network (SAN), and Box. Network admins can configure the file storage for the entire domain via the Admin Portal which automatically synchronizes all MangoApps files and folders to the chosen repository in real-time.
Admin Portal > Modules > Files > File Storage
  1. 1.
    Amazon Simple Storage Service (S3): Select the Amazon Simple Storage Service (S3) option to use your Amazon S3 account as the default file storage for your domain and save all your MangoApps files to the configured Amazon S3 cloud bucket. If selected, automatically uploads all your domain files to your Amazon S3 account. Click the Configure Custom S3 Account button to use a custom Amazon S3 account for file storage.
  2. 2.
    Storage Area Network (SAN): Select the Storage Area Network (SAN) option to use your pre-configured SAN device as the default file storage for your domain and save all your MangoApps files to an external physical storage device. If selected, automatically uploads all your domain files to the configured SAN device. Click the Configure Custom SAN Account button to use a custom SAN account for file storage.
  3. 3.
    Box: Select the Box option to use your Box account as the default file storage for your domain and save all your MangoApps files to the configured Box account. If selected, automatically uploads all your domain files to your Box account. Click the Configure Box Account button to connect your Box account with MangoApps.
By default, MangoApps uses Amazon S3 out-of-the-box as the storage repository to store all uploaded files in your domain.

Configuring Custom S3 Account

To configure a custom Amazon S3 account, click the Configure Custom S3 Account button for Amazon Simple Storage Service (S3):
Configuring Custom S3 Account
  1. 1.
    Enter a name for the S3 account in the Account Name text box. For example, enter QA S3 Account. MangoApps uses this name to distinguish your account from the default MangoApps S3 account.
  2. 2.
    Enter a short description for the Amazon S3 account in the Description text box.
  3. 3.
    Enter the username of your S3 account in the S3 Access Key text box. The username is an alphanumeric text string that uniquely identifies the user who owns the account.
  4. 4.
    Enter the access key for the specified username of your S3 account in the S3 Secret Key text box. The access key unique, known only to the owner of the account and used for authentication and authorization.
  5. 5.
    Enter the bucket name of your S3 account in the S3 Bucket name text box. A bucket is a container for objects stored in Amazon S3. Every object is contained in a bucket.
  6. 6.
    Click the Test Connection button to check the entered details and connect to the custom Amazon S3 account. The system displays a success message 'Connection to storage location successfully established.' on validating and successfully connecting to the S3 account.
  7. 7.
    Click the Save and Activate button to activate the custom Amazon S3 account as your default file storage for MangoApps.
No two accounts can have the same AWS Access Key.

Configuring Custom SAN Account

To configure a custom SAN account, click the Configure Custom SAN Account button for Storage Area Network (SAN):
Configuring Custom SAN Account
  1. 1.
    Enter the base location of your storage device in the SAN location text box. This is where all your files will be stored.
  2. 2.
    Click the Test Connection button to check the entered details and connect to the custom SAN account. The system displays a success message 'Connection to storage location successfully established.' on validating and successfully connecting to the SAN device.
  3. 3.
    Click the Save and Activate button to activate the custom SAN account as your default file storage for MangoApps.
The SAN File Storage option is available only for the MangoApps Private Cloud and On-Premise deployment models. For more information on the deployment options for MangoApps, click here.

Configuring Box Account

To connect your a Box account, click the Configure Box Account button for Box:
Connecting Box Account
  1. 1.
    Enter the your Box account email address in the Email Address text box.
  2. 2.
    Enter the password of the Box account for the mentions email address in the Password text box.
  3. 3.
    Click the Authorize button to verify the details and authorize MangoApps to access the Box account.
  4. 4.
    Box as a storage is available as an option for MangoApps private cloud customers at this time.

FAQs

What happens if I disable the Files module?

Disabling the Files module from the Admin Portal (Admin Portal > Modules > Setup) does NOT delete any files and only hides the module on the User Portal. MangoApps displays a warning message "This module is currently turned off by the Domain Administrator" on the User Portal when users try to access the Files module on the User Portal. Users can still attach files to posts, pages, updates, chats, private messages, etc. on the User Portal and MangoApps automatically saves the files to the storage configured for your domain.

Is there a file size limit for document uploads?

The file upload limit varies between different interfaces such as web, messenger, mobile portals and also based on the storage option used. Here are some limits for file uploaded when using SAN and Amazon S3 as storage for MangoApps.
SAN:
  1. 1.
    Maximum upload size per file from web portal - 2 GB
  2. 2.
    Maximum upload size per file in chat and messenger - 2 GB
  3. 3.
    Maximum upload size per file from file sync - 10 GB
  4. 4.
    Maximum upload size per file from iOS and android platforms - 200 MB
For all the platforms(web, messenger and mobile) with SAN as storage, you can play/stream video files online upto a size of 1 GB per video file without downloading them.
Amazon S3:
  1. 1.
    Maximum upload size per file from web portal - 5 GB
  2. 2.
    Maximum upload size per file in chat and messenger - 2 GB
  3. 3.
    Maximum upload size per file from file sync - 10 GB
  4. 4.
    Maximum upload size per file from iOS and android platforms - 200 MB
For all the platforms(web, messenger and mobile) with Amazon S3 as storage, you can play/stream video files online with no limit to its file size.
For all the platforms(web, messenger and mobile) and both the above storage options(SAN and Amazon S3), there is no download limit to the file size.
For any GIF content, the upload size is limited to 4 MB.

What are the visibility permissions for files & folders?

MangoApps has 4 visibility permissions for files and folders:
  • Private: Setting the visibility of a file or folder as 'Private' removes everyone it’s been shared with and only the owner will have access to it.
  • Shared: Setting the visibility of a file or folder as 'Shared' means only the users explicitly granted the permissions will have access to it.
  • Team: Files/folders created in a project, group or department have visibility setting of 'Team'. This means that all members of the team by default have access to it.
  • Full Company: Setting the visibility of a file or folder as 'Full Company' will allow everyone in your company access to it with Editor privileges.

To see how these configurations impact the Files on the User Portal, see Files in the User Portal Guide.

Did this article help? Your feedback adds value when we shape up the help articles. Hit the smiley
below to let us know!
Last modified 1yr ago