Difference between revisions of "Koha-Library-Management-System/C2/Koha-installation-on-Linux-16.04/English"
Pravin1389 (Talk | contribs) (Created page with ".") |
Pravin1389 (Talk | contribs) |
||
Line 1: | Line 1: | ||
. | . | ||
+ | |||
+ | {| border=1 | ||
+ | || '''Visual Cue''' | ||
+ | || '''Narration''' | ||
+ | |||
+ | |- | ||
+ | || Title slide | ||
+ | || Welcome to this spoken tutorial on '''Installation '''of '''Koha '''on '''Ubuntu Linux OS'''. | ||
+ | |||
+ | |- | ||
+ | || Learning Objectives slide | ||
+ | || In this tutorial, we will learn to | ||
+ | |||
+ | * Install '''Koha Library Management System''' on '''Ubuntu Linux OS 16.04''' | ||
+ | * and cross-verify the installation | ||
+ | |||
+ | |||
+ | |||
+ | |- | ||
+ | || System requirements | ||
+ | || This tutorial is recorded using | ||
+ | |||
+ | # '''Ubuntu Linux''' OS 16.04 | ||
+ | # '''Koha''' version 16.05 | ||
+ | # '''gedit text editor''' | ||
+ | # '''Firefox web browser''' | ||
+ | |||
+ | |||
+ | |||
+ | |- | ||
+ | || Pre-requisites | ||
+ | || Before you start, please ensure that your machine has- | ||
+ | |||
+ | # '''Ubuntu Linux OS 16.04''' | ||
+ | # any '''text editor''' | ||
+ | # either '''Firefox''' or''' Google Chrome web browser''' | ||
+ | |||
+ | |||
+ | |||
+ | |- | ||
+ | || Hardware requirements | ||
+ | || The minimum hardware requirements are- | ||
+ | |||
+ | * i3 processor or above | ||
+ | * 500GB hard disk or more | ||
+ | * minimum 4GB RAM and | ||
+ | * Network facility | ||
+ | |||
+ | |||
+ | |||
+ | |- | ||
+ | || | ||
+ | || Let’s begin. | ||
+ | |||
+ | |- | ||
+ | || Ctrl+Alt+T keys | ||
+ | || Open the '''terminal '''by pressing '''Ctrl+Alt+T''' keys simultaneously on the keyboard. | ||
+ | |||
+ | |- | ||
+ | || Type | ||
+ | |||
+ | sudo apt-get update >> Enter | ||
+ | |||
+ | |||
+ | |||
+ | || We have to first of all ensure that our '''Ubuntu Linux '''installation is up-to-date. | ||
+ | |||
+ | |||
+ | For that type '''sudo apt-get update''' | ||
+ | |||
+ | |- | ||
+ | || Type admin password >> Enter | ||
+ | || Type the '''admin password '''when prompted. | ||
+ | |||
+ | |- | ||
+ | || Type | ||
+ | |||
+ | |||
+ | ''echo deb [http://debian.koha-community.org/koha http://debian.koha-community.org/koha] 16.05 main | sudo tee /etc/apt/sources.list.d/koha.list'' | ||
+ | |||
+ | |||
+ | Press Enter. | ||
+ | || Now type this command carefully and press '''Enter'''. | ||
+ | |||
+ | |||
+ | Please note: '''Koha 16.05''' was the stable version at the time of creation of this tutorial. | ||
+ | |||
+ | |||
+ | This command will create a file named '''koha.list''' and update the '''package repository.''' | ||
+ | |||
+ | |- | ||
+ | || Type | ||
+ | |||
+ | |||
+ | ''wget -O- [http://debian.koha-community.org/koha/gpg.asc http://debian.koha-community.org/koha/gpg.asc] | sudo apt-key add -'' | ||
+ | |||
+ | |||
+ | Press Enter. | ||
+ | || Then type this command as shown on the '''terminal '''and press '''Enter'''. | ||
+ | |||
+ | |||
+ | This will download '''gpg.asc file''' and update the '''signature key'''. | ||
+ | |||
+ | |- | ||
+ | || Type | ||
+ | |||
+ | |||
+ | ''sudo apt-get update'' >> Enter | ||
+ | |||
+ | |||
+ | |||
+ | || Now press up arrow key to recall this command on the '''terminal'''. | ||
+ | |||
+ | |||
+ | And press '''Enter.''' | ||
+ | |||
+ | |||
+ | This is to update the new '''repositories'''. | ||
+ | |||
+ | |- | ||
+ | || Type | ||
+ | |||
+ | sudo apt-get install koha-common >> Enter | ||
+ | || Now type- | ||
+ | |||
+ | '''sudo apt-get install koha-common''' and press '''Enter.''' | ||
+ | |||
+ | |- | ||
+ | || Press Y | ||
+ | || Press '''Y '''when asked if you want to continue. | ||
+ | |||
+ | |- | ||
+ | || | ||
+ | || This will install '''Koha''' on your system. | ||
+ | |||
+ | |||
+ | Wait for the installation to complete. | ||
+ | |||
+ | This will take some time. | ||
+ | |||
+ | |- | ||
+ | || 13:35 | ||
+ | || Now we have to open the '''conf file '''in a '''text editor '''to change the port number for '''Koha'''. | ||
+ | |||
+ | |- | ||
+ | || | ||
+ | || I will use '''gedit text editor'''. You can use any '''text editor '''of your choice. | ||
+ | |||
+ | |- | ||
+ | || type | ||
+ | |||
+ | sudo gedit /etc/koha/koha-sites.conf >> Enter | ||
+ | || So on the '''terminal '''I will type | ||
+ | |||
+ | '''sudo gedit /etc/koha/koha-sites.conf''' | ||
+ | |||
+ | and press '''Enter'''. | ||
+ | |||
+ | |- | ||
+ | || | ||
+ | || The file opens in the '''text editor'''. | ||
+ | |||
+ | |- | ||
+ | || Locate INTRAPORT = 80 | ||
+ | || Locate the line that says '''INTRAPORT = 80''' | ||
+ | |||
+ | |- | ||
+ | || Change 80 to 8080. | ||
+ | || Change '''80''' to '''8080'''. | ||
+ | |||
+ | |||
+ | This will change the port number to '''8080'''. | ||
+ | |||
+ | |- | ||
+ | || Ctrl+S >> close file | ||
+ | || Then save and close the file. | ||
+ | |||
+ | |- | ||
+ | || Terminal | ||
+ | || Come back to the '''terminal'''. | ||
+ | |||
+ | |- | ||
+ | || | ||
+ | || Now we have to set up the '''database'''. | ||
+ | |||
+ | |- | ||
+ | || Type | ||
+ | |||
+ | sudo apt-get install mariadb-server >> Enter | ||
+ | || So type '''sudo apt-get install mariadb-server''' and press '''Enter'''. | ||
+ | |||
+ | |- | ||
+ | || Type | ||
+ | |||
+ | sudo mysqladmin -u root password admin123 >> Enter | ||
+ | || Then type- | ||
+ | |||
+ | '''sudo mysqladmin -u root password admin123''' and press '''Enter'''. | ||
+ | |||
+ | |||
+ | You could give a different password if you wish. | ||
+ | |||
+ | |||
+ | This will set the '''password''' for''' root user''' as '''admin123 '''for the '''database'''. | ||
+ | |||
+ | |- | ||
+ | || Type | ||
+ | |||
+ | sudo a2enmod rewrite >> Enter | ||
+ | |||
+ | sudo a2enmod cgi >> Enter | ||
+ | || Next type | ||
+ | |||
+ | '''sudo a2enmod rewrite '''and press '''Enter'''. | ||
+ | |||
+ | '''sudo a2enmod cgi '''and press '''Enter'''. | ||
+ | |||
+ | |||
+ | This will enable the '''modules''' of '''Koha'''. | ||
+ | |||
+ | |- | ||
+ | || 19:20 | ||
+ | |||
+ | Type | ||
+ | |||
+ | sudo service apache2 restart >> Enter | ||
+ | || Then type | ||
+ | |||
+ | '''sudo service apache2 restart '''and press '''Enter'''. | ||
+ | |||
+ | |||
+ | This will restart '''apache services.''' | ||
+ | |||
+ | |- | ||
+ | || Type: | ||
+ | |||
+ | |||
+ | sudo koha-create --create-db library | ||
+ | || To create a '''Koha instance''' named '''library''', type the following command | ||
+ | |||
+ | |||
+ | And press '''Enter.''' | ||
+ | |||
+ | |- | ||
+ | || Type: | ||
+ | |||
+ | |||
+ | sudo gedit /etc/apache2/ports.conf | ||
+ | || Next we have to tell '''Apache server '''that we are using '''port 8080'''. | ||
+ | |||
+ | |||
+ | For that, we have to open the '''ports.conf''' file in a '''text editor'''. | ||
+ | |||
+ | Once again, I will use '''gedit text editor'''. So type- | ||
+ | |||
+ | |||
+ | '''sudo gedit /etc/apache2/ports.conf''' | ||
+ | |||
+ | |||
+ | and press '''Enter'''. | ||
+ | |||
+ | |- | ||
+ | || Add 8080 | ||
+ | || In the '''ports.conf''' file, search for the line '''Listen 80''' | ||
+ | |||
+ | |||
+ | Next to that line, add '''Listen 8080''' | ||
+ | |||
+ | |- | ||
+ | || Ctrl+S >> close file | ||
+ | || Then save and close the file. | ||
+ | |||
+ | |- | ||
+ | || Type | ||
+ | |||
+ | sudo service apache2 restart >> Enter | ||
+ | || Now type | ||
+ | |||
+ | '''sudo service apache2 restart '''and press '''Enter'''. | ||
+ | |||
+ | |||
+ | This will restart '''apache services.''' | ||
+ | |||
+ | |- | ||
+ | || Type | ||
+ | |||
+ | sudo a2dissite 000-default | ||
+ | || Next type | ||
+ | |||
+ | '''sudo a2dissite 000-default '''and press '''Enter'''. | ||
+ | |||
+ | |||
+ | This is to disable the '''000-default''' site. | ||
+ | |||
+ | |- | ||
+ | || Point to message | ||
+ | || The message confirms that it is already disabled. | ||
+ | |||
+ | |- | ||
+ | || | ||
+ | || Let's move on. | ||
+ | |||
+ | |- | ||
+ | || Type | ||
+ | |||
+ | sudo a2enmod deflate >> Enter | ||
+ | |||
+ | sudo a2ensite library >> Enter | ||
+ | || Type | ||
+ | |||
+ | '''sudo a2enmod deflate '''and press '''Enter'''. | ||
+ | |||
+ | '''sudo a2ensite library '''and press '''Enter'''. | ||
+ | |||
+ | |||
+ | The message on the '''terminal''' confirms that the''' site library''' is enabled. | ||
+ | |||
+ | |- | ||
+ | || sudo service apache2 restart and press Enter. | ||
+ | || Using the up arrow key, recall the command shown on the screen. | ||
+ | |||
+ | |- | ||
+ | || Type | ||
+ | |||
+ | sudo su >> Enter | ||
+ | || Then type | ||
+ | |||
+ | '''sudo su '''and press '''Enter'''. | ||
+ | |||
+ | |||
+ | We are now in the '''superuser''' that is '''root user''' mode. | ||
+ | |||
+ | |- | ||
+ | || Type | ||
+ | |||
+ | mysql -u root -p >> Enter | ||
+ | || At the '''prompt''', type | ||
+ | |||
+ | '''mysql -u root -p '''and press '''Enter'''. | ||
+ | |||
+ | |- | ||
+ | || Type password >> Enter | ||
+ | |||
+ | |||
+ | 21:09 | ||
+ | || Type the '''password''' when prompted. | ||
+ | |||
+ | |||
+ | We are now inside our '''MariaDB prompt'''. | ||
+ | |||
+ | |- | ||
+ | || Type | ||
+ | |||
+ | use mysql; >> Enter | ||
+ | || At the '''MariaDB prompt''', type | ||
+ | |||
+ | '''use mysql semicolon '''and press '''Enter'''. | ||
+ | |||
+ | |||
+ | This is to tell '''MariaDB''' to use '''mysql database.''' | ||
+ | |||
+ | |- | ||
+ | || Point to message | ||
+ | || The message displayed on the '''terminal '''says '''Database changed.''' | ||
+ | |||
+ | |- | ||
+ | || Point to mysql | ||
+ | || Notice the '''MariaDB prompt '''says '''mysql.''' | ||
+ | |||
+ | |- | ||
+ | || | ||
+ | || Now type the following command carefully as shown and press '''Enter'''. | ||
+ | |||
+ | |||
+ | This will set the '''password''' for the '''user koha_library''' as '''koha123'''. | ||
+ | |||
+ | |- | ||
+ | | colspan="2" | Only to be shown in Visual Cue and not to be narrated. | ||
+ | |||
+ | '''SET PASSWORD FOR 'koha_library'@'localhost' = PASSWORD('koha123');''' | ||
+ | |||
+ | |- | ||
+ | || Point to “Query OK” | ||
+ | || We see a message on the '''terminal''' that says “'''Query OK'''”. | ||
+ | |||
+ | |- | ||
+ | || Type | ||
+ | |||
+ | flush privileges; >> Enter | ||
+ | |||
+ | |||
+ | |||
+ | || Next type | ||
+ | |||
+ | '''flush privileges semicolon '''and press '''Enter'''. | ||
+ | |||
+ | |||
+ | This will update the latest changes. | ||
+ | |||
+ | |- | ||
+ | || Point to “Query OK” | ||
+ | || Once again we see a message on the '''terminal''' that says “'''Query OK'''”. | ||
+ | |||
+ | |- | ||
+ | || Type quit; >> Enter | ||
+ | |||
+ | |||
+ | |||
+ | || Lastly, type '''quit semicolon''' and press '''Enter '''to exit from '''Mariadb'''. | ||
+ | |||
+ | |- | ||
+ | || Root user prompt | ||
+ | || We are now back in the '''root user prompt.''' | ||
+ | |||
+ | |- | ||
+ | || Type exit; >> Enter | ||
+ | || Type '''exit semicolon '''and press '''Enter'''. | ||
+ | |||
+ | |- | ||
+ | || User prompt | ||
+ | || This will exit us from '''root user login'''. | ||
+ | |||
+ | |||
+ | And we are brought back to our normal '''user prompt'''. | ||
+ | |||
+ | |- | ||
+ | || Type | ||
+ | |||
+ | sudo gedit /etc/koha/sites/library/koha-conf.xml | ||
+ | |||
+ | Press Enter | ||
+ | || We will now open the '''koha-conf.xml '''file in a '''text editor.''' | ||
+ | |||
+ | |||
+ | I will do so using '''gedit text editor.''' | ||
+ | |||
+ | |||
+ | So I will type | ||
+ | |||
+ | '''sudo gedit /etc/koha/sites/library/koha-conf.xml '''and press '''Enter'''. | ||
+ | |||
+ | |- | ||
+ | || Type | ||
+ | |||
+ | koha_library >> Enter | ||
+ | || In this file, search for the '''keyword 'koha_library'''' and press '''Enter'''. | ||
+ | |||
+ | |- | ||
+ | || | ||
+ | || It shows 3 results. | ||
+ | |||
+ | |- | ||
+ | || 25:15 | ||
+ | |||
+ | Highlight mysql | ||
+ | || Scroll down and locate this line. | ||
+ | |||
+ | |- | ||
+ | || <nowiki>Highlight <pass>5NT......</pass></nowiki> | ||
+ | || Then locate this line. | ||
+ | |||
+ | |- | ||
+ | || Replace with 'koha123' | ||
+ | || Replace the '''alphanumeric''' value with ''''koha123''''. | ||
+ | |||
+ | |||
+ | Recall that this is the '''password''' we had set for our '''database''' earlier via the '''terminal'''. | ||
+ | |||
+ | |- | ||
+ | || Ctrl+S>> close the file | ||
+ | || Save the file and close the '''editor''' window. | ||
+ | |||
+ | |- | ||
+ | || | ||
+ | || Now open any '''web browser.''' | ||
+ | |||
+ | |||
+ | I will be opening '''Firefox web browser.''' | ||
+ | |||
+ | |- | ||
+ | || Firefox web browser >> 127.0.1.1:8080 | ||
+ | |||
+ | Press Enter | ||
+ | || In the '''address bar''', type '''127.0.1.1:8080''' and press '''Enter'''. | ||
+ | |||
+ | |- | ||
+ | || | ||
+ | || The '''Koha web installer page''' appears on the browser. | ||
+ | |||
+ | |- | ||
+ | || Login with | ||
+ | |||
+ | username = koha_library | ||
+ | |||
+ | password = koha123 | ||
+ | || To '''login''', use the credentials we set earlier. | ||
+ | |||
+ | |||
+ | I will type '''username''' as '''koha_library''' and '''password''' as '''koha123'''. | ||
+ | |||
+ | |||
+ | If you had given a different '''username''' and '''password''', then type that in. | ||
+ | |||
+ | |- | ||
+ | || Click on Login button | ||
+ | || Now click on the '''Login''' button at the bottom right. | ||
+ | |||
+ | |- | ||
+ | || Highlight Step 1 | ||
+ | || We are in '''Step 1''' of '''Koha web installer'''. | ||
+ | |||
+ | |- | ||
+ | || language drop-down >> en | ||
+ | |||
+ | |||
+ | |||
+ | || In the '''language''' drop-down, select '''en '''for '''English, '''if it’s not already selected, by default. | ||
+ | |||
+ | |- | ||
+ | || Click on Next button | ||
+ | || Now click on the '''Next''' button at the bottom right. | ||
+ | |||
+ | |- | ||
+ | || Point to the 2 messages | ||
+ | || The window now displays 2 messages. | ||
+ | |||
+ | |||
+ | The messages confirm that all '''Perl modules''' and all '''dependencies '''are installed. | ||
+ | |||
+ | |- | ||
+ | || Click on Next button | ||
+ | || Click on the '''Next''' button at the bottom right. | ||
+ | |||
+ | |- | ||
+ | || 27:09 | ||
+ | |||
+ | Highlight Step 2 | ||
+ | || We are now in '''Step 2 – Database settings''' | ||
+ | |||
+ | |- | ||
+ | || Point to the values displayed | ||
+ | || Notice here all the values''' '''are what we gave earlier. | ||
+ | |||
+ | |- | ||
+ | || Click on Next button | ||
+ | || Then click on the '''Next''' button at the bottom. | ||
+ | |||
+ | |- | ||
+ | || Point to the message | ||
+ | || On doing so, we see a message that says “'''Connection established'''”. | ||
+ | |||
+ | |- | ||
+ | || Point to the messages | ||
+ | || This is followed by 2 more confirmation messages. | ||
+ | |||
+ | |- | ||
+ | || Click on Next button | ||
+ | || Click on the '''Next''' button at the bottom. | ||
+ | |||
+ | |- | ||
+ | || Highlight Step 3 | ||
+ | || We are brought to '''Step 3.''' | ||
+ | |||
+ | |- | ||
+ | || Click on Next button | ||
+ | || Read what is displayed on the screen and then click on the '''Next '''button. | ||
+ | |||
+ | |- | ||
+ | || Point to the success message | ||
+ | || Soon we will see a '''Success''' message on our screen. | ||
+ | |||
+ | |||
+ | This confirms that our '''database tables''' are created. | ||
+ | |||
+ | |- | ||
+ | || Click on Next button | ||
+ | || Now click on the '''Next''' button at the bottom to continue. | ||
+ | |||
+ | |- | ||
+ | || | ||
+ | || Immediately, we are brought to this screen. | ||
+ | |||
+ | |- | ||
+ | || Click on the link install basic configuration settings | ||
+ | || Read the displayed text and then click on the link '''install basic configuration settings'''. | ||
+ | |||
+ | |- | ||
+ | || Highlight MARC flavor | ||
+ | |||
+ | |||
+ | Select MARC21 | ||
+ | || On doing so, we are asked to select our '''MARC flavor.''' | ||
+ | |||
+ | |||
+ | I am going to select '''MARC21.''' | ||
+ | |||
+ | |- | ||
+ | || Click on Next button | ||
+ | || Then click on the '''Next''' button at the bottom. | ||
+ | |||
+ | |- | ||
+ | || Highlight Mandatory section | ||
+ | |||
+ | |||
+ | Point to the selected Default MARC21 checkboxes | ||
+ | || In this screen, scroll down to the section '''Mandatory.''' | ||
+ | |||
+ | |||
+ | Here, we see that the '''Default MARC21 checkboxes '''are selected. | ||
+ | |||
+ | |- | ||
+ | || Highlight Optional section | ||
+ | || Under Optional section, select all the options as shown. | ||
+ | |||
+ | |- | ||
+ | || Scroll down | ||
+ | |||
+ | Highlight Other Data section | ||
+ | |||
+ | Point to the selected checkboxes | ||
+ | || As we scroll down, we see that under '''Other data''', all the checkboxes are already selected. | ||
+ | |||
+ | |- | ||
+ | || Scroll down | ||
+ | || Keep scrolling to the bottom of the page. | ||
+ | |||
+ | |- | ||
+ | || Highlight Optional section | ||
+ | || There is one more '''Optional '''section below, which is very long. | ||
+ | |||
+ | |- | ||
+ | || Locate the option “Some basic currencies” >> select it | ||
+ | || Here, locate the option “'''Some basic currencies'''” and select it. | ||
+ | |||
+ | |- | ||
+ | || Select the option “Useful patron attribute types” | ||
+ | || After this, select the option “'''Useful patron attribute types'''”. | ||
+ | |||
+ | |- | ||
+ | || 34:36 | ||
+ | |||
+ | Click on '''Import '''button | ||
+ | || Now go to the bottom of the page and click on the '''Import '''button. | ||
+ | |||
+ | |- | ||
+ | || | ||
+ | || This will enable all the selected functionalities in '''Koha'''. | ||
+ | |||
+ | |- | ||
+ | || 34:50 | ||
+ | || We are now brought to a new page. | ||
+ | |||
+ | |- | ||
+ | || Scroll down | ||
+ | || Scroll down this page and read all the text displayed on the screen. | ||
+ | |||
+ | |- | ||
+ | || Point to the success message | ||
+ | || We can see a success message “'''All done'''”. | ||
+ | |||
+ | |- | ||
+ | || Click on Finish''' '''button | ||
+ | || Now, click on the '''Finish '''button. | ||
+ | |||
+ | |||
+ | This will complete and load the '''Koha Staff Interface'''. | ||
+ | |||
+ | |- | ||
+ | || Point to the message | ||
+ | || We see the final message on our screen, which confirms that our installation is successful. | ||
+ | |||
+ | |- | ||
+ | || | ||
+ | || We will now be moved to the '''Koha interface.''' | ||
+ | |||
+ | |- | ||
+ | || Type | ||
+ | |||
+ | username=koha_library | ||
+ | |||
+ | password=koha123 | ||
+ | || Type the '''username '''as '''koha_library''' and '''password '''as '''koha123.''' | ||
+ | |||
+ | |- | ||
+ | || Select My Library | ||
+ | || Select '''My Library''' from the drop-down. | ||
+ | |||
+ | |- | ||
+ | || Click on Login''' '''button | ||
+ | || Then click on the '''Login''' button. | ||
+ | |||
+ | |- | ||
+ | || | ||
+ | || We are brought to the '''Koha Administration page.''' | ||
+ | |||
+ | |- | ||
+ | || Point to the various tabs | ||
+ | || We can see various tabs on this page. | ||
+ | |||
+ | |||
+ | We will learn how to use many of these later in this series. | ||
+ | |||
+ | |- | ||
+ | || Click on '''No Library Set''' >> select the '''Logout''' | ||
+ | || Now, click on '''No Library Set''' at the top right and select the '''Logout''' option. | ||
+ | |||
+ | |- | ||
+ | || | ||
+ | || This brings us to the end of this tutorial. | ||
+ | |||
+ | Let us summarize. | ||
+ | |||
+ | |- | ||
+ | || Summary slide | ||
+ | || In this tutorial, we have learnt to | ||
+ | |||
+ | * Install '''Koha Library Management System''' on '''Ubuntu Linux OS 16.04''' | ||
+ | * and cross-verify the installation | ||
+ | |||
+ | |||
+ | |||
+ | |- | ||
+ | || Slide | ||
+ | |||
+ | About '''Spoken Tutorial '''project | ||
+ | |||
+ | * Watch the video available at http://spoken-tutorial.org/What_is_a_Spoken_Tutorial | ||
+ | * It summarises the '''Spoken Tutorial '''project. | ||
+ | * If you do not have good bandwidth, you can download and watch it. | ||
+ | |||
+ | |||
+ | || The video at the following link summarises the '''Spoken Tutorial''' project. | ||
+ | |||
+ | Please download and watch it. | ||
+ | |||
+ | |||
+ | |||
+ | |||
+ | |- | ||
+ | || Slide: | ||
+ | |||
+ | '''Spoken Tutorial '''workshops | ||
+ | |||
+ | The '''Spoken Tutorial''' Project Team | ||
+ | |||
+ | * Conducts workshops using spoken tutorials | ||
+ | * Gives certificates for those who pass an online test | ||
+ | * For more details, please write to contact@spoken-tutorial.org | ||
+ | |||
+ | |||
+ | || The '''Spoken Tutoria'''l Project team: | ||
+ | |||
+ | * conducts workshops and | ||
+ | * gives certificates. | ||
+ | |||
+ | For more details, please write to us. | ||
+ | |||
+ | |- | ||
+ | || Slide: | ||
+ | |||
+ | Forum for specific questions | ||
+ | |||
+ | * Do you have questions in THIS '''Spoken Tutorial'''? | ||
+ | * Please visit http://forums.spoken-tutorial.org | ||
+ | * Choose the minute and second where you have the question | ||
+ | * Explain your question briefly | ||
+ | * Someone from our team will answer them | ||
+ | |||
+ | |||
+ | || Post your timed queries in this Forum. | ||
+ | |||
+ | |- | ||
+ | || Slide 17 | ||
+ | |||
+ | Acknowledgement | ||
+ | |||
+ | * '''Spoken Tutorial''' Project is a part of the '''Talk to a Teacher''' project | ||
+ | * It is supported by the '''National Mission on Education''' through '''ICT, MHRD, Government of India''' | ||
+ | * More information on this Mission is available at http://spoken-tutorial.org/NMEICT-Intro | ||
+ | |||
+ | '''Spoken Tutorial '''project is funded by '''NMEICT, MHRD, Government of India.''' | ||
+ | |||
+ | |||
+ | More information on this mission is available at this link. | ||
+ | |||
+ | |- | ||
+ | || | ||
+ | || The script has been contributed by Nancy and video by Praveen. | ||
+ | |||
+ | |||
+ | This is Nancy from IIT Bombay signing off. | ||
+ | |||
+ | |||
+ | Thank you for joining. | ||
+ | |||
+ | |} |
Revision as of 23:47, 25 September 2018
.
Visual Cue | Narration |
Title slide | Welcome to this spoken tutorial on Installation of Koha on Ubuntu Linux OS. |
Learning Objectives slide | In this tutorial, we will learn to
|
System requirements | This tutorial is recorded using
|
Pre-requisites | Before you start, please ensure that your machine has-
|
Hardware requirements | The minimum hardware requirements are-
|
Let’s begin. | |
Ctrl+Alt+T keys | Open the terminal by pressing Ctrl+Alt+T keys simultaneously on the keyboard. |
Type
sudo apt-get update >> Enter
|
We have to first of all ensure that our Ubuntu Linux installation is up-to-date.
|
Type admin password >> Enter | Type the admin password when prompted. |
Type
|
Now type this command carefully and press Enter.
|
Type
|
Then type this command as shown on the terminal and press Enter.
|
Type
|
Now press up arrow key to recall this command on the terminal.
|
Type
sudo apt-get install koha-common >> Enter |
Now type-
sudo apt-get install koha-common and press Enter. |
Press Y | Press Y when asked if you want to continue. |
This will install Koha on your system.
This will take some time. | |
13:35 | Now we have to open the conf file in a text editor to change the port number for Koha. |
I will use gedit text editor. You can use any text editor of your choice. | |
type
sudo gedit /etc/koha/koha-sites.conf >> Enter |
So on the terminal I will type
sudo gedit /etc/koha/koha-sites.conf and press Enter. |
The file opens in the text editor. | |
Locate INTRAPORT = 80 | Locate the line that says INTRAPORT = 80 |
Change 80 to 8080. | Change 80 to 8080.
|
Ctrl+S >> close file | Then save and close the file. |
Terminal | Come back to the terminal. |
Now we have to set up the database. | |
Type
sudo apt-get install mariadb-server >> Enter |
So type sudo apt-get install mariadb-server and press Enter. |
Type
sudo mysqladmin -u root password admin123 >> Enter |
Then type-
sudo mysqladmin -u root password admin123 and press Enter.
|
Type
sudo a2enmod rewrite >> Enter sudo a2enmod cgi >> Enter |
Next type
sudo a2enmod rewrite and press Enter. sudo a2enmod cgi and press Enter.
|
19:20
Type sudo service apache2 restart >> Enter |
Then type
sudo service apache2 restart and press Enter.
|
Type:
|
To create a Koha instance named library, type the following command
|
Type:
|
Next we have to tell Apache server that we are using port 8080.
Once again, I will use gedit text editor. So type-
|
Add 8080 | In the ports.conf file, search for the line Listen 80
|
Ctrl+S >> close file | Then save and close the file. |
Type
sudo service apache2 restart >> Enter |
Now type
sudo service apache2 restart and press Enter.
|
Type
sudo a2dissite 000-default |
Next type
sudo a2dissite 000-default and press Enter.
|
Point to message | The message confirms that it is already disabled. |
Let's move on. | |
Type
sudo a2enmod deflate >> Enter sudo a2ensite library >> Enter |
Type
sudo a2enmod deflate and press Enter. sudo a2ensite library and press Enter.
|
sudo service apache2 restart and press Enter. | Using the up arrow key, recall the command shown on the screen. |
Type
sudo su >> Enter |
Then type
sudo su and press Enter.
|
Type
mysql -u root -p >> Enter |
At the prompt, type
mysql -u root -p and press Enter. |
Type password >> Enter
|
Type the password when prompted.
|
Type
use mysql; >> Enter |
At the MariaDB prompt, type
use mysql semicolon and press Enter.
|
Point to message | The message displayed on the terminal says Database changed. |
Point to mysql | Notice the MariaDB prompt says mysql. |
Now type the following command carefully as shown and press Enter.
| |
Only to be shown in Visual Cue and not to be narrated.
SET PASSWORD FOR 'koha_library'@'localhost' = PASSWORD('koha123'); | |
Point to “Query OK” | We see a message on the terminal that says “Query OK”. |
Type
flush privileges; >> Enter
|
Next type
flush privileges semicolon and press Enter.
|
Point to “Query OK” | Once again we see a message on the terminal that says “Query OK”. |
Type quit; >> Enter
|
Lastly, type quit semicolon and press Enter to exit from Mariadb. |
Root user prompt | We are now back in the root user prompt. |
Type exit; >> Enter | Type exit semicolon and press Enter. |
User prompt | This will exit us from root user login.
|
Type
sudo gedit /etc/koha/sites/library/koha-conf.xml Press Enter |
We will now open the koha-conf.xml file in a text editor.
sudo gedit /etc/koha/sites/library/koha-conf.xml and press Enter. |
Type
koha_library >> Enter |
In this file, search for the keyword 'koha_library' and press Enter. |
It shows 3 results. | |
25:15
Highlight mysql |
Scroll down and locate this line. |
Highlight <pass>5NT......</pass> | Then locate this line. |
Replace with 'koha123' | Replace the alphanumeric value with 'koha123'.
|
Ctrl+S>> close the file | Save the file and close the editor window. |
Now open any web browser.
| |
Firefox web browser >> 127.0.1.1:8080
Press Enter |
In the address bar, type 127.0.1.1:8080 and press Enter. |
The Koha web installer page appears on the browser. | |
Login with
username = koha_library password = koha123 |
To login, use the credentials we set earlier.
|
Click on Login button | Now click on the Login button at the bottom right. |
Highlight Step 1 | We are in Step 1 of Koha web installer. |
language drop-down >> en
|
In the language drop-down, select en for English, if it’s not already selected, by default. |
Click on Next button | Now click on the Next button at the bottom right. |
Point to the 2 messages | The window now displays 2 messages.
|
Click on Next button | Click on the Next button at the bottom right. |
27:09
Highlight Step 2 |
We are now in Step 2 – Database settings |
Point to the values displayed | Notice here all the values are what we gave earlier. |
Click on Next button | Then click on the Next button at the bottom. |
Point to the message | On doing so, we see a message that says “Connection established”. |
Point to the messages | This is followed by 2 more confirmation messages. |
Click on Next button | Click on the Next button at the bottom. |
Highlight Step 3 | We are brought to Step 3. |
Click on Next button | Read what is displayed on the screen and then click on the Next button. |
Point to the success message | Soon we will see a Success message on our screen.
|
Click on Next button | Now click on the Next button at the bottom to continue. |
Immediately, we are brought to this screen. | |
Click on the link install basic configuration settings | Read the displayed text and then click on the link install basic configuration settings. |
Highlight MARC flavor
|
On doing so, we are asked to select our MARC flavor.
|
Click on Next button | Then click on the Next button at the bottom. |
Highlight Mandatory section
|
In this screen, scroll down to the section Mandatory.
|
Highlight Optional section | Under Optional section, select all the options as shown. |
Scroll down
Highlight Other Data section Point to the selected checkboxes |
As we scroll down, we see that under Other data, all the checkboxes are already selected. |
Scroll down | Keep scrolling to the bottom of the page. |
Highlight Optional section | There is one more Optional section below, which is very long. |
Locate the option “Some basic currencies” >> select it | Here, locate the option “Some basic currencies” and select it. |
Select the option “Useful patron attribute types” | After this, select the option “Useful patron attribute types”. |
34:36
Click on Import button |
Now go to the bottom of the page and click on the Import button. |
This will enable all the selected functionalities in Koha. | |
34:50 | We are now brought to a new page. |
Scroll down | Scroll down this page and read all the text displayed on the screen. |
Point to the success message | We can see a success message “All done”. |
Click on Finish button | Now, click on the Finish button.
|
Point to the message | We see the final message on our screen, which confirms that our installation is successful. |
We will now be moved to the Koha interface. | |
Type
username=koha_library password=koha123 |
Type the username as koha_library and password as koha123. |
Select My Library | Select My Library from the drop-down. |
Click on Login button | Then click on the Login button. |
We are brought to the Koha Administration page. | |
Point to the various tabs | We can see various tabs on this page.
|
Click on No Library Set >> select the Logout | Now, click on No Library Set at the top right and select the Logout option. |
This brings us to the end of this tutorial.
Let us summarize. | |
Summary slide | In this tutorial, we have learnt to
|
Slide
About Spoken Tutorial project
|
The video at the following link summarises the Spoken Tutorial project.
Please download and watch it.
|
Slide:
Spoken Tutorial workshops The Spoken Tutorial Project Team
|
The Spoken Tutorial Project team:
For more details, please write to us. |
Slide:
Forum for specific questions
|
Post your timed queries in this Forum. |
Slide 17
Acknowledgement
Spoken Tutorial project is funded by NMEICT, MHRD, Government of India.
| |
The script has been contributed by Nancy and video by Praveen.
|