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)