Creating and working with bare metal servers (ibmcloud sl hardware)

IBM Cloud® Bare Metal Servers are single-tenant physical servers that provide you performance and control with low-level access to the hardware resources. Bare metal servers provide the raw horsepower you demand for your processor-intensive and disk I/O-intensive workloads. These servers come with the most complete package of standard features and services.

Use the following commands from the IBM Cloud® Command Line Interface to manage IBM Cloud classic infrastructure Bare-metal hardware servers.

ibmcloud sl hardware authorize-storage

Authorize File and Block Storage to a Hardware Server

ibmcloud sl hardware authorize-storage IDENTIFIER [flags]

Command options:

--u, username-storage: The storage username to be added to the hardware server.

ibmcloud sl hardware bandwidth

Bandwidth data over date range.

ibmcloud sl hardware bandwidth IDENTIFIER [OPTIONS] Time formats that are either '2006-01-02', '2006-01-02T15:04' or '2006-01-02T15:04-07:00'

Due to some rounding and date alignment details, results here might be slightly different than results in the control portal. Bandwidth is listed in GB, if no time zone is specified, GMT+0 is assumed.

Examples:

ibmcloud sl hardware bandwidth 1234 -s 2006-01-02T15:04 -e 2006-01-02T15:04-07:00

ibmcloud sl hardware bandwidth IDENTIFIER [flags]

Command options:

--e, end: End date for bandwidth reporting
--q, quiet: Only show the summary table.
--r, rollup: Number of seconds to report as one data point. 300, 600, 1800, 3600 (default), 43200 or 86400 seconds
--s, start: Start date for bandwdith reporting

ibmcloud sl hardware billing

Get billing for a hardware device.

ibmcloud sl hardware billing IDENTIFIER

ibmcloud sl hardware cancel

Cancel a hardware server

ibmcloud sl hardware cancel IDENTIFIER [flags]

Command options:

--c, comment: An optional comment to add to the cancellation ticket
--f, force: Force operation without confirmation
--i, immediate: Cancels the server immediately (instead of on the billing anniversary)
--r, reason: An optional cancellation reason. See '${COMMAND_NAME} sl hardware cancel-reasons' for a list of available options

ibmcloud sl hardware cancel-reasons

Display a list of cancellation reasons

ibmcloud sl hardware cancel-reasons

ibmcloud sl hardware create

Order/create a hardware server

ibmcloud sl hardware create [flags]

Command options:

--b, billing: Billing rate, either hourly or monthly, default is hourly if not specified
--d, datacenter: Datacenter shortname[required]
--D, domain: Domain portion of the FQDN[required]
--x, export: Exports options to a template file
--e, extra: Extra options, multiple occurrence allowed
--f, force: Force operation without confirmation
--H, hostname: Host portion of the FQDN[required]
--k, key: SSH keys to add to the root user, multiple occurrence allowed
--n, no-public: Private network only
--o, os: OS install code[required]
--p, port-speed: Port speed[required]
--i, post-install: Post-install script to download
--s, size: Hardware size[required]
--m, template: A template file that defaults the command-line options
--t, test: Do not actually create the virtual server

ibmcloud sl hardware create-credential

Create a password for a software component.

ibmcloud sl hardware create-credential IDENTIFIER [flags]

Command options:

--n, notes: A note string stored for this username/password pair.
--P, password: The password part of the username/password pair.
--software: The name of this specific piece of software.
--U, username: The username part of the username/password pair.

ibmcloud sl hardware create-options

Server order options for a given chassis

ibmcloud sl hardware create-options

ibmcloud sl hardware credentials

List hardware server credentials

ibmcloud sl hardware credentials IDENTIFIER

ibmcloud sl hardware detail

Get details for a hardware server

ibmcloud sl hardware detail IDENTIFIER [flags]

Command options:

--components: Show associated hardware components
--p, passwords: Show passwords (check over your shoulder!)
--c, price: Show associated prices

ibmcloud sl hardware edit

Edit hardware server details

ibmcloud sl hardware edit IDENTIFIER [flags]

Command options:

--D, domain: Domain portion of the FQDN
--H, hostname: Host portion of the FQDN
--v, private-speed: Private port speed, options are: 0,10,100,1000,10000
--p, public-speed: Public port speed, options are: 0,10,100,1000,10000
--g, tag: Tags to set or empty string to remove all (multiple occurrence permitted).
--u, userdata: User defined metadata string
--F, userfile: Read userdata from file

ibmcloud sl hardware list

List hardware servers

ibmcloud sl hardware list [flags]

Command options:

--column: Column to display, options are: id,hostname,domain,public_ip,private_ip,datacenter,status,guid,cpu,memory,os,ipmi_ip,created,created_by,tags. This option can be specified multiple times
--c, cpu: Filter by number of CPU cores
--d, datacenter: Filter by datacenter
--D, domain: Filter by domain
--H, hostname: Filter by hostname
--m, memory: Filter by memory in gigabytes
--n, network: Filter by network port speed in Mbps
--o, order: Filter by ID of the order which purchased hardware server
--owner: Filter by ID of the owner
--v, private-ip: Filter by private IP address
--p, public-ip: Filter by public IP address
--sortby: Column to sort by, default:hostname, option:id,guid,hostname,domain,public_ip,private_ip,cpu,memory,os,datacenter,status,ipmi_ip,created,created_by
--g, tag: Filter by tags, multiple occurrence allowed

ibmcloud sl hardware monitoring-list

Get details for a hardware monitors device.

ibmcloud sl hardware monitoring-list IDENTIFIER

ibmcloud sl hardware notifications

Shows who gets notified when the server has a monitoring issues.

ibmcloud sl hardware notifications IDENTIFIER

ibmcloud sl hardware notifications-add

Create a user hardware notification entry.

ibmcloud sl hardware notifications-add IDENTIFIER [flags]

Command options:

--users: User ID to be notified on monitoring failure, multiple occurrence allowed

ibmcloud sl hardware notifications-delete

Remove a user hardware notification entry.

ibmcloud sl hardware notifications-delete IDENTIFIER

ibmcloud sl hardware power-cycle

Power cycle a server

ibmcloud sl hardware power-cycle IDENTIFIER [flags]

Command options:

--f, force: Force operation without confirmation

ibmcloud sl hardware power-off

Power off an active server

ibmcloud sl hardware power-off IDENTIFIER [flags]

Command options:

--f, force: Force operation without confirmation

ibmcloud sl hardware power-on

Power on a server

ibmcloud sl hardware power-on IDENTIFIER [flags]

Command options:

--f, force: Force operation without confirmation

ibmcloud sl hardware reboot

Reboot an active server

ibmcloud sl hardware reboot IDENTIFIER [flags]

Command options:

--f, force: Force operation without confirmation
--hard: Perform a hard reboot
--soft: Perform a soft reboot

ibmcloud sl hardware reflash-firmware

Reflash server firmware.

ibmcloud sl hardware reflash-firmware IDENTIFIER [flags]

Command options:

--f, force: Force operation without confirmation

ibmcloud sl hardware reload

Reload operating system on a server

ibmcloud sl hardware reload IDENTIFIER [flags]

Command options:

--f, force: Force operation without confirmation
--k, key: IDs of SSH key to add to the root user, multiple occurrence allowed
--i, postinstall: Post-install script to download, only HTTPS executes, HTTP leaves file in /root
--b, upgrade-bios: Upgrade BIOS
--w, upgrade-firmware: Upgrade all hard drives' firmware

ibmcloud sl hardware rescue

Reboot server into a rescue image

ibmcloud sl hardware rescue IDENTIFIER [flags]

Command options:

--f, force: Force operation without confirmation

ibmcloud sl hardware sensor

Retrieve a server’s hardware state via its internal sensors.

ibmcloud sl hardware sensor IDENTIFIER [flags]

Command options:

--discrete: Show discrete units associated hardware sensor

ibmcloud sl hardware storage

Get storage details for a hardware server.

ibmcloud sl hardware storage IDENTIFIER

ibmcloud sl hardware toggle-ipmi

Toggle the IPMI interface on and off. This command is asynchronous.

ibmcloud sl hardware toggle-ipmi IDENTIFIER [flags]

Command options:

--disable: Disable the IPMI interface.
--enable: Enable the IPMI interface.
--q, quiet: Suppress verbose output

ibmcloud sl hardware update-firmware

Update server firmware

Update server firmware. By default will update all available server components.

ibmcloud sl hardware update-firmware IDENTIFIER [flags]

Command options:

--b, bios: Update BIOS firmware
--f, force: Force operation without confirmation
--d, harddrive: Update Hard Drive firmware
--i, ipmi: Update IPMI firmware
--n, network: Update Network Card firmware
--r, raid: Update RAID firmware

ibmcloud sl hardware vlan-add

Trunks a VLAN to the this server.

IDENTIFIER is the id of the server VLANS is the ID of the VLANs. Multiple vlans can be added at the same time.

ibmcloud sl hardware vlan-add IDENTIFIER VLAN...

ibmcloud sl hardware vlan-remove

Remove VLANs trunked to this server.

IDENTIFIER is the id of the server VLANS is the ID of the VLANs. Multiple vlans can be added at the same time.

ibmcloud sl hardware vlan-remove IDENTIFIER VLAN...

ibmcloud sl hardware vlan-trunkable

Lists VLANs this server can be given access to.

This command will only show VLANs not yet trunked to this server.

ibmcloud sl hardware vlan-trunkable IDENTIFIER