home *** CD-ROM | disk | FTP | other *** search
/ minnie.tuhs.org / unixen.tar / unixen / Other / Coherent / DemonArchives / docs / uuinst.guide.z / uuinst.guide
Encoding:
Text File  |  1993-09-08  |  7.1 KB  |  210 lines
  1.     UUCP - Installation under Coherent
  2.     ----------------------------------
  3.  
  4. I assume you have:
  5.  
  6. A PC with Coherent 3.2 and a modem connected with a 
  7. 1:1 cable at a com-port, here com2:
  8.  
  9. You want to connect your machine for email and news to the 
  10. machine  bighost  whose domain-style-address is:
  11. bigsite.com
  12.  
  13. It's a short information, if you want to know more about UUCP try
  14. to get the Nutshell Handbook "Managing UUCP and USENET" from
  15. O'Reilly and Associates ( uunet!ora!nuts )
  16.  
  17. Give your site a name:
  18. ----------------------
  19.  
  20. You should choose a name for your site, max. 7 characters. Our site
  21. here I will name "myhome"
  22.  
  23. So edit the file  /etc/uucpname  to contain this line:
  24.  
  25. myhome
  26.  
  27. I assume "bigsite.com" will allow us to be a subdomain of it so we have
  28. the complete domain-style-address:
  29.  
  30. myhome.bigsite.com
  31.  
  32. So we need the following line in the file  /etc/domain:
  33.  
  34. bigsite.com
  35.  
  36. (if you do not have a "domain" use the Pseudo-Domain  UUCP)
  37.  
  38. Now we enter /usr/lib/uucp and have to edit some more files:
  39.  
  40. L-devices
  41. ---------
  42.  
  43. This file describes the device we intend to use for UUCP. A line
  44. looks like:
  45.  
  46. ACU  com2l  com2r  2400  hayes
  47.  
  48. ACU   =  AUTO CALL UNIT  =  our modem
  49. com2l =  the line we want to use for dialing out with UUCP
  50. com2r =  the device we have to disable for login when we want to use UUCP
  51. 2400  =  speed we intend to use for this line
  52. hayes =  the name of the entry in /etc/modemcap that describes our
  53.      modem.
  54.  
  55. For direct connections use this line:
  56.  
  57. DIR com2l com2l 9600 direct
  58.  
  59. So one of this lines is all we need for now !
  60.  
  61.  
  62. L.sys
  63. -----
  64.  
  65. The most important file ! Here we describe how to connect to another site:
  66.  
  67. bighost Any ACU 2400 123456789 "" \r\d  in:--in: logname word: password
  68.  
  69. bighost = the name of the site we want to connect to 
  70. Any     = the time when it's allowed to call this site. Here you can
  71.       choose days,hours, refer to your manual
  72. ACU     = the name of the device-entry in L-devices we intend to use when
  73.       calling bighost
  74. 2400    = the baud rate we want to use for this device
  75.  
  76. 123456789 = the phone number, may have modem-control-codes like , W or so.
  77.  
  78. The rest of the line is a script to enable automatic login.
  79. There are always "EXPECT" - "SEND" - pairs.
  80.  
  81. EXPECT:  What we expect to "see" after the connection is established
  82. SEND  :  What we will answer when we got the "expected" stuff
  83.  
  84. Here the script in detail:
  85.  
  86. ""    =  expect nothing
  87. \r\d  =  send  RETURN (\r)  wait 2 seconds (\d = delay)
  88.  
  89. in:--in:  =  expect to see the rest of log(in:)  
  90.          --  =  If we do not get the first login, wait, send again
  91.          Return, wait for another log(in:)
  92. logname   =  what we will send after we got the login:-prompt.
  93.  
  94. word:     =  We expect to get now the rest of Pass(word:)
  95. password  =  And then we will send our password 
  96.  
  97. This is a small script normally good enough for most applications
  98.  
  99. If you use direct connection then you should use such a line:
  100.  
  101. bighost Any com2l 2400  -  "" \r\d  in:--in: logname word: password
  102.  
  103. Instead of ACU we now tell uucico about the device we use. But we still need
  104. the DIR - entry in L-devices.
  105.  
  106. Permissions
  107. -----------
  108.  
  109. The Permissions-file gives as individual control over the access granted
  110. to each system. Here a more complete example:
  111.  
  112. MACHINE=bighost LOGNAME=uubighost \
  113.       COMMANDS=rmail:rnews:uucp \
  114.       READ=/usr/spool/uucppublic:/tmp \
  115.       WRITE=/usr/spool/uucppublic:/tmp \
  116.       REQUEST=yes SENDFILES=yes
  117.  
  118. The Permissions-File is for both dialin and dialout
  119.  
  120. MACHINE  -  this permissions "belong" to bighost
  121. LOGNAME  -  when bighost logs in our machine it will use the login uubighost
  122. COMMANDS -  bighost is allowed to execute this commands on our machine
  123.         rmail, rnews and uucp are the most common needed commands
  124. READ     -  bighost is allowed to read files in this directories
  125. WRITE    -  bighost may write files into this directories
  126. REQUEST  -  yes - bighost may request files from our machine
  127.         no  - bighost is not allowed to request file from our machine
  128. SENDFILES - yes - when there are jobs queued for bighost and we have
  129.               a connection to it then transfer them
  130.  
  131. There are several other fields but I don't want to write a book, I only
  132. want to give a "FIRST AID-Kit".
  133.  
  134. If you edit this three files correctly you now have to call uucheck -v -f .
  135. uucheck -v -f will setup all directories, check for errors, check file
  136. permissions and so on. 
  137.  
  138. ----- comment from Udo Munk -----
  139. Please run uucheck -v -f twice, because the first run creates the new
  140. directorys with the wrong permissions. The second run will fix the
  141. permissions of the new directorys.
  142. ----- end of comment -----
  143.  
  144. And now begins the "real" part: UUCP-debugging ............
  145.  
  146. How uucp works (example: EMAIL)
  147.  
  148. You want to write an email to friend@bigsite.com. mail notices that
  149. friend is not a local user. Therefore it invokes rmail. rmail "visits"
  150. the file /usr/lib/mail/paths to find the way to bigsite.com. Afterwards
  151. it invokes uux that queues a job in the UUCP-spool-directory for bigsite.com
  152. (/usr/spool/uucp/bighost)
  153. uucico will be started (automatically or manually, depends), call the other
  154. machine and will transfer the files in the queue to bigsite.
  155. At bigsite when transmissions is finished, their uucico will invoke uuxqt.
  156. bigsite normally receives 2 files per job. One is the command-file and one
  157. is the datafile belonging to this command-file.
  158. The command here is:   rmail friend
  159. So uuxqt will invoke rmail friend < datafile
  160. rmail notices that friend is a local user and invokes: lmail friend < datafile
  161. (Don't assume that the commands are called exactly like that ....)
  162.  
  163. uux, uuxqt and uucico automatically create log-files about their "work".
  164. These logfiles are useful for debugging a new uucp-session.
  165. You will find these logfiles in: (command_name = uux, uuxqt or uucico)
  166.  
  167. /usr/spool/uucp/.Log/command_name/machine_name
  168.  
  169. So if something fails try to get "why" with the help of this files.
  170.  
  171. invoke uucico manually:
  172.  
  173. /usr/lib/uucp/uucico -r1 -x9 -sbighost
  174.  
  175. -xn =  debug on with debuglevel n.  9 is a good value. 
  176.  
  177. uucico will write a lot of information to your screen. Normally enough
  178. information what works or fails. So you normally should not have problems
  179. to find out what's wrong. 
  180.  
  181. Now it's yours to get it working ;-))
  182.  
  183.  
  184. -------------------------------------------------------------------------
  185. Additions:
  186. ----------
  187.  
  188. bighost wants to dial in our system:
  189.  
  190. edit /etc/passwd like that:
  191.  
  192. uubighost:cryptpw:10:10:uucp-login:/usr/spool/uucppublic:/usr/lib/uucp/uucico
  193.  
  194. cryptpw:  the crypted password for this login.
  195.  
  196. When the modem has Autoanswer enabled and also the port is enabled for
  197. logins then bighost can login and transfer mail, news, files to our
  198. machine.
  199. Easy  ;-))
  200.  
  201. ----------------------------------------------------------------------------
  202.  
  203. +----------------------------+--------------------+-------------------------+
  204. | Joachim Riedel             | joachim@jr.sub.org | jr@connie.de.convex.com |
  205. | Geschwister-Scholl-Str. 48 +----------------------------------------------|
  206. | D-6050 Offenbach am Main   | European Coherent Support BBS: +49 69 858711 |
  207. | Tel. +49 69 85 62 25       | V22bis, V32, V32bis (T3000 and USR Dual Std. |
  208. +---------------------------------------------------------------------------+
  209.  
  210.