JABAWS Manual
+JABAWS Manual
Table of content
JABAWS Virtual Appliance
- When to use virtual appliance +
- How to install VMWare Player or VirtualBox
- VirtualBox appliance configuration
- VMware Player appliance configuration
- JABAWS Appliance details @@ -93,21 +94,31 @@ href="manual.html">Manual How To
JABAWS Virtual Appliance
When to use the virtual appliance
-The appliance best suits for individual users who want to use the JABA web services locally, without Internet connection, want to keep their data private and uses Windows as their main OS. The appliance is a self contained unit of software and as such may be an attractive option for Linux, UNIX or Mac users but they can always deploy a war distribution instead.
-To run the appliance you would need to have relatively powerful computer. The appliance comes pre configured to use 1 CPU and 512M of memory and the minimum amount of memory required is about 378M.
The appliance best suits users who would like to use the JABA web services locally, without an Internet connection, or want to keep their data private
+and uses Windows as their main OS. The appliance is a self contained unit of software and as such may be an attractive option for Linux, UNIX or Mac users but they can always deploy a war distribution instead.
+The appliance comes pre configured to use 1 CPU and 512M of memory and the minimum amount of memory required is about 378M.
How to install VMWare Player or VirtualBox
+Please see the VMware Player +and Oracle VirtualBox websites for up to date instructions and downloads.
+VirtualBox appliance configuration
VirtualBox can be used to run JABAWS services from Windows, Linux, Solaris or Mac host operating systems. Use the VitualBox "Import Appliance" option to import the JABAWS. Please bear in mind that to benefit from multiple CPU support under the VirtualBox software you need to enable hardware virtualization extensions, such as Intel Virtualization VT-x or AMD-V support in the BIOS of your computer. Unfortunately, we were unable to find a reliable way to do it on Mac, so some Macs running VirtualBox will be limited to one CPU only, irrespective of the number of CPUs of the host machine.
We found that, by default, virtualization extensions are enabled in VirtualBox irrespective of whether your computer supports them. You will get the VERR_VMX_MSR_LOCKED_OR_DISABLED exception if your computer does not support the extensions or their support is disabled. Just deselect the checkboxes shown on the screen shot below to solve the problem.
VirtualBox JABAWS VM configuration screen shot displaying virtualization settings.
VMware Player appliance configuration
-The free VMware Player can be used to run the JABAWS services from the Windows and Linux host operating systems, there is no support for Mac in time of writing. However, VMware Fusion, a commercial VMware product, offers virtual machine support for Mac computers too.
+The free VMware Player can be used to run the JABAWS services from the Windows and Linux host operating systems, there is no support for Mac at the time of writing (December 2010). +However, VMware Fusion, a commercial VMware product, offers virtual machine support for Mac computers too.
To run the JABAWS server on VMware player, unpack the JABAWS VM into one of the folders on your local hard drive. Open VMware Player, click "Open Virtual Machine" and point the Player to the location of the JABAWS, then choose the JABAWS.vmx file to open an appliance.
When you play the machine for the first time the Player might ask you whether "This virtual machine may have been moved or copied.", say that you have copied it. That is all.
+JABAWS Appliance details
By default, the JABAWS virtual appliance is configured with 512M of memory and 1 CPU, but you are free to change these settings. If you have more than one CPU or CPU core on your computer you can make them available for the JABAWS virtual machine by editing virtual machine settings. Please bear in mind that more CPU power will not make a single calculation go faster, but it will enable the VM to do calculations in parallel. Similarly, you can add more memory to the virtual machine. More memory lets your VM deal with larger tasks, e.g. work with large alignments.
The VMware Player screen shot below displays JABAWS VM CPU settings.
JABAWS appliance configuration:
VMware info
- Date of creation: 8 October 2010
@@ -149,6 +160,8 @@ To run the appliance you would need to have relatively powerful computer. The a
If you click on Advanced Menu, you will see the configuration console, similar to the one below.
If you need to configure a static IP address the configuration console will help you with this. Shutting down the VM is best from the configuration console as well.
+ +