Windows: How to get the Iguana Service to Work with a Mapped Network Drive

Introduction

Mapped drives will only be accessible for the user that originally created the drive mapping. This means that the Iguana service must logon as that user to access that drive. In order to make mapped drives accessible for all users, you must change the Iguana Log On Properties for the Iguana service called iNTERFACEWARE Iguana.

There are two parts to this solution:

  1. Getting the Iguana service to work with your Windows network drive.
  2. Updating all of your VMD paths in Iguana to point to the network path name.

Note: The Local System account cannot be granted permissions to shared files or directories because they are on another machine. Therefore a different user must be created and granted share permissions, and then used as Iguana Service logon.

Issue [top]

How to get the Iguana Service to Work with a Mapped Network Drive.

Solution [top]

  1. Get the Iguana service to work with your Windows network drive:
    1. Create the Iguana service user and assign local administrator rights.
    2. Logon as the new user and map the shared drive.
    3. Enter “services” into Windows Search and run the Services App:

      This works on Windows 10 and Windows 7.

      search for services

    4. The Services window appears:
      services window
    5. Right-click iNTERFACEWARE Iguana, and select Properties.
    6. The iNTERFACEWARE Iguana Properties window appears, click the Log On tab:
      iguana logon properties
    7. Under Log on as, check This account.
    8. Enter the credentials for the Iguana Service logon user:

      This user must be the same one that mapped the shared drive.

      1. In the This account field, type in the user name, or use the Browse button to select the user from a list.
      2. Enter the user password in the Password and Confirm Password fields.
        Iguana service logon user
    9. Click OK to save your changes.
  2. Update all of your VMD paths in Iguana to point to the network path name.
    1. Determine what the network path name is for your shared network drive:
      1. Open the Command Prompt window.
      2. At the command prompt, type in the drive letter of your shared network drive.
      3. Then type in net use, for example:
        G:>net use 
        New connections will not be remembered. 
        
        Status Local Remote Network 
        
        ------------------------------------------------------------------------------- 
        OK G: \\server_namedirectory Microsoft Windows Network 
        
        The command completed successfully.
    2. Replace all of the file path names in your channel component properties with the network path:

      In the example above, the network path name is \\server_namedirectory for windows — on Linux or Mac it will be //server_namedirectory.

      • For example in a Windows (legacy) From Database component we show both the VMD and the SQLite database file on the shared drive:
        UNC path windows
      • And the same for a (legacy) From Database component on Linux or Mac:
        UNC linux mac

How it Works [top]

There are two parts to this solution:

  1. Getting the Iguana service to work with your Windows network drive.

    Mapped drives are only be accessible for the user that created the drive mapping. This means that the Iguana service must logon as that user that created that drive.

  2. Replace all of the file path names in your channel component properties with the network path for the shared drive.

    This applies to any component that uses files in its settings, e.g., VMD files, database files, certificate files, etc.