IBM Cloud Docs
Attaching Bare metal hosts

Attaching Bare metal hosts

You can use a supported bare metal server as a host attached to your Satellite location, including IBM Cloud® Bare Metal Servers for Classic.

Bare Metal Server requirements

To attach a bare metal host, your Bare Metal Server must meet the following requirements.

  • Must support virtualization technology.
    • For Intel CPUs, support for virtualization is referred to as Intel VT or VT-x.
    • For AMD CPUs, support for virtualization is referred to as AMD Virtualization or AMD-V.
  • Must have a minimum of 8 cores and 32 GB RAM, plus any additional cores that you need for your vCPU overhead. For more information, see CPU overhead in the Red Hat OpenShift docs.
  • Must include enough memory for your workload needs. For example: 360 MiB + (1.002 * requested memory) + 146 MiB + 8 MiB * (number of vCPUs) + 16 MiB * (number of graphics devices). For more information, see Memory overhead in the Red Hat OpenShift docs.
  • No operating system installed. The Red Hat CoreOS operating system is installed later in this process.
  • If you want to use OpenShift Data Foundation as your storage solution, add 2 storage disks to each of your Bare Metal Servers when you provision them.

If your servers do not meet these requirements, you can create a Bare Metal Server. For a list of bare metal options, see Available options for a bare metal server.

Attaching bare metal servers to your location

Follow these general steps to attach your bare metal servers to your location. These steps might vary, depending on your specific hardware. For a complete tutorial, see Attaching IBM Cloud Bare Metal Servers for Classic hosts.

  1. Download a Red Hat CoreOS ISO. Find the corresponding ISO version that matches the Red Hat OpenShift version that you want to use. For example, if you want to use version 4.11, download a version of RHCOS for 4.11, such as rhcos-4.11.9-x86_64-live.x86_64.iso.

  2. Log in to your bare metal server.

  3. In the BIOS settings, ensure that virtualization is enabled.

  4. Set up your boot order to boot the Red Hat CoreOS ISO file that you downloaded in step 1.

  5. Boot your system to install the ISO.

  6. After Red Hat CoreOS is booted into memory, set up network connections so you can provide the location ignition file and attach the server to your location.

  7. Download the ignition script for your Satellite location.

    ibmcloud sat host attach --location <location_name> --operating-system RHCOS
    
  8. Edit your ignition file to include the bare metal host name and network information. For more information about adding these details, see Configuring your ignition file. Note that you must edit the ignition file for each bare metal server that you want to attach to your location.

  9. Put your ignition file in a location that your bare metal server can reach. For example, you can upload it to an IBM Cloud Object Storage bucket.

  10. Download the ignition script to your bare metal server.

    curl <ignition_file_location > ignition.ign
    
  11. Run the following install command to start the ignition file. Replace <diskName> with the full path of the disk location where you want Red Hat CoreOS installed and replace <filename> with the path of the ignition file.

    sudo coreos-installer install <diskName> --ignition-file <filename>
    

    The installation process can take an hour or two to complete.

  12. After the installation completes, unplug your RHCOS ISO file and reboot from your hard disk.

  13. Check your Satellite location to confirm that your bare metal server is attached.

  14. Repeat these steps for each bare metal host that you want to attach to your location.

I added hosts to my location, what's next?

Now that you added hosts to your location, you can assign them to your location control plane or to your IBM Cloud services.

  1. Assign hosts to the location control plane or to your IBM Cloud services.
  2. Create a Satellite-enabled IBM Cloud service, such as a Red Hat OpenShift cluster. You can even register existing Red Hat OpenShift clusters to your location to use as deployment targets.
  3. Manage your applications with Satellite Config.
  4. Create Satellite cluster storage templates.
  5. Learn more about the Satellite Link component and how you can use endpoints to manage the network traffic between your location and IBM Cloud.

Need help? Check out Getting support where you can find information about cloud status, issues, and logging; contacting support; and setting your email notification preferences for IBM Cloud platform-related items.