How to connect a storage device to MASV

Learn how to integrate MASV with local storage devices and online block storage—Amazon EC2 storage, NAS, SAN, and more

Storage Device integration is available for subscription and custom plans . Please contact sales@masv.io for details.

You can integrate MASV with your on-premises storage, such as NAS (network-attached storage) and SAN (storage area network) devices, as well as cloud block storage. For example, you can integrate MASV with your Amazon EC2 (Elastic Compute Cloud) storage, such as Amazon EBS (Elastic Block Storage) and Amazon EFS (Elastic File Storage). With the addition of MASV Storage Gateway technology, MASV evolves from an amazing file transfer solution into an ideal central ingest solution.

This page includes the following topics:

What do you need to make it happen?

It starts in the MASV Web App

To integrate a storage device with MASV

To edit the Target Directory or Parent Folder for a storage device

To rename a storage device integration

To delete a storage device integration

What do you need to make it happen?

The following list includes what you need to get started:

• A target storage device: This can be an on-premises storage device, typically a NAS, SAN, or computer used as a server. It can also be a virtual storage device, for example, storage connected to an Amazon EC2 instance (Amazon EBS or Amazon EFS). The device must be running a platform supported by the MASV Agent (see description below).
• MASV Web App: You need to be an account Owner, Admin, or Integration Manager (role).
• Terminal application: Your target storage device needs to have a terminal application available in order to set up and manage the connection.
• MASV Agent: You must install the MASV Agent on the storage device, either in advance or by following the prompts in the MASV Web App. The MASV Agent is available for Linux and Docker platforms. For more information about installing the MASV Agent, see https://developer.massive.io/transfer-agent/latest/.

It starts in the MASV Web App

You can create and manage storage device integrations in the MASV Web App. When you integrate a storage device, you create a registered connection that includes an ID and Secret Key. Each connection is directional, so you can create more than one connection for a storage device. For example, you can create a connection to save files to storage (write) with an inbound connection and also create a connection to send files from storage (read) with an outbound connection. The name you choose and the transfer direction display on the My Integrations page, along with the creation date and status of the connection. You can rename or delete a connection from the My Integrations page. You can also edit the relative path for your integration by changing the Target Directory and Parent Folder Options.

Security considerations

Connections to storage devices are protected by a Secret Key, authentication processes, as well as encryption of traffic between storage and MASV.

Firewall considerations

Please review the port, host name, and IP address information to ensure your firewall is configured properly for MASV transfers: How to ensure your firewall works with MASV.

To connect a storage device to MASV

1. In the MASV Web App, as Team Owner, Admin, or Integration Manager (role), select Integrations from the sidebar on the left.
2. From the Integrations page, select the Available Integrations tab, and select Storage Device.
3. In the Add Integration window, type a name in the Connection Name box.
4. In the Transfer Direction area, choose a direction:
   • Save to storage: For inbound files (Write)--MASV transfers files to the storage device.
   • Send from storage: For outbound files (Read)--MASV transfers files out of the storage device.
5. (Optional for "Save to storage") In the Target Directory box, type a relative path. You will be able to edit this directory from the Web App as needed.
6. (Optional for "Save to storage") In the Parent Folder Options, leave the checkbox unselected if you want to save the files in a folder that uses the package name. To deliver directly into the Target Directly, select the checkbox. 
7. Select Next.
8. In the Register Integration window, if you have not already installed the MASV Agent on your storage device, select the Install MASV Agent button, select the installation for your platform, and follow the installation instructions.
9. In the Register Integration window, copy the code provided and paste it into the device’s Terminal window.
10. Edit the root-path within the code to point to the directory you want to access. 
11. When the Terminal window responds with Code: 200, select the Done button.
12. Your new integration displays in the list on the My Integrations tab. The status will indicate OK if the connection is successful and ready to use. You might need to refresh the page to update the connection status.

To edit the Target Directory or Parent Folder Options for a storage device

1. In the MASV Web App, as Team Owner or Admin (role), select Integrations from the sidebar on the left.
2. From the Integrations page, select the My Integrations tab.
3. In the Action column for the integration that you want to edit, select the Action icon , and select Edit.
4. In the Edit Integration window, change the Target Directory or Parent Folder Options.
5. Select Next to apply the changes.

To rename a storage device integration

1. In the MASV Web App, as Team Owner or Admin (role), select Integrations from the sidebar on the left.
2. From the Integrations page, select the My Integrations tab.
3. In the Action column for the integration that you want to rename, select the Action icon , and select Rename.
4. Type a new name for the connection and select OK.

To delete a storage device integration

1. In the MASV Web App, as Team Owner or Admin (role), select Integrations from the sidebar on the left.
2. From the Integrations page, select the My Integrations tab.
3. In the Action column for the integration that you want to rename, select the Action icon , and select Delete.
4. Type a new name for the connection and select OK.