Changes for page SMB Connectivity
Last modified by Danniar Firdausy on 2024/09/18 20:40
From version 30.1
edited by Erik Bakker
on 2024/06/20 10:23
on 2024/06/20 10:23
Change comment:
There is no comment for this version
To version 18.1
edited by Bouke Reitsma
on 2024/05/13 12:02
on 2024/05/13 12:02
Change comment:
There is no comment for this version
Summary
-
Page properties (2 modified, 0 added, 0 removed)
Details
- Page properties
-
- Author
-
... ... @@ -1,1 +1,1 @@ 1 -XWiki. ebakker1 +XWiki.BoukeReitsma - Content
-
... ... @@ -1,6 +1,5 @@ 1 -{{container}} 2 -{{container layoutStyle="columns"}}((( 3 -In some situations, direct communication with a local file directory is not possible, or in other case, an external party requires the files to be placed elsewhere. Typically, these files need to be retrieved from or uploaded to a server location using the FTP or SFTP protocols. 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. 1 +{{container}}{{container layoutStyle="columns"}}((( 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. 4 4 5 5 Should you have any questions, please get in touch with [[academy@emagiz.com>>mailto:academy@emagiz.com]]. 6 6 ... ... @@ -63,14 +63,14 @@ 63 63 * Share and directory 64 64 65 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, th en withinthe SMB inboundchanneladapter, a / is needed asremoterectory.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, this should be referenced with a /. 67 67 {{/info}} 68 68 69 69 [[image:Main.Images.Microlearning.WebHome@intermediate-file-based-connectivity-smb-connectivity-smb-session-factory-filled-in.png]] 70 70 71 - In theadvanced tab thereareonlytwosettingstochange.The minimumandmaximum SMB protocolversion.By default,these areset to 2.02 and 3.1.1 respectively to allow a wide range ofsave protocolversion. However, if youwant toonly allow thebestperforming version, theminimum3.0.2 isadvised.If youaim forthebestsecured connectionversion3.1.1 hasthemost functionalityinthis area.Thebestpractiseon this is settheminimum versionas high as possibletomimizerisks.70 +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. 72 72 73 -Now that we have configured the support object ,wecan add the SMB inbound channel adapter to the flow.72 +Now that we have configured the support object adding the SMB inbound channel adapter to the flow has become time. 74 74 75 75 [[image:Main.Images.Microlearning.WebHome@intermediate-file-based-connectivity-smb-connectivity-smb-inbound-channel-adapter-empty.png]] 76 76 ... ... @@ -78,29 +78,18 @@ 78 78 79 79 [[image:Main.Images.Microlearning.WebHome@intermediate-file-based-connectivity-smb-connectivity-smb-inbound-channel-adapter-filled-in.png]] 80 80 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.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. 82 82 83 83 === 3.2 SMB Gateway === 84 84 85 -The SMB Gateway is an additional component that can be used to interact with your SMB share. It al lows the use of a set of pre-configured commands toperformactions such as deleting files. Comparedto the outboundchanneladapterrepliesare send back to eMagiz. Thesereply messages depend on the selected command. Every command option is explainedin detailwithin the helptext. An example configuration to send files is shown below.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. 86 86 87 87 [[image:Main.Images.Microlearning.WebHome@intermediate-file-based-connectivity-smb-connectivity-smb-outbound-gateway-filled-in.png]] 88 88 89 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.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. 91 91 {{/info}} 92 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 - 104 104 This concludes our microlearning, in which we learned how to set up the connectivity with an SMB. 105 105 106 106 == 4. Key takeaways == ... ... @@ -117,5 +117,4 @@ 117 117 * [[SMB Support>>https://docs.spring.io/spring-integration/reference/smb.html||target="blank"]] 118 118 * [[SMB Overview>>https://learn.microsoft.com/en-us/windows-server/storage/file-server/file-server-smb-overview||target="blank"]] 119 119 120 -)))((({{toc/}}))){{/container}} 121 -{{/container}} 108 +)))((({{toc/}}))){{/container}}{{/container}}