V5:Installing ChipWhisperer/Using VBox Virtual Machine - Revision history

Adewar at 16:06, 13 May 2019

2019-05-13T16:06:39Z

Adewar at 15:59, 13 May 2019

2019-05-13T15:59:10Z

Adewar at 14:19, 8 May 2019

2019-05-08T14:19:56Z

Adewar: Created page with "If this is your first time using the ChipWhisperer toolchain, the easiest way to start is to use a virtual machine with everything already set up for you. # Install [https://w..."

2018-12-18T20:24:29Z

Created page with "If this is your first time using the ChipWhisperer toolchain, the easiest way to start is to use a virtual machine with everything already set up for you. # Install [https://w..."

New page

If this is your first time using the ChipWhisperer toolchain, the easiest way to start is to use a virtual machine with everything already set up for you.
# Install [https://www.virtualbox.org/wiki/Downloads VirtualBox]. This program is freely available on Windows, Mac, and Linux.
# Install the [https://download.virtualbox.org/virtualbox/5.2.22/Oracle_VM_VirtualBox_Extension_Pack-5.2.22.vbox-extpack VirtualBox Extension Pack]. This is necessary for the VM to interact with the ChipWhisperer hardware
# Download a ChipWhisperer virtual machine image release (not yet available) or build it yourself using Vagrant (not yet available).
# Unzip the VirtualBox image, go to ''Machine>Add'' in VirtualBox and select the VM that was unzipped
# Verify that the VM boots
Next, we'll need to setup the network for the VM. In VirtualBox:
# Go to ''Global Tools>Host Network Manager''
# If a Host-Only adapter exists, make sure ''Properties is selected''. If not, ''Create'' a new one
# Uncheck ''DHCP Server''
# Go to ''Adapter'' and change the IPv4 Address to 192.168.33.11 and the IPv4 Network Mask to 255.255.255.0
# Click Apply
# Go to ''Machine Tools'', select the VM that you added and go to ''Settings'' (your VM may be named differently)
# Go to ''Network>Adapter 2'' and make sure the Host-Only Adapter you modified is selected (if not select it)
# Run the VM.
You shouldn't need to login as Jupyter (which provides the interface) should start automatically. If you do want to login (say to update the ChipWhisperer software), the username and password are both vagrant.

You can now open ChipWhisperer 5.0 by opening Chrome or Firefox (Edge/Internet Explorer/Safari DO NOT work) and typing 192.168.33.10:8888 into your address bar.

@@ Line 8: / Line 8: @@
 # Verify that the VM boots
 Next, we'll need to update some passwords for the VM. Boot the virtual machine then:
-# Login (user: vagrant pass: vagrant). You will be asked to update your password. Do so.
+# Log in (user: vagrant pass: vagrant). You will be asked to update your password. Do so (make sure to record this password).
-# Setup a new password for Jupyter. This can be done by typing <code>jupyter notebook password</code>, then entering and verifying your new password. Note that Jupyter will not start until this is done.
+# Setup a new password for Jupyter. This can be done by typing <code>jupyter notebook password</code>, then entering and verifying your new password. Note that Jupyter will not start until this is done. This password will be needed to log into Jupyter, so make sure you record it as well.
 # Reboot the VM.
 # Once the VM is booted, you can connect to Jupyter via <code>localhost:8888</code> (Firefox/Chrome ONLY). You will be asked for the password you set via <code>jupyter notebook password</code>
-You shouldn't need to login again to run Jupyter (which provides the interface) as it should start automatically, but make sure you still record the password you set for the vagrant account, as you will need to login to update ChipWhisperer.
+You shouldn't need to log in to the VM again to run Jupyter (which provides the interface) as it should start automatically, but make sure you still record the password you set for the vagrant account, as you will need to log in to update ChipWhisperer.

@@ Line 1: / Line 1: @@
-If this is your first time using the ChipWhisperer toolchain, the easiest way to start is to use a virtual machine with everything already set up for you.
+If this is your first time using the ChipWhisperer toolchain, the easiest way to start is to use a virtual machine with everything already set up for you. Note that Linux users may find it easier to do a manual install.
-# Install [https://www.virtualbox.org/wiki/Downloads VirtualBox]. Note you currently must use Virtualbox 5, not 6 as there is an incompatibility between Virtualbox 6 and the current VM operating system. This program is freely available on Windows, Mac, and Linux.
-# Install the [https://download.virtualbox.org/virtualbox/5.2.22/Oracle_VM_VirtualBox_Extension_Pack-5.2.22.vbox-extpack VirtualBox Extension Pack]. This is necessary for the VM to interact with the ChipWhisperer hardware
+These instructions are for the newest version of CW5 (v5.0.1+) and will not work with CW5's initial alpha release (v5.0.0). Virtualbox 6 is assumed here, but these instructions should work for Virtualbox 5 as well, provided the correct extension pack is installed.
-# Download a ChipWhisperer virtual machine image release (not yet available) or build it yourself using Vagrant (not yet available).
+# Install [https://www.virtualbox.org/wiki/Downloads VirtualBox]. This program is freely available on Windows, Mac, and Linux.
 # Unzip the VirtualBox image, go to ''Machine>Add'' in VirtualBox and select the VM that was unzipped
 # Verify that the VM boots
-Next, we'll need to setup the network for the VM. In VirtualBox:
+Next, we'll need to update some passwords for the VM. Boot the virtual machine then:
-# Go to ''Global Tools>Host Network Manager''
+# Login (user: vagrant pass: vagrant). You will be asked to update your password. Do so.
-# If a Host-Only adapter exists, make sure ''Properties is selected''. If not, ''Create'' a new one
+# Setup a new password for Jupyter. This can be done by typing <code>jupyter notebook password</code>, then entering and verifying your new password. Note that Jupyter will not start until this is done.
-# Uncheck ''DHCP Server''
+# Reboot the VM.
-# Go to ''Adapter'' and change the IPv4 Address to 192.168.33.11 and the IPv4 Network Mask to 255.255.255.0
+# Once the VM is booted, you can connect to Jupyter via <code>localhost:8888</code> (Firefox/Chrome ONLY). You will be asked for the password you set via <code>jupyter notebook password</code>
-# Click Apply
-# Go to ''Machine Tools'', select the VM that you added and go to ''Settings'' (your VM may be named differently)
-# Go to ''Network>Adapter 2'' and make sure the Host-Only Adapter you modified is selected (if not select it)
-# Run the VM.
-You shouldn't need to login as Jupyter (which provides the interface) should start automatically. If you do want to login (say to update the ChipWhisperer software), the username and password are both vagrant.
-You can now open ChipWhisperer 5.0 by opening Chrome or Firefox (Edge/Internet Explorer/Safari DO NOT work) and typing 192.168.33.10:8888 into your address bar.
+You shouldn't need to login again to run Jupyter (which provides the interface) as it should start automatically, but make sure you still record the password you set for the vagrant account, as you will need to login to update ChipWhisperer.