User Tools

Site Tools


documentation:software:ohdsi-in-a-box

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Next revision
Previous revision
documentation:software:ohdsi-in-a-box [2016/09/30 12:42]
ericavoss created
documentation:software:ohdsi-in-a-box [2018/10/20 02:21]
lee [Troubleshooting Issues]
Line 1: Line 1:
-OHDSI-In-A-Box+====== ​OHDSI-In-A-Box ​====== 
 + 
 +OHDSI-In-A-Box is a virtual machine containing the full OHDSI Technology Stack as well as several of the OHDSI tools. It was constructed as a resource to supplement tutorials held during the 2016 OHDSI Symposium. It also functions as a learning aid and sandbox environment for those who want hands-on experience with OHDSI. 
 + 
 +//The OHDSI-In-A-Box virtual machine is intended for demonstration and educational purposes only. Use of OHDSI-In-A-Box beyond this scope is strictly prohibited. You are liable for any effect resulting from downloading or using this software. By downloading OHDSI-In-A-Box you agree to abide by these terms.// 
 + 
 +== Minimum System Requirements == 
 +  * 8GB RAM 
 +  * 45GB available disk space 
 +  * Oracle VM Virtual Box 
 + 
 +== Setup Procedure == 
 +  * Download and install the appropriate VirtualBox binaries [[https://​www.virtualbox.org/​wiki/​Downloads|link]] 
 +  * Download and unzip //​ohdsi-in-a-box.zip//​ [[https://​drive.google.com/​open?​id=0B8QSHCLE8g4JMDBiaWx0b1NKQ3M|link]] 
 +  * Unzip //​ohdsi-in-a-box.zip//​ to extract //​ohdsi-in-a-box.vdi//​ 
 +  * Create an Ubuntu virtual machine using //​ohdsi-in-a-box.vdi//​ 
 +      * Open Oracle VM VirtualBox Manager and click "​New” {{ :​documentation:​software:​ohdsi-in-a-box:​new.png?​nolink&​32 }} 
 +      * In the **Create Virtual Machine** dialog enter the following parameters:​ 
 +          * Name: ohdsi-in-a-box 
 +          * Type: Linux 
 +          * Version: Ubuntu (64-bit) 
 +          * Memory size: 2048 MB 
 +          * Hard Disk: Use an existing hard disk file (navigate to the unzipped file ohdsi-in-a-box.vdi) 
 +          * Click **Create** {{ :​documentation:​software:​ohdsi-in-a-box:​create-virtual-machine.png?​nolink&​200 }} 
 +      * A new entry //​ohdsi-in-a-box//​ will appear in VirtualBox Manager. Right-click on the entry and select the menu item **Settings**. 
 +{{ :​documentation:​software:​ohdsi-in-a-box:​settings.png?​nolink&​200 }} 
 +      * In the **Settings** dialog go to the **Storage** section and ensure that //​ohdsi-in-a-box.vdi//​ appears as a hard disk under Controller: IDE within the Storage Tree. (If it is under **SATA**, remove it and add it under **Controller:​ IDE**.) {{ :​documentation:​software:​ohdsi-in-a-box:​settings-storage.png?​nolink&​200 }} 
 +      * Click **OK** to close the Settings dialog. 
 +  * Double-click the entry //​ohdsi-in-a-box//​ in VirtualBox Manager. 
 +  * If prompted, select the default settings and allow it to boot up. 
 +  * Enter the following credentials:​ 
 +        * login: ohdsi 
 +        * password: ohdsi 
 +  * The ohdsi-in-a-box desktop should appear. {{ :​documentation:​software:​ohdsi-in-a-box:​desktop.png?​nolink&​200 }} 
 + 
 +==== Troubleshooting Issues ==== 
 + 
 +=== When creating the virtual machine only 32-bit options are shown === 
 + 
 +A 64-bit operating system is required. If you have a 64-bit operating system and still have this issue, virtualization may need to be enabled on your machine. (Google “Enable Virtualization on X” and replace X with the model of your computer.) 
 + 
documentation/software/ohdsi-in-a-box.txt · Last modified: 2018/10/20 02:21 by lee