Syllable Desktop Installation
1. Will Syllable Run on My Computer?Syllable is designed to run on modern Intel compatible PC's. At a minimum, your machine must have at least a Pentium compatible processor and 32 MB of memory, but a faster processor and 128 MB of memory or more will allow Syllable to do more and run faster. Specifically, you need some more than 32 MB to use the graphical web browser.
Most common home computer motherboards, video cards and networks cards are supported. Many common sound cards, printers and scanners also work, and some USB devices are also supported. If your particular hardware is not fully supported, it does not mean that your hardware will not work. You can still try to install Syllable; the worst thing that will happen is that it simply will not run. In many cases, it is possible to disable the problematic piece of hardware or operate it in a safe mode.
2. Installing SyllableSyllable is normally installed from a bootable CD, which is a simple and fairly painless way to install Syllable. You can download a disc image and burn a CD yourself.
The downloadable Syllable CD image is distributed as a 7-Ziped ISO image. Before you can burn this image to a CD you must first un-7zip it. On Syllable, 7-Zip is included. On Linux or other Unix-like systems such as MacOS X you should make sure that the portable version of 7-Zip is installed. Then type this in the terminal program on your system:
7za x SyllableDesktop-0.6.7.i586.iso.7z
On Windows you must use 7-Zip to decompress the 7zip file.
Once you have decompressed the ISO disc image, you must burn it to a CD using your preferred burning software, for example cdrecord on Syllable and Linux or Nero on Windows. There are no special requirements for burning the Syllable CD image; it is a standard ISO9660 disc image which any disc burning software will be able to burn.
Once you have burnt Syllable to CD you may boot your computer with it. The CD will start the installation program automatically. Simply follow the instructions to install Syllable to your hard drive.
Once Syllable has been installed to your hard drive you must configure the GrUB bootloader. The installation program can do this almost automatically for you, but the following section has extra information.
3. Configuring the BootloaderThe next step is to configure and install the bootloader.
First you must tell GrUB where to find the kernel and the required disk and file system drivers to load before booting Syllable. This information is found in
title Syllable root (hd0,1) kernel /system/kernel.so root=/dev/disk/ata/hda/1 module /system/config/kernel.cfg module /system/drivers/dev/bus/acpi module /system/drivers/dev/bus/pci module /system/drivers/dev/bus/ata module /system/drivers/dev/hcd/ata_pci module /system/drivers/fs/afsThis will tell GrUB to boot the second partition on the first drive through the
The kernel can also take a number of other parameters that are given in the same manner after the
If you install Syllable on the second partition on the first drive, the default configuration file is OK. Otherwise you may need to edit the
title BeOS chainloader (hd0,3)+1This will add a menu entry titled BeOS that will boot the OS found on the fourth partition on the first disk.
You can also set a timeout in seconds for when to boot the first OS in the list (or the default as set by the
3.1 Installing the BootloaderThe easiest way to install the GrUB bootloader is to let the installation program do it automatically. The following describes how to install the bootloader manually, in case you have special needs. Note that it is not necessary to reinstall the bootloader when you just change the configuration file later.
When done editing the configuration file you must reboot the computer by pressing the
Now you must decide whether you want to install GrUB in the Master Boot Record (MBR) of the first drive and use it as a boot manager (or if Syllable is the only OS on the machine) or if you want to install it on the AFS partition only and use another boot manager to select what OS to boot.
In either case you must tell GrUB where to find the configuration file and the second-stage loader by setting a
root (hd0,1)If you did not install Syllable on the second partition on the first disk you must change the parameters accordingly.
Then you must install the bootloader with the
To install on the MBR of the first drive run:
To install it on the AFS partition only, run:
setup (hd0,1)(Again change the parameters according to your setup.)
Now it should be possible to boot Syllable off the native partition.
3.2 Notes on GrUBGrUB understands Syllable's AFS filesystem and can boot any kernel located on an AFS partition by changing the
Read the GrUB documentation and use the
4. First BootThe first time you boot Syllable it will probe your computer to find drivers for your hardware. If a driver is found which supports some piece of hardware the driver will be loaded automatically.
When all needed drivers are available Syllable will start the graphical user interface. You will see a single window in the centre of the screen with a list of user accounts, a password input field and a Log-in button.
Before you will be able to do anything you will have to log in using a user name and a password. The base installation comes with one predefined user, “root” (privileged) with the password
If something went wrong or Syllable failed to boot, please read section 4.2 of this document (Solving Problems).
4.1 What Can I Do Now?You should read the Welcome text, which can be found in the following locations:
- In Syllable in file:///documentation/Welcome.html, also linked from the desktop.
The Welcome document contains information on Syllable websites, mailing lists, software and hardware and will help you to get started with Syllable.
4.2 Solving ProblemsIf Syllable has failed to install or you cannot boot Syllable, there are various places you can try for help and solutions to common problems. Please read the Welcome file; see the previous section of this document (What Can I Do Now?) for more information.
If there is a problem, the first thing you should do is try to narrow it down. What has gone wrong? Did the CD fail to boot? Was Syllable unable to find your hard drive? Did the graphical user interface fail to start? Collect any error messages that you see; these will be useful in helping to solve your problem. Make a note of your hardware (processor and motherboard type, total amount of memory, type of video card).
You should then check the Frequently Asked Questions (FAQ). These provide answers to very common questions concerning Syllable.
If you are sure it is a problem with Syllable check the forums. Someone may already have had the same problem as you and received a solution!
Finally, if none of those help, ask on the Syllable Developer mailing list. You must first subscribe to this list.