Wikiation check isolation
Wikiation_check_isolation is a testprogram to determine the difference after installing a extension with the content of a external reference server. The test only returns files which content does differ.
Contents |
Fullname
The full name of the program is : Wikiation_check_extension_isolation The full name better describes the purpose of the program. For practical reasons in this documentatie and the program name on the clean machine, the name is : wikiation_check_isolation.
Before this program had the name CheckMWandDBdiff. The new name describes the purpose better.
Syntax
Full name of the program : wikiation_check_isolation
wikiation_check_isolation mwversion [--detail|-d] [excluded_dir]
Argument mwversion
Multiple MediaWiki version may be installed. The name of the MediaWiki version which have to be checked. Versions can be found with the statement in Wikiation_installer#ls_available
Argument detail
Default wikiation_check_isolation does only return which file differs. With this argument is does show what differs in the files.
--detail, -d
Usage
At start do not use the argument so the number of output is limited. If only one, or a few files differs, and you may think about excepting these difference then do use this argument. The you know precise what is different between the original MediaWiki installation.
Argument dir
The files in the Clean Machine MediaWiki installation are compared with reference files. If you do nothing the reference files wil be equal to the Clean Machine. But you want to do something; installing a new extension.
name of the extension directory
Usage
You want to see all the difference except the extension directory you just installed to test. So without the argument you always would see some differences. With this argument you just installed extension directory will be ignored wile comparing with the reference files.
With perfect isolation
No addition code, except the exension "x" in a separate subdirectory "y".
wikiation_check_isolation y
The difference in directory "y" will be igored.
Example result
No difference
* After installation no difference found with the original MediaWiki core. * After installation no difference found with the structure of the original MediaWiki database.
With difference
For this example in a README file one charater is changed.
* After installation no difference found with the structure of the original MediaWiki database. * MediaWiki differences: Files /var/www/mediawiki-1.12.0/includes/cbt/README and /usr/local/test/data/mediawiki-1.12.0/includes/cbt/README differ
With details
This some other example.
CleanMachine:~# wikiation_check_isolation -d root@83.149.110.224's password: data.tar.gz 100% 7123KB 7.0MB/s 00:01 Unpacking. Running checks:
* After installation no difference found with the structure of the original MediaWiki database.
* MediaWiki differences:
diff -r -N /var/www/mediawiki-1.12.0/locale/README /usr/local/test/data/mediawiki-1.12.0/locale/README 1c1 < Thiss directory is for .po files generated by ./maintenance/language/lang2po.php --- > This directory is for .po files generated by ./maintenance/language/lang2po.php
As you can see the difference is one file with the "This" first spelled with 2 "s" and the other with 1 "s".
CleanMachine:~# ls
Without perfect isolation
With addition code, the extension "x" is in a separate subdirectory "y".
wikiation_check_isolation y
The difference in directory "y" will be igored.
Because additional code is changed there will be changes found. Compare these changes with the extension documentation. If you feel this is save enough for, do use the extension. If not do not use it.
No harm done
Because you did test it in this extension tester if the extension did made some changes which you do not like no harm is done. You know it and you can continue without this specific extension. If you should install first it on you own server then the changes are already made. And you do not have any information about it so you are not warned. Even if you are have the idea something is going wrong it is very time consuming to restore the original situation.
Reference
The Wikiation installer does installs the desired MW version. And also store the MW core and DB structure separate. wikiation_check_isolation does use this information to compare if changes did occur after installing the MW software using the MW installer.
Data
The reference data is stored by the Wikiation_installer in directory (path) :
/usr/local/wikiation/test/revisions
If you would like to view the content by yourself. For safety reasons please do not alter.
