| Both sides previous revisionPrevious revisionNext revision | Previous revisionNext revisionBoth sides next revision |
| module:tickit [2018/04/03 22:52] – [Setup] typo digital man | module:tickit [2019/07/29 19:44] – [ctrl/tickit.ini] add Sample FDN Area Definition section wkitty42 |
|---|
| |
| It is configured via the file: ''[[dir:ctrl]]/tickit.ini'' | It is configured via the file: ''[[dir:ctrl]]/tickit.ini'' |
| | |
| | Managing ''[[dir:ctrl]]/tickit.ini'' may be done manually or via ''[[dir:exec]]/tickitcfg.js''. The preferred method is via [[module:tickitcfg|tickitcfg]] which allows for importing your FDN areas as well as access to global and per area options. |
| | |
| | Tickit automatically executes ''[[dir:exec]]/addfiles'' when it processes files sent to your system in FDN areas stored in your file bases. Addfiles is executed for each file as it is processed. Files stored outside of your file bases will not have addfiles run against them during processing. |
| |
| In a recent change to SBBSecho/EchoCfg v3 and ''tickit.js'', the TIC file password for each FTN-linked node is now stored in the ''TicFilePwd'' key of the corresponding ''[node]'' section of the ''[[config:sbbsecho.ini]]'' file and can be managed via AreaFix and via ''[[util:echocfg]]''. | In a recent change to SBBSecho/EchoCfg v3 and ''tickit.js'', the TIC file password for each FTN-linked node is now stored in the ''TicFilePwd'' key of the corresponding ''[node]'' section of the ''[[config:sbbsecho.ini]]'' file and can be managed via AreaFix and via ''[[util:echocfg]]''. |
| * If using BinkD, add a line like this to your ''binkd.cfg'' file to create a semaphore file which triggers the TICKIT timed-event to execute whenever a ''.tic'' file is received: <code>flag /sbbs/data/tickit.now *.tic *.TIC</code> | * If using BinkD, add a line like this to your ''binkd.cfg'' file to create a semaphore file which triggers the TICKIT timed-event to execute whenever a ''.tic'' file is received: <code>flag /sbbs/data/tickit.now *.tic *.TIC</code> |
| * [[module:binkit|BinkIT]] automatically runs the TICKIT timed event when a TIC file is received | * [[module:binkit|BinkIT]] automatically runs the TICKIT timed event when a TIC file is received |
| * If you would like to treat all imported ''.tic'' files as though they have a ''REPLACES'' clause, add the ''-force-replace'' option to the ticket.js command-line | * If you would like to treat all imported ''.tic'' files as though they have a ''REPLACES'' clause, add the ''-force-replace'' option to the ticket.js command-line or use the ''Force Replace'' options in tickitcfg for global or per-area forced replacements |
| ===== Configuration ===== | ===== Configuration ===== |
| |
| * ''Handler'' Set to the filename of a handler script as defined below. If present, this overrides the global Handler, they do not both run. | * ''Handler'' Set to the filename of a handler script as defined below. If present, this overrides the global Handler, they do not both run. |
| * ''HandlerArg'' a string that is passed to the handler function. | * ''HandlerArg'' a string that is passed to the handler function. |
| | |
| | === Sample FDN Area Definition === |
| | |
| | The following is a sample FDN Area Definition for the DAILYLIST FDN. |
| | |
| | <code> |
| | [DAILYLIST] |
| | Dir=FDIST-DAILYLIS |
| | Links=1:261/38,1:123/115,1:123/755,1:135/300,1:3634/12.73,1:3634/27 |
| | Handler=tickit/nodelist_handler.js |
| | HandlerArg={"domain":"fidonet", "match":"Z1DAILY.Z*", "nlmatch":"Z1DAILY.*"} |
| | SourceAddress=1:18/0 |
| | AKAMatching=false |
| | Uploader=DAILYLIST File Dist |
| | </code> |
| | |
| | The Dir line contains the ''internal code'' for this area. In this case, ''FDIST-'' is the internal code for the file library and ''DAILYLIS'' is the internal code for the specific area. Both are used to determine the full ''internal code'' for the area. You do not have to define a code for the library if you do not want to but you must have an internal code for the area defined. These ''internal codes'' should be unique between areas or you will have them crosslinked and be putting files in the wrong area. |
| | |
| | The Links line should contain at least one FTN address. This will be the address of your feed for the FDNs you carry. Every system that you link this area to will be listed as shown above. No spaces are allowed and each FTN address must be complete. I generally put the addresses in numerical order with the first address listed being the main linked system feeding the area. This is not set in stone. You can list the addresses in any order you like. |
| | |
| | See the below Handler section for the definition of what the file handler lines do. |
| | |
| | The SourceAddress is an override field if you want this area to be distributed from a different FTN address than your main one. Your main FTN address is the first one listed in scfg in the fidonet network configuration section. Each of your fidonet technology addresses will be listed in that same section all together. |
| | |
| | AKAMatching is another override for which of your addresses will be used if you have this area connected to more than one system. AKAMatching determines if your main address will be used, if one of your SourceAddress overrides will be used, or if your AKA will be matched to the closest of your addresses for the destination system. |
| | |
| | **Example:** If you have addresses 1:3634/12, 1:18/0, 1:123/0, and 1:3634/0 and you want this DAILYLIST FDN to be sent to each of the above listed links with the closest matching of your four FTN addresses, you would set AKAMatching=true. |
| | |
| | The following table shows which of these example FTN addresses will be used for each destination system based on the three address related options provided. |
| | |
| | ^ AKAMatching Table ^^ |
| | | || |
| | ^Global SourceAddress : 1:3634/12 ^^ |
| | ^DAILYLIST SourceAddress : [blank] ^^ |
| | ^AKAMatching : false ^^ |
| | | || |
| | ^ Destination System ^ Selected AKA ^ |
| | | 1:261/38 | 1:3634/12 | |
| | | 1:123/115 | 1:3634/12 | |
| | | 1:123/755 | 1:3634/12 | |
| | | 1:135/300 | 1:3634/12 | |
| | | 1:3634/12.73 | 1:3634/12 | |
| | | 1:3634/27 | 1:3634/12 | |
| | | || |
| | ^Global SourceAddress : 1:3634/12 ^^ |
| | ^DAILYLIST SourceAddress : 1:18/0 ^^ |
| | ^AKAMatching : false ^^ |
| | | || |
| | | 1:261/38 | 1:18/0 | |
| | | 1:123/115 | 1:18/0 | |
| | | 1:123/755 | 1:18/0 | |
| | | 1:135/300 | 1:18/0 | |
| | | 1:3634/12.73 | 1:18/0 | |
| | | 1:3634/27 | 1:18/0 | |
| | | || |
| | ^Global SourceAddress : 1:3634/12 ^^ |
| | ^DAILYLIST SourceAddress : 1:18/0 ^^ |
| | ^AKAMatching : true ^^ |
| | | || |
| | | 1:261/38 | 1:18/0 | |
| | | 1:123/115 | 1:123/0 | |
| | | 1:123/755 | 1:123/0 | |
| | | 1:135/300 | 1:18/0 | |
| | | 1:3634/12.73 | 1:3634/12 | |
| | | 1:3634/27 | 1:3634/0 | |
| | |
| |
| ==== Handler Scripts ==== | ==== Handler Scripts ==== |
| ===== See Also ===== | ===== See Also ===== |
| * [[module:|Module Index]] | * [[module:|Module Index]] |
| | * [[:module:tickitcfg|tickitcfg]] |
| |
| {{tag>fidonet}} | {{tag>fidonet}} |
| |
