User manual / Centrum

Centrum

The image library on your appliance: what you have, where it came from, and what it is.

On this page
  1. The library
    1. Find images
    2. The list view
  2. Image details
  3. What ONEP knows about an image
    1. Set the class and type yourself
    2. Source marks
  4. Bring your own image
    1. Windows evaluation media
    2. Cisco images
  5. Images built by the Content Hub
  6. Remove an image

Centrum is where images live. Open it from Centrum in the sidebar. The page has two tabs: Discover, where you download new images from their vendors (see Discover), and My Centrum, the library of images already on your appliance. Discover is not a separate item in the sidebar; you always reach it through the Centrum page.

Centrum is about images; the Content Hub is about whole environments. Devices on the canvas, Content Hub builds and imports all draw on the same library. The first time you open Centrum it opens on My Centrum if the library already has images and on Discover if it is empty. After that it opens on the tab you used last, and it remembers your view, page size and search in your browser.

The two buttons at the top right work on both tabs. Refresh reloads the list. Register image adds an image you bring yourself (see Bring your own image).

The library#

The My Centrum tab opens with a strip of counters. They always describe the whole library, whatever filter is active:

  • Images, Size (an alias card shares its base disk and is counted once), Vendors and Verified (images ONEP recognized). A Community counter appears when the library holds community images.
  • Four counts by kind: Virtual machines, Cisco IOS, Classic Cisco and Containers. Select one to filter the list to that kind; select it again to clear the filter.
  • A storage bar for each disk that holds images, with the percentage used and the space free. With two bars they are labeled System and Centrum.

Find images#

  • Search images matches the name, vendor, type, class, version and kind (virtual machine, container, and so on).
  • All vendors and All types are filter menus. The vendor menu shows how many images each vendor has.
  • The two buttons at the right of the toolbar switch between Tiles and List. Tiles show each image's name, vendor, type, version and the number of environments that use it. In the tile view, View 20 / 50 / 100 / All sets the page size and Prev and Next move between pages.
  • If nothing matches, the list says No images match your search with Clear filters. An empty library offers Register image and Discover.

The list view#

The list is a table with these columns: Vendor, Product, Version, Type, Class, Size, Source, Verified, Used by and Added. Three more can be turned on: Image name, Disk and Runtime. A product that has an alias card is marked Alias. When two images would show the same name, vendor and version, a build month or size is added in brackets so you can tell them apart.

  • Sort. Select a column heading. Hold Shift to add a second sort column.
  • Column menu. The arrow on a heading opens Sort ascending, Sort descending, Clear sort, a Filter checklist for Vendor, Type, Class, Source, Verified and Used by (with Select all and Clear), Auto-size column, Auto-size all columns, Hide column, Move left and Move right.
  • Columns (the button in the toolbar) shows or hides columns and has Reset to default. Drag a heading edge to resize a column and drag a heading to reorder it. When the window is narrow, ONEP hides the least important columns for you and brings them back when there is room.
  • Group groups the list by Vendor, Type, Class or Source. Grouping turns paging off.
  • An active column filter appears as a line above the list, for example Type: Router, Switch, with an × to clear it and Clear all.
  • Select rows with the check boxes. A bar then replaces the toolbar with Register to ONEP and Remove from Centrum for the whole selection, and Select all N once a full page is selected.
  • The footer shows the range of images, the selection and its total size, View for the page size, and Prev, Next and a page box.
  • Keyboard. Arrow keys move through rows, Enter opens details, Space selects, Ctrl or Cmd with C copies the image name, and Esc clears the selection and then closes the details.
  • Row menu (the three dots on a row): Open details, Edit hardware, Edit type…, Copy name, Register to ONEP (only where it applies) and Remove from Centrum.

Image details#

Select a tile or a row to open the details panel on the right. Close details or Esc closes it. The panel has three groups, one open at a time:

  • Identity: Vendor, Product, Class, Device type, Version, File, Source, Added, Used by and Fingerprint (the start of the image's SHA-256 hash). Edit changes Vendor, Class and Device type; see Set the class and type yourself.
  • Hardware: vCPU, Memory, NICs, Console, Disk controller, Disk type, the disk file, any extra disks, Runtime and Size. Edit changes the Name, vCPU, Memory (MB), NICs, Console (VNC, Telnet, Serial or SPICE) and Disk controller. Save asks Save changes? before it applies them. These are the defaults a new device made from this image starts with.
  • Provenance: Sealed, Recognition, License and, where they apply, an end-of-life status and a known-issue note.

At the top of the panel an image that ships with a default login shows it. Remove from Centrum sits under the panel.

What ONEP knows about an image#

ONEP identifies images by fingerprint. It matches an image's hash against the fingerprints it knows first. When there is no match it falls back to the file name, and if the name does not identify the image either, the image is listed as Needs review and asks you to confirm it.

Every image is placed in one of ONEP's device classes: Network, Network Security, Cybersecurity, Servers, Endpoints, OT/ICS, Telco or SD-WAN. Each class has its own device types, such as Router and Switch in Network, Firewall and IPS / NDR in Network Security, and PLC and HMI / SCADA in OT/ICS. ONEP maintains the classification itself and updates it inside product updates. The version of the classification your appliance uses is shown in Settings › Diagnostics as Classification content.

The Verified column and the Provenance group state what ONEP can say about an image:

  • The ONEP mark means ONEP recognized the image.
  • Registered means an administrator confirmed the image themselves. ONEP has not tested it.
  • Unsealed appears on a Windows server image that has not been prepared for production use, and Retired — do not deploy on an image that must not be used. Known issue shows the note ONEP holds for the image.
  • A Windows desktop image carries no seal mark, like a Linux desktop.

Set the class and type yourself#

If ONEP's classification does not fit how you use an image, change it in the details panel. Choose Edit… on the row menu, or Edit in the Identity group:

  • Class picks one of the classes, for example Network, Network Security or Servers.
  • Device type picks the type. Choosing a class narrows the list to that class's types, and clears a type that no longer belongs to it. Save is off until a type is chosen.
  • Vendor is a text field.

A class or type you choose by hand locks the image's label, so ONEP's own classification updates do not overwrite it. The panel then shows Set by hand. Automatic classification will not change it. To hand the image back to ONEP, choose Return to automatic; the label then follows ONEP's classification again.

Source marks#

The Source of an image says where its bytes came from, and only what ONEP can prove:

SourceMeans
VendorDownloaded through Discover, a Cisco IOS or Classic Cisco image, or a file whose hash matches the vendor's own
ONEPBuilt on your appliance by a Content Hub deploy
CommunityA file you registered whose hash matches a community-published list
No markNothing matched. ONEP does not guess a source from a file name

Bring your own image#

  1. Choose Register imageand select up to five files, 20 GB in total. The picker offers disk images (.qcow2, .vmdk, .img, .iso, .bin), OVA files and archives (.tar, .tar.gz, .tgz, .7z, .zip). OVA and archive bundles are unpacked for you. For a single file you can type a Display name.
  2. Watch the uploadEach file shows its progress and speed. Keep the window open; closing it cancels the files that are not finished. A file that already exists in Centrum is flagged Image already exists or Same name in Centrum, and an upload of a duplicate is refused. When the content matches an existing image you can instead add the name as an alias card (Add … as alias card), which adds a second name for the same disk with no extra space. An image that backs an alias card cannot be removed until the alias is removed.
  3. Check what ONEP foundValidation complete lists each file with a result: Recognized as followed by the vendor and product, Registered as, Registered - needs a look, or Could not register. ONEP fills in the vendor, type, version, sizing and console where it recognizes the file.
  4. Register to ONEP (optional)On an image that is not recognized, Register to ONEP asks you to confirm. By registering you confirm the image comes from a source you trust; ONEP records its fingerprint but does not check its contents, license or safety, and you remain responsible for it. After registering, an identical upload is recognized automatically, and the Verified column shows Registered. A Discover download never shows this offer, because ONEP already knows where it came from.

An image ONEP cannot identify is listed as Needs review. Open it and fill in vendor, version and device type, then choose Confirm identity. ONEP remembers the answer for the next upload. Confirming and registering are done by an administrator or an instructor. A device can start from an image only after the image is ready in Centrum.

Windows evaluation media#

Microsoft's evaluation media is time-limited and licensed for evaluation, test or demonstration. Centrum labels it in the License row and on the tile: Microsoft 180-day evaluation media — not for production, or Microsoft evaluation media — expired, practice only for a build whose evaluation has already ended. Bringing your own properly licensed Windows media (retail, OEM or volume license) avoids the question. If you use evaluation media, treat it as time-limited evaluation content. This is a statement of the facts, not legal advice.

Cisco images#

Cisco IOS and Classic Cisco images are bring-your-own-license. The images and the license are yours to bring: ONEP does not supply, sell or verify a license. You upload your own license file in Settings › Licensing on the Cisco IOL license card; one license file serves every Cisco device on the appliance. The native switch works without it. See Licensing.

Images built by the Content Hub#

When the Content Hub builds a card on your appliance, the result appears in the library as a ready image, with (ready) in its name and Source ONEP. A Content Hub wizard skips the operating system step when the image it needs is already ready. If you build the same card again, the older image is hidden from the pickers but not deleted: environments already using it keep working.

Remove an image#

Use Remove from Centrum under the details panel, on the row menu, or in the selection bar for several images. ONEP asks you to confirm. Removing deletes the image's record and its file from disk, so it is gone from Centrum everywhere. Images you got from Discover can be added again from there.

An image cannot be removed while an environment uses it, or while an alias card points to its disk. The message names the environments or alias cards; remove those first.

Something wrong or missing on this page? Write to hello@onep.io.