Changes for page SMB Connectivity

Summary

• Page properties (1 modified, 0 added, 0 removed)

Details

Page properties

Content

...	...	@@ -28,45 +28,82 @@
28	28	* Servers must be set up to run SMB services, and the client must have SMB software installed to access these services.
29	29	* eMagiz provides several components to set up the SMB connection
30	30
	31	+-----------------------------------------------------------------------------------------------------------------------------------
	32	+
31	31	So, where the file pickup component searches on the local host for the correct directory, the idea of the SMB setup is that the directory with whom to communicate exists on a remote host. The local host and the remote host can talk to each other via the SMB protocol. That is, in a nutshell, the difference between setting up an SMB connection and communicating with local directories.
32	32
33	33	eMagiz provides only one support objects to connect to an SMB:
34	34
35		-* SMB session factory
	37	+* Default SMB session factory
36	36
37	37	[[image:Main.Images.Microlearning.WebHome@intermediate-file-based-connectivity-ftp-connectivity--ftp-support-objects.png]]
38	38
39		-=== 3.1 Configuration in eMagiz ===
	41	+=== 3.1 Best practices for using FTP ===
40	40
41		-To configure the connection between eMagiz and the SMB, we need two (or three) components. This depends on whether we want to read, write or do both while communicating with the SMB. If we're going to do both, we need both of the functional components. In all other scenarios, you only need one of the functional components. The functional components that you might need are called:
	43	+==== 3.1.1 Which session factory do I need? ====
42	42
43		-* SMB inbound Channel adapter
44		-* SMB outbound Channel adapter
	45	+When occasionally retrieving or writing files to FTP, use the _Default FTP session factory_. A new connection will be set up when you use the _Default FTP session factory_ for every message/file. On some FTP servers, this might take up to seconds for each login. This fact might impact the performance of your flow.
45	45
46		-On top of that, you need the following support objects.
	47	+When you need better performance (say writing multiple files in a minute or retrieving files every minute), use the _Default FTP **caching** session factory_. The _Default FTP **caching** session factory_ shares FTP sessions for messages in your flow.
47	47
48		-* SMB session factory
	49	+==== 3.1.2 Do I have to set up a retry mechanism? ====
49	49
50		-In this microlearning, we will use the SMB inbound channel adapter combined with the SMB session factory to illustrate the configuration. Please note that any other combination works similarly. To configure the connection with the SMB, we first navigate to the Create phase of eMagiz. Here we open the flow we want to edit. In this example, that will be an entry flow as we want to retrieve (read) data from the SMB.
	51	+When writing files to FTP, it is advisable to set a retry mechanism. Find the advanced tab on your _FTP outbound channel adapter_. Under _Request handler advice chain_ add a _Retry Advice_.
51	51
52		-When you have opened the flow, you need to enter "Start Editing" mode. After you have done so, we first add the SMB session factory support object to our flow.
	53	+==== 3.1.3 I get a _Failed to list files/items_ or a _Failed to obtain pooled item_. What can I do? ====
53	53
54		-[[image:Main.Images.Microlearning.WebHome@intermediate-file-based-connectivity-ftp-connectivity--default-ftp-session-factory-empty.png]]
	55	+Incorrect connection settings can cause this. Check whether the correct properties have been set and whether the runtime has retrieved the latest properties.
55	55
56		-Here, we need to define the following:
	57	+==== 3.1.4 I get a _Failed to list files / items_, a _Pipe closed_ or an _input stream is closed_. What can I do? ====
57	57
58		-* Host
59		-* Port
60		-* Username
61		-* Password
	59	+A closed FTP session can cause these notifications due to inactivity. For the _Default FTP **caching** session factory_, always set the _Server alive interval_ property to 30000 (ms).
62	62
63		-As best practise, we also define the share and directory value. The value for this field is the main folder for your fileshare. In case the main folder is the exchange folder, this field should be empty and the main folder should be configured as remote directory in the SMB inbound Channel adapter.
	61	+==== 3.1.6 I get a _Failed to write to_. What can I do? ====
64	64
	63	+Maybe the target folder does not exist, and the _Auto-create directory_ is off. It is also possible that the connection settings are incorrect. Check whether the correct properties have been set and whether the runtime has retrieved the latest properties.
	64	+
	65	+==== 3.1.7 I often get 'Disconnecting from sftp.example.com port 22' and then a 'Caught an exception, leaving main loop due to Socket closed' warnings. ====
	66	+
	67	+Too many connections can cause this to the same server at the same time. If you have many flows connecting to the same FTP server, ensure that the crons do not trigger simultaneously.
	68	+
	69	+==== 3.1.8 I get a 'Failed to create SFTPClient' ====
	70	+
	71	+SFTP, FTP, and FTPS are three different remote file transfer protocols with their _session factory_ components in the eMagiz flow designer. Make sure you use the one that corresponds to the server's protocol.
	72	+
	73	+==== 3.1.9 One of my remote files is not picked up from the SFTP server (without any warning) ====
	74	+
	75	+The default local filter is _AcceptOnceFileListFilter_. This can be replaced by your file list filter on the _FTP inbound channel adapter's_.
	76	+If every day you retrieve a file with the same filename and the _Delete remote files_ property is set, it is advised to use a different local filename. You can add the current timestamp, for example.
	77	+
	78	+==== 3.1.10 Which mode is needed ====
	79	+
	80	+When running in the current-generation architecture (G3) the FTP always needs to run **passive** mode.
	81	+
	82	+=== 3.2 Configuration in eMagiz ===
	83	+
	84	+To configure the connection between eMagiz and the FTP, we need two (or three) components. This depends on whether we want to read, write or do both while communicating with the FTP. If we're going to do both, we need both of the functional components. In all other scenarios, you only need one of the functional components. The functional components that you might need are called:
	85	+
	86	+* FTP Inbound Channel adapter
	87	+* FTP Outbound Channel adapter
	88	+
	89	+On top of that, you need one of the following support objects. If you are unsure of which to use, please check out the information above in this microlearning.
	90	+
	91	+* Default FTP caching session factory
	92	+* Default FTP session factory
	93	+
	94	+In this microlearning, we will use the FTP Inbound channel adapter combined with the Default FTP session factory to illustrate the configuration. Please note that any other combination works similarly. To configure the connection with the FTP, we first navigate to the Create phase of eMagiz. Here we open the flow we want to edit. In this example, that will be an entry flow as we want to retrieve (read) data from the FTP.
	95	+
	96	+When you have opened the flow, you need to enter "Start Editing" mode. After you have done so, we first add the support object to our flow. In this case, we will use the Default FTP session factory.
	97	+
	98	+[[image:Main.Images.Microlearning.WebHome@intermediate-file-based-connectivity-ftp-connectivity--default-ftp-session-factory-empty.png]]
	99	+
	100	+Here, we need to define at least the host and the port. Note that the username and password are optional for an FTP, which makes it less secure. Although in practice, we generally see that the FTP is secured with the help of a username-password combination. As a best practice, we use property references to fill in the various elements.
	101	+
65	65	[[image:Main.Images.Microlearning.WebHome@intermediate-file-based-connectivity-ftp-connectivity--default-ftp-session-factory-filled-in.png]]
66	66
67	67	The settings on the Advanced tab don't have to be changed in most cases. If your specific setup does require a change to these settings, please consult the help texts on the component level for advice.
68	68
69		-Now that we have configured the support object adding the SMB inbound channel adapter to the flow has become time.
	106	+Now that we have configured the support object adding the FTP inbound channel adapter to the flow has become time.
70	70
71	71	[[image:Main.Images.Microlearning.WebHome@intermediate-file-based-connectivity-ftp-connectivity--ftp-inbound-channel-adapter-empty.png]]
72	72
...	...	@@ -74,12 +74,8 @@
74	74
75	75	[[image:Main.Images.Microlearning.WebHome@intermediate-file-based-connectivity-ftp-connectivity--ftp-inbound-channel-adapter-filled-in.png]]
76	76
77		------------------------------------------------------------------------------------------------------------------------------------
78		-
79	79	Apart from these configurations, you could also add a filter, just as we learned in the Crash Course Messaging on file-based connectivity. Finishing things off, we should consider the delete behavior we will use. Based on the filter and the business requirements, whether to delete and when to delete could differ. So please consider all your options in that regard. This concludes our microlearning, in which we learned how to set up the connectivity with an FTP.
80	80
81		-=== 3.2 SMB Gateway ===
82		-
83	83	== 4. Key takeaways ==
84	84
85	85	* FTP (File Transfer Protocol) is a network protocol for transmitting files between computers over Transmission Control Protocol/Internet Protocol (TCP/IP) connections.