Enabling local storage for large attachments in the Documents module
Who is this article for?IT Administrators responsible for managing the Application Server.
Application Server access and version 7.1.4.2 or above are required.
If you need to store large files in the Web client, you can enable this option on the Application Server. This helps to optimise the upload and download of attachments in the Documents module.
This article shows you how to configure the Application Server to allow for large files to be managed.
1. Updating the Dataportal config file
To update the config file:
- Browse to the Ideagen Quality Management Dataportal Config File.
By default, this is stored in C:\inetpub\wwwroot\QPulseDataPortal\web.config. - Paste the keys below before the closing </appSettings> tag.
<add key="EnableLargeAttachmentSaveToFolder" value="true"/>
<add key="LargeAttachmentFolderPath" value="C:\QPulseAttachment"/> <!-- Optional -->
<add key="LargeAttachmentSize" value="200000000"/> <!-- Optional -->
<add key="TempFilePrefix" value="_____"/> <!-- Optional -->
<add key="UploadChunkSize" value="512000"/> <!-- Optional -->
<add key="DownloadChunkSize" value="512000"/> <!-- Optional -->
- Update the LargeAttachmentFolderPath to the location you want to store the QPulseAttachment folder.
2. Updating the Web Client config file
To update the config file:
- Browse to the Ideagen Quality Management Dataportal Config File.
By default, this is stored in C:\inetpub\wwwroot\QPulse\web.config. - Locate the httpRuntime maxRequestLength value found on line 109.
- Update the value to read httpRuntime maxRequestLength="2000000".
3. Updating the Attachment Conversion Service config file
To update the config file:
- Browse to the Attachment Conversion Service config file.
By default, this is stored in C:\Program Files (x86)\Gael Ltd\Q-Pulse Server\QPulseAttachmentConversionService.exe.config. - Paste the keys below before the closing </appSettings> tag.
<add key="EnableLargeAttachmentSaveToFolder" value="true"/>
<add key="LargeAttachmentFolderPath" value="C:\QPulseAttachment"/> <!-- Optional -->
<add key="ScheduledTime" value="23:00"/> <!-- Optional -->
<add key="TempFilePrefix" value="_____"/> <!-- Optional -->
- Update the LargeAttachmentFolderPath to the location you want to store the QPulseAttachment folder.
This is the same location you entered in the Dataportal config file.
4. Updating the Windows Client config file
To update the config file:
- Browse to the Windows Client config file.
By default, this is stored in C:\Program Files (x86)\Gael Ltd\Q-Pulse\Q-Pulse.exe.config. - Locate the ConnectTimeout and InvocationTimeout values on line 53.
- Update the value to read ConnectTimeout="10000000".
- Update the value to read InvocationTimeout="45000000".
5. Configuring the attachment folder permissions
To update the permissions:
- Browse to the Attachment folder referenced in the config files.
By default, this is C:\QPulseAttachment. - Ensure that Full Access permissions are granted to the following users:
- AppPool\QPulseWebClient
- AppPool\QPulseAppPoolv4
- NETWORK SERVICE
6. Maintaining large attachment storage
6.1. Folder structure
Folder structure for the large attachment storage is C:\{LargeAttachmentFolder}\{DatabaseName}\{Module}\{ObjectType}\{RevisionId or ChangeRequestId}\.
6.2. Clean up
Unused temp files and empty folders will be deleted by the Attachment Conversion Service. Clean up will be ran daily at the time configured in the ScheduledTime key found in the Attachment Conversion config file.
6.3. Limitations
There are a few limitations to be aware of when using this configuration.
You will be unable to disable the OK button before the file is fully uploaded. This is due to the page not re-rendering after upload.
Users will also not be able to download attachment larger than 200MB on the Add File page.