home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 35 Internet / 35-Internet.zip / soupinst.zip / soupinst.doc
Text File  |  1996-01-25  |  11KB  |  321 lines
  1. A Quick and Easy Install of Souper v14 and Yarn v0.89 for OS/2
  2. **************************************************************
  3.  
  4. V0.02
  5.  
  6. By Steve Withers                                            Jan 20, 1996
  7.    Internet Marketing Specialist
  8.    IBM New Zealand
  9.    steve.withers@ibm.net 
  10.  
  11.  
  12. Here is the second draft of the Souper and Yarn Install Guide. Scott
  13. Katzer has sent me several notes making some excellent suggestions and
  14. providing his own version of the procedures for uploading and downloading 
  15. news - and several other things as well. 
  16.  
  17. I use SOUPER and YARN to download USENET news only. I download my mail
  18. with Post Road Mailer v1.03a. These instructions do not include info on
  19. how to set up YARN for receiving mail - though, of course, I must use
  20. YARN for my mailed replies to USENET posts I want to mail people about. 
  21. I think this will work fine for mail - but I haven't tried it.     
  22. Scott says he thinks it will work fine for incoming mail as it is very
  23. similar to his config. Try it and let me know. 
  24.  
  25. This may not be the most elegant, or intelligent install procedure. But I offer
  26. it as a guide to anyone who has scratched ruts in their head trying to 
  27. get Souper and Yarn/2 going with the supplied docs. It is intended
  28. to fill the gaps in the SOUPER and YARN docs - not to replace them. 
  29.  
  30.  
  31. CAUTION!!!!!!
  32. **************
  33.  
  34. Remember to adjust the drive letters in the procs to match your own.
  35. Make sure your environment variables point at the right drives and paths.  
  36.  
  37. IGNORE THE MULTI-USER COMMENTS UNLESS YOU *REALLY* NEED IT. You can 
  38. always add this function later once you are comfortable with
  39. the way SOUPER and YARN work. Moreover...I haven't tested them yet. :-)  
  40.  
  41.  
  42.  
  43. FILES YOU NEED *NOW*
  44. ********************
  45.  
  46. First, get these files: 
  47.  
  48.  
  49. (SOUPER and YARN)
  50. SOUPER14.ZIP - via ftp - ftp.oce.com       /pub/yarn
  51. YRN2_089.ZIP           - hobbes.nmsu.edu   /os2/comm
  52.                               
  53. (The EMX Run-Time DLLs)
  54. EMXRT.ZIP    - via ftp - hobbes.nmsu.edu /os2/unix/emx09a
  55.                        - ftp.cdrom.com   /pub/os2/lang/emx09a 
  56.  
  57. (Info ZIP and UNZIP archivers)
  58. ZIP201x2.ZIP - via ftp - hobbes.nmsu.edu /os2/archiver
  59. UNZ512x2.EXE           - ftp.cdrom.com   /pub/os2/archiver
  60.  
  61.  
  62. (There are many more sites that may have these files, but I have 
  63.  personally checked these.) 
  64.  
  65.  
  66.  
  67. INITIAL SETUP -> "Things To Do"
  68. *******************************
  69.  
  70. 1. Unzip EMXRT.ZIP in the root directory as it creates the \EMX
  71.    and other subdirectories. Otherwise you get \EMX\EMX..... :-)
  72.  
  73. 2. Make sure the EMX DLLs are in a directory somewhere on your LIBPATH. 
  74.    SOUPER.EXE won't run without them. I put them in x:\OS2\APPS\DLL 
  75.  
  76.    You can delete the \EMX directory and contents if you do it the 
  77.    way I do it - or put the \EMX\DLL directory on your LIBPATH and 
  78.    leave it there.  
  79.  
  80. 3. Make sure that UNZIP.EXE and ZIP.EXE are in a directory on your PATH. 
  81.    (I put them in x:\OS2\APPS) 
  82.  
  83. 4. Make the directories you will need. I put them on the same
  84.    partition/drive. 
  85.  
  86.    md x:\souper
  87.    md x:\yarninst
  88.    md x:\yarn
  89.    md x:\upload
  90.  
  91.  
  92.  
  93. SOUPER SETUP
  94. ************
  95.  
  96. 1. Unzip SOUPER??.ZIP into the x:\SOUPER directory. 
  97.  
  98. 2. Copy SOUPER.EXE to x:\OS2\APPS - or anywhere on your path. 
  99.  
  100. 3. Delete the x:\SOUPER\SOURCE directory if you like.  
  101.  
  102. 4. Make the NEWSRC file for SOUPER in the \SOUPER (the HOME=) directory
  103.    Use alt.test as your first and only newsgroup. Later, you can add any
  104.    others you want. The only line in the file at this point should be: 
  105.  
  106.    alt.test:  
  107.  
  108. (NOTE: Put 'NO REPLY' in the SUBJECT: line of any post to alt.test - or
  109.        you get auto-responder mail for *DAYS* - dozens of them.)
  110.  
  111. ************************************************************************
  112. OPTIONAL: DON'T DO IT IF YOU DON'T NEED TO! It only complicates things.
  113.  
  114.           If you want to run a multi-user setup, make a \SOUPER\<user>
  115.           directory and put your NEWSRC in there. You will also need
  116.           a \SOUPER\<user>\YARN directory with the YARN 'config' file
  117.           in it for your user settings. The YARN config file is 
  118.           created by the ADDUSER program you run in the next section. 
  119.           You can edit/copy it manually, as needed, once it
  120.           is created. The MSOUP.CMD has a statement (commented out)
  121.           that sets the HOME variable to let you go multi-user. 
  122.           Each user would need their own 'Muser.CMD' 
  123.  
  124.           DON'T DO IT IF YOU DON'T NEED TO. It only complicates things.
  125. ************************************************************************  
  126.  
  127.  
  128. YARN SETUP
  129. **********
  130.  
  131. 1. Unzip YRN2_0??.ZIP into the x:\YARNINST directory. 
  132.  
  133. 2. From x:\YARNINST, enter ENGLISH x:\YARN 
  134.  
  135. 3. Now delete the x:\YARNINST directory if you like. 
  136.  
  137. 4. Copy YARN.EXE, IMPORT.EXE and EXPIRE.EXE into a directory on
  138.    your PATH. (I use \OS2\APPS)
  139.  
  140. 5. Go to the x:\YARN directory and run the ADDUSER program.
  141.    Fill in the details:
  142.  
  143.    a. Make *your* directory x:\SOUPER
  144.  
  145.       (- unless you want to have multiple users....in which
  146.          case use \SOUPER\<user> for each user you want.)  
  147.  
  148.    b. I use TEDIT as my editor (I hate PM editors popping everywhere)  
  149.  
  150.    c. Make the upload directory/file: E:\UPLOAD\REPLY.ZIP
  151.  
  152.       (You would have to vary this by <user> in a multi-user setup, 
  153.        otherwise one user could overwrite another's replies
  154.        accidentally. This setting is in the 'config' file for each
  155.        user - with location controlled by the HOME= variable. If the
  156.        HOME= value is \SOUPER\FRED, then 'config' will found in 
  157.        \SOUPER\FRED\YARN)  
  158.  
  159. 5. Add at least the minimum environment variables to the config.sys: 
  160.    (These are all I need to make it work - I use the IBM Internet service.)
  161.  
  162.          SET HOME=x:\SOUPER
  163.          SET NNTPSERVER=news-s01.ny.us.ibm.net
  164.          SET YARN=x:\YARN
  165.          SET TZ=EST5EDT  - or whatever is appropriate.
  166.                            (If you get this wrong, you may get a 441 error
  167.                             say you are posting into the future)
  168.  
  169.          (for multi-user, the HOME value would need to be overridden in
  170.           each M<user>.CMD - as the first statement.) 
  171.  
  172.  
  173.  
  174. THE HOME STRETCH 
  175. ****************
  176.  
  177. 1. SHUTDOWN and REBOOT so the environment variables apply globally. 
  178.  
  179. 2. Dial up your Internet provider. 
  180.  
  181. 3. Test SOUPER. Issue this command to catch up alt.test to the latest
  182.    5 posts. I suggest only 5 because sometimes they can be pretty big,
  183.    depending on who has been testing what. 
  184.  
  185.    souper -c 5  (This catches up ALL newsgroups in the NEWSRC file)
  186.  
  187. 4. If that went OK....and it should have if everything is correctly set up, 
  188.    try downloading those 5 posts:  
  189.  
  190.    souper -m -k 4096   ("-m" - excludes mail)
  191.                        ("-k" sets the maximum amount to download in KB, 
  192.                          with "0" - zero - indicating NO limit. The 
  193.                          default is 2048KB - about 1,000 posts.)      
  194.                        
  195.  
  196.    Did it download some? You will have seen messages like these: 
  197.  
  198.     [E:\souper]souper -m -k 4096
  199.     souper:   41 unread articles in comp.os.os2.advocacy
  200.     souper:    0 unread articles in comp.os.os2.announce
  201.     souper:   27 unread articles in comp.os.os2.apps
  202.     souper:   21 unread articles in comp.os.os2.misc
  203.     4%
  204.  
  205.    Good.....you're almost there. 
  206.  
  207. 4. Now add whatever other newsgroups you like to your NEWSRC file in the
  208.    \SOUPER directory (or \SOUPER\<user> in a multi-user setup).
  209.  
  210.    Remember to catch them up to however many posts you 
  211.    think you can handle....usually no more than 50 each for, say, 10
  212.    newsgroups. That's 500 posts. But it's your life.......
  213.  
  214.    Also....if it tries to download posts that have already been 
  215.    expired from your newserver, it will appear to be doing nothing 
  216.    until it catches up with the ones that are still on the server. 
  217.  
  218. 5. From this point, you should be able to use *.cmd files like mine 
  219.    below to first get news, then afterwards, upload your followups and 
  220.    e-mail responses. 
  221.  
  222.  
  223. Here are my MSOUP.CMD ('make soup') and SSOUP.CMD (send soup) files
  224. for getting and sending news and mailed responses. 
  225.  
  226. ** This can be run from *any* directory if MSOUP.CMD is in a directory
  227. ** on your path. I use a program object to do it, called DOWNLOAD NEWS. 
  228.  
  229. (If you want to run multiple people using this news spool - as in on a
  230.  LAN - then change the HOME environment variable as the first line. 
  231. I have included a sample - commented out.)    
  232.  
  233. I put these on my PATH - usually in x:\OS2\APPS. 
  234.   
  235. ---------------------------------------------------------------
  236. MSOUP.CMD - Download the News and Import it to Yarn
  237. *********
  238.  
  239. /* SET HOME=x:\SOUPER\STEVE */ 
  240.  
  241. /* ** Change to my HOME directory ** */
  242. 'x:'
  243. 'cd \SOUPER'
  244.  
  245. /* ** Download the news ** */ 
  246. 'souper -m'
  247.  
  248. /* ** ZIP the news prior to import to YARN ** */ 
  249. 'zip -0m soup.zip areas *.msg'
  250.  
  251. /* ** Backup the downloaded news - just in case. ** */
  252. 'copy soup.zip soupbkp.zip'
  253.  
  254. /* ** import the news into Yarn - NOTE: import deletes soup.zip ** */
  255. 'import soup.zip'
  256.  
  257. -----------------------------------------------------------------
  258.  
  259. RUNNING YARN
  260. ************
  261.  
  262. Now you would enter YARN anywhere to start YARN and read news/reply.
  263. Or use a program object - mine is called READ NEWS. 
  264. When you exit YARN, it will create the REPLY.ZIP file we specified
  265. earlier in the x:\UPLOAD directory. (x:\UPLOAD\<user> in a multi-
  266. user setup.)
  267.  
  268. You can check out the YARN docs for things like changing the colours
  269. and the like. This is done in the 'config' file. I find using YARN
  270. a lot like using TRN....especially for replying and following up.   
  271.  
  272. ------------------------------------------------------------------------
  273.  
  274. SSOUP.CMD - Uploads Follow-ups and E-mail Responses 
  275. *********
  276.  
  277. /* ** Upload Responses ** */ 
  278.  
  279. 'x:'
  280. 'cd \upload'
  281. 'unzip -o x:\upload\reply.zip'
  282.  
  283. /* ** These statements backup my reply files "just in case". ** */
  284. 'copy reply1.zip reply2.zip'
  285. 'copy reply.zip reply1.zip'
  286.  
  287. /* ** Delete the reply file ** */
  288. 'del x:\upload\reply.zip'
  289.  
  290. /* ** Upload my news and mail responses. ** */  
  291. 'souper -s'
  292. 'cd\souper'
  293.  
  294. -------------------------------------------------------------------------
  295.  
  296. OTHER UTILITIES
  297. ***************
  298.  
  299. YEP (from ftp.oce.com /incoming) - an OS/2 program which lets you modify
  300. your message headers to add things like X-Newsreader to your posts to let
  301. the world know that you're using Yarn! Scott Katzer has played with it and says 
  302. it works well.  
  303.  
  304. YES (from ftp.oce.com /pub/yarn) - "a DOS package which has more
  305. functions than YEP.  I haven't used this yet." (Said Scott). 
  306.  
  307. YarnUtil (from ftp.oce.com /pub/yarn) - "another collection of utilities.
  308.                         I haven't tried this yet either." (Said Scott). 
  309.  
  310. YarnDial (from hobbes.nmsu.edu /pub/comm) - Dial in & process news
  311.                                             with yrn2_0XX & souper
  312.  
  313.  
  314.  
  315. ***********************************************************
  316. Steve Withers - Wellington, New Zealand
  317. sbwnz01@ibm.net / swithers@vnet.ibm.com
  318. Canadian since '58 / Kiwi (too) since '88 / OS/2 since April '92 
  319. Life started great and just keeps getting better!
  320. ***********************************************************
  321.