In this tutorial, you get hands-on experience with the IBM Cloud Satellite distributed cloud solution. With the help of Satellite Link endpoints, you can connect to a service, server, or application that runs outside of the location from a client that runs within your Satellite location, or vice versa. You learn how to link a database service on the IBM Cloud to your Satellite location and verify the connection by sending and receiving data.
- An IBM Cloud Pay-As-You-Go or Subscription account. You must be the IBM Cloud account owner or have Administrator access.
- An existing IBM Cloud Object Storage service instance.
It will take you approximately 30 minutes to complete this tutorial.
1. Create your location
In IBM Cloud Satellite, a location represents a data center that you can fill with your own infrastructure resources to run IBM Cloud services or other workloads on your infrastructure.
In the Satellite Locations dashboard, click Create a Satellite location.
In the Satellite location section of the page, click Edit.
Within the Name field, enter a custom name for your Satellite location.
From the Managed from list, select the region that you want to use to manage your Satellite location.
Click Done editing.
Click Create location.
2. Attach hosts from your on-premises data centers
Hosts are machines that reside within your infrastructure. In your on-premises environment, identify or create at least three host machines that meet the minimum hardware requirements and are located in physically separate racks (these are called zones in Satellite).
Follow the steps in the IBM Cloud Satellite product documentation to attach your hosts.
3. Assign your hosts to the Satellite location control plane
From the actions menu of each host machine that you attached, click Assign host.
For the Cluster, select
For the Zone, select a unique zone such as
Click Assign host.
Note: When you assign the hosts to the control plane, IBM bootstraps your machine. This process might take a few minutes to complete. During the bootstrapping process, the Health of your machine changes from
Repeat these steps for each host. Make sure that you assign each host to a different zone so that you spread all three hosts across all three zones, such as
From the Hosts tab, verify that your hosts are successfully assigned to the Satellite control plane. The assignment is successful when an IP address is added to your host and the Health status changes to
4. Create the OpenShift cluster
To create the Red Hat OpenShift on IBM Cloud cluster that will live on your Satellite location, follow the steps located in the product documentation.
Now you can deploy an application of your choice.
5. Create a PostgreSQL database and link it to Satellite
A cloud endpoint allows you to securely connect to a service, server, or app that runs outside of the location from a client within your Satellite location. For this tutorial, you first create a PostgreSQL database service and then link that service to your Satellite location.
5.1 Create the database service
Select the Databases for PostgreSQL service from the IBM Cloud catalog.
Databases for PostgreSQL. Click Create.
Name your database and click Create.
After the service is ready, click Service credentials in the navigation pane.
New credentialoption and create credentials.
password, as shown in the following screen capture image. You will use these service credentials to create an endpoint link for the Satellite location.
5.2 Link the database service to your Satellite location
Select the Link endpoints tab, as shown in the following screen capture image.
Click Create an endpoint.
On the Create an endpoint page, select
Cloudas your destination resource.
Type a name in the Endpoint name field.
In the Destination URL or IP field, paste the
hostnamethat you copied when you created the PostgreSQL service credentials.
In the Destination port field, paste the port number that you copied when you created PostgreSQL service credentials.
In the TLS options section, leave the default values, as demonstrated in the following screen capture image, and click Next.
Click Create endpoint.
It takes few moments to create an endpoint. After the endpoint is created, you can view it by clicking the Endpoints tab.
Note: You can follow the same procedure for other IBM Cloud services.
6. Send data to the PostgreSQL database by using the Satellite endpoint
Be sure that your Satellite endpoint is enabled, as shown in the following screen capture. If the endpoint is not enabled, you will not be able to send or receive data by using it.
Copy the Satellite endpoint link that you created in Step 5.2.
passwordfrom the credentials that you created in Step 5.1.
Go to the Satellite Link example GitHub repo. Follow the steps in that repo to send and receive data by using the Satellite endpoint.
With IBM Cloud Satellite, you can quickly address unforeseen challenges, leverage cloud computing benefits in any location, and innovate quickly. Now that you know how a Satellite Link works, try something more complex. Check out the code pattern to build an IoT application at your location by using IBM Cloud Pak for Data and IBM Cloud Satellite.