Latest revision as of 02:33, 16 August 2024

Alteeve Wiki :: Anvil-manage-server-storage

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 that 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 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

Any questions, feedback, advice, complaints or meanderings are welcome.
`Alteeve's Niche!`	`Enterprise Support: Alteeve Support`	`Community Support`
© Alteeve's Niche! Inc. 1997-2024		Anvil! "Intelligent Availability®" Platform
`legal stuff: All info is provided "As-Is". Do not use anything here unless you are willing and able to take responsibility for your own actions.`

@@ 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.
-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 =
--?, -h, '''--help''' Show this man page.
+;-?, -h, '''--help'''
+: Show this man page.
 ; '''--log-secure'''
 : When logging, record sensitive data, like passwords.
@@ Line 26: / Line 26: @@
 == Commands: ==
-'''--add''' &lt;size or percent&gt; 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''' &lt;size or percent&gt;
+: 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''' &lt;name|uuid&gt;
 : 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''' &lt;device, ie: sda, vdb&gt;
+; '''--disk''' &lt;device, ie&colon; sda, vdb&gt;
 : 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'''
 : This ejects the optical disc (ISO) in the drive specified by '''--optical'''.
@@ Line 46: / Line 43: @@
 ; '''--grow''' &lt;size or percent&gt;
 : 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''' &lt;/path/to/file.iso&gt;
 : 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.
 ; '''--storage-group''' &lt;name or uuid&gt;
-: 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 =

Anvil-manage-server-storage: Difference between revisions