documentation:software:ohdsi-in-a-box
Differences
This shows you the differences between two versions of the page.
| Both sides previous revision Previous revision Next revision | Previous 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 [2018/10/20 02:21] lee [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
Page Tools
