Deploying Mediawiki: Difference between revisions
Jump to navigation
Jump to search
implementation of mediawiki |
mNo edit summary |
||
(2 intermediate revisions by the same user not shown) | |||
Line 35: | Line 35: | ||
|} | |} | ||
=Before you proceed= | =Before you proceed= | ||
The domain used here is '''networked.com'''. This is used only for demonstration and required dns entries for this domain have already been done to the host file to make the domain and any subdomains reachable on the network. This domain may be owned by someone else and we do not know who it is and we are not linked to them. | The domain used here is '''networked.com'''. This is used only for demonstration and required dns entries for this domain have already been done to the host file to make the domain and any subdomains reachable on the network. This domain may be owned by someone else and we do not know who it is and we are not linked to them. Mediawiki configured for this domain in this howto is not reachable on public IP. If you try networked.com and find any material that may be suitable / unsuitable to you, we are not the owners of the same and we are not responsible for the content. | ||
=Introduction= | =Introduction= | ||
Line 44: | Line 44: | ||
=Pre-requisites installation= | =Pre-requisites installation= | ||
* Log into the webserver and run the below commands | * Log into the webserver and run the below commands | ||
< | <pre> | ||
ssh kedar@10.1.65.107 | ssh kedar@10.1.65.107 | ||
sudo apt install apache2 php7.2 php7.2-curl php7.2-gd php7.2-intl php7.2-json php7.2-mbstring php7.2-mysql php7.2-soap php7.2-xml php7.2-zip libapache2-mod-php7.2 | sudo apt install apache2 php7.2 php7.2-curl php7.2-gd php7.2-intl php7.2-json php7.2-mbstring php7.2-mysql php7.2-soap php7.2-xml php7.2-zip libapache2-mod-php7.2 | ||
Line 52: | Line 52: | ||
sudo systemctl restart apache2 | sudo systemctl restart apache2 | ||
sudo systemctl status apache2 | sudo systemctl status apache2 | ||
</ | </pre> | ||
=Database Creation= | =Database Creation= | ||
*Database will be created in a mariadb server which is installed into a container created on the host server (infrabase1). Latest mariadb server has been installed and run the below commands after an ssh into the mariadb server. | *Database will be created in a mariadb server which is installed into a container created on the host server (infrabase1). Latest mariadb server has been installed and run the below commands after an ssh into the mariadb server. | ||
< | <pre> | ||
sudo mysql -u root -p | sudo mysql -u root -p | ||
CREATE DATABASE wiki; | CREATE DATABASE wiki; | ||
Line 61: | Line 61: | ||
FLUSH PRIVILEGES; | FLUSH PRIVILEGES; | ||
quit; | quit; | ||
</ | </pre> | ||
=Create self signed certificates= | =Create self signed certificates= | ||
* Log into the webserver and run the below commands | * Log into the webserver and run the below commands | ||
< | <pre> | ||
openssl req -x509 -nodes -days 365 -newkey rsa:2048 -keyout /etc/ssl/private/wiki.key -out /etc/ssl/certs/wiki.crt | openssl req -x509 -nodes -days 365 -newkey rsa:2048 -keyout /etc/ssl/private/wiki.key -out /etc/ssl/certs/wiki.crt | ||
</ | </pre> | ||
* You can use a commercial self signed certificate if you have one or can also use free Lets Encrypt certificate | * You can use a commercial self signed certificate if you have one or can also use free Lets Encrypt certificate | ||
=Download | =Download Wiki= | ||
* Log into the webserver and run the below commands | * Log into the webserver and run the below commands | ||
< | <pre> | ||
cd /var/www/html | cd /var/www/html | ||
sudo mkdir wiki | sudo mkdir wiki | ||
cd /home/kedar | cd /home/kedar | ||
wget https://releases.wikimedia.org/mediawiki/1.34/mediawiki-1.34.1.tar.gz | wget https://releases.wikimedia.org/mediawiki/1.34/mediawiki-1.34.1.tar.gz | ||
</ | </pre> | ||
=Deploy Mediawiki= | =Deploy Mediawiki= | ||
< | <pre> | ||
cd /home/kedar | cd /home/kedar | ||
tar -zxvf mediawiki-1.34.1.tar.gz | tar -zxvf mediawiki-1.34.1.tar.gz | ||
cd mediawiki-1.34.1 | cd mediawiki-1.34.1 | ||
sudo rsync -avz . /var/www/html/wiki | sudo rsync -avz . /var/www/html/wiki | ||
</ | </pre> | ||
* Change the ownership of the wiki folder to apache user | * Change the ownership of the wiki folder to apache user | ||
< | <pre> | ||
cd /var/www/html | cd /var/www/html | ||
sudo chown -R www-data:www-data wiki/ | sudo chown -R www-data:www-data wiki/ | ||
sudo systemctl restart apache2 | sudo systemctl restart apache2 | ||
</ | </pre> | ||
* Create virtual host for the website | * Create virtual host for the website | ||
< | <pre> | ||
cd /etc/apache2/sites-available | cd /etc/apache2/sites-available | ||
sudo a2dissite 000-default.conf | sudo a2dissite 000-default.conf | ||
sudo a2dissite default-ssl.conf | sudo a2dissite default-ssl.conf | ||
sudo nano wiki.conf | sudo nano wiki.conf | ||
</ | </pre> | ||
* Add the below configuration in the wiki.conf file | * Add the below configuration in the wiki.conf file | ||
<syntaxhighlight lang="apacheconf"> | <syntaxhighlight lang="apacheconf"> | ||
Line 120: | Line 119: | ||
</VirtualHost> | </VirtualHost> | ||
</IfModule> | </IfModule> | ||
</ | </pre> | ||
* Enable the site and Restart apache service | * Enable the site and Restart apache service | ||
< | <pre> | ||
sudo a2ensite wiki.conf | sudo a2ensite wiki.conf | ||
sudo sysemctl restart apache2 | sudo sysemctl restart apache2 | ||
</ | </pre> | ||
* Using a browser navigate to https://wiki.networked.com | * Using a browser navigate to https://wiki.networked.com | ||
** Answer various questions based on some of the steps we have done above like db name, db user, db server etc. | ** Answer various questions based on some of the steps we have done above like db name, db user, db server etc. |
Latest revision as of 05:36, 9 June 2020
Setup Details |
hostname: infrabase1 Network: 10.1.65.0/24 IP Address : 10.1.65.11 Subnet Mask: 255.255.255.0 Gateway: 10.1.65.1 DNS: 8.8.8.8 sudo user: kedar Container: webserver Network: 10.1.65.0/24 IP Address : 10.1.65.107 Subnet Mask: 255.255.255.0 Gateway: 10.1.65.1 DNS: 8.8.8.8 sudo user: kedar Container: db1 Network: 10.1.65.0/24 IP Address : 10.1.65.108 Subnet Mask: 255.255.255.0 Gateway: 10.1.65.1 DNS: 8.8.8.8 sudo user: kedar User PC Details PC type: Desktop OS: Ubuntu Desktop IP Address: 10.1.65.160 |
Before you proceed
The domain used here is networked.com. This is used only for demonstration and required dns entries for this domain have already been done to the host file to make the domain and any subdomains reachable on the network. This domain may be owned by someone else and we do not know who it is and we are not linked to them. Mediawiki configured for this domain in this howto is not reachable on public IP. If you try networked.com and find any material that may be suitable / unsuitable to you, we are not the owners of the same and we are not responsible for the content.
Introduction
- We shall be creating a mediawiki site with FQDN as: https://wiki.networked.net
- We shall be hosting the site on port number: 443
- We shall be using a self signed SSL certificate
- Host entry to ensure this website is reachable is done in the user PC, in absence of a DNS
Pre-requisites installation
- Log into the webserver and run the below commands
ssh kedar@10.1.65.107 sudo apt install apache2 php7.2 php7.2-curl php7.2-gd php7.2-intl php7.2-json php7.2-mbstring php7.2-mysql php7.2-soap php7.2-xml php7.2-zip libapache2-mod-php7.2 sudo apt install rsync nano openssl sudo a2enmod ssl sudo a2enmod rewrite sudo systemctl restart apache2 sudo systemctl status apache2
Database Creation
- Database will be created in a mariadb server which is installed into a container created on the host server (infrabase1). Latest mariadb server has been installed and run the below commands after an ssh into the mariadb server.
sudo mysql -u root -p CREATE DATABASE wiki; GRANT ALL PRIVILEGES ON wiki.* TO "wiki"@"%" IDENTIFIED BY "123456"; FLUSH PRIVILEGES; quit;
Create self signed certificates
- Log into the webserver and run the below commands
openssl req -x509 -nodes -days 365 -newkey rsa:2048 -keyout /etc/ssl/private/wiki.key -out /etc/ssl/certs/wiki.crt
- You can use a commercial self signed certificate if you have one or can also use free Lets Encrypt certificate
Download Wiki
- Log into the webserver and run the below commands
cd /var/www/html sudo mkdir wiki cd /home/kedar wget https://releases.wikimedia.org/mediawiki/1.34/mediawiki-1.34.1.tar.gz
Deploy Mediawiki
cd /home/kedar tar -zxvf mediawiki-1.34.1.tar.gz cd mediawiki-1.34.1 sudo rsync -avz . /var/www/html/wiki
- Change the ownership of the wiki folder to apache user
cd /var/www/html sudo chown -R www-data:www-data wiki/ sudo systemctl restart apache2
- Create virtual host for the website
cd /etc/apache2/sites-available sudo a2dissite 000-default.conf sudo a2dissite default-ssl.conf sudo nano wiki.conf
- Add the below configuration in the wiki.conf file
<syntaxhighlight lang="apacheconf"> <IfModule mod_ssl.c>
<VirtualHost _default_:443> ServerName wiki.networked.net ServerAlias wiki ServerAdmin admin@networked.net DocumentRoot /var/www/html/wiki
ErrorLog ${APACHE_LOG_DIR}/error.log CustomLog ${APACHE_LOG_DIR}/access.log combined SSLEngine on SSLCertificateFile /etc/ssl/certs/wiki.crt SSLCertificateKeyFile /etc/ssl/private/wiki.key
<FilesMatch "\.(cgi|shtml|phtml|php)$">
SSLOptions +StdEnvVars </FilesMatch> <Directory /usr/lib/cgi-bin> SSLOptions +StdEnvVars </Directory>
</VirtualHost> </IfModule>
- Enable the site and Restart apache service
sudo a2ensite wiki.conf sudo sysemctl restart apache2
- Using a browser navigate to https://wiki.networked.com
- Answer various questions based on some of the steps we have done above like db name, db user, db server etc.
- Login to wiki using the admin credentials
Conclusion
- We have a working wiki website hosted on an apache web server. Explore the plugins and extensions and create a corporate wiki
- There are many interesting plugins that extend the functionality of mediawiki. Take care while installing the plugins as the installation can break if there is a version mismatch for the mediawiki