MIB Viewer

fUpload

OBJECT-IDENTITY
1.3.6.1.4.1.331.1.2.1.1.8.1
Status
current
Sub-identifiers
8
Objects for file upload control. The actual file transfer is done via HTTP POST. If the Agent doesn't support file upload at all, always 'no such object' has to be returned to any request within this section. General: - Any state transition not shown in the state diagram (except state transcision to idle - see idle description) is not allowed and should respond an SNMP error code. Before responding the error code, fulResultOk and fulResultString should be prepared accordingly. Preconditions for file upload are: - fulState = idle (default at Agent startup) - fulResultOk = false (default at Agent startup) - fulDestFolder (V1.5.0.0 extension), fulFilename, fulMD5, fulUploadURL and fulResultString are empty (defaults at Agent startup) Workflow file upload: - Manager sets fulState = preparation - Manager gets fulSegmentationSupported If segmentation is supported, the Manager performs all neccessary internal actions to prepare file segmentation. This step is optional. If more than one file should be uploaded, the Manager typically checks fulSegmentationSupported only once. - Manager sets fulDestFolder (V1.5.0.0 extension) This step is optional. If not set it is up to the Agent where to store the file. - Manager sets fulFilename Upon this, the Agent prepares the upload URL in fulUploadURL (before responding the set fulFilename request) - Manager gets fulUploadURL - Manager sets fulMD5 This step is optional. The Manager may want to upload a file without MD5 checksum test (e.g. MD5 checksum unknown). - Manager sets fulState = inProgress Manager performs the actual HTTP file transfer of the file <fulFilename> resp. all segments of the file <fulFilename.name>_n_of_m.<fulFilename.extension> using fulUploadURL together with the HTTP POST command. If fulFilename is part of fulUploadURL and file segmentation is used, the Manager has to insert the segment numbering (_n_of_m) into fulUploadURL accordingly. In case of segmented file upload the Agent shall autonomously reassemble the segments to the entire file after last segment was received. - Manager sets fulState = md5check Agent performs the MD5 check (optional, if fulMD5 is not empty), sets fulResultOk and fulResultString accordingly and finally Agent sets fulState = md5checkDone - Manager gets fulState in a loop until fulState = md5checkDone - Manager gets fulResultOk and fulResultString Manager gives corresponding user feedback. - Manager sets fulState = idle Upon this, the Agent resets fulResultOk to false and fulFilename, fulMD5, fulUploadURL and fulResultString to empty string.