Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Auto-install latest/official kiwix-tools + tighten up code #3391

Merged
merged 6 commits into from Oct 5, 2022

Conversation

holta
Copy link
Member

@holta holta commented Oct 4, 2022

Instead of IIAB having to hard-code and host a new version of kiwix-tools every month or so:

  1. This makes installing the lastest/official kiwix-tools release automatic, based on Kiwix's permalink redirects:
  2. Bonus it's now easier to quickly update to the very latest official kiwix-tools release (if any IIAB implementer wants that pre-flight / pre-deployment). It's now as easy as running:
    cd /opt/iiab/iiab
    sudo ./runrole --reinstall kiwix
    
  3. Specific versions of kiwix-tools can now be hard-coded even more easily than in the past, by hand editing /opt/iiab/iiab/roles/kiwix/defaults/main.yml that explains your options much more clearly — e.g. during regression testing (progress testing!) comparing different versions of kiwix-tools, etc.

RECAP: As usual, this installs kiwix-tools' 3 executables {kiwix-manage, kiwix-search, kiwix-serve} into /opt/iiab/kiwix/bin but does it in a more compact and automated way than in the past.

Tested on Ubuntu 22.10 (pre-release).

Not a big deal, but a Caveat: downloading of kiwix-tools will occasionally now take a bit longer (e.g. sometimes a full minute) as Kiwix download mirrors can be quite scattershot. These inconsistent results appear to be luck of the draw (very random) from my experience, probably based Kiwix's "round robin" mirror server rotation that's quite a familiar issue over recent years.

Building on:

@holta holta added this to the 8.0 milestone Oct 4, 2022
@holta
Copy link
Member Author

holta commented Oct 5, 2022

Further testing will be very useful to confirm across all sorts of scenarios in coming days.

Thanks all who can help.

Also after kiwix-tools 3.3.1 is released in a few short days:

@holta holta requested a review from deldesir October 5, 2022 00:27
@holta
Copy link
Member Author

holta commented Oct 5, 2022

Thanks to @deldesir who tested this on Debian 11 (Bullseye) on an x86_64 VM (with graphical desktop).

Copy link
Contributor

@deldesir deldesir left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Works perfectly on Ubuntu 22.10 and Debian 11.

@holta
Copy link
Member Author

holta commented Oct 5, 2022

Many Thanks @deldesir:

  1. I've cleaned up the upgrade path, to move /opt/iiab/kiwix/bin aside (if it already exists)
  2. Further tested on "Raspberry Pi OS with desktop"
  3. Inline docs much improved
  4. Good Enough!

@holta
Copy link
Member Author

holta commented Dec 5, 2022

Very useful kiwix-serve pre-doc, thanks to Renaud Gaudin:

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Development

Successfully merging this pull request may close these issues.

None yet

2 participants