Add installation instructions for UTF-8 database requirement to README

Bug #1692360 reported by Karl-Philipp Richter
6
This bug affects 1 person
Affects Status Importance Assigned to Milestone
Mahara
Fix Released
Low
Kristina Hoeppner

Bug Description

README contains the instruction to install a MySQL or PostgreSQL database only, however after setting up a MySQL 5.7.18-0ubuntu0.17.04.1 scheme, I get the message `You are not using a UTF-8 database. Mahara stores all data as UTF-8 internally. Please drop and re-create your database using UTF-8 encoding.`. Both README and the message should contain information (text or a link) how to setup such an UTF-8 database.

This is not a support request to fix this for me, but an improvement suggestion to get this fixed for anybody.

experienced with 1.8RC2_RELEASE-4940-g8bd74fdbf on Ubuntu 17.04

Revision history for this message
Kristina Hoeppner (kris-hoeppner) wrote :

Hi Karl,

The Readme file includes a link to the installation instructions where there is a section on the database: https://wiki.mahara.org/index.php/System_Administrator's_Guide/Installing_Mahara#Create_the_Database

Does that resolve your question on how to set up a UTF-8 database or would more information be necessary?

Cheers
Kristina

Changed in mahara:
status: New → Incomplete
Revision history for this message
Karl-Philipp Richter (krichter722) wrote :

I overread that easily, but that's my fault. Please see whether you think that https://github.com/MaharaProject/mahara/pull/6 could help.

Changed in mahara:
status: Incomplete → In Progress
importance: Undecided → Low
milestone: none → 17.10.0
assignee: nobody → Kristina Hoeppner (kris-hoeppner)
Revision history for this message
Mahara Bot (dev-mahara) wrote : A patch has been submitted for review

Patch for "master" branch: https://reviews.mahara.org/7774

Revision history for this message
Kristina Hoeppner (kris-hoeppner) wrote :

I made a slightly different change to keep the list short and adding one line for the DB would have had to result in also mentioning the installation instructions again for the other steps.

https://git.mahara.org/mahara/mahara/commit/7531ebcd14dc1a2de7bae619cda17cc329eff483

Changed in mahara:
status: In Progress → Fix Committed
Revision history for this message
Mahara Bot (dev-mahara) wrote : A change has been merged

Reviewed: https://reviews.mahara.org/7774
Committed: https://git.mahara.org/mahara/mahara/commit/7531ebcd14dc1a2de7bae619cda17cc329eff483
Submitter: Robert Lyon (<email address hidden>)
Branch: master

commit 7531ebcd14dc1a2de7bae619cda17cc329eff483
Author: Kristina D.C. Hoeppner <email address hidden>
Date: Tue May 23 08:52:15 2017 +1200

Bug 1692360: Re-iterate installation instructions

State that the steps are more of a checklist to
encourage readers to read the full installation
instructions.

Change-Id: Ia862a21a7ac30a1ff55c63f6fb261e86e9d5ea21
behatnotneeded: Just update to the Readme file

Robert Lyon (robertl-9)
Changed in mahara:
status: Fix Committed → Fix Released
To post a comment you must log in.
This report contains Public information  
Everyone can see this information.

Other bug subscribers

Remote bug watches

Bug watches keep track of this bug in other bug trackers.