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

Both sides previous revision Previous revision
Next revision
Previous revision
Last revision Both sides next revision
documentation:software:ohdsi-in-a-box [2016/10/05 15:56]
mvelez First draft of ohdsi-in-a-box page. (Need screenshots.)
documentation:software:ohdsi-in-a-box [2016/10/12 21:22]
mvelez Add section Troubleshooting Issues
Line 2: Line 2:
  
 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. 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 == == Minimum System Requirements ==
Line 11: Line 13:
   * Download and install the appropriate VirtualBox binaries [[https://​www.virtualbox.org/​wiki/​Downloads|link]]   * 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]]   * Download and unzip //​ohdsi-in-a-box.zip//​ [[https://​drive.google.com/​open?​id=0B8QSHCLE8g4JMDBiaWx0b1NKQ3M|link]]
-  * Unzip //​ohdsi-in-a-box.zip//​ to expose ​//​ohdsi-in-a-box.vdi//​+  * Unzip //​ohdsi-in-a-box.zip//​ to extract ​//​ohdsi-in-a-box.vdi//​
   * Create an Ubuntu virtual machine using //​ohdsi-in-a-box.vdi//​   * Create an Ubuntu virtual machine using //​ohdsi-in-a-box.vdi//​
-      * Open Oracle VM VirtualBox Manager +      * Open Oracle VM VirtualBox Manager ​and click "​New” ​{{ :​documentation:​software:​ohdsi-in-a-box:​new.png?​nolink&​32 }}
-      * Click "​New”+
       * In the **Create Virtual Machine** dialog enter the following parameters:       * In the **Create Virtual Machine** dialog enter the following parameters:
           * Name: ohdsi-in-a-box           * Name: ohdsi-in-a-box
Line 21: Line 22:
           * Memory size: 2048 MB           * Memory size: 2048 MB
           * Hard Disk: Use an existing hard disk file (navigate to the unzipped file ohdsi-in-a-box.vdi)           * Hard Disk: Use an existing hard disk file (navigate to the unzipped file ohdsi-in-a-box.vdi)
-          * Click **Create**+          * 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**.       * A new entry //​ohdsi-in-a-box//​ will appear in VirtualBox Manager. Right-click on the entry and select the menu item **Settings**.
-      ​* 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.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.       * Click **OK** to close the Settings dialog.
   * Double-click the entry //​ohdsi-in-a-box//​ in VirtualBox Manager.   * Double-click the entry //​ohdsi-in-a-box//​ in VirtualBox Manager.
   * If prompted, select the default settings and allow it to boot up.   * If prompted, select the default settings and allow it to boot up.
   * Enter the following credentials:​   * Enter the following credentials:​
-      ​* login: ohdsi +        ​* login: ohdsi 
-      * password: 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