#LyX 1.1 created this file. For more info see http://www.lyx.org/ \lyxformat 2.16 \textclass docbook \begin_preamble \end_preamble \language default \inputencoding default \fontscheme default \graphics default \paperfontsize default \spacing single \papersize Default \paperpackage a4 \use_geometry 0 \use_amsmath 0 \paperorientation portrait \secnumdepth 3 \tocdepth 3 \paragraph_separation indent \defskip medskip \quotes_language english \quotes_times 2 \papercolumns 1 \papersides 1 \paperpagestyle default \layout Title \added_space_top vfill \added_space_bottom vfill Conectiva Linux 6 under VMware \layout Date 10 January, 2001 \layout Author Jacob Moorman, Marble Horse Free Software Group \layout Abstract Conectiva Linux 6 is among the most complete and innovative Linux distributions currently available. Past releases of Conectiva Linux have propelled Conectiva to the forefront of Linux use in South America and Latin America. VMware, a x86 hardware emulation system (virtual machine), permits the end-user to run most modern operating systems in a window on a Linux or Windows host. The stock VMware instructions do not provide the detail needed to install Conectiva Linux 6 under VMware; this document provides a step-by-step overview of the install process. \layout Section Introduction \layout Subsection Conectiva Linux 6 \layout Standard Conectiva Linux 6 is the latest Linux distribution release from Conectiva, a leader in free software operating system development throughout South America and Latin America. This release is provided in Portuguese, Spanish and English; it includes a friendly installer and provides an excellent \begin_inset Quotes eld \end_inset out-of-box \begin_inset Quotes erd \end_inset experience. \layout Standard Conectiva Linux 6 includes a number of innovative features, including support for the powerful APT package management system with integrated RPM package format support. Never has keeping your Conectiva Linux system updated ever been easier. \layout Standard This release is based on GNU glibc 2.1.3, Linux kernel 2.2 series, XFree86 4.0.1 and includes over 1000 packages. The full Conectiva Linux 6 distribution boxed set includes four CDs (two of binary packages and two of source packages). Both KDE2 and GNOME desktops are included in this release. \layout Standard Conectiva Linux 6 may be downloaded from a number of sites on the Internet, or you may purchase a Conectiva Linux 6 boxed set. Commercial support and training for Conectiva Linux are also available. The Conectiva web site (which includes details regarding the Conectiva Linux distribution) may be found at: \begin_inset LatexCommand \htmlurl[http://www.conectiva.com.br]{http://www.conectiva.com.br} \end_inset \layout Subsection VMware \layout Standard VMware provides a mechanism to run most modern operating systems (for the Intel x86 architecture) in a window on your Linux or Windows desktop. Using this \begin_inset Quotes eld \end_inset virtual computer \begin_inset Quotes erd \end_inset technology, one can easily test out a particular operating system distribution, try out a new version of an operating system distribution before upgrading, or test the software currently in development on various different operating system distributions. \layout Standard The virtual computer provided by a VMware session is user-configurable. Within each virtual computer, VMware may support a number of networking configurations (and emulates an Ethernet card compatible with most operating systems), IDE and SCSI disks, CD-ROM drives and floppy drives, VGA graphics and SoundBlaster-compatible sound. The \begin_inset Quotes eld \end_inset disk \begin_inset Quotes erd \end_inset support stores a disk image on your hard drive as a file, permitting you to try various operating systems without repartitioning your system. This nearly-complete solution provides the hardware emulation you need to run nearly any operating system in a stable manner. \layout Standard VMware is a commercial product, licensed per host machine. Information regarding VMware may be found at: \begin_inset LatexCommand \htmlurl[http://www.vmware.com]{http://www.vmware.com} \end_inset \layout Subsection This Document \layout Subsubsection About the Author \layout Standard This document has been written by Jacob Moorman of the \begin_inset LatexCommand \htmlurl[Marble Horse Free Software Group]{http://www.marblehorse.org} \end_inset . The Marble Horse Free Software Group is a distribution-independent development group devoted to the creation of new free software, enhancement of existing free software solutions, free software-related advocacy, and production of free software-related documentation. He may be reached at \begin_inset LatexCommand \htmlurl[roguemtl@marblehorse.org]{mailto:roguemtl@marblehorse.org} \end_inset \layout Subsubsection Free Software \layout Standard Conectiva Linux 6 is free software/open source software. VMware is neither free software, nor open source software; this documentation has been written to provide benefit to free software users. It should be recognized that free alternatives to VMware may be available in the future; the \begin_inset LatexCommand \htmlurl[Plex86]{http://www.plex86.org} \end_inset project is a promising effort which may eventually provide a suitable, free alternative to VMware. Your support of the Plex86 project is encouraged. \layout Subsubsection Copyright \layout Standard Copyright (c) 2000, 2001 Jacob Moorman \layout Standard This manual may be reproduced in whole or in part, without fee, subject to the following restrictions: \layout Standard The copyright notice above and this permission notice must be preserved complete on all complete or partial copies. \layout Standard Any translation or derived work must be approved by the author in writing before distribution. \layout Standard If you distribute this work in part, instructions for obtaining the complete version of this manual must be included, and a means for obtaining a complete version provided. \layout Standard Small portions may be reproduced as illustrations for reviews or quotes in other works without this permission notice if proper citation is given. \layout Standard Exceptions to these rules may be granted for academic purposes: Write to the author and ask. These restrictions are here to protect us as authors, not to restrict you as learners and educators. \layout Standard Please contact the author via email before distribution or inclusion of this documentation in any works. This is to make sure that the most recent and most accurate version is used and is a request, not a requirement. \layout Subsubsection Disclaimer \layout Standard This document is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. \layout Subsubsection Trademarks \layout Standard VMware, the VMware "boxes" logo, and all VMware-based trademarks and logos are trademarks or registered trademarks of VMware, Inc. in the United States and other countries. \layout Standard Linux is a registered trademark of Linus Torvalds. \layout Standard All other trademarks are property of their respective owners. \layout Subsubsection Document Version \layout Itemize 10 January, 2001: Added information about the MI 2.1.0u1 updates diskette. Minor cleanup and proofing changes. \layout Itemize 30 November, 2000: Initial public release. \layout Subsubsection Materials \layout Standard The instructional portion of this document was generated using Conectiva Linux 6.0 with the MI 2.1.0u1 update diskette, on VMware 2.0.3 build-799. Red Hat Linux 6.2 (with all updates at time of writing) was used as the host platform. \layout Standard This document was generated using \begin_inset LatexCommand \htmlurl[LyX]{http://www.lyx.org} \end_inset , a document authoring system. \layout Section Installation Procedure \layout Subsection Prerequisites \layout Subsubsection VMware \layout Standard Prior to following the installation instructions included within this document, it is expected that you have, 1) obtained the VMware software; 2) obtained a valid license for VMware (either by purchasing a license or obtaining a trial license from VMware); 3) installed a supported host platform for VMware (the author of this document used Red Hat Linux 6.2 to generate these instructions, though you may use any supported VMware platform); and 4) installed the VMware software and completed the post-install configuration (vmware-config.pl). When configuring VMware, you should select options to enable host-only networking. \layout Subsubsection Host Operating System \layout Standard It is recommended that you consider installing all distributor-supplied updates and errata for your host platform; keeping your system up-to-date helps to prevent known bugs from interrupting your work. Documentation on installing system updates are available on the vendor web sites for the majority of VMware-supported host platforms. Please attempt to ensure that your system is running properly before you add the complexity of running virtual machine software. \layout Standard If you are using a Linux (or GNU/Linux) distribution as your host, please read the VMware documentation related to X servers supported on host platforms. Ensure that you have sufficient free disk space (1000-3000 MB free, minimum) to install Conectiva Linux 6 under VMware. Verify that your /dev/cdrom device is a symlink pointing to the correct hardware device for your CD-ROM. (Does your CD-ROM drive work?) \layout Subsubsection Conectiva Linux \layout Standard Obtain Conectiva Linux 6 disc 1. This may be done by purchasing a Conectiva Linux 6 boxed set; or by downloading (free of charge, excepting any Internet service fees your ISP charges) the ISO image for Conectiva Linux 6 disc 1 and burning it to CD (using a CD burner). Take a moment to review the release notes included on the CD. \layout Standard Additionally, you will require the MI (Modular Installer) updates diskette image provided by Conectiva. This diskette fixes several bugs in the previous version of the installer which would prevent you from installing Conectiva Linux 6.0 under VMware. The updates disk is available from \begin_inset LatexCommand \htmlurl[ftp://atualizacoes.conectiva.com.br/6.0/images/mi-2.1.0u1-cl60.img]{ftp://atualizacoes.conectiva.com.br/6.0/images/mi-2.1.0u1-cl60.img} \end_inset ; a digital signature for this disk image (signed with the Conectiva distributio n key) is available from \begin_inset LatexCommand \htmlurl[ftp://atualizacoes.conectiva.com.br/6.0/images/mi-2.1.0u1-cl60.img.asc]{ftp://atualizacoes.conectiva.com.br/6.0/images/mi-2.1.0u1-cl60.img.asc} \end_inset \layout Subsection Phase One: Build a VMware Configuration \layout Itemize Start VMware (execute 'vmware' from the prompt). \layout Itemize Select the 'Run the Configuration Wizard.' dialog option and click on the 'OK' button to continue. \layout Itemize The 'VMware Configuration Wizard' dialog will appear. \layout Itemize Click on the 'Next' button to continue. \layout Itemize Select the 'Linux' dialog option and click on the 'Next' button to continue. \layout Itemize Enter the desired path for where you wish to store your VMware configuration and virtual disk file for this session. Click on the 'Next' button to continue. \layout Itemize Ensure that the 'New virtual disk' setting has been selected and click on the 'Next' button to continue. \layout Itemize Set the desired size for the virtual disk (what the VMware session will see as its hard disk). For a 'full' install of Conectiva Linux 6, a minimum of 3000 megabytes is recommended. For a 'default' install of Conectiva Linux 6, a minimum of 1500 megabytes is recommended. Once you have set your desired value for the virtual disk size, click on the 'Next' button to continue. \layout Itemize Ensure that 'CD-ROM enabled' and 'Start with the CD-ROM connected' are selected. Click on the 'Next' button to continue. \layout Itemize Ensure that the 'Floppy enabled' and 'Start with the floppy connected' are selected. Click on the 'Next' button to continue. \layout Itemize Select 'Host-only networking' and click on the 'Next' button to continue. \layout Itemize Review the settings you have selected. Click on the 'Done' button to complete the generation of your new VMware session configuration. \layout Subsection Phase Two: Install Conectiva Linux 6 \layout Itemize Place the Conectiva Linux 6, disc 1 CD-ROM in your CD-ROM drive. \layout Itemize Power on the VMware session. \layout Itemize Conectiva Linux 6 will begin to boot from CD. \layout Itemize At the installation menu, highlight \begin_inset Quotes eld \end_inset Conectiva Linux 6.0 Desktop Edition (Text Interface) \begin_inset Quotes erd \end_inset . The graphical (VGA and VESA graphics) installers for Conectiva Linux 6.0 will not work under VMware; the X server will generate a Signal 11 error during start up, so you must use the text-based installer. \layout Itemize Press 'e' to edit this configuration. Modifying this configuration will allow us to tell the installer that we have an updates disk; it will prompt us for this disk later. Note that you will not need to write the disk image to floppy; simply have the disk image on your hard drive in a place accessible by the user who is executing VMware. \layout Itemize With the \begin_inset Quotes eld \end_inset kernel= \begin_inset Quotes erd \end_inset ... line highlighted, press 'e' to edit this line. \layout Itemize Add \begin_inset Quotes eld \end_inset updates \begin_inset Quotes erd \end_inset to the end of this line (make sure there is a space between the word \begin_inset Quotes eld \end_inset updates \begin_inset Quotes erd \end_inset and the previous words on the line). Press enter to complete this change. \layout Itemize Press 'b' to boot this modified configuration. \layout Itemize You will be prompted to \begin_inset Quotes eld \end_inset Insert your updates disk and press 'OK' to continue. \begin_inset Quotes erd \end_inset \layout Itemize Press Control + Alt + Escape to return keyboard/mouse control to the host. \layout Itemize Select 'Devices' -> 'floppy0' -> 'Disconnect and edit' from the VMware menu bar. \layout Itemize Change the floppy drive type from 'Device' to 'File'. Change the path from '/dev/fd0' to point at the full path to the diskette image you downloaded. i.e. /home/username/mi-2.1.0u1-cl60.img \layout Itemize Click on the 'OK' button. \layout Itemize Select 'Devices' -> 'floppy0' -> 'Connect' from the VMware menu bar. \layout Itemize Click on the VMware window to return control to the guest operating system. \layout Itemize Press \begin_inset Quotes eld \end_inset Ok \begin_inset Quotes erd \end_inset to continue. Installer updates will be loaded from the diskette image and the install will continue. \layout Itemize When prompted for \begin_inset Quotes eld \end_inset Interface Selection \begin_inset Quotes erd \end_inset , select the \begin_inset Quotes eld \end_inset NEWT Frontend \begin_inset Quotes erd \end_inset and select \begin_inset Quotes eld \end_inset Ok \begin_inset Quotes erd \end_inset . \layout Itemize We will now discontinue use of the updates floppy image, so the correct hardware settings will be detected. Press Control + Alt + Escape to return keyboard/mouse control to the host. Select 'Devices' -> 'floppy0' -> 'Disconnect and edit' from the VMware menu bar. Change the floppy drive type back to 'Device' and set the path field to '/dev/fd0'. Click on the 'OK' button. Select 'Devices' -> 'floppy0' -> 'Connect' from the VMware menu bar. Click on the VMware window to return control to the guest operating system. \layout Itemize Select your desired language to use during the install. (I chose English.) \layout Itemize The modular installer will detect a \begin_inset Quotes eld \end_inset Microsoft IntelliMouse (PS/2) \begin_inset Quotes erd \end_inset mouse. Press the \begin_inset Quotes eld \end_inset Ok \begin_inset Quotes erd \end_inset button, then the \begin_inset Quotes eld \end_inset Next \begin_inset Quotes erd \end_inset button. \layout Itemize Select an appropriate keyboard layout. (I selected \begin_inset Quotes eld \end_inset Generic US keyboard \begin_inset Quotes erd \end_inset .) Press the \begin_inset Quotes eld \end_inset Next \begin_inset Quotes erd \end_inset button to continue. \layout Itemize Kernel modules will load. \layout Itemize The message, \begin_inset Quotes eld \end_inset Unable to open /dev/hda - unrecognized disk label. \begin_inset Quotes erd \end_inset will appear. Press the \begin_inset Quotes eld \end_inset Cancel \begin_inset Quotes erd \end_inset button. \layout Itemize The message, \begin_inset Quotes eld \end_inset Cannot probe the partition table in your disk /dev/hda. Do you want to create a NEW partition table on this disk? \begin_inset Quotes erd \end_inset will appear. Press the \begin_inset Quotes eld \end_inset Yes \begin_inset Quotes erd \end_inset button. \layout Itemize Select your desired install type; continue and manually partition the disk if needed (this is generally not necessary, since the Conectiva Linux 6.0 default partition handling does work correctly). If you are asked to manually partition the disk, I recommend you set aside approximately 100 MB in a linux-swap partition. \layout Itemize Packages will be installed based on your selected install type. (A 'Default install' contains roughly 450MB of files and package installation takes about 15 minutes on a dual Pentium II 350 under VMware; performance will vary based on hardware and software load.) \layout Itemize Select 'Configure network through DHCP'. \layout Itemize When prompted regarding your video card, \begin_inset Quotes eld \end_inset Use manual settings \begin_inset Quotes erd \end_inset and select \begin_inset Quotes eld \end_inset Generic VGA \begin_inset Quotes erd \end_inset ("vga" server) and continue. We will override this setting during the final phase of our installation. \layout Itemize When prompted regarding your monitor, select \begin_inset Quotes eld \end_inset Generic Extended SVGA \begin_inset Quotes erd \end_inset and continue. We will override this setting during the final phase of our installation. \layout Itemize Enter the desired password for the root account. \layout Itemize Select LILO or GRUB as your boot loader; install to MBR (Master Boot Record). \layout Itemize Create a boot floppy, if desired. \layout Itemize Complete the installation process. Continue to phase three of these instructions when the installation is complete, before rebooting. \layout Subsection Phase Three: Complete Installation \layout Itemize The system will start to reboot after the installation completes. Presuming you have not modified the VMware configuration or BIOS setup, there is no need to eject the Conectiva Linux CD (the BIOS is set to boot from hard disk before CD-ROM). \layout Itemize If you selected LILO as your boot loader, follow this line; if you selected GRUB, skip this line. When the LILO \begin_inset Quotes eld \end_inset boot: \begin_inset Quotes eld \end_inset prompt appears, press tab. At the \begin_inset Quotes eld \end_inset boot: \begin_inset Quotes eld \end_inset prompt, enter: \layout Code linux single \layout Itemize If you selected GRUB as your boot loader, follow this line; if you selected LILO, skip this line. When the GRUB menu appears, highlight \begin_inset Quotes eld \end_inset Conectiva Linux 6.0 \begin_inset Quotes erd \end_inset and press 'e' to edit this option. Press 'e' again to edit the \begin_inset Quotes eld \end_inset kernel= \begin_inset Quotes erd \end_inset ... line of this configuration. Add the word \begin_inset Quotes eld \end_inset single \begin_inset Quotes erd \end_inset to the end of this line and press enter; make sure there is a space between \begin_inset Quotes eld \end_inset single \begin_inset Quotes erd \end_inset and the previous word on this line. Press 'b' to boot this new configuration. \layout Itemize The system will boot up in to single user (maintenance) mode. \layout Itemize Once the system has finished booting and you are presented with a prompt ( \begin_inset Quotes eld \end_inset # \begin_inset Quotes erd \end_inset ), press Control + Alt + Escape to return keyboard/mouse control to the host. \layout Itemize Select 'Settings' -> 'VMware Tools Install' from the VMware menu bar. The VMware tools suite includes a management application that allows you to tweak the settings on a running VMware session, and an enhanced X server customized for use with VMware. \layout Itemize When prompted as to whether you want to read the VMware tools documentation, select 'No' (unless you have a live net connection and wish to read the official instructions). \layout Itemize Click on the VMware console session to return control to the virtual machine. \layout Itemize At the \begin_inset Quotes eld \end_inset # \begin_inset Quotes erd \end_inset prompt, enter the following commands: \layout Code mount /dev/fd0 /mnt/floppy \layout Code cd /tmp \layout Code tar -xzf /mnt/floppy/vmware-linux-tools.tar.gz \layout Code cd vmware-linux-tools \layout Code rm /dev/mouse \layout Itemize The /dev/mouse symlink will be regenerated during the install process. \layout Itemize At the \begin_inset Quotes eld \end_inset # \begin_inset Quotes erd \end_inset prompt, enter the following command to start the tools install: \layout Code ./install.pl caldera \layout Itemize The Conectiva Linux X-Windows file layout most matches that of Caldera, from the list of those supported by VMware. Press enter when prompted as to whether or not you wish to continue the installation. \layout Itemize After successful completion of the install, your normal floppy resource will automatically be restored. (If the install fails, you may disable the VMware Tools \begin_inset Quotes eld \end_inset diskette \begin_inset Quotes erd \end_inset by first unmounting the floppy ( \begin_inset Quotes eld \end_inset umount /mnt/floppy \begin_inset Quotes erd \end_inset ), then by using the 'Settings' -> 'Cancel VMware Tools Install' option on the VMware menu bar.) \layout Itemize If you wish to have X start automatically during system startup, edit /etc/initt ab and modify the following line: \layout Code id:3:initdefault: \layout Standard to read: \layout Code id:5:initdefault: \layout Itemize At the \begin_inset Quotes eld \end_inset # \begin_inset Quotes erd \end_inset prompt, enter the following commands: \layout Code cd /tmp \layout Code rm -Rf vmware-linux-tools/ \layout Code sync \layout Code reboot \layout Itemize Your installation of Conectiva Linux 6 is now complete; X should start correctly during the following system start-up (if you made the change to your /etc/initt ab file). You may wish to add 'vmware-toolbox' to the menus or desktop of your selected desktop environment or window manager. \layout Section Obtaining Support \layout Subsection Conectiva Linux \layout Standard Information regarding support of the Conectiva Linux distribution, as provided by Conectiva, may be found on the Conectiva web site. At time of this writing, Conectiva provides support with the purchase of a Conectiva Linux boxed set; please see the Conectiva web site for additional, up-to-date details. The Conectiva web site is provided in several languages; the English language support page may be found at: \begin_inset LatexCommand \htmlurl[http://en.conectiva.com/support]{http://en.conectiva.com/support} \end_inset \layout Standard Bugs found in the Conectiva Linux distribution may be reported using \begin_inset LatexCommand \htmlurl[Conectiva's Bugzilla]{http://distro.conectiva.com.br/bugzilla/} \end_inset . \layout Subsection VMware \layout Standard Information regarding support of VMware is available from the VMware support page, found at: \begin_inset LatexCommand \htmlurl[http://www.vmware.com/support/]{http://www.vmware.com/support/} \end_inset \layout Standard Bugs found in VMware may be reported using the \begin_inset Quotes eld \end_inset File an Incident \begin_inset Quotes erd \end_inset link on the VMware support page (mentioned previously). \layout Subsection Reporting Bugs in This Document \layout Standard Bugs (such as spelling errors, or errors of a technical nature) found in this document should be reported to the current maintainer of this document, Jacob Moorman. He may be reached at \begin_inset LatexCommand \htmlurl[roguemtl@marblehorse.org]{mailto:roguemtl@marblehorse.org} \end_inset \layout Standard The most recent official release of this document should always be available from the Documentation page on the \begin_inset LatexCommand \htmlurl[Marble Horse Free Software Group website]{http://www.marblehorse.org} \end_inset . This is the 10 January, 2001 release of this document. Please note that the author is unable to accept Portuguese language nor Spanish language e-mails; English language e-mail is preferred. \the_end