9.11. remove

9.11.1. remove appliance

rocks remove appliance {name}

Remove an appliance definition from the system. This can be called with just the appliance or it can be further qualified by supplying the root XML node name and/or the graph XML file name.

arguments

name

The name of the appliance.

examples

# rocks remove appliance compute

Removes the compute appliance from the database.

9.11.2. remove appliance attr

rocks remove appliance attr {appliance} {attr} [attr=string]

Remove an attribute for an appliance.

arguments

appliance

One or more appliances

attr

The attribute name that should be removed.

parameters

[attr=string]

Can be used in place of the attr argument.

examples

# rocks remove appliance attr compute sge

Removes the attribute sge for compute appliances

# rocks remove appliance attr compute attr=sge

Same as above.

9.11.3. remove appliance route

rocks remove appliance route {appliance} {address} [address=string]

Remove a static route for an appliance type.

arguments

appliance

Appliance name. This argument is required.

address

The address of the static route to remove. This argument is required.

parameters

[address=string]

Can be used in place of the 'address' argument.

examples

# rocks remove appliance route compute 1.2.3.4

Remove the static route for the 'compute' appliance that has the network address '1.2.3.4'.

9.11.4. remove attr

rocks remove attr {attr} [attr=string]

Remove a global attribute.

arguments

attr

The attribute name that should be removed.

parameters

[attr=string]

Can be used in place of the attr argument.

examples

# rocks remove attr cpus

Removes the global attribute named 'cpus'.

# rocks remove attr attr=cpus

Same as above.

9.11.5. remove bootaction

rocks remove bootaction [action=string]

Remove a boot action specification from the system.

parameters

[action=string]

The label name for the boot action. You can see the boot action label names by executing: 'rocks list bootaction'.

examples

# rocks remove bootaction action=os

Remove the 'os' boot action from the system.

9.11.6. remove distribution

rocks remove distribution {distribution}

Remove a distribution specification from the database.

arguments

distribution

Distribution name.

examples

# rocks remove distribution rocks-optiputer

Removes the distribution named "rocks-optiputer" from the database.

9.11.7. remove firewall

rocks remove firewall [category=index] {rulename}

Remove a named firewall rule

arguments

[category=index]

[global,os,appliance,host]=index. Specify which version of rulename to remove os=linux, appliance=login, or host=compute-0-0. global, global=, and global=global all refer to the global category. cannot be wildcarded. Specifying just a rulename defaults to the global category

rulename

The particular rule to remove. Cannot be wildcarded

examples

# rocks remove firewall global ZZDRACONIAN

Remove the rule named ZZDRACONIAN from the global category

# rocks remove firewall appliance=compute MYRULE

Remove the rule named MYRULE from compute appliances

9.11.8. remove host

rocks remove host {host...}

Remove a host from the database. This command will remove all related database rows for each specified host.

arguments

host

List of hosts to remove from the database.

examples

# rocks remove host compute-0-0

Remove the compute-0-0 from the database.

9.11.9. remove host alias

rocks remove host alias {host} {name} [name=string]

Remove an alias for a host.

arguments

host

One hosts.

name

The alias name that should be removed.

parameters

[name=string]

Can be used in place of the name argument.

examples

# rocks remove host alias compute-0-0 c-0-0

Removes the alias c-0-0 for host compute-0-0.

# rocks remove host alias compute-0-0 name=c-0-0

Same as above.

9.11.10. remove host attr

rocks remove host attr {host} {attr} [attr=string]

Remove an attribute for a host.

arguments

host

One or more hosts

attr

The attribute name that should be removed.

parameters

[attr=string]

Can be used in place of the attr argument.

examples

# rocks remove host attr compute-0-0 cpus

Removes the attribute cpus for host compute-0-0.

# rocks remove host attr compute-0-0 attr=cpus

Same as above.

9.11.11. remove host boot

rocks remove host boot {host...}

Removes the boot configuration for a host

arguments

host

One or more named hosts.

examples

# rocks remove host boot compute-0-0

Removes the boot configuration for host compute-0-0.

# rocks remove host boot compute-0-0 compute-0-1

Removes the boot configuration for hosts compute-0-0 and compute-0-1.

9.11.12. remove host bootflags

rocks remove host bootflags {host...}

Remove the kernel boot flags for a list of hosts.

arguments

host

List of hosts to remove kernel boot flag definitions. If no hosts are listed, then the global definition is removed.

examples

# rocks remove host bootflags compute-0-0

Remove the kernel boot flags definition for compute-0-0.

9.11.13. remove host interface

rocks remove host interface {host} {iface} [iface=string]

Remove a network interface definition for a host.

arguments

host

One or more named hosts.

iface

Interface that should be removed. This may be a logical interface or the mac address of the interface.

parameters

[iface=string]

Can be used in place of the iface argument.

examples

# rocks remove host interface compute-0-0 eth1

Removes the interface eth1 on host compute-0-0.

# rocks remove host interface compute-0-0 compute-0-1 iface=eth1

Removes the interface eth1 on hosts compute-0-0 and compute-0-1.

9.11.14. remove host key

rocks remove host key {host} [id=string]

Remove a public key for a host.

arguments

host

A host name.

parameters

[id=string]

The ID of the key you wish to remove. To get the key id, execute: "rocks list host key"

9.11.15. remove host partition

rocks remove host partition {host...} [partition=string]

Remove a partition definitions from a host.

arguments

host

A list of one or more host names.

parameters

[partition=string]

A single partition to remove from this host. If no partition is specified, then all partitions from the host are removed.

examples

# rocks remove host partition compute-0-0

Remove all partitions from compute-0-0.

# rocks remove host partition compute-0-0 partition=/export

Remove only the /export partition from compute-0-0.

9.11.16. remove host roll

rocks remove host roll {host} {name} {version} {arch} [arch=string] [name=string] [os=string] [version=string]

Removes a roll assignment to a frontend appliance.

arguments

host

Host name of a frontend machine.

name

Name of the roll (e.g., 'base').

version

Version of the roll (e.g., '5.2').

arch

Architecture of the roll (e.g., 'x86_64').

parameters

[arch=string]

Same as 'arch' argument.

[name=string]

Same as 'name' argument.

[os=string]

The OS version. The default is 'linux'.

[version=string]

Same as 'version' argument.

examples

# rocks remove host roll frontend-0-0-0 base 5.2 x86_64

Removes the assignment of the roll with name/version/arch of 'base/5.2/x86_64' to frontend-0-0-0.

related commands

list host roll

set host roll

9.11.17. remove host route

rocks remove host route {host} [address=string]

Remove a static route for a host.

arguments

host

Name of a host machine. This argument is required.

parameters

[address=string]

The address of the static route to remove. If not address is specified all the static route relative to the given host will be deleted

examples

# rocks remove host route compute-0-0 address=1.2.3.4

Remove the static route for the host 'compute-0-0' that has the network address '1.2.3.4'.

# rocks remove host route compute-0-0

Remove all the static routes for the host 'compute-0-0'

9.11.18. remove host sec_attr

rocks remove host sec_attr {host} {attr}

Delete an host specific named attribute from secure attributes table

arguments

host

Host name

attr

The attribute you want to remove

9.11.19. remove network

rocks remove network {network...}

Remove network definition from the system. If there are still nodes defined in the database that are assigned to the network name you are trying to remove, the command will not remove the network definition and print a message saying it cannot remove the network.

arguments

network

One or more network names.

examples

# rocks remove network private

Remove network info for the network named 'private'.

9.11.20. remove os

rocks remove os {os}

Remove an OS definition from the system.

arguments

os

The OS type (e.g., "linux", "sunos").

examples

# rocks remove os sunos

Removes the OS type "sunos" from the database.

9.11.21. remove os attr

rocks remove os attr {os} {attr} [attr=string]

Remove an attribute for an OS.

arguments

os

One or more OS specifications (e.g., 'linux').

attr

The attribute name that should be removed.

parameters

[attr=string]

Can be used in place of the attr argument.

examples

# rocks remove os attr linux sge

Removes the attribute sge for linux OS machines.

# rocks remove os attr linux attr=sge

Same as above.

9.11.22. remove os route

rocks remove os route {os} [address=string] [address=string]

Remove a static route for an OS type.

arguments

os

The OS type (e.g., 'linux', 'sunos', etc.). This argument is required.

parameters

[address=string]

Can be used in place of the 'address' argument.

[address=string]

The address of the static route to remove. This argument is required.

examples

# rocks remove os route linux 1.2.3.4

Remove the static route for the OS 'linux' that has the network address '1.2.3.4'.

9.11.23. remove roll

rocks remove roll {roll...} [arch=string] [version=string]

Remove a roll from both the database and filesystem.

arguments

roll

List of rolls. This should be the roll base name (e.g., base, hpc, kernel).

parameters

[arch=string]

The architecture of the roll to be removed. If no architecture is supplied, then all architectures will be removed.

[version=string]

The version number of the roll to be removed. If no version number is supplied, then all versions of a roll will be removed.

examples

# rocks remove roll kernel

Remove all versions and architectures of the kernel roll

# rocks remove roll ganglia version=5.0 arch=i386

Remove version 5.0 of the Ganglia roll for i386 nodes

9.11.24. remove route

rocks remove route {address} [address=string]

Remove a global static route.

arguments

address

The address of the static route to remove. This argument is required.

parameters

[address=string]

Can be used in place of the 'address' argument.

examples

# rocks remove route 1.2.3.4

Remove the global static route that has the network address '1.2.3.4'.

9.11.25. remove sec_attr

rocks remove sec_attr {attr}

Delete the named attribute from the global secure attributes table

arguments

attr

The attribute you want to remove