onevntemplate(1)

ONEVNTEMPLATE(1) onevntemplate(1) -- manages Virtual Network Templates ONEVNTEMPLATE(1)

NAME

onevntemplate - manages Virtual Network Templates

WARNING: Nokogiri was built against libxslt version 1.1.39, but has dynamically loaded 1.1.43 ## SYNOPSIS

onevntemplate command [args] [options]

OPTIONS


--adjust x,y,z Adjust size to not truncate selected columns
--admin lock admin actions
--all lock all actions
-a, --append Append new attributes to the current template
--as_gid gid The Group ID to instantiate the VM
--as_uid uid The User ID to instantiate the VM
--csv Write table in csv format
--csv-del del Set delimiter for csv output
-d, --delay x Sets the delay in seconds for top command
--describe Describe list columns
--dry Just print the template
--endpoint endpoint URL of OpenNebula xmlrpc frontend
--expand [x=prop,y=prop] Expands the columns size to fill the terminal.
For example: $onevm list --expand
name=0.4,group=0.6 will expand name 40% and
group 60%. $onevm list --expand name,group will
expand name and group based on its size.$onevm
list --expand will expand all columns.
--extended Process the template and included extended
information
-f, --filter x,y,z Filter data. An array is specified with
column=value pairs. Valid operators
=,!=,<,<=,>,>=,~ e.g. NAME=test (match name with
test) NAME~test (match every NAME containing the
substring ´test´)
--gateway ip IP of the gateway
-h, --help Show this message
-i, --ip ip First IP address in . notation
-6, --ip6 ip6 First IPv6 address, in CIDR notation e.g.
2001::1/48
-g, --ip6_global ip6_pref IP6 global prefix
-u, --ip6_ula ip6_pref IP6 ula prefix
-j, --json Show the resource in JSON format
-l, --list x,y,z Selects columns to display with list command
-c, --listconf conf Selects a predefined column list
-m, --mac mac First MAC address in : notation
--manage lock manage actions
-m, --multiple x Instance multiple VNs
--name name Name of the new VN TEMPLATE. When instantiating
multiple VNs you can use the "%i" wildcard to
produce different names such as vm-0, vm-1...
--netmask mask Netmask in dot notation
--no-expand Disable expand
--no-header Hides the header of the table
--no-pager Disable pagination
-n, --numeric Do not translate user and group IDs
--operator operator Logical operator used on filters: AND, OR.
Default: AND.
--password password Password to authenticate with OpenNebula
--prefix prefix Prefix to autogenerate name, e.g: 001, 01
-s, --size size Number of addresses
--use lock use actions
--user name User name used to connect to OpenNebula
-v, --verbose Verbose mode
-V, --version Show version and copyright information
--vlanid id VLAN ID assigned
--vn_mad mad Use this driver for the network
-x, --xml Show the resource in xml format
-y, --yaml Show the resource in YAML format

COMMANDS

chgrp range|templateid_list groupid Changes the VN Template group
chmod range|templateid_list octet Changes the VN Template permissions
chown range|templateid_list userid [groupid] Changes the VN Template owner and group
clone templateid name Creates a new VN Template from an existing one
create [file] Creates a new Virtual Network Template from the given description
Examples: - using a Virtual Network Template description file:

onevntemplate create vn_description.tmpl
- using a Virtual Network Template description file via stdin:
cat $vn_template | onevntemplate create valid options: dry

delete range|templateid_list Deletes the given VN Template
instantiate templateid [file] Creates a new VN instance from the given VN Template. This VN can be managed with the ´onevnet´ command.
The source Template can be modified adding or replacing attributes with the optional file argument, or with the options. valid options: as_gid, as_uid, extended, gateway, ip, ip6, ip6_global, ip6_ula, mac, multiple, name, netmask, prefix, size, vlanid, vn_mad
list [filterflag] Lists VN Templates in the pool. The default columns and their layout can be configured in onevntemplate.yaml valid options: adjust, csv, csv_del, delay, describe, expand, filter, json, list, listconf, no_expand, no_header, no_pager, numeric, operator, size, xml, yaml
lock range|templateid_list Locks a VN Template to prevent certain actions defined by different levels. The show action will never be locked. Valid states are: All. Levels: [Use]: locks Admin, Manage and Use actions. [Manage]: locks Manage and Use actions. [Admin]: locks only Admin actions. valid options: admin, all, manage, use
rename templateid name Renames the VN Template
show templateid Shows information for the given VN Template valid options: extended, json, xml, yaml
top [filterflag] Lists Templates continuously valid options: adjust, csv, csv_del, delay, describe, expand, filter, json, list, listconf, no_expand, no_header, no_pager, numeric, operator, size, xml, yaml
unlock range|templateid_list Unlocks a VN Template. Valid states are: All.
update templateid [file] Update the VN template contents. If a path is not provided the editor will be launched to modify the current content. valid options: append

ARGUMENT FORMATS

file Path to a file
filterflag a, all all the known VNTEMPLATEs m, mine the VNTEMPLATE belonging to the user in ONE_AUTH g, group ´mine´ plus the VNTEMPLATE belonging to the groups the user is member of G, primary group the VNTEMPLATE owned the user´s primary group uid VNTEMPLATE of the user identified by this uid user VNTEMPLATE of the user identified by the username
groupid OpenNebula GROUP name or id
range List of id´s in the form 1,8..15
templateid OpenNebula VNTEMPLATE name or id
templateid_list Comma-separated list of OpenNebula VNTEMPLATE names or ids
text String
userid OpenNebula USER name or id

VERSION

OpenNebula 6.10.0.1 Copyright 2002-2024, OpenNebula Project, OpenNebula Systems

March 2026