Sorcerer Install Information and Examples

This page pertains to ONLY the May 17th 2002 ISO

This document contains examples on installations done by Kennith Wayne Mann III. Also included are pre and post install information from Kyle Sallee. This is a supplement to the other documents and faqs available at http://sorcerer.wox.org/docs

  1. What are the system requirements?
  2. I downloaded the bzip2ed ISO, now what?
  3. Installation Checklist
  4. Lilo said LIWrong Boot Loader
  5. Base system install example
  6. Post install procedures
  7. Keeping everything ship-shape
  8. Where do I go from here?
  9. XFree86 install example


  1. What are the system requirements?

    Requirements
    Minimum without XFree86 i586
    64MB RAM
    4 GB HD
    Recommended Athlon
    256MB
    2x30GB HD mirrored

  2. I downloaded the bzip2ed ISO, now what?
    After downloading the image execute bunzip2 sorcerer-$DATE.iso.bz2 Then, burn an installation/rescue CD.
    http://www.linuxdoc.org/HOWTO/CD-Writing-HOWTO.html
    Finally, boot using the CD and follow the menu driven installation.

  3. Installation Checklist
    1. Make a /boot partition before copying files.
    2. Compiled the kernel with the correct built in low level disk drivers.
    3. Configure networking.
    4. Ready to reboot, proceede to the Post Install FAQ.

  4. Lilo said LIWrong Boot Loader
    Did you install Sorcerer somewhere besides IDE-0 or /devices/discs/disc0/disc? To boot Sorcerer from fixed disk did you select a boot drive other than IDE-0 in the BIOS/CMOS configuration? When you rebooted BIOS swaps IDE-0 with the drive you said that you wanted to boot off, unless the first boot device selected is a floppy or CDROM. Lilo complains "Wrong Bootloader"sorcer/web/sorcerer.wox.org/docs/ when it looks at the device where it was installed and finds the other bootloader that is normally on IDE-0.

    f you install Sorcerer onto a spare drive, then the easiest way to load it is to chain to it using your primary lilo bootloader. In the following example we will assume that /devices/discs/disc0/disc is your primary Linux box, and /devices/discs/disc1/disc is where you installed Sorcerer. To boot Sorcerer add the following lines to the /etc/lilo.conf of your primary Linux on the first hard drive, and run lilo

    other=/devices/discs/disc1/part1
    label=Sorcerer
    restricted
    table=/devices/discs/disc1/disc


    Assuming you have a devfs file system mounted on /devices in your primary distro, run lilo. Then, on your next boot you will be able to chain from one lilo to the other.

    Lastly, the purpose of being able to change the default bootable IDE drive in BIOS/CMOS configuration is so you can recover from a crash instantaneously, if your primary hard drive is mirrored onto a secondary hard drive. Naturally, we all have a mirror of our primary hard drive. :)


  5. Base system install example

    Assumptions for Sorcerer: [Not XFree86]


    Installation:

    1. Insert CD into your cdrom drive
    2. Reboot system and allow the boot disc to engage
    3. A screen should come up. At the top left corner is the date that the ISO was released, below that is your kernel version. Press 'enter' here. It should then proceed to load some things.
    4. This screen allows you to load modules, shell out, and choose a root device. If you are starting clean, select 'D' or 'Continue Booting'. If you allready have Linux installed but cannot get a boot loader (such as LILO) to run, select 'R' or 'Choose root device'. Select the device that you installed on. If you installed on your main hard drive and on partition 1, then you would enter '/devices/discs/disc0/part1' and press 'enter'. It should then load up like normal. Further below is an explanation of LILO and how to edit/fix it.
    5. Now you'll get prompted to login, your login is "root" and an empty password. Next, start /usr/sbin/sorcerer.install.
    6. You can choose to change settings for Native Language Support, I won't. We'll go straight to partitioning the harddisk. Select B for partitioning.
    7. Hardcore Linux - Only the Linux OS will be on your system. Nothing else.
      1. Select 'disc0 disk'. Assuming that your main HD [Hard Drive] is the one that is going to have Linux on it. See footnote on HD's order for Primary/Secondary/Master/Slave 1
      2. Select 'f' or 'fdisk'. It will ask if you are certain if you want to do this, select 'Yes'.
      3. It should ask for a command "Command (m for help):". Select 'd'. Then, press '1' and press enter. Do this process again, but with the numer '2'. Keep on looping until it returns a warning saying "Warning: partition [x] has empty type". That means its empty. If you want you can continue through all of them. We at least need to have 2 partitions.
      4. Next we need to create your partitions. Select 'n' for "add a new partition".
      5. Select 'p' for primary partition. Select an open partition. Since we wiped out all of them, and since we need to make a 2SWAP Partition and we will want the SWAP partition to be on our second partition, let us select '2'.
      6. It will ask what cylider you would like to start it for that partition. If you press 'enter' then it will assume the first available cylinder. Press 'enter'.
      7. If you want 1GB of swap enter '+1G' and then press 'enter'. Change the type of the partition to Linux Swap by selecting 't' and '82'.
      8. Next we make your main partition. Press 'n' and select 'p', then '3'. It should ask where to start. Press 'enter' here, it should find its own spot.
      9. After that it needs to know where to stop. Since we are making this box hardcore Linux, we are going to max it out. Press 'enter' here, default should automaticaly max it out.
      10. We're also going to create a seperate /boot partition. Press 'n', 'p', '1' and give it a size of 50 Mb : +50M. Make it bootable by pressing 'a' and '1'.
      11. Ok, we are done partition. Lets write it and leave. Press 'w'. It should then do some work, and return to our menu.
      12. We need to mount our FS now. Select 'C' or 'Mount Filesystems'. It should ask if we are done with making our partitions. Hit 'enter', becuause we just did that.
      13. It needs to know what 3root partition we want. Hit 'enter' as that is your only choice.
      14. Select the HD you want to install to. For me it is 'disc0 disk'. Hit 'enter'.
      15. It wants to know which partition we want to run on. Partition 1 is our /boot, partition 2 is our SWAP partition and partition 3 is our main. Select 'part3 partition'. Hit 'enter'.
      16. This part is mostly your decision. This is the 4file system. I will use ext3.
      17. It will then ask you if you want to check your HD, I usually dont and that is also the default action. Hit 'enter'.
      18. It will next ask you to "mkfs -t ext2 -j /devices/discs/disc0/part3". The /disc0 may differ and /part3 may differ as well from your system. We want this, so hit 'enter'. Its gonna have some fun and tell you some things. Just hit 'enter' until you are taken back to the menu.
      19. We still need to mount our SWAP so the it knows its a swap. Select 'C' or 'Mount Filesystems'. Select the same disc as we did earlier and select 'part2 partition' or the partition you will use for your SWAP. This time select 'swap'. If you want you can check for errors, and then let it 'mkswap /devices/discs/disc0/part2' by hitting 'enter'. Let it have its fun and hit 'enter' once to get back to menu.
      20. Now we'll only have to mount our /boot partition. Select 'C' of 'Mount Filesystems'. Select the disc, select 'part1' and the filesystem of your choice. The installmenu now prompts for the mount point, enter '/boot' in here en select OK.
      21. The easy part. Transfering sorcerer from CD to HD. Select 'D' or 'Transfer Sorcerer'. It will ask if you are done mounting FS's, hit 'enter'.
      22. After copying is done, the customizing part comes up. Select 'E' or 'Select Timezone'. This part is up to you, I run Europe/Amsterdam since I live in CET.
      23. The next part asks about your hardware clock. Im unsure, but I think most machines run on Local time. So select 'L' or 'Local'.
      24. Now we are back at the menu. Select 'F' or 'Architecture Optimize'.
      25. Select what type of microprocesser you run. I run a Celeron on my laptop, so I will select 'i686'. On the bottom of the screen shows the types of processors. [IE: If I highlite 'i686' then "Pentium Pro, Celeron, P2, P3, P4" appears at the bottom left. This is a little helper].
      26. Now select your optimizations. You dont have to select anything, however I always select 'speedy'. You can select by pressing the 'spacebar'. Selecting 'speedy' will cost you a longer compile and size. If you select 'risky' some apps wont compile due to errors. XFree86 wont compile. If you want you can 5enable and disable at will, so you can enable it on some apps, but not on others. The 'risky' setting makes some apps go faster. I usually select this as well when compiling the kernel.
      27. It should repeat back what your optimizations are. Hit 'enter' to go back to the menu.
      28. Next we configre the kernel. Select 'G' or "configure Linux Kernel". It should give you a message or two. It will then proceed to buid Linux and have a bit of fun for a minute or two.
      29. This next part I cant really help you on much because this deals with YOUR computer, however I can suggest a thing or two.
      30. To allow yourself to read a windows floppy: Select 'F' or 'File systems --->'. Then select 'D' or 'DOS FAT'. That should grant you premission to the submenu 'VFAT (Windows-95) fs support'. Select that.
      31. Internet: When you select your network card in here, be sure and write down what module file it requires. You can find out by selecting 'help' while having your driver highlited. The .o file is the module file, and is located (usually) at the bottom of the help. You will need this later when it asks for what module to use for your network card.
      32. Select 'exit', and it will ask if you want to repeat menuconfig. Select 'n'. It will now build your kernel. This might take quite some time.
      33. After doing the kernel, you may want to look/edit the lilo.conf file. Edit if you want to. tds has placed his lilo.conf file with some descriptions in it. His and mine can be found here 6.
      34. It will next ask if you would like to view the install log, I usually dont. This is your decision here.
      35. It should next take you back to the menu.
      36. We now want to configure out networking, if we want to access the internet through network. So, select 'I' or 'Configure Networking'.
      37. It will then ask for a name to your box... go ahead and pick something cool. I chose 'hondekop.dignus.nl'.
      38. You then have 3 choices for how to access the internet. Since I use have an enternet I choose 'E' or 'Ethernet'.
      39. It will ask you if you'll require PCMCIA. As I am installing Sorcerer on my laptop, I chose Yes.
      40. It next asks i we require DHCP. I run DSL, and we since I dont use PPPOE I use DHCP. You will also use DHCP if you use a router for your DSL if you have PPPOE.
      41. Name your ethernet device. 'eth0' is default, so go ahead and use it.
      42. Now you need to tell it what module to use for your NIC card. Dig out that paper, I asked you to write it down. Mine is '8139too.o'. Type in the module's name without the '.o'.After this step, it should bring you back, again, to the menu.
      43. We are done thus far, so select 'J' or 'Done'. It will then ask if you want to reboot, select 'no'.
      44. Linux will now load, or at least a small form of it. This is not the linux that you will be running, its more like a shell from the CD.
      45. Enter 'root' at login. When it asks for a password, use the cleverly disguised 'enter' key. It doesnt use a password. :-)
        NOTE: This step is so that you become familar with how to get a prompt so you can use the rescue features of the install cd.
      46. Now lets shutdown. Your prompt should be somethign like: 'root@Sorcerer:~#'. Type 'halt'. It will then procedd to tweedle around a bit. When the last sentace is says is 'Power down.' Power down.
      47. Now power back up. As soon as you boot up, eject your cd. So we dont boot from it.
      48. The LILO bootloader should popup and give you 12 seconds to make a selection. Press 'enter' to load Linux.
      49. Congratulations. You have installed Sorcerer. Use the same User and password as you did earlier to get in



      1 - disc0 is your Primary/Master. disc1 is your Primary/Slave. disc2 is your Secondary/Master. disc3 is your Secondary/Slave.
      2 - A swap file/partition adds to available memory.
      3 - The root partition is the partition that everything runs on. We set this to be partition 1.
      4 - A filesystem is the way your computer writes to your HD. We have to have some form of way of knowing what we wrote. http://www-106.ibm.com/developerworks/library/l-fs.html has some info on Filesystems. I use ext3.
      5 - You can turn off or turn on any setting by typing 'sorcery', selecting 'O' or 'Option Menu', and 'O' or 'Optimize Architecture'.
      6 - tds's lilo.conf file can be found at lilo_tds.conf.txt. Mine can be found at lilo.conf.txtNeal Birch has kindly given out his lilo.conf file. His uses many partitions. His file can be found at neal_lilo.conf.txt.


  6. Post install procedures

    GETTING STARTED AFTER INSTALLATION

    Congratulations on sucessfully installing Sorcerer

    LOGIN

    Login: root
    Password: [Enter]

    ***** IMPORTANT NOTE *****

    Be sure to check here for updated post-install and upgrade procedures:
    https://lists.berlios.de/pipermail/sorcerer-spells/2002-December/002247.html

    QUICK START CHART

    passwd change your root password
    pon type this command if you have a dial-up connection to connect to your ISP
    screen sorcery update-grimoire
    initial synchronization to latest utilies and compile instructions
    augur synch
    secondary synchronization to latest utilies and compile instructions
    run compiler config script
    create compiler settings file
    run gcc and glibc hold script
    create hold of gcc and glibc to original versions
    augur update
    first stage of recompiling process - SELECT EDITING THE QUEUE and make sure to edit out gcc, glibc, and linux if they appear on the list.
    sorcery rebuild rebuild ALL installed spells from source - SELECT EDITING THE QUEUE and make sure to edit out gcc, glibc, and linux if they appear on the list.
    cast useful-profile this step is OPTIONAL, but RECOMMENDED if you plan to use X
    poff type this command if you have a dial-up connection to disconnect from your ISP
    augur or sorcery
    dabble in sorcery and play with your new tools
    cast spell or profile among the things you do to keep everything ship-shape

    Detailed explanation of chart items.

    INITIAL SYNCHRONIZE

    Sorcery contains a software catalog and utilities and is updated much more frequently than the sorcerer ISO image. This is why an initial syncrhonize is recommended after each Sorcerer installation. This software catalog, called the grimoire, describes the most current stable release for each source.

    COMPILER CONFIG SCRIPT

    cd /etc/sorcery
    mv local.config local.config.b4.glibc.es.gcc.hold
    Run sorcery -> options and go thru all the submenus.

    GCC AND GLIBC HOLD SCRIPT

    augur hold gcc,v2.95.3
    augur hold gcc,v3.2
    augur hold gcc
    augur hold glibc

    REBUILD DISTRIBUTED BINARIES FROM SOURCE

    This step can take a long time, but it is worthwhile since it recompiles all distributed binaries from source using the compiler optimization parameters you specified. After rebuilding your box will 100% source-based. All spells will have been compiled on your system, and optimized specifically for your system.

    There are two methods for rebuilding spells in Sorcerer.
    1. Type sorcery rebuild or
    2. Type sorcery to start the menu-drive spell management utility.
      1. Select Spell Menu
      2. Rebuild Spells.

    DABBLE IN SORCERY

    Type sorcery and browse the menus and sub-menus.
    Press [Esc] to back-out of a menu and to exit the program from the main menu.

    PLAY WITH YOUR NEW TOOLS

    We strongly recommend just typing cast or augur or dispel without any "arguments" and reading on the various things these commands do.

  7. Keeping everything ship-shape

    UPDATE THE SPELLS

    It can be a good idea to update your installed packages on occasion.

    The methods below compares the version numbers in the grimoire against version numbers of your currently installed spells. (This information is in the /var/log/sorcery/version files .) If any of the versions do not match then the installed spell will be re-cast, unless it the system administrator has it on hold. There are two possible methods for updating packages in sorcerer.

    1. Type augur synch followed by augur update  or
    2. Type sorcery to start the menu-driven spell management utility.
      1. Select Update Menu
      2. Select Synchronize Spell and when done then
      3. Select Update

    Notes about method no. 1.
    The command-line-based method is useful for immediate processing and automated updates. With this method you could add an entry to the crontab to automatically perform updates every night. It may also be faster to type augur synch and then augur update then it is to call up sorcery and navigate the menus.

    Notes about method no. 2.
    Sorcery is menu-based and places the updated spells in an install queue which can be useful for:
    1. reviewing the list of spells updates
    2. removing spells from the update list
    3. adding additional spells to the install or removal queues prior to processing

    BLOCKING UPDATES

    Installed spells can be frozen at the current version (updates can be blocked).

    By using one of the following two methods.
    1. Type augur hold. <filename> OR
    2. Type sorcery to start the menu-driven spell management utility.
      1. Select Spell Menu
      2. Select Hold Spells
      3. Select/deselect spell(s) using the [space] bar
      4. Press [Enter] on the  select button

    INSTALLING SOFTWARE SPELLS

    Install your software spells (replace spell# with the spell name found in the sofwtare catalog).

    By using one of the following three methods.
    1. cast spell1 [spell2]... [spell#]

      example:
      cast emacs sudo

    2. Type sorcery to start the menu-driven spell management utility.
      1. Select Spell Menu
      2. Select Select Spells
      3. Select a section (catagory)
      4. Use [space] bar to select/deselect spell(s)
      5. Press [Enter] to select to commit button
      6. Press [Esc] until you return to the main menu
      7. Select Run (queues)


    REMOVING SOFTWARE SPELLS

    Similar to ADDING SOFTWARE SPELLS. Except that the command is dispel and the menu selection is REMOVE SPELL.

  8. Where do I go from here?

    For BEGINNERS, we recommend reading through all of the documentation at least once, preferably twice.

    Since we realize that many people will not be doing this, we recommend that at the very least you read the system administrator, install, and the first two parts of the FAQ.

    For MORE ADVANCED users and ANYONE HAVING PROBLEMS , we would add the rest of the FAQ, and the first parts of the spell documentation.

    If you desire extra security on your box you will want to read how to set up encrypted loopback filesystems in the newbie FAQ. Please see these FAQ items both here and here for more information.

  9. XFree86 install example

    To view my Sorcerer machine information click here.

    What you need to know about your system:


    I leached XFree86 before I wrote this, so I could write it AND install at the same time.
    If you would like to do this, run the command 'leach xfree86'.

    Installing XFree86:
    1. Type the command 'cast xfree86'.
    2. After downloading, it should ask 'xfree86: Configure host.def? [y]'. If you have
      allready isntalled xfree86 before, the default will be [n] instead of [y]. I will
      assume that we will be configuring 'host.def'.
    3. You should now be taken to a menu. We will now configure the video card, so select 'X' or 'XF86CardDrivers'.
    4. A list of graphics cards should come up. I use an 'ATI Rage' for my laptop. So I select 'a' or 'ati'. Select your driver, and hit 'enter'.
    5. You should now be taken back to the first menu. If your graphics card has DRI, then select 'D' or 'DriDrivers'. Now select your 'DRI Driver'. My desktop would use the 'radeon' driver. After you selected your DRI Driver, hit 'enter' to go back to our main menu.
    6. If you have other input devives, want to change/edit your font options, or want other options added to XFree, then tweak with the next 3 menu's.
    7. We are done configuring the compile options for XFree86, so lets save it by selecting 'S' or 'Save current configuration'. It should say it was saved and tell you were it was saved to. Hit 'enter'.
    8. Now we leave and being to compile. Select 'E' or 'Exit'.
    9. It should have some fun for a while.

    XF86Config:
    1. Run the command 'xf86config'.
    2. It should tell you some things, just hit 'enter'.
    3. It will now ask you for what protocol for your mouse. Enter the corresponding number that goes with your mouse and hit 'enter'.
    4. It will ask if you would like to 'Emulate3Buttons'. I usually say 'n'. If you have a 2 button mouse, select 'y'. If this option is selected, press button 1 and 2 simultaneously and it will act like button 3.
    5. It will now ask for the device name for your mouse. Just hit 'enter' and let it go for default.
    6. It now asks you for your keyboard, select your coresponding number and press 'enter'.
    7. It should now ask for your country, select your coresponding country and hit 'enter'.
    8. It will now ask for you to enter a variant name for your layout. Just go for default by hitting 'enter'.
    9. It will now ask you if you want additional XKB options. Select 'n' and hit 'enter'.
    10. It will now say it wants to know the specifications of your monitor. Hit 'enter'.
    11. Now enter your coresponding number with your horizontal sync range and hit 'enter'. If yours isnt supported, hit number '11' and press 'enter'. Then enter your range.
    12. Now enter your coresponding number with your vertical sync range and hit 'enter'. If yours isnt supported, hit number '5' and press 'enter'. Then enter your range.
    13. It now wants a monitor definition. Pressing enter will fill in default names, so hit 'enter'.
    14. It now needs wants to know your graphics card and wants to know if you want to view the list. Press 'y' and hit 'enter'.
    15. Keep on hitting 'enter until you see your name. 'ATI Radeon' is not listed, however, since it is an 'ATI' driver, you can select the 'ATI' driver. <-- That was just an example.
    16. You may notice that on the right side is the graphics card brand. IE: ATI. If you have an ATI, then selecting any of these will do. Same thing for other types.
    17. Type in your coresponding number and hit 'enter'.
    18. It will then tell you your card definition, and want you to either press enter or ctrl-c (to abort). Press 'enter'.
    19. It now wants to know how much memory you have on your card. If you have 4MB or less, select your coresponding number and press 'enter', if not, press '6' and hit 'enter'. Enter the EXACT amount. If you have an 8MB card, multiple 8 times 1024 and enter in that number and press 'enter'.
    20. It now wants you to give a video card definition. Let it fill in default by pressing 'enter'.
    21. It now wants to know what what resolution for what color depth. Unless you want a specific resoultion for a specific depth, press '4' and hit 'enter. When you entered your horizontal sync rate, it noted they max resolution of your monitor. If you would like a virtual desktop, you must enter a specific reslution for the color depths.
    22. It now would like to know what color depth you want, select what you can handle and hit 'enter'.
    23. Almost done, it wants to know if you want to save your config file. Press 'y' and hit 'enter'.
    24. If you have any resolution problems, go through this again, but change your resolution to what you can handel in step 21.

  10. Copyright 2001 and 2002 by Bob Finch - w9ya@amsat.org with assistance from nazadus, dignus, and Kyle Sallee (These authors may retain their own rights.)