Joomla/C2/Common-mistakes-and-uninstalling-Joomla/English-timed

From Script | Spoken-Tutorial
Jump to: navigation, search
Time Narration
00:01 Welcome to the Spoken Tutorial on Common Mistakes while Installing Joomla and Uninstalling Joomla on a local server.
00:11 In this tutorial, we will learn about:

common mistakes when installing Joomla,

solutions to those mistakes and how to uninstall Joomla.

00:23 For this tutorial, we will be using:

Ubuntu Linux 14.04,

Joomla 3.4.1,

Apache, MySQL and PHP obtained through XAMPP 5.5.19.

00:41 To follow this tutorial, you need to have XAMPP and Joomla installed on your system.
00:49 You also need to have knowledge of the Joomla installation process.
00:54 If not, check the relevant tutorial in the Joomla series, on the spoken tutorial website.
01:02 First of all, let me start XAMPP on my machine.
01:06 Let's open the terminal by pressing Ctrl + Alt + T keys.
01:12 Alternately, click on the “Terminal” icon in the launcher bar.
01:17 Start XAMPP by typing sudo space slash opt slash lampp slash lampp space start and press Enter.
01:28 It will prompt for administrative password.
01:31 Let me type my administrative password and press Enter.
01:36 Now we have XAMPP running.
01:39 The first mistake one can make is to extract Joomla in a different directory.
01:45 Go to the browser and open the XAMPP page by typing http colon double slash localhost and press Enter.
01:55 In the menu on the left of the screen, click on phpinfo().
02:00 Now press Ctrl +F keys and search for DOCUMENT underscore ROOT.
02:07 It will be found in the table Apache Environment.
02:11 Value of DOCUMENT underscore ROOT will be either slash opt slash lampp slash htdocs or slash var slash www.
02:24 In my machine, it is slash opt slash lampp slash htdocs.
02:30 Please note that Joomla needs to be extracted in the apache DOCUMENT underscore ROOT directory.
02:37 If this is not the case, the installation setting page would not show up at all.
02:43 Second common mistake that one can make is to have the output buffering ON.
02:49 In the 3rd step of the installation setup, output buffering should be marked as OFF.
02:55 This is a recommended setting and not a required setting.
02:59 Usually, by default, it is turned OFF.
03:03 If output buffering is ON, installation might proceed successfully.
03:08 However, the website might be extremely slow later.
03:12 In some cases, installation might hang up at this step.
03:17 In case it is ON, we can turn it OFF by editing php.ini in the apache installation.
03:24 We will go to the terminal window and locate php.ini first by typing locate space php dot ini and press Enter.
03:37 We may get a number of results for this query.
03:40 There will be one result in which php.ini will be inside the etc directory.
03:48 This directory is inside the lampp directory, inside the opt directory.
03:54 This is the one we need to edit.
03:57 In my machine, the path to that file is slash opt slash lampp slash etc slash php.ini.
04:07 We open the file in Gedit text editor by typing sudo space gedit space slash opt slash lampp slash etc slash php dot ini.
04:23 If prompted, enter your admin password.
04:27 You will have to do so whenever prompted, as we proceed.
04:32 Gedit is the default text-editor preloaded in Ubuntu Linux.
04:37 Alternately, you can use any text editor of your choice.
04:42 When the file is open, search for output underscore buffering.
04:48 The first search result we get is commented. So, we check for the next result.
04:54 Here we find the text we are looking for.
04:57 Change output underscore buffering = 4096 to output underscore buffering = off.
05:05 We save the file by pressing Control + S keys.
05:09 We can then exit the Gedit editor.
05:12 We need to restart XAMPP for the change to get reflected.
05:16 Switch to the terminal and type: sudo space slash opt slash lampp slash lampp space restart.
05:25 Press Enter.
05:27 So, we can proceed to the next step.
05:30 The third mistake you can make is to have no write permission for the configuration file.
05:36 In the last step of installation, you might get an error that says “Your configuration file or directory is not writable or there was a problem creating the configuration file”.
05:48 This occurs when we forget to give write permission to the Joomla folder.
05:53 If this error occurs, you will get some text inside a text box.
05:58 We will copy this text using Control + C keys.
06:02 In this case, we can create a new configuration.php file and paste the text into it.
06:09 We will use the touch command to create the configuration.php inside our joomla folder.
06:16 At the command prompt, type: sudo space touch space slash opt slash lampp slash htdocs slash joomla slash configuration dot php.
06:32 Press Enter.
06:34 Then type: sudo space gedit space slash opt slash lampp slash htdocs slash joomla slash configuration dot php.
06:46 Press Enter.
06:49 This will open the file in Gedit text editor.
06:52 Paste the copied text inside this file.
06:56 Check the file to make sure left bracket, question mark, php is present as the first line of the file and the content is exactly the same.
07:08 Save the configuration.php by pressing Control + S keys.
07:14 We can then exit the Gedit editor.
07:17 Now we have the configuration.php for our Joomla installation.
07:22 Now, we will see the fourth mistake that one can make during the Joomla installation.
07:27 This is to not delete the installation folder in the Finish step.
07:32 I cannot emphasize the importance of this step enough.
07:36 This is one of the most common mistakes.
07:39 So, make sure the folder is deleted.
07:42 If you get an error in this step, you must remove the folder manually.
07:47 I got an error because I am not logged-in as linux superuser and don't have delete permission.
07:56 So, now let us switch to the terminal.
07:59 We will delete the Joomla installation folder manually, from the joomla folder.
08:04 This is mandatory. So, type: cd slash opt slash lampp slash htdocs slash joomla.
08:14 Press Enter.
08:16 Then type: sudo space rm space minus rf space installation forward slash.
08:25 Press Enter.
08:27 We have now successfully installed Joomla.
08:30 We can check this by going to the browser and typing http colon double slash localhost slash joomla.
08:40 We can see our webpage.
08:43 We will now talk about uninstalling Joomla.
08:46 We need to first delete the folder into which we extracted Joomla.
08:51 So, I will switch to the terminal and type: sudo space rm space minus rf space forward slash opt slash lampp slash htdocs slash joomla slash.
09:07 Press Enter.
09:09 Now, type: cd forward slash opt slash lampp slash htdocs slash joomla.
09:17 This is to check if the folder is deleted.
09:20 As you can see, the directory does not exist.
09:24 We will then delete the database and the users.
09:28 This step will uninstall Joomla completely.
09:33 I will first go to the browser and type: http colon double slash localhost slash phpmyadmin.
09:44 I will click on the Users tab and select the user Joomla-1.
09:50 Below, there is an option- Drop the databases that have same names as the users. Click on it.
09:57 This will give you a prompt . You are about to DESTROY a complete database! Do you really want to execute DROP DATABASE? Click on OK.
10:07 Now click on GO button at the bottom right.
10:11 We have now successfully uninstalled Joomla from our localhost.
10:16 Let us summarize. In this tutorial, we learnt about:

common mistakes and their solutions when installing Joomla and to uninstall Joomla.

10:28 Let's come to the assignment now.
10:30 Install Joomla.

Uninstall Joomla.

Check if Joomla is indeed uninstalled and install Joomla once again.

10:41 The video at this link, summarizes the Spoken Tutorial project.
10:46 If you do not have good bandwidth, you can download and watch it.
10:51 The Spoken Tutorial Project team conducts workshops using spoken tutorials and gives certificates on passing online tests.
10:59 For more details, please write to us.
11:03 Spoken Tutorial Project is supported by NMEICT, MHRD, Government of India.
11:10 This is Priyanka, signing off. Thank you for joining.

Contributors and Content Editors

PoojaMoolya, Sandhya.np14, Venuspriya