Beijing AGI Summer School USB Installation for Windows

From OpenCog



This page describes how to install VMWare Player for Windows and prepare a Ubuntu 12.04 virtual machine using the OpenCogLive.iso file provided on USB. This file is 64-bit, so both your hardware and Windows host OS will have to support this.


This page has the following prerequisites:

  • VMWare Player for Windows (available here)
  • The OpenCogLive.iso file, provided on USB.


Installing VMWare Player

Doubleclick the VMware-player-5.0.0-812388.exe (or similar) file you downloaded from VMWare to start the installation.

You should see the following start screen:

VMWare Installation Screen 1.png

Click Next to navigate through the installation screens.

  • Regarding updates: it is recommend to leave this box ticked.
  • Regarding usage statistics: feel free to make your own privacy choice.
  • Regarding shortcuts: leave at least one of the boxes ticked so you can start VMWare Player after installation.

Creating a Virtual Machine for Ubuntu

Start the VMWare Player using the shortcut on your Desktop or in your Start Menu. You should see the Main Screen of VMWare Player as shown below.

VMWare Player Startup Screen.png

VMWare Player may show you a dialox box regarding an upgrade to VMWare Workstation. For our purposes the VMWare Player is sufficient, so you can dismiss this dialox box by selecting 'Skip this version'.

VMWare Player Paid Upgrade Dialog.png

Next, click 'Create a New Virtual Machine' in the main screen of VMWare Player. Select the second option here, 'Installer disc image file (iso)' and browse to the location of the OpenCogLive.iso file that has been provided on USB and click 'Next' to continue.

You can now provide your personal information which will be used to create the first account in Ubuntu. Your username should be in lower case characters only.

The password you provide here will also be your root password. Make sure you remember it!

VMWare Player Personalize Linux.png

Next you need to specify a name for your Virtual Machine and where you would like to store it on disk. Some parts of OpenCog generate a lot of data, so you should choose a location with 20-40 GB of free disk space.

VMWare Installation Details.png

The next screen allows you to specify a maximum size for your Virtual Machine fileset. As mentioned before, aim for 40GB. The choice of single vs. multiple files is less important than it appears, you will end up with a folder full of files in both cases anyway.

VMWare Installation Disk Configuration.png

The final screen gives you an overview of your choices to make sure you are creating your VM the way you meant to. Don't worry about customizing yet, we'll do that in the next section.

Make sure the checkbox 'Power on this virtual machine after creation' is NOT CHECKED. We still have some tweaking to do in the next section.

VMWare Installation Final Confirmation.png

Click 'Finish' in the screen above and the system will take a moment to create your VM. After this you should be returned to the main VMWare Player screen with the VM you just created already selected.

VMWare Installation VM Creation Complete.png

Tweaking Virtual Machine settings

From the main screen of VMWare Player, select the VM you need to edit and click the button 'Edit virtual machne settings' at the bottom of the screen as shown in the image above.

The screen below shows the Network Adapter section of the configuration settings. In order to use a setup where you run OpenCog in the VM and Unity3D (the 3D game engine) in your main Windows environment, make sure you select 'Bridged' as shown below.

VMWare Configuration VM Settings Network.png

Depending on the amount of memory and processor cores / threads you have available you may want to adjust the values in the Memory and Processors sections as well. The free version of VMWare Player allows a maximum of 4 cores.

Moving and Building OpenCog

Because you used the OpenCogLive.iso file, you already have a recent version of the OpenCog source code. However, it's in the wrong place, so we have to move it.

Open a terminal window, and go to your desktop:

cd ~/Desktop

Just to be sure, check if the "OpenCog Source Code" folder is there.


Then we need to move it:

mv "OpenCog Source Code" ~/opencog

Now it's in your home directory, so let's go there:

cd ~/opencog

Let's also make sure git knows where to get new versions of the source code:

git remote add upstream

Make a build folder:

mkdir build

Go into it:

cd build

Run cmake:

cmake ..

And build it with make. You can change the 1 to another number if you assigned more cores to your virtual machine, but you don't want to make it higher than that!

make -j1

Building should take a while, but after that you can return to the original tutorial to set up embodiment. You can now continue here:

Beijing AGI Summer School Tutorial for Windows#Setting up Embodiment on the OpenCog side


Any questions?

Then please leave them here.