User:Revansx/meza/Installing MEZA 35.x on a local Rock Linux 8 VM from scratch

This procedure is meant to help new users get acquainted with Mediawiki via Meza

Prerequisite Downloads

 * 1) Oracle VirtualBox from: https://www.virtualbox.org/wiki/Downloads
 * 2) *(Windows users will click the "Windows Hosts" lin)
 * 3) ISO image of the Centos7 x86 64 bit installation DVD from: http://isoredirect.centos.org/centos/7/isos/x86_64/
 * 4) *pick from any of the mirrors listed - they are all the same

Install Oracle VirtualBox

 * 1) Click the VirtualBox Software Installed you downloaded above
 * 2) Perform a default installation (agree to everything as is)
 * 1) Perform a default installation (agree to everything as is)

Define a new VM in VBox (MYSERVER1)

 * 1) Launch VM VirtualBox Manager
 * 2) Click "New"
 * 3) Create Virtual Machine Dialogue Box
 * 4) Set Name as: "MYSERVER1"
 * 5) Note the location of the machine folder on the local file system (this is where the VM lives as a file or files)
 * 6) Select Type: Linux
 * 7) Select Version: Red Hat (64-bit)
 * 8) Click "Next"
 * 9) Configure Memory Size: 4096M
 * 10) Create Virtual Machine virtual disk
 * 11) *Create a virtual hard disk now
 * 12) *Click "CREATE"
 * 13) Configure Hard Disk File Type
 * 14) *Choose: VDI (Virtual Hard Disk)
 * 15) *Click "NEXT"
 * 16) Configure Storage on Physical hard disk
 * 17) *Choose: Dynamically Allocated
 * 18) *Click "NEXT"
 * 19) Create Virtual Hard Disk
 * 20) Note path of vdi file
 * 21) Set size to: 40GB
 * 22) Click "CREATE"

Prep for a fresh install of Centos7

 * 1) Launch VM VirtualBox Manager
 * 2) Click "MYSERVER1" machine on the left to select the "MYSERVER1" machine
 * 3) Click "SETTINGS" in the top menu (big yellow gear)
 * 4) VM - Settings
 * 5) Click "Network" on the left
 * 6) ensure Adapter 1 is enabled and attached to NAT
 * 7) ensure Adapter 2 is enabled and attached to NAT
 * 8) Click "Storage" on the left
 * 9) Click the Empty Blue Disk Icon to select the optical drive
 * 10) on the right, click the Blue Disk Icon with the little black pulldown arrow on the far right
 * 11) In the dialogue box the appears, browse for and select the CENTOS7 DVD ISO file (you downloaded it earlier)
 * 12) ensure that the "Live CD/DVD" checkbox is selected
 * 13) Click "General" on the left
 * 14) Select Advanced -> Shared Clipboard: Bidirectional
 * 15) Click "OK" to close settings

Install Centos7

 * 1) Start the MYSERVER1 VM
 * 2) Click "Start" in the top menu (big green arrow)
 * 3) Short start-up diagnostics
 * 4) Centos 7 install screens
 * 5) Using your arrows, select "Install CentOS7" and press "Enter"
 * 6) more loading messages
 * 7) CENTOS7 INSTALLATION SCREEN
 * 8) Choose "English", Continue
 * 9) Click "SOFTWARE SELECTION", select "GNOME Desktop" (no other options), Click "DONE"
 * 10) Click "INSTALLTION DESTINATION", Click "DONE" (this selects the default option of automatic partitioning of the only available disk)
 * 11) Click "NETWORK & HOST NAME", make sure each network adapter is ENABLED and at least one of them is showing as "CONNECTED", click DONE
 * 12) NOTE - Host name is "localhost.localdomain" - just note this for future ref
 * 13) Click "Begin Installation"
 * 14) Set the root password to "abc123" (remember, this is just a demo vm, not a production system), Click "Done"
 * 15) Create user as:
 * 16) *Full Name: User X
 * 17) *username: userx
 * 18) UNCHECK Require Password
 * 19) SET Make this user administrator
 * 20) Click Done
 * 21) ...Wait for ~1407 packages to be installed..
 * 22) REBOOT When instructed

Perform updates and other misc post install configurations

 * 1) Login to the MYSERVER1 VM
 * 2) Short start-up diagnostics
 * 3) Centos 7
 * 4) Using your arrows, select "CentOS7" and press "Enter"
 * 5) more loading messages
 * 6) CENTOS7 INITIAL SETUP SCREEN
 * 7) Choose "LICENSE INFO", agree to whatever, click Done
 * 8) Ensure that Network & Host Name is listed as CONNECTED
 * 9) Click FINISH CONFIGURATION
 * 10) Login Screen
 * 11) *Click "User X" to login
 * 12) *Choose English
 * 13) Skip when you can
 * 14) *Close-out the "Getting Started" window
 * 15) *NOTE you are at the GUI desktop - congratulations
 * 16) USER DESKTOP
 * 17) Applications --> System Tools --> Setting --> Power --> Power Saving --> "Blank Screen"
 * 18) Applications --> Firefox --> Verify internet connection by opening a browser and visiting www.nasa.gov, close the bowser
 * 19) Applications --> System Tools --> Terminal
 * 20) FROM TERMINAL
 * 21) Reboot
 * 1) Reboot

Install Guest Additions

 * 1) Login to the MYSERVER1 VM
 * 2) Short start-up diagnostics
 * 3) Applications --> System Tools --> Terminal
 * 4) FROM TERMINAL - https://www.dev2qa.com/how-to-resolve-virtualbox-guest-additions-kernel-headers-not-found-for-target-kernel-error/
 * 5) virtually Insert the "GuestAdditions" disk to the VM virtual optical drive by hovering over "Devices" and selecting "Insert Guest Additions CD image..." then launch it by double-clicking on the desktop
 * 6) Click "Run Software"
 * 7) wait while it builds the guest additions from scratch.
 * 8) Reboot
 * 1) Click "Run Software"
 * 2) wait while it builds the guest additions from scratch.
 * 3) Reboot

Install Meza
At this point.. you should have a fully installed and fully updated Centos7 Linux Workstation with all the VBox Guest Additions installed.

Now its time to install Meza 😎 ..


 * 1) Login to the MYSERVER1 VM
 * 2) From the MYSERVER1 Desktop --> Applications --> System Tools --> Terminal:
 * 3) *watch the package manager install the Git and Ansible packages
 * 4) *watch git download the 35.x branch of the meza project from Github and install it in the  folder
 * 5) *watch the getmeza.sh shell script perform all the first-time only configurations and install the meza playbooks as ansible commands
 * 6) *enter:  as the target
 * 7) *enter:  as the database password
 * 8) *watch meza install and configure the entire MediaWiki software stack and all dependencies and extensions
 * 9) *wait for Meza to finish and report all tasks completed with no errors
 * 10) **The Check for Python3 fail at the very end of the deployment is a known issue: https://github.com/enterprisemediawiki/meza/issues/1266, but does not impact the deployment.
 * 11) ***Until that task is fixed it would be entirely reasonable to comment it out at the very end of
 * 12) This will setup a demo wiki with the user  with password.
 * 13) From MYSERVER1 Desktop --> Applications --> Internet --> Firefox
 * 14) visit
 * 15) Click on the Demo Wiki
 * 16) Login as  with password
 * 17) Gratz! .. You are done.
 * 1) visit
 * 2) Click on the Demo Wiki
 * 3) Login as  with password
 * 4) Gratz! .. You are done.

/*end*/