Koha-Library-Management-System/C2/Koha-installation-on-Linux-16.04/English

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 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 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 | 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 athttp://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 Tutorial 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	[1]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.

Contributors and Content Editors

Nancyvarkey, PoojaMoolya, Pravin1389