Meza/Install on Virtual Box
Expert steps
edit- Setup a machine in Virtual Box with a NAT as network adapter 1 and a host-only as adapter 2.
- Install CentOS minimum install on a virtual machine. This won't have networking enabled or SSH installed.
- Boot your VM, and type these in (without SSH you can't copy-paste)
sudo ifup enp0s3 sudo yum install -y git sudo git clone https://github.com/nasa/meza /opt/meza sudo bash /opt/meza/src/scripts/dev-networking.sh
- Now SSH into your machine and run
sudo bash /opt/meza/src/scripts/getmeza.sh
thensudo meza deploy monolith
.
This will setup a demo wiki with the user Admin
with password adminpass
. Update this password or remove this user for production environments. To add wikis see Meza/Adding wikis.
Detailed steps
editBelow are detailed steps to get meza running on your machine.
Downloads and Installs
edit- Download and install VirtualBox
- Install Git
- On Windows only, you also need to use this for the Git Bash terminal (once installed right click on any window and select "git bash here")
- On Windows only, install PuTTY (You probably want the "Windows MSI installer")
- Download CentOS 7 minimal install into your home directory (e.g.
echo $HOME
) - Clone the meza repository in your terminal:
cd $HOME && git clone https://github.com/nasa/meza
Create a new VM
edit- Create a new Virtual Machine (VM) in VirtualBox:
- Change to meza's scripts directory:
cd meza/src/scripts
- Run the Create VM script:
./create-vm.sh
and follow the prompts. You need at least 10GB of disk space for a basic install.
- Change to meza's scripts directory:
- Install CentOS onto your new VM: Start the VM and follow the prompts.
- If you intend for this VM to have a large amount of wiki data (requiring >50 GB for the database, uploaded files, and any backup files from another server), you'll need to configure partioning at the "Installation Summary" screen, via "Installation Destination". Under "Other Storage Options", select "I will configure partitioning." Upon clicking "Done" you will be prompted to configure partition allocation. You can "Click here to create them automatically" and then make adjustments. For an example with 100 GiB total, if you allocate 1 GiB to
/home
you can then allocate 100 GiB to/
. It will automatically adjust to allocate as much as possible from the remaining amount while leaving enough for/boot
andswap
.
- If you intend for this VM to have a large amount of wiki data (requiring >50 GB for the database, uploaded files, and any backup files from another server), you'll need to configure partioning at the "Installation Summary" screen, via "Installation Destination". Under "Other Storage Options", select "I will configure partitioning." Upon clicking "Done" you will be prompted to configure partition allocation. You can "Click here to create them automatically" and then make adjustments. For an example with 100 GiB total, if you allocate 1 GiB to
Configure the VM
editOnce installed, you'll need to get networking started. Unfortunately in these first few steps you can't copy/paste, so you'll have to type these manually.
sudo ifup enp0s3
sudo yum install -y git
sudo git clone https://github.com/nasa/meza /opt/meza
sudo bash /opt/meza/src/scripts/dev-networking.sh
These steps do the following:
- Start networking
- Get the meza setup script
- Setup the
meza
command - Adds SSH, starts host-only network adapter
Confirm SSH works
edit- Assuming your VM's IP address is 192.168.56.56
- For Mac/Linux/Unix, open your terminal and run
ssh root@192.168.56.56
orssh yourusername@192.168.56.56
- For Windows, open PuTTY and type 192.168.56.56 into the "Host Name (or IP address)" field and hit "Open" then login with your credentials
Shutdown, snapshot
edit- Shutdown your VM:
sudo shutdown -h now
- Take a snapshot and call it something like "baseline configuration". Click the "snapshots" icon in the top-right of VirtualBox and then click the camera icon. You'll be able to jump back to this point at any time.
Install wiki server
edit- Start your VM
- SSH into the VM
- Run
sudo bash /opt/meza/src/scripts/getmeza.sh
to setup themeza
command and get some things ready - Run
sudo meza deploy monolith
to install your wiki server.
This will setup a demo wiki with the user Admin
with password adminpass
. Update this password or remove this user for production environments. To add wikis see Meza/Adding wikis.
Red Hat
editWant to setup a Red Hat VM instead of CentOS? See Meza/Setup a RedHat VM.
Creating a clone of a VM
editIt's possible to create a clone of a virtual machine. While this is not specific to Meza, cloning VMs is sometimes useful when working with wikis and Meza. See Meza/Cloning VirtualBox VMs for more info.