AX1001

Troubleshoot file access

When running an import or performing certain file processing actions, an error may occur when attempting to access the specified file or folder location. The most common reasons for this error are:

  • Using a mapped drive instead of a Universal Naming Convention (UNC) path.
  • Not having the appropriate permissions to the specified file or folder.

UNC path

When specifying the file or folder location, you must use a UNC path. A UNC path identifies the location using a server name instead of a mapped drive.

For example:

UNC path: \\servername\foldername\filename

Mapped drive: I:\foldername\filename

You cannot use mapped drives because they may vary by computer. The mapped drives that you see may be different than the mapped drives your colleagues see and different from the mapped drives seen by the Axiom servers. The UNC path is the only way to universally identify a location within your organization's network.

File/Folder Permissions

The Axiom Budget Planning and Performance Reporting server that performs the process must have the proper folder share and security permissions to access the specified file or folder location. The exact configuration depends on what process you are trying to perform.

Task being performed Where to configure permissions

Account

 Required permissions

Import: Source files located on network share local to the Axiom server
  • Cloud: Axiom Cloud Integration Server
  • On-Premises: Axiom Application Server

Network Service Account
  • Folder share: At least Read permissions
  • Folder security: At least Read, Read & Execute, and List Folder Contents

Import: Source files located on network share not local to the Axiom server
  • Cloud: Axiom Cloud Integration Server
  • On-Premises: Axiom Application Server

Application Server Computer Account
  • Folder share: At least Read permissions
  • Folder security: At least Read, Read & Execute, and List Folder Contents
File processing: Running via Scheduler
  • Cloud: Axiom Cloud Integration Server
  • On-Premises: Axiom Scheduler Server

Scheduler Service Computer Account
  • Folder share: Full Access
  • Folder security: Modify, Read & Execute, List Folder Contents, Read and Write
File processing: Running in Desktop Client

Desktop

User's Domain Account
  • Folder share: Full Access
  • Folder security: Modify, Read & Execute, List Folder Contents, Read and Write

NOTE: On-premises installations can use an optional system configuration setting, ETLAccessibleFolders, to further control access to folders when running imports. If you use this setting, any folder location in the import settings must also be listed in the ETLAccessibleFolders. If it is not, an error occurs when attempting to access files in the folder. The error message does not differentiate whether the folder is inaccessible due to general network permissions or due to the ETLAccessibleFolders setting.