Versions Compared

Old Version 1

changes.mady.by.user Stonebranch

Saved on

compared with

New Version 2

changes.mady.by.user Olivier Michaut

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.


Panel

Table of Contents

...

  • Create a directory C:\UDMG\UDMG Gateway

  • Install the binaries as waarpudmg-gatewaydserver.exe and waarpudmg-gatewayclient.exe

  • Create the configuration file C:\UDMG\UDMG GatewayServer\server.ini with the following parameters:
Panel

[global]
; The name given to identify this gateway instance. If the the database is shared between multiple gateways, this name MUST be unique across these gateways.
GatewayName = mft_waarp_gatewayudmg

; Default OS permission for created files
; FilePermissions = 700

; Default OS permission for created directories
; DirPermissions = 750


[paths]
; The root directory of the gateway. By default, it is the working directory of the process.
; GatewayHome = /home/mft

; The directory for all incoming files.
; DefaultInDir = in

; The directory for all outgoing files.
; DefaultOutDir = out

; The directory for all running transfer files.
; DefaultTmpDir = tmp

[log]
; All messages with a severity above this level will be logged. Possible values are DEBUG, INFO, WARNING, ERROR and CRITICAL.
Level = DEBUG

; The path to the file where the logs must be written. Special values 'stdout' and 'syslog' log respectively to the standard output and to the syslog daemon
; LogTo = stdout

; If LogTo is set on 'syslog', the logs will be written to this facility.
; SyslogFacility = local0

[admin]
; The address used by the admin interface.
Host = 0.0.0.0

; The port used by the admin interface. If the port is 0, a free port will automatically be chosen.
Port = 18080

; Path of the TLS certificate for the admin interface.
; TLSCert =

; Path of the key of the TLS certificate.
; TLSKey =

[database]
; Name of the RDBMS used for the gateway database. Possible values: sqlite, mysql, postgresql
Type = postgresql

; Address of the database
Address = localhost

; The name of the database
Name = mft_waarp_gatewayudmg

; The name of the gateway database user
User = mft_waarp_gatewayudmg_user

; The password of the gateway database user
Password = mft_waarp_gatewayudmg_password

; Path of the database TLS certificate file.
; TLSCert =

; Path of the key of the TLS certificate file.
; TLSKey =

; The path to the file containing the passphrase used to encrypt account passwords using AES
; AESPassphrase = passphrase.aes

[controller]
; The frequency at which the database will be probed for new transfers
Delay = 5s

; The maximum number of concurrent incoming transfers allowed on the gateway (0 = unlimited).
; MaxTransferIn = 0

; The maximum number of concurrent outgoing transfers allowed on the gateway (0 = unlimited).
; MaxTransferOut = 0

[sftp]
; Set to true to allow legacy and weak cipher algorithms: 3des-cbc, aes128-cbc, arcfour, arcfour128, arcfour256
; AllowLegacyCiphers = false

...

  • Create a directory C:\UDMG\MFT Auth Proxy

  • Install the binaries as mft_udmg-auth_-proxy_-server.exe

  • Create the configuration file C:\UDMG\MFT Auth Proxy\config.toml with the following parameters:

Panel

# Proxy Configuration
[proxy]
# Port, default "5000"
port = "5000"
# Network interface, default "0.0.0.0"
inet = "127.0.0.1"
# Enable recover on panic, default true, should be true for production environment
recover = true
# Enable Cross-Origin Resource Sharing (CORS), should be true for production environment
cors = true
# Enable Request Track ID, default true
tracker = true
# Enable Request Logguer, default true
logger = true
# Rate Limit IP Request over 1 second, default 0 (unlimited)
limit = 0
# Enable the Prometheus Metric Endpoint '/metric', default false
metrics = false

# Service 'local' with direct authentication on the waarp gatewaythe UDMG Server
[service.local]
# MFT Waarp Gateway UDMG Server Listen Protocol
protocol = "http"

[[service.local.targets]]
# MFT Waarp Gateway UDMG Server Hostname or IP
hostname = "localhost"
# MFT Waarp Gateway UDMG Server Port
port = 18080

# Service 'mft' with direct authentication on the waarp gatewaythe UDMG Server
[service.mft]
# MFT Waarp Gateway UDMG Server Listen Protocol
protocol = "http"

[[service.mft.targets]]
# MFT Waarp Gateway UDMG Server Hostname or IP
hostname = "localhost"
# MFT Waarp Gateway UDMG Server Port
port = 18080

Configuration for LDAP Authentication

...

Panel

# Proxy Configuration
[proxy]
# Port, default "5000"
port = "5000"
# Network interface, default "0.0.0.0"
inet = "127.0.0.1"
# Enable recover on panic, default true, should be true for production environment
recover = true
# Enable Cross-Origin Resource Sharing (CORS), should be true for production environment
cors = true
# Enable Request Track ID, default true
tracker = true
# Enable Request Logguer, default true
logger = true
# Rate Limit IP Request over 1 second, default 0 (unlimited)
limit = 0
# Enable the Prometheus Metric Endpoint '/metric', default false
metrics = false

# Service 'local' with direct authentication on the waarp gatewayUDMG Server
[service.local]
# MFT Waarp Gateway UDMG Server Listen Protocol
protocol = "http"

[[service.local.targets]]
# MFT Waarp Gateway UDMG Server Hostname or IP
hostname = "localhost"
# MFT Waarp Gateway UDMG Server Port
port = 18080

# Service 'mft' with LDAP Authentication
[service.mft]
# MFT Waarp Gateway UDMG Server Listen Protocol
protocol = "http"

# This option is breaking glass option for admins, they will not reach the LDAP service during the Auth Stage
admins = ["admin"]


[[service.mft.targets]]
# MFT Waarp Gateway UDMG Server Hostname or IP
hostname = "localhost"
# MFT Waarp Gateway UDMG Server Port
port = 18080

# User for Sync Password Between Ldap and Proxy
[service.mft.credential]
# Pre - Setup user under MFT Waarp GatewayUDMG Server
username = "ldap_sync"
password = "ldap_password"

# LDAP Configuration
[service.mft.auth.ldap]
# LDAP Server DC with OU
dn = "ou=users,dc=stonebranch,dc=com"
# LDAP Server FQDN or IP
hostname = "myldap.server.fqdn.com"
# LDAP Server pORT
port = 1389

...

Note

The LDAP replication requires a user with permission for creating and updating users. For example to create the 'ldap_sync' user with the command line interface:

waarp_gateway user udmg-client user add -u ldap_sync -p ldap_password -r 'U=rw'
In case of successful authentication on the LDAP, the user is created with default read permission in the internal UDMG database if it does not exist. Otherwise the credentials are updated in the database to allow for authentication on the REST and CLI interfaces.

...

  • Create a directory C:\UDMG\UDMG Agent

  • Install the binaries as mft_udmg-agent_-proxy_-client.exe and mft_udmg-agent_-proxy_-server.exe

Agent Configuration

...

Panel

[client]
# UDMG Agent Proxy Hostname or IP
hostname = "localhost"
# UDMG Agent Proxy Listen Port
port = "2222"

# SSH Priv Key
ssh_key = "C:\UDMG\UDMG Agent\client_key"
# SSH Public Key
ssh_key_pub = "C:\UDMG\UDMG Agent\client_key.pub"

# Service User
username = "mft"
# Service Password
password = "61ee8b5601a84d5154387578466c8998848ba089"

# Default TTL to Connection Retry
ttl="5s"

# UDMG Agent Client Admin API
[client.api]
# Listen Port
port="2280"

# MFT Waarp Gateway UDMG Server
[gateway]
# MFT Waarp Gateway UDMG Server Hostname or IP
hostname = "localhost"
# MFT Waarp Gateway UDMG Server Port
port = "18080"
# MFT Waarp Gateway UDMG Server Username/Password
username = "admin"
password = "admin_password"

...

  • Download WinSX and copy winsw.exe under C:\UDMG\UDMG Gateway  Server with the following name: waarpudmg-gatewaydserver-service.exe
  • Create a new service definition file: waarpudmg-gatewaydserver-service.yml
Panel

id: UDMG Server
name: UDMG Waarp Gateway Server
description: UDMG Waarp Gateway Server
executable: C:\UDMG\UDMG GatewayServer\waarpudmg-gatewaydserver.exe
startArguments: server -c "C:\UDMG\UDMG Gateway Server\server.ini"
workingdirectory: C:\UDMG\UDMG GatewayUDMG Server
priority: Normal

  • Start the service and check the status:
Panel

C:\UDMG\UDMG Gateway>waarpGateway>udmg-gatewaydserver-service.exe install
2022-10-07 10:07:48,385 INFO  - Installing service 'UDMG Waarp Gateway Server (UDMG Server)'...
2022-10-07 10:07:48,449 INFO  - Service 'UDMG Waarp Gateway Server (UDMG Server)' was installed successfully.

C:\UDMG\UDMG Gateway>waarpGateway>udmg-gatewaydserver-service.exe status
Stopped

C:\UDMG\UDMG Gateway>waarpGateway>udmg-gatewaydserver-service.exe start
2022-10-07 10:08:19,297 INFO  - Starting service 'UDMG Waarp Gateway Server (UDMG Server)'...
2022-10-07 10:08:20,418 INFO  - Service 'UDMG Waarp Gateway Server (UDMG Server)' started successfully.

C:\UDMG\UDMG Gateway>waarpGateway>udmg-gatewaydserver-service.exe status
Started

...

  • Copy winsw.exe under C:\UDMG\UDMG Auth Proxy with the following name: mft_udmg-auth_-proxy_-server-service.exe
  • Create a new service definition file: mft_udmg-auth_-proxy_-server-service.yml
Panel

id: UDMG Auth Proxy
name: UDMG Auth Proxy
description: UDMG Auth Proxy
executable: C:\UDMG\UDMG Auth Proxy\mft_udmg-auth_-proxy_-server.exe
priority: Normal
workingdirectory: C:\UDMG\UDMG Auth Proxy
env:
  - name: MFT_AUTH_PROXY_CONFIG
    value: 'C:\UDMG\UDMG Auth Proxy\config.toml'

  • Start the service and check the status:
Panel

C:\UDMG\UDMG Auth Proxy>mft_Proxy>udmg-auth_-proxy_-server-service.exe install
2022-10-07 10:09:45,618 INFO  - Installing service 'UDMG Auth Proxy (UDMG Auth Proxy)'...
2022-10-07 10:09:45,683 INFO  - Service 'UDMG Auth Proxy (UDMG Auth Proxy)' was installed successfully.

C:\UDMG\UDMG Auth Proxy>mft_Proxy>udmg-auth_-proxy_-server-service.exe start
2022-10-07 10:09:52,852 INFO  - Starting service 'UDMG Auth Proxy (UDMG Auth Proxy)'...
2022-10-07 10:09:54,053 INFO  - Service 'UDMG Auth Proxy (UDMG Auth Proxy)' started successfully.

C:\UDMG\UDMG Auth Proxy>mft_Proxy>udmg-auth_-proxy_-server-service.exe status
Started

...

  • Copy winsw.exe under C:\UDMG\UDMG Agent\agent with the following name: mft_udmg-agent_-proxy_-server-service.exe
  • Create a new service definition file: mft_udmg-agent_-proxy_-server-service.yml
Panel

id: UDMG Agent Server
name: UDMG Agent Server
description: UDMG Agent Server
executable: C:\UDMG\UDMG Agent\agent\mft_udmg-agent_-proxy_-server.exe
priority: Normal
workingdirectory: C:\UDMG\UDMG Agent\agent
env:
- name: MFT_AGENT_PROXY_CONFIG
value: 'C:\UDMG\UDMG Agent\agent\agent.toml'

  • Start the service and check the status:
Panel

C:\UDMG\UDMG Agent\agent>mft_agent>udmg-agent_-proxy_-server-service.exe install
2022-10-07 10:09:45,618 INFO  - Installing service 'UDMG Agent Server (UDMG Agent Server)'...
2022-10-07 10:09:45,683 INFO  - Service 'UDMG Agent Server (UDMG Agent Server)' was installed successfully.
 
C:\UDMG\UDMG Agent\agent>mft_agent>udmg-agent_-proxy_-server-service.exe start
2022-10-07 10:09:52,852 INFO  - Starting service 'UDMG Agent Server (UDMG Agent Server)'...
2022-10-07 10:09:54,053 INFO  - Service 'UDMG Agent Server (UDMG Agent Server)' started successfully.
 
C:\UDMG\UDMG Agent\agent>mft_agent>udmg-agent_-proxy_-server-service.exe status
Started

...

  • Copy winsw.exe under C:\UDMG\UDMG Agent\client with the following name: mft_udmg-agent_-proxy_-client-service.exe
  • Create a new service definition file: mft_udmg-agent_-proxy_-client-service.yml
Panel

id: UDMG Agent Client
name: UDMG Agent Client
description: UDMG Agent Client
executable: C:\UDMG\UDMG Agent\client\mft_udmg-agent_-proxy_-client.exe
priority: Normal
workingdirectory: C:\UDMG\UDMG Agent\client
env:
- name: MFT_AGENT_PROXY_CONFIG
value: 'C:\UDMG\UDMG Agent\client\agent.toml'

  • Start the service and check the status:
Panel

C:\UDMG\UDMG Agent\client>mft_agent_proxy_serverclient>udmg-agent-proxy-client-service.exe install
2022-10-07 10:09:45,618 INFO  - Installing service 'UDMG Agent Server Client(UDMG Agent Server Client)'...
2022-10-07 10:09:45,683 INFO  - Service 'UDMG Agent Server Agent Client (UDMG Agent Server Client)' was installed successfully.

C:\UDMG\UDMG Agent\client>mft_agent_proxy_serverclient>udmg-agent-proxy-client-service.exe start
2022-10-07 10:09:52,852 INFO  - Starting service 'UDMG Agent Server Agent Client (UDMG Agent Server Client)'...
2022-10-07 10:09:54,053 INFO  - Service 'UDMG Agent Server Client(UDMG Agent Server Client)' started successfully.

C:\UDMG\UDMG Agent\client>mft_client>udmg-agent_-proxy_server-client-service.exe status
Started

...

Name

Location

PostgreSQL Client Authentication

21.1. The pg_hba.conf File

PostgreSQL Password Authentication

21.5. Password Authentication

Guide on setting up Nginx as a service on Windowshttps://github.com/sheggi/win-service-nginx

...