Instiki
Troubleshooting (changes)

Showing changes from revision #7 to #8: Added | Removed

• if the following occurs when trying to start Instiki:

C:\instiki>ruby instiki
=> Starting Instiki on http://0.0.0.0:2500
=> Data files are stored in C:/instiki/storage/2500
C:/instiki/vendor/madeleine-0.7.1/lib/madeleine/zmarshal.rb:43:in `read': buffer
 error (Zlib::BufError)
        from C:/instiki/vendor/madeleine-0.7.1/lib/madeleine/zmarshal.rb:43:in `
load'
        from C:/instiki/vendor/madeleine- 0.7.1/lib/madeleine/automatic.rb:402:in
 `load'
        from C:/instiki/vendor/madeleine-0.7.1/lib/madeleine/automatic.rb:155:in
 `load'
        from C:/instiki/vendor/madeleine-0.7.1/lib/madeleine.rb:211:in.C:/instiki/vendor/madeleine-0.7.1/lib/madeleine.rb:211:in `recover_
snapshot'
        from C:/instiki/vendor/madeleine-0.7.1/lib/madeleine.rb:210:in `open_uri
_original_open'
        from c:/ruby/lib/ruby/1.8/open-uri.rb:87:in `open'
        from C:/instiki/vendor/madeleine- 0.7.1/lib/madeleine.rb:210:in `recover_
snapshot'
        from C:/instiki/vendor/madeleine-0.7.1/lib/madeleine.rb:53:in `new'
        from C:/instiki/vendor/madeleine-0.7.1/lib/madeleine/automatic.rb:272:in
 `initialize'
        from C:/instiki/app/models/wiki_service.rb:184:in `new'
        from C:/instiki/app/models/wiki_service.rb:184:in `initialize'
        from C:/instiki/app/models/wiki_service.rb:147:in `new'
        from C:/instiki/app/models/wiki_service.rb:147:in `instance'
        from ./script/server:91
        from instiki:6:in `load'
        from instiki:6

C:\instiki>




then there may be a problem where the snapshot file (essentially a zip file) is corrupted. The file is unopenable by zlib-based
decompression, but you should be able to open it in another zip
program like 7zip (www.7-zip.org).

Go to the storage directory and try to open the latest (highest
number) .snapshot file with it. it will have an annonymous content
file. you can extract this and rezip it (in a “gz” format) and then
use it as normal. Needless to say, backup everything before you try

If that doesn’t work, try deleting the .command_log files and the
latest snapshot. You’ll lose some recent information, but you’ll be
able to get an older version of the data.

thanks to Assaph

1. Upgrade instructions

Hi all, I’ve been running 0.10.2 and am trying to upgrade to 0.11.0 to no avail.
Without even getting to data migration, when I run instiki all I get is a blank page (no HTML rendered at all). When I telet to port 2500, it responds (e.g. BLAH —> page not found).

Other problems:

1. rake migrate

does not appear to have the correct permissions. I’ve tried sqlite (i.e. not changing any settings at all) and mysql. The mysql account is correct (set up in config/database.yml and verified via mysql cli)

So I’m not sure how this is supposed to be used. I had simply copied the ‘storage’ directory over from the previous (0.10.2) install.

root@dev:~/downloads/instiki-0.11.0# rake migrate
(in /home/*****/downloads/instiki-0.11.0)
rake aborted!
Access denied for user: 'root@localhost' (Using password: NO)

(See full trace by running task with --trace)

-- Full Trace --
root@dev:~/downloads/instiki-0.11.0# rake migrate --trace
(in /home/user/downloads/instiki-0.11.0)
** Invoke migrate (first_time)
** Invoke environment (first_time)
** Execute environment
** Execute migrate
rake aborted!
Access denied for user: 'root@localhost' (Using password: NO)
/home/user/downloads/instiki-0.11.0/vendor/rails/activerecord/lib/active_record/connection_adapters/mysql_adapter.rb:316:in `real_connect'
/home/user/downloads/instiki-0.11.0/vendor/rails/activerecord/lib/active_record/connection_adapters/mysql_adapter.rb:316:in `connect'
/home/user/downloads/instiki-0.11.0/vendor/rails/activerecord/lib/active_record/connection_adapters/mysql_adapter.rb:87:in `initialize'
/home/user/downloads/instiki-0.11.0/vendor/rails/activerecord/lib/active_record/connection_adapters/mysql_adapter.rb:37:in `new'
/home/user/downloads/instiki-0.11.0/vendor/rails/activerecord/lib/active_record/connection_adapters/mysql_adapter.rb:37:in `mysql_connection'
/home/user/downloads/instiki-0.11.0/vendor/rails/activerecord/lib/active_record/connection_adapters/abstract/connection_specification.rb:145:in `send'
/home/user/downloads/instiki-0.11.0/vendor/rails/activerecord/lib/active_record/connection_adapters/abstract/connection_specification.rb:145:in `connection_without_query_cache='
/home/user/downloads/instiki-0.11.0/vendor/rails/activerecord/lib/active_record/query_cache.rb:54:in `connection='
/home/user/downloads/instiki-0.11.0/vendor/rails/activerecord/lib/active_record/connection_adapters/abstract/connection_specification.rb:106:in `retrieve_connection'
/home/user/downloads/instiki-0.11.0/vendor/rails/activerecord/lib/active_record/connection_adapters/abstract/connection_specification.rb:20:in `connection'
/home/user/downloads/instiki-0.11.0/vendor/rails/activerecord/lib/active_record/migration.rb:178:in `migrate'
/home/user/downloads/instiki-0.11.0/vendor/rails/railties/lib/tasks/databases.rake:3
/home/user/downloads/instiki-0.11.0/vendor/rails/railties/lib/tasks/databases.rake:2:in `call'
/usr/lib/ruby/gems/1.8/gems/rake-0.7.0/lib/rake.rb:232:in `execute'
/usr/lib/ruby/gems/1.8/gems/rake-0.7.0/lib/rake.rb:232:in `each'
/usr/lib/ruby/gems/1.8/gems/rake-0.7.0/lib/rake.rb:232:in `execute'
/usr/lib/ruby/gems/1.8/gems/rake-0.7.0/lib/rake.rb:202:in `invoke'
/usr/lib/ruby/gems/1.8/gems/rake-0.7.0/lib/rake.rb:195:in `synchronize'
/usr/lib/ruby/gems/1.8/gems/rake-0.7.0/lib/rake.rb:195:in `invoke'
/usr/lib/ruby/gems/1.8/gems/rake-0.7.0/lib/rake.rb:1719:in `run'
/usr/lib/ruby/gems/1.8/gems/rake-0.7.0/lib/rake.rb:1719:in `each'
/usr/lib/ruby/gems/1.8/gems/rake-0.7.0/lib/rake.rb:1719:in `run'
/usr/lib/ruby/gems/1.8/gems/rake-0.7.0/bin/rake:7
/usr/bin/rake:18:in `load'
/usr/bin/rake:18

So I’m after solutions to the above problems, but specifically upgrade instructions.

Install Instiki 0.11 on Cygwin

---

The Cygwin version of the sqlite3 DLL is not provided with the Instiki distribution. If you try to use the native Win32 DLL, all you’ll get is a blank page. So, you need to do the following to make Instiki work.
Get sqlite sources.
Compile it as said in README.
To generate the shared library explicitly, we need to do:

make sqlite3.dll

Then, install the library:

mkdir /path/to/instiki/lib/native/i386-cygwin
cp sqlite3.dll /path/to/instiki/lib/native/i386-cygwin/

Update /path/to/instiki/vendor/sqlite3-ruby/sqlite3/driver/dl/api.rb to add:

when /i386-cygwin/
  "sqlite3.dll"

where the sqlite library is dynamically loaded.

Start instiki on Cygwin

---

cd /path/to/instiki

export PATH=./lib/native/i386-cygwin:$PATH

instiki -b localhost