Difference between revisions of "Koha-Library-Management-System/C2/Koha-installation-on-Linux-16.04/English"
Pravin1389 (Talk | contribs) (Created page with ".") |
Nancyvarkey (Talk | contribs) |
||
(8 intermediate revisions by 3 users not shown) | |||
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''' and | ||
+ | # '''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 | ||
+ | |||
+ | |- | ||
+ | || Slide | ||
+ | || The commands used in this tutorial are available in the '''Code Files''' link below the player. | ||
+ | |||
+ | |- | ||
+ | |Switch to gedit text editor and open the file | ||
+ | |I have opened this file in '''gedit text editor''' on my machine. | ||
+ | |||
+ | |||
+ | And I will use the same file to copy paste the '''commands''' during the demonstration. | ||
+ | |||
+ | |- | ||
+ | || | ||
+ | || Let’s begin. | ||
+ | |||
+ | |- | ||
+ | || Ctrl+Alt+T keys | ||
+ | || Open the '''terminal '''by pressing '''Ctrl+Alt+T''' keys simultaneously on the keyboard. | ||
+ | |||
+ | |- | ||
+ | || sudo apt-get update >> Enter | ||
+ | |||
+ | |||
+ | |||
+ | || We have to first of all ensure that our '''Ubuntu Linux '''installation is up-to-date. | ||
+ | |||
+ | |||
+ | For that copy this '''command''' from the '''Code file''' and paste it in the '''terminal'''. | ||
+ | |||
+ | And press '''Enter.''' | ||
+ | |||
+ | |- | ||
+ | || System password >> Enter | ||
+ | || From now on, type the '''System password '''whenever prompted during installation. | ||
+ | |||
+ | And press '''Enter''' | ||
+ | |||
+ | |- | ||
+ | || Select | ||
+ | |||
+ | |||
+ | ''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'' | ||
+ | || This '''command''' will create a file named '''koha.list''' and update the '''package repository.''' | ||
+ | |||
+ | |||
+ | Please note: '''Koha 16.05''' was the stable version at the time of creation of this tutorial. | ||
+ | |||
+ | |- | ||
+ | || Copy | ||
+ | |||
+ | ''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'' | ||
+ | |||
+ | |||
+ | ''Paste in '''terminal '''''and Press '''Enter.''' | ||
+ | || Copy this '''command''' from the '''Code file''' and paste it in the '''terminal'''. | ||
+ | |||
+ | And press '''Enter.''' | ||
+ | |||
+ | |- | ||
+ | || Copy | ||
+ | |||
+ | |||
+ | ''wget -O- [http://debian.koha-community.org/koha/gpg.asc http://debian.koha-][http://debian.koha-community.org/koha/gpg.asc community.org/koha/gpg.asc] | sudo apt-key add -'' | ||
+ | |||
+ | |||
+ | Paste in '''terminal''' and Press '''Enter.''' | ||
+ | || Then, this will download '''gpg.asc file''' and update the '''signature key'''. | ||
+ | |||
+ | |||
+ | Copy this '''command''' from the '''Code file''' and paste it in the '''terminal'''. | ||
+ | |||
+ | And press '''Enter.''' | ||
+ | |||
+ | |- | ||
+ | || Copy | ||
+ | |||
+ | |||
+ | ''sudo apt-get update'' | ||
+ | |||
+ | Paste in '''terminal''' and Press '''Enter.''' | ||
+ | || Now copy this '''command''' from the '''Code file''' and paste it in the '''terminal'''. | ||
+ | |||
+ | And press '''Enter.''' | ||
+ | |||
+ | |||
+ | This will update the new '''repositories'''. | ||
+ | |||
+ | |- | ||
+ | || Copy | ||
+ | |||
+ | sudo apt-get install koha-common | ||
+ | |||
+ | |||
+ | Paste in '''terminal''' and Press '''Enter.''' | ||
+ | || Now type '''sudo apt-get install koha-common''' and press '''Enter.''' | ||
+ | |||
+ | |||
+ | |- | ||
+ | || Press Y | ||
+ | || Press '''Y '''when asked if you want to continue and press '''Enter''' | ||
+ | |||
+ | |- | ||
+ | || | ||
+ | || This will install '''Koha''' on your system. | ||
+ | |||
+ | |||
+ | Wait for the installation to complete. | ||
+ | |||
+ | This will take some time. | ||
+ | |||
+ | |- | ||
+ | || | ||
+ | || 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. | ||
+ | |||
+ | |- | ||
+ | || Copy | ||
+ | |||
+ | sudo gedit /etc/koha/koha-sites.conf | ||
+ | |||
+ | |||
+ | Paste in '''terminal''' and Press '''Enter.''' | ||
+ | || Copy this '''command''' from the '''Code file''' and paste it in the '''terminal'''. | ||
+ | |||
+ | 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'''. | ||
+ | |||
+ | |- | ||
+ | || Copy | ||
+ | |||
+ | sudo apt-get install mariadb-server | ||
+ | |||
+ | |||
+ | Paste in '''terminal''' and Press '''Enter.''' | ||
+ | || Copy this '''command''' from the '''Code file''' and paste it in the '''terminal'''. | ||
+ | |||
+ | And press '''Enter.''' | ||
+ | |||
+ | |||
+ | Press''' Y '''when asked if you want to continue and press '''Enter''' | ||
+ | |||
+ | |- | ||
+ | || Copy | ||
+ | |||
+ | sudo mysqladmin -u root password admin123 | ||
+ | |||
+ | |||
+ | Paste in '''terminal''' and Press '''Enter.''' | ||
+ | || Next set the '''password''' for''' root user''' as '''admin123 '''for the '''database'''. | ||
+ | |||
+ | |||
+ | You could give a different '''password''' if you wish. | ||
+ | |||
+ | |||
+ | Copy this '''command''' from the '''Code file''' and paste it in the '''terminal'''. | ||
+ | |||
+ | Press '''Enter.''' | ||
+ | |||
+ | |- | ||
+ | || Copy | ||
+ | |||
+ | sudo a2enmod rewrite | ||
+ | |||
+ | sudo a2enmod cgi | ||
+ | |||
+ | |||
+ | Paste them on the '''terminal''' and press '''Enter'''. | ||
+ | || Next copy these two commands one by one, paste them on the '''terminal''' and press '''Enter'''. | ||
+ | |||
+ | |||
+ | '''sudo a2enmod rewrite ''' | ||
+ | |||
+ | |||
+ | '''sudo a2enmod cgi ''' | ||
+ | |||
+ | |||
+ | This will enable the '''modules''' of '''Koha'''. | ||
+ | |||
+ | |- | ||
+ | || Type | ||
+ | |||
+ | sudo service apache2 restart >> Enter | ||
+ | || Then type | ||
+ | |||
+ | '''sudo service apache2 restart''' | ||
+ | |||
+ | |||
+ | This will restart '''apache services '''. | ||
+ | |||
+ | Then press '''Enter'''. | ||
+ | |||
+ | |- | ||
+ | || Copy | ||
+ | |||
+ | |||
+ | sudo koha-create --create-db library | ||
+ | |||
+ | Paste it in the '''terminal''' and Press '''Enter.''' | ||
+ | || To create a '''Koha instance''' named '''library'''- | ||
+ | |||
+ | # Copy this '''command''' from the '''Code file '''and paste it in the '''terminal''' | ||
+ | # and press '''Enter.''' | ||
+ | |||
+ | |- | ||
+ | || Copy: | ||
+ | |||
+ | |||
+ | sudo gedit /etc/apache2/ports.conf | ||
+ | |||
+ | Paste it in the '''terminal''' and Press '''Enter.''' | ||
+ | || 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'''. | ||
+ | |||
+ | |||
+ | Copy this '''command''' from the '''Code file '''and paste it in the '''terminal'''. | ||
+ | |||
+ | 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. | ||
+ | |||
+ | |- | ||
+ | || Copy | ||
+ | |||
+ | sudo service apache2 restart | ||
+ | |||
+ | paste it in the '''terminal''' and Press '''Enter.''' | ||
+ | || Then restart '''apache services.''' | ||
+ | |||
+ | |||
+ | Copy this '''command''' from the '''Code file '''and paste it in the '''terminal'''. | ||
+ | |||
+ | And press '''Enter.''' | ||
+ | |||
+ | |- | ||
+ | || Copy | ||
+ | |||
+ | sudo a2dissite 000-default | ||
+ | |||
+ | |||
+ | Paste it in the '''terminal''' and Press '''Enter.''' | ||
+ | || Next copy this '''command''' from the '''Code file '''and paste it in the '''terminal'''. | ||
+ | |||
+ | And press '''Enter.''' | ||
+ | |||
+ | |||
+ | This is to disable the '''000-default''' site. | ||
+ | |||
+ | |- | ||
+ | || Point to message | ||
+ | || The message confirms that it is disabled. | ||
+ | |||
+ | |- | ||
+ | || | ||
+ | || Let's move on. | ||
+ | |||
+ | |- | ||
+ | || Copy | ||
+ | |||
+ | sudo a2enmod deflate | ||
+ | |||
+ | sudo a2ensite library | ||
+ | |||
+ | |||
+ | Paste it in the '''terminal''' and Press '''Enter.''' | ||
+ | || Copy these two '''commands''' one by one, paste them on the '''terminal''' and press '''Enter'''. | ||
+ | |||
+ | |||
+ | '''sudo a2enmod deflate '''and press '''Enter'''. | ||
+ | |||
+ | '''sudo a2ensite library '''and press '''Enter'''. | ||
+ | |||
+ | |||
+ | The message on the '''terminal''' confirms that the''' site library''' is enabled. | ||
+ | |||
+ | |- | ||
+ | || Copy | ||
+ | |||
+ | sudo service apache2 restart | ||
+ | |||
+ | Paste it in the '''terminal''' and press '''Enter.''' | ||
+ | || Copy this '''command''' from the '''Code file '''and paste it in the '''terminal'''. | ||
+ | |||
+ | And press '''Enter.''' | ||
+ | |||
+ | |- | ||
+ | || Copy | ||
+ | sudo su >> Enter | ||
+ | |||
+ | Paste it in the '''terminal''' and press '''Enter.''' | ||
+ | |Then type '''sudo s u '''and press''' Enter'''. | ||
+ | |||
+ | |||
+ | We are now in the '''superuser''' that is '''root user''' mode. | ||
+ | |||
+ | |- | ||
+ | || Copy | ||
+ | |||
+ | mysql -u root -p >> Enter | ||
+ | |||
+ | |||
+ | Paste it in the '''terminal''' and Press '''Enter.''' | ||
+ | || Copy this command from the '''Code file '''and paste it in the '''terminal'''. | ||
+ | |||
+ | Press '''Enter.''' | ||
+ | |||
+ | |- | ||
+ | || Type password >> Enter | ||
+ | |||
+ | || Type the '''password''' when prompted, '''admin123 '''and Press '''Enter'''. | ||
+ | |||
+ | |- | ||
+ | | | ||
+ | |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.''' | ||
+ | |||
+ | |- | ||
+ | || SET PASSWORD FOR 'koha_library'@'localhost' = PASSWORD('koha123'); | ||
+ | || Now type the following '''command''' carefully as shown and press '''Enter'''. | ||
+ | |||
+ | |||
+ | This will set the '''password''' for the '''user koha_library''' as '''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.''' | ||
+ | |||
+ | |- | ||
+ | || Copy | ||
+ | |||
+ | 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.''' | ||
+ | |||
+ | |- | ||
+ | || Type | ||
+ | |||
+ | mysql >> Enter | ||
+ | || In this file, search for the '''keyword mysql'''. | ||
+ | |||
+ | |- | ||
+ | || Highlight mysql | ||
+ | || Scroll down and 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.0.1:8080 | ||
+ | |||
+ | Press Enter | ||
+ | || In the '''address bar''', type '''127.0.0.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. | ||
+ | |||
+ | |- | ||
+ | || 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'''”. | ||
+ | |||
+ | |- | ||
+ | || 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'''. | ||
+ | |||
+ | |- | ||
+ | || New page | ||
+ | || 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. | ||
+ | |||
+ | |||
+ | 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''' 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 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/ 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 http://spoken-tutorial.org/NMEICT-Intro] | ||
+ | || [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. | ||
+ | |||
+ | |} |
Latest revision as of 03:15, 8 November 2019
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-
|
Slide | The commands used in this tutorial are available in the Code Files link below the player. |
Switch to gedit text editor and open the file | I have opened this file in gedit text editor on my machine.
|
Let’s begin. | |
Ctrl+Alt+T keys | Open the terminal by pressing Ctrl+Alt+T keys simultaneously on the keyboard. |
sudo apt-get update >> Enter
|
We have to first of all ensure that our Ubuntu Linux installation is up-to-date.
And press Enter. |
System password >> Enter | From now on, type the System password whenever prompted during installation.
And press Enter |
Select
|
This command will create a file named koha.list and update the package repository.
|
Copy
echo deb http://debian.koha-community.org/koha 16.05 main | sudo tee /etc/apt/sources.list.d/koha.list
|
Copy this command from the Code file and paste it in the terminal.
And press Enter. |
Copy
|
Then, this will download gpg.asc file and update the signature key.
And press Enter. |
Copy
Paste in terminal and Press Enter. |
Now copy this command from the Code file and paste it in the terminal.
And press Enter.
|
Copy
sudo apt-get install koha-common
|
Now type sudo apt-get install koha-common and press Enter.
|
Press Y | Press Y when asked if you want to continue and press Enter |
This will install Koha on your system.
This will take some time. | |
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. | |
Copy
sudo gedit /etc/koha/koha-sites.conf
|
Copy this command from the Code file and paste it in the terminal.
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. | |
Copy
sudo apt-get install mariadb-server
|
Copy this command from the Code file and paste it in the terminal.
And press Enter.
|
Copy
sudo mysqladmin -u root password admin123
|
Next set the password for root user as admin123 for the database.
Press Enter. |
Copy
sudo a2enmod rewrite sudo a2enmod cgi
|
Next copy these two commands one by one, paste them on the terminal and press Enter.
|
Type
sudo service apache2 restart >> Enter |
Then type
sudo service apache2 restart
Then press Enter. |
Copy
Paste it in the terminal and Press Enter. |
To create a Koha instance named library-
|
Copy:
Paste it in the terminal and Press Enter. |
Next, we have to tell Apache server that we are using port 8080.
And press Enter. |
Add 8080 | In the ports.conf file, search for the line Listen 80
|
Ctrl+S >> close file | Then save and close the file. |
Copy
sudo service apache2 restart paste it in the terminal and Press Enter. |
Then restart apache services.
And press Enter. |
Copy
sudo a2dissite 000-default
|
Next copy this command from the Code file and paste it in the terminal.
And press Enter.
|
Point to message | The message confirms that it is disabled. |
Let's move on. | |
Copy
sudo a2enmod deflate sudo a2ensite library
|
Copy these two commands one by one, paste them on the terminal and press Enter.
sudo a2ensite library and press Enter.
|
Copy
sudo service apache2 restart Paste it in the terminal and press Enter. |
Copy this command from the Code file and paste it in the terminal.
And press Enter. |
Copy
sudo su >> Enter Paste it in the terminal and press Enter. |
Then type sudo s u and press Enter.
|
Copy
mysql -u root -p >> Enter
|
Copy this command from the Code file and paste it in the terminal.
Press Enter. |
Type password >> Enter | Type the password when prompted, admin123 and Press Enter. |
We are now inside our MariaDB prompt. | |
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. |
SET PASSWORD FOR 'koha_library'@'localhost' = PASSWORD('koha123'); | Now type the following command carefully as shown and press Enter.
|
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. |
Copy
sudo gedit /etc/koha/sites/library/koha-conf.xml Press Enter |
We will now open the koha-conf.xml file in a text editor.
|
Type
mysql >> Enter |
In this file, search for the keyword mysql. |
Highlight mysql | Scroll down and 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.0.1:8080
Press Enter |
In the address bar, type 127.0.0.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. |
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”. |
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. | |
New page | 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 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
|
[1]Spoken Tutorial project is funded by NMEICT, MHRD, Government of India.
|
The script has been contributed by Nancy and video by Praveen.
|