home *** CD-ROM | disk | FTP | other *** search
/ Chip 2005 May / CMCD0505.ISO / Software / Complet / Colinux / coLinux-0.6.2.exe / README.txt < prev    next >
Text File  |  2005-02-05  |  9KB  |  252 lines
  1. Cooperative Linux 0.6.2 README
  2. ----------------------------------------------------------------------------
  3.  
  4.   Instructions for running Cooperative Linux for Windows (see source for 
  5. how to build and run coLinux for Linux)
  6.  
  7. WARNING: 
  8.  
  9.   Although Cooperative Linux may be actually useful on some setups
  10. (e.g, stable setups), it is still meant for testing purposes only. 
  11. This means that running it may crash the host (Windows or Linux system).
  12.  
  13. PLEASE REPORT and read about problems on the colinux-devel@sourceforge.net 
  14. mailing list or file an Bug report at 
  15. http://www.sourceforge.net/projects/colinux
  16.  
  17. NOTES ON UPGRADING:
  18.  
  19.  1) If upgrading, please backup or copy your current default.colinux.XMfile
  20.       before installing!
  21.  
  22.  2) If you are upgrading from 0.6.1 to 0.6.2 the kernel version has 
  23. changed (2.4.x in 0.6.1 and 2.6.x in 0.6.2), make sure you get 
  24. module-init-tools if you want to work with modules in this new version. 
  25. See other 2.6 upgrade resources for information about other changes.
  26.  
  27.  3) Gentoo users need to be careful, Gentoo tends to use devfs when 
  28. upgrading to 0.6.2 and so block device names change from cobdX to cobd/X 
  29. and render the image unbootable.  For more details and solutions see the
  30. 2.6 related information on the Wiki (http://wiki.colinux.org)
  31.  
  32.  
  33. RUNNING:
  34.  
  35. To run Cooperative Linux, please follow these instructions before trying to run 
  36. anything.
  37.  
  38. 1. Run the downloaded installer file to begin the installation. 
  39.    
  40. 2. Choose an installation directory. It is better to choose c:\coLinux because
  41.    this way you don't need to edit the configuration XML since the pathnames
  42.    of block devices files are currently aboslute. However, note that any 
  43.    directory should be acceptable.
  44.  
  45. 3. Choose networking method(s) to install. Currently there are two choices:
  46.  
  47.     a. TAP driver - This method installs a virtual network adapter that can 
  48.     then be either shared or bridged with a physical network connection. 
  49.     Note that this requires Internet Connection Sharing or Bridging 
  50.     (Windows XP or higher) or a 3rd party Internet connection 
  51.         sharing application. See the Wiki at wiki.colinux.org for more 
  52.         information/help. The TAP method autmatically chooses the TAP 
  53.         first TAP adapter it finds, if this is not correct for you, you 
  54.         can specify the specific adapter by name (name="TAP1"). 
  55.  
  56.       b. Bridging - This method allows the Cooperative Linux network 
  57.     interface to directly interoperate with one of your built in networking 
  58.     interfaces. You'll need to edit the configuration XML file to reflect 
  59.     that type="bridged" and the 'name' parameter needs to be set to a 
  60.     substring of the network connection name that you will be bridging 
  61.     with (e.g. name="Local Area Connection"). See the Wiki at 
  62.     http://wiki.colinux.org for more information/help.
  63.  
  64. 4. Choose whether to download a root file system from the Cooperative Linux 
  65.    sourceforge page. The installer will try to download directly in 
  66.    the next step but if you experience any issues you can visit the
  67.    Sourceforge page directly at:
  68.  
  69.    http://sourceforge.net/project/showfiles.php?group_id=98788&package_id=108058
  70.  
  71.    NOTE ABOUT DISK SPACE: Each image extracts to over 1GB (or more), so make 
  72.    sure you have enough space there before you start downloading/extracting 
  73.    it. If you are manually downloading, put the extracted file in the 
  74.    installation directory. To unzip .bz2 files, you can use Winzip or 7-Zip 
  75.    (or the bzip utilities in Cygwin, etc). The image MUST be extracted from 
  76.    the .bz2 archive before use!
  77.  
  78. 5. Edit the XML file to point to whatever root file system you downloaded. 
  79.    
  80. 6. The installation directory should include vmlinux, default.config.xml, the 
  81.    supplied linux.sys driver, executables and dlls, and probably the root 
  82.    filesystem image. Be sure to review the XML file for any additional 
  83.    configuration that may be needed.
  84.  
  85. 7. Run coLinux. The current directory should be the installation directory, 
  86.    if not, then you man need to change paths (especially for vmlinux)
  87.    in the XML config file..
  88.  
  89.     a. Running as an service.  
  90.         colinux-daemon.exe -c config.xml --install-service "Cooperative Linux"
  91.         Also, to remove the service:
  92.         colinux-daemon.exe --remove-service "Cooopeative Linux".
  93.        Then go to the Service Manager and start the "Cooperative Linux" 
  94.        service,
  95.        OR net start "Cooperative Linux"
  96.        Last, got to the installation directory and double-click on
  97.            colinux-console-fltk.exe OR
  98.         colinux-console-nt.exe        
  99.     b. As an regular application. 
  100.         colinux-daemon.exe -c config.xml
  101.            See colinux-daemon --help for details about possible 
  102.        command-line arguments.
  103.    
  104.    The console window opens and you would see a Linux machine booting in 
  105.    that window.
  106.  
  107. Post Installation
  108. -----------------
  109.  
  110. You may wish to set up some post installation parameters, including increasing
  111. the amount of memory allocated to Cooperative Linux, or adding a swap 
  112. partition. See the Wiki at wiki.colinux.org for additional help on these 
  113. tasks.
  114.  
  115.  
  116. Command Line Parameters
  117. ------------------------
  118.  
  119. The following command line paramaters may be useful in operating Cooperative 
  120. Linux.
  121.  
  122.     -a #
  123.         Allows you to specify the instance of Coooperative Linux
  124.         that you will be connecting to.
  125.  
  126.     -c filename.XML
  127.         Allows you to choose a specific XML configuration file to use.
  128.  
  129.     -t consoletype
  130.         Allows you to specify either the FLTK (default) or NT (-t nt) 
  131.         console to use on startup. 
  132.  
  133.     --install-service servicename
  134.         Allows you to install Cooperative Linux as a service. Also 
  135.         use the -c parameter to specify your configuration file when 
  136.         doing this. <servicename> is whatever you want it to be called.
  137.  
  138.     --remove-service servicename
  139.         Allows you to remove the Cooperative Linux service. 
  140.  
  141.     --install-drvier
  142.         This command to install the driver portion of Cooperative 
  143.         Linux. BIG NOTE: This already happens during the installation 
  144.                 of coLinux, on most cases you don't need to run it at all.
  145.     
  146.     --remove-driver
  147.         This command will remove the driver portion of Cooperative
  148.         Linux. BIG NOTE: This already happens during the uninstall
  149.                 of coLinux, on most cases you don't need to run it at all.
  150.  
  151. OR
  152.  
  153.     If the first command-line argument on the command line is 
  154. kernel= you will be able to give all the configuration on the 
  155. command-line, in this "mode" the command-line arguments are:
  156.  
  157.     kernel=<path to vmlinux file>
  158.         This specifies the path to the vmlinux file, typically
  159.                 kernel=vmlinux works.
  160.  
  161.     initrd=<path to initrd file>
  162.         This specifies the path to the initrd file, typeically
  163.          initrd=initrd.gz
  164.  
  165.     mem=<mem size>
  166.         This specifies the memory size, assumes MB is the the
  167.         unit type, so 64 is same as 64MB. Default if you leave
  168.         this parameter out is 1/4 of your RAM if your RAM is >= 
  169.         128, otherwise it's 16.  Default value is generally ok.
  170.  
  171.     cobdX=<path to image file>
  172.         Use any number of these to specify the block device's
  173.                 image files
  174.  
  175.     alias=<path to image file> | :cobdX
  176.         Use any number of these to specify an alias (hda1, etc)
  177.                 for an block device's image file.  <path to image file 
  178.                 can be to an partition using standard 
  179.                 \HardDiskX\PartitionY format.
  180.  
  181.     cofsX=<path to windows directory>
  182.         Use any number of these to specify a Cooperative 
  183.         Host filesystem device (mount Host directory to coLinux
  184.         local mount point). There are some limitations in it's
  185.         use currently (namely non-ASCII files).
  186.  
  187.     ethX=tap | pcap-bridge,<network connection name>,<MAC> 
  188.         Use any number of these to specify network interfaces,
  189.         <network connection name & <MAC> are optional.
  190.         
  191.     root=<root device>
  192.         This is the device (as coLinux gues sees it) to the root
  193.         device.
  194.  
  195.     ANY additional parameters are passed to the coLinux kernel as is 
  196. (unmodified).
  197.  
  198.  
  199. Common Problems
  200. ---------------
  201.  
  202.     "Unable to mount root fs"
  203.         Generally this means that the root filesystem image is 
  204.         missing, or was specified incorrectly.
  205.  
  206. Developing, Helping out the Project
  207. -----------------------------------
  208.  
  209.    Check out the source code, and or the Home page 
  210. (http://www.colinux.org) for more on developing coLinux and/or helping 
  211. the project out.  Also, subscribing to the Mailing List is helpful.
  212.  
  213.  
  214. Getting Help
  215. ------------
  216.  
  217. The following resources are available if you need help getting going, or find 
  218. bugs, etc.
  219.  
  220.     IRC
  221.         The official IRC location is at server irc.oftc.net, 
  222.          channel #colinux.
  223.  
  224.     WEB
  225.         The official website, containing downloads, documentation, 
  226.         FAQ, WIKI, etc., is at http://www.colinux.org
  227.  
  228.     Project Web-site
  229.         Source Forge Project website is at 
  230. http://www.sourceforge.net/project/colinux
  231.     
  232.     WIKI
  233.         The community has contributed wonderful and helpful 
  234.                 information on numerous topics, which is available at
  235.                 http://wiki.colinux.org (You can contribute here too!)
  236.     
  237.     Mailing Lists
  238.         Visit the colinux.org website and choose from the available 
  239.         mailing lists (user and devel) to join, view archives, etc.
  240.  
  241.  
  242.  
  243. -
  244. Dan Aloni
  245. da-x@gmx.net
  246.  
  247. Richard Goodwin (readme portions)
  248. colinux@newdiversions.com
  249.  
  250. George P Boutwell (readme updates, fixes, etc)
  251. gboutwel@praize.com
  252.