home *** CD-ROM | disk | FTP | other *** search
/ Amiga ISO Collection / AmigaUtilCD2.iso / Workbench / Dvices / TELSER1.LHA / doc / telser-Axsh-setup.doc < prev    next >
Encoding:
Text File  |  1994-12-28  |  8.2 KB  |  277 lines
  1. ›1m                           Axsh-setup.guide›0m
  2.  
  3. ›1mAxsh-setup.guide›0m
  4.  
  5.   ---------------------------------------------------------
  6.         Spumoni's "How To" Guide:
  7.     Setting up Axsh 1.31 for use with Telserd
  8.      Written 12/27/94 By Nicholas J. Verenini
  9.   -----------------------------------------------------------
  10.  
  11.     Copyright (c) 1994-1995, SpuSoft. No Rights reserved.
  12.  
  13. ›3m Legal Stuff         ›0m
  14. ›3m Introduction        ›0m
  15. ›3m Requirements        ›0m
  16. ›3m What to change      ›0m
  17. ›3m Common Problems     ›0m
  18. ›3m Acknowledgements    ›0m
  19. ›3m Contact Information ›0m
  20. ›3m Disclaimer          ›0m
  21.  
  22.  
  23. ›1mThere is none!›0m
  24.  
  25. It reminds me of lawyers.
  26.  
  27.  
  28. ›1mDuh, what's my name?›0m
  29.  
  30. This is, in short, a hopefully simple and straightforward guide to setting
  31. up telserd to use Axsh 1.31. If you don't know what ›3m Axsh ›0m is, this little essay
  32. won't help you any, so get out while you still can.
  33.  
  34.  
  35. ›1mWhat you need›0m
  36.  
  37. In order to sucessfully set this thing up, you will need the following:
  38.  
  39. o   Correctly installed TCP/IP stack (tested with Amitcp 4.0)
  40. o   Correctly installed, hopefully registered telser package
  41. o   Correctly installed Axsh 1.31 package
  42. o   An IQ greater than your shoe size
  43.  
  44.   ---------------------------------------------------------------------
  45.  
  46. NOTE! (Or: 'In Case the Last Criteria Was Barely Met')
  47.  
  48. Notice my careful usage of the term 'correctly installed.' This means that
  49. at the time of this writing, you have installed, and have complete mastery
  50. of, the aforementioned packages. It also follows that I will assume you,
  51. gentle reader, have at least above-slug intelligence.
  52.  
  53.  
  54. ›1mModify, change, or otherwise mangle›0m
  55.  
  56. This assumes you have the registered version of telser.device. The demo
  57. will only allow one port, but you can use this section as a guide to
  58. setting up the single unit for Axsh. Read on, D00D.
  59.  
  60.   ---------------------------------------------------------------------
  61.             Files that need modification
  62.  
  63.     For demo use (unit 0 only):
  64.  
  65. o   Axsh
  66.  
  67.     ›3m Axsh:etc/rc.server<x>             ›0m
  68.  
  69.     For regged use (unlimited ports):
  70.  
  71. o   Axsh
  72.  
  73.     ›3m Axsh:etc/rc.server<x>             ›0m
  74.     ›3m Axsh:storage/DOSDrivers/NEWAUX<x> ›0m
  75.  
  76. o   Telser.device
  77.  
  78.     ›3m Amitcp:db/telserd.conf            ›0m
  79.     ›3m Amitcp:db/telser.conf             ›0m
  80.  
  81.  
  82. ›1mAxsh:etc/rc.server<x>›0m
  83.  
  84. If you have read the Axsh documentation (if you haven't, go do it now,
  85. dammit) you will know that in Axsh:bin/ there is a program called
  86. ax-server. What this program does is watch a serial device for connect
  87. requests, and on those requests initialize Axsh through a device called
  88. NEWAUX:. In order to do this, it uses a config file, conventionally named
  89. here as 'Axsh:etc/rc.server<x>,' where <x> is the ax-server session you
  90. want to run. The original file as included with the Axsh distribution is
  91. named 'Axsh:bin/rc.server,' so this naming system is just for neatness. You
  92. may name the config file whatever you so desire. If you had three of these
  93. config files, call them rc.server1, rc.server2, and rc.server3, you would
  94. run ax-server once for each one, and this would give you the equivalent of
  95. a three-line serial configuration, except each session will accept a telnet
  96. request instead of an incoming phone call.
  97.  
  98. Basically, what you want to do is to change two things in the rc.server<x>
  99. config:
  100.  
  101. o   For the default, change all references to 'serial.device' to
  102.     'telser.device'
  103.  
  104. o   If you are setting up multiple rc.server<x> configs, you must also
  105.     replace all instances of NEWAUX: with another NEWAUX device that has a
  106.     different name (see section on NEWAUX for this).
  107.  
  108. o   Give telser.device a port to watch- in the unregged version, it will
  109.     only be able to watch port 0 (in which case you can ONLY use ONE
  110.     config file for ax-server), but the regged version can use a, uh, very
  111.     large number of ports (try somewhere in the billions).
  112.  
  113. ›3m Config file example ›0m
  114.  
  115.  
  116. ›1mExample config file for ax-server›0m
  117.  
  118. ;AXsh server configuration file in pasbox
  119. ;by Pasi Ojala
  120.  
  121. %bpslock:    /* lock the DTE speed (If present, %bps: has no effect) */
  122. 19200
  123. %bps:        /* Default baudrate in ax-server (highest possible) *
  124. 2400
  125.  
  126. %serverpri:    /* AX-server priority *
  127. 1
  128.  
  129. %starthour:    /* server starts to monitor calls *
  130. 25
  131. %stophour:    /* server goes to sleep *
  132. 25
  133.  
  134. %eventhour:    /* event time hours */
  135. 25
  136. %eventmins:    /* event time minutes */
  137. 0
  138.  
  139. %eventnumber:    /* string we use for event-call */
  140. atX4E0dt911
  141. %eventcommand:    /* command we execute after connection */
  142. AXsh:bin/net <newaux1:telser.device/10/raw/checkcd >newaux1:telser.device/10/raw/
  143.  
  144. %newshell:    /* AXsh's serial startup command in AX-server *
  145. newshell >NIL: NEWAUX1:telser.device/10/shared from AXsh:etc/remote-startup
  146.  
  147. %newcon:    /* startup for console(can use con: or newcon: handlers too)*/
  148. newshell >NIL: con:0/0//216/AXsh/CLOSE from AXsh:etc/local-startup
  149.  newshell >NIL: con:0/344/664/216/AXsh/CLOSE from AXsh:etc/local-startup
  150.  
  151. %modem-reset:    /* modem reset command, CR not needed */
  152. ATZ
  153.  
  154. %modem-aa:    /* modem autoanswer command */
  155. AT&d0M0X4E0S0=1
  156.  
  157. %modem-noaa:    /* modem autoanswer off command (not used) */
  158. ATE1S0=0
  159.  
  160. %ringflash:    /* DisplayBeeb() on 1=sleeping,2=waiting,3=always */
  161. 0
  162.  
  163. %device:    /* Device to monitor */
  164. telser.device
  165. %unitnum:    /* Unit number on the device */
  166. 10
  167. %handshake:    /* handshake type, "cts/rts" or "none" */
  168. cts/rts
  169.  
  170.  
  171. ›1mNEWAUX:›0m
  172.  
  173. o    2.1=< users
  174.  
  175. NEWAUX: setup is mercifully simple. Simply take the original mountlist
  176. and change the icon's name to something else, ie. AX1: or NEWAUX1: or
  177. whatever. When you mount this from WB (2.1 only) you will have an
  178. additional NEWAUX: port that you can use for another ax-session. Make
  179. sure the file that the icon is associated with has the same name.
  180.  
  181. o    2.0 users
  182.  
  183. Put the name of the device in as the first line in the mountlist (ie.
  184. NEWAUX1:)...then use the standard AmigaDOS 'mount' command to mount it.
  185. There you go.
  186.  
  187.  
  188. ›1mTelserd.conf›0m
  189.  
  190. The port name you want to use for ax-server config must be in
  191. amitcp:db/telserd.conf. A sample line for configuring port 10 follows (use
  192. the existing telserd.conf as a template):
  193.  
  194. #unit ring-interval max-rings    startup-command cleanup-command logfile
  195. #     (seconds)                 "" for none     "" for none     "" for none
  196. 10      2        1    ""              ""              t:telserd.log
  197.  
  198.  
  199. ›1mTelser.conf›0m
  200.  
  201. You must also have some parameters defined for the port name you want to
  202. use in amitcp:db/telser.conf. Observe:
  203.  
  204. 10  fraser  OpenWindow     NOOPENWIN   LINGER   DEBUG  T:telser.log
  205.                      ^^^^^^
  206. This is almost identical to the line already in the file, but notice that
  207. for use with ax-server you MUST set LINGER on, because ax-server closes the
  208. device it uses (in this case telser.device) when it detects a caller. If
  209. LINGER is off that unit will be closed, and newaux: will have nowhere to
  210. output, resulting in an input stream lockup. In short, LINGER off, bad. You
  211. crash. Grunt.
  212.  
  213. Hope that was kinda clear.
  214.  
  215.  
  216. ›1mSome gotchas›0m
  217.  
  218. Here are some common problems you may experience, and here are my utterly
  219. fantastic solutions:
  220.  
  221. Q:    Arrgh! It doesn't work! What should I do?
  222.  
  223. A:    RTFM.
  224.  
  225. Thank you. :)
  226.  
  227.  
  228. ›1mWe give thee thanks, almighty PAYN...er, Telser›0m
  229.  
  230. Of course, this document owes its existence to telser (and Axsh), without
  231. either of which I would be making no sense whatsoever. I also want to thank
  232. my mother, for not beating me as a child, and, most of all, I want to thank
  233. my agent, Bertha, without whom the world would be a much smaller place.
  234.  
  235. Thank you, thank you. <applause>
  236.  
  237.  
  238. ›1mContact Information›0m
  239.  
  240. I may be reached at:
  241.  
  242. nverenin@nverenin.extern.ucsd.edu
  243.  
  244. I also invite you to try out the telnet site at:
  245.  
  246. telnet nverenin.extern.ucsd.edu (sporadic)
  247.  
  248.  
  249.  
  250. ›1mDisclaimer›0m
  251.  
  252. I make no guarantees, implied or otherwise, about the relative usefulness
  253. of this documentation. I alse refuse to take responsibility if it somehow
  254. manages to crash your hard drive, eat your cat, or steal your credit card
  255. and order me a WE 040 board. You have been warned.
  256.  
  257. -Spu (Wednesday 28-Dec-94 20:49:01)
  258.  
  259.  
  260. ›1mWhat is Axsh?›0m
  261.  
  262. Aside from the fact you should know what Axsh is already, I want to briefly
  263. delineate some advantages to running Axsh through a system such as Telser:
  264.  
  265. 1) Simple UNIX shell-like interface
  266. 2) Has its own file protection
  267. 3) Easily integrated into a Internet-type environment
  268. 4) Reasonably fast
  269. 5) Goes great with Cheez Whiz
  270.  
  271.  
  272.  
  273.  
  274.  
  275.   Axsh-setup.guide converted by
  276.   Guide2Doc 1.0 (02-Nov-1993) FreeWare - © Koessi
  277.