You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
<p>Step 1: Download Software<em> BitCurator Virtual Machine or Live CD: <ahref="https://github.com/BitCurator/bitcurator-distro/wiki/Releases">https://github.com/BitCurator/bitcurator-distro/wiki/Releases</a>
153
-
* Current release of VirtualBox: <ahref="https://www.virtualbox.org/wiki/Downloads">https://www.virtualbox.org/wiki/Downloads</a>
154
-
* The VirtualBox Extension Pack </em><em>must</em><em> be installed on the host for shared folder support, USB 2.0/3.0 support, and support for some NVMe SSDs. Once you’ve installed VirtualBox, use the link below the main download on VirtualBox download site to install the Extension Pack on your host.
155
-
Step 2: Unpack the BitCurator Virtual MachineThe BitCurator Virtual Machine is packaged as a tar archive and compressed with gzip. The file will look something like: </em><em>“BitCurator-X.X.X.tar.gz”</em>*</p>
<li>BitCurator Virtual Machine or Live CD: <ahref="https://github.com/BitCurator/bitcurator-distro/wiki/Releases">https://github.com/BitCurator/bitcurator-distro/wiki/Releases</a></li>
173
+
<li>Current release of VirtualBox: <ahref="https://www.virtualbox.org/wiki/Downloads">https://www.virtualbox.org/wiki/Downloads</a></li>
174
+
<li>The VirtualBox Extension Pack <strong>must</strong> be installed on the host for shared folder support, USB 2.0/3.0 support, and support for some NVMe SSDs. Once you’ve installed VirtualBox, use the link below the main download on VirtualBox download site to install the Extension Pack on your host.</li>
175
+
</ul>
176
+
<h4id="step-2-unpack-the-bitcurator-virtual-machine">Step 2: Unpack the BitCurator Virtual Machine</h4>
177
+
<p>The BitCurator Virtual Machine is packaged as a tar archive and compressed with gzip. The file will look something like: <strong>“BitCurator-X.X.X.tar.gz”</strong></p>
156
178
<p>On a Mac (OS X 10.10 or later) or Linux host machine, you can simply double-click on the file to unpack the contents.</p>
157
179
<p>On a Windows machine, you may need a 3rd party utility such as 7-zip: <ahref="https://www.7-zip.org/download.html">https://www.7-zip.org/download.html</a></p>
158
180
<p>When using 7-zip, you’ll need to unpack the .tar.gz file. Right click on the .tar.gz file and select “Extract here…” to extract the .tar file. Then right click on the .tar file and select “Extract here…” again. This will extract a directory containing the BitCurator virtual machine disk image (.vbox) and configuration (.vdi) files.</p>
<p>Copy this directory to a location of your choosing (inside the “VirtualBox VMs” directory in your home directory is a good place), and start up VirtualBox.</p>
165
187
<p>If you’ve never created or used a VM in VirtualBox before, you won’t have a “VirtualBox VMs” directory. Don’t worry – just remember where you extracted the BitCurator directory.</p>
166
-
<p>Step 3: Open Oracle VM VirtualBox ManagerOnce you’ve installed VirtualBox and the VirtualBox extension pack, start up VirtualBox. If you’ve never used VirtualBox before, your list of machines (on the left) will be blank.</p>
188
+
<h4id="step-3-open-oracle-vm-virtualbox-manager">Step 3: Open Oracle VM VirtualBox Manager</h4>
189
+
<p>Once you’ve installed VirtualBox and the VirtualBox extension pack, start up VirtualBox. If you’ve never used VirtualBox before, your list of machines (on the left) will be blank.</p>
167
190
<p>You may need to right-click on the VirtualBox icon and select “Run as Administrator”. Windows machines with certain administrative controls may prevent you from accessing USB devices (or lock out control of the mouse and keyboard) otherwise.</p>
168
191
<p><em>VirtualBox Manager in Windows:</em></p>
169
192
<p><em>VirtualBox Manager in macOS:</em></p>
170
-
<p>Step 4: Add a Virtual MachineFrom the menu bar, select the menu item “Machine -> Add…”</p>
193
+
<h4id="step-4-add-a-virtual-machine">Step 4: Add a Virtual Machine</h4>
194
+
<p>From the menu bar, select the menu item “Machine -> Add…”</p>
171
195
<p>Navigate to the folder containing .vbox file that you extracted.</p>
172
196
<p>Choose that file, and the Virtual Machine should appear in the list within the manager.</p>
173
197
<p><em>Adding a machine (VirtualBox in Windows):</em></p>
174
198
<p><em>Adding a machine (VirtualBox in macOS):</em></p>
175
-
<p>Step 5: Configure RAM and ProcessorsClick on the Settings icon, and select the system tab.</p>
199
+
<h4id="step-5-configure-ram-and-processors">Step 5: Configure RAM and Processors</h4>
200
+
<p>Click on the Settings icon, and select the system tab.</p>
176
201
<p><strong>We recommend a minimum of 4096 MB RAM and 2 processors assigned to the VM.</strong></p>
177
202
<p>You may wish to change the RAM and number of processors depending on the hardware that you’re running on. For best results, select the largest number in the “green” areas for each.</p>
178
203
<p>Two or more processors assigned for VirtualBox are need to support drag-and-drop functionality.</p>
179
204
<p><em>Configuring the VM (VirtualBox in Windows):</em></p>
180
205
<p><em>Configuring the VM (VirtualBox in macOS):</em></p>
181
-
<p>Step 6: Enable USB Device CaptureBitCurator depends on a VirtualBox device filter to capture USB devices. In macOS, you’ll find this filter under the USB tab of the “Ports” icon under “Settings”.</p>
206
+
<h4id="step-6-enable-usb-device-capture">Step 6: Enable USB Device Capture</h4>
207
+
<p>BitCurator depends on a VirtualBox device filter to capture USB devices. In macOS, you’ll find this filter under the USB tab of the “Ports” icon under “Settings”.</p>
182
208
<p>In Windows, you’ll find it in the “USB” tab in settings. You don’t need to do anything here, unless you don’t see an entry under “USB Device Filters”.</p>
183
209
<p><strong>If you don’t see an entry, select the USB 3.0 radio button, and then create a new filter by clicking on the blue icon to the right of the list.</strong></p>
184
210
<p>If you don’t need access to USB devices (for example, if you plan to do analysis of existing born-digital data but no disk imaging), you can delete this filter.</p>
185
211
<p><em>USB Filters (VirtualBox in Windows):</em></p>
186
212
<p><em>USB Filters (VirtualBox in macOS):</em></p>
187
-
<p>Step 7: Setup Shared FoldersIf you wish to move processed materials <strong>back to your host machine</strong> from the BitCurator VM, you can set up a shared folder that both the host and the VM can write to.</p>
<p>If you wish to move processed materials <strong>back to your host machine</strong> from the BitCurator VM, you can set up a shared folder that both the host and the VM can write to.</p>
188
215
<p>In the Shared Folders tab, click the folder with the green “plus” on it to choose a folder on your host machine to share.</p>
189
216
<p>Select “Automount” but not “Read Only”. When the machine is booted, the folder will appear in the “Shared Folders and Media” folder on the desktop in the VM.</p>
190
217
<p><em>Shared Folders (VirtualBox in Windows):</em></p>
191
218
<p><em>Shared Folders (VirtualBox in macOS):</em></p>
192
-
<p>Step 8: Starting the BitCurator Environment (VM)Click on the green “Start” arrow in the Oracle VM VirtualBox Manager screen to start the BitCurator environment.</p>
219
+
<h4id="step-8-starting-the-bitcurator-environment-vm">Step 8: Starting the BitCurator Environment (VM)</h4>
220
+
<p>Click on the green “Start” arrow in the Oracle VM VirtualBox Manager screen to start the BitCurator environment.</p>
193
221
<p>You will see a startup screen, and then the BitCurator environment will boot and automatically log in.</p>
194
222
<p>If you encounter a menu screen on boot, simply hit the Return key to continue.</p>
195
223
<p>If you see an error message mentioning virtualization extensions, or “Intel VT-x”, your host machine’s BIOS does not have the VT-x extensions enabled. You’ll need to reboot your computer, holding down “Del” (or “Esc”, or the “ThinkPad” button, depending on your machine). Once you’re in the BIOS, locate the correct menu entry and enable the “Intel Virtualization Extensions”.</p>
0 commit comments