Server Configuration Parameters
This section contains a description of the parameters you can specify in the ActiveTransfer Server properties configuration file, properties.cnf. This file is located in the Integration Server_directory \instances\instance_name\packages\WmMFT\config directory on ActiveTransfer Server.
ActiveTransfer Server uses default values for many of the parameters. If a parameter has a default, it is listed with the description of the parameter.
For information on configuring the server properties, see
Configuring Server Properties.
mft.aliases.tn
Specifies the remote server aliases for Trading Networks instances hosted on remote Integration Server hosts. These remote server aliases are defined in the Integration Server Administrator portal. When synchronizing partner details and transferring files to remote Trading Networks instances, ActiveTransfer checks this parameter in order to determine to which remote Trading Networks instances it must connect. Use commas to separate the remote server aliases.
For example: mft.aliases.tn=remote server alias 1,remote alias 2,remote alias 3
Note:
This parameter is applicable only if you have webMethods Product Suite version 9.12 and later.
If you do not specify any value in this parameter, ActiveTransfer only connects to local Trading Networks instances (that is, Trading Networks instances hosted on the same Integration Server host as ActiveTransfer).
mft.client.file.optimizeListing
Specifies if ActiveTransfer's optimized or normal file listing functionality must be used on Microsoft Windows Server directories.
When you have an extremely large number of files for ActiveTransfer to list, set this parameter to true to enable the optimized file listing functionality. If you retain the default value of false, ActiveTransfer uses its normal file listing functionality.
mft.client.ftp.list.command
Specifies the list command to use on remote FTP servers. The value for this parameter is not case-sensitive. The possible values are:
LIST.
ActiveTransfer executes the LIST command to list the file directories on the remote FTP servers. LIST is the default value if you have not specified a value for the parameter or if the value you specified is invalid.
MLST. If the remote FTP servers support the MLST command,
ActiveTransfer executes the MLST command to list the file directories on the remote servers. If the remote FTP servers do not support the MLST command, LIST command is used.
mft.client.http.maxUploadSize
Specifies the maximum file size for non-chunked data in upload operations to HTTP(S) servers. The default value is 10 MB.
mft.client.outbound.useProxy
Specifies if you want to enable the use of proxy server settings for file transfers. The possible values are:
true: Supports outbound connections through proxy servers.
false:
ActiveTransfer ignores all proxy server alias configurations, and creates a direct connection to the remote server. This is the default.
mft.client.session
This section describes the parameters that you can configure in the ActiveTransfer Server cache for client sessions. These parameters are only available with ActiveTransfer Server 9.7 fix 7 and higher.
Note:
These parameters are provided for advanced configuration settings, which are, not expected to change unless there is a specific requirement in your ActiveTransfer Server.
mft.client.session.cache.ttl
Specifies the time in seconds for clients sessions to be stored in cache. This is used only for event execution. A client session is logged out and removed from the cache when this parameter is exceeded. The default value is 120 seconds. This property is used only when mft.event.session.reuse is set to true.
mft.client.session.cache.pingInterval
This parameter relates to the caching of the client sessions created to connect to remote servers when ActiveTransfer executes an event. Specifies the idle time in seconds for a client session stored in the cache after which a test command is run to verify if the client session is valid, before the session is used again. The default value is 30 seconds. If the value of this property is set to 0, ActiveTransfer runs a test command to verify the validity of the session each time, prior to executing a remote operation. Set the value of this property to a higher value (> 0) to reduce the number of test commands to run in scenarios that involve transfer of a large number of files, and frequent use of remote operations.
mft.log.sessionlog.disable
Specifies if logging of session information should be disabled for individual user sessions.
If you retain the default value of false, ActiveTransfer creates separate log files for each ActiveTransfer Server user session in the following directory:
Integration Server_directory \instances\instance_name\packages\WmMFT\resources\logs\session_logs
If you set this parameter to true, ActiveTransfer does not create logs for ActiveTransfer Server user sessions in the given directory.
mft.client.zip.extract.maxFileSize
Specifies the maximum size of zip files to be unzipped using Unzip task.
The default value for this property is 10240. By default, ActiveTransfer set a limit of 10240*1024*1024 bytes (10 GB) size for a zip file to unzip by Unzip task.
For example, if you want to set a 20GB limit, then you can set the value 20480 for this property. ActiveTransfer achieves this by multiplying the value for the property with 1024 * 1024 internally.
mft.client.zip.extract.maxFiles
Specifies the maximum number of files a zip file can contain to unzip using Unzip task. The default value is 1000.
mft.sftp.port.forward.allow
Specifies if the port forwarding is allowed on SFTP listeners.
mft.client.sftp.unmask
Specifies the default unmask used to connect to SFTP servers. The default value is 022.
mft.db
This section describes the parameter you can set in ActiveTransfer to retry a database connection.
mft.db.connection.retry
Specifies the number of times ActiveTransfer should retry a connection to a database when there is a broken connection caused by transient database errors. The default value is 0.
mft.db.connection.retryInterval
Specifies the interval in seconds ActiveTransfer should wait between connection retries to a database. The default value is 10 seconds.
mft.server
This section describes the parameter you can set in ActiveTransfer Server.
mft.server.auth.rolesGroups
Specifies if all user login requires the Role or Group information. Set this property to true only when VFS has permissions to set the role or group.
mft.server.dmz.http.upload.confirm
Checks the connection between your ActiveTransfer Server and ActiveTransfer Gateway. When set to true, ActiveTransfer Gateway verifies with ActiveTransfer Server if a file upload is successful.
mft.server.https.auth.redirectURI
SSO authentication redirects the URL when mft.server.https.auth.sml is set to true. All listeners are ignored.
mft.server.dmz.cert.hostnames
Set the comma-separated hostnames that ActiveTransfer uses to validate the gateways SSL certificate's hostnames.
mft.server.dmz.exclude
A comma-separated list of Gateway server names that cannot connect from this instance.This property is useful when there are multiple server and gateway and you want to avoid crisscross connections among them. Setting the accept IP list in the Gateways cannot establish the connection. However, ActiveTransfer Servers will continue trying to connect to all the Gateways. This property will help to avoid this scenario.
mft.commandcentral
This section describes the parameters you can use to register the Command Central instance used to install ActiveTransfer Agent instances. These parameters are available in the CommandCentral.cnf file. ActiveTransfer Server uses the information in these parameters to connect to the Command Central instance when synchronizing agent installation details from Command Central.
mft.server.commandCentral.host
Specifies the host name or IP address of the machine that hosts the Command Central instance used to install ActiveTransfer Agent instances.
mft.server.commandCentral.port
Specifies the port for the Command Central instance used to install ActiveTransfer Agent instances.
mft.server.commandCentral.port.secure
Specifies if communication between the Command Central instance and ActiveTransfer Server must use SSL protocol.
mft.server.commandCentral.username
Specifies the user name to use when ActiveTransfer Server connects with Command Central.
mft.server.commandCentral.password
Specifies the password to use when ActiveTransfer Server connects with Command Central.
mft.event
This section describes the parameter you can set for post-processing events configured on ActiveTransfer Server.
mft.event.sleep.time
Specifies the time interval ActiveTransfer Server should wait to trigger a post-processing event. The default is 1 second. If you set the value of this property to 20 seconds, ActiveTransfer Server holds a post-processing event in a queue and triggers the event along with the other events that are queued, at 20 second intervals.
mft.event.scheduler.runAsUser
Specifies the user name associated with the scheduled task whenever an Integration Server scheduled task is created by ActiveTransfer. The default is Administrator. However, ActiveTransfer does not change the user while updating the scheduled task.
mft.event.session.reuse
Important:
Do not configure this parameter in your production environment. This parameter is provided to help solution providers debug the individual actions in an event.
ActiveTransfer reuses the connections (sessions) to remote servers that are created by ActiveTransfer event actions. This is achieved by caching the sessions for the event and reusing them later in similar actions within the same event instance. This parameter specifies if client sessions should be reused or not in ActiveTransfer events. The default value is true. If you set this parameter to false, a new session is created for each operation involving a remote server connection in the ActiveTransfer event actions. The new session is closed soon after the remote operation is completed.
mft.event.actions.caseSensitive
Specifies if the action name search in action log page is case sensitive.
mft.event.move.skipRename
ActiveTransfer Server attempts to rename a file when the Move operation is used and the host machine is the same for the source and destination locations. This adversely affects files located on two different drives. Set the property to false if files are moved across different drives to skip rename, copy, and delete the original file.
mft.event.manual.allowStatusChange
The manual schedule action is deactivated, by default. This parameter allows manual scheduled action to be activated.
mft.group.aliases
When more than one ActiveTransfer instances share the same database(ActiveTransfer Group), this property specifies the remote server alias for the other nodes. These remote server aliases are defined in the Integration Server Administrator portal. This information is used to synchronize different assets like VFS, Post Process Action, Scheduled Actions across all nodes in the group.
For example: mft.group.aliases=remote server alias 1,remote server alias 2,remote server alias 3
Important:
Do not configure this parameter with a node that points to itself.
For instance, let us assume that you have node A and node B. Now, to configure the mft.group.aliases for node A, you must point it as mft.group.aliases=node B, excluding the node A.
Configuring the node that points to itself results in a performance issue.
mft.http
This section describes the parameters you can configure for HTTP ports.
mft.http.default.port
Specifies the default HTTP port for ActiveTransfer Server to use for collecting data for the Logs page. The default is 2080.
mft.http.default.port.secure
Specifies if the default HTTP port created in MFT is made secure. By default HTTP port is not secure.
mft.query.maxrows
Specifies the maximum number of asset records to fetch from the database and display in the My webMethods Server management and monitoring pages. The default value is 1000. Increasing this value can affect the performance of the system because that many number of records will be placed in the system memory for each user session.
mft.never.ban.list
Specifies a list of IP addresses that should be excluded from the hammering settings that you configure in ActiveTransfer Server. The IP addresses listed using this property are not banned by the ActiveTransfer Server or the ActiveTransfer Gateway. If you have an ActiveTransfer Server and an ActiveTransfer Gateway instance, apply the restriction to the ActiveTransfer Gateway. Apply the restriction to the server only in the absence of an ActiveTransfer Gateway instance.
Note:
If you have a load balancer, include the load balancer IP in this list.
Restart the ActiveTransfer Server and the ActiveTransfer Gateway instances associated with the server for this property to take effect.
mft.partners.useTNPartners
Specifies if ActiveTransfer must synchronize with and use the partners configured in Trading Networks. You can either use ActiveTransfer partners or Trading Networks partners, not both.
The default value is false. Set this parameter to false if you want to use partners configured in ActiveTransfer.
Set this parameter to true to use partners configured in Trading Networks. On changing the parameter value to true, the ActiveTransfer partners become invalid.
Note:
This parameter is applicable only if you have webMethods Product Suite version 9.12 and later.
mft.server
This section describes the parameters you can configure for ActiveTransfer Server to enable SSO.
mft.server.https.auth.saml
The default value is false. Set this parameter to true to enable SSO for HTTPS listeners in ActiveTransfer Server for access through the ActiveTransfer web client.
mft.server.https.auth.saml.redirecturi
Specifies the redirection URI. Set the redirection URI, that you provided when registering with the identity provider.
mft.server.dmz.cert.hostnames
Set the comma-separated hostnames that ActiveTransfer uses to validate the gateways SSL certificate's hostnames.
mft.server.dmz.exclude
A comma-separated list of Gateway server names that cannot connect from this instance.This property is useful when there are multiple server and gateway and you want to avoid crisscross connections among them. Setting the accept IP list in the Gateways cannot establish the connection. However, ActiveTransfer Servers will continue trying to connect to all the Gateways. This property will help to avoid this scenario.
mft.server.sftp.alogorithms.keyexchange.exclude
Specifies a comma-separated list of key exchange algorithms that need to be excluded from the supported list for SFTP servers.
mft.server.sftp.alogorithms.keyexchange.preferred
Specifies the preferred key exchange algorithm for SFTP servers.
mft.server.crlUrl
If certificate-based authentication is enforced through either the "Require valid certificate" or "Require valid certificate and password" field for FTPS (implicit or explicit) and HTTPS ports, ActiveTransfer validates the client certificate against the certificate revocation list (CRL) specified in mft.server.crlUrl to permit or block client access to ActiveTransfer Server.
Set the value of mft.server.crlUrl as either as a file stored in an accessible directory or a file that can be downloaded from a URL.
Example:
mft.server.crlUrl=C:/MFT/CRL/mftCRL.crl
mft.server.crlUrl=http://softwareag.com/crls/mftCRL.crl
If this property is not set, ActiveTransfer does not perform the CRL check.
mft.server.gateway.socket.timeout
ActiveTransfer Gateway and ActiveTransfer Server connection break if the ActiveTransfer takes more time to respond with a timeout of 10 seconds, which causes a failure.
This parameter sets the timeout for a session in milliseconds between ActiveTransfer Server and ActiveTransfer Gateway. The default value is 10000.
Example: mft.server.gateway.socket.timeout=10000
mft.session.replication
This section describes the parameters you can configure for ActiveTransfer Servers to enable session replication in a group of ActiveTransfer Servers.
mft.session.replication.enable
Enables the replication of the HTTP user sessions across all the ActiveTransfer Server nodes. Replicating session information across nodes is expensive. The default value is false. Set the property to true only if HTTP listeners in ActiveTransfer Server nodes are exposed through a load balancer. Set to false if ActiveTransfer Gateway does not require session replication.
mft.session.replication.address
Specifies the IP address or host name, and port details of this ActiveTransfer Server node. The parameters are as follows:
IP_address_node_1:port_node_1
IP_address_node_1: The IP address or host name of this ActiveTransfer Server node.
port_node_1: The port number on which the session replicator is running for this node.
For example: mft.session.replication.address=10.60.30.100:7800
Note:
The IP addresses cannot be loopback addresses (localhost or 127.0.0.1).
mft.session.replication.other.nodes
Specifies the IP address or host name, and port details of the ActiveTransfer Server nodes that forms a group with this server node. The parameters are as follows:
IP_address_ node_2[port_node_2], IP_address_ node_3[port_node_3]… IP_address_ node_n[port_node_n]
IP_address_ node_n: The IP address of the nth node in the group.
port_node_n: The port on which the session replicator is running on the nth node.
For example:
mft.session.replication.other.nodes =10.60.27.214[7800],10.60.28.89[7800]
mft.sharing.account.tempdir
Specifies a temporary directory location for a file share. When the ActiveTransfer group is available, this location must be a shared file location that is accessible from all the nodes. Use only forward slashes in the file path. For example, D:/activetransfer/sharedcontent/.
Software AG recommends that you replace the default shared file location with any local or shared directory.
mft.ssl.client
This section describes the parameter you can configure for SSL authentication of a remote server.
mft.ssl.client.acceptAnyCert
Specifies if ActiveTransfer Server should validate the SSL certificates from a remote server against the certificates in its truststore and allow communication only from trusted remote servers, or accept all SSL certificates. The default is true. Set the value of the property to false if you want ActiveTransfer Server to accept SSL certificates only from servers that have a truststore entry.
mft.ssh.client.preferred.publickey
Specifies the preferred public key algorithm that ActiveTransfer Server should use to communicate with a SFTP server. The default is ssh-dss. Set the value of the property to ssh-rsa if you want ActiveTransfer Server to use the RSA key as the preferred public key algorithm. You must restart Integration Server for this change to take effect. This property is available only on the application of ActiveTransfer Server 9.7 Fix 4 and higher.
mft.user.email
This section describes the parameters you can configure for the emails that are sent to ActiveTransfer users.
mft.user.email.from
Specifies the email address of the ActiveTransfer administrator who will send messages to ActiveTransfer users when adding or editing the user’s profile. If this parameter is not set, the message is sent without any “from email” address. The value you specify here is overridden by any value you set in the File Share settings.
mft.user.email.public.ip
Specifies the ActiveTransfer Server host name to use for the external server URL that is emailed to users for logging in to the server. If this parameter is not set, the internal IP address is used in the email. This parameter also applies to the email notifications sent for shared files. The shared file link contains either the ActiveTransfer Server or ActiveTransfer Gateway if the source location of the shared file is the ActiveTransfer Server VFS or ActiveTransfer Gateway.
For example, the host for ActiveTransfer Server port 8080 is defined on the Server Management page as localhost or 127.9.1.10. If this parameter is not set, the server URL that is emailed to users will contain the internal IP address of the server (in this example, http://localhost:8080 or http://128.1.10:8080, respectively). If you set this parameter to the external host or domain name that your organization uses to represent the server’s internal IP address, the server URL will reflect the external host name (for example, http://xyz.com:8080).
mft.user.email.subject
Specifies the subject line of the email message that is sent to the user. If this parameter is not set, messages are sent without any subject.
mft.web.security
This section describes the web security parameter that you can configure to make the ActiveTransfer web client more secure.
mft.web.security.httpOnly
Specifies if the httpOnly header is added to all HTTP requests from ActiveTransfer Web client. The default is false.
mft.web.security.sameSite
Specifies if sameSite header is added to all HTTP requests from ActiveTransfer Web client. The default value is false.
mft.web.security.csrf
Specifies if CSRF header is added to all HTTP requests from ActiveTransfer Web client. The default value is false.
Note:
This property is available with ActiveTransfer 9.7 Fix 3 or later.
mft.vfs.tree.pagination.depth
When there is a large number of virtual folders, the Virtual Folder Management page takes longer than expected to load the virtual folders. This property along with pageSize will do pagination on VFS screen.
This property specifies the folder depth at which to apply the folder count provided in the property mft.vfs.tree.pagination.pageSize. The folder depth value is 1 for the root folder, 2, 3, and so on for the child folder depth levels.
mft.vfs.tree.pagination.pageSize
When there is a large number of virtual folders, the Virtual Folder Management page takes longer than expected to load the virtual folders. This property along with mft.vfs.tree.pagination.depth will perform the pagination on Virtual folders screen.
This property specifies the number of virtual folders to display in the Virtual Folder Management page. Software AG recommends a value of 300 or less. Higher values for this property might result in lengthy loading time. The value -1 displays all virtual folders.