Anvil-manage-server-storage - Revision history

Digimer: /* Commands: */

2024-09-30T16:51:34Z

Commands:

← Older revision		Revision as of 16:51, 30 September 2024
Line 45:		Line 45:
	: The size can be in percent, ie: '50%' or '100%', a number in bytes, or a human-readable size. Human readable sizes must NOT have a space between the number and letter suffix.		: The size can be in percent, ie: '50%' or '100%', a number in bytes, or a human-readable size. Human readable sizes must NOT have a space between the number and letter suffix.
	: Also, base2 vs base10 notation! Ie: '1GiB' = 1,073,741,824 bytes', '1GB' = '1,000,000,000 bytes'. A single letter used to denote size will be interpreted as base2. ie: '1G' is the same as '1GiB'.		: Also, base2 vs base10 notation! Ie: '1GiB' = 1,073,741,824 bytes', '1GB' = '1,000,000,000 bytes'. A single letter used to denote size will be interpreted as base2. ie: '1G' is the same as '1GiB'.
			:;Note
			::Growing the first disk (volume 0) requires the server be off. If the server is running, the job to grow the storage will hold until the server is powered off.
	; '''--insert''' </path/to/file.iso>		; '''--insert''' </path/to/file.iso>
	: This inserts the optical disc (ISO) into the drive specified by '''--optical'''.		: This inserts the optical disc (ISO) into the drive specified by '''--optical'''.
			;--machine
			:This tells the program to show information in a machine-parsable format.
	; '''--optical''' <device>		; '''--optical''' <device>
	: This is the device, ie: 'sda', to insert the optical disc (ISO file) into or to eject a disc from.		: This is the device, ie: 'sda', to insert the optical disc (ISO file) into or to eject a disc from.

Digimer at 02:33, 16 August 2024

2024-08-16T02:33:49Z

← Older revision		Revision as of 02:33, 16 August 2024
Line 13:		Line 13:
	anvil-manage-server-storage - This tool is used to add a disk, grow an existing disk, change the ISO (optical disk) in a virtual optical drive, and change boot devices.		anvil-manage-server-storage - This tool is used to add a disk, grow an existing disk, change the ISO (optical disk) in a virtual optical drive, and change boot devices.

	When called without switches, the list of servers ~~than~~ can be worked on will be displayed.		When called without switches, the list of servers that can be worked on will be displayed.

	= OPTIONS =		= OPTIONS =
Line 52:		Line 52:
	: This is the server being worked on. If this switch is used alone, then the current state of the storage of the server is displayed, as well as the details of the Storage Groups the server is or can use.		: This is the server being worked on. If this switch is used alone, then the current state of the storage of the server is displayed, as well as the details of the Storage Groups the server is or can use.
	; '''--storage-group''' <name or uuid>		; '''--storage-group''' <name or uuid>
	: If ~~there are~~ two or more Storage Groups exist, and you're adding a disk, this allows you to specify which storage group to use for the new disk.		: If two or more Storage Groups exist, and you're adding a disk, this allows you to specify which storage group to use for the new disk.

	= AUTHOR =		= AUTHOR =

Digimer: /* Commands: */

2024-08-01T01:04:54Z

Commands:

← Older revision		Revision as of 01:04, 1 August 2024
Line 34:		Line 34:
	; '''--confirm'''		; '''--confirm'''
	: Using this prevents the prompts to confirm given actions. When using '''--job-uuid''', this is ignored as all commands are considered confirmed.		: Using this prevents the prompts to confirm given actions. When using '''--job-uuid''', this is ignored as all commands are considered confirmed.
	; '''--disk''' <device, ie: sda, vdb>		; '''--disk''' <device, ie&colon; sda, vdb>
	: This is the disk being worked on. For optical disks, it's the drive that an optical disc (ISO) is being inserted into or ejected from. For disks, it's the disk being added, grown or deleted.		: This is the disk being worked on. For optical disks, it's the drive that an optical disc (ISO) is being inserted into or ejected from. For disks, it's the disk being added, grown or deleted.
	: When not specified, if only one disk exists, it will be chosen automatically.		: When not specified, if only one disk exists, it will be chosen automatically.

Digimer: /* OPTIONS */

2024-08-01T01:04:02Z

OPTIONS

← Older revision		Revision as of 01:04, 1 August 2024
Line 17:		Line 17:
	= OPTIONS =		= OPTIONS =

	-?, -h, '''--help''' Show this man page.		;-?, -h, '''--help'''
			: Show this man page.
	; '''--log-secure'''		; '''--log-secure'''
	: When logging, record sensitive data, like passwords.		: When logging, record sensitive data, like passwords.
Line 26:		Line 26:
	== Commands: ==		== Commands: ==

	'''--add''' <size or percent> This is used to add a new disk to a server. Specifically, it adds a second volume to the replicated storage under the server, which appears as a second disk inside the server. Writes to this and existing disks are ordered during replication, including during short or long throw DR.		;'''--add''' <size or percent>
			: This is used to add a new disk to a server. Specifically, it adds a second volume to the replicated storage under the server, which appears as a second disk inside the server. Writes to this and existing disks are ordered during replication, including during short or long throw DR.
	; The size can be in percent, ie: '50%' or '100%', a number in bytes, or a human-readable size. Human readable sizes must NOT have a space between the number and letter suffix.		: The size can be in percent, ie: '50%' or '100%', a number in bytes, or a human-readable size. Human readable sizes must NOT have a space between the number and letter suffix.
	:		: Also, base2 vs base10 notation! Ie: '1GiB' = 1,073,741,824 bytes', '1GB' = '1,000,000,000 bytes'. A single letter used to denote size will be interpreted as base2. ie: '1G' is the same as '1GiB'.
	; Also, base2 vs base10 notation! Ie: '1GiB' = 1,073,741,824 bytes', '1GB' = '1,000,000,000 bytes'. A single letter used to denote size will be interpreted as base2. ie: '1G' is the same as '1GiB'.
	:
	; '''--anvil''' <name\|uuid>		; '''--anvil''' <name\|uuid>
	: This is the Anvil! node name or UUID to be used. If not specified, the Anvil! the command or job runs on will be used.		: This is the Anvil! node name or UUID to be used. If not specified, the Anvil! the command or job runs on will be used.
Line 38:		Line 36:
	; '''--disk''' <device, ie: sda, vdb>		; '''--disk''' <device, ie: sda, vdb>
	: This is the disk being worked on. For optical disks, it's the drive that an optical disc (ISO) is being inserted into or ejected from. For disks, it's the disk being added, grown or deleted.		: This is the disk being worked on. For optical disks, it's the drive that an optical disc (ISO) is being inserted into or ejected from. For disks, it's the disk being added, grown or deleted.
	; When not specified, if only one disk exists, it will be chosen automatically.		: When not specified, if only one disk exists, it will be chosen automatically.
	:
	; '''--eject'''		; '''--eject'''
	: This ejects the optical disc (ISO) in the drive specified by '''--optical'''.		: This ejects the optical disc (ISO) in the drive specified by '''--optical'''.
Line 46:		Line 43:
	; '''--grow''' <size or percent>		; '''--grow''' <size or percent>
	: This is used to grow an existing disk by the specified amount. The drive to grow is specified using '''--disk'''.		: This is used to grow an existing disk by the specified amount. The drive to grow is specified using '''--disk'''.
	; The size can be in percent, ie: '50%' or '100%', a number in bytes, or a human-readable size. Human readable sizes must NOT have a space between the number and letter suffix.		: The size can be in percent, ie: '50%' or '100%', a number in bytes, or a human-readable size. Human readable sizes must NOT have a space between the number and letter suffix.
	:		: Also, base2 vs base10 notation! Ie: '1GiB' = 1,073,741,824 bytes', '1GB' = '1,000,000,000 bytes'. A single letter used to denote size will be interpreted as base2. ie: '1G' is the same as '1GiB'.
	; Also, base2 vs base10 notation! Ie: '1GiB' = 1,073,741,824 bytes', '1GB' = '1,000,000,000 bytes'. A single letter used to denote size will be interpreted as base2. ie: '1G' is the same as '1GiB'.
	:
	; '''--insert''' </path/to/file.iso>		; '''--insert''' </path/to/file.iso>
	: This inserts the optical disc (ISO) into the drive specified by '''--optical'''.		: This inserts the optical disc (ISO) into the drive specified by '''--optical'''.
Line 57:		Line 52:
	: This is the server being worked on. If this switch is used alone, then the current state of the storage of the server is displayed, as well as the details of the Storage Groups the server is or can use.		: This is the server being worked on. If this switch is used alone, then the current state of the storage of the server is displayed, as well as the details of the Storage Groups the server is or can use.
	; '''--storage-group''' <name or uuid>		; '''--storage-group''' <name or uuid>
	: If there are two or more Storage Groups exist, and you're adding a disk, this allows you to specify which storage group to use for the new disk.		: If there are two or more Storage Groups exist, and you're adding a disk, this allows you to specify which storage group to use for the new disk.

	= AUTHOR =		= AUTHOR =

Digimer: /* DESCRIPTION */

2024-08-01T01:03:06Z

DESCRIPTION

← Older revision		Revision as of 01:03, 1 August 2024
Line 13:		Line 13:
	anvil-manage-server-storage - This tool is used to add a disk, grow an existing disk, change the ISO (optical disk) in a virtual optical drive, and change boot devices.		anvil-manage-server-storage - This tool is used to add a disk, grow an existing disk, change the ISO (optical disk) in a virtual optical drive, and change boot devices.

	; When called without switches, the list of servers than can be worked on will be displayed.		When called without switches, the list of servers than can be worked on will be displayed.
	:

	= OPTIONS =		= OPTIONS =

Digimer: Created page with "{{header}} = NAME = anvil-manage-server-storage - Tool used to manage the storage of a hosted server. = SYNOPSIS = '''anvil-manage-server-storage''' ''<command> ''[''options''] = DESCRIPTION = anvil-manage-server-storage - This tool is used to add a disk, grow an existing disk, change the ISO (optical disk) in a virtual optical drive, and change boot devices. ; When called without switches, the list of servers than can be worked on will be displayed. : = O..."

2024-07-31T20:30:38Z

Created page with "{{header}} = NAME = anvil-manage-server-storage - Tool used to manage the storage of a hosted server. = SYNOPSIS = '''anvil-manage-server-storage''' ''<command> ''[''options''] = DESCRIPTION = anvil-manage-server-storage - This tool is used to add a disk, grow an existing disk, change the ISO (optical disk) in a virtual optical drive, and change boot devices. ; When called without switches, the list of servers than can be worked on will be displayed. : = O..."

Páàjì titun

{{header}}

= NAME =

anvil-manage-server-storage - Tool used to manage the storage of a hosted server.

= SYNOPSIS =

'''anvil-manage-server-storage''' ''<command> ''[''options'']

= DESCRIPTION =

anvil-manage-server-storage - This tool is used to add a disk, grow an existing disk, change the ISO (optical disk) in a virtual optical drive, and change boot devices.

; When called without switches, the list of servers than can be worked on will be displayed.
:

= OPTIONS =

-?, -h, '''--help''' Show this man page.

; '''--log-secure'''
: When logging, record sensitive data, like passwords.
; -v, -vv, -vvv
: Set the log level to 1, 2 or 3 respectively. Be aware that level 3 generates a significant amount of log data.

== Commands: ==

'''--add''' <size or percent> This is used to add a new disk to a server. Specifically, it adds a second volume to the replicated storage under the server, which appears as a second disk inside the server. Writes to this and existing disks are ordered during replication, including during short or long throw DR.

; The size can be in percent, ie: '50%' or '100%', a number in bytes, or a human-readable size. Human readable sizes must NOT have a space between the number and letter suffix.
:
; Also, base2 vs base10 notation! Ie: '1GiB' = 1,073,741,824 bytes', '1GB' = '1,000,000,000 bytes'. A single letter used to denote size will be interpreted as base2. ie: '1G' is the same as '1GiB'.
:
; '''--anvil''' <name|uuid>
: This is the Anvil! node name or UUID to be used. If not specified, the Anvil! the command or job runs on will be used.
; '''--confirm'''
: Using this prevents the prompts to confirm given actions. When using '''--job-uuid''', this is ignored as all commands are considered confirmed.
; '''--disk''' <device, ie: sda, vdb>
: This is the disk being worked on. For optical disks, it's the drive that an optical disc (ISO) is being inserted into or ejected from. For disks, it's the disk being added, grown or deleted.
; When not specified, if only one disk exists, it will be chosen automatically.
:
; '''--eject'''
: This ejects the optical disc (ISO) in the drive specified by '''--optical'''.
; '''--job-uuid'''
: This is the jobs -> job_uuid to execute. Generally this is only used by other programs.
; '''--grow''' <size or percent>
: This is used to grow an existing disk by the specified amount. The drive to grow is specified using '''--disk'''.
; The size can be in percent, ie: '50%' or '100%', a number in bytes, or a human-readable size. Human readable sizes must NOT have a space between the number and letter suffix.
:
; Also, base2 vs base10 notation! Ie: '1GiB' = 1,073,741,824 bytes', '1GB' = '1,000,000,000 bytes'. A single letter used to denote size will be interpreted as base2. ie: '1G' is the same as '1GiB'.
:
; '''--insert''' </path/to/file.iso>
: This inserts the optical disc (ISO) into the drive specified by '''--optical'''.
; '''--optical''' <device>
: This is the device, ie: 'sda', to insert the optical disc (ISO file) into or to eject a disc from.
; '''--server''' <name or uuid>
: This is the server being worked on. If this switch is used alone, then the current state of the storage of the server is displayed, as well as the details of the Storage Groups the server is or can use.
; '''--storage-group''' <name or uuid>
: If there are two or more Storage Groups exist, and you're adding a disk, this allows you to specify which storage group to use for the new disk.

= AUTHOR =

Written by Madison Kelly, Alteeve staff and the Anvil! project contributors.

= REPORTING BUGS =

Report bugs to users@clusterlabs.org

{{footer}}