Difference between revisions of "Joomla/C2/Common-mistakes-and-uninstalling-Joomla/English"

From Script | Spoken-Tutorial
Jump to: navigation, search
(Created page with '{| border=1 || '''Visual Cue''' || '''Narration''' |- || '''Show Slide 1''' Common Mistakes when installing Joomla and Uninstalling Joomla || Welcome to the Spoken Tutorial on …')
 
Line 73: Line 73:
 
|-
 
|-
 
||
 
||
 
+
|| Now we have''' XAMPP''' running.  
|| '''Now we have XAMPP running. '''
+
 
+
|-
+
||
+
 
+
|| Now, let us see the common mistakes one can make during ''' Joomla''' installation.
+
  
 
|-
 
|-
Line 104: Line 98:
 
|| Now press '''Ctrl +F ''' keys and search for  
 
|| Now press '''Ctrl +F ''' keys and search for  
 
'''DOCUMENT underscore ROOT.'''
 
'''DOCUMENT underscore ROOT.'''
 +
 +
It will be found in the table '''Apache Environment'''.
  
 
|-
 
|-
Line 121: Line 117:
 
|| Highlight ''' DOCUMENT_ROOT'''
 
|| Highlight ''' DOCUMENT_ROOT'''
  
|| Please note that Joomla needs to be extracted in the '''apache DOCUMENT underscore ROOT''' directory.
+
|| Please note that '''Joomla''' needs to be extracted in the '''apache DOCUMENT underscore ROOT''' directory.
  
 
If this is not the case, the installation setting page would not show up at all.
 
If this is not the case, the installation setting page would not show up at all.
Line 144: Line 140:
 
However, the website might be extremely slow later.  
 
However, the website might be extremely slow later.  
  
In some cases, installation might hang up at this step itself.
+
In some cases, installation might hang up at this step.
  
 
|-
 
|-
Line 164: Line 160:
 
|| We may get a number of results for this query.  
 
|| We may get a number of results for this query.  
  
There will be one result in which '''php.ini''' is inside the etc directory.  
+
There will be one result in which '''php.ini''' will be inside the '''etc''' directory.  
  
This directory is inside the lampp directory inside the opt directory.  
+
This directory is inside the '''lampp''' directory inside the '''opt''' directory.  
  
 
This is the one we need to edit.
 
This is the one we need to edit.
Line 209: Line 205:
  
 
'''output buffering: off'''
 
'''output buffering: off'''
 
 
 
|| Change  
 
|| Change  
 
''' output_buffering = 4096'''
 
''' output_buffering = 4096'''
Line 232: Line 226:
 
Type '''sudo /opt/lampp/lampp restart'''
 
Type '''sudo /opt/lampp/lampp restart'''
  
|| Switch to the '''terminal'''.
+
|| Switch to the '''terminal''' and type
 
+
Type
+
  
'''sudo space slash opt slash lampp slash lampp space restart.'''
+
'''sudo space slash opt slash lampp slash lampp space restart'''
  
 
Press ''' Enter.'''
 
Press ''' Enter.'''
Line 243: Line 235:
 
|| (Go to browser, we are already on the Step 2 of the installation page)
 
|| (Go to browser, we are already on the Step 2 of the installation page)
  
|| Now go to the installation page again
+
|| Now go to the installation page again.
  
 
|-
 
|-
Line 254: Line 246:
  
 
|| ''' Output Buffering''' is now turned to ''' OFF'''.  
 
|| ''' Output Buffering''' is now turned to ''' OFF'''.  
So, we can proceed to the next step of installation
+
 
 +
So, we can proceed to the next step of installation.
  
 
|-
 
|-
Line 268: Line 261:
 
|| In the last step of installation, you might get an error that says  
 
|| 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”.'''
 
“'''Your configuration file or directory is not writable or there was a problem creating the configuration file”.'''
 +
  
 
This occurs when we forget to give ''' write permission''' to the ''' Joomla''' folder.
 
This occurs when we forget to give ''' write permission''' to the ''' Joomla''' folder.
Line 275: Line 269:
  
 
|| If this error occurs, you will get some text inside a text box.
 
|| If this error occurs, you will get some text inside a text box.
We will copy this text using '''Control + C '''keys'''.'''
+
 
 +
 
 +
We will copy this text using '''Control + C '''keys.
  
 
|-
 
|-
Line 288: Line 284:
  
  
At the command prompt type  
+
At the '''command prompt''' type  
  
 
'''sudo space touch space slash opt slash lampp slash htdocs slash joomla slash configuration dot php'''
 
'''sudo space touch space slash opt slash lampp slash htdocs slash joomla slash configuration dot php'''
Line 326: Line 322:
  
 
||We can then exit the '''Gedit ''' editor.
 
||We can then exit the '''Gedit ''' editor.
 +
 +
Now we have the '''configuration.php''' for our '''Joomla''' installation.
  
 
|-
 
|-
Line 332: Line 330:
  
 
||Now, we will see the fourth mistake that one can make during the ''' Joomla''' installation.
 
||Now, we will see the fourth mistake that one can make during the ''' Joomla''' installation.
 +
 +
 
This is to not delete the '''installation ''' folder in the '''Finish''' step.
 
This is to not delete the '''installation ''' folder in the '''Finish''' step.
  
Line 339: Line 339:
  
 
||I cannot emphasize the importance of this step enough.
 
||I cannot emphasize the importance of this step enough.
 +
 +
 
This is one of the most common mistakes.
 
This is one of the most common mistakes.
 
So, make sure the folder is deleted.  
 
So, make sure the folder is deleted.  
Line 346: Line 348:
  
 
||If you get an error in this step, you must remove the folder manually.
 
||If you get an error in this step, you must remove the folder manually.
I got an error because I am not logged-in as '''linux''' '''superuser''' and don't have '''delete permission'''  
+
 
 +
 
 +
I got an error because I am not logged-in as '''linux superuser''' and don't have '''delete permission'''  
  
 
|-
 
|-
Line 352: Line 356:
  
 
||So, now let us switch to the ''' terminal.'''
 
||So, now let us switch to the ''' terminal.'''
 +
 +
 
We will delete the installation folder manually from the '''joomla''' folder.  
 
We will delete the installation folder manually from the '''joomla''' folder.  
  
Line 366: Line 372:
  
 
Then type
 
Then type
''' sudo space rm space hyphen rf space installation forward slash. '''
+
''' sudo space rm space minus rf space installation forward slash'''
  
 
Press ''' Enter'''
 
Press ''' Enter'''
Line 374: Line 380:
 
Type ''' http://localhost/joomla'''
 
Type ''' http://localhost/joomla'''
  
||We have now successfully installed ''' Joomla. ''' We can check this by going to the browser and typing
+
||We have now successfully installed ''' Joomla. '''  
 +
 
 +
 
 +
We can check this by going to the browser and typing
 
''' http colon double slash localhost slash joomla'''
 
''' http colon double slash localhost slash joomla'''
 +
 +
 
We can see our webpage.
 
We can see our webpage.
  
Line 390: Line 401:
  
 
||We need to first delete the folder into which we extracted ''' Joomla.'''
 
||We need to first delete the folder into which we extracted ''' Joomla.'''
 +
 +
 
So, I will switch to the '''terminal '''and type
 
So, I will switch to the '''terminal '''and type
  
''' sudo space rm space hyphen rf space forward slash opt forward slash lampp slash htdocs forward slash joomla slash'''
+
''' sudo space rm space minus rf space forward slash opt slash lampp slash htdocs slash joomla slash'''
 +
 
 +
Press '''Enter'''.
  
 
|-
 
|-
Line 399: Line 414:
  
 
||Now type  
 
||Now type  
'''cd forward slash opt forward slash lampp slash htdocs slash joomla slash '''  
+
'''cd forward slash opt slash lampp slash htdocs slash joomla slash '''  
 +
 
  
 
This is to check if the folder is deleted.  
 
This is to check if the folder is deleted.  
  
As you see, the directory does not exist.
+
As you can see, the directory does not exist.
  
 
|-
 
|-
Line 410: Line 426:
  
 
||We will then delete the database and the users.
 
||We will then delete the database and the users.
 +
 +
 
This step will uninstall '''Joomla '''completely.
 
This step will uninstall '''Joomla '''completely.
  
I will first go to the browser and type
+
|-
 +
||On the browser type
 +
||I will first go to the browser and type
  
 
'''http colon double slash localhost slash phpmyadmin'''
 
'''http colon double slash localhost slash phpmyadmin'''
Line 434: Line 454:
  
 
||This will give you a prompt  
 
||This will give you a prompt  
''' You are about to DESTROY a complete database. Do you really want to execute DROP DATABASE.'''  
+
''' You are about to DESTROY a complete database! Do you really want to execute DROP DATABASE?'''  
  
 
Click on '''OK.'''
 
Click on '''OK.'''

Revision as of 15:18, 30 September 2014

Visual Cue Narration
Show Slide 1

Common Mistakes when installing Joomla and Uninstalling Joomla

Welcome to the Spoken Tutorial on

Common Mistakes while Installing Joomla and Uninstalling Joomla

on a local server.

Show Slide 2

Learning Objectives

  • Common Mistakes when installing Joomla
  • Solutions to common mistakes
  • Uninstall Joomla
In this tutorial, we will learn about:
  • Common mistakes when installing Joomla
  • Solutions to those mistakes and
  • How to uninstall Joomla
Show Slide 3

Versions and OS

For this tutorial, we will be using:
  • Ubuntu 14.04
  • Joomla 2.5.22
  • Apache, MySQL and PHP obtained through XAMPP 1.8.2
Show Slide 4

Prerequisites

To follow this tutorial, you need to have:
  • XAMPP and Joomla installed on your system

You also need to have knowledge of the Joomla installation process.

If not, check the relevant tutorial in the Joomla series on the spoken tutorial website.

First of all, let me start XAMPP on my machine.
Open terminal by pressing Ctrl+Alt+T


Let's open the terminal by pressing Ctrl + Alt + T keys.

Alternately, click on the “Terminal” icon in the launcher bar.

Type

sudo /opt/lampp/lampp start

Start XAMPP by typing

sudo space slash opt slash lampp slash lampp space start and press Enter.

It will prompt for administrative password.
Enter administrator password >> Press Enter Let me enter my administrative password and press Enter.
Now we have XAMPP running.
Switch to Slide 5:

Joomla is extracted in a different directory

The first mistake one can make is to extract Joomla in a different directory.
Switch to browser

Type http://localhost

Go the the browser and open the XAMPP page by typing

http colon double slash localhost and press Enter

In the left menu >> click on phpinfo() In the menu on the left of the screen, click on phpinfo().
Type Ctrl+F and write DOCUMENT_ROOT in the search window >> Press Enter Now press Ctrl +F keys and search for

DOCUMENT underscore ROOT.

It will be found in the table Apache Environment.

Value of DOCUMENT underscore ROOT will be either

*slash opt slash lampp slash htdocs or

*slash var slash www

Point or highlight /opt/lampp/htdocs. In my machine, it is slash opt slash lampp slash htdocs.
Highlight DOCUMENT_ROOT Please note that Joomla needs to be extracted in the apache DOCUMENT underscore ROOT directory.

If this is not the case, the installation setting page would not show up at all.

Show Slide 6:

Output buffering to be turned off.

Second common mistake that one can make is to have the output buffering ON.
Switch to the browser:

On the browser, show the page for 2nd step (pre-installation check) Highlight output buffering

In the 2nd step of the installation setup, output buffering should be marked as OFF.

This is a recommended setting and not a required setting. Usually, by default, it is turned OFF.

If output_buffering is ON, installation might proceed successfully.

However, the website might be extremely slow later.

In some cases, installation might hang up at this step.

In case it is ON, we can turn it OFF by editing php.ini in the apache installation.
(Switch to terminal)

Type locate php.ini

We will go to the terminal window and locate php.ini first by typing

locate space php dot ini and press Enter.

Highlight the php.ini inside /opt/lampp/etc


We may get a number of results for this query.

There will be one result in which php.ini will be inside the etc directory.

This directory is inside the lampp directory inside the opt directory.

This is the one we need to edit.

In my machine, the path to that file is slash opt slash lampp slash etc slash php.ini

Type sudo gedit /etc/php5/apache2/php.ini We open the file in Gedit text editor by typing

sudo space gedit space slash opt slash lampp slash etc slash php dot ini

If prompted, enter your admin password.

You will have to do so whenever prompted, as we proceed.

Gedit is the default text editor preloaded in Ubuntu Linux.

Alternately, you can use any text editor of your choice.

Press Ctrl + F.

Type output_buffering

When the file is open, search for output underscore buffering.
Highlight down arrow on the search box in gedit editor to go to the next result. The first search result we get is commented. So we check for the next result.

Here we find the text we are looking for.

Change

output buffering: 4096

to

output buffering: off

Change

output_buffering = 4096 to output_buffering = off

Type Ctrl + S

Click on the File menu on top left. Click Quit

We save the file by pressing Control + S keys.

We can then exit the Gedit editor.

We need to restart XAMPP for the change to get reflected.
Switch to the terminal.

Type sudo /opt/lampp/lampp restart

Switch to the terminal and type

sudo space slash opt slash lampp slash lampp space restart

Press Enter.

(Go to browser, we are already on the Step 2 of the installation page) Now go to the installation page again.
Click on Check Again Now click on Check Again button at the top right, to check the configuration.
Highlight Output Buffering Output Buffering is now turned to OFF.

So, we can proceed to the next step of installation.

Show Slide 7:

Configuration file not writable:

The third mistake you can make is to have no write permission for the configuration file.
(Shift to Browser)

Highlight the error message on the final step of the installation page.

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”.


This occurs when we forget to give write permission to the Joomla folder.

Copy text from the textbox >> Ctrl + C If this error occurs, you will get some text inside a text box.


We will copy this text using Control + C keys.

In this case, we can create a new configuration.php file and paste the text into it.
Type sudo touch /'opt/lampp/htdocs/joomla/configuration.php We will use the touch command to create the configuration.php inside our joomla folder.


At the command prompt type

sudo space touch space slash opt slash lampp slash htdocs slash joomla slash configuration dot php


Press Enter.

Type sudo gedit /opt/lampp/htdocs/joomla/configuration.php Then type

sudo space gedit space slash opt slash lampp slash htdocs slash joomla slash configuration dot php.

Press Enter.

This will open the file in Gedit text editor.

Paste >> Ctrl+V Paste the copied text inside this file.
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
Type Ctrl + S Save the configuration.php by pressing Control + S keys.
Click on File menu on top left, and click on Quit. We can then exit the Gedit editor.

Now we have the configuration.php for our Joomla installation.

Show Slide 8:

Installation folder not deleted.

Now, we will see the fourth mistake that one can make during the Joomla installation.


This is to not delete the installation folder in the Finish step.

Switch to the browser

Highlight the Remove Installation Folder button

I cannot emphasize the importance of this step enough.


This is one of the most common mistakes. So, make sure the folder is deleted.

If you get an error in this step, you must remove the folder manually.


I got an error because I am not logged-in as linux superuser and don't have delete permission

Switch to terminal. So, now let us switch to the terminal.


We will delete the installation folder manually from the joomla folder.

This is mandatory.

Type cd joomla

Type sudo rm -rf installation/

So, type

cd slash opt slash lampp slash htdocs slash joomla

Press Enter

Then type sudo space rm space minus rf space installation forward slash

Press Enter

Switch to the browser

Type http://localhost/joomla

We have now successfully installed Joomla.


We can check this by going to the browser and typing http colon double slash localhost slash joomla


We can see our webpage.

Show Slide 9:

(Uninstalling Joomla)

We will now talk about uninstalling Joomla.
Switch to terminal

Type sudo rm -rf /opt/lampp/htdocs/joomla/


We need to first delete the folder into which we extracted Joomla.


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

Press Enter.

Type cd /opt/lampp/htdocs/joomla

Highlight the result destination directory does not exist

Now type

cd forward slash opt slash lampp slash htdocs slash joomla slash


This is to check if the folder is deleted.

As you can see, the directory does not exist.

Switch to browser

Go to http://localhost/phpmyadmin

We will then delete the database and the users.


This step will uninstall Joomla completely.

On the browser type I will first go to the browser and type

http colon double slash localhost slash phpmyadmin

Click on Users tab

Select user Joomla-1

I will click on the Users tab and select the user Joomla-1
Select Drop the databases that have same names as the users Below, there is an option

Drop the databases that have same names as the users.

Click on it.

Click OK in confirmation prompt 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.

Click on GO in the bottom right Now click on GO button at the bottom right.


We have now successfully uninstalled Joomla from our localhost.
Show Slide 10:

(Summary)

Let us summarize.

In this tutorial, we learnt about:

  • Common Mistakes and their solutions when installing Joomla
  • and to uninstall Joomla
Show Slide 11:

(Assignment)

Let's come to the assignment now.
  • Install Joomla.
  • Uninstall Joomla
  • Check if Joomla is indeed uninstalled and
  • Install Joomla once again
Show Slide 12:

(About Spoken Tutorial Project)

The video at this link, summarizes the Spoken Tutorial project.

If you do not have good bandwidth, you can download and watch it.

Show Slide 13:

(About Spoken Tutorial Project)

The Spoken Tutorial Project Team
  • conducts workshops using spoken tutorials and
  • gives certificates on passing online tests.

For more details, please write to us.

Show Slide 14:

(Acknowledgement)

Spoken Tutorial Project is supported by NMEICT, MHRD, Government of India.
This is Priyanka signing off. Thank you for joining.

Contributors and Content Editors

Itspriyanka, Nancyvarkey