Version: eXtendFiles 1.8.7 and above
Audience: Administrator
Overview
To use eXtendFiles with Microsoft Azure, you must configure settings in both:
- Microsoft Azure (storage account and container).
- NetSuite (eXtendFiles Configuration).
You need administrator access in both systems to complete this setup.
Prerequisites
Before you start, confirm you have:
- A NetSuite role with Administrator access.
- Access to the Microsoft Azure portal with permissions to manage Storage accounts.
- The name of the Azure storage account you will use.
- The name of the container (blob container) you will use.
Configuration
Microsoft Azure Configuration
If not already created, use the Microsoft documentation below to create the Azure resources eXtendFiles needs:
- Create a storage account: Create a storage account
- Create a container: Create a container
Find your Azure access key
After you create the storage account and container, find the access key to enter in NetSuite:
- In Microsoft Azure, go to Home → Storage accounts.
- Select your storage account.
- Click Access keys.
- Copy one of the two keys shown. You can use either key for eXtendFiles.
NetSuite Configuration
Complete the steps below in NetSuite:
- Go to eXtendTech → eXtendFiles → eXtendFiles Configuration.
- In Storage Settings → General, set the Storage Type to. Azure Blob Storage.
- Enter the Azure values into the Storage Information fields.
Field definitions
| Field | What to enter |
|---|---|
| Storage Account Name | Your Azure storage account
name. |
| Access Key | An access key from Access keys in the Azure portal for your
storage account. |
| Container | The Azure container (blob container) name used for uploaded files. |
| Additional Containers | Optional. Any additional Azure container names eXtendFiles should use. |
Versioning & Additional Settings
Versioning
- To enable file
versioning, turn on
the "Versioning"
preference.
Delete Files From
Storage
- To delete
files from Azure when all related
eXtendFiles records are
deleted in NetSuite, turn on
the "Delete Files From
Storage" preference.
Direct Upload (Highly recommended)
- After configuration in Azure, turn this on to enable Direct
Upload and improve file upload
performance. Configure eXtendFiles for Direct Upload to Microsoft Azure.
Recommendation: We highly
recommend configuring Direct
Upload for Azure storage. It
significantly improves upload performance
and reliability, especially for larger
files.
Troubleshooting
Error: “Server failed to authenticate the request…”
If you see this error when uploading after connecting to Azure:
- Server failed to authenticate the request. Make sure the value of Authorization header is formed correctly including the signature.
Confirm the correct Azure access key was entered in the Access Key field on the eXtendFiles Setup page.
Azure reference: View account access keys
Error: “The specified resource does not exist.”
If you see this error when uploading after connecting to Azure:
- The storage account and container in eXtendFiles match Azure, and you can read content (i.e., view previously uploaded files), but you cannot add content. If this happens, confirm your Azure subscription is valid. If the subscription has lapsed, you may still be able to read content, but you cannot add new content and will encounter this error.
Error: “getaddrinfo ENOTFOUND”
If you see this error when uploading after connecting to Azure:
- The storage account specified in eXtendFiles does not match the actual storage account name in Azure.
Error: “ContainerNotFound: The specified container does not exist.”
If you see this error when uploading after connecting to Azure:
- The container specified in eXtendFiles does not match the actual container name in Azure.
Frequently Asked Questions (FAQs)
Q: Which Microsoft Azure access tiers are supported?
A: Currently, eXtendFiles supports the hot tier access tier.