How to Enable Local Storage for Large File Attachments in the Document Module

Who is this article for?

 IT administrators responsible for managing the Q-Pulse Application Server

Q-Pulse Version 7.1.4.2 is required.

If you wish to store large files using the Q-Pulse Web client, additional steps must be taken to enable this on the Q-Pulse application server. This helps to optimise the upload and download of attachments in the document module. 

To make this easier to follow, this article is split into a 6 sections. 

1. Updating the Dataportal Config File

2. Updating the Web Client Config File

3. Updating the Attachment Conversion Service Config File

4. Updating the Windows Client config File 

5. Configuring Permissions on the Attachments Folder

6. Important Notes 

1. Updating the Dataportal Config File

1. Browse to the Q-Pulse Dataportal Config File. By default, this is stored in the following location: 

C:\inetpub\wwwroot\QPulseDataPortal\web.config

2. 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 -->

Note: Please update the "LargeAttachmentFolderPath" to point to the location in which you would like to store the 'QPulseAttachment' folder. 

2. Updating the Web Client Config File

1. Browse to the Q-Pulse Web Client config file. By default, this is stored in the following location: 

C:\inetpub\wwwroot\QPulse\web.config

2. Locate the httpRuntime maxRequestLength value found on line 109 and update the value to read as httpRuntime maxRequestLength="2000000" as shown below. 

3. Updating the Attachment Conversion Service Config File. 

1. Browse to the attachment conversion service config file. By default, this is found in the following location: 

C:\Program Files (x86)\Gael Ltd\Q-Pulse Server\QPulseAttachmentConversionService.exe.config

2. 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 -->

Note: If you've updated the location of the folder path in step 1, please update it here too. 

4. Updating the Windows Client Config File 

1. Browse to the Windows client config file. By default, this is found in the following location: 

C:\Program Files (x86)\Gael Ltd\Q-Pulse\Q-Pulse.exe.config

2. Locate the ConnectTimeout and InvocationTimeout values on line 53 and update them as shown below. 

<channels>
<channel type="Belikov.GenuineChannels.GenuineHttp.GenuineHttpClientChannel, GenuineChannels" ConnectTimeout="10000000" InvocationTimeout="45000000" HttpUseGlobalProxy="false" Compression="true" />
</channels>

• Increase ConnectTimeout value to 10000000. Default value is 10000.

• Increase InvocationTimeout value to 45000000. Default value is 120000.

5. Configuring Permissions on the Attachment Folder

1. Browse to the Attachment folder referenced in the config files. By default this is C:\QPulseAttachment. 

2. Ensure that Full access permissions are granted to the following system users:

• AppPool\QPulseWebClient

• AppPool\QPulseAppPoolv4

• NETWORK SERVICE

6. Important Notes

Folder Structure

The Folder structure for the Large Attachment Storage is as follows: 

C:\{LargeAttachmentFolder}\{DatabaseName}\{Module}\{ObjectType}\{RevisionId or ChangeRequestId}\

For Example:

C:\QPulseAttachment\Aviation\Document\Revision\400\file.ext

C:\QPulseAttachment\Aviation\Document\DocumentChange\400\file.ext

C:\QPulseAttachment\Aviation\Document\ChangeRequest\35\file.ext

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. 

Limitations

1. Unable to disable the “OK” button before the file is fully uploaded. This is due to the page not re-rendering after upload. 

2. Users will not be able to download attachment larger than 200MB on the 'Add File' page. 

If you have any issues following this article, please contact the Q-Pulse Support team.