Difference between revisions of "Joomla/C2/Common-mistakes-and-uninstalling-Joomla/English"
Itspriyanka (Talk | contribs) (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 …') |
Nancyvarkey (Talk | contribs) |
||
(2 intermediate revisions by the same user not shown) | |||
Line 27: | Line 27: | ||
|| For this tutorial, we will be using: | || For this tutorial, we will be using: | ||
− | *'''Ubuntu''' 14.04 | + | *'''Ubuntu''' Linux 14.04 |
− | *'''Joomla''' | + | *'''Joomla''' 3.4.1 |
− | *'''Apache''', '''MySQL''' and '''PHP''' obtained through '''XAMPP''' | + | *'''Apache''', '''MySQL''' and '''PHP''' obtained through '''XAMPP''' 5.5.19 |
|- | |- | ||
Line 36: | Line 36: | ||
|| To follow this tutorial, you need to have: | || To follow this tutorial, you need to have: | ||
− | *'''XAMPP''' and '''Joomla ''' installed on your system | + | *'''XAMPP''' and '''Joomla ''' installed on your system. |
You also need to have knowledge of the '''Joomla''' installation process. | 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. | + | If not, check the relevant tutorial in the '''Joomla''' series, on the '''spoken tutorial ''' website. |
|- | |- | ||
Line 73: | Line 73: | ||
|- | |- | ||
|| | || | ||
− | + | || Now we have''' XAMPP''' running. | |
− | || | + | |
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
|- | |- | ||
Line 100: | Line 94: | ||
|- | |- | ||
− | || Type ''' Ctrl+F''' and | + | || Type ''' Ctrl+F''' and type '''DOCUMENT_ROOT''' in the search window >> Press '''Enter''' |
|| 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 136: | Line 132: | ||
Highlight ''' output buffering''' | Highlight ''' output buffering''' | ||
− | || In the | + | || In the 3rd 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. | If ''' output_buffering '''is '''ON''', installation might proceed successfully. | ||
Line 144: | Line 143: | ||
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 | + | In some cases, installation might hang up at this step. |
|- | |- | ||
Line 164: | Line 163: | ||
|| 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''' | + | 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. | ||
+ | |||
In my machine, the path to that file is '''slash opt slash lampp slash etc slash php.ini''' | In my machine, the path to that file is '''slash opt slash lampp slash etc slash php.ini''' | ||
Line 182: | Line 182: | ||
|| If prompted, enter your '''admin''' password. | || If prompted, enter your '''admin''' password. | ||
+ | |||
You will have to do so whenever prompted, as we proceed. | You will have to do so whenever prompted, as we proceed. | ||
Line 188: | Line 189: | ||
|| '''Gedit''' is the default text editor preloaded in''' Ubuntu Linux. ''' | || '''Gedit''' is the default text editor preloaded in''' Ubuntu Linux. ''' | ||
+ | |||
Alternately, you can use any text editor of your choice. | Alternately, you can use any text editor of your choice. | ||
Line 200: | Line 202: | ||
|| The first search result we get is commented. So we check for 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. | Here we find the text we are looking for. | ||
Line 209: | Line 212: | ||
'''output buffering: off''' | '''output buffering: off''' | ||
− | |||
− | |||
|| Change | || Change | ||
''' output_buffering = 4096''' | ''' output_buffering = 4096''' | ||
Line 221: | Line 222: | ||
|| We save the file by pressing ''' Control + S ''' keys. | || We save the file by pressing ''' Control + S ''' keys. | ||
+ | |||
We can then exit the '''Gedit ''' editor. | We can then exit the '''Gedit ''' editor. | ||
Line 232: | Line 234: | ||
Type '''sudo /opt/lampp/lampp restart''' | Type '''sudo /opt/lampp/lampp restart''' | ||
− | || Switch to the '''terminal''' | + | || Switch to the '''terminal''' and 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.''' | ||
|- | |- | ||
− | || | + | || |
− | + | ||So, we can proceed to the next step. | |
− | || | + | |
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | So, we can proceed to the next step | + | |
|- | |- | ||
Line 268: | Line 256: | ||
|| 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 264: | ||
|| 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 279: | ||
− | 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 317: | ||
||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 326: | ||
||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 335: | ||
||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 345: | ||
||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 | + | |
+ | |||
+ | I got an error because I am not logged-in as '''linux superuser''' and don't have '''delete permission''' | ||
|- | |- | ||
Line 352: | Line 353: | ||
||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 '''Joomla''' installation folder manually, from the '''joomla''' folder. | ||
This is mandatory. | This is mandatory. | ||
Line 366: | Line 369: | ||
Then type | Then type | ||
− | ''' sudo space rm space | + | ''' sudo space rm space minus rf space installation forward slash''' |
Press ''' Enter''' | Press ''' Enter''' | ||
Line 374: | Line 377: | ||
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 398: | ||
||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 | + | ''' sudo space rm space minus rf space forward slash opt slash lampp slash htdocs slash joomla slash''' |
+ | |||
+ | Press '''Enter'''. | ||
|- | |- | ||
Line 399: | Line 411: | ||
||Now type | ||Now type | ||
− | '''cd forward slash opt | + | '''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 423: | ||
||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 451: | ||
||This will give you a prompt | ||This will give you a prompt | ||
− | ''' You are about to DESTROY a complete database | + | ''' You are about to DESTROY a complete database! Do you really want to execute DROP DATABASE?''' |
Click on '''OK.''' | Click on '''OK.''' | ||
Line 445: | Line 462: | ||
|- | |- | ||
|| | || | ||
− | |||
||We have now successfully uninstalled ''' Joomla''' from our '''localhost'''. | ||We have now successfully uninstalled ''' Joomla''' from our '''localhost'''. | ||
Line 456: | Line 472: | ||
In this tutorial, we learnt about: | In this tutorial, we learnt about: | ||
*Common Mistakes and their solutions when installing '''Joomla''' | *Common Mistakes and their solutions when installing '''Joomla''' | ||
− | *and to ''' | + | *and to uninstall '''Joomla''' |
|- | |- |
Latest revision as of 12:08, 13 May 2015
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
|
In this tutorial, we will learn about:
|
Show Slide 3
Versions and OS |
For this tutorial, we will be using:
|
Show Slide 4
Prerequisites |
To follow this tutorial, you need to have:
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 type 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 3rd 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.
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.
|
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. |
So, we can proceed to the next step. | |
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”.
|
Copy text from the textbox >> Ctrl + C | If this error occurs, you will get some text inside a text box.
|
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.
sudo space touch space slash opt slash lampp slash htdocs slash joomla slash configuration dot php
|
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
| |
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.
|
Show Slide 8:
Installation folder not deleted. |
Now, we will see the fourth mistake that one can make during the Joomla installation.
|
Switch to the browser
Highlight the Remove Installation Folder button |
I cannot emphasize the importance of this step enough.
So, make sure the folder is deleted. |
If you get an error in this step, you must remove the folder manually.
| |
Switch to terminal. | So, now let us switch to the terminal.
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 | We have now successfully installed Joomla.
|
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.
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
As you can see, the directory does not exist. |
Switch to browser | We will then delete the database and the users.
|
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:
|
Show Slide 11:
(Assignment) |
Let's come to the assignment now.
|
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
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. |