HOWTO : Ubuntu 'Hoary ' with Beagle 0.0.9 and Mono 1.1.6
发表于 : 2005-05-04 1:59
Help with installing Beagle on Ubuntu can be found on the BeagleInstall page of the Ubuntu Wiki. However, that HOWTO only covers installing Beagle 0.0.7 and compiling from CVS whereas this one uses pre-built packages.
Note: The Mono version in the latest Hoary contains Mono 1.0.5 which doesn't work with latest versions of Beagle (i.e. 0.0.8 and 0.0.9).
1. Getting the Packages
You are strongly encouraged to use method 1b, 1a is not maintained any longer.
1a. Installing running Mono 1.1.4-1 packages from from http://manno.name/debian with Beagle 0.0.9. (OBSOLETE)
To do this, add the following line to your /etc/apt/sources.list. You can do this using the command:
sudo nano /etc/apt/sources.list
Add this line to the bottom of the file (Beagle 0.0.9).
deb http://manno.name/debian/ hoary main
If you wish to use the bleeding edge 0.0.9 CVS version, you should add the following to your sources.list instead.
deb http://manno.name/debian/ hoary main cvs
PLEASE NOTE: The version used in this HOWTO is 0.0.9 which requires inotify 0.21 which is not in the Ubuntu kernel. This means that you need to use Beagle without inotify (with means no USB problems - see below), build your own kernel or use Beagle 0.0.8 (see below).
You can now update your listings and install inofficial Mono 1.1.4.
sudo apt-get update
sudo apt-get install mono mono-jit mono-utils mono-mcs mono-assemblies-arch mono-assemblies-base mono-common libgsf-cil libmono0
1b. Installing Mono 1.1.6 from Breezy Badger Backports (RECOMMENDED)
Ubuntu will have Mono 1.1.6 built in for Breezy Badger which it is released in October/November time. However, the Ubuntu Backports project means that the Mono 1.1.6 Packages can be installed into Ubuntu Hoary Hedgehog 5.04. All you need to do is edit your sources.list to include the Backports repository, install Mono 1.1.6 and remove the Backports (unless you want to keep them). Mono 1.1.6 is recommend over 1.1.4.
sudo gedit /etc/apt/sources.list
You now need to add this line to the bottom of the file:
deb http://backports.ubuntuforums.org/backports hoary-backports-staging main universe multiverse restricted
deb http://manno.name/debian/ breezy cvs
You can now update your listings and install Mono 1.1.6.
sudo apt-get update
sudo apt-get install mono mono-utils mono mono-jit mono-utils mono-mcs mono-assemblies-arch mono-assemblies-base mono-common libmono0
You should now have Mono 1.1.6 installed. You can remove the backports from the sources.list if you wish. NOTE: Leaving this in will mean your system is updated with newer software which is possible unstable.
sudo gedit /etc/apt/sources.list
and remove the line:
deb http://backports.ubuntuforums.org/backports hoary-backports-staging main universe multiverse restricted
3. Installing Beagle
Run these commands in a Terminal window to download and install Beagle and all the dependencies. You will recieve a messages about these packages being 'untrusted' but you can safely ignore this.
sudo apt-get update
sudo apt-get install beagle
4. Setting Up Your Filesystems To Be Indexed
To set your file system up to accept extended attributes you will have to edit /etc/fstab. This is needed in order to index your filesystems. Simply, add 'user_xattr' to the line refering to your home directory. On a default Ubuntu install this is done by changing the line that looks like the following:
/dev/hda1 / ext3 defaults,errors=remount-ro 0 1
To make it look like this:
/dev/hda1 / ext3 defaults,errors=remount-ro,user_xattr 0 1
When you are done editing the filesystem(s) you want then you need to remount the filesystem(s) using this comment for each file system you changed:
sudo mount -o remount /dev/hda1
Change the /dev/hda1 part with whatever partitions you selected.
5. Inotify - CAUTION
If you are using Beagle 0.0.8 or you have build your own kernel with inotify 0.21, you can enable inotify kernel support. You must have Hoary Final Release with the latest kernel installed as this is when inotify 0.18 support was added.PLEASE NOTE: When I enabled inotify, it broke my USB plug and play support so I wouldn't enabled it. It just means that you will loose some performance! This is a GNOME bug which should be fixed soon. I would recommend you DO NOT enable inotify until the bug is sorted. Proceed with caution.....
Edit /boot/grub/menu.lst.
find a line starting with "# nonaltoptions" and append inotify to it. Mine ends up like this:
# nonaltoptions=quiet splash inotify
then run sudo /sbin/update-grub to apply these options to all kernels. Reboot.
6. Address Book Bug
The Beagle 0.0.8 and 0.0.9 installations have a small bug which means that the Evolution address book can't be searched. You can fix it by:
cd /usr/lib
sudo ln -s libebook-1.2.so.3 libebook-1.2.so.0
7. Mozilla Extenstion
The Mozilla extension which works for both Mozilla and Mozilla Firefox isn't included with the packages so here is 'one that I made earlier'. You can download it from here http://www.trowbridge.org/beagle-on-debian/beagle.xpi (Thanks to Jon Trowbridge for hosting this). You can install it by going to File --> Open File and selecting the beagle.xpi file. You will need to restart your browser for this to take effect.
8. Beagle Web Services
The latest Ubuntu packages are now web services enabled which mean you can access Beagle from your web browser (and possibly from external sites if you do some router/modem configuration). You can access the page at:
http://localhost:8888/beagle/search.aspx (obviously changed localhost to your IP address of the machine you have Beagle on)
Before this will work, you need to add the --web-start extension when start beagled. See the next sections for more information on this. This page has loads of information on the web services.
9. Pool of Files to Index
Note that by default, everything gets indexed. To get results faster and to possibly get better stability (remember this is alpha software), it is recommended to make the pool of files to index smaller by defining the file .neverindex in your home directory.
cd
ls > .neverindex
Now edit the hidden file .neverindex and remove all directories/files you want to be indexed.
See How to index my data for more information on how to prevent files from being indexed.
10. Starting Beagle
You need start the Beagle daemon (beagled) which will index your data. The --web-start extention enables the Web Services section. You can do this, by running:
beagled --web-start
It is a good idea to start beagled with the debug options which makes it easier to find problems. You can do this by:
beagled --fg --debug --web-start
NOTE: When you restart, you will keep all of the indexed data! You can stop beagle by press Ctrl + C twice (you press it once and then some exiting text appears so it has been again).
11. Searching your Data
The most popular way of searching your data is to use the Best (Bleeding Edge Search Tool) which provides a sleek GTK interface. It should be in your Accessories --> Best. It will then appear in the notifitication area in the top right hand corner of the screen. You can get Best to run on boot by adding the option to run the command: 'best' at startup in the System --> Preferences --> Sessions.
12. Feedback
I (http://www.evolutioncolt.com) have added a lot to this page on the Wiki to make it a more comprehensive guide. Please email at spayne@evolutioncolt.com and tell me if it works, you've found some typos or if your're stuck. The IRC #dashboard channel on irc.gimp.net is very helpful and a lot of the Beagle and GNOME developers hang around here. You can find me here as HulaBeagleSeb
13. Questions and Answers
Q: Why can't I use inotify with Beagle 0.0.9?
A: Beagle 0.0.9 requires the inotify 0.22 patch whereas the standard Ubuntu kernel only has inotify 0.18. This means you can run Beagle without inotify (recommended) or make your own kernel with inotify 0.22 patch. Generally, Beagle 0.0.9 works well on a Athlon 2000+ system without inotify. The only disadvantage is that your data can take longer to index.
Q: I get an error like: "trying to overwrite `/usr/lib/mono', which is also in package ..." try
A: It seems a lot of packages provide a /usr/lib/mono symlink.You can solve this by running:
dpkg -i --force-overwrite /var/cache/apt/archives/mono-assemblies-base_1.1.4-1_all.deb
Q: Why does installing beagle on hoary pull in mozilla-browser? -- CraigBox
A: Best (the Beagle UI) uses Mozilla's Gecko HTML rendering widget.
Q: Can't it depend on mozilla | firefox then?
Q: When I run Best, I get an error saying the Beagle Daemon isn't installed. How do I start it?
A: You can start the Beagle Daemon by running this command in a Terminal window:
beagled
It is a good idea to start beagled with the debug options which makes it easier to find problems. You can do this by:
beagled --fg --debug
Q: In Evolution 2.2, I have an IMAPrev1 account and Beagle isn't indexing it. Why?
A: Beagle 0.0.8 does not have support for IMAPrev1. 0.0.9 (the current release) adds this support.
Q: I get the "Lock obtain timed out" exception - even though I'm running Mono 1.1.4. Any suggestions?
A: Solved after upgrading to 1.1.4-1.
14. Screenshots
See the offical page for shots here. Mine at the ones at www.sebgate.f2s.com running on Ubuntu Hoary Hedgehog Final Release.
Note: The Mono version in the latest Hoary contains Mono 1.0.5 which doesn't work with latest versions of Beagle (i.e. 0.0.8 and 0.0.9).
1. Getting the Packages
You are strongly encouraged to use method 1b, 1a is not maintained any longer.
1a. Installing running Mono 1.1.4-1 packages from from http://manno.name/debian with Beagle 0.0.9. (OBSOLETE)
To do this, add the following line to your /etc/apt/sources.list. You can do this using the command:
sudo nano /etc/apt/sources.list
Add this line to the bottom of the file (Beagle 0.0.9).
deb http://manno.name/debian/ hoary main
If you wish to use the bleeding edge 0.0.9 CVS version, you should add the following to your sources.list instead.
deb http://manno.name/debian/ hoary main cvs
PLEASE NOTE: The version used in this HOWTO is 0.0.9 which requires inotify 0.21 which is not in the Ubuntu kernel. This means that you need to use Beagle without inotify (with means no USB problems - see below), build your own kernel or use Beagle 0.0.8 (see below).
You can now update your listings and install inofficial Mono 1.1.4.
sudo apt-get update
sudo apt-get install mono mono-jit mono-utils mono-mcs mono-assemblies-arch mono-assemblies-base mono-common libgsf-cil libmono0
1b. Installing Mono 1.1.6 from Breezy Badger Backports (RECOMMENDED)
Ubuntu will have Mono 1.1.6 built in for Breezy Badger which it is released in October/November time. However, the Ubuntu Backports project means that the Mono 1.1.6 Packages can be installed into Ubuntu Hoary Hedgehog 5.04. All you need to do is edit your sources.list to include the Backports repository, install Mono 1.1.6 and remove the Backports (unless you want to keep them). Mono 1.1.6 is recommend over 1.1.4.
sudo gedit /etc/apt/sources.list
You now need to add this line to the bottom of the file:
deb http://backports.ubuntuforums.org/backports hoary-backports-staging main universe multiverse restricted
deb http://manno.name/debian/ breezy cvs
You can now update your listings and install Mono 1.1.6.
sudo apt-get update
sudo apt-get install mono mono-utils mono mono-jit mono-utils mono-mcs mono-assemblies-arch mono-assemblies-base mono-common libmono0
You should now have Mono 1.1.6 installed. You can remove the backports from the sources.list if you wish. NOTE: Leaving this in will mean your system is updated with newer software which is possible unstable.
sudo gedit /etc/apt/sources.list
and remove the line:
deb http://backports.ubuntuforums.org/backports hoary-backports-staging main universe multiverse restricted
3. Installing Beagle
Run these commands in a Terminal window to download and install Beagle and all the dependencies. You will recieve a messages about these packages being 'untrusted' but you can safely ignore this.
sudo apt-get update
sudo apt-get install beagle
4. Setting Up Your Filesystems To Be Indexed
To set your file system up to accept extended attributes you will have to edit /etc/fstab. This is needed in order to index your filesystems. Simply, add 'user_xattr' to the line refering to your home directory. On a default Ubuntu install this is done by changing the line that looks like the following:
/dev/hda1 / ext3 defaults,errors=remount-ro 0 1
To make it look like this:
/dev/hda1 / ext3 defaults,errors=remount-ro,user_xattr 0 1
When you are done editing the filesystem(s) you want then you need to remount the filesystem(s) using this comment for each file system you changed:
sudo mount -o remount /dev/hda1
Change the /dev/hda1 part with whatever partitions you selected.
5. Inotify - CAUTION
If you are using Beagle 0.0.8 or you have build your own kernel with inotify 0.21, you can enable inotify kernel support. You must have Hoary Final Release with the latest kernel installed as this is when inotify 0.18 support was added.PLEASE NOTE: When I enabled inotify, it broke my USB plug and play support so I wouldn't enabled it. It just means that you will loose some performance! This is a GNOME bug which should be fixed soon. I would recommend you DO NOT enable inotify until the bug is sorted. Proceed with caution.....
Edit /boot/grub/menu.lst.
find a line starting with "# nonaltoptions" and append inotify to it. Mine ends up like this:
# nonaltoptions=quiet splash inotify
then run sudo /sbin/update-grub to apply these options to all kernels. Reboot.
6. Address Book Bug
The Beagle 0.0.8 and 0.0.9 installations have a small bug which means that the Evolution address book can't be searched. You can fix it by:
cd /usr/lib
sudo ln -s libebook-1.2.so.3 libebook-1.2.so.0
7. Mozilla Extenstion
The Mozilla extension which works for both Mozilla and Mozilla Firefox isn't included with the packages so here is 'one that I made earlier'. You can download it from here http://www.trowbridge.org/beagle-on-debian/beagle.xpi (Thanks to Jon Trowbridge for hosting this). You can install it by going to File --> Open File and selecting the beagle.xpi file. You will need to restart your browser for this to take effect.
8. Beagle Web Services
The latest Ubuntu packages are now web services enabled which mean you can access Beagle from your web browser (and possibly from external sites if you do some router/modem configuration). You can access the page at:
http://localhost:8888/beagle/search.aspx (obviously changed localhost to your IP address of the machine you have Beagle on)
Before this will work, you need to add the --web-start extension when start beagled. See the next sections for more information on this. This page has loads of information on the web services.
9. Pool of Files to Index
Note that by default, everything gets indexed. To get results faster and to possibly get better stability (remember this is alpha software), it is recommended to make the pool of files to index smaller by defining the file .neverindex in your home directory.
cd
ls > .neverindex
Now edit the hidden file .neverindex and remove all directories/files you want to be indexed.
See How to index my data for more information on how to prevent files from being indexed.
10. Starting Beagle
You need start the Beagle daemon (beagled) which will index your data. The --web-start extention enables the Web Services section. You can do this, by running:
beagled --web-start
It is a good idea to start beagled with the debug options which makes it easier to find problems. You can do this by:
beagled --fg --debug --web-start
NOTE: When you restart, you will keep all of the indexed data! You can stop beagle by press Ctrl + C twice (you press it once and then some exiting text appears so it has been again).
11. Searching your Data
The most popular way of searching your data is to use the Best (Bleeding Edge Search Tool) which provides a sleek GTK interface. It should be in your Accessories --> Best. It will then appear in the notifitication area in the top right hand corner of the screen. You can get Best to run on boot by adding the option to run the command: 'best' at startup in the System --> Preferences --> Sessions.
12. Feedback
I (http://www.evolutioncolt.com) have added a lot to this page on the Wiki to make it a more comprehensive guide. Please email at spayne@evolutioncolt.com and tell me if it works, you've found some typos or if your're stuck. The IRC #dashboard channel on irc.gimp.net is very helpful and a lot of the Beagle and GNOME developers hang around here. You can find me here as HulaBeagleSeb
13. Questions and Answers
Q: Why can't I use inotify with Beagle 0.0.9?
A: Beagle 0.0.9 requires the inotify 0.22 patch whereas the standard Ubuntu kernel only has inotify 0.18. This means you can run Beagle without inotify (recommended) or make your own kernel with inotify 0.22 patch. Generally, Beagle 0.0.9 works well on a Athlon 2000+ system without inotify. The only disadvantage is that your data can take longer to index.
Q: I get an error like: "trying to overwrite `/usr/lib/mono', which is also in package ..." try
A: It seems a lot of packages provide a /usr/lib/mono symlink.You can solve this by running:
dpkg -i --force-overwrite /var/cache/apt/archives/mono-assemblies-base_1.1.4-1_all.deb
Q: Why does installing beagle on hoary pull in mozilla-browser? -- CraigBox
A: Best (the Beagle UI) uses Mozilla's Gecko HTML rendering widget.
Q: Can't it depend on mozilla | firefox then?
Q: When I run Best, I get an error saying the Beagle Daemon isn't installed. How do I start it?
A: You can start the Beagle Daemon by running this command in a Terminal window:
beagled
It is a good idea to start beagled with the debug options which makes it easier to find problems. You can do this by:
beagled --fg --debug
Q: In Evolution 2.2, I have an IMAPrev1 account and Beagle isn't indexing it. Why?
A: Beagle 0.0.8 does not have support for IMAPrev1. 0.0.9 (the current release) adds this support.
Q: I get the "Lock obtain timed out" exception - even though I'm running Mono 1.1.4. Any suggestions?
A: Solved after upgrading to 1.1.4-1.
14. Screenshots
See the offical page for shots here. Mine at the ones at www.sebgate.f2s.com running on Ubuntu Hoary Hedgehog Final Release.