Bug 24748

Summary: Workaround to enable installation of 19.11 on Debian 9 is missing from install docs
Product: Koha Reporter: Dwight Tuinstra <dwight.tuinstra>
Component: DocumentationAssignee: Bugs List <koha-bugs>
Status: CLOSED FIXED QA Contact: Testopia <testopia>
Severity: major    
Priority: P5 - low    
Version: 19.11   
Hardware: All   
OS: All   
GIT URL: Initiative type: ---
Sponsorship status: --- Comma delimited list of Sponsors:
Crowdfunding goal: 0 Crowdfunding committed: 0
Crowdfunding contact: Patch complexity: ---
Documentation contact: Documentation submission:
Text to go in the release notes:
Version(s) released in:
Circulation function:

Description Dwight Tuinstra 2020-02-27 17:51:13 UTC
This bug relates to these installation documents:
  - https://wiki.koha-community.org/wiki/Preparing_your_system
  - https://wiki.koha-community.org/wiki/Koha_on_Debian

Since installation on Debian 10 is currently discouraged, I attempted a koha install on a fresh instance of Debian 9, 64-bit (i686) architecture.

The problem occurs at the "Install Koha" step (https://wiki.koha-community.org/wiki/Koha_on_Debian#Install_Koha). The command "apt-get install koha-common" fails with the following error message:

    Reading package lists... Done
    Building dependency tree       
    Reading state information... Done
    Some packages could not be installed. This may mean that you have
    requested an impossible situation or if you are using the unstable
    distribution that some required packages have not yet been created
    or been moved out of Incoming.
    The following information may help to resolve the situation:

    The following packages have unmet dependencies:
    koha-common : Depends: libnet-oauth2-authorizationserver-perl but it is not going to be installed
    E: Unable to correct problems, you have held broken packages.

This is a known problem, mentioned in bug 23128 (https://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=23128). The workaround that is suggested there is to enable Debian 9 backports, as follows:

    1) Create /etc/apt/sources.list.d/stretch-backports.list with this line:
        deb http://deb.debian.org/debian stretch-backports main
    2) Run apt-get update

Running "apt-get install koha-common" will then work.

This workaround should be incorporated into the "Koha on Debian" document. Without it, installation fails.
Comment 1 Dwight Tuinstra 2020-03-11 02:13:58 UTC
I signed up for wiki access and changed the "Koha on Debian" document so it now has instructions for including stretch backports.

Marking this RESOLVED as it fixes a documentation bug; however the underlying problem in bug 23128 is still out there.