How to create a simple to use Wiki based on MediaWiki in ... - VMware

<strong>How</strong> <strong>to</strong> Create a Simple <strong>to</strong>Use <strong>Wiki</strong> Based on Media<strong>Wiki</strong>in a vCloud ® EnvironmentA VMware Cloud Evaluation Reference Document

ContentsAbout Cloud ComputingCloud computing is an approach <strong>to</strong> computing that pools or aggregatesIT infrastructure resources. Using Infrastructure-as-a-Service (IaaS),through cloud computing, gives you a more efficient, flexible andcost-effective infrastructure. Clouds typically include a set of virtualmachines (“VM”s). A virtual machine is an isolated software containerthat can run its own operating systems and applications as if it werea physical computer, and contains it own virtual (i.e., software-<strong>based</strong>)CPU, RAM, hard disk and network interface card (NIC). Users can startand s<strong>to</strong>p Virtual Machines or <strong>use</strong> compute cycles, as needed. Clouds canbe on-site (commonly referred <strong>to</strong> as ‘Private Clouds’), with a ServiceProvider (‘Public Cloud’), or a combination of the two (‘Hybrid Cloud’).Overview ...................................................................................................... 3Features ....................................................................................................... 4Components & Requirements ............................................................... 5Installation ................................................................................................... 6Resources ................................................................................................... 15What is vCloud?VMware vCloud is a software suite that empowers enterprises <strong>to</strong>transform their existing vSphere infrastructure in<strong>to</strong> a consumable,self-managed, web-<strong>based</strong> service. It provides a window for end-<strong>use</strong>rprovisioning and deployment of servers, and enables enterprises <strong>to</strong>isolate departments IT deployments <strong>to</strong> provide unique quality ofservice requirements <strong>to</strong> each business unit. Organizations can maintainone or many shared catalogues, so business units can quickly andeasily deploy cus<strong>to</strong>m servers on-the-fly without the need for furtherIT intervention. The VMware vCloud suite is built on <strong>to</strong>p of vSphere,the industry standard in virtualization technology, and carries withit the enterprise-grade quality and features that you would expectfrom VMware.<strong>How</strong> <strong>to</strong> Create a Simple <strong>to</strong> Use <strong>Wiki</strong> Based on Media<strong>Wiki</strong> in a vCloud Environment 2

OverviewThe VMware Cloud Evaluation includes access <strong>to</strong> a host ofVMware virtual appliances that leverage BitNami OS andapplication templates. This document foc<strong>use</strong>s on getting startedwith Media<strong>Wiki</strong>, a free, open-source, and easy <strong>to</strong> <strong>use</strong> wikiplatform. Unlimited <strong>use</strong> of the Media<strong>Wiki</strong> template is one of themany benefits of the VMware Cloud Evaluation.VMware Virtual AppliancesVMware Virtual Appliances, or vApps, are pre-packaged softwaresolutions comprised of one or more Virtual Machines containingall necessary functionality <strong>to</strong> be easily deployed in any VMware<strong>based</strong> infrastructure, such as VMware vSphere and VMwarevCloud Direc<strong>to</strong>r.Packaged from the BitNami Stacks program, these VirtualAppliances contain all the components that the particular OpenSource application requires. For example, the virtual appliancecomponents may include Apache, MySQL, PHP or Ruby, as wellas the Linux-<strong>based</strong> operating system they are configured <strong>to</strong>run in.The Media<strong>Wiki</strong> Template within the VMwareCloud EvaluationThis document describes the process of deploying theMedia<strong>Wiki</strong> template within the VMware Cloud Evaluation.Media<strong>Wiki</strong> is a wiki package originally written for <strong>Wiki</strong>pedia. It isnow <strong>use</strong>d by several other projects of the non-profit <strong>Wiki</strong>mediaFoundation and by many other wikis. Media<strong>Wiki</strong> was designed <strong>to</strong>be run on a large server farm for a website that gets millions ofhits per day. You can learn more about Media<strong>Wiki</strong> atwww.mediawiki.org/wiki/Media<strong>Wiki</strong>The Media<strong>Wiki</strong> vApp is a ready-<strong>to</strong>-deploy virtual machine thatcontains all of the runtime dependencies <strong>to</strong> get up and runningquickly with minimal setup. Media<strong>Wiki</strong> vApp also includesready-<strong>to</strong>-run versions of Apache, MySQL and PHP. Built upon theMedia<strong>Wiki</strong> BitNami stack this vApp is distributed for free underthe Apache 2.0 license.Optimized for cloud computing, vApps are portable, scalableand easy <strong>to</strong> deploy, making them the perfect fit <strong>to</strong> run in yourVMware Cloud Evaluation environment.Simply deploy the vApp in your VMware Cloud Evaluationinstance and you’re ready <strong>to</strong> start configuring it <strong>to</strong> meetyour needs. Each vApp can be cus<strong>to</strong>mized, so please refer <strong>to</strong>the documentation for each vApp <strong>to</strong> make sure <strong>to</strong> go throughall the necessary steps <strong>to</strong> setup and initialize your newVirtual Appliance.<strong>How</strong> <strong>to</strong> Create a Simple <strong>to</strong> Use <strong>Wiki</strong> Based on Media<strong>Wiki</strong> in a vCloud Environment 3

FeaturesVMware Ready vApps are built with a few goals in mind,including:• Ease of deployment• Independence, agility and portability across anyVMware-<strong>based</strong> infrastructure• Scalability <strong>to</strong> meet application growth as needed• Ability <strong>to</strong> cus<strong>to</strong>mize <strong>to</strong> configure the vApp <strong>to</strong> suit your needsEase of DeploymentVMware vApps make the process of deploying and installing afull Open Source solution incredibly easy, so you can be up andrunning in just a few clicks.IndependentVMware vApps are completely self-contained, and as a result donot interfere with any software currently deployed in your vCloudenvironment simplifying deployment and easing concerns ofconflicts.ScalableWhen your application has outgrown its current capacity, addingmore resources is as easy as a few clicks. Designed for scalability,a vApp can have more RAM or CPU allocated <strong>to</strong> it wheneveryou choose.Cus<strong>to</strong>mizableSince the VMware Cloud Evaluation <strong>use</strong>s templates built onpopular Open Source applications, there is already a vibrantcommunity of people who have contributed how-<strong>to</strong> guides,cus<strong>to</strong>mization guides, themes, and add-on utilities <strong>to</strong> most ofthe applications the vCloud Service Evaluation offers. Everythingfrom WordPress themes <strong>to</strong> Drupal modules are available for <strong>use</strong>and integration with your application.PortableVMware vApps can be migrated <strong>to</strong> new hosts, new vClouds,or exported and moved <strong>to</strong> an entirely new VMware <strong>based</strong>environment, meaning you can bring it with you when yourneeds change. Deploy internally <strong>to</strong> initially test, and then<strong>use</strong> VMware vCloud Connec<strong>to</strong>r <strong>to</strong> migrate the workload <strong>to</strong>your VMware Cloud Evaluation, or transfer it over <strong>to</strong> a fullVMware Certified Public Cloud provider listed atvcloud.vmware.com/partners/vspp<strong>How</strong> <strong>to</strong> Create a Simple <strong>to</strong> Use <strong>Wiki</strong> Based on Media<strong>Wiki</strong> in a vCloud Environment 4

Components & RequirementsComponentsThe Media<strong>Wiki</strong> vApp ships with the following software versionsrunning on Ubuntu 12.04:• Apache 2.2.x• MySQL 5.5.x• PHP 5.3.x• phpMyAdmin 3.5.4RequirementsThe minimum requirements <strong>to</strong> install the Media<strong>Wiki</strong> vApp arelisted below. These minimum requirements are met whenutilizing the “Standard” resource package within the VMwareCloud Evaluation.• Intel x86 or compatible processor running ESX or ESXi• Minimum of 256 MB of RAM dedicated <strong>to</strong> the vApp• Minimum of 150 MB of Hard Disk space• Valid Networking configured <strong>to</strong> the vApp<strong>How</strong> <strong>to</strong> Create a Simple <strong>to</strong> Use <strong>Wiki</strong> Based on Media<strong>Wiki</strong> in a vCloud Environment 5

InstallationThe Media<strong>Wiki</strong> vApp is distributed as an Open VirtualizationFormat (OVF) package. Deploying this package is <strong>simple</strong>.1. Login <strong>to</strong> your VMware Cloud Evaluation Console atvcloudservice.vmware.com<strong>How</strong> <strong>to</strong> Create a Simple <strong>to</strong> Use <strong>Wiki</strong> Based on Media<strong>Wiki</strong> in a vCloud Environment 6

Installation2. Select the “My Clouds” tab3. Click the “Add a New Server” but<strong>to</strong>n<strong>How</strong> <strong>to</strong> Create a Simple <strong>to</strong> Use <strong>Wiki</strong> Based on Media<strong>Wiki</strong> in a vCloud Environment 7

Installation4. A popup form will appear with all of the field informationneeded <strong>to</strong> <strong>create</strong> the virtual machine. Enter the name ofyour server in the Server Label field and select the vApp youwould like the server <strong>to</strong> reside in. You can <strong>create</strong> a new vAppby selecting “Create New vApp” and entering the name ofthe vApp.<strong>How</strong> <strong>to</strong> Create a Simple <strong>to</strong> Use <strong>Wiki</strong> Based on Media<strong>Wiki</strong> in a vCloud Environment 8

Installation5. Select the “Applications“ Template<strong>How</strong> <strong>to</strong> Create a Simple <strong>to</strong> Use <strong>Wiki</strong> Based on Media<strong>Wiki</strong> in a vCloud Environment 9

Installation6. Select “Media<strong>Wiki</strong>” from the next drop down list.<strong>How</strong> <strong>to</strong> Create a Simple <strong>to</strong> Use <strong>Wiki</strong> Based on Media<strong>Wiki</strong> in a vCloud Environment 10

Installation7. Use the slider <strong>to</strong> choose the amount of resource required.<strong>How</strong> <strong>to</strong> Create a Simple <strong>to</strong> Use <strong>Wiki</strong> Based on Media<strong>Wiki</strong> in a vCloud Environment 11

Installation8. Select “Add a New Hard Drive” and enter the amoun<strong>to</strong>f s<strong>to</strong>rage.<strong>How</strong> <strong>to</strong> Create a Simple <strong>to</strong> Use <strong>Wiki</strong> Based on Media<strong>Wiki</strong> in a vCloud Environment 12

Installation9. Check the boxes <strong>to</strong> assign your server an external IP addressand allow traffic for the common incoming ports. Theseoptions can be configured or changed at a later time bygoing <strong>to</strong> the “View my Virtual Networks” sub-tab underMy Cloud.<strong>How</strong> <strong>to</strong> Create a Simple <strong>to</strong> Use <strong>Wiki</strong> Based on Media<strong>Wiki</strong> in a vCloud Environment 13

Installation10. Click “Add New”When your server is <strong>create</strong>d it will be in a powered off state.To access your Media<strong>Wiki</strong> vApp select the power but<strong>to</strong>n andbrowse <strong>to</strong> the external IP address listed in the server details.The default <strong>use</strong>r name is “<strong>use</strong>r” and the default password is“bitnami.” We recommend changing the password withinthe Media<strong>Wiki</strong> application. More information on how <strong>to</strong> <strong>use</strong>Media<strong>Wiki</strong> once deployed is located on the Media<strong>Wiki</strong> site at:mediawiki.org/wiki/Media<strong>Wiki</strong>Once installed, you can further cus<strong>to</strong>mize the installation byusing the vCloud Direc<strong>to</strong>r interface. Please refer <strong>to</strong> Section 8 ofthe vCloud Direc<strong>to</strong>r User Guide for information on using vCloudDirec<strong>to</strong>r <strong>to</strong> work with a vApp. Please seevmware.com/go/vcd-<strong>use</strong>rguide<strong>How</strong> <strong>to</strong> Create a Simple <strong>to</strong> Use <strong>Wiki</strong> Based on Media<strong>Wiki</strong> in a vCloud Environment 14

ResourcesFor additional information on how <strong>to</strong> cus<strong>to</strong>mize yourMedia<strong>Wiki</strong> vApp, visit:wiki.bitnami.org/Applications/BitNami_Media<strong>Wiki</strong>Learn more about BitNami:bitnami.orgTo find additional VMware Ready Virtual Appliances, visit theVMware Solution Exchange:solutionexchange.vmware.com/s<strong>to</strong>re<strong>How</strong> <strong>to</strong> Create a Simple <strong>to</strong> Use <strong>Wiki</strong> Based on Media<strong>Wiki</strong> in a vCloud Environment 15

VMware, Inc. 3401 Hillview Avenue Palo Al<strong>to</strong> CA 94304 USA Tel 877-486-9273 Fax 650-427-5001 www.vmware.comCopyright © 2013 VMware, Inc. All rights reserved. This product is protected by U.S. and international copyright and intellectual property laws. VMware products are covered by one or more patents listed at www.vmware.com/go/patents.VMware is a registered trademark or trademark of VMware, Inc. in the United States and/or other jurisdictions. All other marks and names mentioned herein may betrademarks of their respective companies.