<html xmlns:v="urn:schemas-microsoft-com:vml" xmlns:o="urn:schemas-microsoft-com:office:office" xmlns:w="urn:schemas-microsoft-com:office:word" xmlns:m="http://schemas.microsoft.com/office/2004/12/omml" xmlns="http://www.w3.org/TR/REC-html40"><head><meta http-equiv=Content-Type content="text/html; charset=utf-8"><meta name=Generator content="Microsoft Word 15 (filtered medium)"><style><!--
/* Font Definitions */
@font-face
{font-family:"Cambria Math";
panose-1:2 4 5 3 5 4 6 3 2 4;}
@font-face
{font-family:Calibri;
panose-1:2 15 5 2 2 2 4 3 2 4;}
/* Style Definitions */
p.MsoNormal, li.MsoNormal, div.MsoNormal
{margin:0cm;
margin-bottom:.0001pt;
font-size:12.0pt;
font-family:"Times New Roman",serif;}
a:link, span.MsoHyperlink
{mso-style-priority:99;
color:blue;
text-decoration:underline;}
a:visited, span.MsoHyperlinkFollowed
{mso-style-priority:99;
color:purple;
text-decoration:underline;}
span.EmailStyle17
{mso-style-type:personal-reply;
font-family:"Calibri",sans-serif;
color:#1F497D;}
.MsoChpDefault
{mso-style-type:export-only;
font-family:"Calibri",sans-serif;
mso-fareast-language:EN-US;}
@page WordSection1
{size:612.0pt 792.0pt;
margin:72.0pt 72.0pt 72.0pt 72.0pt;}
div.WordSection1
{page:WordSection1;}
--></style><!--[if gte mso 9]><xml>
<o:shapedefaults v:ext="edit" spidmax="1026" />
</xml><![endif]--><!--[if gte mso 9]><xml>
<o:shapelayout v:ext="edit">
<o:idmap v:ext="edit" data="1" />
</o:shapelayout></xml><![endif]--></head><body lang=EN-AU link=blue vlink=purple><div class=WordSection1><p class=MsoNormal><span style='font-size:11.0pt;font-family:"Calibri",sans-serif;color:#1F497D;mso-fareast-language:EN-US'>Hi David,<o:p></o:p></span></p><p class=MsoNormal><span style='font-size:11.0pt;font-family:"Calibri",sans-serif;color:#1F497D;mso-fareast-language:EN-US'><o:p> </o:p></span></p><p class=MsoNormal><span style='font-size:11.0pt;font-family:"Calibri",sans-serif;color:#1F497D;mso-fareast-language:EN-US'>I’m going to leave most of these questions for Kyle and Tomas, since they relate directly to koha-testing-docker, and I don’t have enough experience with it yet.<o:p></o:p></span></p><p class=MsoNormal><span style='font-size:11.0pt;font-family:"Calibri",sans-serif;color:#1F497D;mso-fareast-language:EN-US'><o:p> </o:p></span></p><p class=MsoNormal><span style='font-size:11.0pt;font-family:"Calibri",sans-serif;color:#1F497D;mso-fareast-language:EN-US'>However, I have been using Docker more and more, and my advice would be to just practice and try things out. <o:p></o:p></span></p><p class=MsoNormal><span style='font-size:11.0pt;font-family:"Calibri",sans-serif;color:#1F497D;mso-fareast-language:EN-US'><o:p> </o:p></span></p><p class=MsoNormal><span style='font-size:11.0pt;font-family:"Calibri",sans-serif;color:#1F497D;mso-fareast-language:EN-US'>For instance, the other day I wanted to try out <a href="https://github.com/UniversalViewer/uv-hello-world">https://github.com/UniversalViewer/uv-hello-world</a>, so I just started a Docker container using a small generic Ubuntu image and did my work in there. I didn’t even bother making a Dockerfile in order to make my own image. I just created a container as a sort of workspace. Once I’d tried out the software, I exited and let the container destroy itself. I had to play with the options a bit (like --rm and -p) to get what I wanted, but it was such a basic use case that it was really easy to see what was going on. <o:p></o:p></span></p><p class=MsoNormal><span style='font-size:11.0pt;font-family:"Calibri",sans-serif;color:#1F497D;mso-fareast-language:EN-US'><o:p> </o:p></span></p><p class=MsoNormal><span style='font-size:11.0pt;font-family:"Calibri",sans-serif;color:#1F497D;mso-fareast-language:EN-US'>Jessie Frazelle used to maintain the Docker core and I love this blog post of hers: <a href="https://blog.jessfraz.com/post/docker-containers-on-the-desktop/">https://blog.jessfraz.com/post/docker-containers-on-the-desktop/</a>. It inspired me to use a Docker container for running the Arduino IDE on my Debian desktop at home. I haven’t shared my Dockerfile and scripts yet for that, but you can find something similar at <a href="https://github.com/tombenke/darduino">https://github.com/tombenke/darduino</a>. Btw, Jessie Frazelle is funny, nice, and really smart. Worth reading her blog in general as she focuses a lot on containers, although it tends to be more intermediate/advanced level I reckon. <o:p></o:p></span></p><p class=MsoNormal><span style='font-size:11.0pt;font-family:"Calibri",sans-serif;color:#1F497D;mso-fareast-language:EN-US'><o:p> </o:p></span></p><p class=MsoNormal><span style='font-size:11.0pt;font-family:"Calibri",sans-serif;color:#1F497D;mso-fareast-language:EN-US'>More recently, I’ve been making my own Docker images for other work projects and I’ve been thinking about Dockerizing a lot of the apps I’ve made at home for my own purposes. I just haven’t gotten to it yet. But really the world is your oyster! <o:p></o:p></span></p><p class=MsoNormal><span style='font-size:11.0pt;font-family:"Calibri",sans-serif;color:#1F497D;mso-fareast-language:EN-US'><o:p> </o:p></span></p><p class=MsoNormal><span style='font-size:11.0pt;font-family:"Calibri",sans-serif;color:#1F497D;mso-fareast-language:EN-US'>Hope that’s a bit inspiring at least… heh.<o:p></o:p></span></p><p class=MsoNormal><span style='font-size:11.0pt;font-family:"Calibri",sans-serif;color:#1F497D;mso-fareast-language:EN-US'><o:p> </o:p></span></p><p class=MsoNormal><span style='font-size:11.0pt;font-family:"Calibri",sans-serif;color:#1F497D'>David Cook<o:p></o:p></span></p><p class=MsoNormal><span style='font-size:11.0pt;font-family:"Calibri",sans-serif;color:#1F497D'>Systems Librarian<o:p></o:p></span></p><p class=MsoNormal><span style='font-size:11.0pt;font-family:"Calibri",sans-serif;color:#1F497D'>Prosentient Systems<o:p></o:p></span></p><p class=MsoNormal><span style='font-size:11.0pt;font-family:"Calibri",sans-serif;color:#1F497D'>72/330 Wattle St<o:p></o:p></span></p><p class=MsoNormal><span style='font-size:11.0pt;font-family:"Calibri",sans-serif;color:#1F497D'>Ultimo, NSW 2007<o:p></o:p></span></p><p class=MsoNormal><span style='font-size:11.0pt;font-family:"Calibri",sans-serif;color:#1F497D'>Australia<o:p></o:p></span></p><p class=MsoNormal><span style='font-size:11.0pt;font-family:"Calibri",sans-serif;color:#1F497D'><o:p> </o:p></span></p><p class=MsoNormal><span style='font-size:11.0pt;font-family:"Calibri",sans-serif;color:#1F497D'>Office: 02 9212 0899<o:p></o:p></span></p><p class=MsoNormal><span style='font-size:11.0pt;font-family:"Calibri",sans-serif;color:#1F497D'>Direct: 02 8005 0595<o:p></o:p></span></p><p class=MsoNormal><span style='font-size:11.0pt;font-family:"Calibri",sans-serif;color:#1F497D;mso-fareast-language:EN-US'><o:p> </o:p></span></p><p class=MsoNormal><b><span lang=EN-US style='font-size:11.0pt;font-family:"Calibri",sans-serif'>From:</span></b><span lang=EN-US style='font-size:11.0pt;font-family:"Calibri",sans-serif'> koha-devel-bounces@lists.koha-community.org [mailto:koha-devel-bounces@lists.koha-community.org] <b>On Behalf Of </b>David Nind<br><b>Sent:</b> Sunday, 7 October 2018 8:02 AM<br><b>To:</b> koha-devel@lists.koha-community.org<br><b>Subject:</b> [Koha-devel] koha-testing-docker - a couple of questions<o:p></o:p></span></p><p class=MsoNormal><o:p> </o:p></p><div><div><div><div><div><div><div><div><div><p class=MsoNormal>I've been getting to grips with using koha-testing-docker (<a href="https://gitlab.com/koha-community/koha-testing-docker" target="_blank">https://gitlab.com/koha-community/koha-testing-docker</a>) since KohaCon 18. Thanks Kyle and Tomás for having a session on it at the HackFest!<o:p></o:p></p></div><div><p class=MsoNormal><o:p> </o:p></p></div><div><p class=MsoNormal>A couple of questions - apologies if the answers to these are obvious, I've not really used docker until now...<o:p></o:p></p></div><div><p class=MsoNormal><o:p> </o:p></p></div><div><p class=MsoNormal>I'm using docker on a Ubuntu 18.04 desktop.<o:p></o:p></p></div><div><p class=MsoNormal><o:p> </o:p></p></div><div><p class=MsoNormal>env/defaults.env and .env<o:p></o:p></p></div><div><p class=MsoNormal>====================<o:p></o:p></p></div><div><p class=MsoNormal><o:p> </o:p></p></div><div><p class=MsoNormal>Is the copy you make of defaults.env only required because docker requires it (as instructed under Setup in the README.md file)?<o:p></o:p></p></div><div><p class=MsoNormal><o:p> </o:p></p></div><div><p class=MsoNormal>Anything I've updated in .env seems to be ignored in favour of what is in the env/defaults.env file, for example your Git user name and email.<o:p></o:p></p></div><div><p class=MsoNormal><o:p> </o:p></p></div><div><p class=MsoNormal>However, if you don't have the .env file you get this error when running docker-compose -p koha up :<o:p></o:p></p></div><div><p class=MsoNormal><o:p> </o:p></p></div><div><p class=MsoNormal>> WARNING: The KOHA_INTRANET_PREFIX variable is not set. Defaulting to a blank string.<br>> WARNING: The KOHA_INSTANCE variable is not set. Defaulting to a blank string.<br>> WARNING: The KOHA_INTRANET_SUFFIX variable is not set. Defaulting to a blank string.<br>> WARNING: The KOHA_DOMAIN variable is not set. Defaulting to a blank string.<br>> WARNING: The KOHA_OPAC_PREFIX variable is not set. Defaulting to a blank string.<br>> WARNING: The KOHA_OPAC_SUFFIX variable is not set. Defaulting to a blank string.<br>> WARNING: The RUN_TESTS_AND_EXIT variable is not set. Defaulting to a blank string.<br>> WARNING: The COVERAGE variable is not set. Defaulting to a blank string.<br>> ERROR: The Compose file './docker-compose.yml' is invalid because:<br>> services.koha.networks.kohanet contains non-unique items, please remove duplicates from [u'', u'']<o:p></o:p></p></div><div><p class=MsoNormal><o:p> </o:p></p></div><div><p class=MsoNormal>For the moment I just make changes in env/defaults.env and copy this to .env<o:p></o:p></p></div><div><p class=MsoNormal><o:p> </o:p></p></div><div><p class=MsoNormal>UNIMARC support<o:p></o:p></p></div><div><p class=MsoNormal>==============<o:p></o:p></p></div><div><p class=MsoNormal><o:p> </o:p></p></div><div><p class=MsoNormal>Does koha-testing-docker support UNIMARC at this stage?<o:p></o:p></p></div><div><p class=MsoNormal><o:p> </o:p></p></div><div><p class=MsoNormal>Adding either UNIMARC or unimarc to the env/defaults.env file didn't seem to make any difference.<o:p></o:p></p></div><div><p class=MsoNormal><o:p> </o:p></p></div><div><p class=MsoNormal>Normally I would use MARC21, but I was trying to test a UNIMARC patch - the UNIMARC specific script said it only works on UNIMARC (surprisingly enough!).<o:p></o:p></p></div><div><p class=MsoNormal><o:p> </o:p></p></div><div><p class=MsoNormal>If I try reset_all_unimarc in the container it hangs at the last line:<o:p></o:p></p></div><div><p class=MsoNormal><o:p> </o:p></p></div><div><p class=MsoNormal>> Inserting /kohadevbox/koha/installer/data/mysql/en/marcflavour/unimarc/mandatory/authorities_normal_unimarc.sql...<br>> Inserting /kohadevbox/koha/installer/data/mysql/en/marcflavour/unimarc/mandatory/unimarc_framework_DEFAULT.sql...<br>> Setting the MARC flavour on the sysprefs...<br>> Setting Koha version to 18.0600035...<br>> Running [sudo koha-shell kohadev -p -c 'PERL5LIB=/kohadevbox/koha:/kohadevbox/qa-test-tools perl /kohadevbox/misc4dev/<a href="http://create_superlibrarian.pl" target="_blank">create_superlibrarian.pl</a> --userid koha --password koha ']...<br>> Running [sudo koha-shell kohadev -c 'PERL5LIB=/kohadevbox/koha:/kohadevbox/qa-test-tools perl /kohadevbox/misc4dev/<a href="http://insert_data.pl" target="_blank">insert_data.pl</a> --marcflavour UNIMARC']...<br>> There is no records data for UNIMARC yet at /kohadevbox/misc4dev/<a href="http://insert_data.pl" target="_blank">insert_data.pl</a> line 50.<o:p></o:p></p></div><div><p class=MsoNormal><o:p> </o:p></p></div><div><p class=MsoNormal>Also, is there an easy way to tell if Koha is using UNIMARC? I assume you can tell by looking at the default cataloguing framework (if you know what you are looking for, which I don't).<o:p></o:p></p></div><div><p class=MsoNormal><o:p> </o:p></p></div><div><div><p class=MsoNormal>Rebuilding search indexes<o:p></o:p></p></div><div><p class=MsoNormal>=====================<o:p></o:p></p></div><div><p class=MsoNormal><o:p> </o:p></p></div><div><p class=MsoNormal>After docker is running you don't get any search reults when searching the catalogue.<o:p></o:p></p></div><div><p class=MsoNormal><o:p> </o:p></p></div><div><p class=MsoNormal>Is having to rebuild the search index manually once docker has started the normal behaviour?<o:p></o:p></p></div><div><p class=MsoNormal><o:p> </o:p></p></div><div><p class=MsoNormal>Is it possible to have the indexes created as part of docker starting up?<o:p></o:p></p></div><div><p class=MsoNormal><o:p> </o:p></p></div><div><p class=MsoNormal>Or is there a reason why this isn't done? (Depending on whether you want to use Zebra or Elastic.) <o:p></o:p></p></div></div><div><p class=MsoNormal><o:p> </o:p></p></div><div><p class=MsoNormal>Getting my head around docker<o:p></o:p></p></div><div><p class=MsoNormal>=========================<o:p></o:p></p></div><div><p class=MsoNormal><o:p> </o:p></p></div><div><p class=MsoNormal>I found this quick guide useful to get the concepts of docker <a href="https://vsupalov.com/6-docker-basics/" target="_blank">https://vsupalov.com/6-docker-basics/</a><o:p></o:p></p></div><div><p class=MsoNormal><o:p> </o:p></p></div><div><p class=MsoNormal>As well, the docker documentation is helpful after that <a href="https://docs.docker.com/get-started/">https://docs.docker.com/get-started/</a><o:p></o:p></p></div><div><p class=MsoNormal><o:p> </o:p></p></div><div><p class=MsoNormal>Are there any other useful guides or tutorials that you would recommend to people new to docker?<o:p></o:p></p></div><div><p class=MsoNormal><o:p> </o:p></p></div><div><p class=MsoNormal>Thanks for everyone's work that has made koha-testing-docker possible!<o:p></o:p></p></div><div><p class=MsoNormal><o:p> </o:p></p></div><div><div><div><div><div><div><div><p class=MsoNormal>David Nind | <a href="mailto:david.nind@gmail.com" target="_blank">david.nind@gmail.com</a><br>PO Box 12367, Thorndon, Wellington, New Zealand 6144<br>m. +64 21 0537 847<o:p></o:p></p></div></div></div></div></div></div></div></div></div></div></div></div></div></div></div></div></body></html>