Provided by: opennebula-tools_4.12.3+dfsg-3.1build1_all 
NAME
oneimage - manages OpenNebula images
SYNOPSIS
oneimage command [args] [options]
OPTIONS
-d, --datastore id|name Selects the datastore
--name name Name of the new image
--description description Description for the new Image
--type type Type of the new Image: OS, CDROM, DATABLOCK,
KERNEL, RAMDISK, CONTEXT
--persistent Tells if the image will be persistent
--prefix prefix Device prefix for the disk (eg. hd, sd, xvd or
vd)
--target target Device the disk will be attached to
--path path Path of the image file
--driver driver Driver to use image (raw, qcow2, tap:aio:...)
--disk_type disk_type Type of the image (BLOCK, CDROM, RBD or FILE)
--source source Source to be used. Useful for not file-based
images
--size size Size in MB. Used for DATABLOCK type or SOURCE
based images.
--fstype fstype Type of file system to be built. This can be any
value understood by mkfs unix command.
--dry Just print the template
-a, --append Append new attributes to the current template
-l, --list x,y,z Selects columns to display with list command
-d, --delay x Sets the delay in seconds for top command
-f, --filter x,y,z Filter data. An array is specified with
column=value pairs.
--csv Write table in csv format
-x, --xml Show the resource in xml format
-n, --numeric Do not translate user and group IDs
--describe Describe list columns
-v, --verbose Verbose mode
-h, --help Show this message
-V, --version Show version and copyright information
--user name User name used to connect to OpenNebula
--password password Password to authenticate with OpenNebula
--endpoint endpoint URL of OpenNebula xmlrpc frontend
COMMANDS
• create [file] Creates a new Image Examples:
- using a template description file:
oneimage create -d default centOS.tmpl
- new image "arch" using a path of type centOS:
oneimage create -d default --name arch --path /tmp/arch.img
- new persistent image, OS type and qcow2 format:
oneimage create -d 1 --name ubuntu --path /tmp/ubuntu.qcow2 \
--prefix sd --type OS --driver qcow2 \
--description "A OS plain installation"
- a datablock image of 400MB:
oneimage create -d 1 --name data --type DATABLOCK --size 400 \
--fstype ext2
valid options: datastore, name, description, type, persistent, prefix, target, path, driver, disk_type, source, size, fstype, dry
• clone imageid name Creates a new Image from an existing one valid options: datastore
• delete range|imageid_list Deletes the given Image
• persistent range|imageid_list Makes the given Image persistent. A persistent Image saves the changes
made to the contents after the VM instance is shutdown (or in real time if a shared FS is used).
Persistent Images can be used by only one VM instance at a time.
• nonpersistent range|imageid_list Makes the given Image non persistent. See ´oneimage persistent´
• update imageid [file] Update the template contents. If a path is not provided the editor will be
launched to modify the current content. valid options: append
• enable range|imageid_list Enables the given Image
• chtype range|imageid_list type Changes the Image´s type
• disable range|imageid_list Disables the given Image
• chgrp range|imageid_list groupid Changes the Image group
• chown range|imageid_list userid [groupid] Changes the Image owner and group
• chmod range|imageid_list octet Changes the Image permissions
• rename imageid name Renames the Image
• list [filterflag] Lists Images in the pool valid options: list, delay, filter, csv, xml, numeric,
describe
• show imageid Shows information for the given Image valid options: xml
• top [filterflag] Lists Images continuously valid options: list, delay, filter, csv, xml, numeric,
describe
ARGUMENT FORMATS
• file Path to a file
• range List of id´s in the form 1,8..15
• text String
• groupid OpenNebula GROUP name or id
• userid OpenNebula USER name or id
• imageid OpenNebula IMAGE name or id
• imageid_list Comma-separated list of OpenNebula IMAGE names or ids
• filterflag a, all all the known IMAGEs m, mine the IMAGE belonging to the user in ONE_AUTH g, group
´mine´ plus the IMAGE belonging to the groups the user is member of uid IMAGE of the user identified
by this uid user IMAGE of the user identified by the username
• type Image type: OS, CDROM, DATABLOCK, KERNEL, RAMDISK, CONTEXT
LICENSE
OpenNebula 4.12.3 Copyright 2002-2015, OpenNebula Project (OpenNebula.org), C12G Labs
Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in
compliance with the License. You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
March 2015 ONEIMAGE(1)