onehook
- manages OpenNebula hooks
onehook
command [args] [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
--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
--error Show only fail executions
-e, --execution exeid execution ID
--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 Show info extended (it only works with xml
output)
-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 test, te, tes..)
-h, --help Show this message
--hook-id id Hook ID to check logs
-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
--manage lock manage actions
--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
--since date First date to take logs
-s, --size x=size,y=size Change the size of selected columns. For example:
$ onevm list --size "name=20" will make column
name size 20.
--success Show only success executions
--until date Last date to take logs
--use lock use actions
--user name User name used to connect to OpenNebula
-v, --verbose Verbose mode
-V, --version Show version and copyright information
-x, --xml Show the resource in xml format
-y, --yaml Show the resource in YAML format
create file Creates a new Hook from the given description
Examples:
- using a Hook description file:
onehook create hook.tmpl
valid options: dry
delete range|hookid_list Deletes the given Hook
list [filterflag] Lists Hooks in the pool 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|hookid_list Locks a Hook with differents levels for lock any actions with this Hook, show and monitoring never will 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
log Get logs about hook executions
Examples:
~ $ onehook log --since 09/19/19 # returns all logs since that date
~ $ onehook log --error # returns all failing execs logs
~ $ onehook log --hook-id 0 # returns all logs from hook 0
valid options: error, hook_id, since, success, until, xml
rename hookid name Renames the Hook
retry hookid execid Retry a previous hook execution.
show hookid Shows information for the given Hook. An execution ID can be given to obtain detailed information of a given hook execution valid options: execution, extended, json, xml, yaml
top [filterflag] Lists Hooks 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|hookid_list Unlocks a Hook for unlock any actions with this Hook. Valid states are: All.
update hookid [file] Update the Hook contents. If a path is not provided the editor will be launched to modify the current content. valid options: append
file Path to a file
hookid OpenNebula HOOK name or id
hookid_list Comma-separated list of OpenNebula HOOK names or ids
range List of id's in the form 1,8..15
text String
OpenNebula 6.0.0.3 Copyright 2002-2021, OpenNebula Project, OpenNebula Systems