mirror of
https://github.com/clearlinux/clear-linux-documentation.git
synced 2026-07-25 05:57:51 +00:00
Kristal Dale
46b7bcb845
- Hide tutorials landing page toctree - Revise titles and intro for tutorial pages per discussion with @mvincerx - web-server-install: Update to use contents:: local with some minor supporting reorg of content; add link to stateless feature in text - wp-install: Removed note re update with swupd as not relevant to the content of the tutorial Signed-off-by: Kristal Dale <kristal.dale@intel.com>
487 lines
14 KiB
ReStructuredText
487 lines
14 KiB
ReStructuredText
.. _web-server-install:
|
||
|
||
Set up a LAMP web server on |CL-ATTR|
|
||
#####################################
|
||
|
||
This tutorial provides instructions on how to set up a
|
||
:abbr:`LAMP (Linux, Apache, MySQL, PHP)` web server on |CL-ATTR| and how
|
||
to use phpMyAdmin\* to manage an associated database. Note that this
|
||
tutorial installs MariaDB\*, which is a drop-in replacement for MySQL\*.
|
||
|
||
In order to create a web server using |CL| as the host OS, your host system
|
||
must be running |CL|. This tutorial assumes you have successfully installed
|
||
:ref:`Clear Linux on bare metal<bare-metal-install>`.
|
||
|
||
This tutorial covers:
|
||
|
||
.. contents:: :local:
|
||
:depth: 1
|
||
|
||
Install Apache
|
||
**************
|
||
|
||
Apache is an open source HTTP web server application that can run on several
|
||
operating systems, including |CL|. Go to the `Apache HTTP Server Project`_
|
||
for more information.
|
||
|
||
Install the web-server-basic bundle
|
||
===================================
|
||
|
||
The **web-server-basic** bundle contains the packages needed to install the
|
||
Apache software bundle on |CL|.
|
||
|
||
.. note::
|
||
|
||
Before you install new packages, update the |CL| with the following
|
||
console command:
|
||
|
||
.. code-block:: bash
|
||
|
||
sudo swupd update
|
||
|
||
#. To install the bundle, enter the following command:
|
||
|
||
.. code-block:: bash
|
||
|
||
sudo swupd bundle-add web-server-basic
|
||
|
||
|
||
#. To start the Apache service, enter the following commands:
|
||
|
||
.. code-block:: bash
|
||
|
||
sudo systemctl enable httpd.service
|
||
sudo systemctl start httpd.service
|
||
|
||
#. To verify that the Apache server application is running, open a web
|
||
browser and navigate to: http://localhost.
|
||
|
||
If the service is running, a confirmation message appears, as shown in figure 1.
|
||
|
||
.. figure:: figures/web-server-install-1.png
|
||
:alt: This web server is operational from host.
|
||
:scale: 50%
|
||
|
||
`Figure 1: Confirmation that the Apache service is running.`
|
||
|
||
.. note::
|
||
|
||
The :file:`index.html` file is located in the :file:`/var/www/html` directory
|
||
of your host system. You will copy this file into a new location after you
|
||
modify the configuration in the next step.
|
||
|
||
Change the default configuration and data directory
|
||
***************************************************
|
||
|
||
|CL| is designed to be a `stateless`_ operating system which means that you
|
||
must create an optional configuration file to make changes over the default
|
||
values. The default location of the Apache configuration file,
|
||
:file:`httpd.conf`, is located in the :file:`/usr/share/defaults/httpd`
|
||
directory. |CL| can overwrite this directory as part of the stateless
|
||
paradigm. This default :file:`.conf` file includes the following directives
|
||
that allow for additional locations of configuration definitions:
|
||
|
||
.. code-block:: console
|
||
|
||
# Virtual hosts
|
||
IncludeOptional /usr/share/defaults/httpd/conf.d/*.conf
|
||
IncludeOptional /usr/share/defaults/httpd/conf.modules.d/*.conf
|
||
IncludeOptional /etc/httpd/conf.d/*.conf
|
||
IncludeOptional /etc/httpd/conf.modules.d/*.conf
|
||
|
||
This tutorial follows these steps:
|
||
|
||
* Create the directory structure for :file:`/etc/httpd/conf.d`.
|
||
|
||
* Create the :file:`httpd.conf` file in directory :file:`/etc/httpd/conf.d`.
|
||
|
||
* Add the ``DocumentRoot`` variable to :file:`httpd.conf`.
|
||
|
||
Open a text editor and perform the following:
|
||
|
||
#. Copy the content listed below into the new file
|
||
:file:`/etc/httpd/conf.d/httpd.conf`.
|
||
|
||
.. code-block:: console
|
||
|
||
#
|
||
# Set a new location for DocumentRoot
|
||
#
|
||
DocumentRoot "/var/www/tutorial"
|
||
|
||
#
|
||
# Relax access to content within /var/www/tutorial for this example
|
||
#
|
||
<Directory "/var/www/tutorial">
|
||
AllowOverride none
|
||
Require all granted
|
||
</Directory>
|
||
|
||
|
||
#. Create a new ``DocumentRoot`` directory structure and copy the
|
||
:file:`index.html` file from :file:`/var/www/html` directory to
|
||
:file:`/var/www/tutorial`.
|
||
|
||
.. code-block:: bash
|
||
|
||
sudo mkdir –p /var/www/tutorial
|
||
cd /var/www/tutorial
|
||
sudo cp /var/www/html/index.html .
|
||
|
||
|
||
#. To ensure a successful setup, edit the new :file:`index.html` file.
|
||
Change the original text from
|
||
|
||
"This web server is operational from host."
|
||
|
||
to
|
||
|
||
"This web server is operational from its new location."
|
||
|
||
#. Stop and then restart ``httpd.service``.
|
||
|
||
.. code-block:: bash
|
||
|
||
sudo systemctl stop httpd.service
|
||
sudo systemctl start httpd.service
|
||
|
||
#. Go to http://localhost to view the new screen.
|
||
|
||
#. Change the configuration back to the default :file:`/var/www/html`
|
||
location. To do this, edit the :file:`/etc/httpd/conf.d/httpd.conf` file
|
||
again and replace any instance of /var/www/tutorial with /var/www/html.
|
||
|
||
#. Stop and then restart ``httpd.service``.
|
||
|
||
.. code-block:: bash
|
||
|
||
sudo systemctl stop httpd.service
|
||
sudo systemctl start httpd.service
|
||
|
||
#. Go to http://localhost and verify that you can see the default screen
|
||
again.
|
||
|
||
Optionally, remove the /var/www/tutorial directory you previously created.
|
||
|
||
.. code-block:: bash
|
||
|
||
sudo rm /var/www/tutorial/index.html
|
||
sudo rmdir /var/www/tutorial
|
||
|
||
Install PHP
|
||
***********
|
||
|
||
An Apache installation allows you to display static web pages. Enabling PHP
|
||
allows you to generate and display dynamic web pages. To add this
|
||
functionality to your web server, install PHP on your system.
|
||
|
||
#. To get the php components, enter the following command:
|
||
|
||
.. code-block:: bash
|
||
|
||
sudo swupd bundle-add php-basic
|
||
|
||
#. To enable PHP, enter the following commands:
|
||
|
||
.. code-block:: bash
|
||
|
||
sudo systemctl enable php-fpm.service
|
||
sudo systemctl start php-fpm.service
|
||
sudo systemctl restart httpd.service
|
||
|
||
After restarting the Apache service, test your PHP installation.
|
||
|
||
#. Create a file named :file:`phpinfo.php` in the
|
||
:file:`/var/www/html/` directory using a text editor.
|
||
|
||
#. Add the following line to the file:
|
||
|
||
.. code-block:: php
|
||
|
||
<?PHP phpinfo() ?>
|
||
|
||
#. Go to http://localhost/phpinfo.php.
|
||
|
||
#. Verify that the PHP information screen appears, as shown in figure 2:
|
||
|
||
.. figure:: figures/web-server-install-2.png
|
||
:alt: PHP information screen
|
||
:width: 600
|
||
|
||
`Figure 2: The PHP information screen.`
|
||
|
||
If the PHP information screen is displayed, you have successfully installed
|
||
the PHP components and are now ready to add your database application to
|
||
complete your LAMP server implementation.
|
||
|
||
Install MariaDB
|
||
***************
|
||
|
||
Install MariaDB to store content. MariaDB is a drop-in replacement for MySQL
|
||
and is available in the database-basic |CL| bundle.
|
||
|
||
#. To install the database-basic bundle, enter the following command:
|
||
|
||
.. code-block:: bash
|
||
|
||
sudo swupd bundle-add database-basic
|
||
|
||
#. To start MariaDB after it is installed, enter the following commands:
|
||
|
||
.. code-block:: bash
|
||
|
||
sudo systemctl enable mariadb
|
||
sudo systemctl start mariadb
|
||
|
||
#. To check the status of MariaDB, enter the following command:
|
||
|
||
.. code-block:: bash
|
||
|
||
sudo systemctl status mariadb
|
||
|
||
Security hardening
|
||
==================
|
||
|
||
With the MariaDB service running, we can perform some basic security
|
||
hardening.
|
||
|
||
#. To add a basic layer of security, enter the following command:
|
||
|
||
.. code-block:: bash
|
||
|
||
mysql_secure_installation
|
||
|
||
#. Respond to the questions that appear in the script below.
|
||
|
||
.. note::
|
||
|
||
Our suggested responses follow each question.
|
||
|
||
.. code-block:: bash
|
||
|
||
Enter current password for root (enter for none):
|
||
|
||
In order to secure MariaDB, we need the current password for the root
|
||
user. For a newly installed MariaDB without a set root password, the
|
||
password is blank. Thus, press enter to continue.
|
||
|
||
.. code-block:: bash
|
||
|
||
OK, successfully used password, moving on...
|
||
|
||
Set root password? [Y/n]
|
||
|
||
.. _set-password:
|
||
|
||
Set the root password to prevent unauthorized MariaDB root user logins.
|
||
To set a root password, type 'y'.
|
||
|
||
.. code-block:: bash
|
||
|
||
New password:
|
||
|
||
Type the desired password for the root user.
|
||
|
||
.. code-block:: bash
|
||
|
||
Re-enter new password:
|
||
|
||
Re-type the desired password for the root user.
|
||
|
||
.. code-block:: bash
|
||
|
||
Password updated successfully!
|
||
Reloading privilege tables..
|
||
... Success!
|
||
|
||
Remove anonymous users? [Y/n]
|
||
|
||
By default, a MariaDB installation includes an anonymous user that allows
|
||
anyone to log in to MariaDB without a user account. This anonymous user
|
||
is intended only for testing and for a smoother installation. To remove
|
||
the anonymous user and make your database more secure, type 'y'.
|
||
|
||
.. code-block:: bash
|
||
|
||
... Success!
|
||
Disallow root login remotely? [Y/n]
|
||
|
||
Normally, root should only be allowed to connect from the 'localhost'. This
|
||
ensures that someone cannot guess the root password from the network. To
|
||
block any remote root login, type 'y'.
|
||
|
||
.. code-block:: bash
|
||
|
||
... Success!
|
||
Remove test database and access to it? [Y/n]
|
||
|
||
By default, MariaDB includes a database named 'test' which anyone can access.
|
||
This database is also intended only for testing and should be removed. To
|
||
remove the test database, type 'y'.
|
||
|
||
.. code-block:: bash
|
||
|
||
- Dropping test database...
|
||
... Success!
|
||
- Removing privileges on test database...
|
||
... Success!
|
||
Reload privilege tables now? [Y/n]
|
||
|
||
Reloading the privilege tables ensures all changes made so far take
|
||
effect immediately. To reload the privilege tables, type 'y'.
|
||
|
||
.. code-block:: bash
|
||
|
||
... Success!
|
||
|
||
Cleaning up...
|
||
|
||
All done! If you've completed all of the above steps, your MariaDB
|
||
installation should now be secure.
|
||
|
||
Thanks for using MariaDB!
|
||
|
||
The MariaDB installation is complete, and we can now install phpMyAdmin to
|
||
manage the databases.
|
||
|
||
Install phpMyAdmin
|
||
******************
|
||
|
||
The web-based tool phpMyAdmin is a straightforward way to manage MySQL or
|
||
MariaDB databases. Visit the `phpMyAdmin`_ website for the complete
|
||
discussion regarding phpMyAdmin, its documentation, the latest downloads,
|
||
and other useful information.
|
||
|
||
This tutorial uses the latest English version of phpMyAdmin to install it on
|
||
our |CL| host system.
|
||
|
||
#. Download the :file:`phpMyAdmin-<version>-english.tar.gz` file to your
|
||
:file:`~/Downloads` directory. Here, <version> refers to the current
|
||
version available at https://www.phpmyadmin.net/downloads.
|
||
|
||
.. note::
|
||
|
||
This example downloads and uses version 4.6.4.
|
||
|
||
#. Once the file has been successfully downloaded and verified, decompress
|
||
the file and directories into the Apache web server document root
|
||
directory. Use the following commands:
|
||
|
||
.. code-block:: bash
|
||
|
||
cd /var/www/html
|
||
sudo tar –xzvf ~/Downloads/phpMyAdmin-4.6.4-english.tar.gz
|
||
|
||
#. To keep things simple, rename the newly created
|
||
:file:`phpMyAdmin-4.6.4-english` directory to :file:`phpMyAdmin` with the
|
||
following command:
|
||
|
||
.. code-block:: bash
|
||
|
||
sudo mv phpMyAdmin-4.6.4-english phpMyAdmin
|
||
|
||
Use phpMyAdmin to manage databases
|
||
==================================
|
||
|
||
You can use the phpMyAdmin web-based tool to manage your databases. Follow the
|
||
steps below for setting up a database called "WordPress".
|
||
|
||
#. Verify that a successful installation of all LAMP server components by
|
||
going to http://localhost/phpMyAdmin. See figure 3.
|
||
|
||
#. Log in with your root userid and the password you set up when you ran the
|
||
:ref:`mysql_secure_installation command <set-password>`. Enter your
|
||
credentials and select :guilabel:`Go` to log in:
|
||
|
||
.. figure:: figures/web-server-install-3.png
|
||
:alt: phpMyAdmin login page
|
||
:width: 600
|
||
|
||
`Figure 3: The phpMyAdmin login page.`
|
||
|
||
|
||
#. Verify a successful login by confirming that the main phpMyAdmin page
|
||
displays, as shown in figure 4:
|
||
|
||
.. figure:: figures/web-server-install-4.png
|
||
:alt: phpMyAdmin dashboard
|
||
:width: 600
|
||
|
||
`Figure 4: The phpMyAdmin dashboard.`
|
||
|
||
|
||
#. Set up a database by selecting the :guilabel:`Databases` tab, as shown in
|
||
figure 5.
|
||
|
||
#. Enter `WordPress` in the text field below the :guilabel:`Create database`
|
||
label.
|
||
|
||
#. Select the :guilabel:`utf8_unicode_ci` option from the
|
||
:guilabel:`Collation` drop-down menu beside the text field.
|
||
|
||
#. Click :guilabel:`Create`.
|
||
|
||
.. figure:: figures/web-server-install-5.png
|
||
:alt: Databases tab
|
||
:width: 600
|
||
|
||
`Figure 5: The Databases tab.`
|
||
|
||
|
||
#. Set up user permissions by selecting the :guilabel:`WordPress` database
|
||
located in the left panel. See figure 6.
|
||
|
||
#. Select the :guilabel:`Privileges` tab. Figure 6 shows its contents.
|
||
|
||
.. figure:: figures/web-server-install-6.png
|
||
:alt: Privileges tab
|
||
:width: 600
|
||
|
||
`Figure 6: The Privileges tab.`
|
||
|
||
#. Click :guilabel:`Add user account` located at the bottom of the
|
||
:guilabel:`Privileges` tab. The `Add user account` page appears, as shown
|
||
in figure 7.
|
||
|
||
.. figure:: figures/web-server-install-7.png
|
||
:alt: User accounts tab
|
||
:width: 600
|
||
|
||
`Figure 7: The User accounts tab.`
|
||
|
||
#. Enter the following information in the corresponding fields that appear
|
||
in figure 7 above:
|
||
|
||
* User name: wordpressuser
|
||
|
||
* Password: wp-example
|
||
|
||
* Re-type: wp-example
|
||
|
||
#. In the `Database for user account` section, select
|
||
:guilabel:`Grant all privileges on database “WordPress”.`
|
||
|
||
#. At the bottom of the page, click :guilabel:`Go`.
|
||
|
||
If successful, you should see the screen shown in figure 8:
|
||
|
||
.. figure:: figures/web-server-install-8.png
|
||
:alt: User added successfully
|
||
:width: 600
|
||
|
||
`Figure 8: The user wordpressuser is successfully added.`
|
||
|
||
**Congratulations!**
|
||
|
||
You have now created a fully functional LAMP server along with a
|
||
WordPress\*-ready database using |CL|.
|
||
|
||
|
||
Next steps
|
||
**********
|
||
|
||
Next, add the WordPress components needed to host a WordPress website with :ref:`wp-install`.
|
||
|
||
.. _Apache HTTP Server Project: https://httpd.apache.org/
|
||
.. _phpMyAdmin: https://www.phpmyadmin.net/
|
||
.. _`stateless`: https://clearlinux.org/features/stateless |