Installing 

  MediaWiki   using   VirtualBox 
Install   VirtualBox   with   your   package   manager   or   download   it   from   the 
https://www.virtualbox.org/   website   and   follow   the   installation   instructions. 

Load   an   Image 
For   workshops   the   best   way   to   get   a  quick   start,   is   if   everyone   loads   a  ready­made   virtual 
machine   image.   In   this   example   the   virtual   machine   image   is   stored   on   a  USB   stick   as   a 
series   of   7zip   files.   First   you   need   to   copy   the   files   from   the   USB   stick   to   your   own   hard   drive 
and   while   the   files   are   copying   you   can   download   and   install   7zip   and   Virtualbox: 
 
● https://www.virtualbox.org/ 
● http://www.7­zip.de/ 
 
Once   the   files   are   downloaded   and   7zip   is   installed   you   can   extract   the   virtual   machine 
archive   by   clicking   on   the   first   7zip   archive   file   and   choosing   “extract   here”. 
 
after   extracting   the   file   you   can   open   the   image   using   VirtualBox: 
 

 
 
After   loading   the   *.vbox   /  *.vdi   file   simply   press   on   “Start”   to   boot   the   virtual   machine. 
 

1/13 
  
 
 

Create   your   own   virtual   machine 
If   you   want   to   create   your   own   virtual   machine   you   still   have   to   download   an   operating 
system.   We   will   use   Ubuntu   16.04.   Download   the   ISO   file   of   the   installation   disk   from: 
https://www.ubuntu.com/download/desktop 
 
After   the   download   is   complete   you   can   start   virtual   box   and   click   on   “New”.   Then   you   need 
to   choose   a  name   for   your   machine.   “Ubuntu   Mediawiki”   is   a  good   choice   to   remember   what 
might   be   inside   the   virtual   machine. 
 

 
 
Then   we   need   to   choose   how   much   RAM   will   be   available   to   the   machine.   We   need   at   least 
3GB   to   run   an   IDE,   the   operating   system   and   a  web   browser   comfortably.   Allocate   more   if 
you   can: 
 

2/13 
  
 
 
Then   we   need   to   choose   how   much   disk   space   we   will   give   to   the   guest   operating   system 
(the   guest   being   the   operating   system   that   runs   on   the   host,   which   is   your   physical 
computer).   Choose   to   “Create   a  virtual   hard   disk   now”: 
 

 
 
In   the   next   screens   choose   “V   DI   (Virtual   Disk   Image) ”  and   “D
  ynamically   Allocated ”.   Then 
choose   the   disk   space.   15   GB   is   a  good   size   for   Ubuntu   and   some   additional   software   if   you 
need   it.   The   disk   space   is   allocated   dynamically,   but   resizing   partitions   later   is   a  little   harder, 
so   choose   a  good   value   now: 
 
 

3/13 
  
 
 
Click   on   Create   to   finish   the   initial   setup.   Then   click   on   settings   to   make   some   additional 
choices.   In   the   System   settings   (Tab:   Processor)   you   can   choose   to   share   more   than   one 
CPU   core   with   your   guest   system. 
 

 
 
Sharing   your   whole   video   memory   with   the   guest   can   also   help   with   performance: 
 

4/13 
  
 
 
 
 
 
 
Finally   you   need   to   choose   the   downloaded   disk   image   as   your   installation   disk: 
 

 
 
Then   click   on   “Start   to   boot   the   machine”.   Be   ready   to   press   the   spacebar   to   jump   into   the 
Ubuntu   setup.   Choose   a  language   and   then   choose   “Install   Ubuntu”. 
 

5/13 
  
 
Then   choose   the   installation   language.   In   the   next   step   you   are   asked   about   downloading 
updates   and   3rd   party   libraries,   which   we   don’t   need.   Then   choose   to   erase   your   disk   (This 
is   the   virtual   disk   we   created.   It   will   not   affect   your   host   system): 
 

6/13 
  
You   are   then   still   asked   about   your   timezone,   your   keyboard   language.   Then   you   are   asked 
to   create   a  username   and   password   for   your   guest   system: 
 

 
After   the   files   have   been   copied   choose   to   restart   the   virtual   machine.   When   it   is   restarted 
start   a  terminal   (You   can   find   it   in   the   quick   launch   search).   Then   we   need   to   install   a  few 
things: 
 

7/13 
  
 
sudo   apt­get   install   git 
sudo   apt­get   install   composer 
sudo   apt­get   install   apache2   mysql­server   php   php­mysql   libapache2­mod­php   php­xml 
php­mbstring 
sudo   apt­get   install   mariadb­server 
 
After   that   you   can   check   if   the   mariadb   database   is   running.   On   Linux   the   database   is   a 
service.   To   check   use: 
service   mysql   status   (mariadb   takes   the   place   of   mysql) 

8/13 
  
 
Now   it   is   time   to   download   Mediawiki   like   developers   do,   using   git.   We   can   use   the   open 
terminal   to   do   a  git   clone.   The   “w”   at   the   end   means   that   we   will   clone   into   the   w  directory. 
 
git   clone  h   ttps://gerrit.wikimedia.org/r/p/mediawiki/core.git   w 
 

9/13 
Go   into   the   “w”   directory   (Use   “ls”   and   cd   folder­name)   to   orient   yourself   and   navigate   around 
with   the   terminal.   Then   use   composer   install   to   install   all   of   Mediawikis   dependencies 
automatically: 

 
 
Then   we   need   to   start   the   webserver.   The   apache   webserver   is   also   a  service   on   Linux.   Use 
“service   apache2   status”   to   see   if   it   is   running.   If   not   use   “service   apache2   start”. 

10/13 
Now   we   need   to   go   into   the   standard   web   server   directory   and   create   a  link   to   our   folder   in 
our   home   directory: 
 
cd   /var/www/html 
sudo   ln   ­s   /home/YOURUSERNAME/w   w  (create   a  link   from   the   w  directory   in   your   home 
directory   in   the   current   directory   and   name   it   “w”) 
 

 
 
After   that   you   should   be   able   to   go   with   your   browser   to   127.0.0.1/w   and   look   at   the 
Mediawiki   startpage.   My   installtion   says   that   I  am   still   missing   some   libraries   which   I  need   to 
install   now:   “mbstring”   and   “xml”.   They   are   actually   already   installed   so   I  just   had   to   fix   the 
environment: 
 
sudo   phpenmod   mbstring 
sudo   phpenmod   xml 
 
After   restarting   the   webserver   (sudo   service   apache2   restart)   the   installation   page   shows   up 
correctly: 
 

11/13 
  
 
Now   we   can   start   configuring   our   Mediawiki   installation.   We   will   follow   the   instruction   of   the 
installation   wizard   to   create   a  LocalSettings.php   file. 
 
On   the   third   page   of   the   setup   we   need   to   choose   our   database   connection.   Remember   that 
our   database   server   is   already   running,   but   we   did   not   create   a  user   and   database   yet. 
 
Go   to   a  terminal   and   use: 
 
sudo   mysql_secure_installation 
 

12/13 
  
 
Answer   yes   to   the   question   about   the   root   password   and   set   one.   Then   use: 
sudo   mysql   ­u   root   ­p 
 
to   login   into   the   mysql   shell. 
 
Then   you   can   use:  
show   databases 
 
To   create   one   for   the   wiki   use: 
CREATE   USER   'newuser'@'localhost'   IDENTIFIED   BY   'password'; 
CREATE   DATABASE   my_wiki 
GRANT   ALL   PRIVILEGES   ON   *  .  *  TO   'newuser'@'localhost'; 
 
Then   on   the   setup   page   enter   that   information   and   click   next.   If   everything   worked   as 
expected   you   reach   another   database   page   that   asks   for   example   about   the   character   set. 
I   choose   UTF­8   here. 
 
Then   it   is   time   to   choose   a  name   for   the   wiki.   And   you   also   have   to   set   the   username   and 
password. 
 
After   a  few   more   easy   to   answer   question   you   will   be   prompted   to   download   the  
 
 

13/13