User:Revansx/meza/Installing MEZA 34.x on a local Centos 7 VM from scratch
Appearance
< User:Revansx | meza
This procedure is meant to help new users get acquainted with Mediawiki via Meza
Prerequisite Downloads
[edit]- Oracle VirtualBox 7.0 from: https://www.virtualbox.org/wiki/Downloads
- (Windows users will click the "Windows Hosts" link)
- ISO image of the Centos7 x86 64 bit installation DVD from: http://isoredirect.centos.org/centos/7/isos/x86_64/
- pick from any of the mirrors listed - they are all the same
Install Oracle VirtualBox
[edit]- Click the VirtualBox Software Installed you downloaded above
- Perform a default installation (agree to everything as is)
Define a new VM in VBox (CENTOS7NEW)
[edit]- Launch VM VirtualBox Manager
- Click the blue "New" Top Menu Icon
- "Create Virtual Machine" Dialogue Box
- Set Name as: "CENTOS7NEW"
- Select Type: "Linux"
- Select Version: "Red Hat (64-bit)"
- Click "Next"
- Configure Memory Size: "4096M"
- Click "Next"
- Click "Create Virtual Machine virtual disk now"
- Change disk size from 20GB to 40GB
- Click "Next"
- Click "Finish"
- Click the blue "New" Top Menu Icon
Prep for a fresh install of Centos7
[edit]- Launch VM VirtualBox Manager
- Click "CENTOS7NEW" machine on the left to select the "CENTOS7NEW" machine
- Click "SETTINGS" in the top menu (big yellow gear)
- Viewing the CENTOS7NEW - Settings dialog box
- Click "Storage" on the left
- Click the Empty Blue CD/DVD Disk Icon to select the optical drive
- On the far right, click the Blue Disk Icon with the little black pulldown arrow on the far right
- In the dialogue box the appears, browse for and select the CENTOS7 DVD ISO file (you downloaded it earlier)
- ensure that the "Live CD/DVD" checkbox is selected
- Click the Empty Blue CD/DVD Disk Icon to select the optical drive
- Click "Storage" on the left
- Click "OK"
- Viewing the CENTOS7NEW - Settings dialog box
Install Centos7
[edit]- Start the CENTOS7NEW VM by clicking the "Start" in the top menu (big green arrow)
- Short start-up diagnostics
- Centos 7 install screens
- Using your arrows, select "Install CentOS7" and press "Enter"
- watch various Linux loading messages
- CENTOS7 INSTALLATION SCREEN
- Choose "English", Click "Continue"
- Click "SOFTWARE SELECTION", select "GNOME Desktop" (no other options), Click "DONE"
- Click "INSTALLTION DESTINATION", Click "DONE" (this selects the default option of automatic partitioning of the only available disk)
- Click "NETWORK & HOST NAME",
- make sure the network adapter is ENABLED and is showing as "CONNECTED", click DONE
- NOTE - Host name is "localhost.localdomain" - just note this for future ref
- Click "Begin Installation"
- Once you click "Begin Installation" VBox will being installing Centos7
- While it is installing components, take a minute to set-up the accounts as follows:
- Set the root password to "wiki" (remember, this is just a demo vm, not a production system),
- Click "Done" twice to accept the simple password
- Create a user as:
- Full Name: userx
- username: userx
- password: wiki
- Click the "Make this user administrator" box
- Click Done twice to accept the simple password
- ...Wait for ~1407 packages to be installed..
- REBOOT When instructed
Perform updates and other misc post install configurations
[edit]- Login to the CENTOS7NEW VM
- Short start-up diagnostics
- Centos Boot Options
- Using your arrows, select "CentOS7" and press "Enter"
- more loading messages
- CENTOS7 INITIAL SETUP SCREEN
- Choose "LICENSE INFO", agree to whatever, click Done
- Ensure that Network & Host Name is listed as CONNECTED
- Click FINISH CONFIGURATION
- Login Screen
- Click "Userx" to login
- Choose English
- Skip when you can
- Close-out the "Getting Started" window
- NOTE you are at the GUI desktop - congratulations
- USER DESKTOP
- Applications --> System Tools --> Setting --> Power --> Power Saving --> "Blank Screen" --> NEVER
- Applications --> Firefox --> Verify internet connection by opening a browser and visiting www.nasa.gov, close the bowser
- Applications --> System Tools --> Terminal
- FROM TERMINAL
sudo yum update -y
- FROM TERMINAL
- Reboot
Install Guest Additions and other worthwhile stuff
[edit]- Login to the CENTOS7NEW VM
- Short start-up diagnostics
- Applications --> System Tools --> Terminal
- FROM TERMINAL
sudo yum install “kernel-devel-uname-r == $(uname -r)”
(needed for guest editions)sudo yum install -y gcc
(needed for guest editions)sudo yum install -y perl
sudo yum install -y kernel-headers
sudo yum install -y kernel-devel
sudo yum install -y htop
- FROM TERMINAL
- 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
- Click "Run Software"
- wait while it builds the guest additions from scratch.
- Powerdown
CLONE YOUR NEW CENTOS7 VM
[edit]Why? .. so that you don't have to do all the steps above ever again
- Make a clone of "CENTOS7NEW" called "CENTOS7MEZA34X"
Install Meza
[edit]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 😎 ..
- Login to the MYSERVER1 VM
- From the MYSERVER1 Desktop --> Applications --> System Tools --> Terminal:
sudo yum install -y git
- watch the package manager install the Git packagesudo git clone https://github.com/enterprisemediawiki/meza /opt/meza
- watch git download the meza project from Github and install it in the/opt/meza
foldercd /opt/meza
- change to the /opt/meza directory
sudo git checkout "34.x"
- switch to the 34.x branch of meza
- Verify that you are on the "34.x" branch
git status
- Only proceed once you have confirmed that you are on the 34.x branch
- go back down to the /opt directory
cd ..
to return to the /opt directory
sudo bash /opt/meza/src/scripts/getmeza.sh
- watch the getmeza.sh shell script perform all the first-time only configurations and install the meza playbooks as ansible commands
Verify that MEZA is fixed to use PHP 7.2 per: Update php ius version to php 7.2
sudo meza deploy monolith
- enter:
127.0.0.1
as the target - enter:
abc123
as the database password - watch meza install and configure the entire MediaWiki software stack and all dependencies and extensions
- If Meza crashes
- Verify that Mediawiki Composer issue is fixed per:
- If Meza crashes
- wait for Meza to finish and report all tasks completed with no errors
- enter:
- From MYSERVER1 Desktop --> Applications --> Internet --> Firefox
- visit
https://localhost
- Click on the Demo Wiki
- Login as
Admin
with passwordadminpass
- visit
- Gratz! .. You are done.
/*end*/