Topic: Troubleshooting
Topic Type: Topic
Helpful hints if things go wrong with your installation.
Originally written by Walter McGinnis, Kete Project Lead for Katipo Communications, Ltd.
Part of the Installation Guide
For other troubleshooting tips, be sure to look in Related Topics below.
Zebra Related Issues
Problem
After installation, on my "Browse" or search results pages, the links to items are go to "http://10.0.0.1/site/topics/show/13-welcome" for example. In other words, they are broken. If I create a new topic or item though, the link for it is correct.
or
After installation you got to "Browse" or search results and you get an error like Connection Error (109).
Solution
You probably forgot to restart your Kete server before "priming the search engine" or the priming didn't work / was incomplete. Zebra, the search engine, was thus fed bad versions of the default topics and items. You'll need to clean out and reprime the search engine. This fix will work if your zebra search index gets out of sync for any reason, though if you have a large amount of records (2,000+) it may be impractical.
On Kete 1.1 or later
Kete 1.1 introduced a new web based Zebra search engine priming tool that technical administrators of the site can use to quick rebuild Zerba and solve issues. To use this, login as a user with the "tech admin" role, navigate to the "Administrators Toolbox" > "Rebuild search databases" > and configure what you need.
You may want to specify "skip private records" if your don't have any private versions of your items, but otherwise the default options will be ok. This will now initialize you search database (clear it out), restart it, and run through all items in every basket and add it to the Zebra database. When it's done, you can try Browse again.
On Kete 1.0 or earlier
Prior to Kete 1.1, rebuilding the zoom database had to be done manually by stopping the old zebra, starting, initializing it, loading default records, and manully entering rebuild URL's. Here are the steps to do that.
$ ps aux | grep zebra
kete [zebra_process_id] 0.0 0.0 78612 508 ?? Ss 2:00pm 0:00.00 zebrasrv -f conf/kete-zebra-servers.xml -l /Users/kete/apps/your_app/log/zebra.log -p /Users/kete/apps/your_app/log/zebra.pid -D
$ sudo kill [zebra_process_id] # if there is no zebra process running, ignore this step
$ rake zebra:start
$ rake zebra:init
$ rake zebra:init ZEBRA_DB=private
$ rake zebra:load_initial_recordsNow make sure you are logged into the site as as the default administrator or an account that has been designated as a "tech admin" and visit the following URLs (adjust for your site's URL) and let them click over (ajax update of page) until you get a "done". Replace your_site_domain with the url of your Kete installation.
your_site_domain/site/search/rebuild_zoom_index?skip_existing=false your_site_domain/site/search/rebuild_zoom_index?skip_existing=false&zoom_class=StillImage your_site_domain/site/search/rebuild_zoom_index?skip_existing=false&zoom_class=AudioRecording your_site_domain/site/search/rebuild_zoom_index?skip_existing=false&zoom_class=Video your_site_domain/site/search/rebuild_zoom_index?skip_existing=false&zoom_class=WebLink your_site_domain/site/search/rebuild_zoom_index?skip_existing=false&zoom_class=Document your_site_domain/site/search/rebuild_zoom_index?skip_existing=false&zoom_class=Comment
Once that's done, double check that search results are good to go by clicking on "Browse" from any page or doing a search
- Created by: Walter McGinnis
- Last Edited by: Walter McGinnis
- Last Edited: 28/08/2008 06:15
Discuss This Topic
There are 8 comments in this discussion.
Read and join this discussion
Joe Atzberger said Zebra problems underlying
Both errors above are related to zebra. For whatever reason, I don't seem to get zebra to pull the correct keteaccess up. I get rejected using the correct creds w/ yazclient. Here's 4 commands:
- netstat showing zebra listening;
- ps showing zebrasrv running;
- cat the keteaccess file;
- yaz-client connection attempt w/ keteaccess and port info.
kete@kohavm77:~/apps/kete_stable_dev$ netstat -a | grep 9001
tcp6 0 0 *:9001 *:* LISTEN
kete@kohavm77:~/apps/kete_stable_dev$ ps -ef | grep zebra
kete 5562 1 0 10:36 ? 00:00:00 zebrasrv -f conf/kete-zebra-servers.xml -l /home/kete/apps/kete_trunk_dev/log/zebra.log -p /home/kete/apps/kete_trunk_dev/log/zebra.pid -D
kete 5756 1 0 11:14 ? 00:00:00 zebrasrv -f conf/kete-zebra-servers.xml -l /home/kete/apps/kete_stable_dev/log/zebra.log -p /home/kete/apps/kete_stable_dev/log/zebra.pid -D
kete 6055 3164 0 12:10 pts/0 00:00:00 grep zebra
kete@kohavm77:~/apps/kete_stable_dev$ cat zebradb/keteaccess
kete:ub3r
kete@kohavm77:~/apps/kete_stable_dev$ yaz-client -u kete:ub3r localhost:9001
Authentication set to Open (kete:ub3r)
Connecting...OK.
Sent initrequest.
Connection rejected by v3 target.
ID : 81
Name : Zebra Information Server/GFS/YAZ
Version: 2.0.26/1.128/3.0.26
Init response contains 1 otherInfo unit:
1: otherInfo unit contains 1 diagnostic:
1: code=1011 (Init/AC: Bad Userid and/or Password),
addinfo=''
Options: search present delSet triggerResourceCtrl scan sort extendedServices namedResultSets negotiationModel
Accepted character set : UTF-8
Accepted code language : none
Accepted records in ...: 0
Converting between UTF-8 and UTF-8
Elapsed: 0.006869
Joe Atzberger said Use / not : on command line
Walter McGinnis said Re: Zebra problems underlying
I suspect that you are using a later version of YAZ and Zebra than is specified in the installation guide. See this comment for details:
http://kete.net.nz/documentation/topics/show/115-preinstall-assumptions#comment-51
Please confirm that you are using the correct versions of YAZ and Zebra.
I hope that we will be able to move to latest versions of Zebra and YAZ in Kete 1.1 or 1.2.
Cheers,
Walter
Joe Atzberger said XML error in rebuild_zoom_index?
So when I go to:
site/search/rebuild_zoom_index?skip_existing=false
What does a user do if they get:
XML Parsing Error: mismatched tag. Expected: </div>.
Location: http://kete.liblime.com/site/search/rebuild_zoom_index?skip_existing=false
Line Number 120, Column 3:</body>
--^
The last time I saw this problem it was related to zebra, but my fixes from last time aren't doing the trick here.
Tags: XML Parsing Error.
Walter McGinnis said Quick Answer
You can work around this error by using Safari browsing in the near term. Sorry, I am at a conference and can't fix the actual bug.
Update 2008-04-09: This bug has been fix in the 1-0-stable branch and will be in trunk soon, too. So shouldn't be an issue anymore.
Tags: Zebra, rebuild_zoom_index, priming, prime
mschell said Missing Source File
I finished the install and browsed to my kete installation and got this error:
I installed RMagick : gem install rmagick
but this did nothing.
If I remove the require RMagick line from the account_controller.rb file it still gives me an error to install RMagick.
Also when I do a dpkg -l | grep magick I only see; imagemagick, libmagick9, and libmagick9-dev.
Not sure what I am missing or if the above info will help
MissingSourceFile in AccountController#login
no such file to load -- RMagick
RAILS_ROOT: /home/mschell/apps/kete
/usr/local/lib/site_ruby/1.8/rubygems/custom_require.rb:27:in `gem_original_require'
/usr/local/lib/site_ruby/1.8/rubygems/custom_require.rb:27:in `require'
vendor/rails/activesupport/lib/active_support/dependencies.rb:496:in `require'
vendor/rails/activesupport/lib/active_support/dependencies.rb:342:in `new_constants_in'
vendor/rails/activesupport/lib/active_support/dependencies.rb:496:in `require'
app/controllers/account_controller.rb:1
vendor/rails/activesupport/lib/active_support/dependencies.rb:203:in `load_without_new_constant_marking'
vendor/rails/activesupport/lib/active_support/dependencies.rb:203:in `load_file'
vendor/rails/activesupport/lib/active_support/dependencies.rb:342:in `new_constants_in'
vendor/rails/activesupport/lib/active_support/dependencies.rb:202:in `load_file'
vendor/rails/activesupport/lib/active_support/dependencies.rb:94:in `require_or_load'
vendor/rails/activesupport/lib/active_support/dependencies.rb:248:in `load_missing_constant'
vendor/rails/activesupport/lib/active_support/dependencies.rb:453:in `const_missing'
vendor/rails/activesupport/lib/active_support/dependencies.rb:465:in `const_missing'
vendor/rails/activesupport/lib/active_support/inflector.rb:257:in `constantize'
vendor/rails/activesupport/lib/active_support/core_ext/string/inflections.rb:148:in `constantize'
vendor/rails/actionpack/lib/action_controller/routing.rb:1426:in `recognize'
vendor/rails/actionpack/lib/action_controller/dispatcher.rb:170:in `handle_request'
vendor/rails/actionpack/lib/action_controller/dispatcher.rb:115:in `dispatch'
vendor/rails/actionpack/lib/action_controller/dispatcher.rb:126:in `dispatch_cgi'
vendor/rails/actionpack/lib/action_controller/dispatcher.rb:9:in `dispatch'
/usr/lib/ruby/gems/1.8/gems/mongrel-1.1.4/lib/mongrel/rails.rb:76:in `process'
/usr/lib/ruby/gems/1.8/gems/mongrel-1.1.4/lib/mongrel/rails.rb:74:in `synchronize'
/usr/lib/ruby/gems/1.8/gems/mongrel-1.1.4/lib/mongrel/rails.rb:74:in `process'
/usr/lib/ruby/gems/1.8/gems/mongrel-1.1.4/lib/mongrel.rb:159:in `process_client'
/usr/lib/ruby/gems/1.8/gems/mongrel-1.1.4/lib/mongrel.rb:158:in `each'
/usr/lib/ruby/gems/1.8/gems/mongrel-1.1.4/lib/mongrel.rb:158:in `process_client'
/usr/lib/ruby/gems/1.8/gems/mongrel-1.1.4/lib/mongrel.rb:285:in `run'
/usr/lib/ruby/gems/1.8/gems/mongrel-1.1.4/lib/mongrel.rb:285:in `initialize'
/usr/lib/ruby/gems/1.8/gems/mongrel-1.1.4/lib/mongrel.rb:285:in `new'
/usr/lib/ruby/gems/1.8/gems/mongrel-1.1.4/lib/mongrel.rb:285:in `run'
/usr/lib/ruby/gems/1.8/gems/mongrel-1.1.4/lib/mongrel.rb:268:in `initialize'
/usr/lib/ruby/gems/1.8/gems/mongrel-1.1.4/lib/mongrel.rb:268:in `new'
/usr/lib/ruby/gems/1.8/gems/mongrel-1.1.4/lib/mongrel.rb:268:in `run'
/usr/lib/ruby/gems/1.8/gems/mongrel-1.1.4/lib/mongrel/configurator.rb:282:in `run'
/usr/lib/ruby/gems/1.8/gems/mongrel-1.1.4/lib/mongrel/configurator.rb:281:in `each'
/usr/lib/ruby/gems/1.8/gems/mongrel-1.1.4/lib/mongrel/configurator.rb:281:in `run'
/usr/lib/ruby/gems/1.8/gems/mongrel-1.1.4/bin/mongrel_rails:128:in `run'
/usr/lib/ruby/gems/1.8/gems/mongrel-1.1.4/lib/mongrel/command.rb:212:in `run'
/usr/lib/ruby/gems/1.8/gems/mongrel-1.1.4/bin/mongrel_rails:281
/usr/bin/mongrel_rails:19:in `load'
/usr/bin/mongrel_rails:19
This error occurred while loading the following files:
RMagick
Request
Parameters:
{"urlified_name"=>"site"} ---
:return_to_title:
:site_admin:
:user:
flash: !map:ActionController::Flash::FlashHash {}
:return_to: /
Response
Headers:
{"cookie"=>[],
"Cache-Control"=>"no-cache"}
Walter McGinnis said Re: Missing Source File
Hi mschell,
The Debian install can be funky because of Ruby Gems and Debian packaging philosophy differences. In other words you can get things in an inconsistent state pretty easily. So tread carefully.
First, lets make sure you don't have any Rmagick on the system. During our normal installation we usually install Rmagick with apt-get.
Run this to see if you have that package:
dpkg -l librmagick-ruby1.8
You shouldn't have the gem installed directly. In other words "gem list RMagick" shouldn't return a result. If it does, there may be a conflict.
If neither of the above return anything, I would recommend running this step from the installation guide again:
apt-get install librmagick-ruby1.8 librmagick-ruby-doc
and then restart your server and see if that does the trick.
Let us know if that works or doesn't.
Good luck,
Walter
Tags: Installation, Rmagick, Troubleshooting
Joe Atzberger said XML error
When I request the first link in "stable", I get an XML error.
XML Parsing Error: mismatched tag. Expected: </div>.
Location: http://kete.liblime.com/site/search/rebuild_zoom_index?skip_existing=false
Line Number 120, Column 3:
</body>
--^
When I try it on "trunk", I get:
NoMethodError in SearchController#rebuild_zoom_index
RAILS_ROOT: /home/kete/apps/kete_trunk_dev
Request
Parameters:
{"skip_existing"=>"false","urlified_name"=>"site"}
Show session dump
--- :skip_existing: "false" :record_count: 0 :return_to: / :site_admin: true :done: false :user: 1 :return_to_title: Welcome :number_of_results_per_page: 10 :start_id: 1 :last: 1 :zoom_db: :zoom_class: Topic :end_id: end flash: !map:ActionController::Flash::FlashHash {}Response
Headers:
{"Status"=>"200 OK","cookie"=>[],
"Content-Type"=>"text/xml",
"Cache-Control"=>"no-cache"}