VMWare ESX install

MindTouch Deki Virtual Appliance Installation for ESX 3.x

Get the Virtual Appliance

Note: If you have ESX 3.5, MindTouch Deki can be imported directly from the new VMWare Virtual Appliance Marketplace! Instructions can be found here: MindTouch Deki Virtual Appliance Marketplace Installation Guide

 

If the Virtual Appliance Marketplace is not available, use the following steps:

Download virtual appliance from http://wiki.mindtouch.com, and extract contents of the zip file to a temporary location.

Using your preferred file transfer mechanism, e.g. ftp, scp, etc., copy the virtual machine files (*.vmx, *.vmsd, *.vmdk) from your local system to an ext3 formatted partition (not the VMFS3 volume where the files will ultimately reside) on the ESX host.

On the VMware ESX Server 3.x system where the virtual machine will be hosted, log in to the Service Console and navigate to the VMFS3 volume where the virtual machine files will be located. Create a new subdirectory for the files called “deki”. For example, on a VMFS3 volume named “myvmfs3”:

# mkdir /vmfs/volumes/myvmfs3/deki 

Copy all of the files except for the virtual disk (the vmdk file) file from the ext3 partition to the newly created directory on the VMFS3 volume. For example, to copy the files to a VMFS3 volume named “myvmfs3”, if the files were originally placed in the /tmp ext3 partition:

# cp /tmp/Deki_Wiki_Kilen_Woods_8.08.1_VM.vmx /vmfs/volumes/myvmfs3/deki

Update the permissions on the configuration(vmx)file to include execute permissions for user, group, and other using the Linux chmod command. Navigate to the virtual machine’s directory, e.g. /vmfs/volumes/myvmfs3/deki and enter:

# chmod 755 Deki_Wiki_Kilen_Woods_8.08.1_VM.vmx


Import the virtual machine disk file into VMFS

Import the virtual machine’s virtual disk (vmdk) file from the ext3 partition to the VMFS3 volume
using the clone (import) function of the ESX vmkfstools utility. There are two interrelated
considerations to be made when performing this operation:

  • To maximize disk I/O performance with no concern about the amount of physical disk
    utilized initially, use the default virtual disk format. The virtual disk file will be fully inflated
    to consume the configured 30 gigabytes and will not grow beyond that size. This fully-allocated
    disk format is the ESX default and is called “zeroed-thick”. Note that it will also take
    significantly longer to clone to this format.
  • To utilize a minimal amount of disk space initially, which will result in a small I/O
    performance degradation, use the thin virtual disk format. The virtual disk file will initially
    consume approximately 2 gigabytes and will grow up to 30 gigabytes as additional disk is required.
    This allocate-on-use disk format is called “thin”.


The format of the vmkfstools utility for the clone function is as follows:

vmkfstools –i source_file [–d file_format] destination_file


Assuming the source ext3 partition is /tmp and the destination VMFS3 volume is named “myvmfs3”,
then the command would appear as follows for each of the two aforementioned options (note that the destination includes the VMFS3 volume name and the subdirectory that was created in earlier):

Fully-allocated (“zeroed-thick”):

# vmkfstools –i /tmp/Deki_Wiki_Kilen_Woods_8.08.1_VM.vmdk /vmfs/volumes/myvmfs3/deki/Deki_Wiki_Kilen_Woods_8.08.1_VM.vmdk

Result:

Destination disk format: VMFS thick
Cloning disk '/tmp/Deki_Wiki_Kilen_Woods_8.08.1_VM.vmdk'...
Clone: 100% done.

Allocate-on-use (“thin”):

# vmkfstools –i /tmp/Deki_Wiki_Kilen_Woods_8.08.1_VM.vmdk –d thin /vmfs/volumes/myvmfs3/deki/Deki_Wiki_Kilen_Woods_8.08.1_VM.vmdk

Result:

Destination disk format: VMFS thin-provisioned
Cloning disk '/tmp/Deki_Wiki_Kilen_Woods_8.08.1_VM.vmdk'...
Clone: 100% done.

Inspect the virtual machine subdirectory and you should see two new files, a small file (< 1-KB) named Deki_Wiki_Kilen_Woods_8.08.1_VM.vmdk and another larger file named Deki_Wiki_Kilen_Woods_8.08.1_VM-flat.vmdk. Note that even for the “thinly provisioned” file imported using the second option, many native Linux utilities, e.g. ls, df, etc., may report the file usage to be 30 gigabytes. However, using the VMware-modified versions available for some of these utilities, e.g. vdf, will properly report the correct disk utilization.

Register and complete configuration of the virtual machine using the VMware Virtual Infrastructure Client

Using the VMware Virtual Infrastructure Client application, either connect directly to the ESX host or to the VirtualCenter server that manages the ESX host, using an account with permissions to create and modify virtual machines.

With the ESX host selected in the Virtual Infrastructure Client hierarchy, go to the Configuration tab and select the Storage (SCSI, SAN, and NFS) section. Right-click the VMFS3 volume containing the virtual machine files and choose Browse Datastore…

Within the Datastore Browser, navigate to the directory folder containing the virtual machine files (/deki), right-click the virtual machine configuration file (in this case, Deki_Wiki_Kilen_Woods_8.08.1_VM.vmx), and choose Add to Inventory.

You can now exit the Datastore Browser.

Complete the ESX configuration

The new virtual machine named “Deki Wiki Kilen Woods 8.08.1 VM” should appear in the inventory of the ESX host within the Virtual Infrastructure Client. Edit the settings of this new virtual machine.

If desired, increase the allocated memory from the default size of 256 megabytes.

Remove the network adapter, as the configuration options specified in the original Deki_Wiki_Kilen_Woods_8.08.1_VM.vmx configuration file are not compatible with ESX Server. Create a new network adapter according to your own network configuration.

Save the settings.


The virtual machine can now be powered on and standard configuration of MindTouch Deki Wiki can be
completed. The files originally copied to the ext3 partition can now be deleted from that location.

# rm /tmp/Deki_Wiki_Kilen_Woods_8.08.1_VM.*

 

Finish the installation

Congratulations! MindTouch Deki is now installed and you should be able to connect to http://your_server/config/index.php to complete the configuration.

 

Powered by MindTouch Deki v.8.08.1a