Skip to content
This repository has been archived by the owner on Jul 22, 2024. It is now read-only.

IBM/satellite-link-database

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

28 Commits
 
 
 
 
 
 

Repository files navigation

abstract authors completed_date components draft excerpt keywords last_updated primary_tag pta pwg related_content related_links runtimes series services subtitle tags title translators type
name email
Rahul Reddy Ravipally
raravi86@in.ibm.com
name email
Amol Dhondse
amol.dhondse@in.ibm.com
name email
Srikanth Manne
srikanth.manne@in.ibm.com
name email
Manjula G. Hosurmath
mhosurma@in.ibm.com
2021-05-03
slug name url type
IBM Cloud
Ibm Cloud
component
true|false
type slug
patterns
title url description
Connect and communicate with a service on IBM Cloud from Satellite location using Satellite Link endpoints
type slug
name email
tutorial

Hands-on: Connect and communicate with a service on IBM Cloud from Satellite location using Satellite Link endpoints

Introduction

The purpose of this tutorial is to give a hands-on experience of IBM Cloud Satellite and Satellite Link endpoints. With the help of Satellite Link endpoints, we can connect to a service, server, or app that runs outside of the location from a client that runs in your Satellite location, or vice-versa. In this tutorial you will learn, how to link a database service on IBM Cloud to your IBM Cloud Satellite location and verify the connection by sending the data and receiving the data.

Prerequisites

IBM Cloud Account

Estimated time

It will take you approximately 30 minutes to complete this tutorial.

Steps

1. Create a Satellite location in IBM Cloud.

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 own infrastructure.

  • From the Satellite Locations dashboard, click Create location.
  • Enter a name and an optional description for your location.
  • Select the IBM Cloud region that you want to use to manage your location.
  • Click Create location.

2. Attaching hosts from on-premises data centers and edge networks

  • Hosts are machines that reside in your infrastructure In your on-premises environment, identify or create at least three host machines in physically separate racks, which are called zones in Satellite, that meet the minimum hardware requirements.

  • Follow the steps in this link to attach hosts from on-premises data centers and edge networks.

3. Assign 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 Control plane.
  • For the Zone, select a unique zone such as zone-1.
  • 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 Ready to Provisioning.

  • 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 zone-1, zone-2, and zone-3.
  • 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 Normal.

4. Create the OpenShift Cluster that will live on your satellite location

  • Here we create the OpenShift cluster that will live on your satellite location.

  • Follow the steps in this link to create OpenShift clusters on Satellite from the console.

  • Now you can deploy an application of your choice.

5. Create PostgreSQL database and link it to IBM Cloud 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.

5.1 Create the Service

  • Create a Databases for PostgreSQL service.

  • Choose Databases for PostgreSQL. Click on Create.

  • Name your database and click on Create.

  • Once the service is ready, click on "Service credentials" in the navigation pane and select the "New credential" option and create credentials. Copy Host url and Port number. .

  • These service credentials will be used to create an Endpoint Link for the Satellite location.

5.2 Link the Service to your satellite

  • Click on Link Endpoints tab.

Link Endpoints

  • Click on Create on Endpoint as shown below.

Create on Endpoint

  • Select Cloud and click on next.

Select Cloud

  • Enter an Endpoint name. In Destination URL or IP paste the host name that you copied when you created the PostgreSQL service credentials . In Destination port paste the port number that you copied when you created PostgreSQL service credentials.

Fill details that you copied from credentials

  • Leave the default value and click on Next as shown below.

Next

  • Click on Create endpoint as shown below.

Create endpoint

  • It takes few moments to create an endpoint. Once the endpoint is created, you can view it under Endpoints as shown below.

Endpoint dashboard

Note: You can follow the same procedure for other services on IBM Cloud.

6. Send data to PostgreSQL database using the Satellite endpoint

Note: Make sure that your satellite endpoint is enabled as shown below. If the endpoint is not enabled you will not be able to send or receive data using the endpoint.

Enable the satellite endpoint

  • Copy the Satellite endpoint link that you created in step 5.2.

  • Copy the username and password from the credentials that you created in step 5.1.

  • Goto this sample and follow the steps

  • Run the application and send/receive data via Satellite endpoint.

View the data flow

Summary

With IBM cloud satellite you can quickly address unforeseen challenges, leverage cloud benefits in any location and innovate quickly anytime anywhere.

Related links

Now that you know how a satellite link works, try something more complex. Check out the following code pattern that helps you build an IoT application at your location using IBM Cloud Pak for Data and IBM Cloud Satellite.
Monitor and Analyze IoT data at your location using IBM Cloud Satellite and IBM Cloud Pak for Data

About

this is for fun, ain't it grand!

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published