This document is basically an extension of Eyetech`s setup guide, it documents many of the solutions to basic problems I`ve come across. Thanks to all the people on the devlist who helped me out.Everything in this document I have done myself so I know it works, at least for me. 1.Setting up an internet dial-up connection 2.Apt-pinning 3.Tar files 4.CD Burning 5.IDE Problems - very important for newbies 6.CHANGING MOUSE KEYBOARD AND VIDEO OPTIONS 7.DVD Software 8.Installing Real Player 9.PLAYING MP3/OGG STREAMS WITH OPERA 10.CREATING A LAME.DEB FILE FOR STABLE 11.GETTING A USB CARD READER TO WORK (BORROWED AND SLIGHTLY EDITED FROM ROYLEITH`S AONE PROBLEMS) 12.SHARING PROFILES IN MOZILLA AND OPERA 13. USING SSL WITH KONQUEROR 14.INSTALLING SAMBA 15.INSTALLING BLACKDOWN JAVA/IBM JAVA 16.CONFIGURING A BROADBAND CONNECTION 17.MAC-ON-LINUX 18.UPDATING KERNEL 19.SEPTEMBER UBOOT UPDATE 20.CONVERTING RPM FILES TO DEB FILES 21.PRINTING 22.UPGRADING KDE AND XFREE 1.First problem for me was setting up an internet dial up connection:- Goto system/debian/admin/pppconfig in the kde menus. If you`ve setup an internet connection before this is fairly strightforward. Once you`ve saved your settings in my case called `demon` open a konsole and type `pon demon` or replace demon with whatever you saved your settings as. You should now go online:) To go offline type `poff demon` You can download and install a graphical ppp program once apt-pinning is set up. 2.APT-PINNING A full guide to apt-pinning along with some FAQ can be found at:- http://www.samfundet.no/~olegil/amiga/ I just copied Ole`s example sources.list, preferences and created apt.conf as described. Once you`ve updated the files above go to a konsole and type:- apt-get update now apt is ready to download and install software, the first 2 programs I installed were xmms and aumix (for xmms think Amiga AMP , aumix is just a sound mixer type program) To install these type:- apt-get install xmms aumix to search for files:- apt-cache search xxxx If you have a Debian CDRom set you can add the CD`s to your sources.list by typing:- apt-cdrom add and then update apt as above. If you have set up apt-pinning as per the guide the first time you try to install unstable software apt-get will need to update your libc6 file. I would highly recommend you login in console mode as KDE needs to be closed down. Once the libc6 is updated you can install further unstable packages safely within KDE (except KDE andXfree updates). To be sure you upgrade your libc6 correctly perhaps the easiest way is to install it before you try to install unstable packages. Login in konsole mode and type:- apt-get -t unstable install libc6 You can then login to KDE and start installing testing & unstable packages. To check your libc6 version type:- /lib/libc.so.6 2.25 =stable 2.31 =unstable see item 22. for details on upgrading KDE and XFree 3.TAR FILES to open a tar file: tar -xfvz xxxxxxxxx.tar.gz don't forget to change the current directory to that of the unpacked archive if neccessary Once you have untar`ed a download you will need to run the installer, in Opera for example this is called install.sh , to run it type:- ./install.sh don`t forget to cd into the unpacked directory before running the installer. In the case of Opera make sure you download the static version. If you download mozilla 1.3 or 1,4b get the installer version which makes life a bit easier, it has a graphical installer. I set up a download directory in my home directory to keeps all the files in a convienient place. 4.CDBURNING I`ve installed several cd burning programs via apt-get (Kreatecd, xcdroast and cdbakeoven) , i`ve had mixed results , though i`ve never had a burner before so to some extent I was experimenting. If like me you`ve got a dvd and a cdrw you`ll need to get Linux to recognize the cdrw. To burn cd `s the cdrw needs to use scsi emulation, this needs to be set in bootargs. I set my dvd drive to scsi emulation as well so CD writing software could read from it. To add to bootargs go into uboot by interupting the countdown on boot up. Go into bootargs and enter a space after the last entry and type `hdc=ide- scsi hdd=ide-scsi`. This tells uboot to use scsi emulation on the secondary ide master (hdc) and slave (hdd). The Primary ide master is hda and slave hdb, so enter as appropriate. Save the settings as you exit uboot but just to make sure enter saveenv back at the prompt (the save function in uboot dosen`t always work). Once rebooted back into kde open a konsole and type:- cd /dev ln -f -s sr0 cdrom (this will change your cdrom from hdc to sr0- first scsi device) then:- ln -f -s sr1 cdrw (this creates cdrw as the 2nd scsi device) cd / mkdir cdrw then with a text editor edit /etc/fstab copy the cdrom line and change all mentions of cdrom to cdrw. To make life much easier you can set up icons for cdrom and cdrw, just right click on kde and select create new cdrom device. Some dvd players look for /dev/dvd rather than cdrom, to bind calls to dvd to cdrom type:- ln -s /dev/cdrom /dev/dvd (the first character is a little L BTW , took me a while to realise this) 5.IDE PROBLEMS If like me you have problems with stability or HD errors add ide=nodma to your bootargs, this dosen`t create a noticeable slowdown , but might explain why I had trouble burning on the fly from my dvd to cdrw. A fix for this will soon be available in the form of Uboot and kernel updates. 6.CHANGING MOUSE KEYBOARD AND VIDEO OPTIONS I installed the wrong mouse driver when setting up debian for the first time which made KDE very difficult to use. The simple solution was to enter from a konsole:- dpkg-reconfigure xserver-xfree86 and reconfigure as appropriate 7.DVD SOFTWARE TO play DVD`s you`ll need either Mplayer or Xine or VLC ,if you want to play encrypted DVD`s (most of them) you`ll need 'libdvdcss2'. This is available as a .deb file and can be installed from apt-get. Just add the follwing to your sources.list and update apt-get. #videolan incl.libdvdcss etc deb http://download.videolan.org/pub/videolan/debian sid main The DVD player VLC is also available at this site. NB:- If you wish to use stable only a slightly older version of libdvdcss2 (1.2.2-1) is available for download. Once you`ve downloaded a .deb file this way just click on it and the Debian Package Manager will open allowing you to install it (the package manager gives you useful info. about the files dependancies). There is a version of Xine in the stable Debian release, I had problems getting this to work well, so I downloaded the source code from:- http://xinehq.de/index.php/releases I chose the latest versions of xine-lib and xine-ui and followed the instructions to complie and install them. Xine has given by far the best results of the players i`ve tried , it supports menus and subtitles and runs nearly at full speed. To get best results try the xv driver which uses the hardware support on video cards (though unfortunately this dosen`t make alot of difference on my Radeon 7000 , due to difficulty in getting the necessary documentation from ATI).Having the DMA disabled will also slow down playback, so hopefully much better results will be acheived when the DMA problem is fixed. To compile xine you will need to install zlib1g-dev using apt-get. You can also install an upto date Xine and Gxine from Debian unstable using apt-pinning Mplayer is available for unstable at:- #mplayer deb http://honk.physik.uni-konstanz.de/~agx/linux-ppc/debian/ mplayer/ To see how much better DVD playback can be, you can enable DMA on your DVD drive only. To do this install hdparm using apt-get. Then type the following into a konsole:- hdparm -d1 /dev/hdc (this assumes your dvd is the secondary master) Playback should be much smoother, but at somepoint an error will most likely occur causing your dvd software to quit or crash. 8.INSTALLING REAL PLAYER Instructions for installing Real Player can be found at:- http://www.yellowdoglinux.com/support/solutions/ydl_general/real_install.shtml Once installed it should automatically work with Mozilla. To get it working with Opera is a little more difficult. Go to Opera preferences and select file types, click new and add:- application/smil smi click on open with other application and choose /usr/local/realplayer8/realplay repeat the process for audio/x-pn-realaudio ram Make sure you click 'apply' before exiting prefs. Realplayer should now work. The BBC Radio Player refuses to work under Linux, an alternative way to use these streams can be found at:- http://www.bbc.co.uk/radio/aod/unix.shtml 9.PLAYING MP3/OGG STREAMS WITH OPERA The mime type is:- audio/x-scpls pls open with:- /usr/bin/xmms 10.CREATING A LAME.DEB FILE FOR STABLE I couldn`t find a lame.deb file for stable anywhere , so eventually I had to learn how to make one for myself as follows: First install the following software with apt-get:- fakeroot debmake debhelper libncurses5-dev then download the lame sourcecode from:- http://lame.sourcefourge.net/ I chose lame-3.93.1.tar.gz unpack the tarfile then cd into the unpacked file and type:- chmod u+x debian/rules dpkg-buildpackage -us -uc -rfakeroot (I guess these commands are the same for any sourcecode?) After a minute or so the .deb file will be created , just open it and let the debian package manager do the rest. I use `abcde` to rip mp3`s and oggs off CD`s. By default `abcde` uses ogg, to get it to use mp3 use the following command:- abcde -o mp3 1 (where 1 is the track no. on the CD). if you want a graphical interface try RipperX If you are using testing or unstable a lame.deb is available at:- # Unofficial Debian Multimedia Packages (lame) deb http://jcarr.wit.org/debian sarge graphics 11.GETTING A USB CARD READER TO WORK (BORROWED AND SLIGHTLY EDITED FROM ROYLEITH`S AONE PROBLEMS) Type `modconf` in a konsole. Select the usb storage driver. add the following line to /etc/fstab /dev/sda1 /usbcard auto rw,user,noauto 0 0 create a new directory in root alongside cdrom etc mkdir usbcard then type:- cd /dev ln -f -s sda1 usbcard goto kde and create a hard disc icon to mount/unmount My Lacie Hexadrive works entirely as you would expect, NB- you must use the back usb ports on your A1 motherboard. 12.SHARING PROFILES IN MOZILLA AND OPERA I used my Root account for weeks before setting up a user account (as recommended) but I wanted to view all my emails from root in my user profiles for Opera and Mozilla, and have the convienience of having all my emails at hand whether logged in as root or as user name `andy`. To do this you need to make the root profiles belong to the user as follows:- chown -R andy /root/.mozilla chown -R andy /root/.opera Then log in as the user and change the profile paths in Opera and Mozilla. In opera goto the file menu, select prefs and then programs and paths and change the Opera directory to /root/.opera/ In Mozilla goto edit and select Mail & Newsgroup settings, select server settings and change the path in local directory to the same as in your root account. 13. USING SSL WITH KONQUEROR To install SSL for use with konqueror:- apt-get install kdebase-crypto kdelibs3-crypto openssl 14.INSTALLING SAMBA apt-get install samba samba-common smbfs swat (just gotta work out how to use it now!) see:- https://lists.samfundet.no/mailman/private/a1g3dev/Week-of-Mon-20030623/subject.html 15.INSTALLING BLACKDOWN JAVA/IBM JAVA You need to put the following in your sources.list # blackdown java deb ftp://metalab.unc.edu/pub/linux/devel/lang/java/blackdown.org/debian unstable main non-free apt-get install j2re1.3 j2se-common java-common The executable to point Opera at is:- /usr/lib/j2se/1.3/jre/lib/ppc though as yet I can`t get this to work correctly, Opera slows to a halt and appears to crash:( Java should automatically work with Konqueror, but to get it to work with Mozilla you will need to copy:- javaplugin_oji.so to:- usr/local/mozilla/plugins ---------------------------------------- NB:- I got Blackdown Java working in Mozilla and Konqueror but found it somewhat unreliable . Alternatively you can install IBM Java which is available in a more upto date version (although there is no Mozilla plugin) at:- https://www6.software.ibm.com/dl/lxdk/lxdk-p Download the SDK version in RPM format (32bit pseries) and convert it using alien (see 20). Install the deb file and add the following line to etc/bash.bashrc export PATH=/opt/IBMJava2-ppc-141/jre/bin:$PATH You will also need to set the paths in Opera and Konqueror. NB:- IBM Java refuses to work for me in Opera and Konqueror, but most seem to have it working in Konqueror, and some report it working with Opera 7.11 but not 7.23 16.CONFIGURING A BROADBAND CONNECTION 1mb ADSL at last :) yippeee If you are using NAT you need to alter as relevant the ip `address` your machine and the `gateway` your router in the file:- /etc/network/interfaces Also you need to specify your isp`s dns servers in the file:- /etc/resolv.conf For DHCP , I am told Linux will auto configure with the command :- dhclient eth0 please note I haven`t tried this myself. If you want to use Mac-on-Linux it`s best to use NAT as both Linux and MacOS will try to take the same Ip address with DHCP. 17.ADDING EXTRA PARTITIONS To do this login in console mode and type cfdisk. You will now see the same partitioning software as when you installed Debian. If you intend to use more than 4 partitions make sure you select logical rather than primary for the 4th partition. If you make you`re 4th partition primary then the rest of the disk will be unusable. To format a partition from a konsole:- mkfs.ext3 /dev/hdxx where xx could be hda2 for example 17.MAC-ON-LINUX You can find the MOL files at:- http://members.optusnet.com.au/amigaone/ Make sure you download both the correct kernal module and the main file. It dosen`t matter which order you install them in. Instructions on installing OSX/MacOS can be found at:- http://amigaone.cleminic.org/maconlinux.html 18.UPDATING KERNEL Instructions for updating your kernel can be found at:- http://amigaone-linux.sourceforge.net/docs.php The updated kernels can be found at:- http://amigaone-linux.sourceforge.net/download.php 19.SEPTEMBER UBOOT UPDATE The words of Ross Vumbaca:- "If you have the latest UBoot(sept), then some possibly good settings to use are: pci_irqa=9 pci_irqb=10 pci_irqc=11 pci_irqd=7 pci_irqa_select=level pci_irqb_select=level pci_irqc_select=level pci_irqd_select=level Just do a "setenv pci_irqa 9" for the first one, and so on.." 20.CONVERTING RPM FILES TO DEB FILES An awful lot of software only seems to be available in RPM format. To get round this install alien with apt-get then cd to the directory the RPM is in and using IBMJava as an example type:_ alien IBMJava2-SDK-1.4.1-1.0.ppc.rpm A deb file will then be created. 21.PRINTING I had a lot of trouble getting printing working correctly, but I finally got a properly working setup. First install cupsys and kdelibs3-cups with apt-get NB:- kdelibs3-cups is not necessary with KDE 3.x Then go into the KDE control center print manager, choose CUPS as the `print system currently used`, and then add your printer. A web interface for CUPS is available at:- http://localhost:631/admin Some apps such as Open Office and Mozilla need to be told to use the KDE print manager. All you need to do is change the print command in these apps to `kprinter` 22.UPGRADING KDE AND XFREE First make sure you have set up apt-pinning as described above in 2. As of 20.1.04 KDE 3.1.5 is available in unstable, to install it type (from a konsole login):- apt-get -u -t unstable install arts kde kdelibs kdebase kdegraphics kdeadmin kdemultimedia the -u is useful as it tells you which files are being upgraded (hopefully the kde files amongst many others). With other methods i`ve tried such as dist-upgrade , apt-get has wanted to remove the kde files , a lot of people seem to have lost kde this way. As of 20.1.04 Xfree 4.2.1.1 is available in unstable, to install it type (from a konsole login):- apt-get -u -t unstable install xserver-common xserver-xfree86 If you need to install Xfree 4.3.01 it is available at:- deb http://ftp.no.debian.org/debian/ ../project/experimental main add this to your sources list , and type the following from a konsole login:- apt-get -u -t experimental install xserver-common xserver-xfree86 To check your version of Xfree:- xdpyinfo | grep 'XFree86 version' If you lose your graphical login after an upgrade, check the following file:- /etc/X11/default-display-manager if you are using kde it should read:- /usr/bin/kdm