home *** CD-ROM | disk | FTP | other *** search
/ com!online 2005 April / com_0405_1.iso / opensource / coLinux-0.6.1.exe / README < prev    next >
Encoding:
Text File  |  2004-04-20  |  4.9 KB  |  136 lines
  1. Cooperative Linux 0.6.x - 'starting to be stable' test binaries 
  2. -----------------------------------------------------
  3.  
  4. WARNING: 
  5.  
  6. Although this binary release of Cooperative Linux may be actually useful on
  7. some setups (e.g, stable setups), it is meant for testing purposes only, 
  8. which means that running it may crash your Windows system.
  9.  
  10. PLEASE REPORT and read about problems on the colinux-devel@sourceforge.net mailing list.
  11.  
  12. NOTE: If upgrading, please backup or copy your current default.colinux.XML file
  13.       before installing!
  14.  
  15. To run Cooperative Linux, please follow these instructions before trying to run 
  16. anything.
  17.  
  18. 1. Run the downloaded installer file to begin the installation. 
  19.    
  20. 2. Choose an installation directory. It is better to choose c:\coLinux because
  21.    this way you don't need to edit the configuration XML since the pathnames
  22.    of block devices files are currently aboslute. However, note that any 
  23.    directory should be acceptable.
  24.  
  25. 3. Choose networking method(s) to install. Currently there are two choices:
  26.  
  27.     a. TAP driver - This method installs a virtual network adapter that can 
  28.     then be either shared or bridged with a physical network connection. 
  29.     Note that this requires Internet Connection Sharing or Bridging 
  30.     (Windows XP or higher)or a 3rd party Internet connection sharing 
  31.     application. See the Wiki at www.colinux.org for more information/help.
  32.  
  33.       b. Bridging - This method allows the Cooperative Linux network 
  34.     interface to directly interoperate with one of your built in networking 
  35.     interfaces. You'll need to edit the configuration XML file to reflect 
  36.     that type="bridged" and the 'name' parameter needs to be set to a 
  37.     substring of the network adapter name that you will be bridging with. 
  38.     Go the the network properties of your machine, and get the properties 
  39.     of the adapter you will be bridging. Look at the text under the 
  40.     'Connect Using' label. If it says, for example "Intel Pro Adapter",
  41.     then you would set the 'name' in the XML file to: name="Intel Pro". 
  42.     See the Wiki at www.colinux.org for more information/help.
  43.  
  44. 4. Choose whether to download a root file system from the Cooperative Linux 
  45.    sourceforge page. The installer will try to download directly in 
  46.    the next step but if you experience any issues you can visit the
  47.    Sourceforge page directly at:
  48.  
  49.    http://sourceforge.net/project/showfiles.php?group_id=98788&package_id=108058
  50.  
  51.    NOTE ABOUT DISK SPACE: Each image extracts to over 1GB (or more), so make 
  52.    sure you   have enough  space there before you start downloading/extracting 
  53.    it. If you are manually downloading, put the extracted file in the 
  54.    installation directory. To unzip .bz2 files, you can use Winzip or 7-Zip 
  55.    (or the bzip utilities in Cygwin, etc). The image MUST be extracted from 
  56.    the .bz2 archive before use!   
  57.  
  58. 5. Edit the XML file to point to whatever root file system you downloaded. 
  59.    
  60. 6. The installation directory should include vmlinux, default.config.xml, the 
  61.    supplied linux.sys driver, executables and dlls, and probably the root 
  62.    filesystem image. Be sure to review the XML file for any additional 
  63.    configuration that may be needed.
  64.  
  65. 7. Run coLinux-daemon.exe. The current directory should be the installation 
  66.    directory, because that is where it will look for default.colinux.xml.
  67.    
  68.    The console window opens and you would see a Linux machine booting in 
  69.    that window.
  70.  
  71. Post Installation
  72. -----------------
  73.  
  74. You may wish to set up some post installation parameters, including increasing
  75. the amount of memory allocated to Cooperative Linux, or adding a swap 
  76. partition. See the Wiki at www.colinux.org for additional help on these tasks.
  77.  
  78.  
  79. Command Line Parameters
  80. ------------------------
  81.  
  82. The following command line paramaters may be useful in operating Cooperative 
  83. Linux.
  84.  
  85.     -c filename.XML
  86.         Allows you to choose a specific XML configuration file to use.
  87.  
  88.     -t consoletype
  89.         Allows you to specify either the FLTK (default) or NT (-t nt) 
  90.         console to use on startup. 
  91.  
  92.     -i servicename
  93.         Allows you to install Cooperative Linux as a service. Also 
  94.         use the -c parameter to specify your configuration file when 
  95.         doing this. <servicename> is whatever you want it to be called.
  96.  
  97.     -r servicename
  98.         Allows you to remove the Cooperative Linux service. 
  99.  
  100.  
  101.  
  102. Common Problems
  103. ---------------
  104.  
  105.     "Unable to mount root fs"
  106.         Generally this means that the root filesystem image is 
  107.         missing, or was specified incorrectly.
  108.  
  109.  
  110. Getting Help
  111. ------------
  112.  
  113. The following resources are available if you need help getting going, or find 
  114. bugs, etc.
  115.  
  116.     IRC
  117.         The official IRC location is at server irc.oftc.net, 
  118.          channel #colinux.
  119.  
  120.     WEB
  121.         The official website, containing downloads, documentation, 
  122.         FAQ, WIKI, etc., is at http://www.colinux.org.
  123.     
  124.     Mailing Lists
  125.         Visit the colinux.org website and choose from the available 
  126.         mailing lists (user and devel) to join, view archives, etc.
  127.  
  128.  
  129.  
  130. -
  131. Dan Aloni
  132. da-x@gmx.net
  133.  
  134. Richard Goodwin (readme portions)
  135. colinux@newdiversions.com
  136.