C&I Wiki Portal/OCP Ready

From OpenCompute
Revision as of 18:39, 8 April 2015 by Jlane (talk | contribs) (→‎Build your own)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to navigation Jump to search

OCP Ready Test Suite Packages[edit]

OCP Ready Test Suite is a different, more generalized test to ensure your hardware works and could be ready for full OCP Certification.


Installing is pretty easy. You will need a couple things to get started:

  • A SUT (Server Under Test). This is the system you are going to be testing.
  • A second machine on the same LAN segment running iperf in server mode

The OCP Ready packages are built for Ubuntu 14.04, 14.10 and 15.04. They are based on the new OCP Certification Suite tool which is in turn based on the new Checkbox-NG tool from Canonical.

To install:

  • Install Ubuntu 14.04, 14.10 or 15.04 to the SUT
  • Once Installation is complete and the SUT is rebooted, log in as the non-privileged user.
  • Once logged in:
$ sudo add-apt-repository ppa:opencompute-developers/ocp-certification-tools-ppa
$ sudo add-apt-repository ppa:hardware-certification/public
$ sudo apt-get update
$ sudo apt-get install opencompute-ready

And that will install all the necessary packages.

Configuring and running the Tool[edit]

Edit the file /etc/xdg/opencompute-testing.conf

Uncomment the following four lines:

#TEST_TARGET_FTP = your-ftp-server.example.com
#TEST_USER = anonymous
#TEST_PASS = password
#TEST_TARGET_IPERF =  your-iperf-server.example.com

Edit the TEST_TARGET_IPERF line replacing your-iperf-server.example.com with the IP address (Or FQDN if applicable) of your iperf server

Now simply issue the command:

$ opencompute-ready

and follow the prompts.

Obtaining the Source Code[edit]

The tools are fully open source under a GPL v3 license and freely available for download here:


OR via bazaar:

bzr branch lp:opencompute/opencompute-testing

OCP Ready Thumbdrive[edit]

NOTE: The Thumbdrive is being deprecated and likely will not be maintained. Eventually, this will be updated with instructions for creating your own

The files for the thumbdrive will be available here:


Note that this is a rather large download (> 1GB) and will take some time to pull all the files.

The README.thumbdrive file includes instructions on building and using the OCP Ready Thumbdrive.

There is also a /OCP directory that includes some OCP Ready related documentation.

Additionally, the OCP Ready Thumb Drive is based on old code and is not really considered reliable. It's a nice way to demo and explore, but not really something you should be using to pre-test your hardware.

Build your own[edit]

Building your own is not terribly difficult. The following will allow you to build your own USB Thumbdrive and assumes you are using Ubuntu to do the building. Note: This is not the same process we used to create the original USB images, that process is far more involved, but this will suffice for getting you a bootable device.

You will need the following:

  • A USB thumb drive that is at least 2GB in size
  • A Ubuntu Desktop or Server 14.04 LTS ISO image. (Later versions will also work)
    • We use the Desktop image to provide a more useful system. Please note that the actual test tools are console based so using Desktop or Server here is completely at your discretion.
  • A computer running Ubuntu (Desktop here, we need the GTK Tools for the following, there is likely a way to do this purely from console, this is just easier and faster to describe).

These next steps will create the bootable USB stick initially.

  1. Insert the USB thumb drive into your computer running Ubuntu Desktop.
  2. Open the Dash (Hit the Windows key or click on the top most icon on the Unity Panel).
  3. Type USB and when you see Startup Disk Creator click on that to launch the tool.
  4. Set the following items in USB Creator GTK (Also known as Startup Disk Creator).
    1. Under Source disc image, click Other and locate your Ubuntu ISO image and click Open. It should now appear in the upper display.
    2. In Disk to use, select the USB Thumb Drive you wish to build.
    3. Click Erase Disk to clear the disk of all data. You will need to provide your password to do this.
    4. Select Stored in reserved extra space and move the slider to at least 1GB, preferably more if your Thumb Drive has the space.
  5. Click Make startup disk.
    1. This will take a few moments. You will see a password prompt that you must use before the bootloader can be written to the thumb drive.
  6. When complete, exit the Startup Disk Creator.

Once the above steps are complete, you should now have a bootable Ubuntu USB Thumb drive with persistent storage of between 1 - 4 GB. Now you need to boot something from that and complete the next steps to have a bootable USB drive with OCP Ready on it.

  1. Insert the USB thumb drive into a machine that has internet access.
  2. Boot the machine and select the USB thumb drive from the boot menu if that machine doesn't automatically boot from USB.
    1. In the boot menu, you may see two entries, one for EFI and one for Legacy BIOS. Use the Legacy BIOS entry to load the bootloader.
  3. At the boot menu, select Try Ubuntu without installing. This is the default selection.
  4. After Ubuntu has booted, open a console by opening the Dash and typing "Terminal" into the search box and clicking on the Terminal icon.
  5. In the Terminal, perform the following steps:
    1. $ sudo add-apt-repository ppa:opencompute-developers/ocp-certification-tools-ppa
      1. Hit Enter to add the PPA when prompted.
    2. $ sudo add-apt-repository ppa:hardware-certification/public
      1. Again, hit Enter to add the PPA when prompted.
    3. $ sudo apt update
    4. $ sudo apt upgrade>/code>
    5. $ sudo apt install opencompute-ready
      1. Note this may fail because the Live USB environment lacks the Universe repository by default. If this does fail for you, the following will resolve dependency problems:
        1. $ sudo add-apt-repository universe
        2. $ sudo apt update
        3. $ sudo apt install opencompute-ready

At this point, you should now have a working USB thumb drive with opencompute-ready installed. To test this, do the following:

  1. Click the Gear icon in the upper right corner.
  2. Click Shut Down...
  3. Shut the system down.
  4. After it is powered off fully, power it back on.
    1. Again, you may need to enter the Boot Menu and force the system to boot from the USB stick if that is not in your default boot order.
  5. Select Try Ubuntu without installing from the boot menu, as before.