Blog

IBM Connections 5.5: File Upload via HTTP Server (Documentation error)

If you try to configure file upload via HTTP server in Connections 5.5 as described in the infocenter, you will get an error similar to this if you try to start the HTTP server afterwards:

httpd: Syntax error on line 958 of /opt/IBM/HTTPServer/conf/httpd.conf: Syntax error on line 5 of /opt/IBM/HTTPServer/conf/ic_fileupload.conf: Can’t locate API module structure `ibm_local_upload_module’ in file /opt/IBM/HTTPServer/modules/mod_ibm_upload.so: /opt/IBM/HTTPServer/modules/mod_ibm_upload.so: undefined symbol: ibm_local_upload_module

Root Cause:

There are two typos in the documentation. The documentation says:

LoadModule ibm_local_upload_module path_to_module/mod_ibm_local_redirect.so

However the correct line for including the file upload module should be:

LoadModule ibm_upload_module modules/mod_ibm_upload.so

 

Update: Someone has now created an official technote.

Update 02.02.2016:

There are other documentation errors on that page:

Most of the RewriteRule statements (for both activities and files) above are missing a blank before “/ihs”. So the rules are not used and you are unable to upload files bigger than the size you have specified for IHS upload in files-config.xml.

Example:

RewriteRule ^/files/(basic|form|oauth)/api/myuserlibrary/feed(\?[^/]*)?/ihs/files/$1/api/myuserlibrary/feed$2 [PT,L]

should read (see the blank before “/ihs”):

RewriteRule ^/files/(basic|form|oauth)/api/myuserlibrary/feed(\?[^/]*)? /ihs/files/$1/api/myuserlibrary/feed$2 [PT,L]

Update 24.05.2017 (thanks to Cristoph Stoettner):

The path name for the shared directory for “Files” seems also to be wrong.

<Location "/ihs/files">    
IBMUploadHandler On    
SetHandler ibm_upload_handler    
IBMUploadBaseStore "/opt/IBM/Connections/data/files/upload"    
IBMUploadMethods POST,PUT
IBMUploadURLPrefix /ihs
</Location>

should read correctly:

<Location "/ihs/files">    
IBMUploadHandler On    
SetHandler ibm_upload_handler    
IBMUploadBaseStore "/opt/IBM/Connections/data/files/upload/files"    
IBMUploadMethods POST,PUT
IBMUploadURLPrefix /ihs
</Location>

 

IBM Connections 5.5: File Upload via HTTP Server (Documentation error)