Apps & Integrations
      Back to home
      1. Help Center - MASV
      2. Apps & Integrations

      How to connect MASV with OpenDrives

      Use MASV to save files to and send files from OpenDrives storage

      OpenDrives is an industry-leading media storage software solution. MASV makes it easy for you and your collaborators to send large files to or from your OpenDrives Atlas storage system.

      Integration overview

      Here is an overview of the integration process:

      1. In the MASV Web App, start the Add Integration process to get the information you need for OpenDrives.

      2. In OpenDrives, select the MASV Recipe and configure it with the information you copied from the MASV Web App.

      3. Enable the MASV Pod that OpenDrives creates from the Recipe.

      4. In the MASV Web App, finalize the secure connection with OpenDrives.

      5. Select or create a MASV Portal and enable the new OpenDrives integration for the Portal.

      Before you begin

      • Ensure you have the permissions you need to set up the integrations in the MASV Web App (Team Owner or Admin) and OpenDrives.
      • Ensure you and the intended users have the permissions needed to access the transfer location.

      To generate integration credentials in MASV

      1. As the Team Owner or Administrator, open the MASV Web App, and from the sidebar on the left, select Integrations.

      2. On the Integrations page, select the Available Integrations tab, and in the Storage Device Integration area, select OpenDrives.

      3. In the Add Integration window, type a name in the Connection Name box. For example, “Save to OpenDrives”.masv-opendrives-add-integration

      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 MASV 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 directory that uses the package name. To deliver directly into the Target Directory, select the checkbox. 

      7. (Optional for “Send from Storage”) In the Source Directories box, type a path to limit access to the specified directory.

      8. Select Next.

      9. The Register Integration window appears. Leave the browser window open so you can copy the values you need for the OpenDrives integration. Open a new browser tab for your OpenDrives dashboard.masv-opendrives-register-integration

      To create a MASV Pod in OpenDrives.

      1. Log in to your OpenDrives Dashboard, and from the sidebar on the left, select Containerization > Recipes.opendrives-dashboard

      2. From the list of recipe cards, select the MASV card (a check mark appears in the upper right corner of the card). opendrives-masv-recipe-card

      3. Scroll back up to select the Create button in the upper right corner.opendrives-create-button-from-recipe

      4. (Optional) On the Create New Pod page, in the Name box, type a new name for your pod. Note:All pod names are prefixed with the tag 'od-pod'. Pod names can contain only alphanumeric characters, underscores, and hyphens.opendrives-create-new-pod-config-page

      5. In the text editor pane, edit the following values:masv-opendrives-recipe-in-text-editor-circled

        1. Ports: Delete the “ports” section unless required for specific workflows.

        2. Volumes: Enter the path for the data volume. We recommend using /data as part of your storage path so it’s easy to identify as the destination folder that you’ve mapped to the container’s /data volume.

        3. MASV_ID and MASV_SECRET: Copy and paste the ID and Secret from the Register Integration window in the MASV Web App.

          1. Note: If the Secret includes any dollar sign symbols ($), type a second dollar sign beside any single dollar signs to avoid verification issues. 

        4. MASV_NAME: Copy and paste the Name you used for the integration in the MASV Web App. Note: The name doesn’t need to match, but it helps you identify connections.

        5. MASV_PERM: Copy and paste the Permissions value from the MASV Web App (will be a “w” or “r” depending on the Transfer Direction you selected).

        6. MASV_DIR: We recommend using the default setting: /data. Delivery errors occur if there is a mismatch with the volume you defined. 

      6. To validate the code, select the Test button below the text editor pane.

      7. After the test is successful, select the Save button below the text editor pane.

      8. On the Pods page, wait for the new MASV pod to load, and select the corresponding toggle to enable the pod.

        opendrives-masv-pod
      9. On the MASV pod card, select the pod name to display the pod information page.
      10. Select the Pod Services Logs tab, and look for code 200 to confirm that the connection is ready.opendrives-pod-services-log-tab

      To verify the OpenDrives integration in MASV

      1. After setting up a MASV pod in OpenDrives, return to the MASV Web App browser window.

      2. In the Register Integration window, select Done.

      3. On the Integrations page, select the My Integrations tab, and refresh the browser window to confirm that the connection is listed and that the Status column displays the connection as OK.opendrives-masv-my-integrations

      That's it! You can now:

      Tip: For more information about the MASV Agent and optimizing storage connections, please see the MASV Developer Documentation.