Table of Contents ================= Introduction Machine List Partitioning your Hard Disk Basic partitioning information Estimating space requirements Partitioning your disk(s) Repartitioning Existing Disks Partition Types and Names Drive Setup Apple HD SC Setup pdisk Installing the Mac OS-side files Once you are in the MkLinux Installer Getting started with MkLinux Logging in as root Creating a user account Mounting the CD Installing a package Removing a package Where to go next Books Online Thanks Last words Introduction ============ Welcome to MkLinux Developer Release 3! MkLinux, as you probably realize, is Apple Computer's Mach 3-based version of the GNU/Linux operating system. Versions of MkLinux run on the Intel, PA-RISC, and PowerPC architectures. This disc contains the version of MkLinux which runs on PowerPC-based Apple Power Macintosh and related systems. With DR3, MkLinux binary executables are compatible with the other PowerPC Linux systems (e.g., LinuxPPC). In addition, MkLinux file systems are byte- order compatible with other (e.g., Intel-based) Linux file systems. Also, MkLinux DR3 supports dynamic shared libraries, for greatly reduced disk and RAM storage and faster program loading. Developer Release 3 has been a long time (over a year!) in development. It supports many more machines since the last release (DR2.1) and offers much more flexibility in terms of installation options. As a result of this flexibility, the installation process has become rather more complex. We have tried to retain as much simplicity as possible, however! If, after reading these notes carefully, you still have trouble getting MkLinux to run, please make use of the wide variety of user-contributed support resources. Specifically, you should start with the "Frequently Asked Questions" (FAQ) on Apple's MkLinux web page (www.mklinux.apple.com). If the FAQ does not help you, please use the MkLinux mailing lists. The "mklinux-setup" list is probably most appropriate for problems you might encounter while installing MkLinux DR3. Submit your question (in detailed form) to the mklinux-setup email list (the MkLinux web site has links to a sign-on form). The members on the setup list are very helpful and knowledgeable about a wide range of machines. Please do not contact directly Apple Computer's MkLinux team or Prime Time Freeware for support on MkLinux. Put simply, neither organization has the resources to help you. You will get better results with the FAQ and mailing lists. Machine List ============ MkLinux DR3 will run on the following PowerPC-based Macintoshes: Power Macintosh 6100 Power Macintosh 9500 Performa 61xx Power Macintosh 9500/180MP Workgroup Server 6150 Power Macintosh 9515 Power Macintosh 7100 Power Macintosh 9600 Power Macintosh 8100 Power Macintosh 9600/200MP Power Macintosh 8115 Workgroup Server 9650 Workgroup Server 8150 Workgroup Server 9150 Power Macintosh 4400 Power Macintosh 5400 Power Macintosh 7200 Performa 54xx Power Macintosh 7215 Power Macintosh 5500 Power Macintosh 7220 Performa 6360 Workgroup Server 7250 Power Macintosh 6400 Power Macintosh 7300 Performa 64xx Workgroup Server 7350 Power Macintosh 6500 Power Macintosh 7500 20th Anniversary Macintosh Power Macintosh 7600 Power Macintosh 8200 PowerBook 3400 Power Macintosh 8500 Power Macintosh G3 Desktop Power Macintosh 8515 Power Macintosh G3 Minitower Workgroup Server 8550 PowerBook G3 Power Macintosh 8600 Notes: Some of the high-end Power Macintoshes and Workgroup Servers use a PCI-based SCSI adapter to access Fast-Wide or Ultra-Wide SCSI devices. At this time, MkLinux cannot access SCSI devices attached via PCI adapters. In order to use MkLinux DR3 on these machines, you will need to attach a separate SCSI disk to the Macintosh's onboard or external SCSI connector. MkLinux has some difficulty accessing various IDE drives that have been shipped on some Macintosh systems. MkLinux will not recognize these drives; thus, the MkLinux installer will not report them in its drive list. As an alternative, you can install MkLinux DR3 onto an external SCSI drive. Check the Frequently Asked Questions on www.mklinux.apple.com for current information, patches, workarounds, etc. MkLinux DR3 will run on many of the Macintosh clones. If you have one of these machines, your best bet is to try the installation process and see how things go. If you have problems, send a note to the mklinux-setup list. Partitioning your Hard Disk =========================== Partitioning your disk is probably the most difficult step in getting MkLinux installed onto your Macintosh. If you are already familiar with partitioning disks on Macintosh systems, you should at least skim this section and proceed with your own partitioning method. Unfortunately, there is no simple partitioning recipe that will work for every situation. Practically every MkLinux installation is unique; each may require different tools and methods to accomplish. The best we can do is to provide you with information about partitioning tools and MkLinux's requirements, then let you determine which method best serves your needs. If you are new to disk partitioning concepts, or partitioning disks on Macintoshes, then you will want to pay close attention to this section. Even if you are completely unfamiliar with disk partitioning concepts, we feel that if you read this section carefully, you _will_ be able to get through the partitioning task. Don't give up, it's really not that difficult. Also, you may want to make use of the helpful people who read and post to the mklinux-setup mailing list. Basic partitioning information ------------------------------ Most of the disk space that MkLinux needs in order to operate does not reside in regular Mac OS volumes. Instead, MkLinux has its own filesystems, which must reside in separate disk partitions. MkLinux uses two distinct types of disk partitions. It uses "swap" space to store idle portions of the memory used by running programs. It uses "filesystem" space to store directories (i.e., folders) and files. The amount of swap space MkLinux needs depends on what sorts of tasks the machine will be doing and how much physical RAM you have installed. The swap space is combined with the physical RAM in the system to produce the total amount of virtual memory available for all running programs. The minimum amount of swap space that the MkLinux DR3 install process will allow is 8 MB. Typically, 64 MB of swap space is just fine. If you have very little RAM or expect to be running many users or programs at once, you may want to provide more swap space. Please keep in mind that the maximum usable size of a MkLinux swap partition is 128 MB. You are free, however, to have more than one swap partition. The MkLinux filesystem has (like Mac OS) a hierarchical directory structure: files may exist at any level of the directory hierarchy. Unlike Mac OS, however, MkLinux can graft whole filesystem trees (residing in separate partitions) onto the main ("root") filesystem. This grafting ability, modelled after UNIX, is called "mounting" a filesystem. The directory under which the mounted filesystem appears is called a "mount point". By carefully choosing the sizes of your filesystem partitions and their mount points, you can create a unified filesystem tree with branches existing in separate partitions or even separate disk drives. MkLinux filesystem partitions are limited, at present, to a maximum of two GB each. Therefore, if you want to have an overall MkLinux filesystem that will hold more than 2 GB, you'll need to use multiple partitions. How you envision using your MkLinux system will help determine where you might consider mounting extra filesystems. For example, if you expect that you will be loading many extra programs (or packages) after your initial MkLinux install, you might want to dedicate a whole partition to the "/usr" portion of your filesystem. If you expect to have several users, you may want to let "/home" (and its subdirectories) reside in its own partition. If you expect a large amount of email or Usenet news to flow through the system, consider giving "/var" its own partition. Finally, if you're not sure how your system will be used, or which areas of the filesystem might need their own partition, you can simply put the whole MkLinux filesystem into one partition. The 2 GB rule mentioned above still applies, but a single partition filesystem is all you need to get started. Estimating space requirements ----------------------------- The MkLinux DR3 CD contains 420 packages that can be installed initially and 233 "extra" packages which can be installed later, as desired. The initial installation process provides quite a bit of flexibility in choosing which of the initial 420 packages to install. Follow-on installation is even more flexible, allowing any desired package(s) to be installed. It would be ridiculous for us to list the disk space requirements of every combination allowed by the initial installation. So, we will provide the space requirements for three typical MkLinux installations. The MkLinux installer has a page where you choose several broad categories of packages to be installed. The install configuration called "Absolute Minimum" unchecks (de-selects) every option on the selection page. "Default Selections" makes no changes on the selections page. "Everything" installs all 420 packages. partition "Absolute Minimum" "Default Selections" "Everything" ------------------------------------------------------------------------- / 15 15 16 /opt 0 33 47 /usr 41 136 398 /var 2 4 10 /home 0 0 3 ------------------------------------------------------------------------- totals 58 188 474 All values are in Megabytes (where 1 Megabyte = 1024*1024 bytes). Given the five partitions shown above, the table shows the space usage in the partition after each of the three separate installations. It is not necessary for you to create all five of these MkLinux filesystem partitions. In fact, the "/opt" partition is not found on most Linux installations. In general, you will want to have fewer partitions in your installation than the five shown above. As you eliminate partitions, incorporate their space into that of the root partition (labelled "/" in the table). To help you get started, we will walk through two common examples. An "Everything" installation, using the three partitions "/", "/usr", and "/home", will require at least 73 MB for "/", 398 MB for "/usr", and 3 MB for "/home". A "Default Selections" installation, with a single filesystem partition, will require at least 188 MB in that ("/") partition. Of course, you will want to leave some extra space in your filesystems so that you can actually use your MkLinux system without running out of space on the first day! If you will be installing some of the 233 "extra" packages on the CD, then you should increase the amount available in "/usr", as most of those packages install files somewhere under the "/usr" directory. If you want to add several user accounts to your system so that your friends can log in, you will want to have plenty of space available for "/home" to grow. "/home" is also the default location of any "anonymous FTP" space or web pages that you may want to host on your MkLinux system. If you expect your MkLinux system to be handling lots of email or Usenet news, ensure that the "/var" directory has plenty of room to grow. Hopefully, you now have some idea of what partitions you will want for MkLinux. The next step is to actually make these MkLinux partitions. Partitioning your disk(s) ------------------------- There are three partitioning programs included on this CD. Each has its strengths and weaknesses when applied to the task of partitioning your disk for MkLinux. These differences are discussed below. However, before we begin, it is important that you understand some of the basic concepts of disk partitioning on Macintosh systems. Whether you realize it or not, your system disk is already partitioned. Most of the space on your disk is probably allocated to one partition that contains a large Mac OS volume. There are several smaller partitions, however, which hold other bits of information: * There is exactly one "Partition Map" partition which holds the partitioning information itself. * There is probably at least one "Driver Partition" which enables Mac OS to access the Mac OS volumes on the disk. * There may be a "Patch Partition" which has been used to store patches to the Mac OS operating system. * Finally, any "free" space must be accounted for in other partitions. Partitions are contiguous areas on your disk. Filesystems are data structures that exist inside partitions. Mac OS Standard (also known as HFS) and Mac OS Extended (also known as HFS+) volumes are two types of filesystems that may exist in partitions. If you open a volume on your desktop and see something like "353.3 MB in disk 844.7 MB available", the 844.7 MB is unused space _inside_ that Mac OS filesystem. The message does NOT refer to free partition space. To find out if you have free partition space on your disk, you will need to use a tool (such as a partitioner) that looks at the actual partition map. Repartitioning Existing Disks ----------------------------- Although (for safety!) we recommend the use of a separate disk for MkLinux, this is not absolutely necessary. It is possible to repartition your existing disk, shrink the Mac OS portion, and install MkLinux in the remaining space. In most instances, however, shrinking your existing Mac OS volume (and the surrounding partition) will require that the Mac OS volume be reinitialized, destroying everything you may have in the volume. Obviously, you would want to back up all your important files before destroying your existing volume! It is possible to shrink a Mac OS volume (and the partition that contains it) while keeping the data intact. The tools supplied in this MkLinux distribution cannot perform this task. However, the task can be accomplished with at least one third-party disk partitioning program (FWB's Hard Disk Toolkit). If this is an approach you would like to take, you will need to obtain HDT and use it to make free partition space. You may use either HDT or the tools supplied on this CD to add the desired MkLinux partitions. Partition Types and Names ------------------------- Every Macintosh partition has a "type" and a "name". Both of these pieces of information are simple strings. Usually, the name of a partition can be anything you want. However, there are several important types that you should know about, including: Apple_partition_map partition map Apple_Driver43 disk drivers Apple_Patches Mac OS patches Apple_HFS Mac OS volumes Apple_UNIX_SVR2 MkLinux partitions Both standard (HFS) and extended (HFS+) Mac OS volumes are usually contained in partitions with the "Apple_HFS" type. The name of an Apple_HFS partition may not be the same as the name of the Mac OS volume that it contains. The names of the MkLinux filesystem partitions are ignored, so it's handy to name them for their intended purpose (e.g., root, home, usr, var, tmp, etc.). The MkLinux installer assigns partitions named "swap" for use as swap space. This disc contains three partitioning programs, with varying capabilities: Drive Setup standard Mac OS utility; partitions Apple drives (both IDE and SCSI); doesn't make A/UX (MkLinux) partitions Apple HD SC Setup older Mac OS utility; partitions any SCSI drive; makes A/UX partitions pdisk Mac OS/Mklinux utility; makes A/UX partitions Drive Setup ----------- Drive Setup is the standard partitioning utility that is shipped with Mac OS. It can create multiple MacOS partitions on your drive, leave free partition space (e.g., for use by pdisk), deposit the latest Apple disk drivers onto the disk, and create actual Mac OS standard and extended volumes in created partititions. It can partition (Apple-branded) SCSI and IDE drives. Drive Setup cannot create the A/UX-style partitions used by MkLinux. One common method is to use Drive Setup to create free partition space on your drive, then use pdisk to create MkLinux partitions in the free space. An alternative is to have Drive Setup create extra Mac OS partitions, then use pdisk to change them to MkLinux partitions before use. Apple HD SC Setup ----------------- Apple HD SC Setup is an older partitioner from Apple that still comes in handy occasionally. HD SC Setup originated in an era when Apple used SCSI drives exclusively. Therefore it will not recognize your IDE drives. It can, however, make A/UX partitions, as used by MkLinux. By default, HD SC Setup will work on Apple drives only, but it can be patched (AT YOUR OWN RISK) to accept other drives: Copy Apple HD SC Setup 7.3.5 from the CD to a writable Mac OS drive. Change the one byte in the "wfwr" ID 67 resource from "00" to "FF". For more information, see www.euronet.nl/users/ernstoud/patch.html pdisk ----- The pdisk partitioner was adapted from a Linux partitioner. Pdisk can do practically anything to your partition table. It runs on Apple-sanctioned as well as non-Apple drives. Pdisk can even modify the partition table of the disk that you're currently running from. However, pdisk has some problems. The main problem is that pdisk is not a typical Mac OS application. It has a command-line interface that can be intimidating to many. Another disadvantage is that it does not do anything to areas of the disk other than the partition map. Consequently it cannot install a driver onto your disk, nor can it create HFS or HFS+ volumes. (However, it is important to note that it is not necessary to have a driver partition on a disk that doesn't have an HFS partition.) Pdisk has two variants. One is a program that runs under Mac OS. The other is a MkLinux program that is available to you when the MkLinux installer is running. The Mac OS version uses Mac OS facilities to access the disks; the MkLinux version uses MkLinux's facilities. However, the "engine" in pdisk is the same between the two versions. So, once you learn to use one, you will know how to use the other. Even though it can be intimidating at first, we recommend that you learn enough of pdisk to at least display the partition table on a disk. A good reference on how to use pdisk is located in the "pdisk.html" file in the "MacOS Utilities" folder on this disc. Just point your favorite browser to the pdisk.html file. Of all the partitioners mentioned, pdisk is the best one to show your disk's true partition layout. Installing the Mac OS-side files ================================ There are five files in the "Mac Files" folder. Copy the two files "MkLinux Booter" and "Mach Kernel" to your Extensions folder. Copy the control panel "MkLinux" to your Control Panels folder. Copy the two files "lilo.conf" and "MkLinux.prefs" to your Preferences folder. The initial boot of MkLinux just runs the installer. Currently, things are set to install from a SCSI CD-ROM drive. If your machine has a SCSI CD-ROM drive, you will not need to change anything. Skip ahead a few paragraphs to where you "Restart your Macintosh". If your machine has an ATAPI CD-ROM, then you will need to change a setting. If you have one of the following machines, you probably have an ATAPI CD-ROM drive: Power Macintosh 4400 Any "Tanzania" based clone PowerBook 3400 PowerBook G3 Power Macintosh G3 To determine whether your machine has an ATAPI CD-ROM drive, insert a disc into your drive, click once on the disc's desktop icon, and run "Get Info" (from the File menu). If the "Where:" line ends in "(ATAPI ..)", you have an ATAPI CD-ROM drive and you will need to change the rootdev setting. To change MkLinux so that it will retrieve the installer from an ATAPI CD-ROM drive, launch the "MkLinux" control panel and select "Custom...". SimpleText will be launched to edit your "lilo.conf" file. Change your rootdev according to the instructions in the lilo.conf file. (Basically, you will change a line so that it reads: "rootdev=/dev/hdc"). Restart your Macintosh. Upon reboot, you should see the MkLinux "splash screen". It is set to default boot into Mac OS. Click on the "MkLinux" button, and the MkLinux installer should run. Once you are in the MkLinux Installer ===================================== The MkLinux installer is adapted from the well-known "Red Hat Linux" installer, originally written by Red Hat Software. The installer was ported to MkLinux with the intent of making as few changes as possible. Therefore, you will probably notice that there are still many references to "Red Hat Linux". Also, there are some concepts presented that are appropriate for other Linux installations, but inappropriate for MkLinux. Don't worry; with some basic instruction, you will be able to use the installer to get your MkLinux system installed with the desired collection of packages. When you get to the first page of the installer, you should see a blue back- ground and a white text window with black characters. If you don't get these colors, you may want to reboot into Mac OS and use the "Monitors and Sound" control panel to choose a 256-color scheme. The following keys will help you navigate while using the installer: Tab Move to the next field Return Select the current highlighted choice Up/Down Arrow Move up/down in a list of items Space Check or Uncheck the selected list item Below is a step-by-step description of the various installation screens. "Welcome to MkLinux" Screen Simply press Return to continue to the next screen. "Keyboard Type" Screen Select a keyboard type. This controls the keyboard mapping. Not all the listed keyboard mappings work properly. If you find this is the case for your selection, start over and select "us" as your keyboard type. You should be able to continue through the installation. "Installation Method" Screen Since the packages to be installed reside on the CD, choose "Local CD-ROM". "Installation Path" Screen Choose "Install". The other option, "Upgrade", is intended to add packages to an already installed Red Hat system, and is not supported in this release. "Partition Disks" Screen The installer will show you a list of disks on your system that MkLinux has recognized. If you select one and choose "Edit", you will be able to view and optionally change that disk's partition map using the MkLinux version of pdisk. When you have finished viewing/editing the partition maps on various disks, choose "Done". (Don't confuse this screen with the upcoming "Partition Disk" screen.) "Select Root Partition" Screen The installer will list every partition that is appropriate for an MkLinux filesystem. Pick one to use for your "root" partition. Only partitions of type "Apple_UNIX_SVR2" are shown. Also, any partitions you designated as swap partitions (by putting the word "swap" in the name) will not be shown. "Partition Disk" Screen This page will list the other partitions that are available to be mounted. Use the arrow keys to highlight a particular partition, then press Return. A follow-on dialog will tell the installer where you would like to have the filesystem in that partition mounted. You may also use this page to mount your Mac OS Standard (HFS) volumes. Please note, however, that the HFS volumes will be mounted read-only. Any MkLinux partitions you designated as swap partitions (by putting the word "swap" in the name) will not be shown. (Don't confuse this screen with the previous "Partition Disks" screen.) "Active Swap Space" Screen The installer will give you a list of every partition that is suitable to be a MkLinux swap partition. Remember, use the Space bar to set/unset which partitions you want to use for swap. "Find installation files" Screen This isn't a real screen. However, you may notice a significant pause here. Be patient; if you have a relatively slow CD-ROM drive, you may need to wait a few minutes. "Format Partitions" Screen The installer will give you a list of partitions. You will need to use the arrow keys and space bar to select which partitions to format. If you have never used MkLinux in these partitions, you must reformat all of them. If you have used MkLinux DR2.1 (or an earlier version), we suggest that you reformat _all_ your MkLinux partitions. If you have used MkLinux "pre-DR3", we suggest that you format at least the system partitions, such as / (the root partition), /usr, or /var. "Components to Install" Screen At this point, the installer will present you with a list of selected collections of packages. Use the Space bar to select the ones that seem appropriate for your installation. At the very end of the list, there is an item labelled "Everything". Selecting "Everything" will install every package (all 420 of them!) available in the main package set, even those not represented in the other groups. There is also a box that you can check labelled "Select individual packages". If this box is checked when you leave this screen, you will go to a set of screens where you can select the packages individually. "Install log" Screen This is just an informative message explaining that an installation log will be saved and will be viewable after the installation in the file "/tmp/install.log". "Install System" Screens At this point, the installer will proceed to create the filesystems in your MkLinux partitions, then install the packages that you selected. A progress bar will be displayed, along with estimates of how much time it will take to complete installing the packages. There are a few packages that write to the installer screen, making the display somewhat messy. You may safely ignore these messages. "Configure Mouse" Screen Choose ADB Mouse. Note: the "emulate three buttons" option is not applicable in MkLinux at this time. "Network Configuration" Screen If your MkLinux system is connected to a TCP/IP-based Local Area Network, and you want to configure your system to operate on this network at this time, choose "Yes". The installer will bring up two screens, the first is the "Configure TCP/IP" screen. You will need to know an IP address for your system, the Net Mask, a Default Gateway address, and a DNS nameserver address. If you don't know these values, you should ask your Network Administrator. Checking "Configure device with bootp" (with the Space bar) indicates that you want to query the network for a set of values appropriate for your machine. The "Configure Network" screen allows you to enter your domain name and host name. Also, if you have any alternate nameservers, you should enter them here. "Configure Timezones" Screen This is the place to set your local timezone. Use the up and down arrow keys to select the correct timezone from the list. You should always check the "Hardware clock set to GMT" box if you want MkLinux to read your Mac OS clock correctly. Don't worry; this will not affect your Mac OS clock in any way. "Services" Screen The installer will present a list of the services that can be started automatically when your MkLinux system boots. If you are not familiar with which services you want and which ones you don't want, it is safe to simply leave the checkboxes unchanged. "Configure Printer" Screen If you choose "Yes" on this screen, the installer will present you with a few more screens asking fairly straight-forward questions about your printer. Please note that, at this time, you cannot set up an AppleTalk printer using this mechanism. "Root Password" Screen You must pick a password for the "root" account. Remember this password, because the "root" account will be the first thing you need once the MkLinux installation is complete. Note that when you type the password, the characters do not appear. "Info" Screen Be sure to remember or write down the "rootdev" value that the installer tells you on this screen. You will need it in a few steps. "Done" Screen When you press ok, the system will reboot. You will need to go into Mac OS at least one more time to change the rootdev setting (mentioned in the previous screen). When the system reboots, the MkLinux "Splash Screen" will appear again. Select "Mac OS". Once Mac OS has booted, invoke the MkLinux Control Panel. Press the "Custom..." button in the control panel. The SimpleText editor will be launched and you will be editing the "lilo.conf" file. Change the line that contains "rootdev=/dev/XXXX" to the value that the installer gave you. Save the file and quit. This is a good time to choose your "Startup Selection". Click the button next to either Mac OS or MkLinux. (This sets the default choice at the MkLinux Splash Screen. At the splash screen, you can always override the default choice.) Close the MkLinux Control Panel and restart your Macintosh. Choose MkLinux. (If MkLinux is the default OS, you may simply choose to wait 10 seconds.) MkLinux should now boot, placing you at the "login prompt". Getting started with MkLinux ============================ Now that you have Mklinux installed, you'll want to start using it to do useful and fun things. It is not possible for us to describe here everything that you can do with MkLinux. For more assistance with using MkLinux (or practically any Linux system), please see the references below. For now, here are a few simple things that you can do with MkLinux to get started. Logging in as root ------------------ At the "login:" prompt, type "root" then return and enter root's password at the password prompt. (Root's password is the one you chose during the installation process.) In general, you should use the root account to do system administration only. For instance, you would want to use the root account to add packages, remove packages, configure your networking, and in some cases shut the system down. For day-to-day operation of your MkLinux system, you should create and use a user account for yourself. Creating a user account ----------------------- Log in as root and use the "adduser" command. For instance, if you want to create an account for Joe, you would issue the command: adduser joe This will create an account for joe, along with an associated home directory "/home/joe". Joe's account will need to have an initial password. Still as root, issue the following command: passwd joe You will be prompted to enter an initial password for Joe's account. Mounting the CD --------------- If you want to add some packages or access files from the MkLinux DR3 CD, you will first need to "mount" the CD. While logged in as root, issue the following command: mount -r -t iso9660 /dev/cdrom /mnt/cdrom The CD is now mounted and accessible in your filesystem directory tree under /mnt/cdrom. If you issue the commands: cd /mnt/cdrom ls You will see the contents of the top directory on the CD. Once you have finished accessing the files on the CD, you will need to "unmount" the CD before you can remove it from the CD-ROM drive. Issue the following commands (as root): cd # Change directory to be outside /mnt/cdrom umount /mnt/cdrom Installing a package -------------------- There are two separate directories on the MkLinux DR3 CD that contain packages that you can install. Assuming that you mounted the CD under /mnt/cdrom, the main packages directory will be here: /mnt/cdrom/RedHat/RPMS The extra packages will be here: /mnt/cdrom/extra/RPMS For example, if you want to install the "zsh" package, you should issue the following commands (as root): cd /mnt/cdrom/RedHat/RPMS # change directory to the packages dir rpm -ihv zsh-3.0.5-1b.ppc.rpm # install the zsh package A complete listing and description of the main packages is in the file: /mnt/cdrom/RedHat/rpmcontents.gz Similarly, there is a listing of the extra packages: /mnt/cdrom/extras/rpmcontents.gz These rpmcontents files are compressed text files. To view them, issue a command such as this: zless /mnt/cdrom/RedHat/rpmcontents.gz Removing a package ------------------ You can remove packages easily. For instance, if you had installed the "inn" package (The Internet News System) during the initial installation, and now you realize that you do not intend to run Usenet news service on your MkLinux system, then you might want to remove the inn package. As root, issue the command: rpm -e inn Starting the X Window System: You may start X, the graphics system popular with practically every Unix system, by issuing the command: startx Typically, you would run X from your regular user account. Where to go next ================ Books ----- MkLinux - Microkernel Linux for the Power Macintosh Prime Time Freeware (www.ptf.com) publishes book/CD collections of Open Source software. At the request of Apple Computer, PTF created a Reference Release for MkLinux. The release contains information on installing, using, and modifying the MkLinux system. Running Linux O'Reilly and Associates (www.oreilly.com) is a leading publisher of books on Unix-related topics. "Running Linux", although written with standard Linux in mind, is a very useful supplement for the MkLinux Reference Release. Online ------ www.mklinux.apple.com www.linux.org Thanks ====== This release of MkLinux would not have been possible without the efforts of many people. We are grateful to everyone who has used, tested, reported bugs, made suggestions, or even submitted fixes to earlier versions of MkLinux. There are so many people involved, it would be impossible to list them all. However, there are a few individuals who have made significant contributions recently that have been extremely beneficial in the production of MkLinux Developer Release 3: Mark Hatle (Mankato State University) ported the Red Hat Installer for use with MkLinux. In doing so, he had to fix portions of MkLinux so that the Installer would operate correctly. Mark has also assisted with the DR3 RPM package set. Jack Howarth (University of Cincinatti College of Medicine) helped tremendously with the DR3 RPM package set. From the earliest "pre-DR3" snapshot, hundreds of RPMs had to be updated, adjusted, or simply rebuilt. Jack's diligence in this area has made for an excellent package set. Brad Midgley (Pacific HiTech, Inc.) ported some HFS code to work properly in the Mach Bootstrap task. This is a key piece to getting the Red Hat installer running as the initial MkLinux installation is booted from an HFS filesystem. James Pearson (University College London) modified mkisofs, yielding the utility "mkhybrid". mkhybrid can create a CD-ROM image that has both ISO-9660 and Apple HFS filesystem structures. The MkLinux DR3 CD image was created with "mkhybrid". Gary Thomas (The Open Group, Research Institute) has contributed far too many things to list that are directly applicable to MkLinux DR3. And finally, we would like to thank the entire Linux/PPC team for their efforts in porting so many software packages. In most cases these packages run unmodified on both Linux/PPC and MkLinux systems. Last words =========== Be sure to check the MkLinux website: http://www.mklinux.apple.com/ for further information on current and future developments with MkLinux. On behalf of everyone involved in making MkLinux Developer Release 3 a reality, we hope you find that MkLinux is both fun and useful. The MkLinux Team Apple Computer July, 1998