MediaWiki - Revision history

Paul Blankenbaker: Updated installation instructions for NST 28

2018-09-17T15:28:13Z

Updated installation instructions for NST 28

← Older revision		Revision as of 11:28, 17 September 2018
Line 1:		Line 1:
	This page contains some notes related to using a '''NST''' system as a [http://www.mediawiki.org MediaWiki] server.		This page contains some notes related to using a '''NST''' system as a [http://www.mediawiki.org MediaWiki] server.

	= Adding MediaWiki =		= Adding MediaWiki (as of NST 28 - 2018-09-17) =

	== Set Up Database Server ==		== Set Up Database Server ==

	MediaWiki requires access to a database. You can use either a ~~MySQL~~ or PostgreSQL database server. Both are ~~available~~ on a NST system.		MediaWiki requires access to a database. You can use either a MariaDB or PostgreSQL database server. Both are pre-installed on a NST system.

	=== Set Up ~~MySQL~~ ===		=== Set Up MariaDB ===

	The easy way to set up the ~~MySQL~~ server is to:		The easy way to set up the MariaDB server is to:

	* From the NST WUI menu bar, select: ''Database\|MySQL\|MySQL Database Management''.		* From the NST WUI menu bar, select: ''Database\|MariaDB (MySQL)\|MariaDB (MySQL) Database Management''.
	* Scroll down to the ''Setup MySQL Server'' section on the page.		* Scroll down to the ''Setup MariaDB (MySQL) Server'' section on the page.
	* Find the ''Change Administrator Password'' row in the configuration table and set the master password you want to use administering the MySQL server. If you forget to do this, a random password will be used. Should you need to find this password, look for NSTCTMYSQLPASSWD in the file: ''/etc/nst.conf''.		* Find the ''Change Administrator Password'' row in the configuration table and set the master password you want to use administering the MySQL server. If you forget to do this, a random password will be used. Should you need to find this password, look for NSTCTMYSQLPASSWD in the file: ''/etc/nst.conf''.
	* If you know what you are doing, feel free to review/tweak other options in the configuration table. If you don't know what you are doing, leave them at their default settings.		* If you know what you are doing, feel free to review/tweak other options in the configuration table. If you don't know what you are doing, leave them at their default settings.
	* Press the ''Setup/Start MySQL Server'' button below the table to configure and start the ~~MySQL~~ server.		* Press the ''Setup/Start MariaDB (MySQL) Server'' button below the table to configure and start the server.

	You should see a new page load. The page will take a bit to complete and show the results of setting up and starting the ~~MySQL server~~. Once the page finishes loading, press the ''Return'' button to return back to the ''MySQL Database Service Management'' page.		You should see a new page load. The page will take a bit to complete and show the results of setting up and starting the ''mariadb.service''. Once the page finishes loading, press the ''Return'' button to return back to the ''MariaDB (MySQL) Database Service Management'' page.

	At this point, you should see that that the ''~~'mysqld'~~'' service is running. Within the table that shows the ''~~'mysqld'~~'' service. Find the ''Boot State'' column and click on the ''Enable'' button corresponding to the ''~~'mysqld'~~'' service. This will enable the service at boot time.		At this point, you should see that that the ''mariadb'' service is running. Within the table that shows the ''mariadb'' service. Find the ''Boot State'' column and click on the ''Enable'' button corresponding to the ''mariadb'' service. This will enable the service at boot time.

	This completes the set up of the ~~MySQL~~ server. At this point your system should be ready to install MediaWiki.		This completes the set up of the SQL server. At this point your system should be ready to install MediaWiki.

	== Set Up sendmail ==		== Set Up sendmail ==
Line 27:		Line 27:
	If you plan on using e-mail with your wiki, you should make sure the sendmail service is setup and configured on your NST system.		If you plan on using e-mail with your wiki, you should make sure the sendmail service is setup and configured on your NST system.

	From the NST WUI menu bar, select: ''Network\|eMail\|Sendmail Service Manager''. This page should guide you through the steps of configuring and testing the '''sendmail''' service.		From the NST WUI menu bar, select: ''Network\|eMail\|Sendmail Service Manager''. This page should guide you through the steps of configuring and testing the ''sendmail'' service.

			NOTE: Depending on your Internet Service Provider, it may be very difficult to get the ''sendmail'' service configured and working.

	== Install MediaWiki Package(s) ==		== Install MediaWiki Package(s) ==
Line 34:		Line 35:
	To add MediaWiki to a NST system, log in as ''root'' and run the following command:		To add MediaWiki to a NST system, log in as ''root'' and run the following command:

	~~yum~~ install mediawiki		dnf install mediawiki

	This will install the basic packages required for MediaWiki support. The other packages (database and web server support packages) should already be installed on your system.		This will install the basic packages required for MediaWiki support. The other packages (database and web server support packages) should already be installed on your system.
Line 55:		Line 56:
	To complete the MediaWiki setup, simply click on the: "''set up the wiki''" link and follow the instructions.		To complete the MediaWiki setup, simply click on the: "''set up the wiki''" link and follow the instructions.

	Once you complete the MediaWiki setup, it will ~~tell~~ you that ~~you need~~ to ~~move the~~ ''~~config/~~LocalSettings.php'' file ~~to its parent directory. You~~ can ~~complete this step by running~~ the following command:		Once you complete the MediaWiki setup, it will give you a ''LocalSettings.php'' file that needs to be installed. The ''LocalSettings.php'' file will likely be in your ''Downloads'' folder and can be installed using the following command:

	mv /~~var/www/wiki/config~~/LocalSettings.php /var/www/wiki/		sudo mv ~/Downloads/LocalSettings.php /var/www/wiki/

	At this point you should have MediaWiki up and running on your NST system. Directing your browser to ''https://IP_ADDRESS/wiki'' should get you to the ''Main Page'' of your wiki.		At this point you should have MediaWiki up and running on your NST system. Directing your browser to ''https://IP_ADDRESS/wiki'' should get you to the ''Main Page'' of your wiki.

	== Additional Extensions ==		= Additional Extensions =

	One may add the following additional extensions to enhance the MediaWiki environment:		One may add the following additional extensions to enhance the MediaWiki environment:

	=== MultimediaViewer ===		== MultimediaViewer ==
	The '''[http://www.mediawiki.org/wiki/Extension:MultimediaViewer MultimediaViewer]''' extension gives the user of a wiki a different interface for viewing full-size, or nearly full-size, images in their browser without extraneous page loads or confusing interstitial pages.		The '''[http://www.mediawiki.org/wiki/Extension:MultimediaViewer MultimediaViewer]''' extension gives the user of a wiki a different interface for viewing full-size, or nearly full-size, images in their browser without extraneous page loads or confusing interstitial pages.

Rwh at 12:33, 21 February 2015

2015-02-21T12:33:57Z

← Older revision		Revision as of 08:33, 21 February 2015
Line 61:		Line 61:
	At this point you should have MediaWiki up and running on your NST system. Directing your browser to ''https://IP_ADDRESS/wiki'' should get you to the ''Main Page'' of your wiki.		At this point you should have MediaWiki up and running on your NST system. Directing your browser to ''https://IP_ADDRESS/wiki'' should get you to the ''Main Page'' of your wiki.

			== Additional Extensions ==
			One may add the following additional extensions to enhance the MediaWiki environment:

			=== MultimediaViewer ===
			The '''[http://www.mediawiki.org/wiki/Extension:MultimediaViewer MultimediaViewer]''' extension gives the user of a wiki a different interface for viewing full-size, or nearly full-size, images in their browser without extraneous page loads or confusing interstitial pages.


	= Adding An Apache Virtual Host With Combined Logging =		= Adding An Apache Virtual Host With Combined Logging =
	The following '''Apache''' include file is an example '''Virtual Host''' configuration with a '''Log Format''' suitable for [http://awstats.sourceforge.net/ AWStats] processing: "'''/etc/httpd/conf.d/mediawiki.conf'''"		The following '''Apache''' include file is an example '''Virtual Host''' configuration with a '''Log Format''' suitable for [http://awstats.sourceforge.net/ AWStats] processing: "'''/etc/httpd/conf.d/mediawiki.conf'''"

Paul Blankenbaker: /* Set up MediaWiki */

2011-10-22T22:01:27Z

Set up MediaWiki

← Older revision		Revision as of 18:01, 22 October 2011
Line 49:		Line 49:
	Reload the web server configuration file:		Reload the web server configuration file:

	service httpd reload		systemctl restart httpd.service # For older systems use: service httpd reload

	At this point, you can test your configuration by pointing your web browser at: "https://IP_ADDRESS/wiki" (put in your own IP ADDRESS). You should be greeted by a MediaWiki page telling you that you need to set up the wiki.		At this point, you can test your configuration by pointing your web browser at: "https://IP_ADDRESS/wiki" (put in your own IP ADDRESS). You should be greeted by a MediaWiki page telling you that you need to set up the wiki.

Paul Blankenbaker: /* = Set Up MySQL */

2010-10-25T15:07:29Z

= Set Up MySQL

← Older revision		Revision as of 11:07, 25 October 2010
Line 7:		Line 7:
	MediaWiki requires access to a database. You can use either a MySQL or PostgreSQL database server. Both are available on a NST system.		MediaWiki requires access to a database. You can use either a MySQL or PostgreSQL database server. Both are available on a NST system.

	=== Set Up MySQL ==		=== Set Up MySQL ===

	The easy way to set up the MySQL server is to:		The easy way to set up the MySQL server is to:

Paul Blankenbaker: /* Adding MediaWiki */

2010-10-25T15:07:17Z

Adding MediaWiki

@@ Line 2: / Line 2: @@
 = Adding MediaWiki =
 To add MediaWiki to a NST system, log in as ''root'' and run the following command:
@@ Line 9: / Line 38: @@
 This will install the basic packages required for MediaWiki support. The other packages (database and web server support packages) should already be installed on your system.
-After installation completes, you will need to setup and configure your wiki.
+== Set up MediaWiki ==
 Edit the file: ''/etc/httpd/conf.d/mediawiki.conf'' and uncomment the two lines:
@@ Line 22: / Line 53: @@
 At this point, you can test your configuration by pointing your web browser at: "https://IP_ADDRESS/wiki" (put in your own IP ADDRESS). You should be greeted by a MediaWiki page telling you that you need to set up the wiki.
+At this point you should have MediaWiki up and running on your NST system. Directing your browser to ''https://IP_ADDRESS/wiki'' should get you to the ''Main Page'' of your wiki.
 = Adding An Apache Virtual Host With Combined Logging =

Paul Blankenbaker at 14:35, 25 October 2010

2010-10-25T14:35:16Z

← Older revision		Revision as of 10:35, 25 October 2010
Line 1:		Line 1:
	This page contains some notes related to using a '''NST''' system as a [http://www.mediawiki.org MediaWiki] server.		This page contains some notes related to using a '''NST''' system as a [http://www.mediawiki.org MediaWiki] server.

			= Adding MediaWiki =

			To add MediaWiki to a NST system, log in as ''root'' and run the following command:

			yum install mediawiki

			This will install the basic packages required for MediaWiki support. The other packages (database and web server support packages) should already be installed on your system.

			After installation completes, you will need to setup and configure your wiki.

			Edit the file: ''/etc/httpd/conf.d/mediawiki.conf'' and uncomment the two lines:

			Alias /wiki/skins /usr/share/mediawiki/skins
			Alias /wiki /var/www/wiki

			Reload the web server configuration file:

			service httpd reload

			At this point, you can test your configuration by pointing your web browser at: "https://IP_ADDRESS/wiki" (put in your own IP ADDRESS). You should be greeted by a MediaWiki page telling you that you need to set up the wiki.





			== Install Package(s) ==

	= Adding An Apache Virtual Host With Combined Logging =		= Adding An Apache Virtual Host With Combined Logging =

Paul Blankenbaker: /* Adding MediaWiki */

2010-10-25T14:18:24Z

Adding MediaWiki

← Older revision		Revision as of 10:18, 25 October 2010
Line 1:		Line 1:
	This page contains some notes related to using a '''NST''' system as a [http://www.mediawiki.org MediaWiki] server.		This page contains some notes related to using a '''NST''' system as a [http://www.mediawiki.org MediaWiki] server.

	~~= Adding MediaWiki =~~

	~~Use the '''NST System Patch Management''' page on the '''NST WUI''' to perform the initial installation. In addition:~~

	* You MUST setup the '''MySQL''' on the '''NST''' system.

	* You will probably want to setup the '''ntpd''' to keep the system clock synchronized.

	* You will probably want to adjust the '''Apache''' web server configuration file to allow others access to the system (see [[Apache Notes]]).

	= Adding An Apache Virtual Host With Combined Logging =		= Adding An Apache Virtual Host With Combined Logging =

Rwh: /* Adding An Apache Virtual Host With Combined Logging */

2008-02-26T13:30:54Z

Adding An Apache Virtual Host With Combined Logging

← Older revision		Revision as of 09:30, 26 February 2008
Line 12:		Line 12:

	= Adding An Apache Virtual Host With Combined Logging =		= Adding An Apache Virtual Host With Combined Logging =
	The following '''Apache''' include file is an example '''Virtual Host''' configuration with a '''Log Format''' suitable for [http://~~www~~.~~mediawiki~~.~~org~~ AWStats] processing: "'''/etc/httpd/conf.d/mediawiki.conf'''"		The following '''Apache''' include file is an example '''Virtual Host''' configuration with a '''Log Format''' suitable for [http://awstats.sourceforge.net/ AWStats] processing: "'''/etc/httpd/conf.d/mediawiki.conf'''"

	<pre class="programListing">		<pre class="programListing">

Rwh at 13:29, 26 February 2008

2008-02-26T13:29:38Z

← Older revision		Revision as of 09:29, 26 February 2008
Line 12:		Line 12:

	= Adding An Apache Virtual Host With Combined Logging =		= Adding An Apache Virtual Host With Combined Logging =
	The following '''Apache''' include file is an example '''Virtual Host''' configuration with a '''Log Format''' suitable for ~~awstats~~ processing: "'''/etc/httpd/conf.d/mediawiki.conf'''"		The following '''Apache''' include file is an example '''Virtual Host''' configuration with a '''Log Format''' suitable for [http://www.mediawiki.org AWStats] processing: "'''/etc/httpd/conf.d/mediawiki.conf'''"

	<pre class="programListing">		<pre class="programListing">

Rwh: /* Adding An Apache Virtual Host With Combined Logging */

2008-02-26T13:27:27Z

Adding An Apache Virtual Host With Combined Logging

← Older revision		Revision as of 09:27, 26 February 2008
Line 17:		Line 17:
	#		#
	# This is for the BMC Wiki...		# This is for the BMC Wiki...
			#
			# - Setup an Apache Virtual Host...
			# - Setup LogFormat for AWStat processing...

	Listen 172.16.1.55:80		Listen 172.16.1.55:80