Joomla/C2/Common-mistakes-and-uninstalling-Joomla/English
| 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. | |
| Now, let us see the common mistakes one can make during Joomla installation. | |
| 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. |
| 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 itself. |
| 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 is 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.
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.
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.
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 hyphen rf space installation forward slash. Press Enter |
| Switch to the browser | 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 hyphen rf space forward slash opt forward slash lampp slash htdocs forward slash joomla slash |
| Type cd /opt/lampp/htdocs/joomla
Highlight the result destination directory does not exist |
Now type
cd forward slash opt forward slash lampp slash htdocs slash joomla slash This is to check if the folder is deleted. As you see, the directory does not exist. |
| Switch to browser | We will then delete the database and the users.
This step will uninstall Joomla completely. 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. |
