docs/8.0/ayanova/docs/adm-attachments.md

@@ -30,6 +30,20 @@ The files are _not_ stored under their original name but rather re-named accordi
 2. save disk space by ensuring that identical files are only stored once
 3. secure the file names themeselves which may contain sensitive information
 
+## Maximum attachment size
+
+AyaNova has a hard limit of 10GB for a single attachment however the actual maximum may be a lot less depending on the network configuration and what software lies between AyaNova and the end user.
+
+For example when using NGINX as a reverse proxy in front of AyaNova the setting `client_max_body_size ` controls how large of an upload is possible and defaults to 1MB. Our [example NGINX configuration](ops-install-linux-server.md#configure-nginx-site-for-ayanova) shows a default of 25MB.
+
+IIS has the `maxAllowedContentLength` setting and Apache has it's own `LimitRequestBody` directive which may need to be configured optimially when used as a reverse proxy in front of AyaNova.
+
+A good security and mistake prevention measure when using a proxy server is to set the maximum attachment size only as large as absolutely necessary for your Users.
+
+## Troubleshooting failures to attach
+
+If a file can not be attached and there is no error message it's very likely an intermediary software package such as a reverse proxy with a limit set causing a [maximum attachment size issue](#maximum-attachment-size). To determine this try attaching a very small file and confirm if it will attach to the same object.
+
 ## Menu options
 
 #### Start attachment maintenance job

docs/8.0/ayanova/docs/ay-start-form-attachments.md

@@ -18,10 +18,10 @@ An attachment is _not_ a part of the normal [edit form](ay-start-edit-forms.md)
 
 When a business object with attachments is deleted in AyaNova, **all** it's attachments are also deleted with it. If you want to preserve attachments before deleting an object they can be either downloaded then re-uploaded or [moved](adm-attachments.md) to a different object by someone with administrator level access.
 
-More information about how attachments are processed at the server can be found in the [administrator attachments guide](adm-attachments.md).
-
 AyaNova has a hard limit of 10gb per attachment but depending on the device / browser and any intermediate web server software between the back end AyaNova server and the user's device there could be further limitations.
 
+More information about how attachments are processed at the server can be found in the [administrator attachments guide](adm-attachments.md).
+
 There are two tabs in the attachment control:
 
 ![control attachment tabs](img/control-attachment-panes.png)
@@ -71,7 +71,7 @@ For example on an Android phone:
 
 ![control attachment Android upload](img/control-attachment-android-chooser.png)
 
-If you were to choose "Camera" the device's camera would open and allow you to take a picture and accept it with the checkmark button Android displays beneath the photo; the photo's file name would appear in the AyaNova upload control ready to be uploaded by clicking on the Upload button. 
+If you were to choose "Camera" the device's camera would open and allow you to take a picture and accept it with the checkmark button Android displays beneath the photo; the photo's file name would appear in the AyaNova upload control ready to be uploaded by clicking on the Upload button.
 
 Note that each brand, model and operating system level of each device will have it's own particular options depending upon what is available and the camera / video / microphone access rights given to the browser in the device.
 
@@ -105,4 +105,4 @@ If you see this error in the log it's likely not AyaNova restricting the upload
 
 Web browsers are not good at handling and displaying this error which is why the log needs to be checked as internally AyaNova will track and log communication errors.
 
-A short cut to test if this is the problem is to upload a small file well under 1mb and see if that works where larger files do not.  If this is the case it's likely a 413 issue.
+A short cut to test if this is the problem is to upload a small file well under 1mb and see if that works where larger files do not. If this is the case it's likely a 413 issue.

docs/8.0/ayanova/mkdocs.yml

@@ -7,7 +7,7 @@ theme:
 site_name: AyaNova manual
 site_dir: '../../../server/AyaNova/wwwroot/docs'
 strict: true 
-copyright: Copyright © 2022 Ground Zero Tech-Works Inc. REV-2022-09-19
+copyright: Copyright © 2022 Ground Zero Tech-Works Inc. REV-2022-09-20
 extra:  
   generator: false
 # Extensions