A JOBF with relative transfer path failed with following error messages:
20200625/134726.137 - U00011479 FT 'xxxxxxxxxx': Unable to start new file transfer session. Error: 'NetUserGetInfo returned unexpected error 1722'.
20200625/134726.137 - U02000082 The Agent routine 'UCFTXEX ' needs '21.164' second(s) for message 'FTXSEND ', RunID 'xxxxxxxxxx'.
When the path was set to absolute path, the transfer worked as expected.
1. Why ft_omit_user_home is set to 'yes' but NetUserGetInfo was still called?
2. How to troubleshoot this error?
Release : 12.3
Component : AUTOMATION ENGINE
Environment issue, port requirement was not met.
The particular failure message is an RPC communication failure between the windows server with the domain controller.
If the INI-parameter ft_omit_user_home=y is set, the Agent simply does not query the crucial Windows APIs (listed in documentation) in case of local/absolute transfer path(s). Meanwhile, in the case of encrypted files or relative path(s), the API functions will still be called to determine the user home.
Since the JOBF was designed with a relative path, the Windows agent must use Windows APIs (NetGetDCName() and NetUserGetInfo()) to determine the user home. The error 1722 was returned when NetUserGetInfo() is called, this is an error returned by a Windows function that indicates an environment problem (possibly network policies).
It is recommended to have a network or system admin do a packet tracing to see if there is any blockage within the network.
Generally, the following requirements are suggested from Microsoft:
https://support.microsoft.com/en-us/help/179442/how-to-configure-a-firewall-for-domains-and-trusts#
In this case, it was later found that port 445 was blocked. Port 445 is associated with (but probably not limited to) SMB,CIFS,SMB2, DFSN, LSARPC, NbtSS, NetLogonR, SamR, SrvSvc.
Another possible required port is 135.