Deprecated. This material represents early efforts and may be of interest to historians. It doe not describe current VIVO efforts.

Deprecated. This material represents early efforts and may be of interest to historians. It doe not describe current VIVO efforts.

The VirtualBox appliances for VIVO v1.3 and v1.3.1 use Debian 6.0.1 and come with Harvester 1.2, but they are both deprecated in favor of the VIVO 1.4.1 virtual appliance.

The VirtualBox appliance for VIVO v1.4.1 uses Debian 6.0.1 and comes with Harvester 1.3.

Login Information

The VIVO virtual machine Linux root user is vitro. The password is vitro123.

The default administrator of the VIVO web site is vivo_root@localhost. The default password is "rootPassword" (was vitro123), and you'll have to pick a new password the first time you log into VIVO.

Browse from host machine

Tomcat runs on port 8080. You will need to forward host port 8080 to guest port 8080. To browse from the host machine, after installing the machine, setup port forwarding by referencing the following guide:

http://www.rustyrazorblade.com/2010/12/virtualbox-4-nat-port-forwarding-gui/

Connecting to your local VIVO

You may find you are not able to browse a local VIVO running in the virtual appliance. First, verify the network devices by running "sudo ifconfig -a" in the console, using the correct root password. The output should look like the following:

eth6 Link encap:Ethernet HWaddr 08:00:27:bd:c0:90
inet addr:10.0.2.15 Bcast:10.0.2.255 Mask:255.255.255.0
inet6 addr: fe80::a00:27ff:febd:c090/64 Scope:Link
UP BROADCAST RUNNING MULTICAST MTU:1500 Metric:1
RX packets:85 errors:0 dropped:0 overruns:0 frame:0
TX packets:78 errors:0 dropped:0 overruns:0 carrier:0
collisions:0 txqueuelen:1000
RX bytes:9433 (9.2 KiB) TX bytes:11472 (11.2 KiB)
Interrupt:10 Base address:0xd020

lo Link encap:Local Loopback
inet addr:127.0.0.1 Mask:255.0.0.0
inet6 addr: ::1/128 Scope:Host
UP LOOPBACK RUNNING MTU:16436 Metric:1
RX packets:54506 errors:0 dropped:0 overruns:0 frame:0
TX packets:54506 errors:0 dropped:0 overruns:0 carrier:0
collisions:0 txqueuelen:0
RX bytes:45526023 (43.4 MiB) TX bytes:45526023 (43.4 MiB)

Verify that the non-loopback device name (eth6 in the above example) matches the device in the last two lines of /etc/network/interfaces:

allow-hotplug eth6
iface eth6 inet dhcp

Then, you should be able to connect to your local VIVO at http://127.0.1.1:8080/vivo.

ssh into Appliance

The 1.3 appliance has an ssh server installed. In order to use it, you will have to configure VirtualBox to map a port on the host system to the ssh port (port 22) on the guest.

Then you can ssh into the appliance using the following command:

ssh -l vitro -p 2222 localhost

Enter vitro123 at the password prompt and you're in.

Secure file copy

From the host computer, you can copy files to the virtual appliance as follows:

scp -P 2222 <filename> vitro@localhost:<Destination>

Conflicts with a local VIVO Installation

If you have a local VIVO running on port 8080, just change the HostPort for apache in the above commands to something else, like 8081. Keep GuestPort 8080. Then you can run something like

http://localhost:8081/vivo

, to connect to your virtual appliance's VIVO installation running on (virtual) port 8080, while

http://localhost:8080/vivo

will connect to your local VIVO installation.

Log files

The log files catalina.out and vivo.all.log are not in the same folder (as is the case with some VIVO installations). Their locations are:

/var/log/tomcat6/catalina.out
/usr/share/tomcat6/logs/vivo.all.log