home *** CD-ROM | disk | FTP | other *** search
/ Datatid 2000 #1 / Datatid-2000-01.iso / nyt / SHOUTCAST / SERVER / README.TXT next >
Encoding:
Text File  |  1999-08-07  |  6.9 KB  |  152 lines
  1.           _ _          __ _        _             _              _   
  2.  _ _ _  _| | |___ ___ / _| |_   __| |_  ___ _  _| |_ __ __ _ __| |_ 
  3. | ' \ || | | (_-</ _ \  _|  _| (_-< ' \/ _ \ || |  _/ _/ _` (_-<  _|
  4. |_||_\_,_|_|_/__/\___/_|  \__| /__/_||_\___/\_,_|\__\__\__,_/__/\__|
  5. ====================================================================
  6.                                               streaming audio system
  7.  
  8. README.TXT for SHOUTCAST SERVER 1.10 - August 4 1999
  9.  
  10. Table of Contents:
  11.   Introduction
  12.   Updates
  13.   Bug reporting
  14.   Installation
  15.   Configuration
  16.   Tech Notes / How it Works
  17.   Remote Administration
  18.   A Word To The Unwise
  19.   License
  20.  
  21. Introduction:
  22.  
  23.   SHOUTcast is a streaming audio system for Windows and Un*x platforms.
  24. The SHOUTcast server is the core of the system, and includes unique
  25. features which distinguish SHOUTcast from other servers, including the 
  26. ability to relay a common stream across multiple SHOUTcast servers to
  27. distribute load, and automatic integration into the SHOUTcast directory
  28. at http://yp.shoutcast.com for effective exposure of your SHOUTcast
  29. server to the world at large, when desired.
  30.  
  31.   SHOUTcast is a product of Nullsoft, Inc, makers of the fantastically
  32. popular Winamp audio player for Win32.  The SHOUTcast system relies on
  33. Winamp for playback and content sourcing.  Winamp is available at
  34. http://www.winamp.com
  35.  
  36. Updates:
  37.  
  38.   SHOUTcast world headquarters is at http://www.shoutcast.com.  Stop by 
  39. to snag the latest version and view online documentation (with pictures,
  40. no less.)
  41.  
  42. Bug reporting:
  43.  
  44.   SHOUTcast is freeware, and doesn't really have a support team to back it
  45. up.  If you come up with an intelligent question or notice a glaring bug,
  46. please notify us at bugfixes@shoutcast.com, but be advised we cannot 
  47. guarantee we'll be able to get back to you.
  48.  
  49. Installation:
  50.  
  51. Windows:  Unzip into an appropriate location on your drive, i.e. c:\shoutcast.
  52. Make sure you have three files:  sc_serv.exe, sc_serv.ini, and readme.txt.
  53.  
  54. Unix versions:  Use gunzip and tar to decompress and extract the necessary
  55. binaries for your particular operating system.  When complete, you should
  56. have three files:  the server binary, server config file, and this readme.
  57. Make certain the server is chmod u+x, and that the config file is readable
  58. by the user you want to run the server as.  The server does *not* need to
  59. be run as root, unless you want to use port numbers below 1024 to serve
  60. SHOUTcast audio streams.
  61.  
  62. Configuration:
  63.  
  64. Windows:  Edit the sc_serv.ini file in Notepad or click the Edit Config menu 
  65. item in the server.  The parameters should be self-explanatory.  Remember
  66. to quit and restart your server (if it's running) to cause the changes to take
  67. effect.
  68.  
  69. Unix:  Edit the sc_serv.conf file in the text editor of your choice.  Tom
  70. would prefer you use Emacs, because it makes Justin really mad.  Justin would
  71. prefer you use vi, because he thinks Tom suffers from some vicious malaise.
  72. You'll probably be lame and end up using Pico.
  73.  
  74. Tech Notes / How it Works:
  75.  
  76. Without going into too much detail, the SHOUTcast server is an intelligent
  77. repeater.  It receives data from a source, notifies the SHOUTcast directory
  78. when requested to by the client, and repeats the data from the source to
  79. the listeners.  It attempts to do this rather efficiently.
  80.  
  81. The Windows server runs under any 32 bit Windows O/S (NT, 95, 98).  It's
  82. a threaded, multi-processor aware application.  It uses about 2MB of RAM
  83. and very little CPU.
  84.  
  85. The Unix server runs (as of this beta release) on win32, FreeBSD, 
  86. Linux (libc5 and glibc), and Solaris.
  87.  
  88. Remote Administration:
  89.  
  90. Remote admistration is now far superior than SHOUTcast 1.0. Simply point
  91. your web browser to http://my.machine.ip:port/ and start from there.
  92. The classic LOG <password> and TAILLOG <password> commands still work via
  93. telnet, but using the web interface is preferable if you ask us :)
  94.  
  95. A Word To The Unwise:
  96.  
  97. All listeners are only able to listen at what their connections can support.
  98. For most users on the net, when you consider modem/PPP overhead, internet 
  99. congestion, and the fact that most modems out there are around 33.6kbps, it
  100. makes sense to use 24kbps for most public streaming. Even though, 
  101. theoretically, 33.6 users should be able to listen at 32kbps, with overhead 
  102. it becomes impossible.
  103.  
  104. Anyone with a 56k modem sending to an upstream server is affected by the 
  105. asymmetric nature of 56k modems. That is, the fastest a 56k modem can download 
  106. data as fast as 53kbps, the upload data is at most 31.2kbps. Sorry, no
  107. 56 or 32kbps streams are servable over a 56k modem.
  108.  
  109. You cannot serve more users that you have available bandwidth. If you're 
  110. running the SHOUTcast server over a modem link at any speed, the most you 
  111. can muster is one user at 24 or 32kbps. Attempting to serve more users than
  112. you have bandwidth only causes skippage.
  113.  
  114. Shell sysadmins will be *very* unhappy if you consume their available 
  115. bandwidth and server CPU without their consent. SHOUTcast is a highly 
  116. demanding program of bandwidth. A T1 line can only theoretically support 
  117. about 60 listeners if no other traffic is on that T1. Additionally, each 
  118. listener takes up a thread on the server operating system, which can slow 
  119. some operating systems if allowed to expand beyond the limits of the system. 
  120. If you throw up a SHOUTcast server unbeknownst to the sysadmin with 50+ 
  121. maximum users, you had better be prepared to face the consequences of your 
  122. actions.  As a fellow sysadmin, I offer this to you as your ONLY WARNING.
  123.  
  124. Pick a smart number of maxusers for your server. Calculate by taking the 
  125. available bandwidth you have, multiplying by 0.9 to account for overhead, 
  126. and dividing by the bitrate you want to serve at. For example, an ADSL 
  127. connection @ 768kbps upstream * 0.9 / 24kbps ~= 29 maximum users. Again, 
  128. set this number too high, and when you reach the limit of bandwidth ALL 
  129. the streams will start to skip. 
  130.  
  131. License:
  132.  
  133. SHOUTCAST SERVER(TM)
  134.  
  135. SHOUTCAST(TM), all versions, are copyright protected and are the property 
  136. of Nullsoft, Inc.  Until further notice, this software may be used for personal
  137. or commercial purposes for free and need not be registered with Nullsoft, Inc.,
  138. or its parent company, America Online, Inc.
  139.  
  140. SHOUTCAST(TM) may not be copied, sold, distributed or used in any other 
  141. manner without the express written consent of Nullsoft, Inc.
  142.  
  143. To the maximum extent permitted by law, Nullsoft, Inc. disclaims all
  144. warranties regarding this software, express or implied, including but not
  145. limited to warranties of merchantability and fitness for a particular
  146. purpose.  In no event shall Nullsoft, Inc. be liable for consequential,
  147. special, incidental or indirect damages arising out of the use or inability
  148. to use this software even if Nullsoft, Inc. is aware of the possibility of
  149. such damages or a known defect.
  150.  
  151. By using this software, you are agreeing to the above terms.
  152.