Running wiki-to-print on the server - Revision history

Manetta: /* Debugging */

2026-01-14T15:16:00Z

Debugging

← Older revision		Revision as of 15:16, 14 January 2026
Line 20:		Line 20:

	==Debugging==		==Debugging==

			===Where to find the logs?===

			This shows the logs of the wiki-to-print service:

			$ journalctl -u wiki-to-print

	===For debugging (on the server)===		===For debugging (on the server)===
Line 36:		Line 42:

	And if needed, you can add print statements in the python files to dive deeper into the code.		And if needed, you can add print statements in the python files to dive deeper into the code.

	~~===Where to find the logs?===~~

	~~This shows the logs of the wiki-to-print service:~~

	~~$ journalctl -u wiki-to-print~~

	===For debugging (through a local installation)===		===For debugging (through a local installation)===

Manetta at 15:15, 14 January 2026

2026-01-14T15:15:45Z

← Older revision		Revision as of 15:15, 14 January 2026
Line 36:		Line 36:

	And if needed, you can add print statements in the python files to dive deeper into the code.		And if needed, you can add print statements in the python files to dive deeper into the code.

			===Where to find the logs?===

			This shows the logs of the wiki-to-print service:

			$ journalctl -u wiki-to-print

	===For debugging (through a local installation)===		===For debugging (through a local installation)===

Manetta: /* Wiki-to-print as a service */

2023-08-22T15:58:29Z

Wiki-to-print as a service

← Older revision		Revision as of 15:58, 22 August 2023
Line 12:		Line 12:

	$ sudo service wiki2print status		$ sudo service wiki2print status

	$ sudo service wiki2print start		$ sudo service wiki2print start
	$ sudo service wiki2print stop		$ sudo service wiki2print stop

Simoon at 15:57, 22 August 2023

2023-08-22T15:57:19Z

← Older revision		Revision as of 15:57, 22 August 2023
Line 49:		Line 49:

	==jobrunner==		==jobrunner==
			MediaWiki comes with a maintenance script called <code>RunJobs.php</code> that writes changes to the database. The job queue is a built-in feature of MediaWiki that is made to increase the performance on large wikis.

	~~There is~~ a script called <code>jobrunner.sh</code> in <code>/var/www/html/wiki/</code> that is based on: https://www.mediawiki.org/wiki/Manual:Job_queue#Continuous_service		On CC we use a script called <code>jobrunner.sh</code> in <code>/var/www/html/wiki/</code> that is based on: https://www.mediawiki.org/wiki/Manual:Job_queue#Continuous_service

	It runs the MediaWiki maintenance script RunJobs.php '''every 10 seconds'''.		It runs the MediaWiki maintenance script <code>RunJobs.php</code> '''every 10 seconds'''.

	It is installed on CC and runs in the background as a systemd service, called "jobrunner", which can be used with:		It is installed on CC and runs in the background as a systemd service, called "jobrunner", which can be used with:

Manetta at 15:53, 22 August 2023

2023-08-22T15:53:18Z

← Older revision		Revision as of 15:53, 22 August 2023
Line 7:		Line 7:
	If you're stuck, this may be of use.		If you're stuck, this may be of use.

	==~~=Running wiki~~-to-print as a ~~background process=~~==		==Wiki-to-print as a service==

	Wiki-to-print is a Flask application that runs in the background as a service, using a systemd service file.		Wiki-to-print is a Flask application that runs in the background as a service, using a systemd service file.
Line 19:		Line 19:
	* The service is configured at: <code>/etc/systemd/system/wiki-to-print.service</code>		* The service is configured at: <code>/etc/systemd/system/wiki-to-print.service</code>
	* Here is an example of that file: https://git.vvvvvvaria.org/varia/wiki-to-print/src/branch/master/wiki-to-print.service.example		* Here is an example of that file: https://git.vvvvvvaria.org/varia/wiki-to-print/src/branch/master/wiki-to-print.service.example

			==Debugging==

	===For debugging (on the server)===		===For debugging (on the server)===

Manetta at 15:52, 22 August 2023

2023-08-22T15:52:20Z

← Older revision		Revision as of 15:52, 22 August 2023
Line 1:		Line 1:
	__TOC__		__TOC__

			'''Official disclaimer''': Many things can happen, 502 errors fly around your ears, wiki-to-print is not a product :) as long as it keeps running we're happy.

			BUT...

			If you're stuck, this may be of use.

	===Running wiki-to-print as a background process===		===Running wiki-to-print as a background process===
Line 12:		Line 17:
	$ sudo service wiki2print restart		$ sudo service wiki2print restart

	The service is configured at: <code>/etc/systemd/system/~~wiki2print~~.service</code>		* The service is configured at: <code>/etc/systemd/system/wiki-to-print.service</code>
			* Here is an example of that file: https://git.vvvvvvaria.org/varia/wiki-to-print/src/branch/master/wiki-to-print.service.example

	===For debugging (on the server)===		===For debugging (on the server)===
Line 22:		Line 28:
	Then run wiki-to-print manually from the folder where it is installed. First go to this folder:		Then run wiki-to-print manually from the folder where it is installed. First go to this folder:

	$ cd /var/www/~~wiki2print~~/~~web~~-~~interface~~/		$ cd /var/www/wiki-to-print/wiki-to-print/

	And then run the application:		And then run the application:
Line 44:		Line 50:
	There is a script called <code>jobrunner.sh</code> in <code>/var/www/html/wiki/</code> that is based on: https://www.mediawiki.org/wiki/Manual:Job_queue#Continuous_service		There is a script called <code>jobrunner.sh</code> in <code>/var/www/html/wiki/</code> that is based on: https://www.mediawiki.org/wiki/Manual:Job_queue#Continuous_service

	It runs the MediaWiki ~~jobs~~ '''every 10 seconds'''.		It runs the MediaWiki maintenance script RunJobs.php '''every 10 seconds'''.

	It is installed on CC and runs in the background as a ~~system-d~~ service, called "jobrunner", which can be used with:		It is installed on CC and runs in the background as a systemd service, called "jobrunner", which can be used with:

	$ sudo service jobrunner status		$ sudo service jobrunner status
Line 53:		Line 59:
	$ sudo service jobrunner reload		$ sudo service jobrunner reload

	The service is configured at: <code>/etc/systemd/system/jobrunner.service</code>		* The service is configured at: <code>/etc/systemd/system/jobrunner.service</code>
			* This is an example of the service file:

			[Unit]
			Description=MediaWiki Job runner

			[Service]
			ExecStart=/var/www/html/wiki/jobrunner.sh
			Nice=10
			ProtectSystem=full
			User=www-data
			OOMScoreAdjust=200
			StandardOutput=journal

			[Install]
			WantedBy=multi-user.target

	[[Category:Sysadmin]]		[[Category:Sysadmin]]
	[[Category:Wiki-to-print]]		[[Category:Wiki-to-print]]

Manetta: /* For debugging (on the server) */

2023-08-22T09:13:49Z

For debugging (on the server)

← Older revision		Revision as of 09:13, 22 August 2023
Line 16:		Line 16:
	===For debugging (on the server)===		===For debugging (on the server)===

	~~Wiki~~-to-print is installed ~~on CC at~~:		Stop the wiki2print service:

			$ sudo service wiki2print stop

			Then run wiki-to-print manually from the folder where it is installed. First go to this folder:

	$ cd /var/www/wiki2print/web-interface/		$ cd /var/www/wiki2print/web-interface/

	~~To get error logs, you can~~ run the ~~flask~~ application ~~directly with~~:		And then run the application:

	$ make server		$ make server

	If you add ~~prints~~ statements in the python files ~~you can see the result in~~ the ~~terminal~~.		And if needed, you can add print statements in the python files to dive deeper into the code.

	===For debugging (through a local installation)===		===For debugging (through a local installation)===

Manetta: /* jobrunner */

2023-08-21T15:22:47Z

jobrunner

← Older revision		Revision as of 15:22, 21 August 2023
Line 40:		Line 40:
	There is a script called <code>jobrunner.sh</code> in <code>/var/www/html/wiki/</code> that is based on: https://www.mediawiki.org/wiki/Manual:Job_queue#Continuous_service		There is a script called <code>jobrunner.sh</code> in <code>/var/www/html/wiki/</code> that is based on: https://www.mediawiki.org/wiki/Manual:Job_queue#Continuous_service

	It runs the MediaWiki jobs every 10 seconds.		It runs the MediaWiki jobs '''every 10 seconds'''.

	It is installed on CC and runs in the background as a system-d service, called "jobrunner", which can be used with:		It is installed on CC and runs in the background as a system-d service, called "jobrunner", which can be used with:

Manetta: /* jobrunner */

2023-08-21T15:22:39Z

jobrunner

← Older revision		Revision as of 15:22, 21 August 2023
Line 40:		Line 40:
	There is a script called <code>jobrunner.sh</code> in <code>/var/www/html/wiki/</code> that is based on: https://www.mediawiki.org/wiki/Manual:Job_queue#Continuous_service		There is a script called <code>jobrunner.sh</code> in <code>/var/www/html/wiki/</code> that is based on: https://www.mediawiki.org/wiki/Manual:Job_queue#Continuous_service

	It runs the MediaWiki jobs every ~~minute~~.		It runs the MediaWiki jobs every 10 seconds.

	It is installed on CC and runs in the background as a system-d service, called "jobrunner", which can be used with:		It is installed on CC and runs in the background as a system-d service, called "jobrunner", which can be used with:

Manetta: /* For debugging (on the server) */

2023-08-21T15:20:57Z

For debugging (on the server)

← Older revision		Revision as of 15:20, 21 August 2023
Line 16:		Line 16:
	===For debugging (on the server)===		===For debugging (on the server)===

	~~You can find the files of wiki~~-to-print ~~here~~:		Wiki-to-print is installed on CC at:

	$ cd /var/www/wiki2print/web-interface/		$ cd /var/www/wiki2print/web-interface/