New User Trying to Run Koha as Localhost
Hello everyone, I am trying to install and run Koha on my laptop at home. My laptop has Ubuntu 16.04 and Windows 10 installed on it with a dual boot option. I am a computer programmer who has worked on a browser based library management system in the past so I am familiar with most of the concepts and steps here. Although the system I worked on only ran on Windows we did use Apache on some sites so I am also familiar with configuring Apache. My intention is to initially run it on my computer as "localhost" while I familiarise myself with it. I have gone through the process of installation as detailed on wiki.koha-community.org/wiki/Debian without error as far as: "Access the web interface". So to summarise my system has: Ubuntu 16.04 LTSKoha 18.11 current stableMySQL database I have completed the following steps without error: 1. Install Koha2. Install the database (MySQL)3. Configure the defaults4. Create a Koha instance The next step "Access the web interface" did not work. At this point I get the standard 'Apache2 Ubuntu Default Page' telling me that Apache is working but the site may be down for maintenance etc. My koha-sites.conf file has:DOMAIN=".localhost" It seems to me that there is a configuration directive to find the Koha default.html or index.html that is missing or looking in the wrong place. Can anyone help me find where this configuration directive is or tell me what I'm doing wrong. I imagine it is something very simple. Thank you very much
Excerpts from Steven Hill's message of 2019-02-20 08:08:50 +0000:
The next step "Access the web interface" did not work. At this point I get the standard 'Apache2 Ubuntu Default Page' telling me that Apache is working but the site may be down for maintenance etc.
There are several things you might want to check. Look at /etc/apache2/sites-available/INSTANCE.conf, where INSTANCE is your Koha instance name. In particular, check the port numbers in the VirtualHost lines. Make sure that those ports are listed in separate Listen statements in /etc/apache2/ports.conf . Then check the port number in /etc/apache2/sites-available/000-default.conf, by examining the VirtualHost line. It will probably be port 80, and if that is the same as one of the ports used by Koha, you'll either need to change the ports used by Koha, or disable 000-default.conf by using the a2dissite command. Make sure that the Koha site is enabled by using the a2ensite command. You'll need to restart Apache after making any configuration changes. This is probably done using 'systemctl restart apache2'. (I hope this helps, but I'm not an Apache expert, and all of my experience is on Debian 8/9, so I may have missed something specific or relevant to Apache or Ubuntu in the above.)
The next step "Access the web interface" did not work. At this point I get the standard 'Apache2 Ubuntu Default Page' telling me
I'd say the key here is not to think about it as a Koha problem so much as an Apache problem. If you're getting the default "Apache2 Ubuntu Default Page" page, that just means that Apache can't match the hostname you're supplying with the ServerName directive in the VirtualHost found in a configuration file in /etc/apache2/sites-available/<INSTANCE>.conf file. (Disabling the 000-default.conf file might work but that just means Apache is blindly handing your Koha site out as the default site on port 80. I wouldn't recommend doing that.) Take a look at your /etc/apache2/sites-available/<INSTANCE>.conf file and double-check the ServerName directive. You can either change the directive there or you can try to change the koha-sites.conf file and re-create your instance. Based on your description, I'm guessing your ServerName is going to be something like "INSTANCE.localhost" and you're going to "localhost" or "localhost.localhost" in the browser? You can either change the ServerName or you could add "INSTANCE.localhost" to your /etc/hosts so that it resolves correctly. (Although keep in mind it'll only work on your machine.) For what it's worth, this is the step that trips up everybody new to Koha. David Cook Systems Librarian Prosentient Systems 72/330 Wattle St Ultimo, NSW 2007 Australia Office: 02 9212 0899 Direct: 02 8005 0595 -----Original Message----- From: koha-devel-bounces@lists.koha-community.org [mailto:koha-devel-bounces@lists.koha-community.org] On Behalf Of Mark Alexander Sent: Thursday, 21 February 2019 5:26 AM To: koha-devel <koha-devel@lists.koha-community.org> Subject: Re: [Koha-devel] New User Trying to Run Koha as Localhost Excerpts from Steven Hill's message of 2019-02-20 08:08:50 +0000: that Apache is working but the site may be down for maintenance etc. There are several things you might want to check. Look at /etc/apache2/sites-available/INSTANCE.conf, where INSTANCE is your Koha instance name. In particular, check the port numbers in the VirtualHost lines. Make sure that those ports are listed in separate Listen statements in /etc/apache2/ports.conf . Then check the port number in /etc/apache2/sites-available/000-default.conf, by examining the VirtualHost line. It will probably be port 80, and if that is the same as one of the ports used by Koha, you'll either need to change the ports used by Koha, or disable 000-default.conf by using the a2dissite command. Make sure that the Koha site is enabled by using the a2ensite command. You'll need to restart Apache after making any configuration changes. This is probably done using 'systemctl restart apache2'. (I hope this helps, but I'm not an Apache expert, and all of my experience is on Debian 8/9, so I may have missed something specific or relevant to Apache or Ubuntu in the above.) _______________________________________________ Koha-devel mailing list Koha-devel@lists.koha-community.org http://lists.koha-community.org/cgi-bin/mailman/listinfo/koha-devel website : http://www.koha-community.org/ git : http://git.koha-community.org/ bugs : http://bugs.koha-community.org/
participants (3)
-
David Cook -
Mark Alexander -
Steven Hill