Changes for page SMB Connectivity

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

From version 12.1
edited by Bouke Reitsma
on 2024/05/06 11:07
Change comment: There is no comment for this version
To version 21.1
edited by Bouke Reitsma
on 2024/05/13 13:57
Change comment: There is no comment for this version

Summary

Details

Page properties
Content
... ... @@ -59,8 +59,11 @@
59 59  * Port
60 60  * Username
61 61  * Password
62 +* 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.
64 +{{info}}
65 +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 smb inbound channel adapter, a / is needed as remote directory.
66 +{{/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,27 +74,43 @@
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.
80 +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  
84 +The SMB Gateway is an additional component that can be used to interact with your SMB share. It enables the use of a set of pre-configured commands to for example delete files. The reply messages depend on the selected command. Every command option is explained within the helptext. An example configuration to send files is shown below.
81 81  
86 +[[image:Main.Images.Microlearning.WebHome@intermediate-file-based-connectivity-smb-connectivity-smb-outbound-gateway-filled-in.png]]
82 82  
88 +{{info}}
89 +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.
90 +{{/info}}
91 +
92 +All available options are:
93 +
94 +* List files
95 +* List file names
96 +* Retrieve file
97 +* Retrieve multiple files
98 +* Remove file(s)
99 +* Move/rename file
100 +* Send file
101 +* Send mulitple files
102 +
83 83  This concludes our microlearning, in which we learned how to set up the connectivity with an SMB.
84 84  
85 85  == 4. Key takeaways ==
86 86  
87 -* FTP (File Transfer Protocol) is a network protocol for transmitting files between computers over Transmission Control Protocol/Internet Protocol (TCP/IP) connections.
88 -* 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.
89 -* Servers must be set up to run FTP services, and the client must have FTP software installed to access these services.
90 -* eMagiz provides several components to set up the FTP connection
107 +* SMB (Server Message Block) is a network protocol for transmitting files between computers over Transmission Control Protocol/Internet Protocol (TCP/IP) connections.
108 +* 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.
109 +* Servers must be set up to run SMB services, and the client must have SMB software installed to access these services.
110 +* eMagiz provides several components to set up the SMB connection
91 91  
92 92  == 5. Suggested Additional Readings ==
93 93  
94 94  If you are interested in this topic and want more information, please read the release notes provided by eMagiz. Furthermore, check out these links:
95 95  
96 -* [[FTP Inbound>>https://docs.spring.io/spring-integration/docs/2.1.x/reference/html/ftp.html#ftp-inbound||target="blank"]]
97 -* [[FTP Session Factory>>https://docs.spring.io/spring-integration/docs/4.3.x/reference/html/ftp.html#ftp-session-factory||target="blank"]]
98 -* [[FTP Explained>>https://searchnetworking.techtarget.com/definition/File-Transfer-Protocol-FTP||target="blank"]]
116 +* [[SMB Support>>https://docs.spring.io/spring-integration/reference/smb.html||target="blank"]]
117 +* [[SMB Overview>>https://learn.microsoft.com/en-us/windows-server/storage/file-server/file-server-smb-overview||target="blank"]]
99 99  
100 100  )))((({{toc/}}))){{/container}}{{/container}}