XamFlow Server Installation Guide¶
This installation guide describes the process to install XamFlow Server on a computer running Microsoft Windows.
XamFlow Server is an extension of SWAP Server (central database node) which is accessed through web APIs.
This guide assumes that SWAP Server and FileStorage Service have already been installed.
Run the following SQL script:
You can run an SQL script with the following commands:
%PG_BIN%\psql.exe -f install_xamflow_0000-XXXX.sql -U postgres swap
(When asked provide the database master password specified during installation of SWAP.)
Run the following SQL command, replace XXXX with the target version number of the file above:
SELECT public.complete_migration('xamflow', 'XXXX');
You can run an SQL command with the following command:
%PG_BIN%\psql.exe -c "SELECT public.complete_migration('xamflow', 'XXXX');" -U postgres swap
(When asked provide the database master password specified in the PostgreSQL setup above.)
IIS Web Server¶
Extract the contents of
Lucid.XamFlow.WebApiSWAP win64.zipinto the folder
Logssubdirectory and grant
Configsubdirectory and grant
Create a file
C:\inetpub\apps\xamflow\Config\string\SWAP.ServerId.configcontaining just the ID of the server. (Must match the server ID of any node-locked application licenses.)
Add the following website:
application pool: Make sure it supports .NET CLR version 4.0 (e.g. use DefaultAppPool)
https(Use the certificate imported before.)
host name 1: domain name of the machine (same as DNS Name in Subject Alternative Name of certificate)
The host name field in the IIS website dialog might be disabled. To enable it, make sure the friendly name of your certificate starts with an asterisk
*character. See the Certificates Guide for how to edit the friendly name of your certificate.
Open SWAP WebAdmin (
Register a file storage mapping for
Create the mapped folders on disk and grant
Create an inbound rule for
44303to allow access.
In case of problems, please see the log files in following locations:
IIS Access log:
IIS HTTP Error log:
IIS Trace Logging for failed requests:
(Note: You may have to tell Windows that you want to access a protected parent folder first.)