Skip to main content
Delphix

Creating a File Masking CIFS/SMB Connection (KBA7488)

 

KBA

KBA# 7488

Applicable Delphix Versions

Click here to view the versions of the Delphix engine to which this article applies
Major Release All Sub Releases
6.0 6.0.0.0, 6.0.1.0, 6.0.1.1, 6.0.2.0, 6.0.2.1, 6.0.3.0, 6.0.3.1, 6.0.4.0, 6.0.4.1, 6.0.4.2, 6.0.5.0, 6.0.6.0, 6.0.6.1, 6.0.7.0, 6.0.8.0

How to Create a File Masking CIFS/SMB Connection

The aim of this knowledge article is to provide an example of setting up a Common Internet File System (CIFS) connection for file masking. This includes delimited, flat, and XML files.

Prerequisites

  • A Delphix masking Engine of Version 6 or higher.
  • Port 445 open between the masking engine and the target server.
  • Access to the Masking Engine API client.
  • An Administrator level user account

To set up the CIFS connection

Complete the following procedure to create the CIFS connection.

  1. Navigate and log in to the the Masking engine API-client. 
    1. The Masking API client can be accessed by adding 'api-client' to the end of the masking engine URL, for example http://mymaskingengine.delphix.com/masking/api-client
    2. Log in and authorize the API connection:
      clipboard_e7e081295f6bbcc70d841e78ddd56de5d.pngclipboard_e2b6678912da92a3325255619d38991dc.png
  2. Ensure the folder is being shared, Windows Example:
    clipboard_e50603d6a01508540a0c81d75a44c03e2.png
     
  3. Add the CIFS configuration to the mountFilesystem part of the API client.
    Open the mountFilesystem section of the API client.
    In the Body enter the required CIFS parameters Example:

    {
    "mountName": "my_new_cifs_connection",
    "hostAddress": "maskingengine.delphix.com",
    "mountPath": "/filemasking",
    "type": "CIFS",
    "connectOnStartup": true,
    "options": "username=delphix,password=delphix,domain=ad.domain.com,vers=3.0"
    }


    Please note the mountPath must be a slash / not a backslash \ when creating the connection. 

    Further mount options and information can found in the documentation: https://maskingdocs.delphix.com/Connecting_Data/Managing_Remote_Mounts/

    Screenshot:
    clipboard_e3e4d5c8e9e3c1e7daab50fb1846831d5.png
     
  4. You will need to know the mountID. Each time a new mountFilesystem is added this value will increment by one. All of the available mounts can be listed by the GET /mount-filesystem section, this will show all the available mounts and the mountID value.
  5. You now need to Connect the masking engine to the CIFS share, this is again done through the CLI client. Enter the mountID value and Execute, this should now be connected.

    clipboard_e4baecbaa2e5ce49bb343aadbf4043b4d.png
     
  6. The status of the connection can be checked by either the GET /mount-filesystem/ or GET /mount-filesystem/{mountID}
    If everything is working, then 'ACTIVE' should be displayed.
    Example:

    clipboard_eecec3dc8f4a8d7f1f1374c107aaef38f.png
  7. The masking file connection can be created. Under the Mount Name the newly configured CIFS connection will be visible:

    clipboard_e8be8ef0a81b0b188ba00e52ba25b3771.png
     
  8. The Ruleset can be created and should display all the files under the remote directory:

    clipboard_ed23869eae5e6bcad7daafc7726698238.png

If any issues are encountered please either post on our community pages or reach out to Delphix support for assistance.

 

Related Articles

The following articles may provide more information or related information to this article: