Skip to content

Installing the scan file upload server

The web-based scan file upload server is a .net web application that allows to upload .scan files via http/s. It can be deployed as an alternative to SMB shares or other means of collecting scan files. Generated scan files can be uploaded using the curl utility or the built-in upload functionality in the Windows scanner Octoscan2.

Depending on your network structure it may be necessary to install multiple file drops. The OctoSAM license allows you to install as many web-based file drops as you like. The upload server supports all platforms that can run .net web applications.

OctoSAM also provides a nginx/OpenResty based variant of the upload server, see https://github.com/octosoft/octopus-resty

IIS Application Pool account

Create an Application Pool that has read/write permission to the configured upload folder. The Application Pool account also needs read/write permissions to the configured log directory. Set the .NET CLR Setting of the Application Pool to No Managed Code

Upload folder

Configure the upload folder through appsettings.json 

    "Collect": {
        "UploadFolder": "D:/OctoSAM/Shared/Data"
    }

Tip

The OctoSAM Import Service supports multiple import folders. You do not have to use the same directory as used for scan file collection via file share.

Create an IIS application

Put the application in a sub-path of your IIS Webserver (Standard name /upload). Do not place it in the server root. If you choose another path than /upload/, you have to adjust all examples accordingly. Configure the IIS application for anonymous authentication.

Configure the IIS Application to point to the Server/OctoCollect directory. With standard configuration that would be D:\OctoSAM\Server\OctoCollect.

Tip

If you define bindings/certificates for SSL on a machine with IPv6 dual stack, don't forget to define bindings for IPv6. Otherwise, you might get errors when trying to upload a file from the same machine.

Test using curl

curl -F "upload=@14d68120-2f9b-11ea-a200-106530c75a73.scan" http://myhost.mydomain.com/upload/
14d68120-2f9b-11ea-a200-106530c75a73.scan thank you!

Octoscan2 configuration for this example:

UploadInsecure = true
UploadPlainHttp = true
UploadHosts = myhost.mydomain.com
UploadPort = 80
UploadUrl = /upload/