Changes for page SMB Connectivity

Last modified by Danniar Firdausy on 2024/09/18 20:40

From version 12.2
edited by Bouke Reitsma
on 2024/05/06 11:28
Change comment: There is no comment for this version
To version 23.1
edited by Erik Bakker
on 2024/05/13 15:54
Change comment: There is no comment for this version

Summary

Details

Page properties
Author
... ... @@ -1,1 +1,1 @@
1 -XWiki.BoukeReitsma
1 +XWiki.ebakker
Content
... ... @@ -1,4 +1,5 @@
1 -{{container}}{{container layoutStyle="columns"}}(((
1 +{{container}}
2 +{{container layoutStyle="columns"}}(((
2 2  In some cases, there is no communication possible with a local file directory. Or there is a requirement from the external party to place the files somewhere else. Mainly the somewhere else is either an FTP or an SFTP. However, there is a third communication protocol that can be used for file transfer. In this microlearning we will take a look at Server Message Block (SMB) connectivity within eMagiz.
3 3  
4 4  Should you have any questions, please get in touch with [[academy@emagiz.com>>mailto:academy@emagiz.com]].
... ... @@ -59,8 +59,11 @@
59 59  * Port
60 60  * Username
61 61  * Password
63 +* Share and directory
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.
65 +{{info}}
66 +The value for the share and directory field is the main folder for your file share. If the main folder is the exchange folder, then within the smb inbound channel adapter, a / is needed as remote directory.
67 +{{/info}}
64 64  
65 65  [[image:Main.Images.Microlearning.WebHome@intermediate-file-based-connectivity-smb-connectivity-smb-session-factory-filled-in.png]]
66 66  
... ... @@ -74,7 +74,7 @@
74 74  
75 75  [[image:Main.Images.Microlearning.WebHome@intermediate-file-based-connectivity-smb-connectivity-smb-inbound-channel-adapter-filled-in.png]]
76 76  
77 -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.
81 +Apart from these configurations, you could also add a filter, just as we learned in the [[Crash Course Messaging on file-based connectivity>>doc:Main.eMagiz Academy.Microlearnings.Crash Course.Crash Course Messaging.WebHome||target="blank"]]. 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. In case there are multiple readers from the folder and/or there are legal requirements to store source files for a certain time period, you should not use the delete remote files option. However, not deleting files read files can cause overloading the machine if no alternative delete policies is in place.
78 78  
79 79  === 3.2 SMB Gateway ===
80 80  
... ... @@ -82,21 +82,36 @@
82 82  
83 83  [[image:Main.Images.Microlearning.WebHome@intermediate-file-based-connectivity-smb-connectivity-smb-outbound-gateway-filled-in.png]]
84 84  
89 +{{info}}
90 +Please note that for some commands an SpEL expression is required to respresent a path. This setting can be found in the advanced settings. An example for the mget command could be **myfilesdirectory/** to get only files from this directory.
91 +{{/info}}
92 +
93 +All available options are:
94 +
95 +* List files
96 +* List file names
97 +* Retrieve file
98 +* Retrieve multiple files
99 +* Remove file(s)
100 +* Move/rename file
101 +* Send file
102 +* Send mulitple files
103 +
85 85  This concludes our microlearning, in which we learned how to set up the connectivity with an SMB.
86 86  
87 87  == 4. Key takeaways ==
88 88  
89 -* FTP (File Transfer Protocol) is a network protocol for transmitting files between computers over Transmission Control Protocol/Internet Protocol (TCP/IP) connections.
90 -* In an FTP transaction, the end user's computer is typically called the localhost. The second computer involved in FTP is a remote host, which is usually a server.
91 -* Servers must be set up to run FTP services, and the client must have FTP software installed to access these services.
92 -* eMagiz provides several components to set up the FTP connection
108 +* SMB (Server Message Block) is a network protocol for transmitting files between computers over Transmission Control Protocol/Internet Protocol (TCP/IP) connections.
109 +* In an SMB transaction, the end user's computer is typically called the localhost. The second computer involved in SMB is a remote host, which is usually a server.
110 +* Servers must be set up to run SMB services, and the client must have SMB software installed to access these services.
111 +* eMagiz provides several components to set up the SMB connection
93 93  
94 94  == 5. Suggested Additional Readings ==
95 95  
96 96  If you are interested in this topic and want more information, please read the release notes provided by eMagiz. Furthermore, check out these links:
97 97  
98 -* [[FTP Inbound>>https://docs.spring.io/spring-integration/docs/2.1.x/reference/html/ftp.html#ftp-inbound||target="blank"]]
99 -* [[FTP Session Factory>>https://docs.spring.io/spring-integration/docs/4.3.x/reference/html/ftp.html#ftp-session-factory||target="blank"]]
100 -* [[FTP Explained>>https://searchnetworking.techtarget.com/definition/File-Transfer-Protocol-FTP||target="blank"]]
117 +* [[SMB Support>>https://docs.spring.io/spring-integration/reference/smb.html||target="blank"]]
118 +* [[SMB Overview>>https://learn.microsoft.com/en-us/windows-server/storage/file-server/file-server-smb-overview||target="blank"]]
101 101  
102 -)))((({{toc/}}))){{/container}}{{/container}}
120 +)))((({{toc/}}))){{/container}}
121 +{{/container}}