Specify 6 Appliance Download and Installation

From iDigBio
Revision as of 14:10, 15 December 2016 by Kyuhojeong (talk | contribs)
Jump to navigation Jump to search

This page gives instructions for using the Specify 6 virtual appliance and demo database for Specify 6 workshops. This is a multi-part process which involves the installation of a virtual machine environment (VirtualBox or VMWare) in which the demo database will run, download of the Specify 6 demo database virtual appliance itself and then opening of the appliance in VirtualBox or VMWare. The appliance has all necessary components and workshop materials installed and ready for use.



Install Virtual Machine environment

First you need to install either VirtualBox (recommended - works for Mac PCX and Linux) or VMware player (recommended for Windows 8 users)


VirtualBox

Follow the below link for Virtualbox installation. Choose the platform of your host machine (PC, Mac or Linux) under VirtualBox Platform packages and install. Use all the default settings.

- https://www.virtualbox.org/wiki/Downloads

Installation instructions (from VirtualBox) can be found here - https://www.virtualbox.org/manual/ch01.html#intro-installing


VMWare Player

Follow the below link for downloading VMWare player.

- https://my.vmware.com/web/vmware/free#desktop_end_user_computing/vmware_workstation_player/12_0%7CPLAYER-1200%7Cproduct_downloads


Download the Specify appliance

Click the link below to download the appliance. The file size is about 2GB, so it may take some time to complete the download depending on your connection speed.

For Virtualbox

- http://s.idigbio.org/idigbio-appliances/Specify_Appliance_VirtualBox_20151008.zip

For VMware

- http://s.idigbio.org/idigbio-appliances/Specify_Appliance_VMware_20151008.zip
- http://s.idigbio.org/idigbio-appliances/Specify_Appliance_VMware_20161215.zip

Open the appliance

For VirtualBox:

Unzip (Extract) the file downloaded in the previous step, place the resulting directory somewhere on your machine (e.g. your Desktop) and double click the specify.vbox file in that directory to run the appliance. NOTE: If you are on a windows machine, DO NOT use the native unzip application in Windows. Use some other unzipping program or download 7-zip free from here: http://www.7-zip.org/

Specify virtualbox v3.0 00.png


If double-clicking the vbox file does not work, notes on creating your first virtual machine can be found here - https://www.virtualbox.org/manual/ch01.html#gui-createvm. Under step 2 you will need to select Linux as your operating system. For all other options the default settings can be selected.

Once Virtual Box starts up you can open the appliance by double clicking the appliance in the left hand menu or clicking the green "Start" arrow at the top of the Virtual Box window.


VirtualBox.png


For VMWare Player:


Unzip (Extract) the file downloaded in the previous step, place the resulting directory somewhere on your machine (e.g. your Desktop) and double click the Specify Appliance file in that directory to run the appliance. NOTE: If you are on a windows machine, DO NOT use the native unzip application in Windows. Use some other unzipping program or download 7-zip free from here: http://www.7-zip.org/


VMWare Specify appliance file.PNG


If double-clicking the file doesn't work then open up VMWare Player, select "Open a Virtual Machine" and navigate to the Specify Appliance file in the directory you downloaded and unzipped.


VMWare player opening screen.PNG


Using Specify

After several minutes, the appliance completes booting up. Then run Specify from the desktop by clicking the Specify_64 icon. Note: this is an Ubuntu installation as this is the only license free operating system we can distribute. We will go through the basics of using Ubuntu (as much as we need for the workshop) on the first day. You may be prompted to install Ubuntu updates. These are not necessary for the workshop and as such can be ignored for now. If you are going to be using this appliance long term however, you may want to keep the operating system up to date.

The username and password for the demo database are demouser/demouser. The machine username and password (should it shut down or sleep) are specify/specify.

If a new version of Specify has been released, you may need to update the version of Specify being used. If a schema change has been performed then you will need the IT (admin username and password to update the database. The IT (admin) username and password is root/root.


Specify virtualbox v3.1 02.png

Exit Specify

Click File > Exit

When exiting specify you may be prompted with a message about backing up the database, you can either simply click the "x" button at the left top corner of the window or "Skip Backup".

Image12.png

Close Ubuntu

In the top right, under the Wheel icon > click Shut Down

Resizing or scaling screen size

- The screen resolution can be easily adjusted by dragging the right-bottom corner.
- If you use Mac retina display, you would want to scale the screen itself. Then select "View" -> "Switch to scaled mode" at the Top menu.